トラブル・FAQ
よくあるトラブルと解決方法、そしてよくある質問（FAQ）をまとめました。困ったときはまずここを確認してください。
トラブルシューティング
チャットボタンがサイトに表示されない
- プラグインが「有効化」されているか確認します。
- 「表示」タブの「チャットを表示するページ」が、見ているページと合っているか確認します（例:「トップページのみ」になっていないか）。
- ブラウザのキャッシュが原因のこともあります。スーパーリロード（Windows:
Ctrl+Shift+R/ Mac:Cmd+Shift+R）を試します。 - キャッシュ系プラグインやPWA（Service Worker）を使っている場合は、後述の「キャッシュ」の項目を参照。
「該当するページが見つかりませんでした」ばかり出る
- 「インデックス」で索引が作成済みか（ページ数が表示されるか）を確認します。未作成なら「今すぐ再構築」。
- 質問に対応するページがサイトに実在するか確認します。無いテーマは案内できません（「分析」のコンテンツギャップが参考になります）。
- 除外ルールで対象を外しすぎていないか確認します。
- コスト上限・回数上限に達していないか（「プライバシー・安全」）。達していると安全装置で「該当なし」に切り替わります。
「通信エラーが発生しました」と出る
- APIキーが正しいか（「AI・モデル」タブ）。キーの打ち間違い・期限切れ・無効化に注意。
- AIサービス側で支払い設定（課金）が有効になっているか。
- サーバーから外部（AIサービス）への通信がブロックされていないか。レンタルサーバーの設定や、外部接続を制限するプラグイン・定数に注意。
- 選んだAIサービスが一時的に混雑している場合があります。少し時間をおいて再度試します。
回答が英語になってしまう
- 本プラグインは日本語で質問されれば日本語で答えるように作られています。改善版で対策済みです。最新版を使っているか確認してください。
- 「AI・モデル」の「AIへの指示文」に英語の指示が入っていないか確認します。
設定を変えたのに反映されない（キャッシュ）
- まずスーパーリロード（
Ctrl+Shift+R/Cmd+Shift+R）。 - PWA（Service Worker）を導入している場合、通常のリロードでは古い表示が残ることがあります。シークレット／プライベートウィンドウで開くと確実に最新が表示されます。または、ブラウザの開発者ツールで「Service Worker の登録解除」「サイトデータの消去」を行います。
- キャッシュ系プラグインを使っている場合は、そのプラグインでキャッシュを削除します。
索引の再構築が終わらない／時間がかかる
- ページ数が多いと時間がかかります。完了表示が出るまで待ちます。
- 検索AIのAPIキー・支払い設定を確認します。
- コスト上限に達していると途中で止まります。上限を確認します。
よくある質問（FAQ）
Q. 無料で使えますか？
プラグイン自体は使えますが、AIの利用は各サービスの従量課金です。OpenAI 等のアカウントと支払い設定が必要です。使いすぎは「プライバシー・安全」の上限で防げます。
Q. どのAIサービスを選べばいいですか？
迷ったら検索AI・回答AIの両方を OpenAI。回答AIだけ GLM や Ollama に変えることもできますが、検索AIは OpenAI 等の埋め込み対応サービスが必要です（比較表）。
Q. APIキーは安全に保管されますか？
はい。キーは暗号化して保存し、フロント（訪問者側）には一切出力しません。万一漏れた場合は、サービス側でそのキーを無効化して作り直してください。
Q. 記事を追加したら、何かする必要がありますか？
「インデックス」で索引を再構築すると新しい記事が案内対象になります。自動（定期）再構築を設定しておけば手間がかかりません。
Q. 自分でテストした質問は分析に混ざりますか？
混ざりません。ログイン中のあなたの質問は「管理者テスト」として別枠で集計され、訪問者の集計には含まれません（分析）。
Q. タグやカテゴリーのページを案内させたくない
「インデックス」の除外ルールに /tag/ や /category/ を1行ずつ追加して再構築してください。いつでも解除できます。
Q. スマホでチャットボタンが小さい「💁」になるのはなぜ？
仕様です。スマホでは他の固定ボタンと重ならないよう、自動的に小さな丸ボタンになります。タップで通常どおり開きます（表示カスタマイズ）。