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

ابدأ هنا عندما لا يعمل شيء ما. اتبع الخطوات بالترتيب.

الخطوات الأولى

1. تحقق مما إذا كانت الخدمة الخلفية تعمل

bash

triggerfish status

إذا لم تكن الخدمة الخلفية تعمل، ابدأها:

bash

triggerfish start

2. تحقق من السجلات

bash

triggerfish logs

يعرض هذا ملف السجل في الوقت الفعلي. استخدم مرشح المستوى لتقليل الضوضاء:

bash

triggerfish logs --level ERROR
triggerfish logs --level WARN

3. شغّل التشخيصات

bash

triggerfish patrol

يتحقق Patrol مما إذا كانت البوابة قابلة للوصول، ومزود LLM يستجيب، والقنوات متصلة، وقواعد السياسة محمّلة، والمهارات مكتشفة. أي فحص معلَّم بـ CRITICAL أو WARNING يخبرك أين يجب التركيز.

4. تحقق من صحة تكوينك

bash

triggerfish config validate

يحلل هذا triggerfish.yaml، ويتحقق من الحقول المطلوبة، ويتحقق من صحة مستويات التصنيف، ويحلّ مراجع الأسرار.

استكشاف الأخطاء حسب المجال

إذا لم تشر الخطوات الأولى أعلاه إلى المشكلة، اختر المجال الذي يطابق أعراضك:

التثبيت - فشل سكربت التثبيت، مشاكل البناء من المصدر، مشاكل المنصة
الخدمة الخلفية - الخدمة لا تبدأ، تعارضات المنافذ، أخطاء "قيد التشغيل بالفعل"
التكوين - أخطاء تحليل YAML، حقول مفقودة، فشل حل الأسرار
القنوات - البوت لا يستجيب، فشل المصادقة، مشاكل تسليم الرسائل
مزودو LLM - أخطاء API، النموذج غير موجود، فشل البث
التكاملات - Google OAuth، GitHub PAT، Notion API، CalDAV، خوادم MCP
أتمتة المتصفح - Chrome غير موجود، فشل التشغيل، حظر التنقل
الأمان والتصنيف - حظر الكتابة للأسفل، مشاكل التلوث، SSRF، رفض السياسات
الأسرار وبيانات الاعتماد - أخطاء سلسلة المفاتيح، مخزن الملفات المشفر، مشاكل الأذونات

هل ما زلت عالقاً؟

إذا لم يحل أي من الأدلة أعلاه مشكلتك:

اجمع حزمة سجلات
اقرأ دليل تقديم البلاغات
افتح بلاغاً على GitHub

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

الخطوات الأولى ​

1. تحقق مما إذا كانت الخدمة الخلفية تعمل ​

2. تحقق من السجلات ​

3. شغّل التشخيصات ​

4. تحقق من صحة تكوينك ​

استكشاف الأخطاء حسب المجال ​

هل ما زلت عالقاً؟ ​

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

الخطوات الأولى

1. تحقق مما إذا كانت الخدمة الخلفية تعمل

2. تحقق من السجلات

3. شغّل التشخيصات

4. تحقق من صحة تكوينك

استكشاف الأخطاء حسب المجال

هل ما زلت عالقاً؟