前言¶
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 任务执行能力。
