bdg

bdg (Browser Debugger CLI) 是一款高效且精简的命令行界面，专为 AI 代理与开发者设计，通过 Chrome DevTools Protocol (CDP) 与网页浏览器进行直接互动。与 Puppeteer 或 Playwright 等大型框架不同，bdg 维持持久化的会话状态，允许进行连续且具备状态的自动化任务，而无需每次都重新初始化框架。它特别针对需要细粒度控制的代理进行优化，例如爬取动态 SPA 内容、管理网络流量或在隔离环境中执行 JavaScript。

• 完整的 CDP 访问权限：可连接超过 60 个 CDP 域与 600 多种方法，包括 Page、Network、Runtime、DOM 与 Emulation 等域。

• 以代理为中心的设计：具备 --list、--search 与 --describe 等自我探索指令，协助代理在不需要外部文档的状况下自动导航协议架构。

• 持久化会话：在有状态模式下运行，保持 Chrome 实例活跃，非常适合基于 HMR 的开发环境或长时间运行的多步骤自动化工作流程。

• 代币效率互动：采用选择性 DOM 查询与语义数据提取，而非转储完整的辅助功能树，为 LLM 将上下文窗口的占用降至最低。

• Unix 风格可组合性：设计用于与 shell 管道、jq JSON 处理工具以及自定义 Chrome 旗标的环境变量无缝整合。

• 健全的错误处理：提供语义化退出代码与描述性错误消息，以促进代理驱动会话期间的自我修正与自动化恢复。

• 使用场景：爬取动态 JavaScript 驱动的网站、自动化登录流程、测试 UI 交互、调试网络请求，以及利用目标元素截图进行自动化视觉回归测试。

• 输入：接收 URL、CSS 选择器、JS 表达式以及 JSON 格式的标准 CDP 方法参数。

• 输出：返回结构化的 JSON 数据、指令状态指标以及用于验证的屏幕截图。

• 操作限制：需要 Chrome 或 Chromium 浏览器。适用于 Linux/macOS/WSL 环境。由于会话是持久的，用户必须使用 stop 指令明确管理生命周期，以防止产生无效的僵尸进程。