SSD Nodes Learn Hosting plans →
الأدلة Matt Connorبقلم Matt Connor · آخر تحديث في 2026-10-21

هل يحمي Compartment ذاكرة الوكلاء دون اتصال؟

تعرّف إلى ما يحميه Compartment فعلياً بالتشفير المحلي، وما الذي يكشفه نموذج التهديد، ولماذا يعني فقدان عبارة المرور فقدان الذاكرة المشفّرة.

ما الذي يميز Compartment

Compartment هو مخزن لذاكرة الوكلاء يحافظ على تشفير كل سجل على الجهاز الذي أنشأه، ولا يتصل أبداً بخدمة شبكية. هناك خياران يميزانه عن بقية مجال ذاكرة الوكلاء. الخزنة عبارة عن ملف واحد مغلق لا تفتحه إلا عبارة المرور، وتعمل خطوة التضمين محلياً، لذلك لا يُرسل نص الذاكرة إلى أي مكان لتحويله إلى متجه. نُشر الإصدار 4.6.0 في 10 August 2026، وترخيصه Apache-2.0، ويُثبَّت من PyPI. صدرت إصدارات أحدث لاحقاً، واعتباراً من 12 October 2026 كان أحدث إصدار على PyPI هو 4.11.0، وقد صدر في 30 September 2026. يظل هذا الدليل مثبتاً على الإصدار 4.6.0.

هذا ادعاء متعلق بنموذج التهديد، ولذلك يتعامل معه هذا الدليل على هذا الأساس. يحمي التشفير أثناء السكون، إلى جانب التصميم غير المتصل، قائمة محددة من الأشياء. لكنه يترك أشياء أخرى مكشوفة، وتظهر مشكلات اليوم الثاني في هذه الفجوة.

يتبع هذا الدليل وثائق المشروع الخاصة بالإصدار 4.6.0، وقد أُعيدت قراءتها آخر مرة في 12 October 2026. يوفّر Compartment تطبيقاً لسطح المكتب، وعنصراً في شريط القوائم على macOS، وأيقونة في منطقة الإعلام على Windows، إلى جانب أداة سطر الأوامر الخاصة به. ولا يمكن تشغيل مطالبة عبارة المرور من حاوية مؤتمتة. تعامل مع ما يلي على أنه سلوك موثق، لا سلوكاً جرى قياسه هنا. شغّله على جهاز احتياطي قبل أن تثق به مع أي بيانات فعلية.

ما الذي تحميه التشفير أثناء التخزين فعلياً

تُشفَّر الخزنة باستخدام XChaCha20-Poly1305، وهو تشفير AEAD (تشفير موثَّق مع بيانات مرتبطة)، بينما تُغلَّف خانات المفاتيح التي تحتوي على المفتاح الرئيسي باستخدام Argon2id، وهي دالة تجزئة كلمات مرور صُممت لتكون بطيئة وتحتاج إلى قدر كبير من الذاكرة. وينتج عن ذلك أمران. تصبح نسخة الملف الموجودة على قرص مسروق، أو في نسخة احتياطية قديمة، أو مرفقة بتذكرة دعم، مجرد وحدات بايت لا أكثر. كما يؤدي تغيير بت واحد إلى فشل المصادقة عند فتح الملف، فتظهر حالة التلف كخطأ واضح بدلاً من إنتاج إجابة خاطئة.

تُشفَّر متجهات التضمين أيضاً، وهذا أهم مما يبدو. فالتضمين ليس تجزئة. أظهرت أبحاث عكس التضمين إمكانية استعادة أجزاء قابلة للقراءة من النص الأصلي اعتماداً على متجهه وحده، ولذلك فإن وجود فهرس متجهات غير مشفَّر بجانب قاعدة بيانات مشفَّرة يشبه تقريباً ترك قاعدة البيانات مفتوحة. لا يكتب Compartment أي فهرس بنص واضح على القرص.

الحذف هو حذف فعلي. يحمل كل سجل مفتاحه الخاص، وتدمّر compartment forget --shred ذلك المفتاح، ولذلك لا يمكن لأي شخص فك تشفير النص المشفَّر المتبقي، بما في ذلك أنت. قارن ذلك بصف محذوف من ملف قاعدة بيانات، إذ يبقى عادة قابلاً للقراءة في الصفحات الحرة إلى أن تستبدله بيانات أخرى.

