更新与卸载

为什么两个版本号不同

Windows 和 Android 的发布节奏不同：

• 只修改手机交互时，可以只发布新版 APK，不重打 Windows EXE。
• 构建 Windows 安装器时，会把当时已经核对包名、版本和 SHA256 的 APK 放进安装包。
• Windows 安装器发布后，官网仍可以继续单独发布更新的 Android APK。
• 手机只比较 Android 版本，不会因为电脑端版本号较小或较大就提示故障。

更新 Windows 客户端

1. 下载新的 Windows 安装器

   确认文件来自官网，并核对下载页公布的版本和 SHA256。

2. 关闭 Woodox 图形窗口

   升级会处理电脑端服务文件。普通 Agent 会话不应因覆盖程序文件而被删除。

3. 重新运行安装器

   安装器会先备份上一版程序文件，再覆盖新版。

4. 重新打开桌面快捷方式

   进入 “设置”或版本信息确认 Windows 版本，再启动后台服务。

5. 检查 Agent 和手机连接

   本机私有配置会保留，但仍建议确认 Agent 设置、已有设备和公网隧道状态。

升级默认保留 .codex-mobile中的访问凭据、设备记录和远程配置。

更新 Android App

1. 在官网 下载中心下载最新 APK，或在 Android App 的更新入口获取安装包。
2. 打开 APK，允许系统在现有 App 上安装更新。
3. 更新后打开“关于”或页面版本信息，确认 Android 版本号。
4. 保存的电脑连接通常会继续存在；如果连接信息已被电脑端重置，需要重新扫码。

Android 的 versionCode必须递增才能覆盖安装；官网只发布已经核对包名、版本、文件大小和 SHA256 的 APK。

核对下载文件

下载页会公布每个可下载文件的 SHA256。在 Windows PowerShell 中运行：

Get-FileHash .\文件名.exe -Algorithm SHA256

APK 同样可以核对：

Get-FileHash .\Woodox-Android-v0.9.09.apk -Algorithm SHA256

大小写不影响哈希比较，但 64 位十六进制内容必须完全相同。不同说明文件损坏、下载未完成或来源不是当前发布文件。

升级后无法使用

1. 先打开 “诊断”，查看具体异常项。
2. 使用诊断页提供的修复操作或重新启动后台服务。
3. 仍无法解决时，点击下载/复制支持包并发给维护者。
4. 上一版程序备份属于维护能力，普通界面不默认显示。由维护者确认后再回退，避免把正常的新配置一起误判为版本故障。

卸载

通过 Windows 设置中的应用卸载入口或安装目录提供的卸载程序移除客户端。默认保留本机私有数据，方便以后重新安装继续使用。

Android App 可以在系统应用设置中直接卸载。卸载只清除手机端数据，不会结束电脑上的 Agent 会话。