SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor

Memmy: ذاكرة محلية مشتركة لوكلاء الذكاء الاصطناعي

ثبّت Memmy من المصدر على Ubuntu، وشغّل خدمة الذاكرة على المنفذ 18960، لتخزين ملاحظات Claude Code وCodex وCursor محليًا في قاعدة SQLite واحدة.

Verified Every command ran end-to-end on a fresh Ubuntu 24.04 server, July 31, 2026.

ما هو Memmy وما الذي يخزنه

Memmy هو مركز ذاكرة محلي لوكلاء الذكاء الاصطناعي يعمل على خادمك الخاص (VPS). يحتفظ بقاعدة بيانات SQLite واحدة لما تعلمه وكلاؤك، ويقوم كل وكيل على الخادم بالقراءة والكتابة في نفس المخزن. المشروع memmy-agent من MemTensor، وهو مرخص برخصة MIT، ويحمل الإصدار 1.2.401 اعتباراً من 1 نوفمبر 2026؛ بينما يتم إصدار Memory بشكل مستقل برقم 2.1.7.

جزء فقط من المشروع يهمك على الخادم. يوفر Memmy خدمة ذاكرة تستمع على http://127.0.0.1:18960، وواجهة سطر أوامر (CLI) memmy-memory تتواصل مع تلك الخدمة، ومنصة عمل مكتبية. منصة العمل متاحة فقط لنظامي macOS وWindows، لذا على خادم Linux VPS، ستقوم بتشغيل الخدمة وواجهة سطر الأوامر فقط. هذا كافٍ لمنح Claude Code وCodex وCursor ذاكرة مشتركة.

يصنف Memmy ما يخزنه إلى أربع طبقات. تقوم طبقة Capture أولاً بتخزين Raw Turn منفصل، ثم تكتب عنصراً واحداً من نوع L1 Trace لكل خطوة ملتقطة، بما في ذلك الطلبات والاستجابات واستدعاءات الأدوات والنتائج. طبقة L2 Policy هي إجراء مستمد من المسارات التي أثبتت فائدتها. طبقة L3 World Model هي معرفة مستقرة حول مشروع أو بيئة ما. أما Skill فهي إجراء قابل للاستدعاء متبلور من سياسة معينة. تنشئ Capture مسارات L1، بينما تعمل المهام الخلفية على تطوير الطبقات الأعلى، ويمكن للكتابة الصريحة اختيار طبقة محددة. إذا بدت هذه الفروق مجردة، فاعلم أن الذاكرة هي واحدة من المراحل المتأخرة في مسار مرحلي لتعلم بناء الوكلاء، وتصبح الطبقات أكثر منطقية بمجرد أن تكتب حلقة وكيل بسيطة بنفسك وتراقبها وهي تنسى كل شيء بين عمليات التشغيل.

ما الذي يغيّره مركز الذاكرة المشتركة مقارنة بالذاكرة الخاصة بكل أداة

تحتفظ كل وكالة (agent) اليوم بذاكرتها الخاصة. يحتفظ Claude Code بملفات التعليمات داخل المستودع. ويحتفظ Cursor بالقواعد في قاعدة بيانات مساحة العمل الخاصة به. بينما يحتفظ Codex بسجلات الجلسة تحت ~/.codex. ينتمي كل مخزن إلى أداة واحدة، لذا فإن حقيقة علّمتها للأداة يوم الاثنين ستكون مجهولة يوم الثلاثاء في أداة أخرى. أنت تدفع ثمن ذلك مرتين: مرة في الرموز (tokens) التي تُستهلك في إعادة شرح نفس المشروع، ومرة في العمل الخاطئ عندما يتصرف الوكيل بناءً على افتراض قمت بتصحيحه بالفعل في مكان آخر.

