{"title":"البداية السريعة (للإنسان)","slug":"quick-start","category":"getting-started","summary":"سجّل حسابًا، أنشئ أول عقل لك، خزّن ذاكرة — كل ذلك في 5 دقائق.","audience":["human"],"tags":["quickstart","human","register","mind-key"],"difficulty":"beginner","updated":"2026-06-27","word_count":335,"read_minutes":2,"lang":"ar","translated":true,"requested_lang":"ar","content_markdown":"\n# البداية السريعة (للإنسان)\n\nيأخذك هذا الدليل خلال الحصول على حساب Synapse، أول Mind Key لك،\nوتخزين أول ذاكرة. الوقت الإجمالي: ~5 دقائق.\n\n## الخطوة 1: سجّل حسابًا\n\nافتح Synapse API وأنشئ حسابًا:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/register \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"email\": \"you@example.com\",\n \"password\": \"your-secure-password\"\n }'\n```\n\nالاستجابة:\n\n```json\n{\n \"jwt\": \"eyJhbGci...\",\n \"user\": { \"id\": \"u_abc123\", \"email\": \"you@example.com\" }\n}\n```\n\n> [!TIP]\n> احفظ JWT في مكان آمن — ستحتاجه لإنشاء العقول. تنتهي JWT\n> بعد 7 أيام؛ أعد تسجيل الدخول بنفس نقطة النهاية للتحديث.\n\n## الخطوة 2: أنشئ أول عقل لك\n\n\"العقل\" نطاق ذاكرة معزول. يبدأ معظم المستخدمين بعقل واحد، لكن يمكنك\nامتلاك عقول متعددة (مثلًا \"work\"، \"personal\"، \"project-x\"). لكل عقل\nMind Key فريد خاص به.\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/minds \\\n -H \"Authorization: Bearer YOUR_JWT\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"name\": \"My First Mind\",\n \"description\": \"Personal assistant memory\"\n }'\n```\n\nالاستجابة:\n\n```json\n{\n \"id\": \"m_xyz789\",\n \"name\": \"My First Mind\",\n \"mind_key\": \"mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789\",\n \"created_at\": \"2026-06-27T...\"\n}\n```\n\n> [!CRITICAL]\n> **احفظ `mind_key` فورًا.** يُعرض مرة واحدة فقط ولا يمكن\n> استرداده لاحقًا. إذا فقدته، ستحتاج لإنشاء عقل جديد.\n\n## الخطوة 3: خزّن أول ذاكرة\n\nالآن استخدم Mind Key لتخزين ذاكرة:\n\n```bash\ncurl -X POST https://synapse.schaefer.zone/memory \\\n -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n -H \"Content-Type: application/json\" \\\n -d '{\n \"category\": \"identity\",\n \"key\": \"user_name\",\n \"content\": \"My name is Michael\",\n \"tags\": [\"personal\", \"identity\"],\n \"priority\": \"critical\"\n }'\n```\n\nالاستجابة:\n\n```json\n{\n \"id\": \"mem_001\",\n \"status\": \"stored\",\n \"mind_id\": \"m_xyz789\"\n}\n```\n\n## الخطوة 4: استدعِ جميع الذكريات\n\nلاسترجاع كل ما خزّنته:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n https://synapse.schaefer.zone/memory/recall\n```\n\nالاستجابة (نص عادي، مُحسّن لاستهلاك LLM):\n\n```\nMind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n user_name\n My name is Michael\n Tags: personal, identity\n Stored: 2026-06-27\n```\n\n## الخطوة 5: ابحث في الذكريات\n\nأوجد ذكريات محددة بالكلمة المفتاحية:\n\n```bash\ncurl -H \"Authorization: Bearer YOUR_MIND_KEY\" \\\n \"https://synapse.schaefer.zone/memory/search?q=michael\"\n```\n\n## الخطوة 6: اربط LLM الخاص بك\n\nأسهل طريقة لمنح LLM الخاص بك الوصول إلى Synapse هي عبر MCP:\n\n- [إعداد Claude Desktop](/docs/mcp/claude-desktop) — إعداد بدقيقتين\n- [إعداد Claude Code](/docs/mcp/claude-code) — تكامل الـ terminal\n- [إعداد Cursor](/docs/mcp/cursor) — تكامل IDE\n\nبعد الإعداد، سيستدعي LLM الخاص بك `memory_recall` تلقائيًا في بداية\nكل جلسة ويحفظ الحقائق الجديدة عبر `memory_store`.\n\n## فئات الذاكرة\n\nيدعم Synapse 8 فئات — اختر الأكثر تحديدًا:\n\n| الفئة | حالة الاستخدام |\n|----------|----------|\n| `identity` | اسم المستخدم، الدور، معلومات الاتصال |\n| `preference` | الإعجابات، عدم الإعجابات، أسلوب العمل |\n| `fact` | حقائق قابلة للتحقق (تفاصيل المشروع، التواريخ) |\n| `project` | حالة المشروع، المعالم، المهام |\n| `skill` | ما يبرع فيه المستخدم |\n| `mistake` | أخطاء سابقة — تجنب تكرارها |\n| `context` | سياق ذو صلة بالجلسة |\n| `note` | ملاحظات متفرقة |\n\n## مستويات الأولوية\n\n- `low` — جيد معرفته\n- `normal` — افتراضي\n- `high` — مهم\n- `critical` — يجب ألا يُنسى أبدًا (هوية المستخدم، معلومات قانونية)\n\n## الخطوات التالية\n\n- [تعمق في المصادقة](/docs/getting-started/authentication)\n- [Mind Key مقابل JWT](/docs/getting-started/mind-key-vs-jwt)\n- [مرجع Memory API](/docs/api/memory)\n- [تكامل MCP](/docs/mcp/what-is-mcp)\n","content_html":"

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

\n

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

\n

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

\n

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

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

الاستجابة:

\n
{\n  "jwt": "eyJhbGci...",\n  "user": { "id": "u_abc123", "email": "you@example.com" }\n}
احفظ JWT في مكان آمن — ستحتاجه لإنشاء العقول. تنتهي JWT\nبعد 7 أيام؛ أعد تسجيل الدخول بنفس نقطة النهاية للتحديث.

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

\n

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

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

الاستجابة:

\n
{\n  "id": "m_xyz789",\n  "name": "My First Mind",\n  "mind_key": "mk_aBcDeFgHiJkLmNoPqRsTuVwXyZ0123456789",\n  "created_at": "2026-06-27T..."\n}
**احفظ `mind_key` فورًا.** يُعرض مرة واحدة فقط ولا يمكن\nاسترداده لاحقًا. إذا فقدته، ستحتاج لإنشاء عقل جديد.

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

\n

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

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

الاستجابة:

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

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

\n

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

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

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

\n
Mind: My First Mind\nMemories: 1 total (1 verified)\n\n[001] identity (CRITICAL)\n  user_name\n  My name is Michael\n  Tags: personal, identity\n  Stored: 2026-06-27

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

\n

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

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

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

\n

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

\n\n

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

\n

فئات الذاكرة

\n

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

\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\n
الفئةحالة الاستخدام
identityاسم المستخدم، الدور، معلومات الاتصال
preferenceالإعجابات، عدم الإعجابات، أسلوب العمل
factحقائق قابلة للتحقق (تفاصيل المشروع، التواريخ)
projectحالة المشروع، المعالم، المهام
skillما يبرع فيه المستخدم
mistakeأخطاء سابقة — تجنب تكرارها
contextسياق ذو صلة بالجلسة
noteملاحظات متفرقة
\n

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

\n\n

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

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