● مجتمع
Lum1104
⚡ فوري
Understand-Anything
بواسطة Lum1104 · Lum1104/Understand-Anything
إعداد مرئي لأي قاعدة كود — شبكات معرفية هيكلية ومجالية تُعلّم النظام بدلاً من مجرد رسمه.
يحوّل Understand-Anything قواعد الكود وقواعد المعرفة إلى شبكات تفاعلية. عرض ثنائي الطبقة: هيكلي (الملفات / الدوال / الفئات) ومجالي (العمليات التجارية / تدفقات البيانات). يتضمن بحثاً دلالياً ('ما الذي يتعامل مع المصادقة؟') وتحليل أثر التغيير ومستويات تفصيل تكيفية. مُصمَّم لتأهيل الفرق الجديدة وفهم المعمارية، لا للصور الجميلة.
لماذا تستخدمه
الميزات الأساسية
- شبكتان هيكلية ومجالية جنباً إلى جنب
- بحث بالمعنى الدلالي عبر الكود/الوثائق
- تحليل أثر التغيير — ما الذي يكسر إذا لمست X
- تفصيل تكيفي (أكثر للمطورين الكبار، أقل للمنضمين الجدد)
- توليف شبكة موجّهة بالقوة من مصادر wiki بأسلوب Karpathy
عرض مباشر
كيف يبدو في الممارسة
جاهز
حالات الاستخدام
استخدامات عملية: Understand-Anything
متى تستخدمه: مستودع جديد، ولديك أسبوع لتشعر بالإنتاجية.
الخطوات
-
فهرسة المستودع
Use understand-anything. Build the structural graph for ./repo and the domain graph from /docs.✓ تم النسخ
→ إحصاءات الشبكة (العقد، الحواف، الكثافة)
-
إيجاد نقاط الالتحام الأساسية
Highlight the 5 most-connected modules — likely architectural seams.✓ تم النسخ
→ قائمة مرتبة مع المبرر
-
تتبع ميزة واحدة
Walk me through 'create checkout' end-to-end across structural + domain graphs.✓ تم النسخ
→ مسار مُشروح عبر العقد؛ يشرح التقاطعات التجارية والتقنية
النتيجة: إنتاجية في أيام لا أسابيع؛ قراءة موجّهة بدلاً من الاستكشاف العشوائي.
المزالق
- الشبكة كثيفة جداً فتصبح غير مقروءة — فلتر حسب المجلد أو الميزة؛ المهارة تدعم مستويات تفصيل تكيفية
متى تستخدمه: أنت على وشك إعادة هيكلة وحدة 'تبدو حاملة للعبء'.
الخطوات
-
تحديد التغيير
Use understand-anything. I'll change the signature of calculateTax(price, region) to add a customer_class. What breaks?✓ تم النسخ
→ قائمة المُستدعين والاختبارات التي تحتاج تحديثاً
-
تصوير نطاق الأثر
Show me the subgraph touched by this change.✓ تم النسخ
→ شبكة فرعية مُضاءة مع درجة خطورة لكل حافة
-
تخطيط PR
Propose a PR sequence that minimizes review surface — which files first?✓ تم النسخ
→ قائمة ملفات مرتبة مع المبرر
النتيجة: PR مُحدَّد للمراجعة البشرية، لا وحش بـ 1500 سطر.
المزالق
- الشبكة تُغفل المُستدعين في وقت التشغيل (reflection, dynamic dispatch) — تحقق بـ grep لاسم الدالة؛ اذكر المُستدعين في وقت التشغيل منفصلاً
متى تستخدمه: لديك wiki بـ 200 صفحة؛ لا أحد يستطيع إيجاد أي شيء.
الخطوات
-
استيعاب الصفحات
Use understand-anything. Build a knowledge graph from /wiki/. Extract entities and implicit relationships.✓ تم النسخ
→ شبكة بأنواع كيانات + أنواع علاقات
-
إيجاد الأطراف الميتة
Which entities are referenced but never defined?✓ تم النسخ
→ قائمة موضوعات مشار إليها تحتاج صفحات
-
اقتراح إعادة التنظيم
Based on cluster structure, propose a 5-section TOC.✓ تم النسخ
→ قائمة أقسام مع الصفحات المخصصة
النتيجة: wiki يمكنك التنقل فيه فعلاً.
المزالق
- العلاقات الضمنية تصبح ضوضاء (كل صفحة تذكر 'API') — اضبط قائمة توقف المستخرج؛ المهارة تكشف إعداداً للمصطلحات الضوضائية الشائعة
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
الاحتفاظ بالشبكات المُولَّدة لإعادة استخدام الفريق
Save the graph to .claude/graphs/ and check in. Refresh on each main merge.✓ تم النسخ
بناء شبكة لمستودع عام بعيد دون استنساخ محلي
Use gitmcp for the repo source; pipe into understand-anything to build the graph in memory.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا شيء — مهارة محلية
- الرموز لكل استدعاء
- بناء الشبكة رخيص؛ الاستعلامات تُعيد 200-1500 رمز حسب حجم الشبكة الفرعية
- التكلفة المالية
- مجاني
- نصيحة
- ابنِ مرة واحدة لكل main، خزّن مؤقتاً؛ أعد البناء في عمليات إعادة الهيكلة الكبيرة
الأمان
الصلاحيات والأسرار ونطاق الأثر
الحد الأدنى من الصلاحيات: filesystem-read
تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: لا شيء
- الشبكات قد تكشف بنية كود حساسة إذا شُوركت علناً — عاملها كالمصدر نفسه
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
البناء بطيء على مستودع ضخم
مرّر --include و --exclude لتحديد النطاق؛ تخطَّ مجلدات generated/vendor
الاستدعاءات متعددة اللغات مفقودة
المهارة تعمل بشكل أفضل على مستودعات بلغة واحدة لكل مرور؛ لـ polyglot ابنِ شبكات منفصلة وارتبط يدوياً
الشبكة المجالية فارغة
مسار /docs لا يحتوي محتوى يتعرف عليه المستخرج؛ جرّب /README + /design-docs
المخرج كثيف جداً للقراءة
خفّض مستوى التفصيل؛ أو فلتر لشبكة فرعية لميزة بدلاً من عرض الشبكة الكاملة
البدائل
Understand-Anything مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| graphify-skill | تريد مهارة شبكة كود أخف وزناً | قدرة أقل في الشبكة المجالية |
| Sourcegraph | تريد بحثاً في الكود على مستوى المؤسسة مع واجهة رسومية | مدفوع؛ حمل إعداد |