{"title":"أفضل ممارسات الذاكرة","slug":"memory-best-practices","category":"guides","summary":"كيف تُنظَّم الذكريات للاستدعاء الفعال — الفئات، المفاتيح، الوسوم، الأولويات.","audience":["human","llm"],"tags":["guide","memory","best-practices","patterns"],"difficulty":"intermediate","updated":"2026-06-27","word_count":603,"read_minutes":3,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# أفضل ممارسات الذاكرة\n\nكيف تُنظَّم الذكريات يحدد مدى فائدتها. يغطي هذا الدليل\nأنماط تصنيف ووسم وأولوية الذكريات حتى يستطيع الـ LLM\nاستدعاء المعلومة الصحيحة في الوقت المناسب.\n\n## الفئات: اختر الأكثر تحديدًا\n\n| الفئة | استخدم لـ | مثال |\n|----------|---------|---------|\n| `identity` | اسم المستخدم، الدور، معلومات الاتصال | `\"user_name\": \"Michael Schäfer\"` |\n| `preference` | الإعجابات، عدم الإعجابات، أسلوب العمل | `\"communication\": \"Prefers concise responses\"` |\n| `fact` | حقائق قابلة للتحقق | `\"office_location\": \"Berlin, Germany\"` |\n| `project` | حالة المشروع، القرارات | `\"project_synapse\": \"v1.5.0 deployed\"` |\n| `skill` | مهارات المستخدم | `\"skill_python\": \"Advanced, 10+ years\"` |\n| `mistake` | أخطاء سابقة يجب تجنبها | `\"mistake_npm_version\": \"Always bump version\"` |\n| `context` | سياق ذو صلة بالجلسة | `\"current_focus\": \"Working on docs system\"` |\n| `note` | ملاحظات متفرقة | `\"note_idea\": \"Try Redis for caching\"` |\n\n> [!TIP]\n> عند الشك، استخدم `fact` للمعلومات القابلة للتحقق و `note` لكل شيء آخر.\n> لا تفرط في التصنيف — أفضل أن يكون لديك `fact` واضح من `context` مربك.\n\n## المفاتيح: مُعرّفات ذات معنى\n\nالحقل `key` هو مُعرّف الذاكرة. استخدم مفاتيح ذات معنى وثابتة:\n\n**مفاتيح جيدة:**\n- `user_name`\n- `project_synapse_status`\n- `preference_communication_style`\n- `mistake_npm_version_bump`\n\n**مفاتيح سيئة:**\n- `mem_001` (ليس ذا معنى)\n- `temp` (ليس وصفيًا)\n- `2026-06-27-note` (التاريخ لا يساعد الاستدعاء)\n\n### اصطلاحات تسمية المفاتيح\n\n- `snake_case` (أحرف صغيرة مع شرطات سفلية)\n- بادئة بالفئة: `preference_*`، `project_*`، `mistake_*`\n- استخدم أسماء وصفية، لا أفعالًا\n- أبقِها أقل من 50 حرفًا\n\n## الوسوم: للبحث والتصفية\n\nتُمكّن الوسوم التصفية والبحث السريع. أضف 2-5 وسوم لكل ذاكرة:\n\n```json\n{\n \"category\": \"project\",\n \"key\": \"project_synapse_status\",\n \"content\": \"Synapse v1.5.0 deployed. Next: v1.6.0 with docs system.\",\n \"tags\": [\"synapse\", \"deployment\", \"status\", \"v1.5.0\"]\n}\n```\n\n### أنماط الوسوم\n\n- **أسماء المشاريع**: `synapse`، `synapse-mcp`، `synapse-chat`\n- **المواضيع**: `deployment`، `ci`، `database`، `auth`\n- **الحالة**: `active`، `completed`، `blocked`\n- **مؤشرات الأولوية**: `urgent`، `long-term`\n\n> [!NOTE]\n> الوسوم غير حساسة لحالة الأحرف. استخدم أحرفًا صغيرة للاتساق.\n\n## الأولويات: كن واقعيًا\n\n| الأولوية | استخدم لـ | % من الذكريات |\n|----------|---------|---------------|\n| `critical` | هوية المستخدم، المعلومات القانونية، القرارات غير القابلة للتراجع | ~5% |\n| `high` | المشاريع النشطة، التفضيلات المهمة | ~20% |\n| `normal` | معظم الحقائق، الملاحظات، السياق | ~65% |\n| `low` | عابرة، جيد معرفتها | ~10% |\n\n> [!WARNING]\n> لا تعلّم كل شيء `critical`. إذا كان كل شيء حرجًا، فلا شيء كذلك.\n> احجز `critical` للأشياء التي تسبب ضررًا حقيقيًا إذا نُسيت.\n\n## متى تخزّن ومتى لا تخزّن\n\n### خزّن دائمًا\n\n- هوية المستخدم (الاسم، البريد، الدور)\n- التفضيلات طويلة الأمد\n- قرارات المشروع والمبررات\n- الأخطاء السابقة والدروس المستفادة\n- الالتزامات المقطوعة للمستخدم\n\n### لا تخزّن\n\n- الحالة العابرة (استخدم المتغيرات بدلًا من ذلك)\n- سجل المحادثة الحرفي (نظام الدردشة يتولى هذا)\n- البيانات الحساسة (كلمات المرور، مفاتيح API)\n- الحقائق المشتقة بسهولة (التاريخ الحالي، محتويات الملفات)\n- السياق العابر (استخدم فئة `context` بأولوية منخفضة)\n\n## تحديث الذكريات\n\nاستدعِ `POST /memory` بنفس `category` + `key` يُحدّث الذاكرة الموجودة:\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. CI green.\", priority=\"high\")\n```\n\n> [!TIP]\n> استخدم مفاتيح ثابتة حتى تُحدّث دون إنشاء مكررات. على الـ LLM\n> إعادة POST لنفس المفتاح مع تغير المعلومات، لا إنشاء ذكريات جديدة.\n\n## دورة حياة الذاكرة\n\n```\nCreate → Active → Stale → Archive → Delete\n```\n\n- **Create**: POST /memory بسياق كامل\n- **Active**: استدعِ كثيرًا، حدّث حسب الحاجة\n- **Stale**: ما زال ذا صلة لكن غير مستخدم بنشاط (أولوية أقل؟)\n- **Archive**: عيّن الأولوية إلى `low`، أبقِ للمرجع التاريخي\n- **Delete**: DELETE /memory/:id عندما لا يعود ذا صلة\n\n### تنظيف دوري\n\n```python\n# إيجاد الذكريات غير المُحدّثة منذ 90 يومًا\nold_memories = requests.get(\n f\"{URL}/memory/search?q=*\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}\n)\n\nfor mem in old_memories[\"results\"]:\n if is_stale(mem, days=90):\n # إما حذف أو خفض الأولوية\n if is_obsolete(mem):\n delete_memory(mem[\"id\"])\n else:\n update_memory(mem[\"id\"], priority=\"low\")\n```\n\n## نمط: وراثة الذاكرة\n\nللسياق الهرمي (مشروع → مشروع فرعي → مهمة):\n\n```python\n# المشروع الأب\nstore(\"project\", \"project_synapse\", \"Main Synapse project\", \n tags=[\"synapse\", \"parent\"], priority=\"high\")\n\n# مشروع فرعي (الوسوم تربط بالأب)\nstore(\"project\", \"project_synapse_docs\", \"Docs system for Synapse\",\n tags=[\"synapse\", \"docs\", \"synapse-parent\"], priority=\"high\")\n\n# مهمة محددة (الوسوم تربط بالمشروع الفرعي)\nstore(\"project\", \"task_docs_loader\", \"Implement docs-loader.ts\",\n tags=[\"synapse\", \"docs\", \"task\"], priority=\"normal\")\n```\n\nيستطيع الـ LLM حينها البحث `q=synapse+docs` لإيجاد جميع الذكريات ذات الصلة.\n\n## نمط: سجل القرارات\n\nخزّن القرارات مع المبررات حتى لا يعيد الـ LLM مناقشتها:\n\n```python\nstore(\"fact\", \"decision_postgres_over_sqlite\",\n \"Chose PostgreSQL over SQLite for production. Reason: concurrent writes, \"\n \"FTS5 native support, better backup story. Date: 2026-06-15. Decided by: Michael.\",\n tags=[\"decision\", \"database\", \"postgres\", \"sqlite\"],\n priority=\"high\")\n```\n\n## نمط: تجنب الأخطاء\n\nخزّن الأخطاء مع تعليمات تجنب محددة:\n\n```python\nstore(\"mistake\", \"mistake_forget_version_bump\",\n \"Forgot to bump package.json version after changes. npm publish failed. \"\n \"FIX: Always run `npm version patch` before pushing. \"\n \"CI fails with 'version already exists' if you forget.\",\n tags=[\"npm\", \"ci\", \"publish\", \"version\"],\n priority=\"high\")\n```\n\n## أنماط مضادة يجب تجنبها\n\n> [!WARNING]\n> - **تخزين سجلات المحادثة** — نظام الدردشة يتولى هذا\n> - **تخزين الملفات الكاملة** — استخدم تخزين السكربتات أو تخزينًا خارجيًا\n> - **تخزين الحالة العابرة** — استخدم المتغيرات\n> - **تخزين الأسرار** — استخدم متغيرات البيئة\n> - **تكرار الذكريات** — استخدم مفاتيح ثابتة\n> - **الإفراط في الوسم** — 2-5 وسوم لكل ذاكرة مثالي\n> - **كل شيء حرج** — كن واقعيًا مع الأولويات\n\n## الخطوات التالية\n\n- [Memory API](/docs/api/memory)\n- [وكيل LLM الدائم](/docs/guides/persistent-llm-agent)\n- [استراتيجية وسوم الذاكرة](/docs/llm-cookbook/memory-tagging-strategy)\n","content_html":"

أفضل ممارسات الذاكرة

\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\n\n
الفئةاستخدم لـمثال
identityاسم المستخدم، الدور، معلومات الاتصال"user_name": "Michael Schäfer"
preferenceالإعجابات، عدم الإعجابات، أسلوب العمل"communication": "Prefers concise responses"
factحقائق قابلة للتحقق"office_location": "Berlin, Germany"
projectحالة المشروع، القرارات"project_synapse": "v1.5.0 deployed"
skillمهارات المستخدم"skill_python": "Advanced, 10+ years"
mistakeأخطاء سابقة يجب تجنبها"mistake_npm_version": "Always bump version"
contextسياق ذو صلة بالجلسة"current_focus": "Working on docs system"
noteملاحظات متفرقة"note_idea": "Try Redis for caching"
\n
عند الشك، استخدم `fact` للمعلومات القابلة للتحقق و `note` لكل شيء آخر.\nلا تفرط في التصنيف — أفضل أن يكون لديك `fact` واضح من `context` مربك.

المفاتيح: مُعرّفات ذات معنى

\n

الحقل key هو مُعرّف الذاكرة. استخدم مفاتيح ذات معنى وثابتة:

\n

مفاتيح جيدة:

\n\n

مفاتيح سيئة:

\n\n

اصطلاحات تسمية المفاتيح

\n\n

الوسوم: للبحث والتصفية

\n

تُمكّن الوسوم التصفية والبحث السريع. أضف 2-5 وسوم لكل ذاكرة:

\n
{\n  "category": "project",\n  "key": "project_synapse_status",\n  "content": "Synapse v1.5.0 deployed. Next: v1.6.0 with docs system.",\n  "tags": ["synapse", "deployment", "status", "v1.5.0"]\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
الأولويةاستخدم لـ% من الذكريات
criticalهوية المستخدم، المعلومات القانونية، القرارات غير القابلة للتراجع~5%
highالمشاريع النشطة، التفضيلات المهمة~20%
normalمعظم الحقائق، الملاحظات، السياق~65%
lowعابرة، جيد معرفتها~10%
\n
لا تعلّم كل شيء `critical`. إذا كان كل شيء حرجًا، فلا شيء كذلك.\nاحجز `critical` للأشياء التي تسبب ضررًا حقيقيًا إذا نُسيت.

متى تخزّن ومتى لا تخزّن

\n

خزّن دائمًا

\n\n

لا تخزّن

\n\n

تحديث الذكريات

\n

استدعِ POST /memory بنفس category + key يُحدّث الذاكرة الموجودة:

\n
# التخزين الأول\nstore("project", "project_synapse_status", "v1.4.0 deployed", priority="high")\n\n# لاحقًا: التحديث بنفس المفتاح\nstore("project", "project_synapse_status", "v1.5.0 deployed. CI green.", priority="high")
استخدم مفاتيح ثابتة حتى تُحدّث دون إنشاء مكررات. على الـ LLM\nإعادة POST لنفس المفتاح مع تغير المعلومات، لا إنشاء ذكريات جديدة.

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

\n
Create → Active → Stale → Archive → Delete
\n

تنظيف دوري

\n
# إيجاد الذكريات غير المُحدّثة منذ 90 يومًا\nold_memories = requests.get(\n    f"{URL}/memory/search?q=*",\n    headers={"Authorization": f"Bearer {KEY}"}\n)\n\nfor mem in old_memories["results"]:\n    if is_stale(mem, days=90):\n        # إما حذف أو خفض الأولوية\n        if is_obsolete(mem):\n            delete_memory(mem["id"])\n        else:\n            update_memory(mem["id"], priority="low")

نمط: وراثة الذاكرة

\n

للسياق الهرمي (مشروع → مشروع فرعي → مهمة):

\n
# المشروع الأب\nstore("project", "project_synapse", "Main Synapse project", \n      tags=["synapse", "parent"], priority="high")\n\n# مشروع فرعي (الوسوم تربط بالأب)\nstore("project", "project_synapse_docs", "Docs system for Synapse",\n      tags=["synapse", "docs", "synapse-parent"], priority="high")\n\n# مهمة محددة (الوسوم تربط بالمشروع الفرعي)\nstore("project", "task_docs_loader", "Implement docs-loader.ts",\n      tags=["synapse", "docs", "task"], priority="normal")

يستطيع الـ LLM حينها البحث q=synapse+docs لإيجاد جميع الذكريات ذات الصلة.

\n

نمط: سجل القرارات

\n

خزّن القرارات مع المبررات حتى لا يعيد الـ LLM مناقشتها:

\n
store("fact", "decision_postgres_over_sqlite",\n      "Chose PostgreSQL over SQLite for production. Reason: concurrent writes, "\n      "FTS5 native support, better backup story. Date: 2026-06-15. Decided by: Michael.",\n      tags=["decision", "database", "postgres", "sqlite"],\n      priority="high")

نمط: تجنب الأخطاء

\n

خزّن الأخطاء مع تعليمات تجنب محددة:

\n
store("mistake", "mistake_forget_version_bump",\n      "Forgot to bump package.json version after changes. npm publish failed. "\n      "FIX: Always run `npm version patch` before pushing. "\n      "CI fails with 'version already exists' if you forget.",\n      tags=["npm", "ci", "publish", "version"],\n      priority="high")

أنماط مضادة يجب تجنبها

\n

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

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