记录 Windows 客户端实测结果与安装包校验值

docs/verification/windows-client-2026-09-22/README.md

@@ -0,0 +1,60 @@
+# 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](https://github.com/Lsamien/yaoyao/actions/workflows/windows-client.yml)。安装包只交付 Actions artifact，没有发布正式 Release。
+
+已在 Windows CI 实测通过：63 项桌面测试及 58 项服务端测试。打包后的客户端连接本地测试登录服务，验证了管理员登录流程、DPAPI 加密、会话恢复、仅客户端模式、托盘关窗；原生助手验证了 PowerShell 中文输出、退出码、超时、取消与子进程清理。当前交互桌面在 100% 缩放下验证了截图、点击、中文/emoji 输入、Ctrl+A、显示变化作废截图、撤销授权，以及独立浏览器截图与 Cookie 隔离。
+
+最终运行：[35750511967，全流程通过](https://github.com/Lsamien/yaoyao/actions/runs/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 安装包及更新文件](https://github.com/Lsamien/yaoyao/actions/runs/35750511967/artifacts/10705091432)，[测试证据](https://github.com/Lsamien/yaoyao/actions/runs/35750511967/artifacts/10705211454)。本目录 `evidence` 保存对应 JSON、截图及更新日志。Actions artifacts 保留至 2026-12-21；下载可能需要登录 GitHub。
+
+EXE 文件名为 `Yaoyao-0.4.70-win-x64-setup.exe`，SHA-256：
+
+```text
+25010f11c7f46c15863090887b933205c1c8076f4c5816c80da6c0307819f1d6
+```
+
+完整 [文件校验清单](evidence/SHA256SUMS-win-x64.txt) 取自上述构建日志，与安装包内清单对应。安装包 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 客户端说明](../../windows-client.md)。CI 编译或 Windows Server 上的功能测试不替代以上验收。

docs/verification/windows-client-2026-09-22/evidence/SHA256SUMS-win-x64.txt

@@ -0,0 +1,3 @@
+25010f11c7f46c15863090887b933205c1c8076f4c5816c80da6c0307819f1d6  Yaoyao-0.4.70-win-x64-setup.exe
+7e86699fcf41c3a9ea01aa94748db05c72fe54108fac3a534a4b44609511590f  Yaoyao-0.4.70-win-x64-setup.exe.blockmap
+0cd4ac712b77a985badd61999e3858b942a7da9fad77c900c9208ac08020f49d  latest.yml

docs/verification/windows-client-2026-09-22/evidence/smoke.json

@@ -0,0 +1,19 @@
+{
+  "platform": "win32",
+  "login": true,
+  "encryptedPairing": true,
+  "sessionRestored": true,
+  "clientOnly": true,
+  "native": {
+    "shell": true,
+    "isolatedBrowser": true,
+    "screenshot": true,
+    "click": true,
+    "unicodeInput": true,
+    "ctrlA": true,
+    "displayInvalidation": true,
+    "revoked": true,
+    "scaleFactor": 1
+  },
+  "windows10and11Matrix": "requires Windows 10/11 acceptance; CI runs Windows Server 2022"
+}

docs/verification/windows-client-2026-09-22/evidence/upgrade-main.log

