{"title":"استراتيجية وسوم الذاكرة","slug":"memory-tagging-strategy","category":"llm-cookbook","summary":"كيف تُوسم الذكريات للبحث والتصفية الفعالة — نظام الوسوم القابل للتوسع.","audience":["llm"],"tags":["cookbook","tagging","memory","strategy"],"difficulty":"intermediate","updated":"2026-06-27","word_count":329,"read_minutes":2,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# استراتيجية وسوم الذاكرة\n\nالوسوم سر استرجاع الذاكرة القابل للتوسع. يُظهر هذا الدليل كيف تُوسم\nالذكريات حتى تعود الصحيحة في الوقت المناسب.\n\n## لماذا تهم الوسوم\n\nبدون الوسوم، لديك بحث نصي كامل مسطح. مع الوسوم، لديك تنقل\nمنظم:\n\n```bash\n# بدون وسوم: ابحث في كل شيء\nGET /memory/search?q=docker\n\n# مع الوسوم: صفِّ حسب المشروع + التقنية\nGET /memory/search?q=deployment&tag=synapse&tag=docker\n```\n\nتُمكّن الوسوم:\n\n- **تصفية سريعة** — `GET /memory/by-tag?tag=production`\n- **بحث محدود** — `?q=auth&tag=project-x`\n- **تجميع** — أوجد جميع ذكريات \"الأخطاء\" لمشروع\n- **إسناد متبادل** — الذكريات التي تشارك الوسوم مرتبطة\n\n## مخطط الوسوم\n\n### وسوم المشروع\n\nاستخدم أسماء المشاريع كوسوم:\n\n```\nsynapse, synapse-mcp, synapse-chat, synapse-sdk\n```\n\n### وسوم التقنية\n\nاستخدم أسماء التقنيات:\n\n```\ndocker, kubernetes, postgres, fastify, react, typescript\n```\n\n### وسوم المواضيع\n\nاستخدم فئات المواضيع:\n\n```\ndeployment, ci-cd, auth, database, frontend, backend, security\n```\n\n### وسوم الحالة\n\nاستخدم مؤشرات الحالة:\n\n```\nactive, completed, blocked, deprecated\n```\n\n### وسوم النوع\n\nاستخدم مؤشرات النوع:\n\n```\ndecision, mistake, pattern, reference, todo\n```\n\n## قواعد الوسم\n\n### القاعدة 1: 2-5 وسوم لكل ذاكرة\n\nوسوم قليلة جدًا = قابلية اكتشاف ضعيفة. كثيرة جدًا = ضوضاء.\n\n```json\n// جيد: 3 وسوم ذات صلة\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\"] }\n\n// سيء: وسم واحد (ضيق جدًا)\n{ \"tags\": [\"synapse\"] }\n\n// سيء: 10 وسوم (ضوضاء)\n{ \"tags\": [\"synapse\", \"deployment\", \"docker\", \"vps1\", \"2026\", \"june\", \"ssh\", \"git\", \"main\", \"production\"] }\n```\n\n### القاعدة 2: أحرف صغيرة، بوصلات\n\n```\n✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey\n```\n\n### القاعدة 3: استخدم مفردات متسقة\n\nأنشئ مفردات وسم والتزم بها:\n\n```\n# مفردات المشروع\nsynapse, synapse-mcp, synapse-chat\n\n# لا: synapse_project, synapseProject, SYNAPSE\n```\n\n### القاعدة 4: وسم بنية البحث\n\nاسأل: \"كيف سأبحث عن هذه الذاكرة؟\"\n\n```json\n// تخزين قرار نشر\n{\n \"content\": \"Decided to use Docker Swarm for Synapse deployment\",\n \"tags\": [\"synapse\", \"deployment\", \"docker\", \"swarm\", \"decision\"]\n}\n\n// ستبحث غالبًا: ?q=docker+swarm أو ?tag=deployment\n```\n\n## الأنماط\n\n### النمط 1: مشروع + موضوع\n\n```json\n{ \"tags\": [\"synapse\", \"deployment\"] }\n{ \"tags\": [\"synapse\", \"auth\"] }\n{ \"tags\": [\"synapse-mcp\", \"tools\"] }\n```\n\nبحث: `?tag=synapse` (جميع ذكريات مشروع Synapse)\nبحث: `?tag=synapse&q=deployment` (ذكريات النشر في Synapse)\n\n### النمط 2: نوع + مجال\n\n```json\n{ \"tags\": [\"mistake\", \"deployment\"] }\n{ \"tags\": [\"decision\", \"database\"] }\n{ \"tags\": [\"pattern\", \"auth\"] }\n```\n\nبحث: `?tag=mistake` (جميع الأخطاء)\nبحث: `?tag=mistake&q=deployment` (أخطاء النشر)\n\n### النمط 3: هرمي\n\nلمشاريع فرعية ضمن مشروع:\n\n```json\n{ \"tags\": [\"synapse\", \"synapse-docs\", \"markdown\"] }\n{ \"tags\": [\"synapse\", \"synapse-mcp\", \"mcp\"] }\n{ \"tags\": [\"synapse\", \"synapse-admin\", \"ui\"] }\n```\n\nبحث: `?tag=synapse` (كل Synapse)\nبحث: `?tag=synapse-docs` (المشروع الفرعي docs فقط)\n\n### النمط 4: تتبع الحالة\n\n```json\n// مشروع نشط\n{ \"tags\": [\"synapse\", \"active\"], \"priority\": \"high\" }\n\n// مشروع مكتمل\n{ \"tags\": [\"synapse-v1\", \"completed\"], \"priority\": \"low\" }\n\n// محظور\n{ \"tags\": [\"synapse-v2\", \"blocked\"], \"priority\": \"high\" }\n```\n\n## حالات الاستخدام الشائعة\n\n### إيجاد جميع القرارات حول مشروع\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=decision&tag=synapse\"\n```\n\n### إيجاد جميع الأخطاء في مجال\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=mistake&tag=deployment\"\n```\n\n### إيجاد العمل النشط\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/by-tag?tag=active\"\n```\n\n### إيجاد ذكريات حول تقنية\n\n```bash\ncurl -H \"Authorization: Bearer $KEY\" \\\n \".../memory/search?q=postgres+performance&tag=database\"\n```\n\n## صيانة الوسوم\n\n### مراجعة دورية\n\n```python\n# إيجاد الوسوم النادرة الاستخدام (مرشحات للتنظيف)\ntags = requests.get(f\"{URL}/memory/tags\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\nfor tag, count in tags.items():\n if count < 2:\n print(f\"Rare tag: {tag} ({count} memories)\")\n```\n\n### دمج الوسوم\n\nإذا كان لديك وسوم غير متسقة (`docker` و `Docker`)، ادمجها:\n\n```python\n# أوجد جميع الذكريات بالوسم \"Docker\"\nmems = requests.get(f\"{URL}/memory/by-tag?tag=Docker\",\n headers={\"Authorization\": f\"Bearer {KEY}\"}).json()\n\n# حدّث كل واحدة لاستخدام \"docker\" بدلًا من ذلك\nfor mem in mems[\"results\"]:\n tags = [t.lower() for t in mem[\"tags\"]]\n update_memory(mem[\"id\"], tags=list(set(tags)))\n```\n\n## أفضل الممارسات\n\n> [!TIP]\n> - **أنشئ المفردات مبكرًا** — وسوم متسقة من اليوم الأول\n> - **وسم بنية البحث** — كيف ستجد هذا لاحقًا؟\n> - **2-5 وسوم هي النقطة المثلى** — قليلة جدًا أو كثيرة جدًا سيئة\n> - **أحرف صغيرة + وصلات** — `ci-cd` لا `CI/CD`\n> - **راجع دوريًا** — ادمج المكررات، احذف غير المستخدمة\n\n## الخطوات التالية\n\n- [أفضل ممارسات الذاكرة](/docs/guides/memory-best-practices)\n- [بحث FTS5](/docs/concepts/fts5-search)\n- [سير العمل المدفوع بالمهام](/docs/llm-cookbook/task-driven-workflow)\n","content_html":"

استراتيجية وسوم الذاكرة

\n

الوسوم سر استرجاع الذاكرة القابل للتوسع. يُظهر هذا الدليل كيف تُوسم\nالذكريات حتى تعود الصحيحة في الوقت المناسب.

\n

لماذا تهم الوسوم

\n

بدون الوسوم، لديك بحث نصي كامل مسطح. مع الوسوم، لديك تنقل\nمنظم:

\n
# بدون وسوم: ابحث في كل شيء\nGET /memory/search?q=docker\n\n# مع الوسوم: صفِّ حسب المشروع + التقنية\nGET /memory/search?q=deployment&tag=synapse&tag=docker

تُمكّن الوسوم:

\n\n

مخطط الوسوم

\n

وسوم المشروع

\n

استخدم أسماء المشاريع كوسوم:

\n
synapse, synapse-mcp, synapse-chat, synapse-sdk

وسوم التقنية

\n

استخدم أسماء التقنيات:

\n
docker, kubernetes, postgres, fastify, react, typescript

وسوم المواضيع

\n

استخدم فئات المواضيع:

\n
deployment, ci-cd, auth, database, frontend, backend, security

وسوم الحالة

\n

استخدم مؤشرات الحالة:

\n
active, completed, blocked, deprecated

وسوم النوع

\n

استخدم مؤشرات النوع:

\n
decision, mistake, pattern, reference, todo

قواعد الوسم

\n

القاعدة 1: 2-5 وسوم لكل ذاكرة

\n

وسوم قليلة جدًا = قابلية اكتشاف ضعيفة. كثيرة جدًا = ضوضاء.

\n
// جيد: 3 وسوم ذات صلة\n{ "tags": ["synapse", "deployment", "docker"] }\n\n// سيء: وسم واحد (ضيق جدًا)\n{ "tags": ["synapse"] }\n\n// سيء: 10 وسوم (ضوضاء)\n{ "tags": ["synapse", "deployment", "docker", "vps1", "2026", "june", "ssh", "git", "main", "production"] }

القاعدة 2: أحرف صغيرة، بوصلات

\n
✅ ci-cd, api-key, mind-key\n❌ CI-CD, APIKey, MindKey

القاعدة 3: استخدم مفردات متسقة

\n

أنشئ مفردات وسم والتزم بها:

\n
# مفردات المشروع\nsynapse, synapse-mcp, synapse-chat\n\n# لا: synapse_project, synapseProject, SYNAPSE

القاعدة 4: وسم بنية البحث

\n

اسأل: "كيف سأبحث عن هذه الذاكرة؟"

\n
// تخزين قرار نشر\n{\n  "content": "Decided to use Docker Swarm for Synapse deployment",\n  "tags": ["synapse", "deployment", "docker", "swarm", "decision"]\n}\n\n// ستبحث غالبًا: ?q=docker+swarm أو ?tag=deployment

الأنماط

\n

النمط 1: مشروع + موضوع

\n
{ "tags": ["synapse", "deployment"] }\n{ "tags": ["synapse", "auth"] }\n{ "tags": ["synapse-mcp", "tools"] }

بحث: ?tag=synapse (جميع ذكريات مشروع Synapse)\nبحث: ?tag=synapse&q=deployment (ذكريات النشر في Synapse)

\n

النمط 2: نوع + مجال

\n
{ "tags": ["mistake", "deployment"] }\n{ "tags": ["decision", "database"] }\n{ "tags": ["pattern", "auth"] }

بحث: ?tag=mistake (جميع الأخطاء)\nبحث: ?tag=mistake&q=deployment (أخطاء النشر)

\n

النمط 3: هرمي

\n

لمشاريع فرعية ضمن مشروع:

\n
{ "tags": ["synapse", "synapse-docs", "markdown"] }\n{ "tags": ["synapse", "synapse-mcp", "mcp"] }\n{ "tags": ["synapse", "synapse-admin", "ui"] }

بحث: ?tag=synapse (كل Synapse)\nبحث: ?tag=synapse-docs (المشروع الفرعي docs فقط)

\n

النمط 4: تتبع الحالة

\n
// مشروع نشط\n{ "tags": ["synapse", "active"], "priority": "high" }\n\n// مشروع مكتمل\n{ "tags": ["synapse-v1", "completed"], "priority": "low" }\n\n// محظور\n{ "tags": ["synapse-v2", "blocked"], "priority": "high" }

حالات الاستخدام الشائعة

\n

إيجاد جميع القرارات حول مشروع

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=decision&tag=synapse"

إيجاد جميع الأخطاء في مجال

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=mistake&tag=deployment"

إيجاد العمل النشط

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/by-tag?tag=active"

إيجاد ذكريات حول تقنية

\n
curl -H "Authorization: Bearer $KEY" \\\n     ".../memory/search?q=postgres+performance&tag=database"

صيانة الوسوم

\n

مراجعة دورية

\n
# إيجاد الوسوم النادرة الاستخدام (مرشحات للتنظيف)\ntags = requests.get(f"{URL}/memory/tags",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\nfor tag, count in tags.items():\n    if count < 2:\n        print(f"Rare tag: {tag} ({count} memories)")

دمج الوسوم

\n

إذا كان لديك وسوم غير متسقة (docker و Docker)، ادمجها:

\n
# أوجد جميع الذكريات بالوسم "Docker"\nmems = requests.get(f"{URL}/memory/by-tag?tag=Docker",\n    headers={"Authorization": f"Bearer {KEY}"}).json()\n\n# حدّث كل واحدة لاستخدام "docker" بدلًا من ذلك\nfor mem in mems["results"]:\n    tags = [t.lower() for t in mem["tags"]]\n    update_memory(mem["id"], tags=list(set(tags)))

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

\n

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

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