عن المشروع

Vault Cortex هو خادم منفصل لبروتوكول سياق النموذج (MCP) يوفّر لوكلاء الذكاء الاصطناعي بحثًا هجينًا، وإدارة للمهام، وذاكرة منظمة، ووصولاً للقراءة والكتابة إلى خزائن Obsidian. ويعمل مباشرةً على ملفات `.md` المخزّنة على القرص، دون الحاجة إلى إضافات Obsidian أو وجود نسخة قيد التشغيل من التطبيق. ويُشغَّل الخادم في حاوية Docker واحدة، ويمكن نشره محليًا، أو استضافته ذاتيًا على خادم افتراضي خاص (VPS)، أو عبر النشر بنقرة واحدة على منصتي Railway أو Render للوصول عن بُعد. **الميزات الرئيسية:** - **البحث الهجين**: يجمع بين مطابقة الكلمات المفتاحية باستخدام FTS5 والتشابه الدلالي المتجهي عبر دمج الترتيب التبادلي (RRF)، مع تحسين النتائج بإعادة الترتيب باستخدام نموذج Cross-Encoder للاستعلامات المعتمدة على النية. وتعمل جميع النماذج محليًا بحجم إجمالي يقارب 45 ميغابايت، ودون أي واجهة برمجية خارجية. - **الذاكرة المنظمة**: نظام إدخال مؤرَّخ يُكتب فيه التسلسل الزمني فقط (Append-only)، ويُخزَّن في ملفات Markdown عادية داخل مجلد `About Me/` الافتراضي. ويستعيد الاستدلال الموضوعي الإدخالات ذات الصلة عبر جميع ملفات الذاكرة، مع عرض الحالة الحالية والتطور التاريخي. كما يدعم سياسة `entry-policy: living` للإدخالات القابلة للتقليم التي تعكس الحالة الحالية. - **إدارة المهام**: استعلامات وتحديثات مدركة للوح كانبان. ويدعم التصفية حسب الحالة، أو التواريخ، أو الأولوية، أو المجلد، أو المسار. ويتعامل مع كلٍّ من رموز الإيموجي الخاصة بإضافة Tasks وصيغة الحقول المضمّنة في Dataview. وعند إكمال المهام المتكررة، ينشئ الخادم المواعيد التالية تلقائيًا؛ كما يدعم إجراءات "عند الإكمال". - **الوصول إلى الملفات**: يقرأ الملفات غير النصية بما فيها الصور (مع تصغيرها على جانب الخادم)، وملفات PDF (باستخراج النص أو عرض الصفحات)، ولوحات Canvases (بمخططات قابلة للقراءة)، والملفات البياناتية مثل TXT، SVG، JSON، XML، CSV، YAML، السجلات، وقواعد Bases. - **الرسم البياني للروابط**: يكشف الروابط الراجعة، والروابط الصادرة، والمقالات المعزولة عبر كامل الخزينة. - **متوافق أصلاً مع Obsidian**: يفهم بيانات الوصف الأمامية (Frontmatter)، والروابط الداخلية Wikilinks، والوسوم، والعناوين، والملاحظات اليومية. - **سير عمل موجهة**: يطرح مطالبات مدمجة لفحص صحة الخزينة، ومراجعة الذاكرة، والتسوية اليومية، مُجمَّعة من بيانات الخزينة الحية. **المصادقة**: يدعم بروتوكول OAuth 2.1 للوصول عن بُعد مع صفحات موافقة، إضافةً إلى رمز حامل (Bearer Token) للعملاء الذين لا يستخدمون OAuth. ويتم تجديد الرموز تلقائيًا لعملاء OAuth. **خيارات النشر**: - محليًا: عبر Docker ومجلد الخزينة، مع الإعداد بواسطة الأمر `npx vault-cortex@latest init` - عن بُعد: نشر بنقرة واحدة على Railway أو Render، أو استضافة ذاتية على أي خادم VPS يعمل بنظام Linux ويحتوي على Docker - تستخدم عمليات النشر عن بُعد خدمة Obsidian Sync للحفاظ على تحديث الخزينة عبر مختلف الأجهزة **الإعداد**: تدير واجهة سطر الأوامر دورة حياة الخادم (`configure`, `upgrade`, `start`, `restart`, `logs`, `down`). كما يتوفر إعداد يدوي باستخدام Docker Compose. وتتولى صفحة إعداد موجودة على المسار `/setup` تسجيل الدخول إلى Obsidian Sync للنشر عن بُعد. **الأمان**: يتضمن تكاملًا مستمرًا (CI) مع فحوصات Gitleaks وTrivy، بالإضافة إلى شارات OpenSSF Scorecard وأفضل الممارسات. وتبقى الخزينة هي مصدر الحقيقة بصيغة Markdown العادية؛ بينما تحتفظ الحاوية بنسخة منها فقط. **حالات الاستخدام**: تم اختباره خلال رحلة استمرت 15 يومًا عبر أوروبا بأكثر من 30 جلسة استخدام من الهاتف، وشملت 216 استدعاءً للأدوات، دون أي وصول إلى حاسوب محمول. وكانت الكتابات المنفذة في جلسة واحدة متاحة فورًا في الجلسة التالية عبر مدن وأيام مختلفة.