> ## 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.

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

> كيف تعمل بنية وولف فيش المستوحاة من الدماغ

# الفكرة الجوهرية

يُسقط وولف فيش بنية الدماغ البشري على خطّ معالجة برمجي حتمي. كل وحدة من وحدات وقت التشغيل الخمس عشرة تتولى وظيفة واحدة بالضبط، وتتواصل عبر ناقل أحداث مكتوب الأنواع (corpus).

## استعارة الدماغ

أسماء الوحدات ليست عشوائية — كل اسم يقابل منطقة دماغية حقيقية تؤدي وظيفة مماثلة:

| الوحدة         | منطقة الدماغ        | الوظيفة                                           |
| -------------- | ------------------- | ------------------------------------------------- |
| `thalamus`     | بوابة الحس          | توجيه المدخلات إلى مزودي نماذج اللغة              |
| `prefrontal`   | الوظيفة التنفيذية   | تجميع السياق لنموذج اللغة                         |
| `ras`          | جهاز التنشيط الشبكي | تصفية المحتوى ذي الصلة بحسب الانتباه              |
| `cortex`       | القشرة المخية       | فهرس استرجاع سريع (SQLite FTS5)                   |
| `hippocampus`  | مركز الذاكرة        | يخزن سجل المحادثات ويستعيده                       |
| `cerebellum`   | تنسيق الحركة        | يكتشف القدرات ويحمّلها                            |
| `wernicke`     | فهم اللغة           | يحلل مخرجات نموذج اللغة ويستخرج استدعاءات الأدوات |
| `broca`        | إنتاج اللغة         | يدفق الردود إلى واجهة المستخدم                    |
| `amygdala`     | كشف التهديد         | بوابة أمان للعمليات الخطرة                        |
| `motor`        | القشرة الحركية      | ينفّذ المهام مع إعادة المحاولة والتسجيل           |
| `basalganglia` | المكافأة/التعلم     | يسجل النتائج للحصول على ملاحظات                   |
| `hypothalamus` | التوازن الداخلي     | يراقب صحة النظام                                  |
| `brainstem`    | الوظائف اللاإرادية  | مراقبة الملفات، ومهام cron، والدمج                |
| `corpus`       | الجسم الثفني        | ناقل الأحداث الذي يربط بين كل الوحدات             |
| `insula`       | الوعي الذاتي        | استبطان الحالة والأداء                            |

## الفكرة المحورية

خطّ المعالجة حتمي — نفس المدخل يسلك نفس المسار عبر نفس البوابات في كل مرة. يضيف نموذج اللغة الإبداع والذكاء عند نقطة واحدة بالضبط (استدعاء `thalamus.stream()`). كل ما عداه هو كود TypeScript قابل للتنبؤ يقرأ ملفات Markdown ويكتب إليها.

## تواصل الوحدات

تتواصل جميع الوحدات عبر `corpus` (ناقل الأحداث)، ولا تستورد بعضها بعضًا مباشرة أبدًا. هذا يبقي التبعيات نظيفة ويجعل النظام قابلًا للفحص — كل حدث يُسجَّل في ملفات Markdown يومية.

```
corpus.emit('message.received', { content: '...' })
corpus.emit('context.built', { tokens: 8000 })
corpus.emit('tool.called', { name: 'shell_exec', args: {...} })
corpus.emit('safety.blocked', { reason: '...' })
```

## الحزمة التقنية

تم بناء وولف فيش على Electron 39 وReact 19 وTypeScript 5.9 وVite 7. يستخدم ناقل الأحداث `mitt` للأحداث المكتوبة الأنواع. تستخدم فهرسة الذاكرة `better-sqlite3` مع FTS5. كل التواصل مع نماذج اللغة هو `fetch()` خالص — بدون أي SDK.

<Card title="شاهد خطّ المعالجة كاملًا" icon="diagram-project" href="/ar/architecture/pipeline">
  تابع رسالة من المدخل إلى الرد، خطوة بخطوة.
</Card>