والعمل دون اتصال هو النصف الآخر من الحماية. لا يُرفع أي شيء، لذلك لا توجد حسابات لدى مورّد تحتفظ بذكرياتك، ولا يوجد مفتاح API يمكن أن يسرّبها.

ما الذي لا تحميه الحاوية

ينتهي هذا الادعاء عند حدود الخزنة، وهذه الحدود أقرب مما تبدو.

يقرأ الوكيل النص الواضح. يفك Recall تشفير الذاكرة ويسلّم النص إلى الوكيل. إذا كان هذا الوكيل نموذجاً مستضافاً، تنتقل الذاكرة إلى مزوّد النموذج داخل الطلب التالي، تماماً مثل كل ما يوجد في نافذة السياق. تحمي التشفيرة أثناء السكون الملف، لكنها لا تحمي عملية الاسترجاع. لذلك لا تصبح قواعد إبقاء الأسرار خارج وكلاء الذكاء الاصطناعي أقل صرامة لأن مخزن البيانات مشفّر: فكلمة المرور المحفوظة كذاكرة هي كلمة مرور رتّبتَ لصقها في الطلب تلقائياً.

الخزنة غير المقفلة على جهاز قيد التشغيل مفتوحة. توضح ملاحظات أمان المشروع ذلك صراحةً. عندما تكون الخزنة غير مقفلة، يوجد المفتاح الرئيسي ومجموعة العمل في RAM، ولا تستطيع Python ضمان محو المخزن المؤقت، وقد تكتب swap أو صورة الإسبات تلك الذاكرة إلى القرص. لا يحتاج برنامج ضار يعمل بحسابك إلى كسر التشفير، لأنه يستطيع طلب البيانات من الخزنة المفتوحة مسبقاً.

هوية المستدعي تصريحية. يمكن تقييد namespaces لكل مستدعٍ، لكن اسم المستدعي يصل من العملية المضيفة. لذلك يحصل المضيف الذي يكذب بشأن اسمه على المنح التي يدّعيها. تمثل صلاحيات namespaces تنظيماً، وليست حداً أمنياً في مواجهة برنامج محلي خبيث.

لا يمكن للإتلاف الوصول إلى النسخ. forget --shred يتلف المفتاح داخل الملف الحالي. وتظل النسخة الاحتياطية المأخوذة قبل الإتلاف تحتوي على ذلك السجل، وتظل قابلة للفتح بعبارة المرور الخاصة بذلك اليوم.

تنهي عبارة المرور الضعيفة النقاش. تجعل Argon2id كل تخمين مكلفاً. لكنها لا تنقذ عبارة مرور تظهر في قائمة كلمات.

تثبيت Compartment من إصدار مثبت

يتطلب Compartment الإصدار Python 3.11 أو أحدث. يتحرك المشروع بسرعة، إذ صدر 23 إصداراً على PyPI بين 26 July و10 August 2026، وبلغ العدد 35 إصداراً بحلول 12 October 2026. لذلك ثبّت الإصدار بدلاً من استخدام الإصدار المتاح في يوم التثبيت.

python3 --version
pip install "compartment==4.6.0"
compartment --version
compartment init

يجب أن يطبع compartment --version الإصدار الذي ثبّتَّه. إذا أجاب shell بـ compartment: command not found، فدليل التثبيت ليس موجوداً في PATH الخاص بك، ويكون هذا الدليل في معظم الأنظمة ~/.local/bin. يتولى pipx install compartment==4.6.0 وuv tool install compartment==4.6.0 إدارة مساراتهما الخاصة، ولذلك يتجنبان هذه المشكلة.

يطلب compartment init إدخال عبارة المرور مرتين ولا يعرض أي أحرف. عبارة المرور هذه هي المفتاح الوحيد. لا ينشئ المشروع كلمة مرور ولا عبارة استرداد، وهذا مقصود: فلا توجد بيانات اعتماد يحتفظ بها البرنامج ولا تملكها أنت.

تحقق من النتيجة قبل ربط أي شيء به.

compartment status

