このページの翻訳は LLM によって生成されています。誤りに気づいた場合は GitHub で issue を開いてお知らせください。

トラブルシューティング

まずバージョンとセッション状態を確認します:

herdr -V
herdr status

OS、外側のターミナル名とバージョン、ローカルまたはリモートのどちらか、tmux を使用しているかも記録してください。

Enter、Tab、Backspace が 2 回入力される

古いターミナルでは、アプリケーションが Kitty キーボードイベント報告を有効にすると、Enter、Tab、Backspace のリリースをプレスと同じバイトとして送ることがあります。送信後は Herdr から重複したバイトを区別できません。

上流の修正を含むバージョンへ外側のターミナルを更新してください:

長期サポート版 Linux ディストリビューションの古いターミナルパッケージで特に発生します。確認済みの境界キャプチャと上流参照は Herdr issue #1116 を参照してください。現在のターミナルでも発生する場合は、正確なバージョンと Herdr の外でも発生するかを報告してください。

バイナリを更新しても、互換性のある実行中サーバーは自動で置き換わらないことがあります。herdr status を確認してください。更新済みサーバーを起動するには、セッションを停止して Herdr を再起動します:

herdr server stop
herdr

サーバーを停止するとペインのプロセスも終了します。名前付きセッションでは herdr session stop <name> を使います。更新機能、パッケージマネージャー、ライブハンドオフについてはインストールを参照してください。

ターミナルを再起動して環境を読み込み直し、Herdr のインストール先が PATH に含まれていることを確認してください。パッケージマネージャー経由のインストールは、そのパッケージマネージャーから更新して公開する必要があります。インストールを参照してください。

OS または外側のターミナルが Herdr に届く前にキーを処理している可能性があります。そのレイヤーでキーを解放するか、別のバインドを選んでください。既知の競合と安全なデフォルトはキーボードを参照してください。

まず ssh <host> で通常の OpenSSH 接続が動作することを確認してください。非対話シェル、CI、モバイルターミナルでパスフレーズ付きキーを使う場合は、リモートアタッチの前にキーを ssh-agent へ読み込んでください。永続化とリモートアクセスを参照してください。

Herdr のログはデフォルトで ~/.config/herdr/ にあります:

herdr.log
herdr-client.log
herdr-server.log

詳細なログには HERDR_LOG=herdr=debug を設定します。問題を報告するときは現在のログとローテーション済みログを含めてください。設定を参照してください。