f3fa5601d5
README badges, system requirements, translated README copies, and public docs had drifted from package.json. Align them with version 13.4.0 and the Node >=20 engine requirement, and make the hook overview count explicit as Setup plus five lifecycle events. Constraint: package.json is the source of truth for current package version and engine requirements Rejected: Update only the root README | translated README files would still publish stale requirements Confidence: high Scope-risk: narrow Directive: Keep README badges and requirements synchronized with package.json during version or engine bumps Tested: rg found no remaining version-6.5.0, node >=18 badge, Node 18.0.0 requirement, or Hook System (5 events) references under README.md docs package.json Not-tested: Full docs build
22 KiB
🌐 এটি একটি স্বয়ংক্রিয় অনুবাদ। সম্প্রদায়ের সংশোধন স্বাগত জানাই!
🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 Português • 🇰🇷 한국어 • 🇪🇸 Español • 🇩🇪 Deutsch • 🇫🇷 Français 🇮🇱 עברית • 🇸🇦 العربية • 🇷🇺 Русский • 🇵🇱 Polski • 🇨🇿 Čeština • 🇳🇱 Nederlands • 🇹🇷 Türkçe • 🇺🇦 Українська • 🇻🇳 Tiếng Việt • 🇮🇩 Indonesia • 🇹🇭 ไทย • 🇮🇳 हिन्दी • 🇧🇩 বাংলা • 🇵🇰 اردو • 🇷🇴 Română • 🇸🇪 Svenska • 🇮🇹 Italiano • 🇬🇷 Ελληνικά • 🇭🇺 Magyar • 🇫🇮 Suomi • 🇩🇰 Dansk • 🇳🇴 Norsk
Claude Code-এর জন্য নির্মিত স্থায়ী মেমরি কম্প্রেশন সিস্টেম।
দ্রুত শুরু • এটি কীভাবে কাজ করে • অনুসন্ধান টুল • ডকুমেন্টেশন • কনফিগারেশন • সমস্যা সমাধান • লাইসেন্স
Claude-Mem স্বয়ংক্রিয়ভাবে টুল ব্যবহারের পর্যবেক্ষণ ক্যাপচার করে, সিমান্টিক সারসংক্ষেপ তৈরি করে এবং সেগুলি ভবিষ্যতের সেশনে উপলব্ধ করে সেশন জুড়ে প্রসঙ্গ নির্বিঘ্নে সংরক্ষণ করে। এটি Claude কে সেশন শেষ হওয়ার বা পুনঃসংযোগের পরেও প্রকল্প সম্পর্কে জ্ঞানের ধারাবাহিকতা বজায় রাখতে সক্ষম করে।
দ্রুত শুরু
টার্মিনালে একটি নতুন Claude Code সেশন শুরু করুন এবং নিম্নলিখিত কমান্ডগুলি প্রবেশ করান:
> /plugin marketplace add thedotmack/claude-mem
> /plugin install claude-mem
Claude Code পুনরায় চালু করুন। পূর্ববর্তী সেশনের প্রসঙ্গ স্বয়ংক্রিয়ভাবে নতুন সেশনে উপস্থিত হবে।
মূল বৈশিষ্ট্যসমূহ:
- 🧠 স্থায়ী মেমরি - প্রসঙ্গ সেশন জুড়ে টিকে থাকে
- 📊 প্রগতিশীল প্রকাশ - টোকেন খরচ দৃশ্যমানতা সহ স্তরযুক্ত মেমরি পুনরুদ্ধার
- 🔍 দক্ষতা-ভিত্তিক অনুসন্ধান - mem-search skill দিয়ে আপনার প্রকল্পের ইতিহাস অনুসন্ধান করুন
- 🖥️ ওয়েব ভিউয়ার UI - http://localhost:37777 এ রিয়েল-টাইম মেমরি স্ট্রিম
- 💻 Claude Desktop Skill - Claude Desktop কথোপকথন থেকে মেমরি অনুসন্ধান করুন
- 🔒 গোপনীয়তা নিয়ন্ত্রণ - সংবেদনশীল বিষয়বস্তু স্টোরেজ থেকে বাদ দিতে
<private>ট্যাগ ব্যবহার করুন - ⚙️ প্রসঙ্গ কনফিগারেশন - কোন প্রসঙ্গ ইনজেক্ট করা হবে তার উপর সূক্ষ্ম নিয়ন্ত্রণ
- 🤖 স্বয়ংক্রিয় অপারেশন - কোন ম্যানুয়াল হস্তক্ষেপ প্রয়োজন নেই
- 🔗 উদ্ধৃতি - ID দিয়ে পূর্ববর্তী পর্যবেক্ষণ রেফারেন্স করুন (http://localhost:37777/api/observation/{id} এর মাধ্যমে অ্যাক্সেস করুন অথবা http://localhost:37777 এ ওয়েব ভিউয়ারে সব দেখুন)
- 🧪 বিটা চ্যানেল - ভার্সন পরিবর্তনের মাধ্যমে Endless Mode-এর মতো পরীক্ষামূলক বৈশিষ্ট্য চেষ্টা করুন
ডকুমেন্টেশন
📚 সম্পূর্ণ ডকুমেন্টেশন দেখুন - অফিসিয়াল ওয়েবসাইটে ব্রাউজ করুন
শুরু করা
- ইনস্টলেশন গাইড - দ্রুত শুরু এবং উন্নত ইনস্টলেশন
- ব্যবহার গাইড - Claude-Mem কীভাবে স্বয়ংক্রিয়ভাবে কাজ করে
- অনুসন্ধান টুল - প্রাকৃতিক ভাষা দিয়ে আপনার প্রকল্পের ইতিহাস অনুসন্ধান করুন
- বিটা বৈশিষ্ট্য - Endless Mode-এর মতো পরীক্ষামূলক বৈশিষ্ট্য চেষ্টা করুন
সর্বোত্তম অনুশীলন
- প্রসঙ্গ ইঞ্জিনিয়ারিং - AI এজেন্ট প্রসঙ্গ অপটিমাইজেশন নীতি
- প্রগতিশীল প্রকাশ - Claude-Mem-এর প্রসঙ্গ প্রাইমিং কৌশলের পিছনে দর্শন
আর্কিটেকচার
- সারসংক্ষেপ - সিস্টেম উপাদান এবং ডেটা ফ্লো
- আর্কিটেকচার বিবর্তন - v3 থেকে v5 পর্যন্ত যাত্রা
- হুকস আর্কিটেকচার - Claude-Mem কীভাবে লাইফসাইকেল হুক ব্যবহার করে
- হুকস রেফারেন্স - ৭টি হুক স্ক্রিপ্ট ব্যাখ্যা করা হয়েছে
- ওয়ার্কার সার্ভিস - HTTP API এবং Bun ম্যানেজমেন্ট
- ডাটাবেস - SQLite স্কিমা এবং FTS5 অনুসন্ধান
- অনুসন্ধান আর্কিটেকচার - Chroma ভেক্টর ডাটাবেস সহ হাইব্রিড অনুসন্ধান
কনফিগারেশন এবং ডেভেলপমেন্ট
- কনফিগারেশন - পরিবেশ ভেরিয়েবল এবং সেটিংস
- ডেভেলপমেন্ট - বিল্ডিং, টেস্টিং, অবদান
- সমস্যা সমাধান - সাধারণ সমস্যা এবং সমাধান
এটি কীভাবে কাজ করে
মূল উপাদানসমূহ:
- ৫টি লাইফসাইকেল হুক - SessionStart, UserPromptSubmit, PostToolUse, Stop, SessionEnd (৬টি হুক স্ক্রিপ্ট)
- স্মার্ট ইনস্টল - ক্যাশড ডিপেন্ডেন্সি চেকার (প্রি-হুক স্ক্রিপ্ট, লাইফসাইকেল হুক নয়)
- ওয়ার্কার সার্ভিস - ওয়েব ভিউয়ার UI এবং ১০টি অনুসন্ধান এন্ডপয়েন্ট সহ পোর্ট 37777-এ HTTP API, Bun দ্বারা পরিচালিত
- SQLite ডাটাবেস - সেশন, পর্যবেক্ষণ, সারসংক্ষেপ সংরক্ষণ করে
- mem-search Skill - প্রগতিশীল প্রকাশ সহ প্রাকৃতিক ভাষা প্রশ্ন
- Chroma ভেক্টর ডাটাবেস - বুদ্ধিমান প্রসঙ্গ পুনরুদ্ধারের জন্য হাইব্রিড সিমান্টিক + কীওয়ার্ড অনুসন্ধান
বিস্তারিত জানতে আর্কিটেকচার সারসংক্ষেপ দেখুন।
অনুসন্ধান টুল
Claude-Mem, mem-search skill-এর মাধ্যমে বুদ্ধিমান অনুসন্ধান প্রদান করে যা আপনি পূর্ববর্তী কাজ সম্পর্কে জিজ্ঞাসা করলে স্বয়ংক্রিয়ভাবে চালু হয়:
এটি কীভাবে কাজ করে:
- শুধু স্বাভাবিকভাবে জিজ্ঞাসা করুন: "গত সেশনে আমরা কী করেছিলাম?" অথবা "আমরা কি আগে এই বাগটি ঠিক করেছিলাম?"
- Claude স্বয়ংক্রিয়ভাবে প্রাসঙ্গিক প্রসঙ্গ খুঁজে পেতে mem-search skill চালু করে
উপলব্ধ অনুসন্ধান অপারেশনসমূহ:
- অবজারভেশন অনুসন্ধান করুন - পর্যবেক্ষণ জুড়ে পূর্ণ-পাঠ্য অনুসন্ধান
- সেশন অনুসন্ধান করুন - সেশন সারসংক্ষেপ জুড়ে পূর্ণ-পাঠ্য অনুসন্ধান
- প্রম্পট অনুসন্ধান করুন - কাঁচা ব্যবহারকারী অনুরোধ অনুসন্ধান করুন
- ধারণা অনুযায়ী - ধারণা ট্যাগ দ্বারা খুঁজুন (discovery, problem-solution, pattern, ইত্যাদি)
- ফাইল অনুযায়ী - নির্দিষ্ট ফাইল উল্লেখ করা পর্যবেক্ষণ খুঁজুন
- টাইপ অনুযায়ী - টাইপ দ্বারা খুঁজুন (decision, bugfix, feature, refactor, discovery, change)
- সাম্প্রতিক প্রসঙ্গ - একটি প্রকল্পের জন্য সাম্প্রতিক সেশন প্রসঙ্গ পান
- টাইমলাইন - সময়ের একটি নির্দিষ্ট বিন্দুর চারপাশে প্রসঙ্গের একীভূত টাইমলাইন পান
- প্রশ্ন দ্বারা টাইমলাইন - পর্যবেক্ষণ অনুসন্ধান করুন এবং সেরা মিলের চারপাশে টাইমলাইন প্রসঙ্গ পান
- API সহায়তা - অনুসন্ধান API ডকুমেন্টেশন পান
প্রাকৃতিক ভাষা প্রশ্নের উদাহরণ:
"গত সেশনে আমরা কোন বাগ ঠিক করেছিলাম?"
"আমরা কীভাবে অথেন্টিকেশন প্রয়োগ করেছি?"
"worker-service.ts-এ কী পরিবর্তন করা হয়েছিল?"
"এই প্রকল্পে সাম্প্রতিক কাজ দেখান"
"ভিউয়ার UI যোগ করার সময় কী হচ্ছিল?"
বিস্তারিত উদাহরণের জন্য অনুসন্ধান টুল গাইড দেখুন।
বিটা বৈশিষ্ট্য
Claude-Mem একটি বিটা চ্যানেল অফার করে যাতে Endless Mode-এর মতো পরীক্ষামূলক বৈশিষ্ট্য রয়েছে (বর্ধিত সেশনের জন্য বায়োমিমেটিক মেমরি আর্কিটেকচার)। http://localhost:37777 → Settings-এ ওয়েব ভিউয়ার UI থেকে স্থিতিশীল এবং বিটা সংস্করণের মধ্যে স্যুইচ করুন।
Endless Mode এবং এটি কীভাবে চেষ্টা করবেন সে সম্পর্কে বিস্তারিত জানতে বিটা বৈশিষ্ট্য ডকুমেন্টেশন দেখুন।
সিস্টেম প্রয়োজনীয়তা
- Node.js: 20.0.0 বা উচ্চতর
- Claude Code: প্লাগইন সাপোর্ট সহ সর্বশেষ সংস্করণ
- Bun: JavaScript রানটাইম এবং প্রসেস ম্যানেজার (অনুপস্থিত থাকলে স্বয়ংক্রিয়ভাবে ইনস্টল হয়)
- uv: ভেক্টর অনুসন্ধানের জন্য Python প্যাকেজ ম্যানেজার (অনুপস্থিত থাকলে স্বয়ংক্রিয়ভাবে ইনস্টল হয়)
- SQLite 3: স্থায়ী স্টোরেজের জন্য (বান্ডল করা)
কনফিগারেশন
সেটিংস ~/.claude-mem/settings.json-এ পরিচালিত হয় (প্রথম রানে ডিফল্ট সহ স্বয়ংক্রিয়ভাবে তৈরি হয়)। AI মডেল, ওয়ার্কার পোর্ট, ডেটা ডিরেক্টরি, লগ লেভেল এবং প্রসঙ্গ ইনজেকশন সেটিংস কনফিগার করুন।
সমস্ত উপলব্ধ সেটিংস এবং উদাহরণের জন্য কনফিগারেশন গাইড দেখুন।
ডেভেলপমেন্ট
বিল্ড নির্দেশাবলী, টেস্টিং এবং অবদান ওয়ার্কফ্লোর জন্য ডেভেলপমেন্ট গাইড দেখুন।
সমস্যা সমাধান
যদি সমস্যার সম্মুখীন হন, Claude-কে সমস্যাটি বর্ণনা করুন এবং troubleshoot skill স্বয়ংক্রিয়ভাবে নির্ণয় করবে এবং সমাধান প্রদান করবে।
সাধারণ সমস্যা এবং সমাধানের জন্য সমস্যা সমাধান গাইড দেখুন।
বাগ রিপোর্ট
স্বয়ংক্রিয় জেনারেটর দিয়ে বিস্তৃত বাগ রিপোর্ট তৈরি করুন:
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
অবদান
অবদান স্বাগত জানাই! অনুগ্রহ করে:
- রিপোজিটরি ফর্ক করুন
- একটি ফিচার ব্র্যাঞ্চ তৈরি করুন
- টেস্ট সহ আপনার পরিবর্তনগুলি করুন
- ডকুমেন্টেশন আপডেট করুন
- একটি Pull Request জমা দিন
অবদান ওয়ার্কফ্লোর জন্য ডেভেলপমেন্ট গাইড দেখুন।
License
This project is licensed under the Apache License 2.0 (Apache-2.0).
Copyright (C) 2025 Alex Newman (@thedotmack). All rights reserved.
See the LICENSE file for full details.
Apache-2.0 allows broad use, modification, distribution, and commercial use, subject to its terms.
Ragtime note: The ragtime/ directory is licensed under the Apache License 2.0. See ragtime/LICENSE for details.
সাপোর্ট
- ডকুমেন্টেশন: docs/
- ইস্যু: GitHub Issues
- রিপোজিটরি: github.com/thedotmack/claude-mem
- লেখক: Alex Newman (@thedotmack)
Claude Agent SDK দিয়ে নির্মিত | Claude Code দ্বারা চালিত | TypeScript দিয়ে তৈরি