تُظهر الخزنة السليمة أنها غير مقفلة. إذا أظهرت أنها مقفلة، فشغّل compartment unlock وأدخل عبارة المرور. يؤدي إعادة التشغيل إلى قفلها مرة أخرى، لأن بيانات الاعتماد التي تُبقيها مفتوحة تعتمد على سر خاص بكل إقلاع. على macOS، يتيح compartment unlock --keychain استمرار فتحها بعد إعادة التشغيل من خلال تخزين بيانات الاعتماد في سلسلة مفاتيح النظام.

أين توجد البيانات فعلياً

المخزن الافتراضي هو ~/.compartment/memory.vault. حدّد موقعاً آخر باستخدام --vault PATH مع أي أمر، أو باستخدام متغير البيئة COMPARTMENT_VAULT.

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

والنتيجة المفيدة هي أن برنامج النسخ الاحتياطي ينسخ مساراً واحداً بالضبط. أما الجانب غير المريح فهو أنك لا تستطيع استخدام grep عليه، ولا إصلاحه في محرر نصوص. إذا أردت ذكريات يمكنك قراءتها باستخدام cat وإيداعها في git، فإن ملفات Memmy المحلية للذكريات بنص عادي تقدم المقايضة المعاكسة. كلا الخيارين معقول، بحسب ما تخشاه: حاسوب محمول مسروق أم أداة تتعطل.

يزيل compartment uninstall البرنامج ويُبقي المخزن. مرّر --purge فقط عندما يكون ذلك مقصوداً.

ربطه بوكيل

يربط أمر واحد عميلاً مدعوماً.

compartment integrate --list
compartment integrate claude

بالنسبة إلى Claude Code، ينشئ هذا الأمر إدخال خادم MCP (بروتوكول سياق النموذج) وhook باسم PostToolUse داخل ~/.claude/settings.json، بعد أخذ نسخة احتياطية من الملف أولاً. كما يثبّت مهارة /compartmentalize في ~/.claude/skills/، ويضيف كتلة مُدارة إلى ~/.claude/CLAUDE.md لإبلاغ الوكيل بأن Compartment يحل محل الذاكرة المستندة إلى الملف التي كان يستخدمها. تحقّق من الجزأين:

compartment hook status
compartment recent

لتسجيل الخادم يدوياً بدلاً من ذلك:

claude mcp add --scope user compartment -- \
    compartment --vault ~/.compartment/memory.vault --caller claude-code serve

يستخدم أي مضيف آخر يدعم MCP الخادم نفسه مع اسم المستدعي الخاص به.

{ "mcpServers": { "compartment": {
    "command": "compartment",
    "args": ["--vault", "/path/to/memory.vault",
             "--caller", "your-agent-name", "serve"] } } }

امنح كل مضيف قيمة --caller مختلفة. هذه هي التسمية التي يسجلها سجل التدقيق، كما أنها المفتاح الذي تُكتب مقابله منح مساحة الأسماء. لذلك، يجعل الاسم المشترك كلا الاستخدامين عديم الفائدة.

إذا كان Claude Code قد بدأ بكتابة الحقائق في ملفات الذاكرة الخاصة به، فسيعرض compartment import-claude --dry-run ما سينتقل قبل نقل أي شيء. اقرأ أولاً ما الذي يحتفظ به Claude Code في ملفات الذاكرة الخاصة به، لأن استيراد ملاحظات سنة كاملة إلى مخزن جديد هو الطريقة التي تمتلئ بها الذاكرة بأشياء لم يقصد أحد الاحتفاظ بها.

ما مدى سرعة مخزن محلي

هذه هي الأرقام التي ينشرها المشروع لمخزن بحجم شخصي. وهي مأخوذة من وثائقه، وليست ناتجة عن اختبار أُجري هنا.

رسم بيانيCompartment published local latency, milliseconds
البيانات وراء هذا الرسم البياني
[
  {
    "label": "Store one memory, end to end",
    "latency_ms": 40
  },
  {
    "label": "Embed one memory, bundled model",
    "latency_ms": 25
  },
  {
    "label": "Hybrid search, median",
    "latency_ms": 11.6
  },
  {
    "label": "Vector search at 20k records, p95",
    "latency_ms": 0.68
  }
]

