docs: capture hwlab playwright validation path

2026-06-14 12:46:24 +00:00
parent c00f22eab5
commit 6418d7ace6
3 changed files with 16 additions and 2 deletions
@@ -150,6 +150,8 @@ PW

 该入口只负责短生命周期 Playwright 执行和产物回传，不提供长驻浏览器 daemon。需要多步交互时，把步骤写在同一个 heredoc 内；helper 会在远端后台提交 job，并用短连接轮询 manifest，避免单次 SSH 透传超过 60 秒硬限制。需要保留远端证据时显式加 `--keep-remote`。

+登录态、会话发送和 trace 截图应在同一个 heredoc 中显式等待关键 HTTP response 和稳定 selector，不要只靠宽泛的 `input[type=text]` 或页面标题判断登录成功。对 HWLAB Cloud Web 这类表单，优先定位 `input[autocomplete="username"]`、`input[type="password"]`，并等待 `/auth/login` 返回 `authenticated=true` 后再进入 `/workbench`、创建 session、发送消息和截图。截图对比必须记录实际 URL/lane；例如 D601 `v0.3` 的 `https://hwlab.pikapython.com` 是 PK01 Caddy/FRP 域名入口，而 `http://74.48.78.17:19666/` 属于 G14 `v0.2`/旧 React 工作台对照，不能作为 D601 `v0.3` 的等价验收入口。
+
 ## Async Job State

 长时操作采用 Fire-and-Forget 模式：CLI 创建 `.state/jobs/{jobId}.json`，后台进程执行真实命令，并将 stdout、stderr 分别写入 `.state/jobs/{jobId}.stdout.log` 与 `.state/jobs/{jobId}.stderr.log`。调用者通过 `bun scripts/cli.ts job status <jobId>` 查询进度和尾部输出。