🌐 هذه ترجمة آلية. نرحب بالتصحيحات من المجتمع!

<section dir="rtl">

<h1 align="center">
  <br>
  <a href="https://github.com/thedotmack/claude-mem">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-dark-mode.webp">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/claude-mem-logo-for-light-mode.webp" alt="Claude-Mem" width="400">
    </picture>
  </a>
  <br>
  <a href="https://vercel.com/open-source-program">
    <img alt="Vercel OSS Program" src="https://vercel.com/oss/program-badge-2026.svg" />
  </a>
</h1>

<p align="center">
  <a href="docs/i18n/README.zh.md">🇨🇳 中文</a> •
  <a href="docs/i18n/README.zh-tw.md">🇹🇼 繁體中文</a> •
  <a href="docs/i18n/README.ja.md">🇯🇵 日本語</a> •
  <a href="docs/i18n/README.pt.md">🇵🇹 Português</a> •
  <a href="docs/i18n/README.pt-br.md">🇧🇷 Português</a> •
  <a href="docs/i18n/README.ko.md">🇰🇷 한국어</a> •
  <a href="docs/i18n/README.es.md">🇪🇸 Español</a> •
  <a href="docs/i18n/README.de.md">🇩🇪 Deutsch</a> •
  <a href="docs/i18n/README.fr.md">🇫🇷 Français</a> •
  <a href="docs/i18n/README.he.md">🇮🇱 עברית</a> •
  <a href="docs/i18n/README.ar.md">🇸🇦 العربية</a> •
  <a href="docs/i18n/README.ru.md">🇷🇺 Русский</a> •
  <a href="docs/i18n/README.pl.md">🇵🇱 Polski</a> •
  <a href="docs/i18n/README.cs.md">🇨🇿 Čeština</a> •
  <a href="docs/i18n/README.nl.md">🇳🇱 Nederlands</a> •
  <a href="docs/i18n/README.tr.md">🇹🇷 Türkçe</a> •
  <a href="docs/i18n/README.uk.md">🇺🇦 Українська</a> •
  <a href="docs/i18n/README.vi.md">🇻🇳 Tiếng Việt</a> •
  <a href="docs/i18n/README.tl.md">🇵🇭 Tagalog</a> •
  <a href="docs/i18n/README.id.md">🇮🇩 Indonesia</a> •
  <a href="docs/i18n/README.th.md">🇹🇭 ไทย</a> •
  <a href="docs/i18n/README.hi.md">🇮🇳 हिन्दी</a> •
  <a href="docs/i18n/README.bn.md">🇧🇩 বাংলা</a> •
  <a href="docs/i18n/README.ur.md">🇵🇰 اردو</a> •
  <a href="docs/i18n/README.ro.md">🇷🇴 Română</a> •
  <a href="docs/i18n/README.sv.md">🇸🇪 Svenska</a> •
  <a href="docs/i18n/README.it.md">🇮🇹 Italiano</a> •
  <a href="docs/i18n/README.el.md">🇬🇷 Ελληνικά</a> •
  <a href="docs/i18n/README.hu.md">🇭🇺 Magyar</a> •
  <a href="docs/i18n/README.fi.md">🇫🇮 Suomi</a> •
  <a href="docs/i18n/README.da.md">🇩🇰 Dansk</a> •
  <a href="docs/i18n/README.no.md">🇳🇴 Norsk</a>
</p>

<h4 align="center">نظام دائم لضغط الذاكرة، مصمم خصيصاً لـ <a href="https://claude.com/claude-code" target="_blank">Claude Code</a>.</h4>

<p align="center">
  <a href="LICENSE">
    <img src="https://img.shields.io/badge/License-Apache%202.0-blue.svg" alt="License">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/version-13.4.0-green.svg" alt="Version">
  </a>
  <a href="package.json">
    <img src="https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen.svg" alt="Node">
  </a>
  <a href="https://github.com/thedotmack/awesome-claude-code">
    <img src="https://awesome.re/mentioned-badge.svg" alt="Mentioned in Awesome Claude Code">
  </a>
</p>

<p align="center">
  <a href="https://trendshift.io/repositories/15496" target="_blank">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge-dark.svg">
      <source media="(prefers-color-scheme: light)" srcset="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg">
      <img src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/trendshift-badge.svg" alt="thedotmack/claude-mem | Trendshift" width="250" height="55"/>
    </picture>
  </a>
</p>

<br>