ينقل المركز (hub) المخزن خارج الأداة. يقرأ Memmy أيضاً المخازن الموجودة، لذا فأنت لا تبدأ من قاعدة بيانات فارغة. يعرف الماسح الضوئي الخاص به عشرة مصادر مدمجة: Claude Code في ~/.claude/projects/**/*.jsonl، وCodex في ~/.codex/sessions/<YYYY>/<MM>/<DD>/rollout-*.jsonl، وOpenCode في ~/.local/share/opencode/opencode.db، وملفات state.vscdb الخاصة بـ Cursor، وقواعد بيانات SQLite الخاصة بـ OpenClaw تحت ~/.openclaw، وHermes تحت ~/.hermes، وDeepSeek Harness تحت ~/.dsh/sessions، وWorkBuddy تحت ~/.workbuddy/projects، وPi تحت ~/.pi/agent/sessions، وQwenWork تحت ~/.qwenworkcn/projects. يمكن لمنصة العمل المكتبية (desktop workbench) إضافة وكيل آخر بالاسم، وتطلب مسار سجله فقط عندما لا تستطيع العثور على الوكيل نفسه. لا يحتوي الماسح الضوئي من جانب الخادم على مصادر مخصصة، لذا على خادم VPS بدون واجهة رسومية ستحصل على المصادر المدمجة فقط.

لن تتطابق عدادات الاستيراد، وهذا أمر متوقع. يجمع الماسح الضوئي الرسائل حسب المصدر والمحادثة، ثم يكتب ذاكرة L1 واحدة لكل دورة (turn) كاملة. تُعتبر الدورة كاملة عندما تحتوي على محتوى مستخدم غير فارغ وتنتهي برسالة مساعد غير فارغة، لذا فإن الدورة غير المكتملة لا تضيف شيئاً حتى تتمكن مزامنة لاحقة من إكمالها. يتم إلغاء تكرار الرسائل باستخدام نقاط فحص المحادثة ومعرفات الدورات المستقرة. يختلف عدد العناصر الممسوحة ضوئياً، وعدد الرسائل المستوردة، وعدد الذاكرة الجديدة، كل ذلك في نفس التشغيل.

هذا هو الجزء الذي يقترن بـ كيفية إدارة Claude Code للسياق داخل جلسة واحدة. تقرر إدارة السياق ما يناسب نافذة واحدة. بينما يقرر مركز الذاكرة ما يبقى بعد إغلاق تلك النافذة.

ما تحتاجه على خادم VPS

  • إصدار Node.js 22 أو أحدث. تتطلب وثائق Memmy ذلك، بينما يأتي Ubuntu 24.04 بإصدار Node 18.
  • git وأدوات البناء (build toolchain)، لأن better-sqlite3 وحدة برمجية أصلية (native module) قد تحتاج إلى التجميع أثناء التثبيت.
  • ذاكرة وصول عشوائي (RAM) كافية لتثبيت مساحة العمل الجذرية وسلسلة بناء الواجهة الأمامية.
  • مساحة قرص فارغة لـ node_modules وقاعدة البيانات.
sudo apt update
sudo apt install -y git build-essential python3 curl ca-certificates sqlite3
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node --version

يجب أن يطبع node --version الإصدار v22 أو أعلى من أجل البناء من المصدر الموثق. ظهور v18 هنا يعني أن خطوة NodeSource لم تكتمل بنجاح. القيمة الافتراضية لـ engine-strict في npm هي false، لذا فإن تعارض تعريف المحرك (engine declaration) يؤدي عادةً إلى ظهور تحذير بدلاً من فشل التثبيت تلقائياً.

تثبيت Memmy من المصدر على Ubuntu 24.04

git clone https://github.com/MemTensor/memmy-agent.git
cd memmy-agent
cp .env.example .env
npm install
npm run memory:build

يقوم npm run memory:build بتجميع مساحة العمل @memmy/memory إلى Memory/dist. كما يقوم ببناء AgentSourceCore، وعارض الذاكرة، وأصول التكامل التي تحتاجها مساحة العمل تلك. تحقق من تحميل الوحدة الأصلية (native module):

node -e "const Database = require('better-sqlite3'); const db = new Database(':memory:'); db.close(); console.log('better-sqlite3 loads')"

إذا أدى هذا السطر إلى ظهور خطأ بدلاً من الطباعة، فاقرأ الخطأ لتحديد سبب فشل التحميل أو فشل تهيئة قاعدة البيانات. في حال وجود عدم توافق في الوحدة الأصلية، شغّل npm rebuild better-sqlite3، وهو بالضبط ما يقوم به نص التشغيل الخاص بالمشروع قبل إطلاق أي شيء.

