前言¶
DeepSeek Harness (DSH) 是一個插件化的智能體開發環境。在構建需要瀏覽網頁的智能體時，處理登錄態、會話持久化以及人工介入控制是常見痛點。DeepSeek Harness Browser Use 插件提供了持久化的 Playwright 瀏覽器工具和一個交互式面板，幫助開發者或智能體在 DSH 環境中穩定地操作瀏覽器。
插件定位¶
該插件由 syncended 維護，基於 Playwright。它爲 DeepSeek Harness 提供持久化瀏覽器配置、跨標籤頁登錄狀態共享、穩定的頁面快照引用以及實時可視化的瀏覽器面板。
核心功能¶
- 持久化與狀態共享：保持一個 Chromium 配置文件，在多輪對話中共享登錄狀態。
- 交互式面板：提供實時瀏覽器視圖，支持被動監控和手動接管。
- 穩定快照引用：通過
browser_snapshot獲取頁面元素引用，後續通過browser_click或browser_type操作。 - 代理工具集：提供
browser_status、browser_tabs、browser_navigate、browser_snapshot、browser_click、browser_type、browser_press、browser_scroll、browser_screenshot等工具。
安裝與啓用¶
該插件依賴 DeepSeek Harness 0.1.6-alpha.2、Node.js 22 或更新版本以及 pnpm。宿主機必須已安裝 Chromium 或 Chrome 可執行文件。
dsh plugin --profile web add @syncended/dsh-browser-use@0.1.6-alpha.1
典型用法¶
- 打開或創建 DSH 會話，進入對話詳情側邊欄，打開 Browser 標籤頁。
- 保持面板打開，可以被動觀察智能體的瀏覽過程。
- 需要手動操作時，在面板底部選擇 Take control，輸入 URL 或與頁面交互，完成後選擇 Return control to agent。
- 讓智能體執行操作時，通過
browser_snapshot獲取當前頁面的交互元素引用，隨後使用browser_click或browser_type進行操作。注意快照引用是一次性的，操作後需重新獲取。
配置項¶
插件通過 cordis.patch.yml 注入默認配置。可覆蓋 profile（持久化配置名稱）、headless（是否無頭模式）、executablePath（瀏覽器路徑）、viewportWidth/Height、screenshotQuality（截圖質量）、operationTimeoutMs（超時時間）、humanLeaseTtlMs（手動接管租約時長）等。
適用場景與注意¶
- 環境依賴：必須在宿主機安裝 Chromium 或 Chrome 可執行文件，且模型需支持圖片輸入以使用截圖功能。
- 安全注意：瀏覽器配置文件包含憑證，請保護 DSH 的家目錄；遠程 Web 控制遵循
trustedHosts策略；請保持 Chromium 沙箱開啓；敏感操作（密碼、支付、驗證碼）需人工介入，插件不自動填充。 - 快照機制：
browser_snapshot返回的引用是單次有效的，任何頁面變動後必須重新調用快照。 - 反爬限制：插件不提供反反爬蟲機制。
結語¶
該插件通過提供穩定的瀏覽器操作接口和可視化的交互面板，降低了智能體在 DSH 環境中進行 Web 任務開發的門檻。更多細節與源碼請訪問 GitHub 倉庫。
