🇨🇳 中文 • 🇹🇼 繁體中文 • 🇯🇵 日本語 • 🇧🇷 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-Mem هو نظام متطور مصمم لضغط وحفظ الذاكرة لسياق عمل Claude Code. وظيفته الأساسية هي جعل "كلود" يتذكر ما فعله في جلسات العمل السابقة بسلاسة، عبر تسجيل تحركاته، وإنشاء ملخصات ذكية، واستدعائها في الجلسات المستقبلية. هذا يضمن عدم ضياع سياق المشروع حتى لو أغلقت البرنامج وفتحته لاحقاً.

للبدء، افتح "Claude Code" في مبنى الأوامر (Terminal) واكتب الأوامر التالية:

> /plugin marketplace add thedotmack/claude-mem

> /plugin install claude-mem

بمجرد إعادة تشغيل Claude Code، سيتم استدعاء السياق من الجلسات السابقة تلقائيا عند الحاجة.

الميزات الرئيسية:

• 🧠 ذاكرة مستديمه: سياق عملك لا ينتهي بانتهاء الجلسة، بل ينتقل معك للجلسة التالية.
• 📊 الكشف التدريجي (Progressive Disclosure): نظام ذكي يستدعي المعلومات على طبقات، مما يمنحك رؤية واضحة لاستهلاك الـ "Tokens" (التكلفة).
• 🔍 بحث سريع - استعلم عن سجل مشروعك باستخدام خاصية mem-search.
• 🖥️ واجهة مستخدم ويب - رؤية معلومات الذاكرة مع تحديث فوري عبر المتصفح من خلال الرابط: http://localhost:37777
• 💻 تكامل مع Claude Desktop - إمكانية البحث في الذاكرة مباشرة من واجهة Claude المكتبية
• 🔒 التحكم في الخصوصية - دعم وسم <private> لمنع النظام من تخزين أي معلومات حساسة.
• ⚙️ إعدادات السياق - تحكم دقيق في السياق (context) التي سيتم حقنها في سياق المحادثة.
• 🤖 أتمتة كاملة: - النظام يعمل في الخلفية دون الحاجة لتدخل يدوي منك.
• 🔗 الاستشهادات - رجوع إلى الملاحظات السابقة باستخدام (http://localhost:37777/api/observation/{id} أو عرض جميع المعلومات على http://localhost:37777)
• 🧪 مزايا التجريبيه - تجربة مميزات مثل "الوضع اللانهائي" (Endless Mode).

📚 عرض التوثيق الكامل - تصفح على الموقع الرسمي

• دليل التثبيت - البدء السريع والتثبيت المتقدم
• دليل الاستخدام - كيف يعمل Claude-Mem تلقائيًا
• أدوات البحث - استعلم عن سجل مشروعك بلغتك
• الميزات التجريبية - جرّب الميزات التجريبية مثل Endless Mode

• هندسة السياق - مبادئ تحسين سياق وكيل الذكاء الاصطناعي
• الكشف التدريجي - الفلسفة وراء استراتيجية تهيئة السياق في Claude-Mem

• نظرة عامة - مكونات النظام وتدفق البيانات
• تطور البنية المعمارية - تطور المعمارية من v3 إلى v5
• بنية برامج الربط (Hooks) - كيف يستخدم Claude-Mem خطافات دورة الحياة
• مرجع برامج الربط (Hooks) - شرح 7 سكريبتات خطافات
• خدمة العامل - HTTP API وإدارة Bun
• قاعدة البيانات - مخطط SQLite وبحث FTS5
• بنية البحث - البحث المختلط مع قاعدة بيانات المتجهات Chroma

• الإعدادات - متغيرات البيئة والإعدادات
• التطوير - البناء، الاختبار، سير العمل للمساهمة
• استكشاف الأخطاء وإصلاحها - المشكلات الشائعة والحلول

المكونات الأساسية:

1. 5 برامج ربط (Hooks) - SessionStart، UserPromptSubmit، PostToolUse، Stop، SessionEnd
2. تثبيت ذكي - فاحص التبعيات المخزنة مؤقتًا
3. خدمة العامل - HTTP API على المنفذ 37777 مع واجهة مستخدم عارض الويب و10 نقاط نهاية للبحث، تديرها Bun
4. قاعدة بيانات SQLite - تخزن الجلسات، الملاحظات، الملخصات
5. مهارة mem-search - استعلامات اللغة الطبيعية مع الكشف التدريجي
6. قاعدة بيانات المتجهات Chroma - البحث الدلالي الهجين + الكلمات المفتاحية لاسترجاع السياق الذكي

انظر نظرة عامة على البنية المعمارية للتفاصيل.

يوفر Claude-Mem بحثًا ذكيًا من خلال مهارة mem-search التي تُستدعى تلقائيًا عندما تسأل عن العمل السابق:

كيف يعمل:

• فقط اسأل بشكل طبيعي: "ماذا فعلنا في الجلسة الأخيرة؟" أو "هل أصلحنا هذا الخطأ من قبل؟"
• يستدعي Claude تلقائيًا خاصية mem-search للعثور على السياق ذي الصلة

عمليات البحث المتاحة:

1. البحث في الملاحظات - البحث النصي الكامل عبر الملاحظات
2. البحث في الجلسات - البحث النصي الكامل عبر ملخصات الجلسات
3. البحث في المطالبات - البحث في طلبات المستخدم الخام
4. حسب المفهوم - البحث بواسطة وسوم المفهوم (discovery، problem-solution، pattern، إلخ.)
5. حسب الملف - البحث عن الملاحظات التي تشير إلى ملفات محددة
6. حسب النوع - البحث حسب النوع (decision، bugfix، feature، refactor، discovery، change)
7. السياق الحديث - الحصول على سياق الجلسة الأخيرة لمشروع
8. الجدول الزمني - الحصول على جدول زمني موحد للسياق حول نقطة زمنية محددة
9. الجدول الزمني حسب الاستعلام - البحث عن الملاحظات والحصول على سياق الجدول الزمني حول أفضل تطابق
10. مساعدة API - الحصول على توثيق API البحث

أمثلة على الاستعلامات:

"What bugs did we fix last session?"
"How did we implement authentication?"
"What changes were made to worker-service.ts?"
"Show me recent work on this project"
"What was happening when we added the viewer UI?"

انظر دليل أدوات البحث لأمثلة مفصلة.

يقدم Claude-Mem قناة تجريبية بميزات تجريبية مثل Endless Mode (بنية ذاكرة بيوميمتية للجلسات الممتدة). بدّل بين الإصدارات المستقرة والتجريبية من واجهة مستخدم عارض الويب على http://localhost:37777 ← الإعدادات.

انظر توثيق الميزات التجريبية لتفاصيل حول Endless Mode وكيفية تجربته.

• Node.js: 18.0.0 أو أعلى
• Claude Code: أحدث إصدار مع دعم الإضافات
• Bun & uv: (يتم تثبيتهما تلقائياً) لإدارة العمليات والبحث المتجه.
• SQLite 3: للتخزين المستمر (مدمج)

تتم إدارة الإعدادات في ~/.claude-mem/settings.json (يتم إنشاؤه تلقائيًا بالقيم الافتراضية عند التشغيل الأول). قم بتكوين نموذج الذكاء الاصطناعي، منفذ العامل، دليل البيانات، مستوى السجل، وإعدادات حقن السياق.

انظر دليل الإعدادات لجميع الإعدادات المتاحة والأمثلة.

انظر دليل التطوير لتعليمات البناء، الاختبار، وسير عمل المساهمة.

إذا واجهت مشكلة، اشرحها لـ Claude وسيقوم بتشغيل خاصية troubleshoot لإصلاحها ذاتياً.

انظر دليل استكشاف الأخطاء وإصلاحها للمشكلات الشائعة والحلول.

أنشئ تقارير أخطاء شاملة باستخدام المولّد الآلي:

cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report

المساهمات مرحب بها! يُرجى:

1. عمل Fork للمشروع (Repository)
2. إنشاء فرع (branch)
3. إجراء التغييرات مع الاختبارات
4. تحديث المستندات عند الحاجه
5. تقديم Pull Request

انظر دليل التطوير لسير عمل المساهمة.

هذا المشروع مرخص بموجب ترخيص GNU Affero العام الإصدار 3.0 (AGPL-3.0).

حقوق النشر (C) 2025 Alex Newman (@thedotmack). جميع الحقوق محفوظة.

انظر ملف LICENSE للتفاصيل الكاملة.

ماذا يعني هذا:

• يمكنك استخدام وتعديل وتوزيع هذا البرنامج بحرية
• إذا قمت بتعديل ونشر على خادم شبكة، يجب أن تتيح كود المصدر الخاص بك
• الأعمال المشتقة يجب أن تكون مرخصة أيضًا تحت AGPL-3.0
• لا يوجد ضمان لهذا البرنامج

ملاحظة حول Ragtime: دليل ragtime/ مرخص بشكل منفصل تحت ترخيص PolyForm Noncommercial 1.0.0. انظر ragtime/LICENSE للتفاصيل.

• التوثيق: docs/
• المشكلات: GitHub Issues
• المستودع: github.com/thedotmack/claude-mem
• المؤلف: Alex Newman (@thedotmack)

مبني باستخدام Claude Agent SDK | مدعوم بواسطة Claude Code | صُنع باستخدام TypeScript