前言¶

智能體開發中，要操作用戶真實 Chrome 實例，通常需要額外編寫後臺服務或使用第三方方案，流程複雜且安全邊界難以把控。DSH 的理念是「一切皆插件」，插件通過擴展能力來補齊能力缺口。下面介紹一個能直接控制用戶真實 Chrome 的 DSH 插件：dsh-chrome-bridge。

插件定位¶

這是 DeepSeek Harness 的一個客戶端插件，由維護者 Dax233 提供。它以 MV3 擴展形式存在，通過 Chrome 的 chrome.debugger API 與 Host 側的 chrome 工具配合，實現對用戶真實 Chrome 的控制。插件支持後臺標籤、DSH Agent 標籤組、UIA 引用、動作回執、console/network 日誌、iframe 觀測與 frame 內點擊等能力。

核心能力¶

Host 側工具與 WebSocket 服務¶

插件在 Host 側註冊了一個 chrome 工具，並啓動一個迴環 WebSocket 服務（默認監聽 127.0.0.1:47835）。該服務負責與擴展通信，提供鑑權（hello 幀鑑權、Host/Origin 校驗）與安全邊界。Host 工具提供一系列方法來驅動 Chrome：

• status：獲取狀態
• tabs：獲取/管理標籤
• newTab：新建標籤，自動加入 DSH Agent 標籤組
• closeTab：關閉標籤
• attach：附加到指定標籤（顯式 opt-in，用戶拖出標籤組即撤銷）
• detach：從調試會話中分離標籤
• navigate：導航到指定 URL
• snapshot：獲取頁面快照，使用 Host 側 n<backendNodeId> 引用
• click、type、key：對頁面元素進行點擊、輸入和按鍵操作
• scroll：滾動頁面
• screenshot：截圖
• logs：獲取 console/network 日誌，支持 filter / clear
• upload：通過 DOM.setFileInputFiles 實現文件上傳
• evaluate：在頁面上下文中執行 JavaScript
• wait：等待頁面元素或條件滿足（支持 selector / text / ms）

擴展側實現¶

擴展側使用 MV3 架構，通過 chrome.debugger 與 Host 通信，實現標籤組控制、日誌收集與 iframe 觀測。iframe 內容會被標記爲 (iframe)，點擊操作在 frame 隔離世界中按可訪問名執行 .click()。

安全與權限¶

• 只有 DSH Agent 標籤組內的 tab 會被驅動；拖出標籤組即撤銷控制權。
• WebSocket 服務僅監聽 127.0.0.1，避免跨機暴露。
• hello 幀攜帶 token 鑑權，Host/Origin 校驗。
• 默認 token 僅用於本機配對，可在擴展選項或環境變量中覆蓋。

安裝與啓用¶

在 Host 側執行以下命令添加插件：

dsh plugin --profile desktop add github:Dax233/dsh-chrome-bridge

然後在 Chrome 中：

1. 打開 chrome://extensions
2. 開啓「開發者模式」
3. 選擇「加載已解壓的擴展程序」
4. 指向本倉庫的 extensions/chrome-extension 目錄
5. 打開擴展選項頁，確認端口與 token（默認端口 47835，默認 token dsh-chrome-bridge-local）

Release / 下載安裝¶

GitHub Releases（由 .github/workflows/release.yml 在推送 v* tag 或手動 dispatch 時生成）提供兩種安裝方式：

• dsh-chrome-bridge-v<version>.zip：解壓後按上述步驟加載已解壓擴展程序。
• dsh-chrome-bridge-v<version>.crx：自簽名包，適用於企業策略或 Chromium 開發版；Chrome 穩定版通常會拒絕拖入安裝。

擴展 ID 默認隨構建簽名 key 變化。若需要穩定 ID（例如企業策略分發），可在倉庫 Secrets 中設置 CRX_PRIVATE_KEY 爲簽名私鑰 PEM，workflow 會優先使用。私鑰不要提交到倉庫。

開發¶

本地測試：

npm test

適用場景與注意¶

適合需要直接控制用戶真實 Chrome 實例的開發者與智能體系統。插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證。建議僅在受控環境或明確授權的場景中使用。

小結¶

dsh-chrome-bridge 將 Chrome 瀏覽器控制能力以插件形式集成到 DSH 中，提供了從標籤管理、頁面操作到日誌觀測的一整套能力。如果你需要在智能體或自動化流程中直接操作真實 Chrome，這個插件可以作爲一條可行的路徑。

• 插件目錄頁：https://www.skillhub.cn/plugins/Dax233/dsh-chrome-bridge
• GitHub 倉庫：https://github.com/Dax233/dsh-chrome-bridge