يوثّق ملف README الأمر bash scripts/dev-start.sh كأمر تشغيل بضغطة واحدة. لا تقم بتشغيله على خادم افتراضي (VPS) بدون واجهة رسومية (headless). فهو يبدأ واجهة سطح المكتب Electron وخادم تطوير Vite على المنفذ 19000 بجانب خدمة الذاكرة، وتحتاج Electron إلى شاشة عرض، لذا سيتوقف النص أو يخرج عن العمل على خادم لا يحتوي على جلسة رسومية.

تتضمن الإصدارات الأخيرة أيضاً memmy-agent-linux-cli.tar.gz وinstall.sh لأنظمة Linux بمعمارية x64 وarm64. يحتاج المثبّت إلى Node.js بإصدار 22.23.4+ ضمن سلسلة 22.x، أو 24.22.1+ ضمن سلسلة 24.x، أو 26.12.1+ ضمن سلسلة 26.x، بالإضافة إلى جلسة مستخدم systemd؛ حيث يرفض المثبّت أي إصدارات رئيسية أخرى. يضع المثبّت مشغّلات memmy وmemmy-memory في ~/.local/bin، ويبدأ خدمة الذاكرة كوحدة مستخدم (user unit) على 127.0.0.1:18960. يلتزم هذا الدليل بالبناء من المصدر لأنه المسار الذي يتيح لك قراءة كل نص برمجي قبل تنفيذه.

بدء خدمة الذاكرة والتحقق من استجابتها

npm run memory:serve:dev

هذه هي الطريقة الموثقة لتشغيل خدمة الذاكرة من المصدر. فهي تربط 127.0.0.1:18960، وتحتفظ بقاعدة البيانات في ~/.memmy/memory-service/memory.sqlite، وتقرأ الإعدادات من ~/.memmy/config.yaml. يقبل الخادم نفس القيم كأعلام (flags) عندما ترغب في تحديدها صراحةً:

npm run memory:serve:dev -- \
  --host 127.0.0.1 --port 18960 \
  --db ~/.memmy/memory-service/memory.sqlite \
  --config ~/.memmy/config.yaml

من واجهة أوامر ثانية، اسأل الخدمة عما إذا كانت تعمل:

curl -sS http://127.0.0.1:18960/api/v1/health

لا تطلب نقطة النهاية الخاصة بالصحة (health) رمزاً مميزاً (token)، ولهذا السبب فهي الأداة المناسبة للفحص. إذا خرج أمر curl برمز الخطأ 7 مع رسالة Failed to connect to 127.0.0.1 port 18960، فهذا يعني فشل الاتصال؛ وهذا وحده لا يثبت وجود مستمع (listener) من عدمه. تحقق من العنوان والمنفذ وجدار الحماية المحلي، واقرأ مخرجات الطرفية التي تشغل الخدمة للبحث عن أخطاء بدء التشغيل. يؤكد ss -lntp | grep 18960 وجود المقبس (socket) بمجرد عمل الخدمة.

توجد بقية واجهة برمجة تطبيقات HTTP (application programming interface) تحت المسار /api/v1.

  • يكتب POST /api/v1/memory/add ذاكرة، ويستعلم POST /api/v1/memory/search عنها.
  • يقرأ GET /api/v1/memory/:id ويحذف DELETE /api/v1/memory/:id إدخالاً واحداً.
  • يحيط POST /api/v1/sessions/open وPOST /api/v1/sessions/:sessionId/close جلسة الوكيل (agent session).
  • يسجل POST /api/v1/turns/start وPOST /api/v1/turns/:turnId/complete دورة محادثة واحدة (turn).
  • يغذي GET /api/v1/panel/overview و/api/v1/panel/analysis و/api/v1/panel/items لوحة التحكم.

تحجز Memmy مجموعة من المنافذ، وفي وضع التشغيل بدون واجهة (headless) تستخدم المنفذ الأول فقط: 18960 للذاكرة، 18970 لصحة البوابة، 18980 لواجهة الويب وإدارة HTTP، 18990 لواجهة برمجة التطبيقات المتوافقة مع OpenAI التي يبدأها memmy serve، ثم 19000 لخادم تطوير Vite الخاص بواجهة سطح المكتب، و19001 لمقبس التحديث السريع الخاص بها. لا تزال صفحة المنافذ الخاصة بالمشروع تدرج 19010 للتحديث السريع، لكن إعدادات Vite تضبطه على 19001. إذا كان هناك شيء ما على جهازك يشغل أحد هذه المنافذ بالفعل، فهذه القائمة هي المكان الذي يجب أن تبحث فيه.

