Project Zurvan
يحوّل Project Zurvan الوثائق الخام إلى ويكي مترابط قابل للبحث ومتوافق مع git، ثم يتيحه للوكلاء عبر خادم Model Context Protocol أو MCP. استُوحي محرك المعرفة الذي يعطي الأولوية للمعالجة المحلية ويعتمد على LLM من ملاحظات Andrej Karpathy عن إدارة المعرفة الشخصية، وصُمّم للباحثين والمهندسين والوكلاء الذين يحتاجون ذاكرة منظّمة طويلة الأمد دون الارتهان للسحابة.
مستودع الكود المصدري خاص. تواصل معي لطلب الوصول.
٠١ / نظرة عامة
المعرفة والاسترجاع
تتبّع فكرة مصنّفة من المصدر إلى سياق الوكيل
اختر نوعًا معرفيًا لتتبّع علاقته التخطيطية من مستند المصدر مرورًا بالاسترجاع. تصف التسميات أدناه البنية، لا مثالًا من مدونة خاصة.
مخطط توضيحي · لا يعرض سجلات مدونة أو نتائج استرجاعاستخراج من مادة المصدر؛ تتراكم الروابط عبر المصادر
ادعاء: استرجاع عبر البحث الهجين؛ وقد يضيف جيران الرسم سياقًا ذا صلة
معنى النوع المحدد
- ادعاء
تحفظ عقدة الادعاء عبارةً كمعرفة منظمة مرتبطة بمادة المصدر.
- مفهوم
تربط عقدة المفهوم موضوعًا بمعرفة ذات صلة عبر الويكي المحلية.
- كيان
تمثل عقدة الكيان موضوعًا مسمى يمكن ربطه بالادعاءات والمفاهيم.
- قرار
تسجل عقدة القرار قرارًا كعنصر مصنّف يمكن استرجاعه مع السياق ذي الصلة.
لا يدّعي هذا المخطط اكتمال الأمانة للمصادر أو تغطية المنشأ أو استدعاء الاسترجاع. بل يعرض نموذج البيانات ومراحل الاسترجاع الموثقة فقط.
مستودع Zurvan خاص؛ يستخدم هذا المخطط العام تسميات عامة ولا يتضمن سجلات من المدونة.
المشكلة
يفتقر وكلاء LLM إلى ذاكرة منظّمة مستمرة بين الجلسات. تتطلب مسارات RAG الحالية بنية سحابية أو تفقد علاقات المعرفة، مثل دعم ادعاء لقرار أو تعارض مفهومين. يجب أن يستوعب الحل المحلي وثائق متنوعة ويحفظ علاقاتها كشبكة ويقدّمها بصيغة قابلة للاستعلام وتحمي الخصوصية.
نظرة عامة على الحل
- بناء مسار استيعاب محلي لملفات MD وPDF وTXT والصور إلى مخزن معرفة قائم على SQLite.
- استخراج عقد ذات أنواع محددة بالـLLM: ادعاءات ومفاهيم وكيانات وقرارات، تُدمج تراكميًا مع نمو المصادر.
- بحث هجين FTS5 ودلالي مع توسيع جوار الشبكة لتجميع سياق عميق للوكلاء.
- خادم MCP عبر stdio يتيح zurvan_search وzurvan_context وzurvan_remember وzurvan_decision_add وأدوات الشبكة لـClaude Code وCursor.
- اتحاد متعدد المشاريع لإدارة مخازن مستقلة مع بحث عابر لها وكشف التعارض وانحراف السياسات.
٠٢ / الأدلة
الإثبات والتحقق
- نجاح 218 اختبارًا عبر 18 مرحلة تطوير مكتملة.
- التحقق من خادم MCP مع أدلة إعداد Claude Code وCursor.
- تكامل مخزن Obsidian مع شبكة ملوّنة من 7 أنواع معرفة: ادعاءات ومفاهيم وكيانات وقرارات وجلسات وتعارضات وتركيبات.
- يعمل مسار حزمة الأدلة ثم التقرير والمراجعة والنشر بالكامل دون اتصال.
- توثيق تنسيق عمل الوكيل، قبل العمل وبعد التحرير وعند إغلاق الجلسة، لـClaude Code وCodex.
٠٣ / المنهجية
البناء
مكدس التقنيات
- Python 3.10+
- SQLite FTS5 (بحث هجين)
- خادم MCP عبر stdio
- مزوّدو LLM: OpenAI / Anthropic / Mock
- بنية مخزن متوافقة مع Obsidian
- استيعاب Markdown وPDF وTXT والصور في ويكي مترابط قابل للبحث ومتوافق مع git.
- استخراج عقد المعرفة المحددة النوع بالـLLM ودمج الادعاءات والمفاهيم والكيانات والقرارات تراكميًا عبر المصادر.
- بحث هجين FTS5 ودلالي مع توسيع جوار الشبكة لتجميع سياق كثيف.
- خادم MCP عبر stdio يتيح zurvan_search وzurvan_context وzurvan_remember وzurvan_decision_add وأدوات الشبكة لـClaude Code وCursor.
- اتحاد متعدد المشاريع مع بحث عابر للمخازن وكشف التعارض ومراقبة السياسات.
- نجاح 218 اختبارًا عبر 18 مرحلة مكتملة.
الأمان
- تصميم يعطي الأولوية للمعالجة المحلية؛ دون تخزين سحابي أو إرسال محتوى الوثائق خارجيًا.
- خادم MCP للقراءة فقط افتراضيًا؛ الكتابة تتطلب علامة موافقة صريحة.
- مسارات المشاريع في ~/.zurvan/projects.json ولا تُدرج في نظام التحكم بالإصدارات.
- مزوّد Mock LLM متاح للتطوير والاختبار الآمن دون كشف مفتاح API.
- ذاكرة الوكيل منفصلة لكل مخزن، والاتحاد بينها يتطلب تسجيلًا صريحًا.