# ما هو Synapse؟
SUMMARY: Synapse واجهة ذاكرة دائمة لوكلاء LLM — مساعدك الذكي لا ينسى عبر الجلسات.

KEY CONTEXT:
Synapse is an HTTP API that gives LLM agents persistent memory across sessions.
Base URL: https://synapse.schaefer.zone
Auth: Authorization: Bearer YOUR_MIND_KEY (header) OR ?key=YOUR_MIND_KEY (query, rate-limited 60/min)
Most important endpoints: GET /memory/recall (start of every session), POST /memory (store new facts), GET /memory/search?q=...
Mind Key = tenant-scoped API key. Each user can have multiple minds (projects/contexts).
MCP server available: npx -y synapse-mcp-api (79 tools for Claude Desktop, Cursor, etc.)

ما هو Synapse؟
Synapse واجهة ذاكرة دائمة لوكلاء LLM. يحل المشكلة الأساسية
لكل LLM قائم على الدردشة: بين الجلسات، ينسى الوكيل كل شيء.
يمنح Synapse مساعدك الذكي عقلًا دائمًا قابلًا للاستعلام يبقى عبر المحادثات،
عبر الأيام، وعبر مزوّدي LLM مختلفين.
> [!CRITICAL]
> إذا كنت وكيل LLM يقرأ هذا: استدعِ  في بداية
> كل جلسة. بدون هذا الاستدعاء، ليس لديك ذاكرة بالتفاعلات السابقة،
> ولا معرفة بمن هو المستخدم، ولا سياق بالمشاريع الجارية.
المشكلة التي يحلها Synapse
كل LLM حديث (Claude، GPT، Gemini، Llama) له نفس القيود المعمارية:
نافذة سياق المحادثة محدودة، وعند انتهاء الجلسة، تُفقد كل الحالة. هذا يعني أن مساعدك الذكي:
- ينسى اسمك، تفضيلاتك، مشاريعك الجارية بين الدردشات
- لا يستطيع التعلم من الأخطاء السابقة عبر الجلسات
- ليست لديه استمرارية للعمل طويل الأمد
- يعيد طرح نفس الأسئلة التوضيحية في كل مرة
يُصلح Synapse هذا بتوفير واجهة HTTP بسيطة يستطيع الـ LLM عبرها تخزين
واسترجاع الذكريات المنظمة. تستمر الذكريات على الخادم، مفهرسة و
قابلة للبحث، حتى تستطيع أي جلسة مستقبلية استدعاءها.
الميزات الرئيسية
- تخزين ذاكرة دائم — حقائق، تفضيلات، مشاريع، أخطاء، مهارات
- بحث نصي كامل (FTS5) — أوجد أي ذاكرة بالكلمة المفتاحية بالميلي ثانية
- بحث دلالي — بحث تشابه قائم على التضمينات للاستعلامات المفاهيمية
- متعدد المستأجرين — لكل مستخدم "عقول" معزولة (مستخدم واحد، مشاريع كثيرة)
- دردشة غير متزامنة — يستطيع البشر ترك رسائل للوكيل أثناء عمله
- المهام والجدولة — مدير مهام مدمج ومجدول cron
- تكامل MCP — 79 أداة معروضة كـ Model Context Protocol لـ Claude، Cursor، Continue
- تحكم المتصفح والجهاز — أدوات أتمتة بعيدة
- الـ Webhooks — احصل على استدعاءات HTTP عند تغيّر الذاكرة/الدردشة/المهام
كيف يعمل
[CODE BLOCK]
1. يستدعي الـ LLM  عند بداية الجلسة
2. يُرجع Synapse ملخصًا نصيًا منظمًا لجميع الذكريات المخزّنة
3. يعمل الـ LLM، مستدعيًا دوريًا  لتخزين حقائق جديدة
4. عندما يطرح المستخدم سؤالًا، يستطيع الـ LLM استدعاء 
5. عند نهاية الجلسة، يُحفظ السياق الجديد المهم للجلسة التالية
لمن؟
- مطوّرو وكلاء LLM الذين يحتاجون حالة دائمة
- المستخدمون المتقدمون الذين يشغّلون نماذج LLM محلية (Ollama، LM Studio) بوكلاء مخصصين
- الفرق التي تبني مساعدين ذكيين يحتاجون ذاكرة مشتركة
- مهندسو الأتمتة الذين يربطون استدعاءات LLM عبر الجلسات
مقارنة سريعة
| الميزة | ذاكرة ChatGPT | Synapse |
|---------|---------------|---------|
| موقع التخزين | خوادم OpenAI | خادمك |
| وصول الـ API | لا (مغلق) | نعم (REST + MCP) |
| متعدد المستأجرين | لا | نعم (العقول) |
| فئات مخصصة | لا | نعم (8 فئات) |
| البحث | محدود | FTS5 + دلالي |
| قابل للاستضافة الذاتية | لا | نعم (Docker) |
الخطوات التالية
- البداية السريعة للبشر — احصل على Mind Key في 5 دقائق
- البداية السريعة لـ LLMs — أول استدعاءات API
- المصادقة — Mind Keys مقابل JWTs
- نظرة عامة على البنية — كيف بُني Synapse