منصوبے کے بارے میں

Vault Cortex ایک اسٹینڈ اکیلے MCP (ماڈل کونٹیکسٹ پروٹوکول) سرور ہے جو AI ایجنٹس کو ہائبرڈ تلاش، کام کا انتظام، منظم میموری، اور Obsidian والٹ تک پڑھنے/لکھنے کی رسائی فراہم کرتا ہے۔ یہ ڈسک پر موجود `.md` فائلوں پر براہ راست کام کرتا ہے، جس کے لیے کسی Obsidian پلگ ان یا چلتی ہوئی مثال کی ضرورت نہیں ہوتی۔ سرور ایک ہی Docker کنٹینر میں چلتا ہے اور اسے مقامی طور پر، VPS پر سیلف ہوسٹ کیا جا سکتا ہے، یا ریموٹ رسائی کے لیے Railway یا Render پر ایک کلک ڈیپلائمنٹ کے ذریعے تعینات کیا جا سکتا ہے۔ **اہم خصوصیات:** - **ہائبرڈ تلاش**: FTS5 کلیدی الفاظ کی مماثلت کو ویکٹر سیمنٹک مماثلت کے ساتھ Reciprocal Rank Fusion (RRF) کے ذریعے جوڑتی ہے، جسے ارادے پر مبنی سوالات کے لیے کراس-انکوڈر ری رینکنگ سے بہتر بنایا جاتا ہے۔ تمام ماڈل مقامی طور پر چلتے ہیں (کل ~45MB، کوئی بیرونی API نہیں)۔ - **منظم میموری**: ایک اپینڈ-اونلی، تاریخ شدہ انٹری سسٹم جو سادہ مارک ڈاؤن فائلوں میں محفوظ ہوتا ہے (ڈیفالٹ `About Me/` فولڈر)۔ ٹاپک ریکال تمام میموری فائلوں میں متعلقہ اندراجات کو بازیافت کرتا ہے، موجودہ حالت اور تاریخی ارتقاء دکھاتا ہے۔ `entry-policy: living` کو پرون ایبل موجودہ حالت کے اندراجات کے لیے سپورٹ کرتا ہے۔ - **ٹاسک مینجمنٹ**: کنبان سے آگاہ ٹاسک سوالات اور اپ ڈیٹس۔ اسٹیٹس، تاریخوں، ترجیح، فولڈر، یا لین کے لحاظ سے فلٹرنگ سپورٹ کرتا ہے۔ Tasks پلگ ان ایموجی اشارے اور Dataview ان لائن فیلڈ فارمیٹس دونوں کو ہینڈل کرتا ہے۔ بار بار آنے والے کاموں کو مکمل کرنے سے اگلی تکرار پیدا ہوتی ہے؛ "On completion" ایکشن سپورٹ کرتا ہے۔ - **فائل تک رسائی**: غیر مارک ڈاؤن فائلیں پڑھتا ہے بشمول تصاویر (سرور سائیڈ پر چھوٹی کی گئیں)، PDFs (ٹیکسٹ نکالنا یا رینڈر شدہ صفحات)، کینوس (قابل پڑھنے والے خاکے)، اور ڈیٹا فائلیں (TXT, SVG, JSON, XML, CSV, YAML, logs, Bases)۔ - **لنک گراف**: والٹ میں بیک لنکس، آؤٹ گوئنگ لنکس، اور اورفن ڈٹیکشن۔ - **Obsidian-نیٹیو**: فرنٹ میٹر، وکی لنکس، ٹیگز، ہیڈنگز، اور ڈیلی نوٹس کو سمجھتا ہے۔ - **گائیڈڈ ورک فلو**: والٹ ہیلتھ، میموری ریویو، اور ڈیلی ریکنسلیشن کے لیے بلٹ ان پرامپٹس، جو لائیو والٹ ڈیٹا سے جمع کیے گئے ہیں۔ **تصدیق**: ریموٹ رسائی کے لیے OAuth 2.1 کو کونسینٹ پیجز کے ساتھ سپورٹ کرتا ہے، نیز OAuth کے بغیر کلائنٹس کے لیے Bearer ٹوکن۔ OAuth کلائنٹس کے لیے ٹوکن کی تجدید خودکار طریقے سے ہوتی ہے۔ **ڈیپلائمنٹ کے اختیارات**: - مقامی: Docker + والٹ فولڈر، `npx vault-cortex@latest init` کے ذریعے ترتیب دیا جاتا ہے - ریموٹ: Railway یا Render پر ایک کلک ڈیپلائمنٹ، یا کسی بھی Linux VPS پر Docker کے ساتھ سیلف ہوسٹڈ - ریموٹ ڈیپلائمنٹس والٹ کو مختلف آلات پر موجودہ رکھنے کے لیے Obsidian Sync استعمال کرتی ہیں **سیٹ اپ**: CLI سرور لائف سائیکل کا انتظام کرتا ہے (`configure`, `upgrade`, `start`, `restart`, `logs`, `down`)۔ دستی Docker Compose سیٹ اپ بھی دستیاب ہے۔ `/setup` صفحہ ریموٹ ڈیپلائمنٹس کے لیے Obsidian Sync سائن ان ہینڈل کرتا ہے۔ **سیکیورٹی**: Gitleaks اور Trivy اسکینز کے ساتھ CI، OpenSSF اسکور کارڈ اور بیسٹ پریکٹسز بیجز شامل ہیں۔ والٹ سادہ مارک ڈاؤن میں سچائی کا ذریعہ رہتا ہے؛ کنٹینر صرف ایک کاپی رکھتا ہے۔ **استعمال کے کیسز**: یورپ کے 15 دن کے سفر میں فون سے 30+ سیشنز، 216 ٹول کالز، صفر لیپ ٹاپ رسائی کے ساتھ آزمایا گیا۔ ایک سیشن میں لکھی گئی تحریریں اگلے سیشن میں شہروں اور دنوں کے درمیان فوری طور پر دستیاب تھیں۔