مصدر أمر memmy-memory الفعلي

هنا تقع معظم أخطاء التثبيت الأول، لذا اقرأه من الحزمة بدلاً من التخمين. اسم الأمر لا علاقة له باسم المستودع. إنه يأتي من حقل bin في مساحة العمل التي تعرّفه:

node -p "JSON.stringify(require('./Memory/package.json').bin)"

يطبع هذا الأمر {"memmy-memory":"./dist/src/cli/index.js"}. لذا فإن نقطة الدخول المبنية هي Memory/dist/src/cli/index.js، ولا توجد إلا بعد تنفيذ npm run memory:build، لأن عملية البناء هي التي تنشئ dist وتجعل الملف قابلاً للتنفيذ. شغّله مباشرة:

node Memory/dist/src/cli/index.js health

إذا أردت استخدام الاسم المختصر في مسار النظام PATH، قم بإنشاء رابط لهذا الملف نفسه:

sudo ln -s "$PWD/Memory/dist/src/cli/index.js" /usr/local/bin/memmy-memory
memmy-memory health

يستخدم واجهة سطر الأوامر (CLI) افتراضياً http://127.0.0.1:18960 ويقبل --url، و--token، و--config، و--source، و--user-id. أوامره الفرعية هي init، وhealth، وsearch، وadd، وget، وdelete، بالإضافة إلى استدعاءات session وturn التي تستخدمها الوكلاء (agents) بدلاً من البشر، وinstall، وupgrade، وservice، وstop لإدارة الخدمة نفسها. يعد memmy-memory search "deploy steps" وmemmy-memory add "staging migrates on deploy" هما الأمران الأكثر استخداماً من قبل الوكيل.

كيف تربط Claude Code بـ Memmy؟

لا يسجّل Memmy نفسه كخادم داخل Claude Code. بل يتصل عبر الملفات التي يقرؤها Claude Code بالفعل، ويعتمد مدى هذا الاتصال على memmy-memory الذي تشغله. من نسخة المصدر، يكتب memmy-memory init --agent claude مهارة memmy-memory في ~/.claude/skills/ وكتلة ذاكرة محددة في ~/.claude/CLAUDE.md، ثم يقوم Claude Code بتشغيل memmy-memory كأمر shell عادي عندما تطلب منه التعليمات ذلك. يذهب المشغّل (launcher) الذي يضعه مثبت Linux في ~/.local/bin إلى أبعد من ذلك: فالأمر نفسه يسجّل أيضاً خطافات (hooks) في ~/.claude/settings.json لكل من SessionStart وUserPromptSubmit وStop وPostCompact وSessionEnd، والتي تحقن الذاكرة ذات الصلة وتحفظ كل دورة مكتملة دون الحاجة إلى أن يقرر النموذج القيام بذلك.

اكتب التعليمات يدوياً مرة واحدة، لأنك حينها ستعرف بالضبط ما قيل للوكيل. يقرأ Claude Code ملف CLAUDE.md من جذر المشروع في بداية كل جلسة، لذا فإن قسماً كهذا يمثل التكامل الكامل في مسار المصدر:

## Memory

Before starting a task, run `memmy-memory search "<topic>"` and read what comes back.
When a task is done, run `memmy-memory add "<what you learned>"` for anything that will matter next session.

كن واضحاً بشأن ما يوفره لك هذا. بدون الخطافات، يكون التكامل على مستوى التعليمات، لذا فهو يعمل عندما يقرر النموذج تشغيل الأمر، وليس في غير ذلك. لا شيء يفرض الاستدعاء. إذا انتهت الجلسة دون add، فإن التعليمات نفسها لم تحفظ شيئاً؛ لا يزال بإمكان فحص السجل اللاحق استيراد الدورة المكتملة. هذا هو نفس المقايضة الموجودة في ملفات ذاكرة Claude Code الخاصة، مع اختلاف واحد: المتجر مشترك، لذا تصل الملاحظة أيضاً إلى Codex وCursor على نفس الجهاز. تغلق الخطافات الفجوة بدلاً من الطلب بلطف، وهذا هو السبب أيضاً في أن الذاكرة الدائمة توضع جنباً إلى جنب مع حدود الميزانية وقواعد الأذونات ضمن إضافات DeepSeek Harness التي تستحق التثبيت.

