用途:消费 browser-trace 采集到的 CDP 请求/响应事件,配对流量、对观测 URL 做模板化、从样本推断 JSON Schema,最终输出 OpenAPI 3.1 文档和人类可读的覆盖率报告。它本身不抓包,只对 browser-trace 的 cdp/network/*.jsonl 做离线后处理。
主要能力:自动过滤追踪、反爬、会话与 HTML 页面等噪声,通常可去掉 60%–80% 流量;按 operationName 等字段拆解 GraphQL/多路复用端点;输出 openapi.yaml/json、零依赖 client.mjs、report.md、confidence.json、样本与中间产物,以及自包含的 index.html 报告(含变量表、客户端用法与请求/响应示例)。
使用方式:先用 browser-trace 抓取,可选 browse network on 保存请求/响应体;再运行 node scripts/discover.mjs --run .o11y/my-site,打开生成的 index.html。常用参数包括 --run、--out、--bodies、--include、--exclude、--origins、--format、--title、--redact、--min-samples、--stage。
适用场景:为无文档或第三方网站 API 生成规范、基于 browser-trace 运行提取端点与 Schema、构建客户端/SDK、查看哪些流程能扩展规范覆盖。
限制:覆盖范围受限于已捕获流程,无法证明完整性;Schema 是归纳而非契约;认证仅被观测记录,不声明安全方案;路径模板为启发式;脱敏是尽力而为。具体安装与运行命令以资料中给出的 CLI 为准。