قلّل إنفاق رموز الوكلاء بنسبة 80%. Graphify Cloud هي ذاكرة دائمة التشغيل تحكم وكلاءك، وتحافظ على جودة عالية للشيفرة، وتثبت الصحة عبر التحقق الصوري. ابدأ تجربة مجانية لمدة 14 يومًا →

اكتب /graphify في مساعد البرمجة بالذكاء الاصطناعي لديك فيقوم برسم خريطة لمشروعك بالكامل (الشيفرة والوثائق وملفات PDF والصور والفيديو) في رسم بياني معرفي يمكنك الاستعلام منه بدلًا من البحث بـ grep عبر الملفات.

• خرائط الشيفرة مجانًا وبشكل محلي تمامًا. تُحلّل الشيفرة باستخدام شجرة البنية النحوية AST من tree-sitter: حتمية، دون نموذج لغوي، ولا شيء يغادر جهازك. (أما الوثائق وملفات PDF والصور والفيديو فتستخدم نموذج مساعدك، أو مفتاح API مُهيّأ، لإجراء تمريرة دلالية.)
• كل حافة مشروحة. تُوسَم كل صلة بـ EXTRACTED (صريحة في المصدر) أو INFERRED (مستنتجة بواسطة graphify)، حتى تميّز ما قُرئ مباشرةً عمّا استُنتج.
• ليس فهرسًا شعاعيًا. لا تضمينات ولا مخزن شعاعي: رسم بياني حقيقي تجتازه. اطرح سؤالًا، أو تتبّع المسار بين شيئين، أو اشرح مفهومًا واحدًا.

قاعدة شيفرة FastAPI مرسومة بواسطة graphify. كل عقدة مفهوم، والألوان مجتمعات مُكتشفة، والكل قابل للنقر في graph.html.

البدء (30 ثانية):

uv tool install graphifyy      # install the CLI (or: pipx install graphifyy)
graphify install               # register the skill with your AI assistant

ثم، في مساعد الذكاء الاصطناعي لديك:

/graphify .

هذا كل شيء. تحصل على ثلاثة ملفات:

graphify-out/
├── graph.html       open in any browser — click nodes, filter, search
├── GRAPH_REPORT.md  the highlights: key concepts, surprising connections, suggested questions
└── graph.json       the full graph — query it anytime without re-reading your files

يتضمن الرسم البياني المحفوظ graph.schema_version حتى تتمكن عمليات التكامل من اكتشاف تغييرات الصيغة غير المتوافقة، إضافةً إلى graph.graphify_version الذي يحدد إصدار Graphify الذي أنتجه.

يعمل في Claude Code وCursor وCodex وGemini CLI وGitHub Copilot و15+ غيرها — اختر منصّتك.

الأدلة الكاملة والمرجع موجودة في docs.graphify.com:

• Quickstart — ابنِ أول رسم بياني لك
• CLI reference — كل أمر وكل راية
• Ask better graph questions — أنماط الاستعلام
• Configuration — متغيرات البيئة والضبط
• Supported inputs — اللغات وأنواع الملفات
• Team workflows و**PR review**
• Troubleshooting و**How it works**

بمجرد بناء الرسم البياني تستعلم منه بدلًا من قراءة الملفات. مخرجات حقيقية من تشغيل graphify على قاعدة شيفرة FastAPI الموضحة أعلاه:

$ graphify explain "APIRouter"
Node: APIRouter
  Source:    routing.py L2210
  Community: 2
  Degree:    47

Connections (47):
  --> RequestValidationError [uses] [INFERRED]
  --> Dependant [uses] [INFERRED]
  --> .get() [method] [EXTRACTED]
  <-- __init__.py [imports] [EXTRACTED]
  ...

$ graphify path "FastAPI" "ModelField"
Shortest path (3 hops):
  FastAPI --uses--> DefaultPlaceholder <--references-- get_request_handler() --references--> ModelField

تحمل كل حافة وسم ثقة (EXTRACTED = صريحة في المصدر، INFERRED = مشتقة بالاستنتاج)، حتى تميّز ما قُرئ مباشرةً عمّا استُنتج. يعيد graphify query "<question>" رسمًا بيانيًا جزئيًا محدّد النطاق لسؤال بلغة عادية، ويتتبّع graphify path A B كيفية ارتباط أي شيئين.

ما تحصل عليه جاهزًا للاستخدام:

شُغّل كل نظام على المنصّة نفسها بالنموذج نفسه والميزانيات نفسها، وقُيّم بواسطة حَكَم تم التحقق منه بشكل أعمى مقابل حَكَم ثانٍ (توافق 90.6%، كابا كوهين 0.81). الجداول الكاملة لكل نظام، ونتيجة ذكاء الشيفرة، وأوامر إعادة الإنتاج: BENCHMARKS.md.