الاتجاه الآخر لا يحتاج إلى أي إعداد على الإطلاق. يقرأ ماسح Memmy بالفعل ~/.claude/projects/**/*.jsonl، وهو المكان الذي يكتب فيه Claude Code نصوص جلساته. شغّل Memmy على نفس الخادم الذي تشغّل عليه Claude Code داخل جلسة tmux وسيصبح عمل الأمس ذاكرة دون أن تضطر إلى تهيئة أي شيء.

هل يعمل Memmy كخادم MCP مع Claude Code؟

لا. ومعرفة ذلك توفر عليك وقتًا طويلًا. يتضمن MCP (بروتوكول سياق النموذج) عملاء وخوادم. Memmy عميل. يتصل بخوادم MCP ويتيح أدواتها لبيئة تشغيل وكيله. ولا ينشر نقطة نهاية MCP يمكن لـ claude mcp add الاتصال بها. جسر MCP الوحيد في المستودع تابع لتكامل Composio داخل واجهة API المحلية لتطبيق سطح المكتب، وتربط واجهة API هذه منفذًا عشوائيًا على 127.0.0.1 خلف ترويسة x-memmy-mcp-token الخاصة بها.

تُضبط جهة العميل في ~/.memmy/config.yaml، وهو الملف الذي يشير إليه MEMMY_CONFIG، ضمن tools.mcpServers:

tools:
  mcpServers:
    example:
      type: stdio
      command: npx
      args:
        - "-y"
        - "your-mcp-server"
      toolTimeout: 30
      enabledTools:
        - "*"

يقبل type القيم stdio وsse وstreamableHttp. يعمل خادم stdio كعملية فرعية لـ Memmy، ولذلك يجب أن يكون الأمر الخاص به موجودًا على الجهاز نفسه وأن يعمل باستخدام المستخدم نفسه. إذا كنت تشغّل خوادم MCP على VPS، فأدرجها هنا.

الحفاظ على خصوصية مخزن الذاكرة

كل ما يملكه Memmy يقع تحت ~/.memmy: config.yaml، ومساحة العمل، وmemory-service/memory.sqlite، وملفات وقت التشغيل. تتم عمليات المسح والاستيعاب محلياً، وتُكتب الذكريات في ملف SQLite المحلي ذلك، لذا فإن الوضع الافتراضي هو محلي بالكامل.

يُعد الاتصال السحابي مساراً واحداً يجب مراقبته. يحدد MEMMY_CLOUD_SERVICE مصدر السحابة. لا يضع الكود قيمة افتراضية له، ولكن .env.example، الذي تنسخه خطوات التثبيت إلى .env، يضبطه على https://api.memmy.cn. يدعم هذا الملف وضع الحساب مع رموز التجربة الخاصة به، وكلما تم ضبطه، يرسل كود التحليلات في Memmy أحداث الاستخدام إليه أيضاً، حتى في وضع مفتاح API: أسماء الأحداث والأوامر، والإصدارات، ومعرف التثبيت. لا يرسل واجهة سطر الأوامر (CLI) سوى كلمات الأوامر الثابتة، ولا يرسل أبداً استعلامات البحث أو نصوص الذاكرة، ولا يرسل كود التحليلات أي شيء عندما تكون القيمة غير مضبوطة، لذا على خادم يستخدم مفاتيح API فقط، أفرغ ذلك السطر في .env قبل البدء بأي شيء. برنامج تحسين الذاكرة هو خيار تبديل منفصل في إعدادات الخصوصية.

تُعد استدعاءات النموذج مساراً آخر. إذا قمت بتهيئة مزود تضمين (embedding) مستضاف، فسيتم إرسال نص الذاكرة الذي يتم تضمينه إلى ذلك المزود ليتحول إلى متجه (vector). التخزين المحلي لا يساعد في هذه الحالة. استخدم مزود التضمين المحلي المدمج أو نقطة نهاية تضمين تستضيفها بنفسك لإغلاق هذا المسار. تتلقى نماذج التلخيص والتطوير وفلتر الملاءمة المستضافة أيضاً محتوى الذاكرة عند تشغيل تلك المهام، لذا تحقق من إعدادات تلك النماذج أيضاً.

