Wolffish Documentation

وولف فيش لا يستجيب على الإطلاق

الأعراض: تكتب رسالة ولا يحدث شيء. لا استجابة، لا خطأ.تحقق من هذه بالترتيب:

حالة المزود — افتح الإعدادات وتأكد أن مزود LLM الخاص بك مُهيأ ويمكن الوصول إليه. إذا كنت تستخدم مزوداً سحابياً (OpenAI أو Anthropic)، تحقق من صفحة حالتهم.
هل Ollama يعمل — إذا كنت تستخدم نموذجاً محلياً، تأكد أن Ollama يعمل:
```
curl http://localhost:11434/api/tags
```
إذا انتهت المهلة، شغّل Ollama: ollama serve
سجلات التطبيق — تحقق من سجلات Electron للأعطال:
```
ls -lt ~/.wolffish/logs/
cat ~/.wolffish/logs/main.log
```
ابحث عن استثناءات غير مُعالجة أو أخطاء اتصال.
سجل الأحداث — إذا بدا التطبيق متجاوباً لكن LLM لا يرد، تحقق مما إذا كانت الأحداث تُطلق:
```
tail -20 ~/.wolffish/workspace/brain/corpus/$(date +%Y-%m-%d).log.md
```
إذا رأيت input.received لكن لا llm.response، فاستدعاء المزود معلق أو فاشل.

الوكيل لا يستخدم قدرتي

الأعراض: أنشأت قدرة لكن وولف فيش لا يستخدمها أبداً.تحقق من هذه:

مُحفزات SKILL.md — افتح SKILL.md الخاص بقدرتك وتحقق من حقل triggers في الواجهة. يجب أن تتطابق المُحفزات مع أنواع الرسائل التي ترسلها. مثال:
```
triggers:
  - "deploy"
  - "push to production"
  - "release"
```
لقطة التصحيح — أرسل رسالة يجب أن تُفعّل القدرة، ثم تحقق من أحدث لقطة تصحيح:
```
ls -t brain/prefrontal/.debug/ | head -1
```
افتحها وانظر في قسم <skills>. هل قدرتك مُدرجة؟ إذا لا، فدرجة صلتها كانت تحت العتبة.
هل حمّلها cerebellum — تحقق من سجل الأحداث لأحداث capability.loaded أو capability.error:
```
grep "capability" brain/corpus/$(date +%Y-%m-%d).log.md
```
إذا رأيت capability.error، فإن SKILL.md به مشكلة في التحليل (واجهة تالفة، حقول مطلوبة مفقودة).
خفّض العتبة — إذا سجلت المهارة درجة قريبة لكن ليست فوق العتبة الافتراضية، إما أضف مزيداً من المُحفزات أو خفّض ras.threshold في config.json.

استدعاءات الأدوات تُحظر دائماً

الأعراض: كل استدعاء أداة يُطلق تأكيد أمان أو يُرفض.تحقق من هذه:

danger_patterns في SKILL.md — يفحص amygdala معاملات الأداة مقابل تعبيرات danger_patterns النمطية المُعرّفة في SKILL.md الخاص بالقدرة. إذا كانت أنماطك واسعة جداً، ستتطابق مع كل شيء:
```
danger_patterns:
  - "rm\\s+-rf"        # Good: specific
  - "rm"               # Bad: matches "format", "inform", etc.
```
confirm_patterns — هذه تتطلب تأكيد المستخدم لكن لا تحظر. إذا أردت تشغيل الأداة بدون سؤال، أزل النمط المطابق من confirm_patterns.
إعداد التجاوز — للتطوير، يمكنك تعطيل تأكيدات الأمان في الإعدادات. هذا يتخطى بوابة amygdala بالكامل.

عطّل الأمان في التطوير فقط. في الاستخدام العادي، بوابة الأمان تمنع العمليات المدمرة.

الذاكرة تبدو خاطئة أو قديمة

الأعراض: يشير وولف فيش إلى معلومات خاطئة أو قديمة أو من سياق غير صحيح.أصلحها مباشرة:

اقرأ ملف الحلقة — الحلقات هي Markdown عادي. ابحث عن الذاكرة المعيبة:
```
grep -r "wrong information" brain/hippocampus/episodes/
```
عدّلها أو احذفها — افتح ملف الحلقة وأصلح المحتوى، أو احذف الملف بالكامل. الحلقات مجرد Markdown — عدّلها مثل أي ملف آخر.
أعد بناء الفهرس — بعد تعديل الحلقات، يصبح فهرس cortex قديماً. احذفه وسيعيد وولف فيش بناءه عند إعادة التشغيل التالية:
```
rm brain/cortex/cortex.db
```
عند التشغيل التالي، يعيد cortex فهرسة جميع ملفات الحلقات من الصفر.

السياق كبير جداً / الاستجابات بطيئة

الأعراض: يستغرق وولف فيش وقتاً طويلاً للاستجابة، أو ترى تحذيرات ميزانية الرموز.تحقق من هذه:

تحذيرات hypothalamus — ابحث عن أحداث الصحة:
```
grep "health" brain/corpus/$(date +%Y-%m-%d).log.md
```
التحذيرات حول استخدام الرموز تعني أن نافذة السياق ممتلئة تقريباً.
قلل المهارات المُحمّلة — إذا كانت قدرات كثيرة تتطابق مع كل رسالة، فمحتويات SKILL.md الخاصة بها تستهلك رموزاً. اجعل المُحفزات أكثر تحديداً حتى تُحمّل مهارات أقل في كل دور.
ارفع عتبة RAS — في config.json، ارفع ras.threshold (الافتراضي 0.3) لتكون أكثر انتقائية فيما يُضمن في السياق:
```
{
  "ras": {
    "threshold": 0.5
  }
}
```
تحقق من حجم لقطة التصحيح — تعليق ميزانية الرموز في أعلى كل لقطة تصحيح يُظهر الاستخدام. إذا هيمن <memory> أو <skills>، قلل تلك الأقسام.

