前言¶
DeepSeek Harness (DSH) 採用插件化架構。在開發智能體時，若需要直接操作瀏覽器（如登錄、抓取動態內容或執行自動化任務），通常需要配置 Selenium 或 Playwright 等重型驅動。lexmount/dsh-browser 插件通過註冊原生工具，將 Lexmount 的雲瀏覽器能力注入 DSH，讓模型直接調用瀏覽器操作，無需手動管理驅動。
插件簡介¶
這是一個爲 DeepSeek Harness 提供的輕量級 Bundle，負責註冊 31 個原生工具，並在底層調用 Rust 編寫的 browser-cli 可執行文件。該包不包含瀏覽器二進制文件，也不依賴 Lexmount 的 Node.js SDK。
核心功能¶
- 31 個原生工具：覆蓋診斷、認證、會話管理、下載管理、上下文管理。
- 瀏覽器操作：支持打開 URL、等待元素/文本、點擊、填充表單、頁面快照、截圖、導出 PDF。
- 高級能力：支持執行任意 JavaScript 和 Chrome DevTools Protocol (CDP) 命令。
- 自動下載與緩存：首次調用時通過網絡下載匹配當前平臺的
browser-cli，並自動校驗 SHA256 校驗和；後續調用複用緩存，支持離線工作。
安裝與啓用¶
安裝前需確保環境滿足以下要求：
* Node.js >= 22.14.0
* DeepSeek Harness >= 0.1.0-rc.6 且 < 0.2.0
* 全局 pnpm（可通過 corepack 安裝）
在 DSH 的 Web profile 中執行以下命令安裝插件：
npx --yes @deepseek-ai/dsh@0.1.0-rc.6 plugin --profile web add @lexmount/dsh-browser@0.1.1
典型用法¶
插件安裝後，通過以下命令進行初始化和操作：
- 檢查環境：運行
lexmount_doctor查看狀態，首次調用會觸發browser-cli的下載。 - 身份認證：運行
lexmount_auth_login，通過系統瀏覽器完成授權。 - 會話管理：創建臨時 Session 或持久 Context 以複用登錄狀態。
- 頁面操作：使用
lexmount_browser_snapshot導航並檢查頁面結構，隨後使用 typed wait/click/fill 工具執行具體動作。 - 清理：臨時 Session 使用完畢後關閉。
適用場景與注意¶
- 平臺支持：當前支持 Windows x64、macOS Apple Silicon 和 Linux x64。macOS Intel 和 Linux ARM64 不在支持列表中。
- Headless 模式：Headless profile 必須預先完成認證，因爲 PKCE 流程需要交互式瀏覽器。
- 安全性：模型輸入作爲子進程參數數組傳遞（
shell: false），不會拼接 shell 命令，防止注入攻擊。API 密鑰和敏感信息在返回數據中會被自動移除。 - 離線支持：
browser-cli二進制文件下載後存入緩存，後續重啓可複用，無需再次下載。
結語¶
該插件通過標準化的原生工具接口，降低了在 DSH 環境下進行瀏覽器自動化的門檻。開發者可參考 技能目錄 或 GitHub 倉庫 獲取更多細節。
