README.ar SA

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

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

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

[!NOTE] تريد هذا دائم التشغيل؟ يُبقي Graphify Cloud الرسم البياني حيًّا عبر دورة حياة تطوير البرمجيات بأكملها: دعم المستودعات الأحادية والعابرة للمستودعات، والتحقق الصوري، ومراجعة الكود بنظرة شاملة على دورة حياة التطوير، إضافة إلى موصّلات لـ Sentry وJira والمزيد لتجلس الحوادث والتذاكر في الرسم البياني ذاته مع الكود. ابدأ تجربة مجانية لمدة 14 يومًا على app.graphify.com.

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

ابدأ الآن (30 ثانية). يتطلب Python 3.10+ وuv (أو pipx):

uv tool install graphifyy      # install the CLI (or: pipx install graphifyy)
graphify install               # detects your assistant and registers the skill

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

/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 و20+ غيرها، على macOS وLinux وWindows: اختر منصتك.

See it in action¶

بمجرد بناء الرسم البياني تستعلم عنه بدلًا من قراءة الملفات. مخرجات حقيقية، من تشغيل 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 كيف يرتبط أي شيئين.

What it does¶

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

[!TIP] تشغّل هذا عبر مستودعات كثيرة أو مستودع أحادي؟ يفعله Graphify Cloud باستمرار ويخفّض إنفاق الوكلاء على الرموز بنسبة 80%، مع روابط عابرة للمستودعات، ومراجعة كود على مستوى دورة حياة التطوير، وتحقق صوري، وموصّلات Sentry/Jira. ابدأ تجربة مجانية لمدة 14 يومًا →

Benchmarks: 0.497 recall@10, 0 LLM credits¶

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

Documentation¶

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

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

Prerequisites¶

تثبيت سريع على 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

Install¶

[!IMPORTANT] الحزمة الرسمية: حزمة PyPI هي graphifyy (بحرفَي y). حزم graphify* الأخرى على PyPI غير تابعة. أمر CLI ما يزال graphify.

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

البدء السريع بأمرين في أعلى هذا الملف التعريفي. يغطي هذا القسم طرق التثبيت، والتثبيت محدد النطاق بالمشروع، وكل منصة مدعومة.

طرق التثبيت (اختر واحدة):

uv tool install graphifyy   # recommended, isolated env (if 'graphify' isn't found after, run: uv tool update-shell)
pipx install graphifyy      # alternative
pip install graphifyy       # may need PATH setup, see Troubleshooting below

ثم شغّل 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.

[!TIP] تواجه command not found، أو مشكلة pip على Mac/Windows، أو اقتباس PowerShell، أو استخدام uvx، أو مشاكل PATH في خطاف git، أو الوضع الصارم؟ راجع Installation وTroubleshooting.

Make your assistant always use the graph¶

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

شغّل 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 CODEBUDDY.md + خطافات PreToolUse، وملف Codex AGENTS.md، وإضافة Kilo الأصلية .kilo، وقاعدة Cursor alwaysApply، وهكذا) مشروحة في Always-on setup.

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

CLI skills or MCP instructions?¶

تصف التعليمات التي يثبّتها graphify install وتلك المرفقة باتصال Graphify MCP طرقًا مختلفة لاستعلام رسم بياني:

كلاهما يشجّع الاستعلامات محددة النطاق على الرسم البياني قبل عمليات البحث الواسعة في المصدر. اختر التعليمات التي تطابق الأدوات التي يستطيع مساعدك الوصول إليها فعلًا؛ ولا تؤسس أي من الكتلتين قاعدة أسبقية شاملة لملفات تعليمات مساعدك. إذا استخدمت كلا التكاملين، فحدّد أي رسم بياني يستعلم عنه كل منهما واختر مسار استعلام أساسيًا بدلًا من نسخ كتلتَي تعليمات غير مشروطتين إلى AGENTS.md.

يثبّت graphify install تكامل المساعد المحلي؛ ولا يؤسس اتصال MCP. لا يحتاج عميل MCP إلى تشغيل استعلامات CLI محلية لاستخدام خادمه المتصل. خادم مستضاف محليًا ما يزال يحتاج إلى تثبيت Graphify ورسم بياني خاص به، بينما قد يخدم اتصال مستضاف رسمًا بيانيًا غير موجود في دليل عمل العميل. إذا كانت الأدوات المتوقعة مفقودة، فتحقق من تثبيت CLI أو اتصال MCP المعني بدلًا من معاملة تعليمات الإعداد الآخر على أنها قابلة للتبادل.

What's in the report¶

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

What files it handles: ~40 languages¶

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

Common commands¶

/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

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

Ignoring files¶

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

Project configuration¶

أنشئ ملف .graphifyrc في جذر الفحص لإعدادات تخص المشروع لا تشغيلة واحدة. key=value واحد لكل سطر؛ والأسطر التي تبدأ بـ # تعليقات.

الامتدادات الغامضة. بعض الامتدادات تعني لغات مختلفة في مشاريع مختلفة: .inc هو PHP على pfSense، وPascal في شجرة Delphi، وSQL أو تجميعية في غيرها؛ و.h هو C أو C++؛ و.m هو Objective-C أو MATLAB. على graphify أن يختار افتراضًا عامًا واحدًا، وحين يختار خطأً لا يفشل الملف: يُحلَّل كاللغة الخاطئة ويعطي حفنة من العقد العرضية، فيبدو الرسم البياني مأهولًا بينما الرموز الحقيقية مفقودة. صرّح بما يعنيه الامتداد في مستودعك:

# .graphifyrc
# A language name:
language.inc=php
# Or an extension graphify already knows:
language.tpl=.ts
# Baked into the git hooks (see Team setup):
viz_node_limit=0

يتدفق التصريح عبر التصنيف، واختيار المستخرج، والقواعد والتحليل، والاستيرادات، وgraphify watch، وذاكرة AST المؤقتة (ملف يُعاد تحليله بلغة مختلفة لا يعيد استخدام المدخل القديم أبدًا)، ويُقرأ .graphifyrc ذاته بواسطة extract وupdate والخطافات وخادم MCP ومهارة /graphify. يُبلَّغ عن الخطأ المطبعي مرة واحدة على stderr ويستمر الفحص بالافتراضات. كيف تتفاعل التصريحات مع التخزين المؤقت، وإعادة البناء التراكمي، وتحليل الاستيراد: Configuration.

Team setup¶

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

Using the graph directly¶

إلى جانب مساعد الذكاء الاصطناعي لديك، استعلم عن graph.json مباشرة من CLI بـ graphify query وgraphify path وgraphify explain. الاسم الذي يطابق عدة عقد يُرفض بسرد المرشحين بدلًا من التخمين. يمكن للسكربتات قراءة النتيجة من رمز الخروج: 0 إجابة، 3 اسم غامض، 4 لا عقدة مطابقة. راجع Ask better graph questions وquery reference.

Environment variables¶

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

Privacy¶

• ملفات الكود: تُعالَج محليًا عبر 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¶

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

Full command reference¶

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

Learn more¶

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

Graphify Cloud¶

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

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

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

Contributing¶

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

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

Contributors¶

Made with contrib.rocks.

Translations¶

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

Building on graphify¶

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

Community and links¶