@@ -0,0 +1,37 @@
+2026-09-22T15:59:14.252Z [更新:info] Checking for update
+2026-09-22T15:59:14.256Z [更新:info] Generated new staging user ID: 50f9de12-833b-58a5-be79-f3145335ef85
+2026-09-22T15:59:14.267Z [更新:info] Found version 0.4.71 (url: Yaoyao-0.4.71-win-x64-setup.exe)
+2026-09-22T15:59:14.319Z [更新:info] Downloading update from Yaoyao-0.4.71-win-x64-setup.exe
+2026-09-22T15:59:14.320Z [更新:debug] updater cache dir: C:\Users\runneradmin\AppData\Local\yaoyao-upgrade-d1acfd91-cbfd-4fa8-adfa-853f5711e481
+2026-09-22T15:59:14.321Z [更新:warn] disableWebInstaller is set to false, you should set it to true if you do not plan on using a web installer. This will default to true in a future version.
+2026-09-22T15:59:14.322Z [更新:info] Download block maps (old: "http://127.0.0.1:60116/feed/Yaoyao-0.4.70-win-x64-setup.exe.blockmap", new: http://127.0.0.1:60116/feed/Yaoyao-0.4.71-win-x64-setup.exe.blockmap)
+2026-09-22T15:59:14.338Z [更新:error] Cannot download differentially, fallback to full download: Error: Cannot download "http://127.0.0.1/feed/Yaoyao-0.4.70-win-x64-setup.exe.blockmap", status 404: Not Found
+    at ClientRequest.<anonymous> (C:\Users\runneradmin\AppData\Local\Temp\yaoyao-upgrade-KUczhi\app\resources\runtime\electron-updater.cjs:3643:30)
+    at ClientRequest.emit (node:events:509:28)
+    at SimpleURLLoaderWrapper.<anonymous> (node:electron/js2c/browser_init:2:138237)
+    at SimpleURLLoaderWrapper.emit (node:events:509:28)
+2026-09-22T15:59:14.344Z [更新:error] Error: Error: sha512 checksum mismatch, expected ZP3MT8+w1DN8TweOLwTzNUuTpf0V7mWjx+AH95PWQrsfnLvCI8WhjKWjhQLK5+UhQhLmX6voBhVyJhGBvwSReg==, got gYvvGCo6Vo/XWRQyghY1fV1xKKL9IVWA3Vo2+eXxgR2Z1unrcEb4ebb7w2C1Vz3IKicvPdDFiOHthn3A7IgxOg==
+    at newError (C:\Users\runneradmin\AppData\Local\Temp\yaoyao-upgrade-KUczhi\app\resources\runtime\electron-updater.cjs:2597:21)
+    at DigestTransform.validate (C:\Users\runneradmin\AppData\Local\Temp\yaoyao-upgrade-KUczhi\app\resources\runtime\electron-updater.cjs:3804:38)
+    at DigestTransform._flush (C:\Users\runneradmin\AppData\Local\Temp\yaoyao-upgrade-KUczhi\app\resources\runtime\electron-updater.cjs:3791:18)
+    at DigestTransform.final [as _final] (node:internal/streams/transform:128:10)
+    at prefinish (node:internal/streams/writable:914:14)
+    at finishMaybe (node:internal/streams/writable:928:5)
+    at Writable.end (node:internal/streams/writable:843:5)
+    at ProgressCallbackTransform.onend (node:internal/streams/readable:950:10)
+    at Object.onceWrapper (node:events:630:28)
+    at ProgressCallbackTransform.emit (node:events:509:28)
+2026-09-22T15:59:14.410Z [更新:info] Checking for update
+2026-09-22T15:59:14.414Z [更新:info] Found version 0.4.71 (url: Yaoyao-0.4.71-win-x64-setup.exe)
+2026-09-22T15:59:14.441Z [更新:info] Downloading update from Yaoyao-0.4.71-win-x64-setup.exe
+2026-09-22T15:59:14.443Z [更新:warn] disableWebInstaller is set to false, you should set it to true if you do not plan on using a web installer. This will default to true in a future version.
+2026-09-22T15:59:14.443Z [更新:info] Download block maps (old: "http://127.0.0.1:60116/feed/Yaoyao-0.4.70-win-x64-setup.exe.blockmap", new: http://127.0.0.1:60116/feed/Yaoyao-0.4.71-win-x64-setup.exe.blockmap)
+2026-09-22T15:59:14.477Z [更新:error] Cannot download differentially, fallback to full download: Error: Cannot download "http://127.0.0.1/feed/Yaoyao-0.4.70-win-x64-setup.exe.blockmap", status 404: Not Found
+    at ClientRequest.<anonymous> (C:\Users\runneradmin\AppData\Local\Temp\yaoyao-upgrade-KUczhi\app\resources\runtime\electron-updater.cjs:3643:30)
+    at ClientRequest.emit (node:events:509:28)
+    at SimpleURLLoaderWrapper.<anonymous> (node:electron/js2c/browser_init:2:138237)
+    at SimpleURLLoaderWrapper.emit (node:events:509:28)
+2026-09-22T15:59:14.980Z [更新:info] New version 0.4.71 has been downloaded to C:\Users\runneradmin\AppData\Local\yaoyao-upgrade-d1acfd91-cbfd-4fa8-adfa-853f5711e481\pending\Yaoyao-0.4.71-win-x64-setup.exe
+2026-09-22T15:59:15.363Z [更新:info] Install on explicit quitAndInstall
+2026-09-22T15:59:15.364Z [更新:info] Install: isSilent: false, isForceRunAfter: true
+2026-09-22T15:59:15.364Z [更新:info] Executing: C:\Users\runneradmin\AppData\Local\yaoyao-upgrade-d1acfd91-cbfd-4fa8-adfa-853f5711e481\pending\Yaoyao-0.4.71-win-x64-setup.exe with args: --updated,--force-run

docs/verification/windows-client-2026-09-22/evidence/upgrade.json

@@ -0,0 +1,14 @@
+{
+  "platform": "win32",
+  "from": "0.4.70",
+  "to": "0.4.71",
+  "installed": true,
+  "corruptDownloadRejected": true,
+  "nsisReplacement": true,
+  "automaticRestart": true,
+  "cookieRestored": true,
+  "settingsPreserved": true,
+  "dpapiPreserved": true,
+  "uninstalled": true,
+  "dataRetained": true
+}

docs/windows-client.md

@@ -38,7 +38,7 @@ Windows 更新使用 NSIS，只有用户点击“重启更新”才安装，先
 
 ## 验证记录与人工验收
 
-自动测试覆盖平台模式、路径边界、凭据提供器、更新状态、设备权限与来源路由。Windows CI 另外编译并自检原生助手，测试真实 PowerShell 及子进程清理，以及打包应用的登录、DPAPI 配置保存、会话恢复、菜单与托盘行为。交互会话可用时，测试原生截图、点击、中文/emoji 输入、组合键、显示变化、授权撤销及独立浏览器。升级测试临时构建下一个版本，实际安装、拒绝损坏包、下载、重启替换，再检查设置、Cookie、DPAPI 数据保留与卸载。临时升级版本不会上传或发布。测试证据位于 `test-results/windows-client`，实际运行结果另见验证记录。
+自动测试覆盖平台模式、路径边界、凭据提供器、更新状态、设备权限与来源路由。Windows CI 另外编译并自检原生助手，测试真实 PowerShell 及子进程清理，以及打包应用的登录、DPAPI 配置保存、会话恢复、菜单与托盘行为。交互会话可用时，测试原生截图、点击、中文/emoji 输入、组合键、显示变化、授权撤销及独立浏览器。升级测试临时构建下一个版本，实际安装、拒绝损坏包、下载、重启替换，再检查设置、Cookie、DPAPI 数据保留与卸载。临时升级版本不会上传或发布。测试证据位于 `test-results/windows-client`，实际运行结果见 [验证记录](verification/windows-client-2026-09-22/README.md)。
 
 以下项目需要真实 Windows 10 和 Windows 11 交互环境，不以 CI 编译或模拟响应代替：