用途:对当前分支或 PR 影响的页面运行端到端浏览器测试,适用于被要求检查当前改动的浏览器测试时。
主要能力:先按策略选择浏览器驱动,优先使用宿主原生集成浏览器,否则回退到 agent-browser,且整个运行只用一个驱动,不引入独立 Playwright、Puppeteer 或其它临时浏览器自动化。根据参数确定测试范围:PR 编号用 gh pr view [number] --json files -q '.files[].path';当前或空参数用 git diff --name-only main...HEAD;分支名用 git diff --name-only main...[branch]。随后把改动文件映射为路由,确定开发服务器端口,验证服务器运行,再逐页导航、检查状态、执行关键交互并留证。
使用方式:默认手动模式由用户控制开发服务器;若回退驱动为 agent-browser,需询问有头或无头运行。管道模式(mode:pipeline)由 LFG 等自动运行器调用,全程无人值守,不阻塞提问,需读取 references/pipeline-orchestration.md 并遵循其端口选择、服务器启动与可见性规则。端口由 scripts/resolve-port.sh 解析,依次取显式端口参数、package.json 中 dev/start 脚本的 --port、.env 等文件中的 PORT=,否则用 3000。执行第 3 步前需读取 references/route-and-report.md,其中包含路由映射模式、端口与服务器命令、逐页检查、两个面向用户的提示及汇总格式。
适用场景:需要验证 PR 或分支改动所影响页面的浏览器行为时。
限制:需要带改动的 git 仓库;遇到 OAuth、邮件、支付、短信、第三方 API 等外部交互流程时,手动模式暂停询问,管道模式记为 Skip 并继续;失败时捕获错误状态与复现步骤,手动模式询问修复或跳过,管道模式记录后继续。运行结束必须报告汇总,每个受影响路由标记 Pass、Fail 或 Skip,Skip 需附原因;若预检阻塞导致无法测试,则报告阻塞项及解除条件。资料未提供安装命令、收费与价格信息。