故障排除

1同伴無法啟動

最常見的原因是前一個會話進程卡住，導致配對金鑰檔案保持開啟狀態。同伴是單一實例 - 當一個已經運行時（即使沒有可見的視窗），新的啟動會默默退出。

1. 首先檢查系統托盤。 查看螢幕右下角靠近時鐘的綠色“PC”形圖示。如果它在那裡，則同伴正在運行 - 只需雙擊它即可恢復視窗。
2. 殺死任何卡住的實例。 新聞 Ctrl+Shift+Esc 開啟工作管理員。上 詳情 選項卡，尋找以以下內容開頭的進程 WindowsHelperCompanion。右鍵點選 → 結束任務。重複直到沒有列出。
3. 再次運行 .exe。 雙擊“下載”資料夾。 2-3 秒內，視窗出現，托盤圖示變為綠色。
4. 還是什麼都沒有？ 檢查滾動診斷日誌 %APPDATA%\WindowsHelper\logs\ — 最近的 companion-YYYYMMDD.ndjson 文件具有啟動記錄（或阻止啟動的錯誤）。打開記事本 → 檔案 → 打開並貼上該路徑以查看它。

2配對碼被拒絕

配對碼自您手機顯示之日起 5 分鐘內有效。如果您輸入的時間較長，或者您的手機刷新了代碼（某些螢幕在每次訪問時都會輪換代碼），您的電腦看到的代碼將不再匹配。

1. 從您的手機獲取新的代碼。 在手機上開啟 WindowsHelper → 點按 電腦控制 在底部導航中。將出現一個新的 8 字元代碼（或顯示現有代碼）。
2. 注意最容易混淆的字元。 代碼使用大寫字母和數字 - 但不包括 I, O, 0, and 1 透過設計。如果您輸入其中任何一個，則表示您輸入錯誤。
3. 在配套視窗中輸入程式碼 在手機上看到它後一兩分鐘內。
4. 上網檢查。 您的手機和 PC 都需要有效的網路連線（配對握手透過 Firestore 進行）。不穩定的家庭 WiFi 可能會導致相同的症狀 - 嘗試在較弱的裝置上停用並重新啟用 WiFi。

3命令未在我的電腦上運行

三個常見原因：速率限制（兩端上限為每分鐘 10 個命令）、執行前拒絕命令的飛行前安全檢查或電話端重新配對後陳舊配對金鑰的簽名不符。

1. 檢查「即時指令」配套視窗中的部分 — 每個收到的命令及其結果都會記錄在那裡。如果顯示“預檢查失敗”或“達到速率限制”，這就是您的原因。等待 60 秒以清除速率視窗。
2. 如果同伴從未記錄過該命令， 電話從未送達。開啟 WindowsHelper Companion 日誌檢視器（右鍵點選托盤圖示 → 查看日誌...）並檢查最近條目中的 Firestore 連線錯誤。
3. 維修。 如果簽名驗證拒絕您的命令，則手機和 PC 金鑰不同步。右鍵單擊托盤圖示 → 新配對碼 在 PC 上，然後在手機的 PC 控制畫面上重新輸入新代碼。
4. 測試連通性 透過點擊 測試連接 在電話的 PC 控制畫面中。配套版本 + 正常運作時間可在 <500 毫秒內成功完成 ping 回覆。失敗意味著電線本身斷了——而不是你的命令。

4手機顯示“電腦離線”

同伴每 30 秒就會寫入 Firestore 心跳。如果最近的心跳超過約 90 秒，手機會認為 PC 離線。最常見的原因是電腦正在睡眠、同儕退出或電腦的網路故障。

1. 確認同伴正在運行。 查看電腦的系統托盤中是否有綠色圖示。如果遺失，請雙擊下載資料夾中的 .exe 重新啟動。
2. 喚醒電腦。 如果您的電腦處於睡眠狀態，心跳就會停止，直到它被喚醒。移動滑鼠，然後等待 30-60 秒，等待下一次心跳到來 - 手機的藥丸會自動翻轉回綠色。
3. 檢查電腦的網路。 在電腦上開啟瀏覽器並載入任何網站。頁面載入失敗意味著心跳無法到達 Firestore - 修復網絡，然後心跳恢復。
4. 點選手機上的刷新。 PC 控制螢幕上的拉動刷新會強制重新檢查心跳文件。如果電腦確實在線，則藥丸會立即更新。

5防毒軟體隔離了 .exe

自包含的 .NET .exe 是 AV 啟發式的一種常見誤報 - 它們將整個 .NET 運行時 + 您的程式碼捆綁到一個檔案中，從統計角度來看，該檔案與無法識別發布者的引擎的惡意軟體加殼程式相似。程式碼簽名消除了這個問題；我們正在努力。同時：

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 產品。 一些便宜的防毒軟體幾乎標記了所有東西；黃金標準的 Windows Defender 通常是最準確的。如果您的防毒軟體是唯一標記此問題的防毒軟體，則很可能是誤報。