{"title":"نموذج الذاكرة","slug":"memory-model","category":"concepts","summary":"كيف تُنظَّم الذكريات — الفئات، المفاتيح، الوسوم، الأولويات، المصادر، التحقق.","audience":["human","llm"],"tags":["concept","memory","model","structure"],"difficulty":"intermediate","updated":"2026-06-27","word_count":679,"read_minutes":3,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# نموذج الذاكرة\n\nنموذج ذاكرة Synapse مصمم لوكلاء LLM — منظّم بما يكفي\nللاستدعاء الموثوق، ومرن بما يكفي لأي مجال.\n\n## تشريح الذاكرة\n\n```json\n{\n \"id\": \"mem_abc123\",\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed on vps1. CI green.\",\n \"tags\": [\"synapse\", \"deployment\", \"v1.5.0\"],\n \"priority\": \"high\",\n \"source\": \"agent\",\n \"verified\": false,\n \"confidence\": 0.85,\n \"expires_at\": null,\n \"mind_id\": \"m_xyz789\",\n \"created_at\": \"2026-06-27T...\",\n \"updated_at\": \"2026-06-27T...\"\n}\n```\n\n## الحقول\n\n| الحقل | النوع | مطلوب | الوصف |\n|-------|------|----------|-------------|\n| `id` | string | تلقائي | معرّف فريد (mem_xxx) |\n| `category` | enum | ✅ | واحدة من 8 فئات |\n| `key` | string | ✅ | مُعرّف ثابت (يُستخدم للتحديثات) |\n| `content` | string | ✅ | محتوى الذاكرة (أي نص) |\n| `tags` | string[] | – | للبحث والتصفية |\n| `priority` | enum | – | low، normal، high، critical (افتراضي: normal) |\n| `source` | enum | تلقائي | user، agent (من خزّنها) |\n| `verified` | bool | تلقائي | هل تحقق منها إنسان؟ |\n| `confidence` | float | – | 0.0 إلى 1.0 (افتراضي: 1.0 للمستخدم، 0.7 للوكيل) |\n| `expires_at` | timestamp | – | متى تُنسى هذه الذاكرة |\n| `mind_id` | string | تلقائي | أي عقل يملكها |\n| `created_at` | timestamp | تلقائي | أول تخزين |\n| `updated_at` | timestamp | تلقائي | آخر تعديل |\n\n## الفئات\n\nثماني فئات تغطي حالات استخدام وكلاء LLM الشائعة:\n\n| الفئة | الغرض | مثال على المحتوى |\n|----------|---------|-----------------|\n| `identity` | من هو المستخدم | \"User is Michael Schäfer, software engineer in Berlin\" |\n| `preference` | تفضيلات المستخدم | \"Prefers concise technical responses\" |\n| `fact` | حقائق قابلة للتحقق | \"Office is in Berlin, timezone Europe/Berlin\" |\n| `project` | حالة المشروع | \"Synapse v1.5.0 deployed, working on v1.6.0 docs\" |\n| `skill` | مهارات المستخدم | \"Advanced Python, 10+ years\" |\n| `mistake` | أخطاء سابقة | \"Forgot to bump npm version — CI failed\" |\n| `context` | سياق الجلسة | \"Currently reviewing PR #42\" |\n| `note` | ملاحظات متفرقة | \"Try Redis for caching next sprint\" |\n\n## المفاتيح: مُعرّفات ثابتة\n\nالحقل `key` حاسم — فهو كيف تُحدّث الذكريات دون إنشاء\nمكررات.\n\n```python\n# التخزين الأول\nstore(\"project\", \"project_synapse_status\", \"v1.4.0 deployed\", priority=\"high\")\n\n# التحديث بنفس المفتاح (يستبدل، لا يكرر)\nstore(\"project\", \"project_synapse_status\", \"v1.5.0 deployed\", priority=\"high\")\n```\n\n**قواعد المفتاح:**\n\n- يجب أن يكون فريدًا ضمن (الفئة، العقل)\n- استخدم `snake_case`\n- أضف بادئة الفئة للوضوح: `preference_communication`، `mistake_npm_version`\n- أبقِه ثابتًا — لا تغيّر المفاتيح بعد الإنشاء\n\n## الوسوم: للبحث\n\nتُمكّن الوسوم التصفية والبحث السريع:\n\n```bash\n# إيجاد جميع الذكريات بالوسم \"docker\"\nGET /memory/by-tag?tag=docker\n\n# بحث FTS5 ضمن مجموعة موسومة\nGET /memory/search?q=swarm&tag=docker\n```\n\n**أفضل ممارسات الوسوم:**\n\n- 2-5 وسوم لكل ذاكرة (لا تفرط في الوسم)\n- أحرف صغيرة للاتساق\n- استخدم أسماء المشاريع، المواضيع، التقنيات\n- الوسوم غير حساسة لحالة الأحرف\n\n## مستويات الأولوية\n\n| الأولوية | متى تُستخدم | سلوك الاستدعاء |\n|----------|-------------|-----------------|\n| `critical` | الهوية، القانونية، غير القابلة للتراجع | دائمًا في أعلى الاستدعاء |\n| `high` | المشاريع النشطة، التفضيلات الأساسية | بارز في الاستدعاء |\n| `normal` | معظم الذكريات (افتراضي) | ترتيب استدعاء قياسي |\n| `low` | عابرة، جيد معرفتها | قد تُلخّص |\n\nيُرتّب `/memory/recall` حسب الأولوية (critical أولًا)، ثم حسب الأحدث.\n\n## المصدر: المستخدم مقابل الوكيل\n\nتُوسم الذكريات بـ `source`:\n\n- `user` — خزّنها إنسان (عبر JWT أو واجهة الإنسان)\n- `agent` — خزّنها وكيل LLM (عبر Mind Key)\n\nيؤثر هذا على:\n\n- **التحقق**: ذكريات `user` مُتحقّق منها تلقائيًا، ذكريات `agent` لا\n- **الثقة**: `user` افتراضي 1.0، `agent` 0.7\n- **الاستدعاء**: يعلّم `/memory/recall` الذكريات غير المُتحقّق منها بـ \"(unverified)\"\n\n> [!NOTE]\n> تعامل مع ذكريات المصدر `agent` بقدر مناسب من الشك. قد تكون\n> مستنتجة أو مفترضة بدلًا من ذكرها مباشرة من المستخدم.\n\n## التحقق\n\nتشير علامة `verified` إلى أن إنسانًا أكّد الذاكرة:\n\n- ذكريات `user`: مُتحقّق منها تلقائيًا (`true`)\n- ذكريات `agent`: غير مُتحقّق منها افتراضيًا (`false`)\n\nتحقق من الذكريات عبر:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n -H \"Authorization: Bearer YOUR_JWT\"\n```\n\n> [!NOTE]\n> يتطلب التحقق JWT (مصادقة الإنسان)، وليس Mind Key (مصادقة الوكيل). هذا\n> يضمن أن البشر فقط يمكنهم تعليم الذكريات كمُتحقّق منها.\n\n## الثقة\n\nيشير الحقل `confidence` (0.0 إلى 1.0) إلى موثوقية الذاكرة:\n\n- 1.0 — ذُكرت مباشرة من المستخدم\n- 0.7 — مستنتجة بواسطة الوكيل\n- 0.5 — غير مؤكدة، تحتاج تحققًا\n- 0.0 — مشكوك فيها صراحة\n\nعيّن الثقة عند التخزين:\n\n```json\n{\n \"category\": \"preference\",\n \"key\": \"prefers_dark_mode\",\n \"content\": \"User seems to prefer dark mode (based on their IDE screenshots)\",\n \"confidence\": 0.5,\n \"source\": \"agent\"\n}\n```\n\n## الانتهاء\n\nعيّن `expires_at` للذكريات الحساسة للوقت:\n\n```json\n{\n \"category\": \"context\",\n \"key\": \"current_meeting_topic\",\n \"content\": \"Discussing Q3 roadmap\",\n \"expires_at\": \"2026-06-28T00:00:00Z\"\n}\n```\n\nالذكريات المنتهية لا يُرجعها `/memory/recall` (لكنها لا تزال موجودة في DB).\nاستخدم `/memory/expiring?within=7d` لرؤية الذكريات التي تنتهي قريبًا.\n\n## دورة حياة الذاكرة\n\n```\n ┌─────────────────┐\n │ Create │\n │ POST /memory │\n └────────┬────────┘\n │\n ▼\n ┌─────────────────┐\n │ Active │ ◀──── PUT /memory/:id (update)\n │ (in recall) │\n └────────┬────────┘\n │\n ┌────────────┼────────────┐\n │ │ │\n ▼ ▼ ▼\n ┌──────────┐ ┌──────────┐ ┌──────────┐\n │ Expired │ │ Verified │ │ Deleted │\n │ (in DB) │ │ (flag) │ │ (gone) │\n └──────────┘ └──────────┘ └──────────┘\n```\n\n## سلوك الاستدعاء\n\nيُرجع `GET /memory/recall` ملخصًا نصيًا عاديًا مُحسّنًا لسياق LLM:\n\n```\nMind: Michael's Mind\nMemories: 12 total (10 verified, 2 unverified)\n\n[001] identity (CRITICAL) [verified]\n user_name\n Michael Schäfer\n Tags: person, identity\n\n[002] preference (HIGH) [verified]\n communication_style\n Prefers concise technical responses\n Tags: communication\n\n[003] project (HIGH) [unverified]\n synapse_status\n v1.5.0 deployed, working on v1.6.0 docs\n Tags: synapse, deployment\n\n...\n```\n\n- مُرتّب حسب الأولوية (critical → low)، ثم حسب الأحدث\n- الذكريات غير المُتحقّق منها معلّمة بـ `[unverified]`\n- الوسوم مضمنة للسياق\n- نص عادي (لا حاجة لتحليل JSON)\n\n## الخطوات التالية\n\n- [Memory API](/docs/api/memory)\n- [أفضل ممارسات الذاكرة](/docs/guides/memory-best-practices)\n- [بحث FTS5](/docs/concepts/fts5-search)\n","content_html":"

نموذج الذاكرة

\n

نموذج ذاكرة Synapse مصمم لوكلاء LLM — منظّم بما يكفي\nللاستدعاء الموثوق، ومرن بما يكفي لأي مجال.

\n

تشريح الذاكرة

\n
{\n  "id": "mem_abc123",\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed on vps1. CI green.",\n  "tags": ["synapse", "deployment", "v1.5.0"],\n  "priority": "high",\n  "source": "agent",\n  "verified": false,\n  "confidence": 0.85,\n  "expires_at": null,\n  "mind_id": "m_xyz789",\n  "created_at": "2026-06-27T...",\n  "updated_at": "2026-06-27T..."\n}

الحقول

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
الحقلالنوعمطلوبالوصف
idstringتلقائيمعرّف فريد (mem_xxx)
categoryenum✅واحدة من 8 فئات
keystring✅مُعرّف ثابت (يُستخدم للتحديثات)
contentstring✅محتوى الذاكرة (أي نص)
tagsstring[]–للبحث والتصفية
priorityenum–low، normal، high، critical (افتراضي: normal)
sourceenumتلقائيuser، agent (من خزّنها)
verifiedboolتلقائيهل تحقق منها إنسان؟
confidencefloat–0.0 إلى 1.0 (افتراضي: 1.0 للمستخدم، 0.7 للوكيل)
expires_attimestamp–متى تُنسى هذه الذاكرة
mind_idstringتلقائيأي عقل يملكها
created_attimestampتلقائيأول تخزين
updated_attimestampتلقائيآخر تعديل
\n

الفئات

\n

ثماني فئات تغطي حالات استخدام وكلاء LLM الشائعة:

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
الفئةالغرضمثال على المحتوى
identityمن هو المستخدم"User is Michael Schäfer, software engineer in Berlin"
preferenceتفضيلات المستخدم"Prefers concise technical responses"
factحقائق قابلة للتحقق"Office is in Berlin, timezone Europe/Berlin"
projectحالة المشروع"Synapse v1.5.0 deployed, working on v1.6.0 docs"
skillمهارات المستخدم"Advanced Python, 10+ years"
mistakeأخطاء سابقة"Forgot to bump npm version — CI failed"
contextسياق الجلسة"Currently reviewing PR #42"
noteملاحظات متفرقة"Try Redis for caching next sprint"
\n

المفاتيح: مُعرّفات ثابتة

\n

الحقل key حاسم — فهو كيف تُحدّث الذكريات دون إنشاء\nمكررات.

\n
# التخزين الأول\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# التحديث بنفس المفتاح (يستبدل، لا يكرر)\nstore("project", "project_synapse_status", "v1.5.0 deployed", priority="high")

قواعد المفتاح:

\n\n

الوسوم: للبحث

\n

تُمكّن الوسوم التصفية والبحث السريع:

\n
# إيجاد جميع الذكريات بالوسم "docker"\nGET /memory/by-tag?tag=docker\n\n# بحث FTS5 ضمن مجموعة موسومة\nGET /memory/search?q=swarm&tag=docker

أفضل ممارسات الوسوم:

\n\n

مستويات الأولوية

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
الأولويةمتى تُستخدمسلوك الاستدعاء
criticalالهوية، القانونية، غير القابلة للتراجعدائمًا في أعلى الاستدعاء
highالمشاريع النشطة، التفضيلات الأساسيةبارز في الاستدعاء
normalمعظم الذكريات (افتراضي)ترتيب استدعاء قياسي
lowعابرة، جيد معرفتهاقد تُلخّص
\n

يُرتّب /memory/recall حسب الأولوية (critical أولًا)، ثم حسب الأحدث.

\n

المصدر: المستخدم مقابل الوكيل

\n

تُوسم الذكريات بـ source:

\n\n

يؤثر هذا على:

\n\n
تعامل مع ذكريات المصدر `agent` بقدر مناسب من الشك. قد تكون\nمستنتجة أو مفترضة بدلًا من ذكرها مباشرة من المستخدم.

التحقق

\n

تشير علامة verified إلى أن إنسانًا أكّد الذاكرة:

\n\n

تحقق من الذكريات عبر:

\n
curl -X POST https://synapse.schaefer.zone/memory/mem_001/verify \\\n  -H "Authorization: Bearer YOUR_JWT"
يتطلب التحقق JWT (مصادقة الإنسان)، وليس Mind Key (مصادقة الوكيل). هذا\nيضمن أن البشر فقط يمكنهم تعليم الذكريات كمُتحقّق منها.

الثقة

\n

يشير الحقل confidence (0.0 إلى 1.0) إلى موثوقية الذاكرة:

\n\n

عيّن الثقة عند التخزين:

\n
{\n  "category": "preference",\n  "key": "prefers_dark_mode",\n  "content": "User seems to prefer dark mode (based on their IDE screenshots)",\n  "confidence": 0.5,\n  "source": "agent"\n}

الانتهاء

\n

عيّن expires_at للذكريات الحساسة للوقت:

\n
{\n  "category": "context",\n  "key": "current_meeting_topic",\n  "content": "Discussing Q3 roadmap",\n  "expires_at": "2026-06-28T00:00:00Z"\n}

الذكريات المنتهية لا يُرجعها /memory/recall (لكنها لا تزال موجودة في DB).\nاستخدم /memory/expiring?within=7d لرؤية الذكريات التي تنتهي قريبًا.

\n

دورة حياة الذاكرة

\n
                  ┌─────────────────┐\n                  │     Create      │\n                  │  POST /memory   │\n                  └────────┬────────┘\n                           │\n                           ▼\n                  ┌─────────────────┐\n                  │     Active      │ ◀──── PUT /memory/:id (update)\n                  │  (in recall)    │\n                  └────────┬────────┘\n                           │\n              ┌────────────┼────────────┐\n              │            │            │\n              ▼            ▼            ▼\n        ┌──────────┐ ┌──────────┐ ┌──────────┐\n        │ Expired  │ │ Verified │ │ Deleted  │\n        │ (in DB)  │ │ (flag)   │ │ (gone)   │\n        └──────────┘ └──────────┘ └──────────┘

سلوك الاستدعاء

\n

يُرجع GET /memory/recall ملخصًا نصيًا عاديًا مُحسّنًا لسياق LLM:

\n
Mind: Michael's Mind\nMemories: 12 total (10 verified, 2 unverified)\n\n[001] identity (CRITICAL) [verified]\n  user_name\n  Michael Schäfer\n  Tags: person, identity\n\n[002] preference (HIGH) [verified]\n  communication_style\n  Prefers concise technical responses\n  Tags: communication\n\n[003] project (HIGH) [unverified]\n  synapse_status\n  v1.5.0 deployed, working on v1.6.0 docs\n  Tags: synapse, deployment\n\n...
\n

الخطوات التالية

\n\n","urls":{"html":"/docs/concepts/memory-model","text":"/docs/concepts/memory-model?format=text","json":"/docs/concepts/memory-model?format=json","llm":"/docs/concepts/memory-model?format=llm"},"translations_available":["en","zh","hi","es","fr","ar","pt","ru","ja","de","it","ko","nl","pl","tr","sv","vi","th","id","uk"]}