حافظ على المنفذ 18960 على عنوان الاسترجاع (loopback). لا يحتاج إلى قاعدة جدار ناري، لأن الخدمة المرتبطة بـ 127.0.0.1 لا يمكن الوصول إليها من خارج الجهاز على الإطلاق. بدلاً من ذلك، يمكنك الوصول إليها من حاسوبك المحمول عبر SSH:

ssh -N -L 18960:127.0.0.1:18960 you@your-vps

ترفض خدمة الذاكرة الحالية عناوين الربط غير الخاصة بالاسترجاع. إن ضبط storage.token في ملف الإعداد، أو متغير البيئة MEMMY_MEMORY_TOKEN أو MEMORY_SERVICE_TOKEN، يحمي استدعاءات API الخاصة بالذاكرة العادية باستخدام رمز حامل (bearer token)؛ تظل حالة الصحة (health) غير مصادق عليها، ويستخدم عارض المتصفح فحوصات منفصلة للطلبات المحلية. تدعم قيم الإعداد مراجع ${ENV_NAME}، بحيث يظل الرمز ومفاتيح API الخاصة بنموذجك خارج الملف نفسه. هذه هي نفس العادة المتبعة في إبقاء الأسرار خارج وكلاء الذكاء الاصطناعي في أي مكان آخر، وتُعد سياسة ufw الافتراضية للرفض هي خط دفاعك الأخير إذا غيّر إصدار مستقبلي عنوان الربط الافتراضي الخاص به.

انسخ ~/.memmy احتياطياً قبل الاعتماد عليه

memory.sqlite هو مخزن البيانات بالكامل. تعيش المتجهات (vectors) في الملف نفسه من خلال الامتداد sqlite-vec، لذا فإن ملفاً واحداً هو كل ما تحتاجه للنسخ الاحتياطي. نسخ الملف باستخدام cp أثناء كتابة الخدمة للبيانات قد يؤدي إلى قاعدة بيانات تالفة. استخدم أمر النسخ الاحتياطي الخاص بـ SQLite:

mkdir -p ~/memmy-backup
sqlite3 ~/.memmy/memory-service/memory.sqlite ".backup '$HOME/memmy-backup/memory.sqlite'"

ينتج هذا الأمر نسخة متسقة بينما تظل الخدمة قيد التشغيل. انقل النسخة خارج الخادم وفق جدول زمني، وهو الغرض من استخدام restic للتخزين خارج الموقع. فقدان config.yaml يعني خسارة إعدادات المزود التي يمكنك إعادة كتابتها. أما فقدان memory.sqlite فيعني خسارة الذكريات المسجلة منذ آخر نسخة احتياطية صالحة؛ تنشئ الخدمة أيضاً نسخة احتياطية محلية قبل ترحيل المخطط (schema migrations)، لكنها ليست نسخة خارجية حديثة.

تشغيل خدمة Memory تحت إدارة systemd

تتوقف npm run memory:serve:dev عند تشغيلها في shell بمجرد إغلاق الـshell. يضمن ملف الوحدة (unit file) بقاء الخدمة تعمل بعد إعادة التشغيل. تعمل الخدمة بصلاحيات المستخدم memmy، من نسخة مستخرجة في /opt/memmy، مع وجود ملفات الإعداد في المجلد الرئيسي (home) لذلك المستخدم. أوقف النسخة التي تعمل حالياً في الـshell، ثم انقل النسخة المستخرجة وملفات الإعداد، وقم بتحديث الرابط memmy-memory:

sudo useradd -m -s /bin/bash memmy
sudo mkdir -p /opt/memmy
sudo mv ~/memmy-agent /opt/memmy/memmy-agent
sudo chown -R memmy:memmy /opt/memmy
sudo ln -sfn /opt/memmy/memmy-agent/Memory/dist/src/cli/index.js /usr/local/bin/memmy-memory
sudo install -d -o memmy -g memmy -m 700 /home/memmy/.memmy
sudo install -o memmy -g memmy -m 600 ~/.memmy/config.yaml /home/memmy/.memmy/config.yaml
sudo install -d -m 755 /etc/memmy

