الرسم البياني للمعرفة (knowledge graph) مع Graphify: يحوّل مستودع Graphify-Labs/graphify مشروعًا (شيفرة ومستندات وملفات PDF وصورًا وفيديو) إلى رسم بياني يُستعلَم عنه بدل تصفح الملفات بـ grep. يُستدعى بالأمر /graphify من مساعد برمجة. وكان يعرض نحو 132 100 نجمة في أكتوبر 2026، بترخيص مزدوج Apache-2.0 وMIT.
بالنسبة إلى مهندس أو SRE يتسلّم شيفرة مجهولة (خدمة بلا توثيق، أو مستودعًا ضخمًا موحّدًا monorepo، أو مستودع حادثة)، الفكرة أن يرى أي المكوّنات تعتمد على أي منها من دون قراءة مئة ملف. يعرض هذا المقال ما يقوله المستودع، والتثبيت بحسب README، وما تنتجه الأداة، والنقاط الواجب مراقبتها: الخصوصية وسجل الاستعلامات والعرض التجاري المجاور.
المعلومات مأخوذة من README ووثائق المشروع. لم تثبّت span.observer برنامج Graphify: اللقطة ومخرجات الأمر أدناه من README المستودع (مثال شيفرة FastAPI).
الرسم البياني للمعرفة مع Graphify: ما يقوله المستودع
- الجهة: Graphify Labs، التي تقدّم نفسها مالكةً للاسم والشعار. ويعرض README شارة Y Combinator S26. ويحمل الملف
LICENSE-MITعبارة «Copyright (c) 2026 Safi Shamsi». - الترخيص: يحتوي المستودع ملف
LICENSE(Apache-2.0، وتكرره شارة README) وملفLICENSE-MIT. ولا يقول README أي جزء يخضع لأي منهما: اقرأ الملفين قبل أي استخدام تجاري. - الإصدار: كانت الحزمة
graphifyyعلى PyPI بالإصدار 0.9.93، نُشر في 20 أكتوبر 2026. والفرع الافتراضي للمستودع هوv8. - المدخلات: نحو 40 لغة برمجة تُحلَّل بـ tree-sitter؛ ومستندات وملفات PDF وصور وصوت وفيديو عبر مرحلة دلالية؛ ومخططات SQL وملفات إعداد بإضافات اختيارية.
- المخرجات: مجلد
graphify-out/فيهgraph.html(رسم بياني تفاعلي) وGRAPH_REPORT.md(المفاهيم المركزية والروابط المفاجئة والأسئلة المقترحة) وgraph.json(الرسم الكامل القابل للاستعلام لاحقًا). - المبدأ: يوسَم كل رابط بـ
EXTRACTED(صريح في المصدر) أوINFERRED(مستنتَج). ويوضح README أنه ليس فهرسًا شعاعيًا: لا تضمينات embeddings، بل رسم بياني حقيقي يُتجوَّل فيه.

تُظهر اللقطة ملف graph.html الناتج عن شيفرة FastAPI: كل لون مجتمع مكتشف، أي نظام فرعي من الشيفرة.
تثبيت Graphify بحسب README
الخطوة 1 — المتطلبات
Python 3.10 أو أحدث، وuv (موصى به) أو pipx. ويقدم README أوامر تثبيت لـ macOS (brew install [email protected] uv) وWindows (winget install astral-sh.uv) وDebian أو Ubuntu.
الخطوة 2 — تثبيت الأمر وتسجيله في مساعدك
uv tool install graphifyy # ou : pipx install graphifyy
graphify install # détecte votre assistant et enregistre le skill
انتبه إلى الاسم: تُكتب حزمة PyPI الرسمية graphifyy بحرفي «y». وينبّه README إلى أن حزمًا أخرى باسم graphify* غير تابعة للمشروع. أما الأمر نفسه فيبقى graphify.
الخطوة 3 — بناء الرسم البياني
في مساعد البرمجة (Claude Code وCursor وGemini CLI وGitHub Copilot ونحو عشرين آخرين، بحسب README) اكتب:
/graphify .
ومع Codex تكون الصيغة $graphify. ولتثبيت المهارة (skill) في المستودع الحالي بدل ملفك الشخصي: graphify install --project. وللبناء من جديد تلقائيًا عند كل إيداع (commit): graphify hook install.
الاستعلام عن الرسم البياني
بعد بناء الرسم يصف README ثلاث حركات: graphify query "question" وgraphify path A B وgraphify explain "Nom". وهذا مثال المخرجات المنشور من المشروع على شيفرة FastAPI:

