> ## 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.
# تصحيح أخطاء وولف فيش
> كيفية فهم ما يفعله وولف فيش وإصلاح المشاكل
# كل شيء ملف Markdown
صُمم وولف فيش ليكون قابلاً لتصحيح الأخطاء. كل طبقة من النظام تُنتج مخرجات Markdown مقروءة بشرياً يمكنك فتحها في أي محرر نصوص. لا توجد سجلات ثنائية، ولا صيغ مملوكة، ولا أدوات خاصة مطلوبة.
إذا لم تستطع تصحيح الخطأ بقراءة ملف Markdown، فهذا خلل في وولف فيش.
## أربعة مصادر للحقيقة
عندما يحدث خطأ ما، الإجابة تكمن في أحد هذه الأماكن الأربعة:
السياق الدقيق المُرسل إلى LLM في كل دور. يُظهر ما رآه النموذج فعلاً.
سجل زمني لكل حدث أُطلق في النظام.
سجلات خطوة بخطوة لتنفيذ الأدوات — ما الذي نُفذ، وما الذي أُرجع، وما الذي فشل.
ما تذكره وولف فيش من المحادثات. مُخزّن كـ Markdown في hippocampus.
## مواقع الملفات
| المخرج | المسار | مكتوب بواسطة |
| ------------- | ------------------------------------------------ | --------------------------- |
| لقطات التصحيح | `brain/prefrontal/.debug/context-{timestamp}.md` | `prefrontal.buildContext()` |
| سجلات الأحداث | `brain/corpus/YYYY-MM-DD.log.md` | ناقل أحداث `corpus` |
| ملفات المهام | `brain/motor/tasks/TASK-{id}.md` | `motor.createTask()` |
| ملفات الحلقات | `brain/hippocampus/episodes/*.md` | `hippocampus.save()` |
جميع المسارات نسبية إلى جذر مساحة العمل (`~/.wolffish/workspace/` افتراضياً).
## مسار التشخيص السريع
اتبع هذا التسلسل عند حدوث خطأ ما:
```
ملاحظة المشكلة
│
▼
┌─────────────────────────────────┐
│ 1. تحقق من لقطة التصحيح │
│ هل أُرسل السياق الصحيح؟ │
└─────────────┬───────────────────┘
│
▼
┌─────────────────────────────────┐
│ 2. تحقق من سجل الأحداث │
│ هل أُطلقت الأحداث بشكل صحيح؟ │
└─────────────┬───────────────────┘
│
▼
┌─────────────────────────────────┐
│ 3. تحقق من ملف المهمة │
│ هل نجح تنفيذ الأداة؟ │
└─────────────────────────────────┘
```
معظم المشاكل تُحل في الخطوة 1 — تُظهر لك لقطة التصحيح بالضبط ما استقبله LLM، فتستطيع رؤية ما إذا كان هناك شيء مفقود أو خاطئ فوراً.
## الأدوات
لا تحتاج لأي شيء خاص لتصحيح أخطاء وولف فيش. يتضمن التطبيق عارض ملفات ومحرر Markdown مدمج يتيح لك تصفح جميع مخرجات التصحيح دون مغادرة وولف فيش. لمعظم التصحيح، هذا كل ما تحتاجه.
للمستخدمين المتقدمين، VS Code مفيد أيضاً بسبب معاينة Markdown ومراقب الملفات. افتح مجلد `brain/` كمساحة عمل ويمكنك مشاهدة مخرجات التصحيح تظهر في الوقت الفعلي.
الإعداد الموصى به:
* **VS Code** مع فتح مساحة العمل على `~/.wolffish/workspace/brain/`
* **لوحة معاينة Markdown** الجانبية لقراءة لقطات التصحيح
* **مستكشف الملفات** مُرتب حسب تاريخ التعديل لرؤية أحدث المخرجات
* **الطرفية** مع `tail -f` على سجل الأحداث اليومي للمراقبة المباشرة:
```bash theme={null}
tail -f ~/.wolffish/workspace/brain/corpus/$(date +%Y-%m-%d).log.md
```