故障排除

1同伴无法启动

最常见的原因是前一个会话进程卡住，导致配对密钥文件保持打开状态。同伴是单实例 - 当一个已经运行时（即使没有可见的窗口），新的启动会默默退出。

1. 首先检查系统托盘。 查看屏幕右下角靠近时钟的绿色“PC”形图标。如果它在那里，则同伴正在运行 - 只需双击它即可恢复窗口。
2. 杀死任何卡住的实例。 按 控制键+转变+ESC 打开任务管理器。上 详情 选项卡，查找 WindowsHelperCompanion.exe。右键单击 → 结束任务。重复直到没有列出。
3. 再次运行 .exe。 双击“下载”文件夹。 2-3 秒内，窗口出现，托盘图标变为绿色。
4. 还是什么都没有？ 检查滚动诊断日志 %APPDATA%\WindowsHelper\日志\ — 最近的 同伴-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.exe.
2. 如果隔离区已被删除，请从隔离区中恢复。 大多数 AV 产品都有隔离视图（Defender：病毒和威胁防护 → 保护历史记录）。找到该条目，单击它，然后 允许 或 恢复.
3. 验证您下载的 SHA-256。 如果您重新下载，请确认哈希值与发布的哈希值匹配 /companion-version.json:

(Get-FileHash -Algorithm SHA256 ~\Downloads\WindowsHelperCompanion.exe).Hash

4. 最后的手段：暂时尝试不同的 AV 产品。 一些便宜的反病毒软件几乎标记了所有东西；黄金标准的 Windows Defender 通常是最准确的。如果您的反病毒软件是唯一标记此问题的反病毒软件，则很可能是误报。