تظهر هنا الفائدة للتشغيل: يعطي الأمر explain الملف المصدر والمجتمع ودرجة مكوّن ما؛ ويبيّن الأمر path أقصر مسار بين مكوّنين. والوسوم INFERRED فرضيات: تحقق منها في الشيفرة قبل أن تستنتج.
الخصوصية وقابلية ملاحظة الأداة
- الشيفرة: تُحلَّل محليًا بواسطة tree-sitter، من دون نموذج لغوي، بحسب README؛ ويُبنى مجموع شيفرة فقط من دون مفتاح API.
- المستندات وPDF والصور: تُرسل إلى مساعدك أو إلى مزوّد هيّأته (متغيرات بيئة لـ Gemini وClaude وOpenAI وOllama وBedrock…). ويعطّل
GRAPHIFY_BACKEND=noneالنماذج، ويُبقيGRAPHIFY_BACKEND=ollamaكل شيء محليًا. - التتبع (telemetry): يؤكد README أنه لا يوجد أي تتبع.
- سجل الاستعلامات: مفعّل افتراضيًا، فكل
queryوpathوexplainواستدعاء MCPquery_graphيُضاف إلى~/.cache/graphify-queries.logبصيغة JSON Lines (الطابع الزمني والسؤال والمجموع وعدد العقد والمدة). ولا تُخزَّن الإجابات الكاملة. والتعطيل بـGRAPHIFY_QUERY_LOG_DISABLE=1.
بالنسبة إلى أداة محلية، هذا السجل هو أثر الاستخدام الوحيد الموثق: يتيح رؤية مدة كل استعلام. ويذكر README أيضًا إضافة mcp (uv tool install "graphifyy[mcp]") تقدّم الرسم البياني عبر خادم MCP بقناة stdio؛ وعن هذا النوع من الخوادم راجع مراقبة وكلاء MCP بواسطة OpenTelemetry. ولم نعثر على تصدير OpenTelemetry موثق.
كيف تتحقق من أن كل شيء يعمل؟
- بعد
/graphify .يحتوي المجلدgraphify-out/فعلًا علىgraph.htmlوGRAPH_REPORT.mdوgraph.json. - افتح
graph.html: هل تطابق المجتمعات الأنظمة الفرعية التي تعرفها؟ - شغّل
graphify explainعلى مكوّن معروف وقارن الروابطEXTRACTEDبالشيفرة.
الحدود والنقاط المفتوحة
- أرقام المشروع: ينشر README نتائج (LOCOMO وLongMemEval-S وERPNext) موضحًا أنها من المشروع نفسه؛ ولا نعيد إنتاجها هنا. أما عبارة «خفض إنفاق الرموز لدى الوكلاء بنسبة 80%» فتخص العرض السحابي وتبقى ادعاءً تجاريًا.
- العرض السحابي: «Graphify Cloud» مدفوع ويُروَّج له في README كله. تبقى الأداة المحلية قابلة للاستخدام وحدها، لكن اقرأ الصفحة قبل الاعتماد على وظيفة.
- اعتماديات اختيارية: تتطلب بعض الخيارات مُصرِّفًا بلغة C أو إصدارًا محددًا من Python؛ ويحتاج Codex إلى
multi_agent = trueللاستخراج المتوازي. - حداثة المشروع: أكثر من 130 000 نجمة، وإصدارات متكررة، ورقم إصدار أقل من 1.0: توقّع تغييرات.
أفضل الممارسات
- ابدأ بمستودع غير حساس، مع
--code-onlyإن لم ترد إرسال شيء إلى نموذج. - استبعد الأسرار والبيانات الشخصية من المجموع قبل المرحلة الدلالية.
- أعد قراءة الروابط
INFERREDقبل الاستشهاد بها في مراجعة. - قرّر مدة الاحتفاظ بالسجل
~/.cache/graphify-queries.log، فهو يحتوي أسئلتك. - أكمل بذاكرة وكيل أو بضغط للسياق: راجع context-mode ونافذة سياق الوكلاء.
الأسئلة الشائعة
هل يرسل Graphify شيفرتي إلى خدمة؟
بحسب README تُحلَّل الشيفرة محليًا. ولا يمر عبر مساعدك أو المزوّد الذي تهيّئه إلا المستندات وملفات PDF والصور.
ما الفرق عن البحث الشعاعي؟
يؤكد المشروع أنه لا يستخدم تضمينات ولا قاعدة بيانات شعاعية: يبني رسمًا بيانيًا للعلاقات يُتجوَّل فيه (query وpath وexplain).
هل يعمل Graphify مع خادم MCP الخاص بـ GitHub؟
هما أداتان مختلفتان: الأولى ترسم خريطة مشروع، والثانية تتيح واجهة GitHub لوكيل. راجع خادم MCP الرسمي لـ GitHub.
الخلاصة
يقترح Graphify طريقة عملية لفهم شيفرة مجهولة: رسم بياني محلي وروابط صريحة وثلاثة أوامر للاستعلام. جرّبه على مستودع غير حساس، واقرأ ملفَّي الترخيص، وعطّل السجل عند الحاجة، واعتبر أرقام README ادعاءات من المشروع.
span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية (docs.graphify.com).