Feilsøking

Start her når noe ikke fungerer. Følg trinnene i rekkefølge.

Første trinn

1. Sjekk om daemonen kjører

triggerfish status

Hvis daemonen ikke kjører, start den:

triggerfish start

2. Sjekk loggene

triggerfish logs

Dette følger loggfilen i sanntid. Bruk et nivåfilter for å redusere støy:

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

3. Kjør diagnostikk

triggerfish patrol

Patrol sjekker om gatewayen er nåbar, LLM-leverandøren svarer, kanaler er tilkoblet, policyregler er lastet, og ferdigheter er oppdaget. Enhver sjekk merket CRITICAL eller WARNING forteller deg hvor du bør fokusere.

4. Valider konfigurasjonen

triggerfish config validate

Dette tolker triggerfish.yaml, sjekker obligatoriske felt, validerer klassifiseringsnivåer og løser hemmelighetreferanser.

Feilsøking etter område

Hvis de første trinnene ovenfor ikke pekte deg mot problemet, velg området som samsvarer med symptomene dine:

• Installasjon - installasjonsskriptfeil, bygg-fra-kildekode-problemer, plattformproblemer
• Daemon - tjenesten vil ikke starte, portkonflikter, «allerede kjørende»-feil
• Konfigurasjon - YAML-parserfeil, manglende felt, hemmelighetløsingsfeil
• Kanaler - bot svarer ikke, autentiseringsfeil, leveringsproblemer
• LLM-leverandører - API-feil, modell ikke funnet, strømmingsfeil
• Integrasjoner - Google OAuth, GitHub PAT, Notion API, CalDAV, MCP-servere
• Nettleserautomatisering - Chrome ikke funnet, oppstartsfeil, navigasjon blokkert
• Sikkerhet og klassifisering - write-down-blokkering, Taint-problemer, SSRF, policynekting
• Hemmeligheter og legitimasjon - nøkkelringfeil, kryptert fillager, tillatelsefeil

Fortsatt fast?

Hvis ingen av veiledningene ovenfor løste problemet ditt:

1. Samle inn en loggpakke
2. Les veiledningen for sakrapportering
3. Åpne en sak på GitHub