<table align="center">
  <tr>
    <td align="center">
      <a href="https://github.com/thedotmack/claude-mem">
        <picture>
          <img
            src="https://raw.githubusercontent.com/thedotmack/claude-mem/main/docs/public/cm-preview.gif"
            alt="Claude-Mem Preview"
            width="500"
          >
        </picture>
      </a>
    </td>
    <td align="center">
      <a href="https://www.star-history.com/#thedotmack/claude-mem&Date">
        <picture>
          <source
            media="(prefers-color-scheme: dark)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&theme=dark&legend=top-left"
          />
          <source
            media="(prefers-color-scheme: light)"
            srcset="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
          />
          <img
            alt="Star History Chart"
            src="https://api.star-history.com/image?repos=thedotmack/claude-mem&type=date&legend=top-left"
            width="500"
          />
        </picture>
      </a>
    </td>
  </tr>
</table>

<p align="center">
  <a href="#بداية-سريعة">بداية سريعة</a> •
  <a href="#كيف-يعمل">كيف يعمل</a> •
  <a href="#أدوات-البحث-mcp-search-tools">أدوات البحث</a> •
  <a href="#المستندات">التوثيق</a> •
  <a href="#الإعدادات">الإعدادات</a> •
  <a href="#استكشاف-الأخطاء-وإصلاحها">استكشاف الأخطاء وإصلاحها</a> •
  <a href="#الترخيص">الترخيص</a>
</p>

<p align="center">
  يحافظ Claude-Mem على السياق بسلاسة عبر الجلسات من خلال تسجيل ملاحظات استخدام الأدوات تلقائياً، وإنشاء ملخصات دلالية، وإتاحتها للجلسات المستقبلية. يتيح هذا لـ Claude الحفاظ على استمرارية المعرفة حول المشاريع حتى بعد انتهاء الجلسات أو إعادة الاتصال.
</p>

---

## بداية سريعة

قم بالتثبيت بأمر واحد:

```bash
npx claude-mem install
```

أو قم بالتثبيت لـ OpenCode:

```bash
npx claude-mem install --ide opencode
```