تحتفظ الخدمة بقاعدة بياناتها في /home/memmy/.memmy، لذا ستبدأ بمخزن بيانات فارغ.

[Unit]
Description=Memmy memory service
After=network-online.target

[Service]
Type=simple
User=memmy
WorkingDirectory=/opt/memmy/memmy-agent
EnvironmentFile=/etc/memmy/memory.env
ExecStart=/usr/bin/npm run memory:serve:dev
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

لا تضع الرمز (token) داخل ملف الوحدة. ضعه في /etc/memmy/memory.env، واجعل ملكيته لـroot، مع ضبط الصلاحيات على 600:

MEMMY_CONFIG=/home/memmy/.memmy/config.yaml
MEMMY_MEMORY_TOKEN=replace-this-with-a-long-random-string
sudo systemctl daemon-reload
sudo systemctl enable --now memmy-memory
systemctl status memmy-memory --no-pager
curl -sS http://127.0.0.1:18960/api/v1/health

تعني status=203/EXEC في مخرجات الحالة أن systemd لم يتمكن من تشغيل ExecStart إطلاقاً، لذا تحقق من which npm: يكون المسار /usr/bin/npm في تثبيتات NodeSource، بينما يكون في مجلد المستخدم الرئيسي عند استخدام nvm، وهو مسار لن يجده systemd. الوحدة التي تبدأ ثم تتوقف فوراً تحتاج إلى فحص حالة الخروج (exit status) وسجلاتها: الكود 0 يعني خروجاً سليماً، بينما تشمل النتائج الأخرى رموز خروج غير صفرية، أو إشارات (signals)، أو انتهاء مهلة (timeouts). نفّذ journalctl -u memmy-memory -n 50 لعرض مخرجات الخدمة. الآلية هي نفسها المتبعة مع أي خدمة systemd أخرى على خادم VPS.

يوفر المشروع الآن بديلين على مستوى المستخدم. المسار المذكور في ملف README للبناء من المصدر هو memmy-memory install --service-only، والذي يقوم بتحميل بيئة تشغيل Memory المحددة (pinned) وتسجيل خدمة مستخدم، بينما يقوم مثبت Linux بإعداد memmy-memory.service كخدمة systemd --user. لا يقوم أي منهما بتفعيل خاصية linger، لذا نفّذ sudo loginctl enable-linger <user> لضمان استمرار عمل مدير خدمات ذلك المستخدم بعد تسجيل الخروج وبدئه عند الإقلاع.

ما لا يفعله Memmy حتى الآن

  • لا يوجد إصدار لسطح مكتب Linux. تغطي نصوص البرمجة الخاصة بالتغليف أنظمة macOS وWindows، لذا فإن بيئة العمل ومعالج الإعداد الأولي غير متاحين على الخادم نفسه. تتضمن خدمة الذاكرة الآن عارضاً للمتصفح على http://127.0.0.1:18960/viewer/، يمكن الوصول إليه عبر نفق SSH المذكور أعلاه. يحصل Linux على ملف tarball لواجهة سطر الأوامر وinstall.sh بدلاً من ذلك.
  • يقوم memory:serve:dev بتشغيل نقطة دخول TypeScript عبر tsx، وهو مسار تطوير. كما يوفر المستودع memory:serve للمخرجات المترجمة. شغّل npm run بدون وسائط لمعرفة النصوص البرمجية التي يحتوي عليها إصدارك الحالي فعلياً.
  • يبني الاسترجاع نافذة البحث الخاصة به من أحدث 2000 صف متجهي، ثم يطبق اختيار Top-K داخل تلك النافذة. في مخزن ضخم جداً، قد تظل الذاكرة القديمة خارج نطاق هذه النافذة.
  • يحدث التضمين (Embedding) بعد الالتقاط، ويذهب الفشل إلى قائمة انتظار إعادة المحاولة بدلاً من حظر دور الوكيل. قد لا تكون الذاكرة التي أضيفت قبل لحظات قابلة للعثور عليها بواسطة البحث المتجهي بعد.
  • الخادم الثاني الذي يمتلك قاعدة بيانات SQLite محلية خاصة به لديه ذاكرة منفصلة.

