Deepseek ArtifactsDeepseek Artifacts
طرف ثالث · Apache-2.0 · Python

Graphify: رسم بياني معرفي لقاعدة الشيفرة من أجل Claude Code

يحوّل Graphify المستودع — الشيفرة والتوثيق ومخططات SQL والإعدادات وملفات PDF — إلى رسم بياني معرفي يمكن الاستعلام عنه من داخل Claude Code. تحليل محلي بواسطة tree-sitter، وكل حافة موسومة، ولا مخزن متجهات.

Graphify في لمحة

  • مشروع مفتوح المصدر من طرف ثالث (Graphify-Labs/graphify، رخصة Apache-2.0، مكتوب بلغة Python) وليس منتجًا من Anthropic. يوفّر مهارة `/graphify` لـ Claude Code وCursor وCodex وGemini CLI وغيرها.
  • تُحلَّل الشيفرة بواسطة tree-sitter إلى AST محليًا وبشكل حتمي، دون أي نداء لنموذج. كل حافة موسومة بـ `EXTRACTED` (صريحة في المصدر) أو `INFERRED` (استنتجها Graphify).
  • إنه رسم بياني يُتجوَّل فيه، لا فهرس متجهات: لا تضمينات ولا مخزن متجهات. يعيد `/graphify query` العقد والحواف اللازمة للإجابة فقط.
  • ثلاثة أوامر تكفي: `uv tool install graphifyy` ثم `graphify install` ثم `/graphify .` داخل المستودع. المخرجات تظهر في `graphify-out/`.

Graphify-Labs/graphify — repository and README

المصدرgithub.com2026-11-15

فتح

Graphify Quickstart

المصدرdocs.graphify.com2026-11-15

فتح

GitHub REST API — repos/Graphify-Labs/graphify

المصدرapi.github.com2026-11-15

فتح

كل أمر ووسيط واسم ملف في هذه الصفحة قُرئ من المصادر الثلاثة أعلاه في 2026-11-15. الأوامر والمسارات تُركت دون ترجمة بقصد، لأن الأمر المترجم لا يعمل.

تم التحقق في 2026-11-15. الفرع الافتراضي هو v8 وآخر push كان في 2026-11-14؛ أعداد النجوم والتفرعات تتغير يوميًا، فأعد قراءة الـ API قبل الاقتباس.

ما هو Graphify فعليًا

وصف المشروع لنفسه: حوّل أي قاعدة شيفرة، مع توثيقها ومخططات SQL والإعدادات وملفات PDF، إلى رسم بياني معرفي قابل للاستعلام — مهارة `/graphify` لـ Claude Code وCursor وCodex وGemini CLI، بتحليل AST محلي وحتمي، وكل حافة مشروحة، ودون مخزن متجهات.

عمليًا: تثبّت واجهة سطر أوامر (`graphify`) ومهارة، ثم تكتب `/graphify` داخل مساعدك. ينفّذ المساعد الاكتشاف والاستخراج والتجميع، ويكتب الرسم البياني في `graphify-out/`، ثم يجيب عن الأسئلة بالتجوال في ذلك الرسم بدل البحث بـ grep في الشجرة.

الرخصة
Apache-2.0
اللغة
Python (اسم الحزمة graphifyy)
النجوم / التفرعات
147,983 / 14,194 — لقطة 2026-11-15
الحالة
طرف ثالث؛ الفرع الافتراضي v8؛ آخر push في 2026-11-14

ليس مشروعًا من Anthropic

ينشر Graphify تنظيم Graphify-Labs (ويذكر GitHub API أن is_verified: false) برخصة Apache-2.0. لا تصونه Anthropic ولا يأتي مضمّنًا في Claude Code: تثبّته بنفسك، ويعمل على ملفاتك أنت.

كيف يُبنى الرسم البياني

تُحلَّل الشيفرة بـ tree-sitter إلى AST. هذه المرحلة حتمية وتجري على جهازك: بلا LLM ولا خروج لأي شيء. علاقات ما بين الملفات (calls وimports وinherits وmixes_in) تُستخرج من AST لنحو 40 لغة، كما تتحول تعليقات `# NOTE:` / `# WHY:` وإشارات ADR وRFC إلى عقد.

التوثيق وملفات PDF والصور والفيديو تمرّ في مرحلة ثانية دلالية تستخدم نموذج مساعدك أو مفتاح API مُعدًّا. هذا هو الجزء الذي يستهلك الرموز؛ أما خريطة الشيفرة نفسها فلا.