تثبيت سريع على macOS (Homebrew):

brew install python@3.12 uv

تثبيت سريع على Windows:

winget install astral-sh.uv

Ubuntu/Debian:

sudo apt install python3.12 python3-pip pipx
# or install uv:
curl -LsSf https://astral.sh/uv/install.sh | sh

مستودع المصدر الرسمي هو Graphify-Labs/graphify.

الخطوة 1 — ثبّت الحزمة:

# Recommended (isolated env; if 'graphify' isn't found after, run: uv tool update-shell):
uv tool install graphifyy

# Alternatives:
pipx install graphifyy
pip install graphifyy  # may need PATH setup — see note below

الخطوة 2 — سجّل المهارة لدى مساعد الذكاء الاصطناعي:

graphify install

هذا كل شيء. افتح مساعد الذكاء الاصطناعي واكتب /graphify .

لتثبيت مهارة المساعد في المستودع الحالي بدلًا من ملف تعريف المستخدم، أضف --project:

graphify install --project
graphify install --project --platform codex

تكتب عمليات التثبيت محدّدة النطاق بالمشروع تحت الدليل الحالي، على سبيل المثال .claude/skills/graphify/SKILL.md أو .agents/skills/graphify/SKILL.md (إضافةً إلى ملف مرافق references/ تحمّله المهارة عند الطلب)، وتطبع تلميح git add للملفات التي يمكن إيداعها. الأوامر الخاصة بكل منصّة التي تدعم عمليات التثبيت محدّدة النطاق بالمشروع تقبل الراية نفسها، على سبيل المثال graphify claude install --project أو graphify codex install --project.

شغّل هذا مرة واحدة في مشروعك بعد بناء رسم بياني:

شغّل graphify <platform> install مرة واحدة في مشروعك، على سبيل المثال graphify claude install أو graphify codex install (أو graphify install --platform <name>).

يكتب هذا ملف ضبط صغيرًا يخبر مساعدك باستشارة الرسم البياني المعرفي لأسئلة قاعدة الشيفرة، مفضّلًا الاستعلامات محدّدة النطاق مثل graphify query "<question>" على قراءة التقرير الكامل أو البحث بـ grep في الملفات الخام.

• منصّات الخطّافات (Claude Code وGemini CLI): يُطلَق خطّاف تلقائيًا قبل استدعاءات أدوات البحث (وعلى Claude Code، قبل قراءة ملفات المصدر واحدًا تلو الآخر عبر أداتَي Read/Glob) ويوجّه مساعدك نحو مسار الرسم البياني.
• منصّات ملفات التعليمات (Codex وOpenCode وCursor وغيرها): توفّر ملفات التعليمات الدائمة (AGENTS.md و.cursor/rules/ وغيرها) الإرشاد نفسه القائم على الاستعلام أولًا.

لا يزال GRAPH_REPORT.md متاحًا للمراجعة المعمارية الواسعة.

يقوم CodeBuddy بالأمرين نفسيهما اللذين يقوم بهما Claude Code: يكتب قسم CODEBUDDY.md يخبر CodeBuddy بقراءة graphify-out/GRAPH_REPORT.md قبل الإجابة على الأسئلة المعمارية، ويثبّت خطّافات PreToolUse (.codebuddy/settings.json) تُطلَق قبل أوامر بحث Bash وقراءات الملفات، موجّهًا نحو graphify query بدلًا منها.

يكتب Codex إلى AGENTS.md، وهو ما يحمل فعليًا الإرشاد دائم التشغيل للرسم البياني على هذه المنصّة. يسجّل graphify codex install أيضًا خطّاف PreToolUse في .codex/hooks.json (graphify hook-check)، لكن هذا الإدخال هو عمدًا بلا أثر: يرفض Codex Desktop hookSpecificOutput.additionalContext على PreToolUse، لذا فإن إصدار توجيه هناك سيعطّل استدعاءات أداة Bash. وبخلاف Claude Code، حيث يقوم الخطّاف (graphify hook-guard) بالتوجيه، يُطلَق الخطّاف على Codex ولا يفعل شيئًا عن قصد، وAGENTS.md هي الآلية دائمة التشغيل.

يثبّت Kilo Code مهارة Graphify في ~/.config/kilo/skills/graphify/SKILL.md وأمرًا أصليًا /graphify في ~/.config/kilo/command/graphify.md. يكتب graphify kilo install أيضًا AGENTS.md إضافةً إلى إضافة أصلية tool.execute.before (.kilo/plugins/graphify.js + تسجيل .kilo/kilo.json أو .kilo/kilo.jsonc) بحيث يحصل Kilo على سلوك التذكير بالرسم البياني دائم التشغيل نفسه عبر ضبط .kilo الأصلي.

