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 指令明確管理生命週期，以防止產生無效的殭屍進程。