# ذكرى

> ذاكرة لوكلاء الذكاء · عبر MCP

عضو ذاكرة لوكلاء الذكاء الاصطناعي. استرجاع طويل المدى ورسم بياني للكيانات يصل إليه أي وكيل عبر MCP — فما تتعلّمه جلسة تعرفه التالية.

```bash
curl -fsSL https://app.zekra.dev/install.sh | sh
```

## المزايا

### استرجاع هجين لا متجهات فقط

تشابه متجهي وBM25 يُدمجان برتبة متبادلة ثم يُعاد ترتيبهما. الاسم أو العبارة الحرفية يجدها النصف البارع في الأسماء.

### يحدّث الحقائق بدل تكديسها

كل كتابة تمرّ بخطوة قرار — إضافة أو تحديث أو إبطال أو لا شيء — فتُستبدل الحقيقة المتناقضة بدل تكرارها. والنسيان إبطال ناعم، والتاريخ يبقى قابلًا للاستعلام.

### أدمغة متعددة ورسم معرفي

دماغ لكل مشروع أو فريق، مع صلاحيات لكل وكيل ورموز محدودة تُفرض على الخادم. الكيانات والعلاقات تُستخرج من الذكريات ويمكن التنقّل بينها.

### أي عميل، بروتوكول واحد

كلود سطح المكتب والشيفرة وCodex وGemini وCursor تتصل عبر سطر أوامر واحد هو خادم MCP ومثبّته معًا.

## ما يستطيع الوكيل استدعاءه

- memory_recall
- memory_retain
- memory_get
- memory_edit
- memory_forget
- graph_neighbors
- graph_traverse
- brain_chat

## على أي شيء بُني

- **التخزين**: togo-postgres, pgvector, VectorChord, BM25
- **التخزين المؤقت**: Redis
- **المزوّدون**: brain-tei, brain-cognee

## البداية

1. سجّل وأصدر رمزًا

أنشئ دماغًا على app.zekra.dev ثم رمز cbt_ لوكيلك.

2. ثبّت سطر الأوامر

```bash
curl -fsSL https://app.zekra.dev/install.sh | sh
```

3. سجّل الدخول

```bash
zekra auth login --token <cbt_…>
```

4. اربط وكيلك

```bash
zekra mcp:install claude-code
```

## أسئلة شائعة

### كيف أعطي Claude Code ذاكرة بين الجلسات؟

اربط خادم ذاكرة عبر MCP. مع ذكرى: ثبّت سطر الأوامر، وسجّل الدخول برمز، ثم شغّل zekra mcp:install claude-code. بعدها يستدعي Claude Code الأداة memory_retain ليحفظ القرارات وmemory_recall ليستعيدها في الجلسة التالية مع المصادر. يبقى CLAUDE.md للقواعد، وذكرى للحقائق التي يجمعها المشروع.

### ما خادم الذاكرة عبر MCP؟

خدمة تتيح أدوات الحفظ والاسترجاع عبر بروتوكول Model Context Protocol، فيستطيع أي عميل MCP — Claude Code وCodex وCursor وGemini ووكلاؤك — أن يخزّن الحقائق ويسترجعها لاحقًا. ذكرى واحد منها: مفتوح المصدر، باسترجاع هجين بالمتجهات وBM25، ورسم معرفي، وأدمغة متعددة بصلاحيات لكل وكيل.

### هل ذكرى مفتوح المصدر؟ وهل أستضيفه بنفسي؟

نعم. الشيفرة على GitHub برخصة AGPL-3.0، ويأتي المستودع بحزمة Docker Compose: ‏Postgres مع VectorChord وواجهة Go واللوحة وخادمَا TEI على المعالج. والنسخة المستضافة على app.zekra.dev.

### ما الفرق بين ذكرى وmem0 وZep وLetta؟

ذكرى يبدأ من MCP: أمر واحد يربط Claude Code أو Codex أو Cursor أو Gemini أو Claude Desktop، والوكلاء يتشاركون الأدمغة نفسها. يزيل التكرار عند الكتابة (إضافة/تحديث/إبطال/لا شيء)، ويسترجع بالمتجهات وBM25 وإعادة الترتيب ورسم بقفزة واحدة، ويفهرس العربية والإنجليزية معًا. وهو أحدث وأصغر من تلك المشاريع، ويديره مطوّر واحد.

### هل يستطيع ذكرى إنشاء عرض تقديمي من ملاحظاتي؟

نعم. يبني ذكرى عرضًا تقديميًا وتقريرًا مطوّلًا مما في الدماغ (ملاحظاته أو استعلام بحث أو عمود كيان أو أهم الملاحظات) بالاعتماد على المادة المجمّعة وحدها، ويذكر التقرير مصادره. ويمكنك البدء من مخطط تلصقه مع قوالب مثل العرض الاستشاري أو عرض المنتج. صدّر العرض إلى PDF والتقرير إلى PDF أو Word، أو شارك رابط قراءة فقط.

### هل يستطيع ذكرى ترجمة عرض تقديمي بين العربية والإنجليزية؟

نعم. استدعاء واحد (presentation_translate أو لوحة الويب) يترجم العرض كاملًا من العربية إلى الإنجليزية أو العكس مع بقاء بنيته. والعروض العربية تُعرض من اليمين إلى اليسار.

### هل يستطيع ذكرى قراءة النص من الصور والإيصالات والسبورات (OCR)؟

نعم. احفظ صورة فيحوّل ذكرى النص الذي فيها إلى ذاكرة قابلة للبحث. تقرأ القراءة الضوئية العربية والإنجليزية وكتابات أخرى كثيرة، حتى لو اجتمعت في صورة واحدة، دون أن تحدد اللغة. وتُدعم ملفات PDF والفيديو (لقطات مفتاحية مع نص منطوق) والصوت أيضًا. ومن يستضيف بنفسه يشغّل خدمة zekra-ocr الاختيارية.

### مع أي عملاء يعمل ذكرى؟

أي عميل MCP. يثبّته سطر الأوامر في Claude Code وClaude Desktop وCodex وGemini وCursor، ومعه لوحة ويب وتطبيقات سطح مكتب لماك وويندوز ولينكس ونسخ تجريبية لآيفون وأندرويد وإضافة للمتصفح وواجهة REST.

## الحالة

يعمل الآن وما زال في بدايته. اللوحة المستضافة على app.zekra.dev ونقطة MCP على mcp.zekra.dev، فوق Postgres مع VectorChord وBM25، والتضمين وإعادة الترتيب عبر TEI. يديره مطوّر واحد ويستخدمه ذاكرةً له كل يوم. ويمكنك استضافته بنفسك عبر Docker Compose برخصة AGPL-3.0.

## مبني على ToGO

مبني على ToGO (https://to-go.dev). إضافات ToGO ومزاياه المستخدمة: نواة ToGO · REST وGraphQL وOpenAPI, brain · محرّك الذاكرة, brain-tei · التضمين وإعادة الترتيب, brain-cognee · استخراج الرسم البياني, brain-ocr · التعرّف على النص, ذاكرة Redis سريعة, المصادقة, PostgreSQL, المهام الخلفية, تخزين الملفات, البريد.

- ToGO: https://to-go.dev/?utm_source=zekra.dev&utm_medium=built-with
- Showcase: https://to-go.dev/ar/showcase#zekra

Source: https://github.com/fadymondy/zekra