bdg - Browser Debug Gateway
bdg 是一个通过 Chrome DevTools Protocol 提供浏览器遥测与调试能力的命令行工具，主要用于测试 Astro 开发服务器。以下按用途、主要能力、使用方式、适用场景和限制分段介绍。
一、用途 bdg 面向浏览器调试与遥测场景，典型用途包括：测试 Astro 开发服务器、检查网络请求、调试控制台错误。它通过 Chrome DevTools Protocol 连接浏览器，采集会话数据供后续查看与分析。
二、主要能力
- 会话管理：在开发服务器上启动会话（如 bdg http://localhost:4321/）、查看会话状态、停止并保存会话到 ~/.bdg/session.json、停止并关闭 Chrome、清理陈旧会话，以及强制结束所有 Chrome 实例。
- 数据检视（Peek，非破坏性预览）：可查看全部数据摘要，或仅查看网络请求、仅查看控制台消息、查看 DOM/A11y 树，支持跟随模式（类似 tail -f）、查看最后 N 项、输出 JSON。
- 网络分析：列出所有请求、仅列出失败请求、按类型过滤（如 XHR）、查看主文档请求头、查看指定请求头、列出 cookies、导出为 HAR 文件。
- 控制台分析：列出全部消息、仅错误、仅警告、实时跟随、查看最后若干条消息。
- 详情查看：查看指定请求的完整详情、查看指定控制台消息的完整内容。
- DOM 交互：
- 检查：查看无障碍树、在无障碍树中搜索、使用 CSS 选择器查询、获取元素结构、获取原始 HTML。
- 操作：点击元素、填写输入框、提交表单、按键、执行 JS 表达式。
- 截图：整页截图、指定元素截图。
- CDP 协议访问：列出共 53 个域、搜索方法、描述方法详情、执行 CDP 方法。
三、使用方式 快速开始： bdg http://localhost:4321/ # 在 Astro 开发服务器上启动会话 bdg status # 查看状态 bdg peek # 预览已采集的数据 bdg stop # 停止并保存会话
常用命令示例： bdg stop --kill-chrome # 停止并关闭 Chrome bdg cleanup # 清理陈旧会话 bdg cleanup --aggressive # 强制结束所有 Chrome 实例 bdg peek -n / -c / -d / -f / --last 20 / -j bdg network list / --failed / --type XHR bdg network headers / <id> / getCookies / har bdg console -l / --level error / --level warning / -f / --last 50 bdg details request <id> / console <id> bdg dom a11y ["button"] bdg dom query "nav a" bdg dom get "header" / "article" --raw bdg dom click "button.submit" bdg dom fill "input[name=email]" "test" bdg dom submit "form" bdg dom pressKey "input" "Enter" bdg dom eval "document.title" bdg dom screenshot ./shot.png bdg dom screenshot ./el.png -s "header" bdg cdp --list / --search cookie / --describe Network.getCookies / Network.getCookies
选项参考： -q, --quiet 面向 AI 代理的精简输出 -j, --json JSON 输出（大多数命令支持） --headless 不显示浏览器窗口 -t, --timeout <s> 在 N 秒后自动停止 -p, --port <n> Chrome 调试端口（默认 9222） --debug 详细日志
输出文件： 会话数据：~/.bdg/session.json Chrome 配置：~/.bdg/chrome-profile/
常见工作流示例：
- 测试页面加载性能：启动会话、浏览站点、bdg peek -n 检查网络请求、bdg network list --failed 查看失败请求、bdg stop 结束。
- 调试控制台错误：启动会话、bdg console --level error 或 bdg console -f 实时监控。
- 检查无障碍：启动会话、bdg dom a11y 查看完整无障碍树、bdg dom a11y "navigation" 查找导航元素。
- 捕获视觉状态：启动会话、整页截图或指定元素截图。
四、适用场景 适用于前端开发过程中对 Astro 开发服务器的调试与验证，包括网络请求分析、控制台错误排查、无障碍检查、DOM 交互测试以及页面视觉状态捕获。其 -q 精简输出与 -j JSON 输出选项便于 AI 代理集成使用。
五、限制 资料中未提供关于该工具的安装步骤、收费方式、价格、性能指标或平台兼容性的明确说明，暂未提供。会话数据保存路径与 Chrome 配置路径已在输出文件部分给出发送。