تشغيل التشخيصات

يحتوي Triggerfish على أداتي تشخيص مدمجتين: patrol (فحص صحي خارجي) وأداة healthcheck (فحص نظام داخلي).

Patrol

Patrol هو أمر CLI يتحقق مما إذا كانت الأنظمة الأساسية تعمل:

triggerfish patrol

ما يتحقق منه

الفحص	الحالة	المعنى
البوابة تعمل	CRITICAL إذا معطّلة	مستوى تحكم WebSocket لا يستجيب
LLM متصل	CRITICAL إذا معطّل	لا يمكن الوصول إلى مزود LLM الأساسي
القنوات نشطة	WARNING إذا 0	لا توجد محولات قنوات متصلة
قواعد السياسة محمّلة	WARNING إذا 0	لا توجد قواعد سياسة محمّلة
المهارات مثبتة	WARNING إذا 0	لم تُكتشف مهارات

الحالة العامة

• HEALTHY - جميع الفحوصات ناجحة
• WARNING - بعض الفحوصات غير الحرجة مُعلَّمة (مثل عدم تثبيت مهارات)
• CRITICAL - فشل فحص حرج واحد على الأقل (البوابة أو LLM غير قابل للوصول)

متى تستخدم patrol

• بعد التثبيت، للتحقق من أن كل شيء يعمل
• بعد تغييرات التكوين، للتأكد من إعادة تشغيل الخدمة الخلفية بنظافة
• عندما يتوقف البوت عن الاستجابة، لتضييق نطاق المكوّن الذي فشل
• قبل تقديم تقرير خلل، لتضمين مخرجات patrol

مثال على المخرجات

Triggerfish Patrol Report
=========================
Overall: HEALTHY

[OK]      Gateway running
[OK]      LLM connected (anthropic)
[OK]      Channels active (3)
[OK]      Policy rules loaded (12)
[WARNING] Skills installed (0)

---

أداة الفحص الصحي

أداة الفحص الصحي هي أداة وكيل داخلية تفحص مكونات النظام من داخل البوابة العاملة. متوفرة للوكيل أثناء المحادثات.

ما تتحقق منه

المزودون:

• المزود الافتراضي موجود وقابل للوصول
• يُرجع اسم المزود

التخزين:

• اختبار رحلة ذهاب وإياب: يكتب مفتاحاً، يقرأه، يحذفه
• يتحقق من أن طبقة التخزين تعمل

المهارات:

• يعدّ المهارات المكتشفة حسب المصدر (مُجمَّعة، مُثبّتة، مساحة عمل)

التكوين:

• تحقق أساسي من التكوين

مستويات الحالة

كل مكوّن يبلّغ عن أحد:

• healthy - يعمل بالكامل
• degraded - يعمل جزئياً (بعض الميزات قد لا تعمل)
• error - المكوّن معطّل

متطلب التصنيف

أداة الفحص الصحي تتطلب تصنيفاً أدنى INTERNAL لأنها تكشف عن تفاصيل النظام الداخلية (أسماء المزودين، أعداد المهارات، حالة التخزين). لا يمكن لجلسة PUBLIC استخدامها.

استخدام الفحص الصحي

اطلب من وكيلك:

شغّل فحصاً صحياً

أو إذا كنت تستخدم الأداة مباشرة:

tool: healthcheck

الاستجابة هي تقرير منظّم:

Overall: healthy

Providers: healthy
  Default provider: anthropic

Storage: healthy
  Round-trip test passed

Skills: healthy
  12 skills discovered

Config: healthy

---

دمج التشخيصات

لجلسة تشخيصية شاملة:

1. شغّل patrol من CLI:

   triggerfish patrol

2. تحقق من السجلات بحثاً عن أخطاء حديثة:

   triggerfish logs --level ERROR

3. اطلب من الوكيل تشغيل فحص صحي (إذا كان الوكيل يستجيب):

   شغّل فحصاً صحياً للنظام وأخبرني عن أي مشاكل

4. اجمع حزمة سجلات إذا احتجت لتقديم بلاغ:

   triggerfish logs bundle

---

تشخيصات بدء التشغيل

إذا لم تبدأ الخدمة الخلفية إطلاقاً، تحقق من هذه بالترتيب:

1. التكوين موجود وصالح:

   triggerfish config validate

2. الأسرار يمكن حلّها:

   triggerfish config get-secret --list

3. لا تعارضات منافذ:

   # Linux
   ss -tlnp | grep -E '18789|18790'
   # macOS
   lsof -i :18789 -i :18790

4. لا توجد نسخة أخرى تعمل:

   triggerfish status

5. تحقق من دفتر يومية النظام (Linux):

   journalctl --user -u triggerfish.service --no-pager -n 50

6. تحقق من launchd (macOS):

   launchctl print gui/$(id -u)/dev.triggerfish.agent

7. تحقق من سجل أحداث Windows (Windows):

   Get-EventLog -LogName Application -Source Triggerfish -Newest 10