故障排除

1Companion 無法啟動

最常見的原因是上一次工作階段殘留的處理程序仍占用配對金鑰檔案。Companion 只允許單一執行個體 — 如果已經有一個在執行（就算看不到視窗），新啟動的那個會靜默結束。

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

2配對碼被拒絕

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

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

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

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

1. 查看 Companion 視窗裡的"即時命令"區域 — 每條收到的命令都會連同結果記錄在那裡。如果顯示"預檢失敗"或"已達速率上限"，那就是原因。等 60 秒讓速率視窗清空。
2. 如果同伴從未記錄過該命令， 電話從未送達。開啟 WindowsHelper Companion 日誌檢視器（右鍵點選托盤圖示 → 查看日誌...）並檢查最近條目中的 Firestore 連線錯誤。
3. 重新配對。 如果簽名驗證拒絕您的命令，則手機和 PC 金鑰不同步。右鍵單擊托盤圖示 → 旋轉配對碼... 在 PC 上，然後在手機的 PC 控制畫面上重新輸入新代碼。
4. 在手機的 PC Control 介面點按 測試連線 來 檢查連通性。成功的 ping 會在 <500 ms 內回傳 Companion 版本和執行時長。失敗表示是連線本身斷了 — 不是你的命令有問題。

4手機顯示“電腦離線”

Companion 在執行期間會把自己標記為已連線，只要 PC Control 畫面開著，你的手機就會每隔幾秒重新核對一次。出現離線標記最常見的原因是電腦進入睡眠、Companion 被關閉，或者電腦斷網了。

1. 確認 Companion 正在執行。在電腦的系統匣裡找那個綠色圖示。如果不見了，雙擊「下載」資料夾裡的 .exe 重新啟動它。
2. 喚醒電腦。 睡眠中的電腦無法回報自己的狀態。動一下滑鼠，然後讓 PC Control 畫面開著幾秒鐘——標記會自己變回綠色。如果沒有變，請重新啟動 Companion：它一啟動就會回報狀態。
3. 檢查電腦的網路。 在電腦上開啟瀏覽器，載入任一網站。頁面打不開表示 Companion 連不上 Firestore——修好網路，它就會重新回報狀態。
4. 重新開啟 PC Control 畫面。 退回上一層，再點一次 PC Control，狀態檢查就會從頭開始。如果電腦確實在線上，標記會在幾秒內更新。

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 通常是最準確的。如果您的防毒軟體是唯一標記此問題的防毒軟體，則很可能是誤報。