פתרון בעיות

התחילו כאן כאשר משהו לא עובד. עקבו אחר הצעדים לפי הסדר.

צעדים ראשונים

1. בדקו אם ה-daemon רץ

triggerfish status

אם ה-daemon לא רץ, הפעילו אותו:

triggerfish start

2. בדקו את הלוגים

triggerfish logs

זה עוקב אחר קובץ הלוג בזמן אמת. השתמשו בסינון רמה כדי לחתוך דרך הרעש:

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

3. הריצו אבחון

triggerfish patrol

Patrol בודק האם ה-gateway נגיש, האם ספק ה-LLM מגיב, האם ערוצים מחוברים, האם כללי מדיניות טעונים והאם מיומנויות התגלו. כל בדיקה המסומנת CRITICAL או WARNING אומרת לכם היכן להתמקד.

4. אמתו את התצורה

triggerfish config validate

זה מנתח את triggerfish.yaml, בודק שדות נדרשים, מאמת רמות סיווג ומפענח הפניות לסודות.

פתרון בעיות לפי תחום

אם הצעדים הראשונים למעלה לא הצביעו על הבעיה, בחרו את התחום שתואם את הסימפטומים שלכם:

• התקנה - כשלי סקריפט התקנה, בעיות בנייה מקוד מקור, בעיות פלטפורמה
• Daemon - שירות לא מתחיל, התנגשויות פורטים, שגיאות "כבר רץ"
• תצורה - שגיאות ניתוח YAML, שדות חסרים, כשלי פענוח סודות
• ערוצים - בוט לא מגיב, כשלי אימות, בעיות מסירת הודעות
• ספקי LLM - שגיאות API, מודל לא נמצא, כשלי streaming
• אינטגרציות - Google OAuth, GitHub PAT, Notion API, CalDAV, שרתי MCP
• אוטומציית דפדפן - Chrome לא נמצא, כשלי הפעלה, ניווט חסום
• אבטחה וסיווג - חסימות כתיבה-למטה, בעיות זיהום, SSRF, דחיות מדיניות
• סודות ואישורים - שגיאות keychain, אחסון קובץ מוצפן, בעיות הרשאות

עדיין תקועים?

אם אף מדריך למעלה לא פתר את הבעיה:

1. אספו חבילת לוג
2. קראו את מדריך דיווח הבעיות
3. פתחו issue ב-GitHub