{"title":"الأسئلة الشائعة لاستكشاف الأخطاء","slug":"troubleshooting","category":"faq","summary":"حلول لمشكلات Synapse الشائعة — المصادقة، الشبكة، البيانات، النشر.","audience":["human","llm"],"tags":["faq","troubleshooting","problems","solutions"],"difficulty":"beginner","updated":"2026-06-27","word_count":671,"read_minutes":3,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# الأسئلة الشائعة لاستكشاف الأخطاء\n\nحلول لمشكلات Synapse الشائعة.\n\n## لا أستطيع تسجيل الدخول\n\n### الأعراض\n\n- يُرجع `POST /login` 401\n- \"Invalid email or password\"\n\n### الحلول\n\n1. **تحقق أن البريد الإلكتروني صحيح** — حساس لحالة الأحرف\n2. **تحقق من كلمة المرور** — 6 أحرف كحد أدنى\n3. **سجّل أولًا** إذا لم يكن لديك حساب: `POST /register`\n4. **أعد تعيين كلمة المرور** (إذا كان SMTP مُعدًا) عبر واجهة الويب\n\n## فقدت Mind Key\n\n### الأعراض\n\n- لا أستطيع الوصول إلى الذكريات\n- حُذف Mind Key أو فُقد\n\n### الحلول\n\nلا يمكن استرداد Mind Keys. يجب أن:\n\n1. تسجّل الدخول للحصول على JWT: `POST /login`\n2. تسرد العقول: `GET /minds` (مع JWT)\n3. تنشئ عقلًا جديدًا: `POST /minds`\n4. تحفظ Mind Key الجديد\n5. (اختياري) تحذف العقل القديم: `DELETE /minds/:id`\n\n**البيانات في العقل القديم فقدت** إلا إذا وجدت Mind Key.\n\n## استدعاءات الـ API تُرجع 401\n\n### الأعراض\n\n- جميع استدعاءات الـ API تُرجع 401 Unauthorized\n- \"Mind Key fehlt oder ungültig\"\n\n### الحلول\n\n1. **تحقق من تنسيق الترويسة**: `Authorization: Bearer mk_...`\n2. **تحقق أن Mind Key يبدأ بـ `mk_`** (وليس `eyJ` وهو JWT)\n3. **اختبر مباشرة**:\n ```bash\n curl -H \"Authorization: Bearer mk_YOUR_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n ```\n4. **قد يكون Mind Key مُبطَلًا** — أنشئ عقلًا جديدًا\n\nراجع [المصادقة](/docs/getting-started/authentication).\n\n## استدعاءات الـ API تُرجع 404\n\n### الأعراض\n\n- 404 Not Found\n- \"Route not found\"\n\n### الحلول\n\n> [!CRITICAL]\n> لا تخمّن مسارات نقاط النهاية. فقط المسارات في `GET /endpoints` موجودة.\n\n1. **تحقق من نقاط النهاية الصالحة**: `curl https://synapse.schaefer.zone/endpoints`\n2. **قارن عنوان URL بدقة** — حساس لحالة الأحرف، بلا شرطات مائلة لاحقة\n3. **تحقق من طريقة HTTP** — `GET /memory` مقابل `POST /memory` مختلفة\n\n## استدعاءات الـ API تُرجع 429\n\n### الأعراض\n\n- 429 Too Many Requests\n- \"Rate limit exceeded\"\n\n### الحلول\n\n1. **بدّل إلى مصادقة الترويسة** (بلا حد معدل):\n ```bash\n # لا تفعل\n curl \".../memory/recall?key=mk_...\"\n \n # افعل\n curl -H \"Authorization: Bearer mk_...\" .../memory/recall\n ```\n2. **انتظر `Retry-After` ثانية** إذا وجب استخدام `?key=`\n\nراجع [حدود المعدل](/docs/api/rate-limits).\n\n## بحث الذاكرة يُرجع نتائج فارغة\n\n### الأعراض\n\n- يُرجع `GET /memory/search?q=...` فارغًا\n- أعرف أن الذكريات موجودة\n\n### الحلول\n\n1. **تحقق من وجود الذكريات**: `GET /memory/recall`\n2. **تحقق من صياغة البحث** — لـ FTS5 صياغة محددة\n3. **جرّب استعلامًا أبسط** — `?q=docker` بدلًا من `?q=docker+swarm+deployment`\n4. **استخدم البحث الدلالي** للاستعلامات المفاهيمية: `GET /memory/semantic-search?q=...`\n\nراجع [بحث FTS5](/docs/concepts/fts5-search).\n\n## الذكريات لا تستمر\n\n### الأعراض\n\n- يُرجع POST /memory نجاحًا\n- لا يُظهرها GET /memory/recall\n\n### الحلول\n\n1. **تحقق من نفس Mind Key** — مفاتيح مختلفة = عقول مختلفة\n2. **تحقق من الاستجابة** — يُرجع POST `{ \"id\": \"mem_...\", \"status\": \"stored\" }`\n3. **جرّب GET /memory** (قائمة JSON) بدلًا من /memory/recall (نص)\n4. **تحقق من المرشّح** — `?category=` أو `?tag=` قد يخفيها\n\n## الأدوات لا تظهر في Claude Desktop\n\n### الأعراض\n\n- يُظهر Claude Desktop 0 أدوات\n- لا توجد أيقونة 🔌\n\n### الحلول\n\n1. **أعد تشغيل Claude Desktop بالكامل** (Cmd+Q)\n2. **تحقق أن ملف الإعداد** JSON صالح\n3. **تحقق من Node.js 18+** مثبت\n4. **شغّل MCP يدويًا**: `npx -y synapse-mcp-api@latest`\n5. **تحقق من السجلات**: `~/Library/Logs/Claude/mcp.log`\n\nراجع [استكشاف أخطاء MCP](/docs/mcp/troubleshooting).\n\n## Synapse غير متصل\n\n### الأعراض\n\n- لا يمكن الوصول إلى synapse.schaefer.zone\n- curl ينتهي بانتهاء المهلة\n\n### الحلول\n\n1. **تحقق من إنترنتك** — جرّب موقعًا آخر\n2. **تحقق من صحة Synapse**: `curl https://synapse.schaefer.zone/health`\n3. **انتظر** — قد يكون انقطاعًا مؤقتًا أو نشرًا\n4. **تحقق من صفحة الحالة** (إن وُجدت)\n\nللاستضافة الذاتية: تحقق من حالة حاوية Docker، اتصال قاعدة البيانات.\n\n## أخطاء قاعدة البيانات\n\n### الأعراض\n\n- 500 Internal Server Error\n- \"Database connection failed\"\n\n### الحلول\n\nللاستضافة الذاتية:\n\n1. **تحقق من تشغيل PostgreSQL**: `docker ps | grep postgres`\n2. **تحقق من DATABASE_URL** في البيئة\n3. **تحقق من الترحيلات**: `npm run migrate:check`\n4. **تحقق من مساحة القرص**: `df -h`\n\nللمُستضاف: أبلغ الدعم.\n\n## الـ Webhook لا يعمل\n\n### الأعراض\n\n- سجّلت webhook لكن لا أتلقى استدعاءات\n- لا POST إلى عنوان URL الخاص بك\n\n### الحلول\n\n1. **تحقق أن عنوان URL قابل للوصول**: `curl -X POST your-url -d '{}'`\n2. **تحقق من مرشّح الأحداث** — `memory.*` يطابق جميع أحداث الذاكرة\n3. **اختبر الـ webhook**: `POST /webhooks/:id/test`\n4. **تحقق أن الـ webhook مُمكَّن**: `GET /webhooks/:id`\n5. **تحقق من SSL** — يتطلب Synapse HTTPS صالحًا لعناوين URL للـ webhooks\n\nراجع [Webhooks API](/docs/api/webhooks).\n\n## مهمة Cron لا تعمل\n\n### الأعراض\n\n- أنشأت مهمة cron لكنها لا تعمل\n- `next_run` لا يُحدّث\n\n### الحلول\n\n1. **تحقق من صياغة الجدول** — يجب أن تكون cron 5 حقول صالح OR عدد ثوانٍ صحيح\n2. **تحقق أن نقطة النهاية مسموحة** — يجب أن تكون http(s)، بلا عناوين IP خاصة\n3. **تحقق أن المهمة مُمكَّنة**: `GET /cron`\n4. **انتظر الوقت المجدول التالي** — cron ليس فوريًا\n\nراجع [Cron والمجدول](/docs/api/cron).\n\n## تحتاج مزيدًا من المساعدة؟\n\n1. **تحقق من الوثائق الموجودة**: \n2. **ابحث في الوثائق**: `GET /docs/search?q=your+question`\n3. **افتح issue**: \n4. **تواصل**: راجع صفحة `/support`\n\n## الخطوات التالية\n\n- [الأخطاء ومعالجتها](/docs/api/errors)\n- [أسئلة الـ API الشائعة](/docs/faq/api-faq)\n- [استكشاف أخطاء MCP](/docs/mcp/troubleshooting)\n","content_html":"

الأسئلة الشائعة لاستكشاف الأخطاء

\n

حلول لمشكلات Synapse الشائعة.

\n

لا أستطيع تسجيل الدخول

\n

الأعراض

\n\n

الحلول

\n
    \n
  1. تحقق أن البريد الإلكتروني صحيح — حساس لحالة الأحرف
    2. \n
  2. تحقق من كلمة المرور — 6 أحرف كحد أدنى
    3. \n
  3. سجّل أولًا إذا لم يكن لديك حساب: POST /register
    4. \n
  4. أعد تعيين كلمة المرور (إذا كان SMTP مُعدًا) عبر واجهة الويب
    5. \n
\n

فقدت Mind Key

\n

الأعراض

\n\n

الحلول

\n

لا يمكن استرداد Mind Keys. يجب أن:

\n
    \n
  1. تسجّل الدخول للحصول على JWT: POST /login
    2. \n
  2. تسرد العقول: GET /minds (مع JWT)
    3. \n
  3. تنشئ عقلًا جديدًا: POST /minds
    4. \n
  4. تحفظ Mind Key الجديد
    5. \n
  5. (اختياري) تحذف العقل القديم: DELETE /minds/:id
    6. \n
\n

البيانات في العقل القديم فقدت إلا إذا وجدت Mind Key.

\n

استدعاءات الـ API تُرجع 401

\n

الأعراض

\n\n

الحلول

\n
    \n
  1. تحقق من تنسيق الترويسة: Authorization: Bearer mk_...
    2. \n
  2. تحقق أن Mind Key يبدأ بـ mk_ (وليس eyJ وهو JWT)
    3. \n
  3. اختبر مباشرة:
    curl -H "Authorization: Bearer mk_YOUR_KEY" \\\n     https://synapse.schaefer.zone/memory/recall
    4. \n
  4. قد يكون Mind Key مُبطَلًا — أنشئ عقلًا جديدًا
    5. \n
\n

راجع المصادقة.

\n

استدعاءات الـ API تُرجع 404

\n

الأعراض

\n\n

الحلول

\n
لا تخمّن مسارات نقاط النهاية. فقط المسارات في `GET /endpoints` موجودة.
    \n
  1. تحقق من نقاط النهاية الصالحة: curl https://synapse.schaefer.zone/endpoints
    2. \n
  2. قارن عنوان URL بدقة — حساس لحالة الأحرف، بلا شرطات مائلة لاحقة
    3. \n
  3. تحقق من طريقة HTTP — GET /memory مقابل POST /memory مختلفة
    4. \n
\n

استدعاءات الـ API تُرجع 429

\n

الأعراض

\n\n

الحلول

\n
    \n
  1. بدّل إلى مصادقة الترويسة (بلا حد معدل):
    # لا تفعل\ncurl ".../memory/recall?key=mk_..."\n\n# افعل\ncurl -H "Authorization: Bearer mk_..." .../memory/recall
    2. \n
  2. انتظر Retry-After ثانية إذا وجب استخدام ?key=
    3. \n
\n

راجع حدود المعدل.

\n

بحث الذاكرة يُرجع نتائج فارغة

\n

الأعراض

\n\n

الحلول

\n
    \n
  1. تحقق من وجود الذكريات: GET /memory/recall
    2. \n
  2. تحقق من صياغة البحث — لـ FTS5 صياغة محددة
    3. \n
  3. جرّب استعلامًا أبسط — ?q=docker بدلًا من ?q=docker+swarm+deployment
    4. \n
  4. استخدم البحث الدلالي للاستعلامات المفاهيمية: GET /memory/semantic-search?q=...
    5. \n
\n

راجع بحث FTS5.

\n

الذكريات لا تستمر

\n

الأعراض

\n\n

الحلول

\n
    \n
  1. تحقق من نفس Mind Key — مفاتيح مختلفة = عقول مختلفة
    2. \n
  2. تحقق من الاستجابة — يُرجع POST { "id": "mem_...", "status": "stored" }
    3. \n
  3. جرّب GET /memory (قائمة JSON) بدلًا من /memory/recall (نص)
    4. \n
  4. تحقق من المرشّح — ?category= أو ?tag= قد يخفيها
    5. \n
\n

الأدوات لا تظهر في Claude Desktop

\n

الأعراض

\n\n

الحلول

\n
    \n
  1. أعد تشغيل Claude Desktop بالكامل (Cmd+Q)
    2. \n
  2. تحقق أن ملف الإعداد JSON صالح
    3. \n
  3. تحقق من Node.js 18+ مثبت
    4. \n
  4. شغّل MCP يدويًا: npx -y synapse-mcp-api@latest
    5. \n
  5. تحقق من السجلات: ~/Library/Logs/Claude/mcp.log
    6. \n
\n

راجع استكشاف أخطاء MCP.

\n

Synapse غير متصل

\n

الأعراض

\n\n

الحلول

\n
    \n
  1. تحقق من إنترنتك — جرّب موقعًا آخر
    2. \n
  2. تحقق من صحة Synapse: curl https://synapse.schaefer.zone/health
    3. \n
  3. انتظر — قد يكون انقطاعًا مؤقتًا أو نشرًا
    4. \n
  4. تحقق من صفحة الحالة (إن وُجدت)
    5. \n
\n

للاستضافة الذاتية: تحقق من حالة حاوية Docker، اتصال قاعدة البيانات.

\n

أخطاء قاعدة البيانات

\n

الأعراض

\n\n

الحلول

\n

للاستضافة الذاتية:

\n
    \n
  1. تحقق من تشغيل PostgreSQL: docker ps | grep postgres
    2. \n
  2. تحقق من DATABASE_URL في البيئة
    3. \n
  3. تحقق من الترحيلات: npm run migrate:check
    4. \n
  4. تحقق من مساحة القرص: df -h
    5. \n
\n

للمُستضاف: أبلغ الدعم.

\n

الـ Webhook لا يعمل

\n

الأعراض

\n\n

الحلول

\n
    \n
  1. تحقق أن عنوان URL قابل للوصول: curl -X POST your-url -d '{}'
    2. \n
  2. تحقق من مرشّح الأحداث — memory.* يطابق جميع أحداث الذاكرة
    3. \n
  3. اختبر الـ webhook: POST /webhooks/:id/test
    4. \n
  4. تحقق أن الـ webhook مُمكَّن: GET /webhooks/:id
    5. \n
  5. تحقق من SSL — يتطلب Synapse HTTPS صالحًا لعناوين URL للـ webhooks
    6. \n
\n

راجع Webhooks API.

\n

مهمة Cron لا تعمل

\n

الأعراض

\n\n

الحلول

\n
    \n
  1. تحقق من صياغة الجدول — يجب أن تكون cron 5 حقول صالح OR عدد ثوانٍ صحيح
    2. \n
  2. تحقق أن نقطة النهاية مسموحة — يجب أن تكون http(s)، بلا عناوين IP خاصة
    3. \n
  3. تحقق أن المهمة مُمكَّنة: GET /cron
    4. \n
  4. انتظر الوقت المجدول التالي — cron ليس فوريًا
    5. \n
\n

راجع Cron والمجدول.

\n

تحتاج مزيدًا من المساعدة؟

\n
    \n
  1. تحقق من الوثائق الموجودة: https://synapse.schaefer.zone/docs
    2. \n
  2. ابحث في الوثائق: GET /docs/search?q=your+question
    3. \n
  3. افتح issue: https://gitlab.com/schaefer-services/synapse/-/issues
    4. \n
  4. تواصل: راجع صفحة /support
    5. \n
\n

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

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