أو قم بالتثبيت لـ Antigravity CLI ([دليل الإعداد](https://docs.claude-mem.ai/antigravity-cli/setup)):

```bash
npx claude-mem install --ide antigravity
```

أو قم بالتثبيت من متجر الإضافات (plugin marketplace) داخل Claude Code:

```bash
/plugin marketplace add thedotmack/claude-mem

/plugin install claude-mem
```

أعد تشغيل Claude Code. سيظهر السياق من الجلسات السابقة تلقائياً في الجلسات الجديدة.

> **ملاحظة:** يُنشر Claude-Mem أيضاً على npm، إلا أن الأمر `npm install -g claude-mem` يُثبّت **حزمة الـ SDK/المكتبة فقط** — ولا يقوم بتسجيل خطافات الإضافة (plugin hooks) ولا بإعداد خدمة العامل (worker service). قم دائماً بالتثبيت عبر `npx claude-mem install` أو أوامر `/plugin` المذكورة أعلاه.

### 🦞 بوابة OpenClaw (OpenClaw Gateway)

قم بتثبيت claude-mem كإضافة ذاكرة دائمة على بوابات [OpenClaw](https://openclaw.ai) بأمر واحد:

```bash
curl -fsSL https://install.cmem.ai/openclaw.sh | bash
```

يتولى برنامج التثبيت التبعيات، وإعداد الإضافة، وتهيئة مزوّد الذكاء الاصطناعي، وتشغيل العامل (worker)، بالإضافة إلى بثّ اختياري للملاحظات في الوقت الفعلي إلى Telegram وDiscord وSlack وغيرها. راجع [دليل تكامل OpenClaw](https://docs.claude-mem.ai/openclaw-integration) للتفاصيل.

**الميزات الرئيسية:**

- 🧠 **ذاكرة دائمة** - السياق يستمر عبر الجلسات
- 📊 **الكشف التدريجي (Progressive Disclosure)** - استرجاع الذاكرة على طبقات مع رؤية واضحة لتكلفة الـ tokens
- 🔍 **بحث قائم على المهارات** - استعلم عن سجل مشروعك باستخدام مهارة mem-search
- 🖥️ **واجهة مستخدم عارض الويب** - بثّ مباشر للذاكرة عبر رابط العامل (worker URL) الذي يُطبع عند بدء التشغيل
- 💻 **مهارة Claude Desktop** - ابحث في الذاكرة من محادثات Claude Desktop
- 🔒 **التحكم في الخصوصية** - استخدم وسوم `<private>` لاستبعاد المحتوى الحساس من التخزين
- ⚙️ **إعدادات السياق** - تحكم دقيق فيما يتم حقنه من السياق
- 🤖 **تشغيل تلقائي** - لا حاجة لأي تدخل يدوي
- 🔗 **الاستشهادات** - الرجوع إلى الملاحظات السابقة عبر معرّفاتها (IDs) من خلال واجهة برمجة تطبيقات العامل (worker API) أو عرضها جميعاً في عارض الويب

---

## المستندات

📚 **[عرض التوثيق الكامل](https://docs.claude-mem.ai/)** - تصفح على الموقع الرسمي

### البدء

- **[دليل التثبيت](https://docs.claude-mem.ai/installation)** - البدء السريع والتثبيت المتقدم
- **[دليل الاستخدام](https://docs.claude-mem.ai/usage/getting-started)** - كيف يعمل Claude-Mem تلقائياً
- **[أدوات البحث](https://docs.claude-mem.ai/usage/search-tools)** - استعلم عن سجل مشروعك باللغة الطبيعية

### أفضل الممارسات

- **[هندسة السياق](https://docs.claude-mem.ai/context-engineering)** - مبادئ تحسين سياق وكيل الذكاء الاصطناعي
- **[الكشف التدريجي](https://docs.claude-mem.ai/progressive-disclosure)** - الفلسفة وراء استراتيجية تهيئة السياق في Claude-Mem

### البنية المعمارية

- **[نظرة عامة](https://docs.claude-mem.ai/architecture/overview)** - مكونات النظام وتدفق البيانات
- **[تطور البنية المعمارية](https://docs.claude-mem.ai/architecture-evolution)** - رحلة التطور من v3 إلى v5
- **[بنية برامج الربط (Hooks)](https://docs.claude-mem.ai/hooks-architecture)** - كيف يستخدم Claude-Mem خطافات دورة الحياة
- **[مرجع برامج الربط (Hooks)](https://docs.claude-mem.ai/architecture/hooks)** - شرح 7 سكريبتات خطافات
- **[خدمة العامل](https://docs.claude-mem.ai/architecture/worker-service)** - واجهة HTTP API وإدارة Bun
- **[قاعدة البيانات](https://docs.claude-mem.ai/architecture/database)** - مخطط SQLite وبحث FTS5
- **[بنية البحث](https://docs.claude-mem.ai/architecture/search-architecture)** - البحث الهجين مع قاعدة بيانات المتجهات Chroma

### الإعدادات والتطوير

- **[الإعدادات](https://docs.claude-mem.ai/configuration)** - متغيرات البيئة والإعدادات
- **[التطوير](https://docs.claude-mem.ai/development)** - البناء، الاختبار، والمساهمة
- **[فروع الإصدارات](https://docs.claude-mem.ai/branches)** - تدفق فروع Stable وcore-dev وcommunity-edge
- **[استكشاف الأخطاء وإصلاحها](https://docs.claude-mem.ai/troubleshooting)** - المشكلات الشائعة والحلول

---

## كيف يعمل

**المكونات الأساسية:**

1. **5 خطافات لدورة الحياة (Lifecycle Hooks)** - SessionStart، UserPromptSubmit، PostToolUse، Stop، SessionEnd (6 سكريبتات خطافات)
2. **تثبيت ذكي** - فاحص تبعيات مخزّن مؤقتاً (سكريبت سابق للخطاف، وليس خطاف دورة حياة)
3. **خدمة العامل** - واجهة HTTP API محلية مع واجهة مستخدم عارض الويب ونقاط نهاية للبحث، تديرها Bun
4. **قاعدة بيانات SQLite** - تخزّن الجلسات، الملاحظات، والملخصات
5. **مهارة mem-search** - استعلامات باللغة الطبيعية مع الكشف التدريجي
6. **قاعدة بيانات المتجهات Chroma** - بحث هجين دلالي + بالكلمات المفتاحية لاسترجاع سياق ذكي

راجع [نظرة عامة على البنية المعمارية](https://docs.claude-mem.ai/architecture/overview) للتفاصيل.

---

## أدوات البحث (MCP Search Tools)

يوفر Claude-Mem بحثاً ذكياً في الذاكرة من خلال **4 أدوات MCP** تتبع نمط سير عمل **من 3 طبقات** موفّراً لاستهلاك الـ tokens:

**سير العمل من 3 طبقات:**

1. **`search`** - الحصول على فهرس مضغوط مع المعرّفات (IDs) (~50-100 tokens لكل نتيجة)
2. **`timeline`** - الحصول على سياق زمني حول النتائج المثيرة للاهتمام
3. **`get_observations`** - جلب التفاصيل الكاملة فقط للمعرّفات (IDs) المُصفّاة (~500-1,000 tokens لكل نتيجة)

**كيف يعمل:**
- يستخدم Claude أدوات MCP للبحث في ذاكرتك
- ابدأ بـ `search` للحصول على فهرس للنتائج
- استخدم `timeline` لمعرفة ما كان يحدث حول ملاحظات محددة
- استخدم `get_observations` لجلب التفاصيل الكاملة للمعرّفات ذات الصلة
- **توفير يصل إلى 10 أضعاف في استهلاك الـ tokens** من خلال التصفية قبل جلب التفاصيل

**أدوات MCP المتاحة:**

1. **`search`** - البحث في فهرس الذاكرة باستعلامات نصية كاملة، مع التصفية حسب النوع/التاريخ/المشروع
2. **`timeline`** - الحصول على سياق زمني حول ملاحظة أو استعلام محدد
3. **`get_observations`** - جلب تفاصيل الملاحظات الكاملة حسب المعرّفات (IDs) (اجمع دائماً عدة معرّفات في طلب واحد)

**مثال على الاستخدام:**

```typescript
// Step 1: Search for index
search(query="authentication bug", type="bugfix", limit=10)

// Step 2: Review index, identify relevant IDs (e.g., #123, #456)

// Step 3: Fetch full details
get_observations(ids=[123, 456])
```

راجع [دليل أدوات البحث](https://docs.claude-mem.ai/usage/search-tools) لأمثلة مفصلة.

---

## فروع الإصدارات

يتم إصدار النسخ المستقرة من فرع `main` ونشرها على npm. أما `core-dev` و`community-edge` فهما فرعان يتم تشغيلهما من المصدر لإصلاحات الموثوقية المبكرة وتكاملات المجتمع. راجع **[فروع الإصدارات](https://docs.claude-mem.ai/branches)** لمعرفة تدفق الفروع وتعليمات التشغيل غير المستقر.

---

## متطلبات النظام

- **Node.js**: 20.0.0 أو أحدث
- **Claude Code**: أحدث إصدار يدعم الإضافات
- **Bun**: بيئة تشغيل JavaScript ومدير عمليات (يُثبَّت تلقائياً إذا لم يكن موجوداً)
- **uv**: مدير حزم Python للبحث المتجهي (يُثبَّت تلقائياً إذا لم يكن موجوداً)
- **SQLite 3**: للتخزين الدائم (مضمّن)

---
### ملاحظات إعداد Windows

إذا واجهت خطأ مثل:

```powershell
npm : The term 'npm' is not recognized as the name of a cmdlet
```

تأكد من تثبيت Node.js وnpm وإضافتهما إلى متغيّر PATH. قم بتنزيل أحدث برنامج تثبيت لـ Node.js من https://nodejs.org وأعد تشغيل الطرفية (terminal) بعد التثبيت.

---

## الإعدادات

تتم إدارة الإعدادات في `~/.claude-mem/settings.json` (يُنشأ تلقائياً بالقيم الافتراضية عند التشغيل الأول). قم بتهيئة نموذج الذكاء الاصطناعي، ومنفذ العامل (worker port)، ودليل البيانات، ومستوى السجل (log level)، وإعدادات حقن السياق.

راجع **[دليل الإعدادات](https://docs.claude-mem.ai/configuration)** لجميع الإعدادات المتاحة والأمثلة.

### إعدادات الوضع واللغة

يدعم Claude-Mem أوضاع سير عمل ولغات متعددة عبر إعداد `CLAUDE_MEM_MODE`.

يتحكم هذا الخيار في كلا الأمرين:
- سلوك سير العمل (مثل code وchill وinvestigation)
- اللغة المستخدمة في الملاحظات المُنشأة

#### كيفية الإعداد

قم بتحرير ملف الإعدادات الخاص بك في `~/.claude-mem/settings.json`:

```json
{
  "CLAUDE_MEM_MODE": "code--zh"
}
```

يتم تعريف الأوضاع في `plugin/modes/`. لرؤية جميع الأوضاع المتاحة محلياً:

```bash
ls ~/.claude/plugins/marketplaces/thedotmack/plugin/modes/
```

#### الأوضاع المتاحة

| الوضع | الوصف |
|------------|-------------------------|
| `code` | الوضع الافتراضي (الإنجليزية) |
| `code--zh` | وضع الصينية المبسطة |
| `code--ja` | وضع اليابانية |

تتبع الأوضاع الخاصة باللغة النمط `code--[lang]` حيث يكون `[lang]` هو رمز اللغة وفق معيار ISO 639-1 (مثل `zh` للصينية، و`ja` لليابانية، و`es` للإسبانية).

> ملاحظة: الوضع `code--zh` (الصينية المبسطة) مدمج بالفعل — لا حاجة لأي تثبيت إضافي أو تحديث للإضافة.

#### بعد تغيير الوضع

أعد تشغيل Claude Code لتطبيق إعداد الوضع الجديد.

---

## التطوير

راجع **[دليل التطوير](https://docs.claude-mem.ai/development)** لتعليمات البناء، والاختبار، وسير عمل المساهمة.

---

## استكشاف الأخطاء وإصلاحها

إذا واجهت مشكلات، اشرح المشكلة لـ Claude وستقوم مهارة troubleshoot تلقائياً بتشخيصها وتقديم الحلول.

راجع **[دليل استكشاف الأخطاء وإصلاحها](https://docs.claude-mem.ai/troubleshooting)** للمشكلات الشائعة والحلول.

---

## تقارير الأخطاء

أنشئ تقارير أخطاء شاملة باستخدام المولّد الآلي:

```bash
cd ~/.claude/plugins/marketplaces/thedotmack
npm run bug-report
```

## المساهمة

المساهمات مرحب بها! يُرجى:

1. عمل Fork للمستودع (repository)
2. إنشاء فرع (branch) للميزة
3. إجراء التغييرات مع الاختبارات
4. تحديث المستندات
5. تقديم Pull Request

يتم إصدار Claude-Mem من ثلاثة فروع: `main` (المستقر)، و`core-dev`، و`community-edge`. يُنشر `main` فقط على npm؛ أما الفروع الأخرى فيتم تشغيلها من المصدر. راجع [فروع الإصدارات](https://docs.claude-mem.ai/branches) للاطلاع على الاستراتيجية وتعليمات التشغيل المحلي.

راجع [دليل التطوير](https://docs.claude-mem.ai/development) لسير عمل المساهمة.

---

## الترخيص

Claude-Mem مرخّص بموجب رخصة Apache 2.0.

اخترنا رخصة Apache-2.0 لأن الذاكرة الوكيلية الدائمة (durable agentic memory) ينبغي أن يكون من السهل تضمينها في أدوات المطورين، والوكلاء المحليين، وخوادم MCP، وأنظمة المؤسسات، ومنظومات الروبوتات، وأطر تشغيل الوكلاء في الإنتاج.

راجع ملف [LICENSE](LICENSE) للتفاصيل الكاملة. راجع [docs/license.md](docs/license.md)
و[docs/ip-boundary.md](docs/ip-boundary.md) لمعرفة نطاق الترخيص والحدود بين المفتوح والتجاري.

**ملاحظة حول Ragtime**: دليل `ragtime/` مرخّص بموجب **رخصة Apache 2.0**. راجع [ragtime/LICENSE](ragtime/LICENSE) للتفاصيل.

---

## الدعم

- **التوثيق**: [docs/](docs/)
- **المشكلات**: [GitHub Issues](https://github.com/thedotmack/claude-mem/issues)
- **المستودع**: [github.com/thedotmack/claude-mem](https://github.com/thedotmack/claude-mem)
- **حساب X الرسمي**: [@Claude_Memory](https://x.com/Claude_Memory)
- **Discord الرسمي**: [انضم إلى Discord](https://discord.com/invite/J4wttp9vDu)
- **المؤلف**: Alex Newman ([@thedotmack](https://github.com/thedotmack))

---

**مبني باستخدام Claude Agent SDK** | **يعمل مع Claude Code** | **صُنع باستخدام TypeScript**

---

### ماذا عن CMEM؟

CMEM هو رمز (token) أنشأه طرف ثالث، لكنه معتمد رسمياً من قِبل مبتكر Claude-Mem (Alex Newman، @thedotmack). يعمل الرمز كحافز مجتمعي للنمو ووسيلة لإيصال CMEM إلى المطورين والعاملين في مجال المعرفة الأكثر حاجة إليه.

عنوان العقد الرسمي على BASE (BASE CA): 0x76b1967eec0ccaeb001bbbb2b40dc4badba31ba3

</section>

---