عن المشروع

MisakaNet هي مكتبة ذاكرة فشل مدعومة بـ git لوكلاء البرمجة بالذكاء الاصطناعي. عند ظهور خطأ، يبحث الوكيل في الدروس المفهرسة، ويطبّق إصلاحًا تحقق منه شخص آخر، وإذا لم يجد تطابقًا، يحوّل مسار الإدخال هذا الطريق المسدود إلى درس للوكيل التالي. كل درس هو ملف Markdown في المستودع، يُراجَع مثل الشيفرة عبر commits موقّعة بـ DCO، ويُصنَّف حسب مستوى الأدلة، ويُسترجَع باستخدام BM25 من مكتبة بايثون القياسية. لا قاعدة بيانات متجهات، ولا نموذج تضمين، ولا خادم إلا إذا أردت ذلك. الخصائص الأساسية - توجد الدروس تحت `lessons/` كقاعدة معرفية مفتوحة وقابلة للتدقيق تغطي مجالات مثل rag وdevops وfanuc وdocker وfeishu وmcp وnetwork وci وwsl وwindows. - تمتد مستويات الأدلة من E0 intake عبر E1 CI وE2 merged PR وE3 maintainer وصولًا إلى E4 production reuse، بحيث يستطيع الوكيل وزن إدخال مجتمعي بشكل مختلف عن إصلاح مُثبت في الإنتاج. - يضع المشروع نفسه صراحةً كطبقة معرفة لاستعادة الفشل، وليس كنظام ذاكرة عام، أو بيئة تشغيل وكلاء، أو قاعدة بيانات متجهات، أو نظام RAG، أو خدمة سحابية تتطلب تسجيلًا، أو سوق مهارات. المهارة تعلّم كيفية القيام بشيء؛ أما الدرس فيسجّل ما حدث من خطأ سابقًا وكيفية تجنب الفشل مجددًا. واجهات أصلية للوكلاء - خادم MCP يكشف سبع أدوات، إضافة إلى WebMCP عبر `navigator.modelContext` في المتصفح. - `llms.txt` و`llms-full.txt` لبرامج الزحف، واكتشاف A2A عبر `.well-known/agent-card.json`. - القراءات مجهولة وغير محدودة عبر HTTP؛ والحد الوحيد هو نافذة اندفاع لكل عنوان. التسجيل مخصص للكتابة، ويفتح `misakanet_write_lesson` و`misakanet_preflight` برمز صالح لنحو 30 يومًا. التثبيت والاستخدام - المتطلبات هي Node 18+ للمثبّت أو Python 3.10+ للمكتبة وخادم stdio. - يكتب `npx @misaka-net/misakanet-setup` نقطة نهاية MCP في إعدادات كل مساعد، واختياريًا كتلة قواعد وخطافًا. تشمل العملاء الذين يديرهم المثبّت Claude Code وCodex وHermes وOpenClaw وcodewhale وCursor وGemini CLI وCopilot CLI وOpenCode وKiro؛ ويمكن تهيئة عملاء MCP-over-HTTP الآخرين يدويًا. - يوفر `pip install misakanet-core` مكتبة BM25 بدون تبعيات؛ وتشحن حزمة `misakanet` على PyPI خادم MCP عبر stdio؛ وحزمة `misakanet` على npm هي إضافة DSH/Codex. - يمكن لنداء `curl` مجهول واحد إلى `https://misakanet.org/mcp` استدعاء `misakanet_search` دون حساب أو رمز أو متصفح. - تتحقق أعلام `--verify` و`--uninstall` و`--report` من التثبيت وتلغيه وتبلّغ عنه. إجراء GitHub Action يمكن ربط النص نفسه بـ CI: عند فشل سير عمل، يبحث الإجراء في الدروس، ويعلّق بأقرب تطابق على طلب السحب، ويبلّغ اختياريًا عن الخطأ الجديد. وهو منشور على GitHub Marketplace ويدعم وضعي `suggest-only` أو `suggest-and-intake`. القياس والقيود المعلنة يتضمن README قياسًا أسبوعيًا يعمل على Cloudflare Workers AI لقياس `lesson_hit_rate` — نسبة أوامر درس مُدخَل التي تُعاد في إجابة. ويشير صراحةً إلى أنه لا يُستدعى أي استرجاع ولا يُتحقق من الصحة، لذا يقيس هذا نصف التلاوة في RAG وليس دليلًا على أن البحث يعمل. ويذكر المشروع أيضًا بوضوح أن BM25 يطابق الكلمات لا المعنى، لذا فإن الأعطال الموصوفة بمفردات غير مألوفة تكون حالات فشل في المطابقة؛ وتعيد حالة عدم المطابقة `no_match` مع نداء إدخال بدلًا من نتيجة فارغة. القيود المعروفة والأهداف غير المقصودة موثقة في LIMITATIONS.md. المساهمة والأمان تُقبل المساهمات كطلبات سحب صغيرة أو ملاحظات فشل من خمسة أسطر عبر قوالب القضايا أو إدخال MCP، دون دفع مكافآت. يفحص CI جميع ملفات Markdown بحثًا عن أنماط خطرة مثل `rm -rf` و`curl | sh` وحقن backtick، ويحذر README المستخدمين من عزل الوكلاء في بيئة معزولة قبل تنفيذ الأوامر المسترجعة. المشروع مرخّص بموجب Apache-2.0.