57 lines
3.4 KiB
Markdown
57 lines
3.4 KiB
Markdown
# 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 读图受限，以真机复核为准）。
|