البداية السريعة (للإنسان)

يأخذك هذا الدليل خلال الحصول على حساب Synapse، أول Mind Key لك، وتخزين أول ذاكرة. الوقت الإجمالي: ~5 دقائق.

الخطوة 1: سجّل حسابًا

افتح Synapse API وأنشئ حسابًا:

curl -X POST https://synapse.schaefer.zone/register \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your-secure-password"
  }'

الاستجابة:

{
  "jwt": "eyJhbGci...",
  "user": { "id": "u_abc123", "email": "you@example.com" }
}

الخطوة 2: أنشئ أول عقل لك

"العقل" نطاق ذاكرة معزول. يبدأ معظم المستخدمين بعقل واحد، لكن يمكنك امتلاك عقول متعددة (مثلًا "work"، "personal"، "project-x"). لكل عقل Mind Key فريد خاص به.

curl -X POST https://synapse.schaefer.zone/minds \
  -H "Authorization: Bearer YOUR_JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My First Mind",
    "description": "Personal assistant memory"
  }'

الاستجابة:

{
  "id": "m_xyz789",
  "name": "My First Mind",
  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",
  "created_at": "2026-06-27T..."
}

الخطوة 3: خزّن أول ذاكرة

الآن استخدم Mind Key لتخزين ذاكرة:

curl -X POST https://synapse.schaefer.zone/memory \
  -H "Authorization: Bearer YOUR_MIND_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "identity",
    "key": "user_name",
    "content": "My name is Michael",
    "tags": ["personal", "identity"],
    "priority": "critical"
  }'

الاستجابة:

{
  "id": "mem_001",
  "status": "stored",
  "mind_id": "m_xyz789"
}

الخطوة 4: استدعِ جميع الذكريات

لاسترجاع كل ما خزّنته:

curl -H "Authorization: Bearer YOUR_MIND_KEY" \
     https://synapse.schaefer.zone/memory/recall

الاستجابة (نص عادي، مُحسّن لاستهلاك LLM):

Mind: My First Mind
Memories: 1 total (1 verified)

[001] identity (CRITICAL)
  user_name
  My name is Michael
  Tags: personal, identity
  Stored: 2026-06-27

الخطوة 5: ابحث في الذكريات

أوجد ذكريات محددة بالكلمة المفتاحية:

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

الخطوة 6: اربط LLM الخاص بك

أسهل طريقة لمنح LLM الخاص بك الوصول إلى Synapse هي عبر MCP:

• إعداد Claude Desktop — إعداد بدقيقتين
• إعداد Claude Code — تكامل الـ terminal
• إعداد Cursor — تكامل IDE

بعد الإعداد، سيستدعي LLM الخاص بك memory_recall تلقائيًا في بداية كل جلسة ويحفظ الحقائق الجديدة عبر memory_store.

فئات الذاكرة

يدعم Synapse 8 فئات — اختر الأكثر تحديدًا:

مستويات الأولوية

• low — جيد معرفته
• normal — افتراضي
• high — مهم
• critical — يجب ألا يُنسى أبدًا (هوية المستخدم، معلومات قانونية)

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

• تعمق في المصادقة
• Mind Key مقابل JWT
• مرجع Memory API
• تكامل MCP