Wave 2.2: 流式安装输出、软件内授权四模式、本机环境一键装与总览缓存

EOF Co-authored-by: Cursor <cursoragent@cursor.com>
2026-08-25 17:11:14 +08:00
parent a2fd5e369b
commit dd5a9378d2
24 changed files with 2659 additions and 263 deletions
@@ -0,0 +1,56 @@
+# AgentDock Wave 2.2 自测记录
+
+## 构建与测试
+
+- `cargo test`：**97 通过 / 0 失败**（基线 Wave 2.1 为 78，本波 +19；另有 7 个 `--ignored` 真机用例）。
+- 前端 `npm run build`（tsc + vite）：通过，无类型错误。
+- `tauri dev` 实机启动：窗口正常打开，控制台出现 `[agentdock] window-ready`（无崩溃）。
+
+## 4 条要求逐条自证
+
+### 1. 安装输出实时滚动（留证：时间戳）
+
+运行交错输出 stdout/stderr 的命令，记录每行到达时间（`cargo test -p agentdock-core real_machine_streaming_evidence -- --ignored --nocapture`）：
+
+```
+[  173ms] stdout out1
+[  177ms] stderr err1
+[  591ms] stdout out2
+[  591ms] stderr err2
+[  995ms] stdout out3
+[  995ms] stderr err3
+[ 1402ms] stdout out4
+[ 1402ms] stderr err4
+```
+
+stderr 在 stdout 结束前**交错实时到达**（旧实现会等 stdout 全部读完才输出 stderr，即结尾回放）。断言 `first_stderr_idx < last_stdout_idx` 通过。另附总览截图 `shot-overview-wave22.png`（1920×1080，窗口已打开）。
+
+人话化映射：单元测试覆盖 `program_not_found→Node`、`permission_denied`、`network_timeout`、`disk_full`、兜底 `exec_failed`（`errors_zh` 6 例全过）；`ActionEvent::error_hint` 携带结构化 `ErrorHint`（含 `missing_runtime`）已测。
+
+### 2. 软件内授权（留证：codex 设备码到出码步骤）
+
+真机跑 `codex login --device-auth`，8 秒后自动取消（走到出码即可，不要求真实账号完成最后一步）：
+
+```
+=== codex 设备码流程（到出码步骤） ===
+验证链接: https://auth.openai.com/codex/device
+设备码: BGBY-I9EY2
+```
+
+断言链接指向官方域名、设备码非空均通过；取消时 `taskkill /T /F` 正确终止整棵进程树（日志可见「成功: 已终止 PID …」）。设备码解析（含 ANSI 去色）另有 2 个单元测试。真机密钥库往返（Windows Credential Manager，写假 key→读回一致→删除清理）通过。
+
+### 3. 本机环境一键安装 + 诊断
+
+- `runtime_install`：来源表白名单校验（`is_url_host_allowed` 精确/子域/伪造域名）6 例单元测试通过；`previewRuntimeInstall` / `openRuntimePage` / `installRuntime`（curl 下载→explorer 打开向导→失败兜底官网）已接线。**未做**：真实下载 30MB+ 安装包并走完安装向导（会弹 UAC，工位不宜真装；代码路径已就位，UI 确认/白名单/兜底逻辑已测）。
+- 总览「立即诊断」：`diagnoseAll` 对全部已装工具跑四类诊断并弹汇总，已接两处入口。**未做**：真机点按截图（留给总工真机 GUI 复核）。
+
+### 4. 总览加载闪烁
+
+- `useDetectAll` / `useEnv` 模块级缓存：切页先用缓存渲染、后台刷新；首检（无缓存）显示骨架屏，空态文案仅在检测完成且零安装时出现。逻辑已实现并通过前端 build。
+
+## 未测到 / 待真机复核
+
+- 真实下载大安装包并走完安装向导（需 UAC，工位不做）。
+- 浏览器 OAuth 全流程到真实登录完成（本机 codex 已登录，为避免覆盖现有会话未真跑完整登录；`browser_oauth` 路径与设备码共用同一套流式/取消/状态刷新机制，且设备码流程已真机走通）。
+- Linux 分支（本波依旧只 Windows）。
+- 总工真机 GUI 逐页点按复核（本卡截图由全屏截取，AI 读图受限，以真机复核为准）。