yaoyao/docs/verification/windows-client-2026-09-22

Windows 客户端验证

版本：0.4.70。目标为 Windows 10/11 x64 客户端；Windows 不托管本机服务器、Hermes、Runner 或虚拟机。交换协议保持版本 1，无数据库迁移。

Mac 回归

在 Mac 开发环境执行并通过：

• npm run typecheck。
• npm run desktop:build，包含生产界面、Mac 桌面资源和 Swift 助手。
• 服务端 desktopEnvironments、desktopHosts、fileTransfer：75 项。
• 桌面平台、模式、登录、凭据、路径、文件传输、更新生命周期等相关单元测试。仅依赖 Windows 的原生命令测试在 Mac 跳过，在 Windows CI 运行。
• Electron 界面回归：首次启动和远程登录、客户端/服务器双向切换、远程及本地重启更新、更新失败恢复；5 项通过。启动反馈与电脑接管窗口也通过初轮回归。
• Mac 原生更新器代理下载、签名拒绝和等待系统准备完成：2 项通过。
• 独立 Chromium 标签页、截图与持久会话隔离；本机服务启动、关窗驻留、故障恢复和退出清理：2 项通过。

Windows 自动化验收

GitHub Actions 使用 Windows Server 2022 x64、Node 24、锁定的 npm 依赖、MSVC/CMake 和 Windows SDK。该环境与 Windows 10/11 真机矩阵分别记录。

工作流：Windows client。安装包只交付 Actions artifact，没有发布正式 Release。

已在 Windows CI 实测通过：63 项桌面测试及 58 项服务端测试。打包后的客户端连接本地测试登录服务，验证了管理员登录流程、DPAPI 加密、会话恢复、仅客户端模式、托盘关窗；原生助手验证了 PowerShell 中文输出、退出码、超时、取消与子进程清理。当前交互桌面在 100% 缩放下验证了截图、点击、中文/emoji 输入、Ctrl+A、显示变化作废截图、撤销授权，以及独立浏览器截图与 Cookie 隔离。

最终运行：35750511967，全流程通过。CI 源码提交为 4dc2d8b356649291faa2954f32a4558b04bc8c60，对应本地代码提交 0edcc1f。验证时间为 2026-09-22，记录归档于 2026-09-23，系统版本 Windows Server 2022 / 10.0.20348。

验证	结果
类型检查、生产构建、原生助手编译	通过；助手使用静态 MSVC 运行时
安装包结构、EXE、blockmap、更新清单及摘要	通过；客户端 ASAR 不含项目 node_modules
桌面测试 / 服务端测试	63 / 58 项全部通过
NSIS 当前用户安装	通过
隔离源损坏包拒绝及重新下载	通过
0.4.70 → 临时 0.4.71 的实际文件替换	通过
升级后自动重启、登录 Cookie、设置及 DPAPI 数据	通过；使用正常用户数据目录
卸载与应用配置保留	通过

安装升级测试另外 1 项通过，临时 0.4.71 仅用于验证，未发布。隔离更新源未提供旧版 blockmap，本次验证了回退到完整下载后的真实升级；差分下载尚未实测。当前用户安装与升级在一次性 CI 账号中执行，不代表普通用户权限和所有 Windows 10/11 环境均已验收。

交付：未签名 Windows 安装包及更新文件，测试证据。本目录 evidence 保存对应 JSON、截图及更新日志。Actions artifacts 保留至 2026-12-21；下载可能需要登录 GitHub。

EXE 文件名为 Yaoyao-0.4.70-win-x64-setup.exe，SHA-256：

25010f11c7f46c15863090887b933205c1c8076f4c5816c80da6c0307819f1d6

完整 文件校验清单 取自上述构建日志，与安装包内清单对应。安装包 artifact ZIP 的 SHA-256 为 1129c806d1d7d0f5f1caabeb5fec252940dc10a2cc56ba5ff22221e02ac96ec4；测试证据 ZIP 的 SHA-256 为 ed6950df17a79bd9a8369ce72cf8617db8f4c90b6206a7dcbc4f4902fe6a1bb2，归档证据下载后已核对。

尚需 Windows 10/11 真机验收

以下项目没有可用的 Windows 10/11 真机记录，状态为 未验证：

• 干净 Windows 10、Windows 11 普通用户安装；中文 Windows 用户名；登录启动与实际用户登录。
• 100%、150%、200% 缩放及多显示器切主屏；双击、拖拽、滚动、Alt/Win 组合键。
• 原生授权对话框的允许与拒绝；人工接管、锁屏、RDP 断开、UAC 安全桌面、高权限窗口拒绝。
• 与真实夭夭服务器端到端联调：管理员与普通账号、过期会话、更换服务器、断网重连、真实双向文件传输和远程电脑面板。
• Windows 10/11 上实际升级失败后的恢复、签名发布流程及正式证书校验。

完整操作步骤见 Windows 客户端说明。CI 编译或 Windows Server 上的功能测试不替代以上验收。