الرسم البياني للمعرفة مع Graphify: خريطة لشيفرة مجهولة

الرسم البياني للمعرفة مع Graphify مفتوح المصدر: التثبيت بحسب README، والاستعلامات query وpath وexplain، والخصوصية وسجل الاستعلامات.
Graphify graphe de connaissances : cartographier un code

الرسم البياني للمعرفة (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، بل رسم بياني حقيقي يُتجوَّل فيه.
مقتطف من README الخاص بـ Graphify: رسم بياني تفاعلي لشيفرة FastAPI على هيئة سحابة عقد ملونة، مع مفتاح المجتمعات المكتشفة على اليمين (APIRouter وSecurityBase وFastAPI وHTTPException وModelField…)
Source : github.com

تُظهر اللقطة ملف 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:

مخرجات مثال من README الخاص بـ Graphify على شيفرة FastAPI: الأمر graphify explain APIRouter مع روابطه السبعة والأربعين الموسومة EXTRACTED أو INFERRED، ثم graphify path بين FastAPI وModelField في ثلاث قفزات
Source : github.com

تظهر هنا الفائدة للتشغيل: يعطي الأمر explain الملف المصدر والمجتمع ودرجة مكوّن ما؛ ويبيّن الأمر path أقصر مسار بين مكوّنين. والوسوم INFERRED فرضيات: تحقق منها في الشيفرة قبل أن تستنتج.

الخصوصية وقابلية ملاحظة الأداة

  • الشيفرة: تُحلَّل محليًا بواسطة tree-sitter، من دون نموذج لغوي، بحسب README؛ ويُبنى مجموع شيفرة فقط من دون مفتاح API.
  • المستندات وPDF والصور: تُرسل إلى مساعدك أو إلى مزوّد هيّأته (متغيرات بيئة لـ Gemini وClaude وOpenAI وOllama وBedrock…). ويعطّل GRAPHIFY_BACKEND=none النماذج، ويُبقي GRAPHIFY_BACKEND=ollama كل شيء محليًا.
  • التتبع (telemetry): يؤكد README أنه لا يوجد أي تتبع.
  • سجل الاستعلامات: مفعّل افتراضيًا، فكل query وpath وexplain واستدعاء MCP query_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).

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
vLLM inférence LLM : installer et superviser le serveur

خادم vLLM لاستدلال LLM: التثبيت والمراقبة

Next Post
Supabase Postgres open source : installer et superviser

Supabase مفتوح المصدر: التثبيت والمراقبة

Related Posts