كل حافة مشروحة

كل ارتباط يحمل وسمًا: `EXTRACTED` عندما تكون العلاقة صريحة في المصدر، و`INFERRED` عندما يستنتجها Graphify. هكذا تعرف ما قُرئ من الشيفرة وما استُنتج.

ليس فهرس متجهات

لا تضمينات ولا مخزن متجهات. المخرج رسم بياني حقيقي — عقد وحواف ومجتمعات وعقد god — تتجول فيه عبر `query` و`path` و`explain`.

تثبيت Graphify من أجل Claude Code

ثلاثة أوامر. الهدف الافتراضي لـ `graphify install` هو Claude Code، وأي مساعد آخر يبعد عنه بوسيط واحد.

ثبّت واجهة سطر الأوامر

اسم الحزمة `graphifyy` — بحرفَي y. وهي تثبّت الأمرين `graphify` و`graphify-mcp`. تحتاج Python 3.10 أو أحدث، وأي مدير حزم من الثلاثة يكفي.

# Python 3.10 or lateruv tool install graphifyy# or: pipx install graphifyy# or: pip install graphifyy

انتبه للتهجئة: ما تثبّته هو `graphifyy`، وما تكتبه هو `graphify` و`graphify-mcp`.

سجّل المهارة

دون وسيط يستهدف `graphify install` برنامج Claude Code: ينسخ المهارة إلى `~/.claude/skills/graphify/SKILL.md` ويسجّلها في `~/.claude/CLAUDE.md`. ولمساعد آخر مرّر `--platform`.

graphify install# Claude Code (default): ~/.claude/skills/graphify/SKILL.md# registered in ~/.claude/CLAUDE.md# another assistant: graphify install --platform codex

مثلًا `graphify install --platform codex`. إن لم يُعرَف `/graphify` بعد ذلك، أعد تشغيل المساعد أو تحقق من وجود `~/.claude/skills/graphify/SKILL.md`.

شغّله داخل مستودع

افتح المستودع في مساعدك ونفّذ `/graphify .`. يقوم الوكيل بالكشف والاستخراج والتجميع ثم يقدّم تقريرًا؛ الشيفرة تُحلَّل محليًا، والتوثيق والأوراق تمرّ عبر نموذج الوكيل نفسه.

/graphify .

ثم اسأل: يعيد `/graphify query "how does authentication reach the database"` العقد والحواف اللازمة فقط، مقصوصة على ميزانية رموز.

قبل أن تبدأ

  • 1Python 3.10 أو أحدث.
  • 2uv أو pipx أو pip — أيًّا كان ما تستخدمه لأدوات سطر الأوامر.
  • 3مساعد برمجة يدعمه `graphify install` (والافتراضي Claude Code)، مع مستودع للفهرسة — محلي، أو رابط GitHub عام لـ `/graphify <url>`.

الأوامر التي ستستخدمها فعليًا

منقولة حرفيًا من quickstart وجدول الأوامر في التوثيق. الأوامر التي تبدأ بـ `/` تُكتب داخل المساعد، والباقي يُنفَّذ في الصدفة.

الأمرما يفعله
/graphify query "…"يطرح سؤالًا ويعيد العقد والحواف اللازمة فقط، مقصوصة على ميزانية رموز.
/graphify path "AuthModule" "Database"يعرض أقصر مسار بين عقدتين — هنا من AuthModule إلى Database.
/graphify explain "SessionStore"يشرح عقدة واحدة: ما هي، وبماذا تتصل، ولماذا.
/graphify . --updateيحدّث رسمًا موجودًا بدل إعادة بنائه من الصفر.
/graphify . --mode deepيشغّل نمط الاستخراج الأعمق — أبطأ، لكنه يحلّ علاقات أكثر.
/graphify . --wikiينتج أيضًا وصفًا للرسم البياني بأسلوب الويكي.
/graphify https://github.com/<owner>/<repo>يستهدف مستودعًا عامًا عبر رابط بدل مسار محلي.
graphify hook installيثبّت خطافات git (post-commit وpost-checkout وpost-merge وpost-rewrite إضافة إلى merge driver) لتتبع الخريطة المستودع؛ وينبغي أن يُظهر `graphify hook status` الخطافات الأربعة كـ installed.
graphify god-nodes --top 5يطبع العقد الأكثر ارتباطًا — فحص سريع لوجود الرسم البياني وسلامة شكله.
graphify extract . --code-onlyيعيد الاستخراج بمرحلة الشيفرة وحدها، متجاوزًا خطوات LLM للتوثيق والوسائط.
graphify uninstallيزيل المهارة وتسجيلاتها.

