Risoluzione dei Problemi
Iniziare qui quando qualcosa non funziona. Seguire i passaggi in ordine.
Primi Passi
1. Verificare se il daemon è in esecuzione
bash
triggerfish statusSe il daemon non è in esecuzione, avviarlo:
bash
triggerfish start2. Controllare i log
bash
triggerfish logsQuesto mostra il file di log in tempo reale. Utilizzare un filtro di livello per ridurre il rumore:
bash
triggerfish logs --level ERROR
triggerfish logs --level WARN3. Eseguire la diagnostica
bash
triggerfish patrolPatrol verifica se il gateway è raggiungibile, il provider LLM risponde, i canali sono connessi, le regole di policy sono caricate e le skill sono scoperte. Qualsiasi controllo contrassegnato come CRITICAL o WARNING indica dove concentrarsi.
4. Validare la configurazione
bash
triggerfish config validateQuesto analizza triggerfish.yaml, verifica i campi obbligatori, valida i livelli di classificazione e risolve i riferimenti ai secret.
Risoluzione dei Problemi per Area
Se i primi passi sopra non hanno indicato il problema, scegliere l'area che corrisponde ai sintomi:
- Installazione - fallimenti dello script di installazione, problemi di compilazione da sorgente, problemi di piattaforma
- Daemon - il servizio non si avvia, conflitti di porte, errori "già in esecuzione"
- Configurazione - errori di parsing YAML, campi mancanti, fallimenti nella risoluzione dei secret
- Canali - il bot non risponde, fallimenti di autenticazione, problemi di consegna dei messaggi
- Provider LLM - errori API, modello non trovato, fallimenti dello streaming
- Integrazioni - Google OAuth, GitHub PAT, Notion API, CalDAV, server MCP
- Automazione del Browser - Chrome non trovato, fallimenti di avvio, navigazione bloccata
- Sicurezza e Classificazione - blocchi write-down, problemi di taint, SSRF, negazioni delle policy
- Secret e Credenziali - errori del portachiavi, file store crittografato, problemi di permessi
Ancora Bloccati?
Se nessuna delle guide sopra ha risolto il problema:
- Raccogliere un bundle di log
- Leggere la guida alla segnalazione degli issue
- Aprire un issue su GitHub
