প্রকল্প সম্পর্কে

Vault Cortex একটি স্বতন্ত্র MCP (Model Context Protocol) সার্ভার যা AI এজেন্টদের Obsidian ভল্টে হাইব্রিড সার্চ, টাস্ক ম্যানেজমেন্ট, স্ট্রাকচার্ড মেমরি এবং রিড/রাইট অ্যাক্সেস প্রদান করে। এটি ডিস্কে সরাসরি `.md` ফাইলগুলোর উপর কাজ করে, কোনো Obsidian প্লাগইন বা চলমান ইনস্ট্যান্সের প্রয়োজন নেই। সার্ভারটি একটি একক Docker কন্টেইনারে চলে এবং লোকালি, VPS-এ সেলফ-হোস্টেড, অথবা রিমোট অ্যাক্সেসের জন্য Railway বা Render-এ ওয়ান-ক্লিক ডিপ্লয়মেন্টের মাধ্যমে ডিপ্লয় করা যায়। **মূল বৈশিষ্ট্য:** - **হাইব্রিড সার্চ**: FTS5 কীওয়ার্ড ম্যাচিং এবং ভেক্টর সেমান্টিক সাদৃশ্যকে Reciprocal Rank Fusion (RRF)-এর মাধ্যমে একত্রিত করে, যা ইন্টেন্ট-প্রধান কোয়েরির জন্য ক্রস-এনকোডার রির‍্যাংকিং দ্বারা পরিমার্জিত হয়। সব মডেল লোকালি চলে (~৪৫MB মোট, কোনো বাহ্যিক API নেই)। - **স্ট্রাকচার্ড মেমরি**: প্লেইন Markdown ফাইলে সংরক্ষিত একটি অ্যাপেন্ড-অনলি, তারিখযুক্ত এন্ট্রি সিস্টেম (ডিফল্ট `About Me/` ফোল্ডার)। টপিক রিকল সমস্ত মেমরি ফাইল জুড়ে প্রাসঙ্গিক এন্ট্রি পুনরুদ্ধার করে, বর্তমান অবস্থা এবং ঐতিহাসিক বিবর্তন দেখায়। প্রুনেবল বর্তমান-অবস্থা এন্ট্রির জন্য `entry-policy: living` সমর্থন করে। - **টাস্ক ম্যানেজমেন্ট**: Kanban-সচেতন টাস্ক কোয়েরি এবং আপডেট। স্ট্যাটাস, তারিখ, প্রায়োরিটি, ফোল্ডার বা লেন দ্বারা ফিল্টারিং সমর্থন করে। Tasks প্লাগইন ইমোজি সাইনিফায়ার এবং Dataview ইনলাইন-ফিল্ড ফরম্যাট উভয়ই হ্যান্ডেল করে। পুনরাবৃত্ত টাস্ক সম্পন্ন করলে পরবর্তী সংঘটন তৈরি হয়; "On completion" অ্যাকশন সমর্থন করে। - **ফাইল অ্যাক্সেস**: নন-মার্কডাউন ফাইল পড়ে, যার মধ্যে রয়েছে ছবি (সার্ভার-সাইডে ডাউনস্কেল করা), PDF (টেক্সট এক্সট্রাকশন বা রেন্ডার করা পৃষ্ঠা), ক্যানভাস (পাঠযোগ্য আউটলাইন), এবং ডেটা ফাইল (TXT, SVG, JSON, XML, CSV, YAML, লগ, Bases)। - **লিংক গ্রাফ**: ভল্ট জুড়ে ব্যাকলিংক, আউটগোয়িং লিংক এবং অরফান ডিটেকশন। - **Obsidian-নেটিভ**: ফ্রন্টম্যাটার, উইকিলিংক, ট্যাগ, হেডিং এবং ডেইলি নোট বোঝে। - **গাইডেড ওয়ার্কফ্লো**: ভল্ট হেলথ, মেমরি রিভিউ এবং ডেইলি রিকনসিলিয়েশনের জন্য বিল্ট-ইন প্রম্পট, লাইভ ভল্ট ডেটা থেকে সংকলিত। **অথেন্টিকেশন**: কনসেন্ট পেজসহ রিমোট অ্যাক্সেসের জন্য OAuth 2.1 সমর্থন করে, এবং OAuth ছাড়া ক্লায়েন্টদের জন্য Bearer টোকেন। OAuth ক্লায়েন্টদের জন্য টোকেন নবায়ন স্বয়ংক্রিয়ভাবে পরিচালিত হয়। **ডিপ্লয়মেন্ট অপশন**: - লোকাল: Docker + ভল্ট ফোল্ডার, `npx vault-cortex@latest init` এর মাধ্যমে সেটআপ - রিমোট: Railway বা Render-এ ওয়ান-ক্লিক ডিপ্লয়, অথবা Docker সহ যেকোনো Linux VPS-এ সেলফ-হোস্টেড - রিমোট ডিপ্লয়মেন্ট ডিভাইস জুড়ে ভল্ট হালনাগাদ রাখতে Obsidian Sync ব্যবহার করে **সেটআপ**: CLI সার্ভার লাইফসাইকেল পরিচালনা করে (`configure`, `upgrade`, `start`, `restart`, `logs`, `down`)। ম্যানুয়াল Docker Compose সেটআপও উপলব্ধ। `/setup`-এ একটি সেটআপ পেজ রিমোট ডিপ্লয়মেন্টের জন্য Obsidian Sync সাইন-ইন পরিচালনা করে। **নিরাপত্তা**: Gitleaks এবং Trivy স্ক্যানসহ CI, OpenSSF Scorecard এবং Best Practices ব্যাজ অন্তর্ভুক্ত। ভল্ট প্লেইন Markdown-এ সত্যের উৎস হিসেবে থাকে; কন্টেইনার শুধু একটি কপি ধারণ করে। **ব্যবহারের ক্ষেত্র**: ইউরোপ জুড়ে ১৫ দিনের একটি ভ্রমণে ফোন থেকে ৩০+ সেশন, ২১৬টি টুল কল, শূন্য ল্যাপটপ অ্যাক্সেস নিয়ে পরীক্ষিত। বিভিন্ন শহর ও দিনে এক সেশনে করা লেখা পরের সেশনেই তাৎক্ষণিকভাবে উপলব্ধ ছিল।