إن لم يجد الأمر الرسم البياني، شغّله من المجلد الذي يحتوي `graphify-out/`، أو مرّر `--graph graphify-out/graph.json`.

ما يظهر في graphify-out/

شجرة التوثيق، كما هي:

graphify-out/├── graph.json├── graph.html├── GRAPH_REPORT.md├── manifest.json└── cache/
  • 1`graph.json` — الرسم البياني الكامل، والملف الذي تقرأه الأدوات الأخرى.
  • 2`graph.html` — عرض في المتصفح: نقر على العقد، تصفية، بحث.
  • 3`GRAPH_REPORT.md` — أهم النقاط والارتباطات المفاجئة وأسئلة يُستحسن طرحها.
  • 4`manifest.json` — بيان بما جرى فهرسته.
  • 5`cache/` — بيانات عمل محلية؛ أضفها إلى `.gitignore` بدل تثبيتها في المستودع.

ما الذي تثبّته في git

ينصح التوثيق بتثبيت `graph.json` و`GRAPH_REPORT.md` وإضافة `cache/` إلى `.gitignore`. النسخة المختصرة في README تقول إنك تحصل على «ثلاثة ملفات» (`graph.html` و`GRAPH_REPORT.md` و`graph.json`)، بينما يسرد quickstart خمسة عناصر. الوصفان يتحدثان عن المجلد نفسه بمستويين من التفصيل.

الرسم البياني المحفوظ يسجّل أيضًا `graph.schema_version` و`graph.graphify_version`. تحقق منهما بعد ترقية واجهة الأوامر: قد يحتاج رسم قديم إلى إعادة بناء.

إبقاء الرسم البياني حديثًا

قيمة الرسم البياني تساوي آخر بناء له، لذا اربطه بـ git:

graphify hook installgraphify hook status# → 4 hooks installed, merge driver: registered

يصل `graphify hook install` خطافات post-commit وpost-checkout وpost-merge وpost-rewrite مع merge driver. بعدها ينبغي أن يُظهر `graphify hook status` الخطافات الأربعة installed وعبارة “merge driver: registered”.

عند تغيّر التوثيق أو الصور، أعد تشغيل `/graphify . --update` بدل بناء كامل.

متى يناسبك، وما لا يفعله

Graphify أداة لرسم خرائط الشيفرة. يستحق التثبيت حين تكون بنية المستودع أهم من نص ملف واحد.

حالات مناسبة

  • 1تدخل قاعدة شيفرة غير مألوفة وتريد رؤية الوحدات وعقد god والمجتمعات قبل قراءة الملفات.
  • 2السؤال سؤال علاقة — كيف يصل هذا إلى ذاك، ومن يستدعي هذا — وgrep يجيب عنه بضعف.
  • 3تريد تثبيت الخريطة كي يعيد الفريق أو الوكيل قراءتها دون دفع كلفة إعادة البناء.

حدود يجب معرفتها

  • 1الجزء المجاني والمحلي بالكامل يغطي الشيفرة. أما التوثيق وملفات PDF والصور والفيديو فتمرّ عبر نموذج في المرحلة الدلالية، أي برموز أو مفتاح API.
  • 2حواف `INFERRED` هي استنتاج Graphify وليست حقيقة في المصدر. اقرأ الوسم قبل الوثوق بأي ارتباط.
  • 3الرسم البياني لقطة. بلا الخطافات أو `--update` يقدم كما يقدم README.
  • 4إنه مشروع طرف ثالث حديث: حجّته تأتي من README الخاص به لا من تقييم مستقل.

ينشر المشروع في README جدول قياسات خاصًا به — مثل LOCOMO recall@10 بمقدار 0.497 عند n=300. هذه قياسات القائمين على المشروع وليست نتيجة مستقلة، فاعتبرها ادعاءً يستحق التحقق على مستودعك.

Graphify على DeepSeek Harness

ثمّة أيضًا إضافة أصلية من طرف ثالث لـ DeepSeek Harness مدرجة في دليل إضافاته. هي عمل مجتمعي ومستقلة عن مستودع Graphify-Labs.

عرض بطاقة الإضافة

أسئلة شائعة عن Graphify

تابع القراءة