يُقدَّر زمن تخزين ذاكرة واحدة بـ 40 مللي ثانية، بينما يستغرق البحث المتجهي عبر عشرين ألف سجل 0.68 مللي ثانية عند المئين 95. ويستند المشروع في تبريره للإبقاء على الذاكرة محلية إلى حساب بسيط: غالباً ما تستغرق رحلة شبكة واحدة ذهاباً وإياباً إلى واجهة برمجة ذاكرة مستضافة وقتاً أطول من الوسيط البالغ 11.6 مللي ثانية لعملية بحث هجينة كاملة هنا.

يفسّر تفصيلان في التصميم أرقام البحث. عندما يقل عدد السجلات عن عشرين ألفاً، يقارن Compartment الاستعلام بكل متجه، ولذلك يكون الاسترجاع دقيقاً بحكم التصميم وليس تقريبياً. وعندما يتجاوز العدد ذلك، ينتقل إلى HNSW (عالم صغير هرمي قابل للتنقل)، وهو فهرس تقريبي يبادل جزءاً صغيراً من دقة الاسترجاع بزيادة السرعة. كما يسجل المخزن تجزئة SHA-256 لنموذج التضمين، ويرفض الفتح باستخدام نموذج مختلف، لأن مقارنة متجهات ناتجة عن نموذجين مختلفين قد تتم من دون ظهور أي خطأ، وعندها لا تعني الدرجات الناتجة شيئاً.

النسخ الاحتياطية، والنسخة التي ستظل قادراً على فتحها في العام المقبل

الخزنة المقفلة هي ملف واحد قابل للنقل، لذا فإن نقلها يعني إنشاء نسخة منها.

compartment lock
scp ~/.compartment/memory.vault other-machine:
compartment --vault memory.vault unlock

أقفلها أولاً. قد يؤدي النسخ أثناء كتابة الوكيل إلى التقاط إدخال في السجل أثناء إلحاقه. ورغم أن تأطير CRC يتيح للقارئ تخطي هذا الجزء الأخير غير المكتمل، فإن الذاكرة الموجودة داخله تضيع. يختم compartment lock --sign الملف ببيان Ed25519، وبذلك يمكن للجهاز المستقبل التحقق من وصول النسخة سليمة من دون امتلاك عبارة المرور.

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

تحذيران. لا يصل الحذف الآمن إلى النسخ الاحتياطية، لذلك يظل السجل الذي حُذف تشفيرياً اليوم قابلاً للقراءة في نسخة الأسبوع الماضي لأي شخص يملك عبارة مرور الأسبوع الماضي. كما أن compartment export --plaintext يكتب الخزنة كاملةً دون تشفير، وهذا هو الأداة المناسبة للترحيل إلى نظام آخر، لكنه الملف الخطأ الذي يُترك في ~/Downloads.

احتفظ بعدد قليل من النسخ وأضف إليها التواريخ. يتحول مخزن الذاكرة إلى عبء عندما لا يحذف أحد النسخ القديمة، وهذا هو سبب تسميم ذكريات الوكيل القديمة لنتائج الاسترجاع بهدوء.

التعامل مع المفاتيح وتدويرها والعامل الثاني

compartment rekey
compartment 2fa enable
compartment 2fa status

يغيّر rekey عبارة المرور عبر إعادة تغليف المفتاح الرئيسي في خانة المفاتيح للملف الحالي. تحتفظ النسخ القديمة بعبارة المرور القديمة، لأن وحدات البايت فيها أُغلقت قبل التغيير، ولا توجد آلية تعود لتعديلها. دوّر النسخ أيضاً، أو تقبّل أن عبارة مرور متوقفة عن الاستخدام ما زالت تفتح شيئاً ما.

يضيف 2fa enable ملف مفتاح بوصفه عاملاً ثانياً، ويجمعه مع عبارة المرور أثناء اشتقاق المفتاح، ولذلك يلزم كلاهما لفتح الخزنة. هذا يضاعف أيضاً عدد الأشياء التي قد تفقدها. احتفظ بملف المفتاح خارج الجهاز الذي يحتوي على الخزنة.

