トラブルシューティング

1Companion が起動しない

最も多い原因は、ペアリングキーのファイルを開いたままにしている前回セッションの残留プロセスです。Companion は多重起動できません。すでに動いている場合（ウィンドウが見えなくても）、新しい起動は黙って終了します。

1. まず通知領域を確認します。 画面右下、時計の近くに緑色の "PC" の形をしたアイコンがないか見てください。あれば Companion は動いています。ダブルクリックすればウィンドウが戻ります。
2. スタックしたインスタンスをすべて強制終了します。 プレス Ctrl+Shift+Esc をクリックしてタスクマネージャーを開きます。で 詳細 タブで、次で始まるプロセスを探します。 WindowsHelperCompanion。 → [タスクを終了] を右クリックします。リストに何も表示されなくなるまで繰り返します。
3. .exe を再度実行します。 ダウンロード フォルダーからダブルクリックします。 2 ～ 3 秒以内にウィンドウが表示され、トレイ アイコンが緑色に変わります。
4. まだ何もありませんか？ 次の場所でローリング診断ログを確認します。 %APPDATA%\WindowsHelper\logs\ — 最新の companion-YYYYMMDD.ndjson ファイルには起動レコード (または起動を妨げたエラー) があります。メモ帳 → ファイル → を開き、そのパスを貼り付けて確認します。

2ペアリングコードが拒否されました

ペアリング コードは、携帯電話に表示されてから 10 分間有効です。入力に時間がかかった場合、または携帯電話でコードが更新された場合 (一部の画面では、アクセスするたびにコードが切り替わります)、PC に表示されるコードは一致しなくなります。

1. 携帯電話から新しいコードを取得します。 スマートフォンで WindowsHelper を開き、→ タップします PC制御 下部のナビゲーションにあります。新しい 8 文字のコードが表示されます (または既存のコードが表示されます)。
2. 最も混同されやすい文字に注意してください。 コードでは大文字と数字が使用されますが、 I, O, 0, and 1 設計上。これらのいずれかを入力した場合は、入力が間違っています。
3. スマホでコードを見てから 1〜2 分以内に、Companion のウィンドウにコードを入力してください。
4. インターネットチェック。 携帯電話と PC の両方が有効なインターネット接続を必要とします (ペアリング ハンドシェイクは Firestore を介して行われます)。自宅の Wi-Fi が不安定でも同じ症状が発生する可能性があります。弱い方のデバイスで WiFi を無効にしてから再度有効にしてみてください。

3PC 上でコマンドが実行されない

一般的な原因は 3 つあります。レート制限（両端で 1 分あたり 10 コマンドが上限です）、実行前にコマンドを拒否したフライト前の安全性チェック、または電話機側の再ペアリング後の古いペアリング キーによる署名の不一致です。

1. Companion のウィンドウの "ライブ コマンド" セクションを確認します。受信したコマンドは結果とともにそこに記録されます。"事前チェックに失敗しました" や "レート制限に達しました" と出ていれば、それが原因です。レートの枠が空くまで 60 秒待ってください。
2. コンパニオンがコマンドを記録しなかった場合、 電話は決してそれを届けませんでした。 WindowsHelper Companion ログ ビューアを開きます (トレイ アイコン → を右クリックします) ログを表示...)、最新のエントリで Firestore 接続エラーがないか確認します。
3. ペアリングし直します。 署名検証でコマンドが拒否される場合は、電話機と PC のキーが同期していません。トレイ アイコン → を右クリックします ペアリングコードを回転させます... PC で新しいコードを入力し、電話機の PC コントロール画面に新しいコードを再入力します。
4. スマホの PC Control 画面で 接続をテスト をタップして 通信を確認します。成功した ping は <500 ms で応答し、Companion のバージョンと稼働時間を返します。失敗した場合は回線自体が切れているということで、コマンドの問題ではありません。

4電話機に「PC がオフラインです」と表示される

Companion は動作している間、自分を「接続済み」として記録し続けます。PC Control 画面を開いている間、スマートフォンは数秒ごとにそれを再確認します。オフラインのバッジが出る最も多い原因は、PC がスリープしていた、Companion が終了した、または PC のインターネットが切れた、のいずれかです。

1. Companion が動いていることを確認します。 PC の通知領域に緑のアイコンがあるか見てください。見当たらなければ、ダウンロード フォルダーの .exe をダブルクリックして起動し直します。
2. PC を復帰させます。 スリープ中の PC は自分の状態を知らせられません。マウスを動かし、PC Control 画面を数秒開いたままにしてください。バッジは自動的に緑に戻ります。戻らない場合は Companion を起動し直してください。起動した瞬間に状態を知らせます。
3. PC のインターネットを確認します。 PC でブラウザーを開き、任意のウェブサイトを読み込みます。ページが読み込めない場合、Companion は Firestore に到達できていません。ネットワークを直せば、また状態を知らせるようになります。
4. PC Control 画面を開き直します。 前の画面に戻ってから、もう一度 PC Control をタップすると、状態の確認が最初からやり直されます。PC が実際にオンラインなら、バッジは数秒以内に更新されます。

5ウイルス対策ソフトが .exe を隔離しました

自己完結型の .NET .exe は、AV ヒューリスティックの一般的な誤検知です。これらは、.NET ランタイム全体とコードを 1 つのファイルにバンドルしており、発行者を認識しないエンジンに対するマルウェア パッカーと統計的に似ています。コード署名を使用すると、これを排除できます。私たちはそれに取り組んでいます。それまでの間:

1. 再ダウンロードする前に除外を追加してください。 ウイルス対策設定を開きます (Windows Defender: 設定 → プライバシーとセキュリティ → Windows セキュリティ → ウイルスと脅威の保護 → 設定の管理 → 除外の追加または削除)。次のいずれかの除外を追加します。
   • .exe を保存するフォルダー (例: C:\Users\YourName\Downloads）、または
   • で始まる任意のファイル WindowsHelperCompanion (例: WindowsHelperCompanion-*.exe).
2. 隔離がすでに削除されている場合は、隔離から復元します。 ほとんどの AV 製品には隔離ビュー (Defender: ウイルスと脅威の保護 → 保護履歴) があります。エントリを見つけてクリックし、 許可する または 復元.
3. ダウンロードの SHA-256 を確認します。 再ダウンロードした場合は、ハッシュが公開されているものと一致することを確認してください。 /companion-version.json:

(Get-FileHash -Algorithm SHA256 (Get-ChildItem ~\Downloads\WindowsHelperCompanion*.exe | Sort-Object LastWriteTime | Select-Object -Last 1)).Hash

4. 最後の手段: 一時的に別の AV 製品を試してください。 一部のお買い得品 AV では、ほぼすべてにフラグが立てられます。通常、ゴールドスタンダードの Windows Defender が最も正確です。 AV だけがこのフラグを立てている場合は、誤検知である可能性が非常に高くなります。