الانتقال إلى المحتوى الرئيسي

​
كل شيء ملف Markdown

صُمم وولف فيش ليكون قابلاً لتصحيح الأخطاء. كل طبقة من النظام تُنتج مخرجات Markdown مقروءة بشرياً يمكنك فتحها في أي محرر نصوص. لا توجد سجلات ثنائية، ولا صيغ مملوكة، ولا أدوات خاصة مطلوبة.
إذا لم تستطع تصحيح الخطأ بقراءة ملف Markdown، فهذا خلل في وولف فيش.

​
أربعة مصادر للحقيقة

عندما يحدث خطأ ما، الإجابة تكمن في أحد هذه الأماكن الأربعة:

لقطات التصحيح

السياق الدقيق المُرسل إلى LLM في كل دور. يُظهر ما رآه النموذج فعلاً.

سجلات الأحداث

سجل زمني لكل حدث أُطلق في النظام.

ملفات المهام

سجلات خطوة بخطوة لتنفيذ الأدوات — ما الذي نُفذ، وما الذي أُرجع، وما الذي فشل.

ملفات الحلقات

ما تذكره وولف فيش من المحادثات. مُخزّن كـ Markdown في hippocampus.

​
مواقع الملفات

المخرجالمسارمكتوب بواسطة
لقطات التصحيحbrain/prefrontal/.debug/context-{timestamp}.mdprefrontal.buildContext()
سجلات الأحداثbrain/corpus/YYYY-MM-DD.log.mdناقل أحداث corpus
ملفات المهامbrain/motor/tasks/TASK-{id}.mdmotor.createTask()
ملفات الحلقاتbrain/hippocampus/episodes/*.mdhippocampus.save()
جميع المسارات نسبية إلى جذر مساحة العمل (~/.wolffish/workspace/ افتراضياً).

​
مسار التشخيص السريع

اتبع هذا التسلسل عند حدوث خطأ ما: 
ملاحظة المشكلة
    │
    ▼
┌─────────────────────────────────┐
│ 1. تحقق من لقطة التصحيح        │
│    هل أُرسل السياق الصحيح؟      │
└─────────────┬───────────────────┘
              │
              ▼
┌─────────────────────────────────┐
│ 2. تحقق من سجل الأحداث         │
│    هل أُطلقت الأحداث بشكل صحيح؟ │
└─────────────┬───────────────────┘
              │
              ▼
┌─────────────────────────────────┐
│ 3. تحقق من ملف المهمة           │
│    هل نجح تنفيذ الأداة؟         │
└─────────────────────────────────┘
معظم المشاكل تُحل في الخطوة 1 — تُظهر لك لقطة التصحيح بالضبط ما استقبله LLM، فتستطيع رؤية ما إذا كان هناك شيء مفقود أو خاطئ فوراً.

​
الأدوات

لا تحتاج لأي شيء خاص لتصحيح أخطاء وولف فيش. يتضمن التطبيق عارض ملفات ومحرر Markdown مدمج يتيح لك تصفح جميع مخرجات التصحيح دون مغادرة وولف فيش. لمعظم التصحيح، هذا كل ما تحتاجه.
للمستخدمين المتقدمين، VS Code مفيد أيضاً بسبب معاينة Markdown ومراقب الملفات. افتح مجلد brain/ كمساحة عمل ويمكنك مشاهدة مخرجات التصحيح تظهر في الوقت الفعلي.
الإعداد الموصى به:
  • VS Code مع فتح مساحة العمل على ~/.wolffish/workspace/brain/
  • لوحة معاينة Markdown الجانبية لقراءة لقطات التصحيح
  • مستكشف الملفات مُرتب حسب تاريخ التعديل لرؤية أحدث المخرجات
  • الطرفية مع tail -f على سجل الأحداث اليومي للمراقبة المباشرة:
tail -f ~/.wolffish/workspace/brain/corpus/$(date +%Y-%m-%d).log.md