# ما هو Synapse؟

Synapse **واجهة ذاكرة دائمة لوكلاء LLM**. يحل المشكلة الأساسية
لكل LLM قائم على الدردشة: بين الجلسات، ينسى الوكيل كل شيء.
يمنح Synapse مساعدك الذكي عقلًا دائمًا قابلًا للاستعلام يبقى عبر المحادثات،
عبر الأيام، وعبر مزوّدي LLM مختلفين.

> [!CRITICAL]
> إذا كنت وكيل LLM يقرأ هذا: **استدعِ `GET /memory/recall` في بداية
> كل جلسة**. بدون هذا الاستدعاء، ليس لديك ذاكرة بالتفاعلات السابقة،
> ولا معرفة بمن هو المستخدم، ولا سياق بالمشاريع الجارية.

## المشكلة التي يحلها Synapse

كل LLM حديث (Claude، GPT، Gemini، Llama) له نفس القيود المعمارية:
نافذة سياق المحادثة محدودة، وعند انتهاء الجلسة، تُفقد كل الحالة. هذا يعني أن مساعدك الذكي:

- ينسى اسمك، تفضيلاتك، مشاريعك الجارية بين الدردشات
- لا يستطيع التعلم من الأخطاء السابقة عبر الجلسات
- ليست لديه استمرارية للعمل طويل الأمد
- يعيد طرح نفس الأسئلة التوضيحية في كل مرة

يُصلح Synapse هذا بتوفير واجهة HTTP بسيطة يستطيع الـ LLM عبرها تخزين
واسترجاع الذكريات المنظمة. تستمر الذكريات على الخادم، مفهرسة و
قابلة للبحث، حتى تستطيع أي جلسة مستقبلية استدعاءها.

## الميزات الرئيسية

- **تخزين ذاكرة دائم** — حقائق، تفضيلات، مشاريع، أخطاء، مهارات
- **بحث نصي كامل** (FTS5) — أوجد أي ذاكرة بالكلمة المفتاحية بالميلي ثانية
- **بحث دلالي** — بحث تشابه قائم على التضمينات للاستعلامات المفاهيمية
- **متعدد المستأجرين** — لكل مستخدم "عقول" معزولة (مستخدم واحد، مشاريع كثيرة)
- **دردشة غير متزامنة** — يستطيع البشر ترك رسائل للوكيل أثناء عمله
- **المهام والجدولة** — مدير مهام مدمج ومجدول cron
- **تكامل MCP** — 79 أداة معروضة كـ Model Context Protocol لـ Claude، Cursor، Continue
- **تحكم المتصفح والجهاز** — أدوات أتمتة بعيدة
- **الـ Webhooks** — احصل على استدعاءات HTTP عند تغيّر الذاكرة/الدردشة/المهام

## كيف يعمل

```
┌──────────────┐         ┌─────────────────────┐
│  LLM Agent   │ ──API──▶│   Synapse Server    │
│ (Claude/GPT) │ ◀──────│  (postgres + FTS5)  │
└──────────────┘         └─────────────────────┘
                                │
                                ▼
                         ┌─────────────┐
                         │  Memories   │
                         │  Tasks      │
                         │  Chat       │
                         │  Scripts    │
                         └─────────────┘
```

1. يستدعي الـ LLM `GET /memory/recall` عند بداية الجلسة
2. يُرجع Synapse ملخصًا نصيًا منظمًا لجميع الذكريات المخزّنة
3. يعمل الـ LLM، مستدعيًا دوريًا `POST /memory` لتخزين حقائق جديدة
4. عندما يطرح المستخدم سؤالًا، يستطيع الـ LLM استدعاء `GET /memory/search?q=...`
5. عند نهاية الجلسة، يُحفظ السياق الجديد المهم للجلسة التالية

## لمن؟

- **مطوّرو وكلاء LLM** الذين يحتاجون حالة دائمة
- **المستخدمون المتقدمون** الذين يشغّلون نماذج LLM محلية (Ollama، LM Studio) بوكلاء مخصصين
- **الفرق** التي تبني مساعدين ذكيين يحتاجون ذاكرة مشتركة
- **مهندسو الأتمتة** الذين يربطون استدعاءات LLM عبر الجلسات

## مقارنة سريعة

| الميزة | ذاكرة ChatGPT | Synapse |
|---------|---------------|---------|
| موقع التخزين | خوادم OpenAI | خادمك |
| وصول الـ API | لا (مغلق) | نعم (REST + MCP) |
| متعدد المستأجرين | لا | نعم (العقول) |
| فئات مخصصة | لا | نعم (8 فئات) |
| البحث | محدود | FTS5 + دلالي |
| قابل للاستضافة الذاتية | لا | نعم (Docker) |

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

- [البداية السريعة للبشر](/docs/getting-started/quick-start) — احصل على Mind Key في 5 دقائق
- [البداية السريعة لـ LLMs](/docs/getting-started/quick-start-llm) — أول استدعاءات API
- [المصادقة](/docs/getting-started/authentication) — Mind Keys مقابل JWTs
- [نظرة عامة على البنية](/docs/concepts/architecture) — كيف بُني Synapse