اجرای تشخیص‌ها

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

Patrol

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

triggerfish patrol

ما يتحقق ازه

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

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

• HEALTHY - تمام الفحوصات ناجحة
• WARNING - بعض الفحوصات غير الحرجة مُعلَّمة (مثل عدم تثبيت مهارات)
• CRITICAL - فشل فحص حرج واحد روی الأقل (Gateway یا 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)

---

ابزار الفحص الصحي

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

ما تتحقق ازه

ارائه‌دهندگان:

• ارائه‌دهنده پیش‌فرض موجود وقابل للوصول
• يُرجع اسم ارائه‌دهنده

ذخیره‌سازی:

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

مهارت‌ها:

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

پیکربندی:

• تحقق أساسي از پیکربندی

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

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

• 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