الإصدار 1.2.401 بتاريخ 1 نوفمبر 2026 لا يزال يصف مشروعاً ناشئاً يتطور بسرعة. تتغير الأعلام والمسارات وأسماء النصوص البرمجية بين الإصدارات. اقرأ حقل bin ومخرجات npm run في نسختك الخاصة بدلاً من الوثوق بأمر منسوخ من أي مكان، بما في ذلك هذا المستند.

FAQ

لماذا يُرجع فحص السلامة خطأ رفض الاتصال (connection refused)؟

يُشير رمز الخروج 7 من curl مع Failed to connect to 127.0.0.1 port 18960 إلى فشل الاتصال، ولا يحدد ما إذا كان Memmy متوقفاً، أو تعرّض لانهيار، أو يستمع على منفذ آخر، أو يتعذر الوصول إليه. تحقق من العنوان والمنفذ، ونفّذ ss -lntp | grep 18960، واقرأ مخرجات الطرفية أو السجل (journal) حيث بدأت الخدمة. إذا أبلغ السجل عن عدم تطابق في وحدة SQLite الأصلية، نفّذ npm rebuild better-sqlite3. تحقق أيضاً من إصدار Node لديك: تتطلب وثائق المصدر إصدار Node 22 أو أحدث، بينما يقبل مثبت Linux فقط إصدار Node.js 22.23.4+ ضمن سلسلة 22.x، أو 24.22.1+ ضمن سلسلة 24.x، أو 26.12.1+ ضمن سلسلة 26.x.

من أين يأتي الأمر memmy-memory بعد البناء من المصدر؟

يأتي من حقل bin في حزمة مساحة العمل @memmy/memory، وليس من اسم المستودع. نفّذ node -p "JSON.stringify(require('./Memory/package.json').bin)" داخل مجلد المشروع وسيطبع {"memmy-memory":"./dist/src/cli/index.js"}. هذا الملف لا يوجد إلا بعد npm run memory:build، لأن عملية البناء تنشئ dist وتجعل الملف قابلاً للتنفيذ. نفّذه بصيغة node Memory/dist/src/cli/index.js health، أو أنشئ رابطاً رمزياً (symlink) له في /usr/local/bin لاستخدام الاسم المختصر.

هل يمكنني إضافة Memmy إلى Claude Code باستخدام claude mcp add؟

لا. Memmy هو عميل MCP، وليس خادم MCP. هو يتصل بالخوادم المدرجة تحت tools.mcpServers في ~/.memmy/config.yaml ويوفر أدواتها لبيئة التشغيل الخاصة به. يصل Claude Code إلى Memmy بالاتجاه المعاكس، عن طريق تشغيل واجهة سطر الأوامر memmy-memory كأمر shell. يكتب memmy-memory init --agent claude مهارة (Skill) وكتلة CLAUDE.md تخبره متى يعمل، كما يضيف المشغّل من مثبت Linux خطافات (hooks) لـ Claude Code تحفظ أدوار المحادثة (turns) تلقائياً.

هل يؤدي تشغيل Memmy إلى إرسال ذكرياتي إلى خدمة سحابية؟

تتم عمليات المسح والاستيعاب محلياً، وتُكتب الذكريات في ~/.memmy/memory-service/memory.sqlite على قرصك الخاص. يقوم MEMMY_CLOUD_SERVICE، المضبوط على https://api.memmy.cn في .env.example، بخدمة وضع الحساب ورموز الفترة التجريبية، ويستقبل تحليلات الاستخدام دون نصوص الذكريات طالما أنه مضبوط، لذا أفرغه إذا كنت تستخدم مفاتيح API فقط. يحتوي برنامج تحسين الذاكرة على مفتاح تبديل منفصل للخصوصية. يستقبل نموذج التضمين (embedding model) المستضاف نص الذاكرة الذي يحوله إلى متجه؛ استخدم الموفر المحلي المدمج أو نقطة نهاية (endpoint) تشغلها بنفسك للحفاظ على معالجة البيانات محلياً. كما تستقبل نماذج التلخيص والتطوير وفلترة الملاءمة المستضافة محتوى الذاكرة عند تشغيل تلك المهام.

هل كان هذا المقال مفيدًا؟