Felsökning

Börja här när något inte fungerar. Följ stegen i ordning.

Första steg

1. Kontrollera om daemonen körs

triggerfish status

Om daemonen inte körs, starta den:

triggerfish start

2. Kontrollera loggarna

triggerfish logs

Det här följer loggfilen i realtid. Använd ett nivåfilter för att minska bruset:

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

3. Kör diagnostik

triggerfish patrol

Patrol kontrollerar om gatewayen är nåbar, om LLM-leverantören svarar, om kanaler är anslutna, om policyregler är laddade och om kunskaper hittas. Varje kontroll markerad som CRITICAL eller WARNING talar om var du ska fokusera.

4. Validera din konfiguration

triggerfish config validate

Det här tolkar triggerfish.yaml, kontrollerar obligatoriska fält, validerar klassificeringsnivåer och löser upp hemlighetshänvisningar.

Felsökning per område

Om stegen ovan inte pekade ut problemet väljer du det område som matchar dina symptom:

• Installation — installationsskriptfel, problem med att bygga från källkod, plattformsproblem
• Daemon — tjänsten startar inte, portkonflikter, fel om "redan körs"
• Konfiguration — YAML-tolkningsfel, saknade fält, misslyckad hemlighetslösning
• Kanaler — boten svarar inte, autentiseringsfel, leveransproblem
• LLM-leverantörer — API-fel, modell hittades ej, streamingfel
• Integrationer — Google OAuth, GitHub PAT, Notion API, CalDAV, MCP-servrar
• Webbläsarautomatisering — Chrome hittades ej, startfel, navigering blockerad
• Säkerhet och klassificering — nedskrivningsblock, taint-problem, SSRF, policyavslag
• Hemligheter och autentiseringsuppgifter — nyckelringsfel, krypterat filarkiv, behörighetsproblem

Fortfarande fast?

Om ingen av guiderna ovan löste ditt problem:

1. Samla ett loggpaket
2. Läs guiden för att rapportera ärenden
3. Öppna ett ärende på GitHub