用途:这是 agent-browser 技能中的内部调试执行协议模板,入口为 agent-browser 技能,由 agent-browser 编排器调用,用于按固定顺序排查 Web 界面问题。
主要能力:提供分诊序列,依次检查 JS 错误、控制台警告、失败的 XHR/fetch 请求(可按状态码、方法过滤)、单个请求的完整请求/响应体、cookies 与 localStorage 认证状态、DOM 快照与元素可见/启用状态、表单有效性,并可打开 DevTools 深入调查。支持用 HAR 记录完整网络轨迹作为持久证据。
使用方式:先执行 agent-browser --headed open <url> 与 agent-browser wait --load networkidle,再依次运行 errors、console --pattern "error|warn"、network requests 等子命令;失败请求用 network request <requestId> 查看完整负载;认证可疑时先看 cookies 与 storage local;HAR 需在导航前用 network har start ./debug-trace.har 开始,复现后 stop,再导入浏览器 DevTools 查看。
适用场景:排查界面损坏、登录/会话异常、网络请求报错等前端调试问题,尤其适合先在无头模式下无法复现时改用 --headed 观察。
限制:属于内部模板,非独立对外工具;文档特别提示不要跳过 errors 直接查 DOM、不要假设认证正常、不要误以为 inspect 会终止 CLI(两者可同时运行)。遇到 JS 错误、认证令牌缺失、API 异常或响应含敏感数据时,应暂停并交由用户判断;敏感数据不应记录。