Troubleshooting
Simulan dito kapag may hindi gumagana. Sundin ang mga hakbang nang sunud-sunod.
Mga Unang Hakbang
1. Tingnan kung tumatakbo ang daemon
bash
triggerfish statusKung hindi tumatakbo ang daemon, i-start ito:
bash
triggerfish start2. Tingnan ang logs
bash
triggerfish logsTina-tail nito ang log file nang real time. Gumamit ng level filter para mabawasan ang ingay:
bash
triggerfish logs --level ERROR
triggerfish logs --level WARN3. Magpatakbo ng diagnostics
bash
triggerfish patrolTinitingnan ng Patrol kung naabot ang gateway, sumasagot ang LLM provider, nakakonekta ang mga channels, naka-load ang policy rules, at natutuklasan ang mga skills. Anumang check na naka-mark na CRITICAL o WARNING ang magsasabi sa iyo kung saan dapat mag-focus.
4. I-validate ang config mo
bash
triggerfish config validatePina-parse nito ang triggerfish.yaml, tinitingnan ang required fields, vina-validate ang classification levels, at nire-resolve ang secret references.
Troubleshooting Ayon sa Area
Kung hindi nakatulong ang mga unang hakbang sa itaas para mahanap ang problema, piliin ang area na tumutugma sa iyong mga sintomas:
- Installation - install script failures, build-from-source issues, platform problems
- Daemon - hindi mag-start ang service, port conflicts, "already running" errors
- Configuration - YAML parse errors, missing fields, secret resolution failures
- Channels - hindi sumasagot ang bot, auth failures, message delivery issues
- LLM Providers - API errors, model not found, streaming failures
- Integrations - Google OAuth, GitHub PAT, Notion API, CalDAV, MCP servers
- Browser Automation - Chrome not found, launch failures, navigation blocked
- Security & Classification - write-down blocks, taint issues, SSRF, policy denials
- Secrets & Credentials - keychain errors, encrypted file store, permission problems
Hindi Pa Rin Naayos?
Kung wala sa mga guides sa itaas ang nakalutas ng iyong issue:
- Mangolekta ng log bundle
- Basahin ang filing issues guide
- Mag-open ng issue sa GitHub
