前言¶
在 DeepSeek Harness (DSH) 的生態中，Agent 要處理複雜的網頁交互（如登錄態保持、驗證碼、動態渲染），僅靠命令行工具往往力不從心。通用瀏覽器是爲人類設計的，Agent 難以精確控制。dsh-browser-cdp（原名 dsh-ego-browser）通過 Chrome DevTools Protocol (CDP) 接入真實 Chrome，爲 Agent 提供了 38 個結構化工具，並配以實時觀察窗，解決了 Agent 在瀏覽器中“看不見、插不上手”的問題。
核心能力¶
本插件提供以下核心功能：
- 38 個結構化工具：以
bcdp_*命名的一組工具，覆蓋頁面操作、截圖、下載等具體行爲，職責單一，確定性高。 - 實時觀察窗：通過 SSE 實時視頻流回傳頁面畫面，支持鼠標在觀察窗中直接操作真實瀏覽器、下載捕獲。若安裝了
dsh-better-sidebar，觀察窗會以側邊欄 Tab 形式展示。 - 登錄態導入：支持將 Chrome/Edge/Brave 的登錄 Cookie 按域名複製進 Agent 瀏覽器，兼容 Chrome 127+ 的 App-Bound Encryption。
- Self-observation：Agent 操作 DSH 自身界面（如管理會話）時，同樣通過觀察窗可見，開發者可隨時接手。
- 平臺自適應：支持 Linux、macOS、Windows 自動探測，內置
--no-sandboxwrapper，適配 root/Docker/無顯示器環境。 - 運維型工具：提供
bcdp_doctor（環境體檢）、bcdp_captcha（人機驗證探測）、bcdp_http（瀏覽器上下文請求）等輔助工具。
安裝與前置要求¶
在使用前，請確保環境滿足以下要求：
- Node.js：版本 >= 22
- DSH：版本 >= 0.2.0-rc.1
- 可選依賴：
dsh-better-sidebar>= 0.12.2（用於側邊欄支持）
安裝插件：
dsh plugin --profile web add github:drscrewdriver/dsh-browser-cdp
插件包內置了預構建的運行時，無需額外的構建腳本。
典型用法¶
該插件適用於以下場景：
- 文獻與數據抓取：讓 Agent 登錄知網或谷歌學術，通過翻頁收集數據，開發者可實時觀察抓取進度。
- 表單與登錄：Agent 填表過程中遇到驗證碼，開發者可在觀察窗中手動接管並完成驗證，隨後交還給 Agent。
- QA/冒煙測試：模擬用戶操作產品，觀察窗充當錄屏與交互終端。
- Self-observation：觀察 Agent 如何操作 DSH 的界面本身，便於調試交互邏輯。
注意事項¶
- Headless 模式：即使不啓動觀察窗，Headless 會話下的
bcdp_*工具依然可用，只是無法看到畫面。 - 兼容性：Cookie 導入功能兼容 Chrome 127+ 的 App-Bound Encryption，無需離線解密。
- 權限：插件以當前 DSH 進程權限運行，安裝前建議檢查源碼與許可證。
總結¶
dsh-browser-cdp 將一個“黑盒”的瀏覽器變成了“白盒”的觀察與控制終端，讓 Agent 在瀏覽器中的操作全程可見、可控。對於需要處理複雜網頁交互的開發者而言，它提供了必要的抓手。
