{"title":"البحث النصي الكامل FTS5","slug":"fts5-search","category":"concepts","summary":"كيف يستخدم Synapse SQLite FTS5 للبحث النصي الكامل في الذاكرة بزمن أقل من مللي ثانية.","audience":["human","llm"],"tags":["concept","search","fts5","fulltext"],"difficulty":"advanced","updated":"2026-06-27","word_count":591,"read_minutes":3,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# البحث النصي الكامل FTS5\n\nيستخدم Synapse امتداد FTS5 (Full-Text Search 5) للبحث السريع والمرن في الذاكرة.\nتشرح هذه الصفحة كيف يعمل وكيفية استخدامه بفعالية.\n\n## ما هو FTS5؟\n\nFTS5 امتداد SQLite (متاح أيضًا في PostgreSQL عبر امتدادات) يُوفّر قدرات\nالبحث النصي الكامل. يقوم بـ:\n\n- فهرسة المحتوى النصي للبحث السريع بالكلمات المفتاحية\n- دعم المعاملات المنطقية (AND، OR، NOT)\n- دعم مطابقة العبارات مع علامات الاقتباس\n- دعم مطابقة البادئات مع `*`\n- ترتيب النتائج حسب الصلة\n\nيستخدم Synapse امتداد FTS5 لفهرسة جميع محتويات الذاكرة، مما يُمكّن البحث بزمن\nأقل من مللي ثانية عبر آلاف الذكريات.\n\n## كيف يستخدم Synapse FTS5\n\nعند تنفيذ `POST /memory`:\n\n1. يُخزَّن محتوى الذاكرة في جدول `memories`\n2. يُدرج المحتوى أيضًا في الجدول الافتراضي FTS5\n3. يقوم FTS5 تلقائيًا بتجزئة المحتوى وفهرسته\n\nعند تنفيذ `GET /memory/search?q=...`:\n\n1. يحلل Synapse الاستعلام باستخدام صياغة FTS5\n2. ينفذ `MATCH` مقابل فهرس FTS5\n3. يصفّي حسب `mind_id` (عزل المستأجر)\n4. يُرجع النتائج مرتّبة\n\n## صياغة الاستعلام\n\n### بحث بالكلمات المفتاحية البسيطة\n\n```\n?q=docker\n```\n\nيُرجع الذكريات التي تحتوي على \"docker\".\n\n### كلمات مفتاحية متعددة (AND ضمني)\n\n```\n?q=docker+swarm\n?q=docker%20swarm\n```\n\nيُرجع الذكريات التي تحتوي على \"docker\" AND \"swarm\" معًا.\n\n### مطابقة العبارات\n\n```\n?q=\"docker+swarm\"\n?q=%22docker%20swarm%22\n```\n\nيُرجع الذكريات التي تحتوي على العبارة الدقيقة \"docker swarm\".\n\n### مطابقة البادئات\n\n```\n?q=docker*\n```\n\nيُرجع الذكريات التي تحتوي على كلمات تبدأ بـ \"docker\" (مثل \"dockers\"،\n\"dockerfile\"، \"dockerize\").\n\n### OR المنطقية\n\n```\n?q=docker+OR+kubernetes\n```\n\nيُرجع الذكريات التي تحتوي على \"docker\" OR \"kubernetes\".\n\n### NOT المنطقية\n\n```\n?q=docker+-swarm\n?q=docker+NOT+swarm\n```\n\nيُرجع الذكريات التي تحتوي على \"docker\" وليس \"swarm\".\n\n### التجميع\n\n```\n?q=(docker+OR+kubernetes)+-test\n```\n\nيُرجع الذكريات التي تحتوي على \"docker\" أو \"kubernetes\"، لكن ليس \"test\".\n\n## أمثلة عملية\n\n### البحث عن ذكريات حول مشروع\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=synapse+deployment\"\n```\n\n### البحث عن عبارة دقيقة\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=%22docker+swarm%22\"\n```\n\n### استبعاد ذكريات الاختبار\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=production+-test\"\n```\n\n### البحث حسب التقنية\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=(postgres+OR+sqlite)+-mysql\"\n```\n\n## الترتيب\n\nيرتّب FTS5 النتائج حسب الصلة باستخدام خوارزمية BM25. العوامل:\n\n- تكرار المصطلح (كم مرة يظهر المصطلح)\n- معكوس تكرار المستند (المصطلحات النادرة تُرتّب أعلى)\n- طول المستند (المستندات الأقصر التي تحتوي على المصطلح تُرتّب أعلى)\n- وزن العمود (العنوان > المحتوى)\n\nتُرجع النتائج بترتيب الصلة (الأكثر صلة أولًا).\n\n## الأداء\n\n| العملية | زمن الاستجابة |\n|-----------|---------|\n| البحث في 100 ذاكرة | < 5 مللي ث |\n| البحث في 1,000 ذاكرة | < 10 مللي ث |\n| البحث في 10,000 ذاكرة | < 25 مللي ث |\n| البحث في 100,000 ذاكرة | < 100 مللي ث |\n\nFTS5 مُحسّن للغاية لأحمال العمل الكثيفة القراءة.\n\n## القيود\n\n### الاشتقاق\n\nFTS5 لا يقوم بالاشتقاق افتراضيًا. \"running\" و \"run\" مصطلحان مختلفان.\n\n**الحل البديل:** استخدم مطابقة البادئات: `?q=run*`\n\n### التسامح مع الأخطاء المطبعية\n\nFTS5 لا يدعم المطابقة الضبابية. خطأ مطبعي سيُرجع نتائج فارغة.\n\n**الحل البديل:** استخدم البحث الدلالي (`/memory/semantic-search`) للمطابقة\nالمفاهيمية.\n\n### كلمات الوقف\n\nالكلمات الشائعة (the، a، an، is) مفهرسة لكن قد لا تكون مفيدة للبحث.\nيتعامل FTS5 مع هذا تلقائيًا.\n\n## FTS5 مقابل البحث الدلالي\n\n| الجانب | FTS5 | البحث الدلالي |\n|--------|------|-----------------|\n| السرعة | أقل من مللي ثانية | 50-100 مللي ث |\n| المطابقة | كلمات مفتاحية دقيقة | مفاهيمية |\n| التسامح مع الأخطاء | لا شيء | بعض |\n| الاشتقاق | لا شيء | ضمني |\n| يتطلب تضمينات | لا | نعم |\n| الأفضل لـ | مصطلحات محددة | المفاهيم |\n\nاستخدم FTS5 عندما تعرف الكلمات المفتاحية. استخدم البحث الدلالي عندما تريد\n\"ذكريات حول X\" حيث يُوصف X بشكل مختلف.\n\n## أفضل الممارسات\n\n> [!TIP]\n> - **استخدم مصطلحات محددة** — \"docker swarm\" أفضل من \"container orchestration\"\n> - **اضبط العبارات بين علامات اقتباس** — `\"docker swarm\"` يضمن مطابقة العبارة\n> - **استخدم البادئات للاختلافات** — `deploy*` يلتقط \"deploy\" و \"deployment\" و \"deploying\"\n> - **استبعد الضوضاء** — `-test` يصفّي ذكريات الاختبار\n> - **اجمع مع الوسوم** — `?q=docker&tag=production` يضيّق النتائج\n\n## الخطوات التالية\n\n- [البحث الدلالي](/docs/concepts/semantic-search)\n- [Memory API](/docs/api/memory)\n- [أفضل ممارسات الذاكرة](/docs/guides/memory-best-practices)\n","content_html":"

البحث النصي الكامل FTS5

\n

يستخدم Synapse امتداد FTS5 (Full-Text Search 5) للبحث السريع والمرن في الذاكرة.\nتشرح هذه الصفحة كيف يعمل وكيفية استخدامه بفعالية.

\n

ما هو FTS5؟

\n

FTS5 امتداد SQLite (متاح أيضًا في PostgreSQL عبر امتدادات) يُوفّر قدرات\nالبحث النصي الكامل. يقوم بـ:

\n\n

يستخدم Synapse امتداد FTS5 لفهرسة جميع محتويات الذاكرة، مما يُمكّن البحث بزمن\nأقل من مللي ثانية عبر آلاف الذكريات.

\n

كيف يستخدم Synapse FTS5

\n

عند تنفيذ POST /memory:

\n
    \n
  1. يُخزَّن محتوى الذاكرة في جدول memories
    2. \n
  2. يُدرج المحتوى أيضًا في الجدول الافتراضي FTS5
    3. \n
  3. يقوم FTS5 تلقائيًا بتجزئة المحتوى وفهرسته
    4. \n
\n

عند تنفيذ GET /memory/search?q=...:

\n
    \n
  1. يحلل Synapse الاستعلام باستخدام صياغة FTS5
    2. \n
  2. ينفذ MATCH مقابل فهرس FTS5
    3. \n
  3. يصفّي حسب mind_id (عزل المستأجر)
    4. \n
  4. يُرجع النتائج مرتّبة
    5. \n
\n

صياغة الاستعلام

\n

بحث بالكلمات المفتاحية البسيطة

\n
?q=docker

يُرجع الذكريات التي تحتوي على "docker".

\n

كلمات مفتاحية متعددة (AND ضمني)

\n
?q=docker+swarm\n?q=docker%20swarm

يُرجع الذكريات التي تحتوي على "docker" AND "swarm" معًا.

\n

مطابقة العبارات

\n
?q="docker+swarm"\n?q=%22docker%20swarm%22

يُرجع الذكريات التي تحتوي على العبارة الدقيقة "docker swarm".

\n

مطابقة البادئات

\n
?q=docker*

يُرجع الذكريات التي تحتوي على كلمات تبدأ بـ "docker" (مثل "dockers"،\n"dockerfile"، "dockerize").

\n

OR المنطقية

\n
?q=docker+OR+kubernetes

يُرجع الذكريات التي تحتوي على "docker" OR "kubernetes".

\n

NOT المنطقية

\n
?q=docker+-swarm\n?q=docker+NOT+swarm

يُرجع الذكريات التي تحتوي على "docker" وليس "swarm".

\n

التجميع

\n
?q=(docker+OR+kubernetes)+-test

يُرجع الذكريات التي تحتوي على "docker" أو "kubernetes"، لكن ليس "test".

\n

أمثلة عملية

\n

البحث عن ذكريات حول مشروع

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=synapse+deployment"

البحث عن عبارة دقيقة

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=%22docker+swarm%22"

استبعاد ذكريات الاختبار

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=production+-test"

البحث حسب التقنية

\n
curl -H "Authorization: Bearer YOUR_MIND_KEY" \\\n     "https://synapse.schaefer.zone/memory/search?q=(postgres+OR+sqlite)+-mysql"

الترتيب

\n

يرتّب FTS5 النتائج حسب الصلة باستخدام خوارزمية BM25. العوامل:

\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
العمليةزمن الاستجابة
البحث في 100 ذاكرة< 5 مللي ث
البحث في 1,000 ذاكرة< 10 مللي ث
البحث في 10,000 ذاكرة< 25 مللي ث
البحث في 100,000 ذاكرة< 100 مللي ث
\n

FTS5 مُحسّن للغاية لأحمال العمل الكثيفة القراءة.

\n

القيود

\n

الاشتقاق

\n

FTS5 لا يقوم بالاشتقاق افتراضيًا. "running" و "run" مصطلحان مختلفان.

\n

الحل البديل: استخدم مطابقة البادئات: ?q=run*

\n

التسامح مع الأخطاء المطبعية

\n

FTS5 لا يدعم المطابقة الضبابية. خطأ مطبعي سيُرجع نتائج فارغة.

\n

الحل البديل: استخدم البحث الدلالي (/memory/semantic-search) للمطابقة\nالمفاهيمية.

\n

كلمات الوقف

\n

الكلمات الشائعة (the، a، an، is) مفهرسة لكن قد لا تكون مفيدة للبحث.\nيتعامل FTS5 مع هذا تلقائيًا.

\n

FTS5 مقابل البحث الدلالي

\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
الجانبFTS5البحث الدلالي
السرعةأقل من مللي ثانية50-100 مللي ث
المطابقةكلمات مفتاحية دقيقةمفاهيمية
التسامح مع الأخطاءلا شيءبعض
الاشتقاقلا شيءضمني
يتطلب تضميناتلانعم
الأفضل لـمصطلحات محددةالمفاهيم
\n

استخدم FTS5 عندما تعرف الكلمات المفتاحية. استخدم البحث الدلالي عندما تريد\n"ذكريات حول X" حيث يُوصف X بشكل مختلف.

\n

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

\n

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

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