عن المشروع

Graphify هي أداة مطوّرين تحوّل قاعدة الشيفرة—إلى جانب المستندات وملفات PDF ومخططات SQL وملفات أخرى—إلى رسم معرفي قابل للاستعلام. وهي مصممة للاستخدام داخل مساعدي البرمجة بالذكاء الاصطناعي: بعد التثبيت، تكتب /graphify . في Claude Code وCursor وCodex وGemini CLI وGitHub Copilot CLI والعديد من المنصات المدعومة الأخرى، فيستطيع المساعد الاستعلام من الرسم بدل البحث عبر ملفات المصدر باستخدام grep. كيف يعمل: يُحلَّل الكود محليًا باستخدام tree-sitter AST، لذا يكون رسم الخريطة للكود حتميًا ولا يتطلب LLM. يمكن معالجة المستندات وملفات PDF والصور والفيديو عبر تمريرة دلالية باستخدام نموذج المساعد أو مفتاح API مُهيَّأ، لكن فقط إذا فعّل المستخدم خلفية (backend). لا يستخدم النظام embeddings أو مخزنًا متجهيًا؛ بل يبني رسمًا حقيقيًا بعُقد وحواف مشروحة. تُوسَم كل وصلة بـ EXTRACTED عندما تكون صريحة في المصدر أو INFERRED عندما يحلها graphify، مع ذكر وسم AMBIGUOUS أيضًا. تشمل القدرات الأساسية الموصوفة في README: عُقد god للمفاهيم الأكثر ترابطًا، واكتشاف المجتمعات باستخدام Leiden، وروابط عابرة للملفات عبر نحو 40 لغة عبر tree-sitter، وأوامر مثل graphify query للأسئلة باللغة الطبيعية، وgraphify path لتتبع الروابط بين شيئين، وgraphify explain لفحص عقدة واحدة. كما يستخرج تعليقات المبررات مثل # NOTE: و# WHY:، بالإضافة إلى استشهادات ADR/RFC، كعُقد من الدرجة الأولى مرتبطة بالكود. يتكون الناتج من ثلاثة ملفات: graph.html للتصفح التفاعلي، وGRAPH_REPORT.md مع أبرز النقاط والأسئلة المقترحة، وgraph.json للاستعلام البرمجي. يستخدم التثبيت حزمة PyPI باسم graphifyy (لاحظ حرف y المزدوج). الإعداد الموصى به هو uv tool install graphifyy أو pipx install graphifyy، يليه graphify install لتسجيل المهارة لدى مساعد الذكاء الاصطناعي. تتوفر أوامر تثبيت خاصة بكل منصة للعديد من المساعدين، ويمكن إجراء تثبيتات لكل مشروع باستخدام --project. تغطي الإضافات الاختيارية استخراج PDF، ومستندات Office، وGoogle Sheets، ونسخ الفيديو/الصوت، وخادم MCP stdio، والدفع إلى Neo4j وFalkorDB، وتصدير SVG، واكتشاف مجتمعات Leiden، وخلفيات LLM متعددة (OpenAI وGemini وAnthropic وBedrock وAzure وOllama)، واستخراج مخطط SQL، واستبطان PostgreSQL، ومحللات لغات إضافية مثل Terraform وOCaml وCommon Lisp وRobot Framework وPascal وBYOND DreamMaker. يتضمن README أيضًا مقارنات معيارية (benchmark) مقابل أنظمة ذاكرة/RAG أخرى، ويذكر أن تحليل الكود يعمل محليًا بالكامل مع صفر أرصدة LLM لبناء الرسم. ويؤكد أن graphify ليس فهرسًا متجهيًا وأن المشروع مطوَّر بواسطة Graphify Labs، مع وصول مبكر إلى منصة مستضافة على app.graphify.com.