用途:把一次 headed 验收变成 PR 上可打开的截图证据。先判断变更是否适合截图验收:UI 视觉/交互、状态迁移后行为不变适合截图;纯移除/重构、API 数据正确性应改用量测或 curl,混合型两者都要。
主要能力:按编号列出验收项(B 未登录、C 登录、C8b 补充视角),用 agent-browser 做 headed 验收并截图,存放于 .verification/<日期>-<slug>/<env>/,文件名与编号一一对应;主对话目检抽验截图后再发 comment;最后把截图上传到 PR comment。
必要用法:agent-browser open <url> --headed、agent-browser snapshot -i、agent-browser screenshot <path>。上传需起 stock Chrome 并开 CDP:"/Applications/Google Chrome.app/Contents/MacOS/Google Chrome" --user-data-dir="$HOME/.agent-chrome-profile" --remote-debugging-port=9222 --no-first-run "https://github.com/login?return_to=<PR路径>",再 agent-browser connect 9222,用 agent-browser fill "#new_comment_field" 与 agent-browser upload "#fc-new_comment_field" <文件...> 模拟人工附图。
限制:gh CLI 与 GitHub REST API 不支持 comment 附图,外部图床有曝光风险且多已关闭,agent-browser 内建 Chromium 会被 Google SSO 挡,只有 stock Chrome + CDP 可行;Chrome 136+ 必须用独立 --user-data-dir;截图会以使用者本人身分公开,发送前须人工目检;范围外错误如实记录但不列 FAIL。