> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wolffi.sh/llms.txt
> Use this file to discover all available pages before exploring further.
# كيف تعمل الذاكرة
> نظام الذاكرة ثلاثي المستويات في وولف فيش — الأحداث، التجميع، والمعرفة
# الالتقاط، التجميع، الدمج
نظام الذاكرة في وولف فيش يحاكي hippocampus البشري. تمر المعلومات عبر ثلاث مراحل: الالتقاط، التجميع، والدمج. تُسجَّل الأحداث الخام فورياً، ثم تُضغط في أنماط مع مرور الوقت، وتُرقَّى في النهاية إلى معرفة دائمة.
## المستويات الثلاثة
| المستوى | الموقع | يُكتب بواسطة | يتطلب LLM |
| --------- | -------------------------------------- | -------------------------- | --------- |
| الأحداث | `hippocampus/episodes/YYYY-MM-DD.md` | كل دورة محادثة (إلحاق) | لا |
| المُجمَّع | `hippocampus/consolidated/YYYY-WNN.md` | الضغط الليلي | نعم |
| المعرفة | `hippocampus/knowledge/*.md` | الترقية + الكتابة المباشرة | نعم |
جميع ملفات الذاكرة تُخزَّن كملفات Markdown داخل مساحة العمل الخاصة بك:
```
~/.wolffish/workspace/brain/hippocampus/
├── episodes/
│ ├── 2026-05-14.md
│ ├── 2026-05-15.md
│ └── 2026-05-16.md
├── consolidated/
│ ├── 2026-W19.md
│ └── 2026-W20.md
└── knowledge/
├── people.md
├── projects.md
├── preferences.md
├── technical.md
└── decisions.md
```
## تدفق البيانات
```
وصول رسالة
→ hippocampus.appendEpisode() [فوري، بدون LLM]
→ brainstem الضغط الليلي [LLM يُلخّص الأحداث]
→ ترقية إلى المعرفة [LLM يستخرج الحقائق الدائمة]
```
تسجيل الأحداث هو مجرد إلحاق في ملف — بدون استدعاء LLM، وبدون أي تأخير. عمليات التلخيص المكلفة تحدث أثناء الضغط الليلي عندما لا تكون بانتظار استجابة.
## كيف تدخل الذاكرة إلى السياق
وحدة prefrontal تُجمِّع السياق قبل كل استدعاء لـ LLM. تسحب مرشحات الذاكرة من المستويات الثلاثة، وتمررها عبر **RAS** (نظام التفعيل الشبكي) لتقييم الصلة، ولا تُضمِّن إلا ما يتعلق بالرسالة الحالية.
يستخدم RAS تقييم يعتمد على الكلمات المفتاحية مع حد أدنى 0.25. جزء من الذاكرة يتعلق بـ "أداء React" لن يظهر في السياق عندما تسأل عن "أفكار لقائمة مشتريات".
### ميزانية التوكنات
تحصل الذاكرة على 30% من نافذة السياق الكلية. ضمن هذه الميزانية، يوزّع RAS المساحة بناءً على درجات الصلة — وليس أولوية المستوى. حدث ذو صلة عالية من الأمس يمكن أن يتفوق على إدخال أقل صلة في ملف المعرفة.
## فهرس Cortex
جميع ملفات Markdown في `hippocampus/` تُفهرَس بواسطة وحدة cortex (باستخدام SQLite FTS5 مع ترتيب BM25). هذا يعني أن الذاكرة قابلة للبحث النصي الكامل بدون فحص الملفات على القرص. الفهرس قابل للحذف بالكامل — احذف `cortex.db` وسيُعاد بناؤه تلقائياً من ملفات Markdown المصدرية.
يمكنك تعديل أي ملف ذاكرة يدوياً في أي وقت. وولف فيش يقرأها كما هي. سيُعيد cortex فهرسة التغييرات تلقائياً عبر مراقب الملفات في brainstem.
## لا صناديق سوداء
كل عملية ذاكرة تُنتج ملف Markdown قابل للقراءة. يمكنك فتح `~/.wolffish/workspace/brain/hippocampus/` في أي محرر نصوص ورؤية ما يتذكره وولف فيش بالضبط، ولماذا جمَّع مواضيع معينة، وما يعتبره معرفة دائمة. احذف ملفاً وسيُنسى. عدّل ملفاً وسيسري التعديل فوراً.
سجلات المحادثات اليومية — التدفق الخام لما حدث.
كيف تُضغط الأحداث في ملخصات أسبوعية.
حقائق طويلة المدى عن الأشخاص والمشاريع والتفضيلات.
كيف تُشكّل النتائج السلوك المستقبلي.