Telegram / WhatsApp لا يتصل

الأعراض: القناة تظهر كمنفصلة، الرسائل لا تُستقبل.لـ Telegram:

تأكد أن رمز البوت في الإعدادات صحيح
تحقق من الاتصال بالإنترنت

ابحث عن أخطاء الاتصال:

grep "telegram\|channel" ~/.wolffish/logs/main.log

بوتات Telegram تتطلب الاستقصاء — إذا كان وولف فيش غير متصل، يعيد الاتصال تلقائياً عند إعادة التشغيل

لـ WhatsApp:

يجب مسح رمز QR في الإعدادات بهاتفك
تنتهي الجلسة إذا كان هاتفك غير متصل لأكثر من 14 يوماً — أعد مسح رمز QR
تحقق من أخطاء الجلسة في السجلات:
```
grep "whatsapp\|wa-web" ~/.wolffish/logs/main.log
```

الإضافة تُطلق أخطاء

الأعراض: إضافة قدرة تفشل في التحميل أو الأدوات تُخطئ أثناء التشغيل.تحقق من هذه:

بنية التصدير — plugin/index.mjs يجب أن يُصدّر كائناً افتراضياً:
```
export default {
  init(context) { ... },
  tools: { ... }
}
```
أسماء الأدوات تتطابق — أسماء الأدوات في الإضافة يجب أن تتطابق تماماً مع الأسماء المُعلنة في قسم tools: في واجهة SKILL.md.
المعاملات تتطابق مع المخطط — مخطط JSON في SKILL.md يجب أن يتطابق مع ما تتوقعه دالة الإضافة. عدم تطابق الأنواع يسبب فشلاً صامتاً.
تحقق من سجل الأحداث — ابحث عن أحداث capability.error:
```
grep "capability.error" brain/corpus/$(date +%Y-%m-%d).log.md
```
رسالة الخطأ عادة تشير إلى المشكلة بالضبط (تصدير مفقود، خطأ صياغة، استيراد تالف).

cortex.db تالف

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

rm ~/.wolffish/workspace/brain/cortex/cortex.db

ثم أعد تشغيل وولف فيش. يعيد cortex فهرسة جميع ملفات الحلقات من brain/hippocampus/episodes/ — يستغرق هذا بضع ثوانٍ حسب عدد الحلقات لديك.

cortex.db هو مخرج مُشتق — يمكن إعادة بنائه دائماً من ملفات Markdown. لن تفقد بيانات أبداً بحذفه.

وولف فيش يستخدم مساحة قرص كبيرة

الأعراض: استخدام القرص يزداد بمرور الوقت، خاصة في ~/.wolffish/.تحقق من هذه المواقع:

ذاكرة التخزين المؤقت لـ Chromium — المتصفح المُضمن يُخزّن بقوة:
```
du -sh ~/.wolffish/runtime/
```
آمن للحذف: rm -rf ~/.wolffish/runtime/Cache/
سجلات الأحداث القديمة — يجب أن تُنظف تلقائياً بعد 7 أيام، لكن تحقق:
```
ls -la ~/.wolffish/workspace/brain/corpus/*.log.md
```
تراكم الحلقات — المثيلات طويلة التشغيل تراكم حلقات. راجع وقلّم القديمة:
```
du -sh ~/.wolffish/workspace/brain/hippocampus/episodes/
ls ~/.wolffish/workspace/brain/hippocampus/episodes/ | wc -l
```
لقطات التصحيح — يجب أن تُنظف تلقائياً، لكن تحقق:
```
du -sh ~/.wolffish/workspace/brain/prefrontal/.debug/
```

كيفية إعادة تعيين كل شيء (الخيار النووي)

إذا لم ينفع أي شيء آخر وتريد البدء من الصفر:

rm -rf ~/.wolffish/

هذا يحذف جميع الإعدادات والذكريات والحلقات والقدرات والسجلات. سيُشغل وولف فيش إعداد التشغيل الأول مرة أخرى. افعل هذا فقط إذا كنت مستعداً لخسارة كل شيء.

لإعادة تعيين أقل تدميراً، احذف مجلدات محددة فقط:

rm -rf ~/.wolffish/workspace/brain/cortex/ — إعادة بناء فهرس البحث فقط
rm -rf ~/.wolffish/workspace/brain/hippocampus/episodes/ — مسح جميع الذكريات
rm -rf ~/.wolffish/workspace/brain/corpus/ — مسح سجلات الأحداث
rm -rf ~/.wolffish/workspace/brain/prefrontal/.debug/ — مسح لقطات التصحيح

مشاكل GitHub

ابحث في المشاكل الموجودة أو أنشئ واحدة جديدة. أرفق سجل الأحداث ولقطة التصحيح المعنية.

مجتمع Discord

اسأل في قناة الدعم. أعضاء المجتمع والمشرفون نشطون هنا.

استكشاف الأخطاء وإصلاحها

ابحث عن مشكلتك

الحصول على المساعدة

مشاكل GitHub

مجتمع Discord

​ابحث عن مشكلتك

​الحصول على المساعدة

مشاكل GitHub

مجتمع Discord

ابحث عن مشكلتك

الحصول على المساعدة