トラブルシューティング
発生しやすい症状とその対応をまとめました。該当する症状から原因と解決手順を確認できます。
| 症状 | 原因 / 確認ポイント | 解決手順 |
|---|---|---|
| Bot がメッセージを読み上げない | 対象テキストチャンネルがバインドされていない / Bot が VC に入っていない | ボイスチャンネルに入って /join をテキストチャンネル側で実行する |
| ログインできない / 連携エラー | Discord 連携が完了していない、または cookie が破損している | ダッシュボードの「Discord と連携する」をやり直す。ブラウザ cookie をクリアして再ログイン |
| 設定を保存しても反映されない | Bot 側のキャッシュが更新されていない | 数秒待って再度発話してみる。改善しない場合は /leave → /join を実行してセッション再構築 |
| 音声が途中で切れる / 雑音 | VC のリージョンが遠い / ネットワーク帯域不足 / 同時発話のキュー長すぎ | サーバーの VC リージョンを変更。発話の最大文字数 (max_length) を下げる |
| 辞書 / 個人辞書が適用されない | サーバー設定「個人辞書の許可」がオフ / 優先度の低いエントリが上書きされている | サーバー設定で「個人辞書の許可」を ON にする。同一語の優先度を見直す |
| サーバー一覧に出てこない | Discord OAuth スコープが不足 / メンバーシップキャッシュが古い | ダッシュボードで Discord 連携をやり直す (guilds スコープが必要)。最大 5 分でキャッシュ更新 |