يكتب Cursor ملف .cursor/rules/graphify.mdc مع alwaysApply: true، لذا يضمّنه Cursor في كل محادثة تلقائيًا، دون حاجة إلى خطّاف.

لإزالة graphify من جميع المنصّات دفعة واحدة: graphify uninstall (أضف --purge لحذف graphify-out/ أيضًا). أو استخدم الأمر الخاص بكل منصّة (مثل graphify claude uninstall).

يلخّص GRAPH_REPORT.md العقد العملاقة والمجتمعات والمسارات الأساسية للمراجعة المعمارية الواسعة. كيفية بناء الرسم البياني وما يحتويه: How graphify works.

يحلّل graphify نحو 40 لغة برمجة محليًا بشجرة البنية النحوية AST من tree-sitter، ويرسم الوثائق وملفات PDF والصور والصوت/الفيديو عبر تمريرة دلالية اختيارية. القائمة الكاملة: Supported inputs.

/graphify .                        # build graph for current folder
/graphify ./docs --update          # re-extract only changed files
/graphify . --cluster-only         # rerun clustering without re-extracting
/graphify . --cluster-only --resolution 1.5      # more granular communities
/graphify . --cluster-only --exclude-hubs 99     # suppress utility super-hubs from god-node rankings
/graphify . --no-viz               # skip the HTML, just the report + JSON
/graphify . --wiki                 # build a markdown wiki from the graph
graphify export callflow-html      # Mermaid architecture/call-flow HTML (auto-regenerates on every git commit if hook is installed)

/graphify query "what connects auth to the database?"
/graphify path "UserService" "DatabasePool"
/graphify explain "RateLimiter"

/graphify add https://arxiv.org/abs/1706.03762   # fetch a paper and add it
/graphify add <youtube-url>                       # transcribe and add a video

graphify hook install              # auto-rebuild on commit + branch checkout (run `graphify update .` after `git pull` — see "Recommended workflow" below)
graphify merge-graphs a.json b.json              # combine two graphs

graphify prs                       # PR dashboard: CI state, review status, worktree mapping
graphify prs 42                    # deep dive on PR #42 with graph impact
graphify prs --triage              # AI ranks your review queue (uses whatever backend is configured)
graphify prs --conflicts           # PRs sharing graph communities — merge-order risk

راجع مرجع الأوامر الكامل أدناه.

يحترم graphify ملف .gitignore ويدعم أنماط --exclude وملف مشروع .graphifyignore. التفاصيل: Configuration.

أودِع الرسم البياني أو شاركه حتى يستعلم فريقك بأكمله من السياق نفسه، وراجع طلبات السحب بسياق الرسم البياني. راجع Share context with your team و**Review pull requests**.

بعيدًا عن مساعد الذكاء الاصطناعي لديك، استعلم من graph.json مباشرةً من سطر الأوامر عبر graphify query وgraphify path وgraphify explain. راجع Ask better graph questions و**query reference**.

تُتحكَّم بالخوادم الخلفية ومفاتيح API وسلوك الخطّافات والضبط عبر متغيرات البيئة. الجدول الكامل: Configuration.

• ملفات الشيفرة — تُعالَج محليًا عبر tree-sitter. لا شيء يغادر جهازك. لا تتطلب مجموعة شيفرة فقط أي مفتاح API — يعمل graphify extract دون اتصال تمامًا. على مستودع مختلط، أضف --code-only لفهرسة الشيفرة فقط وتخطّي الوثائق/ملفات PDF/الصور التي ستحتاج خلاف ذلك إلى نموذج لغوي.
• الفيديو / الصوت — يُنسَخ محليًا بـ faster-whisper. لا شيء يغادر جهازك.
• الوثائق وملفات PDF والصور — تُرسَل إلى مساعد الذكاء الاصطناعي لديك للاستخراج الدلالي (عبر مهارة /graphify، باستخدام أي نموذج تشغّله جلسة بيئة التطوير لديك). يتطلب graphify extract بدون واجهة GEMINI_API_KEY / GOOGLE_API_KEY (Gemini)، أو MOONSHOT_API_KEY (Kimi)، أو ANTHROPIC_API_KEY (Claude)، أو OPENAI_API_KEY (OpenAI)، أو DEEPSEEK_API_KEY (DeepSeek)، أو نسخة Ollama قيد التشغيل (OLLAMA_BASE_URL)، أو بيانات اعتماد AWS عبر سلسلة المزوّد القياسية (Bedrock - لا حاجة لمفتاح API، يستخدم IAM)، أو الملف الثنائي لـ claude CLI (Claude Code - لا حاجة لمفتاح API، يستخدم اشتراكك في Claude). تستخدم راية --dedup-llm المفتاح نفسه.
• مكان إقامة البيانات — يكتشف graphify extract تلقائيًا أي مزوّد يُستخدم بناءً على مفتاح API المُعيَّن (الأولوية: Gemini → Kimi → Claude → OpenAI → DeepSeek → Azure → Bedrock → Ollama). للشيفرة ذات متطلبات مكان إقامة البيانات، استخدم --backend ollama (محلي تمامًا) أو مرّر راية --backend صريحة. يوجّه Kimi (MOONSHOT_API_KEY) إلى خوادم Moonshot AI في الصين.
• لا قياسات عن بُعد، ولا تتبع استخدام، ولا تحليلات.
• تسجيل الاستعلامات — يُسجَّل كل استدعاء graphify query وgraphify path وgraphify explain واستدعاء MCP query_graph في ~/.cache/graphify-queries.log بصيغة JSON Lines (الطابع الزمني، والسؤال، والمجموعة، والعقد المُعادة، والمدة). لا تُخزَّن استجابات الرسوم البيانية الجزئية الكاملة افتراضيًا. اضبط GRAPHIFY_QUERY_LOG_DISABLE=1 للانسحاب، أو GRAPHIFY_QUERY_LOG=/dev/null لإسكاته دون تعطيل مسار الشيفرة.

