問題の切り分け
問題が発生したら、設定を初期化する前に「いつから」「どの画面で」「どの操作だけが失敗するか」を記録します。起動、モデル接続、ツール実行、ファイル操作を分けて確認すると原因を絞り込みやすくなります。
最初に記録する
Section titled “最初に記録する”- OSとHermes Desktopのバージョン
- 問題が起きた時刻
- 実行した操作
- 表示されたエラー全文
- ローカルバックエンドかリモートバックエンドか
- 直前に変更した設定、更新、追加したMCPやツール
バージョンは情報から確認できます。
症状別の確認
Section titled “症状別の確認”| 症状 | 最初の確認 |
|---|---|
| アプリが起動しない | Desktopログ、更新直後か、空き容量 |
| チャットが応答しない | プロバイダー認証、モデル選択、ネットワーク |
| ツールだけ失敗する | ツール有効化、APIキー、作業フォルダ、承認 |
| MCPだけ接続できない | サーバーコマンド、環境変数、起動ログ |
| リモート接続できない | URL、認証方式、バックエンド起動、VPN・Firewall |
| 更新後に挙動が変わった | バージョン、設定バックアップ、変更履歴 |
Desktopログを確認する
Section titled “Desktopログを確認する”公式ガイドでは、Desktopの起動ログはHERMES_HOME/logs/desktop.logに保存されます。CLIが利用できる場合は次のコマンドで追跡できます。
hermes logs gui -fログを共有するときは、APIキー、トークン、ローカルパス、個人情報を削除してください。
設定を確認する順序
Section titled “設定を確認する順序”初期化する前に
Section titled “初期化する前に”設定のリセットや再インストールを行う前に、設定を書き出し、バージョンとエラーを記録します。