عن المشروع
"فهم أي شيء" (Understand Anything) هو أداة مفتوحة المصدر لفهم الأكواد تحول المستودعات الكودية وقواعد المعرفة والوثائق إلى رسوم بيانية معرفية تفاعلية. يحلل المشاريع باستخدام نهج هجين يجمع بين التحليل الحتمي لـ Tree-sitter والتحليل الدلالي المعتمد على نماذج الذكاء الاصطناعي، ثم يعرض النتائج عبر لوحة تحكم ويب تفاعلية.
## القدرات الرئيسية
**تصور المستودع الكودي**
- يبني رسماً بيانياً من العقد والروابط لكل ملف ودالة وفئة وتابعة
- يلوّن العقد حسب الطبقة المعمارية (API، خدمة، بيانات، واجهة، أدوات)
- يدعم البحث الشبه الدقيق والدلالي عبر الرسم البياني
- يوفر ملخصات بلغة واضحة لكل عقدة
**خط أنابيب متعدد الوكلاء**
تنسق الأداة وكلاء متخصصين: ماسح المشروع، محلل الملفات، محلل البنية، باني الجولات، ومراجع الرسم البياني. يعمل محللو الملفات بالتوازي مع ما يصل إلى 5 عمال متزامنين. التشغيلات اللاحقة تزيدجية وتعيد تحليل الملفات المتغيرة فقط.
**تحليل النطاق والمعرفة**
- عرض النطاق يربط الكود بالعمليات التجارية والتدفقات والمراحل
- تحليل قواعد المعرفة يعمل مع ويكيّات LLM بنمط Karpathy، ويستخرج الكيانات والادعاءات والعلاقات الضمنية مع تجمّع المجتمعات
**التعلّم الموجه**
- جولات موجهة مولّدة تلقائياً مرتبة حسب التبعية
- 12 نمط برمجي موضّح في سياقه
- واجهة متكيفة مع الشخصيات تضبط مستوى التفاصيل للمطورين المبتدئين ومديري المنتجات ومستخدمي الخبرة
**تحليل أثر الفروقات**
- معرفة الأجزاء المتأثرة بالتغييرات قبل الالتزام
- تتبع التداعيات عبر المستودع الكودي
## التثبيت
الأداة متاحة كإضافة لـ Claude Code وتثبت عبر أكثر من 18 منصة تشمل Cursor وVS Code + GitHub Copilot وCodex وGemini CLI وOpenCode وCopilot CLI وKiro وTrae وCline وغيرها. معظم التثبيتات تستخدم سكريبتاً واحداً:
curl -fsSL https://raw.githubusercontent.com/Egonex-AI/Understand-Anything/main/install.sh | bash
مستخدمو Claude Code يثبتون عبر سوق الإضافات. Cursor وVS Code يكتشفان الإضافة تلقائياً عند سحب المستودع.
## لوحة التحكم بدون LLM
الرسم البياني المعرفي المُنتج يُخزّن كـ JSON ويمكن عرضه بشكل مستقل بـ:
npx https://github.com/Egonex-AI/Understand-Anything/releases/latest/download/understand-anything-viewer.tgz /path/to/project
هذا يتطلب Node.js فقط (>= 18)، ويعمل بقراءة من القرص المحلي بدون استدعاءات LLM.
## التعريب
يدعم إخراجاً متعدد اللغات (الإنجليزية والصينية والمينانيزي واليابانية والكورية والروسية) عبر علامة `--language`، ويؤثر على ملخصات العقد وواجهة لوحة التحكم ومحتوى الجولات الموجهة.
## المشاركة
يمكن الالتزام بالرسم البياني JSON في التحكم بالنسخة ليفحص أعضاء الفريق دون تشغيل الخط الأنابيب. يُنصح بـ Git LFS للرسوم الكبيرة (10 MB+). يمكن تفعيل خطاف ما بعد الالتزام لتحديث الرسم渐进ياً.
## الترخيص
ترخيص MIT. من صنع Lum1104 ونشره Egonex (شركة الكون اللامتناهي).
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.