بالنسبة إلى البرامج النصية وCI (التكامل المستمر)، يمكن أن تصل عبارة المرور عبر متغير البيئة COMPARTMENT_PASSPHRASE، ويقرأها unlock --passphrase-stdin من pipe. استخدم pipe متى أمكن. يمكن للعمليات الأخرى التي يملكها المستخدم نفسه قراءة متغير البيئة، كما ينتهي به المطاف غالباً في سجلات المهام.

يرتبط سجل التدقيق بسلسلة من قيم hash، ويمر compartment audit verify عبر السجل ويُبلغ عن أول رابط مكسور. شغّله بعد أي استعادة، لأن الملف المقتطع بصمت يظهر عندها.

ماذا يحدث عند فقدان عبارة المرور

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

لذلك، لا تتعلق خطة الاسترداد بالخزنة، بل بعبارة المرور. سجّلها في مدير كلمات مرور في اليوم الذي تشغّل فيه compartment init. ثم اختبرها: اقفل الخزنة، وافتحها باستخدام ما دوّنته فقط، ودع عميلاً يبدأ بملئها بعد نجاح ذلك.

Compartment أم خادم ذاكرة

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

عندما تحتاج عدة أجهزة إلى الذاكرة نفسها في الوقت نفسه، فهذه مشكلة خادم. يجيب خادم Mem0 مستضاف ذاتياً على VPS عن هذه الحاجة: نقطة نهاية واحدة، وعدة عملاء، وذاكرة تبقى بعد مغادرة الحاسوب المحمول. يجب توضيح التكلفة. يشغّل ذلك الخادم عملية يمكنها قراءة البيانات التي يخزنها، لذلك يشمل نموذج التهديد لديك الآن VPS وكل من يمكنه الوصول إلى API الخاص به.

اختر بناءً على الخسارة التي تخشاها فعلاً. إذا كانت الخسارة المحتملة هي سرقة حاسوب محمول أو قراءة مورّد لملاحظاتك، فستكون الخزنة المحلية المشفّرة الخيار الأقوى. وإذا كانت الخسارة هي أن ينسى الوكيل كل شيء فور انتقالك بين الأجهزة، فالحل هو الخادم.

FAQ

ما الذي يحميه تشفير Compartment فعلياً؟

يحمي الملف. تُغلق الخزنة باستخدام XChaCha20-Poly1305، وتُغلّف خانات مفاتيحها باستخدام Argon2id، كما تُشفّر متجهات التضمين أيضاً. لذلك ينتج عن قرص مسروق أو نسخة احتياطية قديمة بيانات ثنائية لا يمكن قراءة شيء منها. لكنه لا يحمي خزنة غير مقفلة على جهاز قيد التشغيل، لأن المفتاح الرئيسي يبقى في RAM أثناء فتح الخزنة. كما أنه لا يتحكم فيما يفعله الوكيل بالذاكرة بعد إعادتها كنص واضح.

إذا كان Compartment غير متصل، فهل تكون ذاكرتي خاصة ولا يراها موفّر النموذج؟

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

ماذا يحدث إذا فقدت عبارة مرور Compartment؟

تصبح الخزنة غير قابلة للاسترداد، وهذا مقصود. لا ينشئ Compartment بذرة أو عبارة استرداد، ولا يحتفظ ببيانات اعتماد لا تملكها أنت، لذلك لا يوجد شيء يمكن إعادة ضبطه. ضع عبارة المرور في مدير كلمات مرور، واحتفظ بأي ملف مفتاح 2FA خارج الجهاز الذي يخزن الخزنة، وتأكد من قدرتك على فتح نسخة منها قبل أن تحتوي الخزنة على أي شيء ستفتقده.

هل يمكن لجهازين مشاركة خزنة Compartment واحدة؟

ليس في الوقت نفسه. الخزنة المقفلة ملف محمول واحد، والمسار الموثق هو قفلها، ثم نسخها، ثم فتحها على الجهاز الآخر باستخدام --vault. تغطي الوثائق قفل الملف الاستشاري الذي ينظّم عمليات الكتابة بالتتابع للوكلاء على جهاز واحد فقط. ولا تغطي أي شيء يتعلق بكتابة جهازين في ملف واحد، لذلك تعامل مع هذا الإعداد على أنه طريقة لفقدان الذاكرة. شغّل خادم ذاكرة عندما تحتاج إلى ذلك.

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

#agent-memory#compartment#encryption#offline#privacy