前言¶
DeepSeek Harness（DSH）採用「一切皆插件」的架構，智能體在執行任務時若需訪問互聯網或進行復雜頁面交互，通常需要依賴瀏覽器驅動。直接使用瀏覽器驅動往往面臨會話管理混亂、選擇器脆弱以及數據泄露等風險。
dsh-browser 插件旨在爲 DSH 提供一套無頭優先、隔離安全的瀏覽器自動化方案。它不依賴傳統的 CSS 選擇器，而是通過語義化引用來操作頁面，確保 Agent 的操作具有確定性和可追溯性。
這是什麼¶
dsh-browser 是 DeepSeek Harness 的聯網工具插件，由開發者 ZSeven-W 維護。
它的核心價值在於爲智能體提供隔離的 Chromium 會話環境，並封裝了一套語義化的操作接口。插件使用 Playwright Core 1.62.1 作爲底層驅動，通過臨時的用戶數據目錄實現 Agent 間的完全隔離，並提供了有界證據和確定性安全檢查機制。
核心功能¶
該插件提供以下核心能力：
- 無頭優先的瀏覽器自動化：默認以無頭模式運行，不依賴個人瀏覽器配置。
- 隔離的會話環境：每個 Agent 擁有獨立的 Chromium 上下文，互不干擾。
- 語義化引用：操作頁面元素不依賴 CSS 選擇器，而是使用生成的語義引用。
- 作用域觀察：支持對頁面局部或特定子樹進行觀察。
- 有界證據：限制控制台和網絡日誌的輸出範圍，避免敏感信息泄露。
- 確定性安全檢查：在執行動作前進行驗證，防止無效或危險操作。
安裝與啓用¶
確保環境滿足要求：
* Node.js 版本 >= 24.11.0
* pnpm（插件內部使用 pnpm@10.34.5）
通過 npm 安裝插件包：
npm install @zseven-w/dsh-browser
注意：當前版本爲預發佈版本 0.1.0-rc.1，根據 DSH v9 契約，該版本可能存在變更。
典型用法¶
使用該插件的標準流程如下：
- 啓動會話：調用
browser_session_start啓動一個隔離的瀏覽器上下文。 - 觀察頁面：調用
browser_observe獲取頁面的語義化視圖。 - 執行操作：使用
browser_act配合上一步獲取的引用進行點擊、填寫、導航等操作。 - 二次觀察：執行操作後再次調用
browser_observe檢查結果。 - 結束會話：調用
browser_session_stop關閉上下文並刪除臨時數據。
適用場景與注意¶
該插件適用於需要在智能體中集成瀏覽器自動化能力的場景，如網頁測試、數據抓取或表單填寫。
注意事項：
* 插件以 DSH 進程的權限運行，安裝前請檢查源碼與許可證。
* 由於是預發佈版本，API 行爲可能隨 v9 契約更新而變化。
* 使用了 Playwright Core 1.62.1 作爲底層依賴。
結語¶
dsh-browser 爲 DeepSeek Harness 提供了標準化的瀏覽器操作能力，通過隔離會話和語義化引用降低了智能體開發瀏覽任務的複雜度。更多詳情可訪問插件目錄或 GitHub 倉庫。
