Skip to main content

كل شيء ملف Markdown

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

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

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

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

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

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

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

ملفات المهام

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

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

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

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

جميع المسارات نسبية إلى جذر مساحة العمل (~/.wolffish/workspace/ افتراضياً).
المصادر الأربعة كلها مفهرسة في cortex.db، ويستطيع وولفيش البحث فيها بنفسه عبر memory_search. غالباً ما تكون أسرع خطوة أولى هي ببساطة سؤال وولفيش: “ابحث في سجلاتك عما حدث عندما طلبت منك إعادة تشغيل الخادم.”

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

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

إرسال محادثة إلى شخص آخر

حين تكون المشكلة من شأن شخص آخر أن ينظر فيها، لست مضطراً لجمع هذه الملفات بيدك. زرّ التصدير التشخيصي في أي محادثة يحزم محادثة واحدة — نصّها الكامل، وشريحتها من سجل الأحداث، وملفات المهام التي تفرّعت عنها، والذاكرة والموجّهات التي تقف خلفها، وإعداداتك بعد حجب أسرارها — في ملف مضغوط واحد، مع استبدال بيانات الاعتماد بمؤشّرات طول وترك وسائط المرفقات خارجه.

التصدير التشخيصي

زرّ واحد وأرشيف واحد: ما الذي يدخل، وما الذي يبقى خارجاً، وأين يحطّ.

الأدوات

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