SuperAPI AI 工具集

browser-trace

通用与其它

查看项目

更新于 10-15 18:37

技能介绍

用途:为已在运行的浏览器自动化附加一个只读的第二 CDP 客户端,记录完整 DevTools 事件流、截图与 DOM 快照,用于排查失败表单、缺失元素、导航挂起、JS 异常等问题;也可在不重启自动化的情况下中途接入录制。它本身不驱动页面,只做监听,需配合 browser 技能、browse、Stagehand、Playwright 等支持 CDP 的工具。

主要能力:CDP firehose 将每个事件以一行 JSON 写入 cdp/raw.ndjson;采样循环按间隔(默认 2s)调用 browse screenshot 与 browse get html body;bisect-cdp.mjs 将原始流按 CDP 方法切分为 network、console、runtime、log、page、target、dom 等桶文件,并以顶层 Page.frameNavigated 为边界切出 per-page 目录。产物包括 manifest.json、index.jsonl、cdp/summary.json、screenshots/ 与 dom/。

使用方式:需 Node 18+,可用 npm install -g browse,可选 jq。本地 Chrome 流程为:以 --remote-debugging-port=9222 启动 Chrome,运行 node scripts/start-capture.mjs 9222 my-run,用自动化连接端口 9222,然后 node scripts/stop-capture.mjs my-run 与 node scripts/bisect-cdp.mjs my-run。Browserbase 远程用 bb-capture.mjs(--new 或传入 session id)与 bb-finalize.mjs,并需设置 BROWSERBASE_API_KEY。可用 scripts/query.mjs <run-id> <command> 交互查询。

适用场景与限制:适合本地或 Browserbase 上的浏览器自动化调试与事后事件分析。远程需先用 --keep-alive 创建会话,并让主自动化先于或同时于 tracer 接入;采样间隔不建议快于约 1s;默认域为 Network Console Runtime Log Page,DOM 需通过 O11Y_DOMAINS 启用且噪声大;会话回放(rrweb)抓取已弃用,不提供;日志常为空,CDP firehose 才是真实来源;运行结束应执行 stop-capture.mjs;bb-finalize.mjs 仅在自建会话时使用 --release。