مشكلات التثبيت والاستخراج الشائعة وحلولها: Troubleshooting.

كل أمر وكل راية، مع أمثلة: CLI reference.

• docs.graphify.com — الوثائق الكاملة: الأدلة ومرجع الأوامر وعمليات التكامل
• How it works — خط أنابيب الاستخراج واكتشاف المجتمعات وتقييم الثقة والمعايير
• ARCHITECTURE.md — تفصيل الوحدات وكيفية إضافة لغة
• Optional integrations — Docker MCP Toolkit + SQLite
• The Memory Layer — الكتاب عن الأفكار وراء graphify والمعمارية من البداية إلى النهاية

Graphify Cloud هي الطبقة دائمة التشغيل المبنية فوق graphify. بدلًا من رسم بياني تعيد بناءه عند الطلب لكل مجلد، تُبقي رسمًا بيانيًا حيًّا واحدًا عبر دورة حياة تطوير برمجياتك بأكملها:

• رموز أقل بنسبة 80% — الذاكرة دائمة التشغيل تعني أن وكلاءك يتوقفون عن إعادة قراءة قاعدة الشيفرة وإعادة شرحها في كل جلسة.
• مستودع أحادي وعبر المستودعات — رسم بياني متصل واحد عبر كل خدمة ومستودع، وليس رسمًا بيانيًا لكل مجلد.
• التحقق الصوري — تحقق من الثوابت المعمارية وثوابت التبعيات مقابل الرسم البياني الحيّ.
• مراجعة الشيفرة بنظرة شاملة على دورة حياة التطوير — انظر كيف يتموّج تغيير عبر النظام كله قبل أن تدمجه.
• موصّلات دورة حياة التطوير — اجلب Sentry وJira والمزيد، بحيث تعيش الحوادث والتذاكر والشيفرة في رسم بياني واحد.
• دائم التشغيل — يُحدَّث باستمرار في الخلفية عبر الشيفرة والوثائق والاجتماعات.

ابدأ تجربة مجانية لمدة 14 يومًا على app.graphify.com →

المساهمات مُرحَّب بها. راجع CONTRIBUTING.md لإعداد التطوير، وأوامر الاختبار والتكافؤ مع CI، وسير عمل git، وما الذي يجعل المساهمة قوية (الأمثلة العملية وتقارير أخطاء الاستخراج هي الأكثر فائدة). المعمارية وكيفية إضافة لغة: ARCHITECTURE.md.

جديد هنا؟ ألقِ التحية على Discord أو في GitHub Discussions.

صُنع باستخدام contrib.rocks.

الملف التعريفي متاح بـ 32 لغة. استخدم مبدّل اللغات في أعلى هذا الملف لقراءته بلغتك، أو تصفّح docs/translations/. لتحسين ترجمة أو إضافة ترجمة جديدة، افتح طلب سحب مقابل الملف المطابق هناك.

تبني شيئًا في منظومة graphify؟ هذا مُشجَّع. إذا استخدم مشروعك "graphify" في اسمه (على سبيل المثال graphify-dashboard أو graphify-action)، فيرجى إضافة ملاحظة قصيرة إلى ملفك التعريفي توضّح أنه مبني من قبل المجتمع وغير تابع لـ Graphify Labs أو مُعتمَد منها. "graphify" وشعار graphify علامتان لـ Graphify Labs؛ يرجى عدم استخدامهما بطريقة توحي بصفة رسمية.