Agent-Tools/SELF-TEST.md

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 读图受限，以真机复核为准）。