前言¶
DeepSeek Harness (DSH) 採用插件化架構，通過擴展點增強功能。對於需要真實瀏覽器環境、動態內容渲染或複雜交互的任務，dsh-browser-use 提供了直接的解決方案。它通過啓動本機 Chrome 或 Chromium，利用 Chrome DevTools Protocol (CDP) 和 DOM 工具，爲 Agent 提供瀏覽器操作能力，從而替代靜態抓取或搜索方案。
它是什麼¶
dsh-browser-use 是一個爲 DeepSeek Harness 提供原生瀏覽器 Agent 工具的插件。該插件由 dengpeihua 維護，採用 MIT 許可證。它作爲 DSH 的 Web profile 插件獨立安裝，不依賴 DSH 源碼的修改。
核心功能¶
該插件提供以下能力：
- 原生 Chromium：使用本機 Chrome/Chromium，而非 HTTP 抓取器。
- 增量 DOM：優先返回 DOM 差異（
+|/-|），減少重複上下文。 - 會話隔離：每個 DSH Agent 獨立擁有瀏覽器進程、標籤頁、CDP 會話和 DOM 緩存。
- 多標籤頁與滾動探索：支持創建、切換、關閉標籤頁，以及按屏或按頁面位置探索。
- DSH 原生生命週期：使用 Cordis、
defineTool、approval 和 attachment 服務。 - 顯式瀏覽器路由：明確區分瀏覽器操作與搜索/抓取。
- 安全默認值：Chromium sandbox 默認開啓；改變頁面狀態的操作默認需要批准。
- 有界輸出：限制腳本結果大小，只返回預覽，完整結果寫入目錄。
- 同輪文本留存：在改變頁面前提醒 Agent 記錄重要答案。
- 按需回讀歸檔：頁面觀察自動歸檔，按需調用
browser_recall。 - 操作後置條件：點擊和輸入可檢查文本或 URL。
- 精確檢查點恢復：支持恢復表單值、展開狀態、滾動位置等。
- 結構化與跨域診斷：支持 JSON-LD、重複列表和有界結果。
安裝與啓用¶
環境要求¶
- Node.js
>=22.19 - Chrome 或 Chromium
pnpm（DSH 插件安裝命令依賴）
安裝步驟¶
在 DSH 的 web profile 中添加該插件：
npx @deepseek-ai/dsh@0.1.2-alpha.2 plugin --profile web add dsh-browser-plugin
典型用法¶
安裝後，Agent 可通過自然語言描述任務。典型場景包括：
- 信息提取：打開網頁並提取排名數據（例如 Hugging Face 模型）。
- 表單填寫：打開聯繫表單並填寫指定字段，檢查校驗規則。
- 多步調研：調查論文的代碼倉庫、依賴、維護狀態及復現問題。
適用場景與注意¶
- 本地構建：該插件目前未發佈到 npm，通常需要本地構建和安裝。
- 版本依賴：根據示例，需要 DeepSeek Harness 版本
0.1.2-alpha.2。 - 安全機制：默認啓用沙箱；涉及頁面狀態修改的操作需要 DSH approval。
- 兼容性：與 DSH 其他版本的兼容性未明確確認。
總結¶
dsh-browser-use 將真實瀏覽器的控制能力引入 DeepSeek Harness，通過會話隔離、增量 DOM 和精確檢查點恢復，爲 Agent 提供了可靠的多步驟 Web 任務執行能力。
