故障排除

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 通常是最准确的。如果您的反病毒软件是唯一标记此问题的反病毒软件，则很可能是误报。