Penyelesaian Masalah

Mulakan di sini apabila sesuatu tidak berfungsi. Ikut langkah-langkah mengikut urutan.

Langkah Pertama

1. Semak sama ada daemon sedang berjalan

triggerfish status

Jika daemon tidak berjalan, mulakan ia:

triggerfish start

2. Semak log

triggerfish logs

Ini mengekori fail log secara masa nyata. Gunakan penapis tahap untuk mengurangkan bunyi:

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

3. Jalankan diagnostik

triggerfish patrol

Patrol menyemak sama ada gateway boleh dicapai, pembekal LLM memberi respons, saluran disambungkan, peraturan dasar dimuatkan, dan kemahiran ditemui. Sebarang semakan yang ditanda CRITICAL atau WARNING memberitahu anda di mana hendak menumpukan perhatian.

4. Sahkan konfigurasi anda

triggerfish config validate

Ini menghurai triggerfish.yaml, menyemak medan yang diperlukan, mengesahkan tahap klasifikasi, dan menyelesaikan rujukan rahsia.

Penyelesaian Masalah Mengikut Kawasan

Jika langkah-langkah pertama di atas tidak menunjukkan masalah, pilih kawasan yang sepadan dengan gejala anda:

• Pemasangan - kegagalan skrip pemasangan, isu binaan dari sumber, masalah platform
• Daemon - perkhidmatan tidak mahu bermula, konflik port, ralat "sudah berjalan"
• Konfigurasi - ralat hurai YAML, medan hilang, kegagalan penyelesaian rahsia
• Saluran - bot tidak memberi respons, kegagalan pengesahan, isu penghantaran mesej
• Pembekal LLM - ralat API, model tidak ditemui, kegagalan penstriman
• Integrasi - Google OAuth, GitHub PAT, Notion API, CalDAV, pelayan MCP
• Automasi Pelayar - Chrome tidak ditemui, kegagalan pelancaran, navigasi disekat
• Keselamatan & Klasifikasi - blok write-down, isu taint, SSRF, penolakan dasar
• Rahsia & Kelayakan - ralat keychain, stor fail yang disulitkan, masalah kebenaran

Masih Tersekat?

Jika tiada panduan di atas menyelesaikan isu anda:

1. Kumpulkan bundle log
2. Baca panduan pemfailan isu
3. Buka isu di GitHub