前言¶
在構建需要瀏覽器操作的工作流時，通常需要啓動無頭瀏覽器或配置遠程調試端口。這往往意味着要重新登錄、丟失已安裝的擴展，或者反覆彈出“允許遠程調試”的確認框。BrowserRig 提供了一個本地驅動方案，它不依賴無頭瀏覽器，而是通過 Chrome 擴展與你的現有已登錄 Chromium 瀏覽器建立連接。
這是什麼¶
BrowserRig 是一個開源的本地瀏覽器驅動插件，由 Castor6 維護。它允許智能體（Agent）複用你現有的 Chrome 窗口、Cookies、登錄會話和擴展，而無需瀏覽器範圍的遠程調試批准。它是一個獨立的開源產品，不包含 LLM，也不負責規劃決策，僅作爲代碼層面的執行層。
核心功能¶
- 複用現有會話：複用 Chrome 窗口、Cookies、會話和擴展。
- 無阻塞連接：通過本地中繼和擴展連接已登錄的 Chrome，不觸發瀏覽器範圍的遠程調試確認。
- 會話接管：
session adopt --active命令可在一次操作中查找、附加並接管活動標籤頁。 - 後臺工作：
execute命令在同一個瀏覽器配置文件中創建後臺標籤頁，保持前臺工作流不被打斷。 - 技能優先驅動：提供 CLI 和 Skill-first 的驅動模式，適配 DeepSeek Harness 等運行時。
安裝與啓用¶
將插件添加到 DeepSeek Harness 的指定 Profile 中。
dsh plugin --profile web add browserrig
執行安裝後，查看生成的配置以確認插件加載成功：
dsh --profile web --dump-config
典型用法¶
安裝完成後，通過 CLI 執行 Playwright 腳本。以下命令會導航到示例頁面並返回標題與 URL：
browserrig execute 'await page.goto("https://example.com"); return { title: await page.title(), url: page.url() }'
檢查插件連接狀態和健康檢查：
browserrig status
browserrig doctor
適用場景與注意¶
- 適用場景：需要保留登錄狀態、使用瀏覽器擴展或需要高頻切換瀏覽器窗口的開發與測試工作流。
- 前置要求：需要安裝 Node.js 22.22.0 或更新版本。
- 權限說明：插件以當前 DSH 進程的權限運行。Chrome 可能會在標籤頁附加時顯示標準非阻塞調試信息欄，這是正常現象。
- 核心差異：BrowserRig 不連接 Chrome 的瀏覽器範圍遠程調試端點，而是通過擴展 API 傳輸 CDP 命令。它不包含 LLM 或做出規劃決策，僅負責執行代碼。
結尾¶
BrowserRig 解決了智能體開發中複用真實瀏覽器環境的痛點。通過 session adopt --active 和後臺標籤頁機制，它保持了工作流的連貫性。更多細節可參考項目源碼。
