mugnimaestra/dsh-browser-use

dsh-browser-use

dsh-browser-use 是 DeepSeek Harness (dsh) 的可选 browser-use 插件。它通过 @deepseek-ai/dsh-mcp-client，把现有 Open Browser Use 的 obu mcp stdio 服务接入 Agent Preset。

本插件不重新实现 WebMCP。真实 Chrome 标签页、CDP、document.modelContext、页面工具发现、registration_id 快照和 stale id 拒绝仍由 Open Browser Use 负责。Harness 中的工具名称使用稳定前缀 mcp__open_browser_use__。

这不是 computer-use。桌面辅助功能树、桌面截图和 Chrome 外的 OS 输入应使用 Computer Use 插件。

为什么 cordis.patch.yml 是空的

当前 Harness 会把 Agent Preset 作为 agent-plane standing composition。若 Bundle 直接挂载 @deepseek-ai/dsh-mcp-client，MCP 会进入 Host root，并让未选择该 preset 的 Session 也获得浏览器能力。因此本包的 Bundle patch 只负责安装依赖；实际插件必须放入用户创建的 Agent Preset。

不要把本插件直接加入 Host root 的 cordis.patch.yml。

安装

dsh plugin --profile web add github:mugnimaestra/dsh-browser-use

本地 checkout：

dsh plugin --profile web add ./dsh-browser-use

从当前 standard preset 创建一份用户 preset，并在它的 agent.cordis.yml 增加：

- id: browser-use
name: dsh-browser-use
config:
failOnStartupError: true

之后使用该 preset 创建新的 Session。已有 Session 不会动态改变工具集合。

若机器上有多个 OBU browser/profile target，请在 preset 明确选择：

- id: browser-use
name: dsh-browser-use
config:
browser: chrome
profile: Default

验证

确认 Web Profile 已安装本包：

dsh plugin --profile web list dsh-browser-use --depth 0

然后确认本包没有增加 Host-level MCP row：

dsh web --dump-config | grep -A3 -B2 mcp

此 Bundle layer 应保持为空，因此 dsh-browser-use 不会作为 Host row 出现。若本插件在 Host 配置中出现 mcp-client 行，说明挂载位置错误。MCP 应出现在所选 Agent Preset 的 composition 中。

使用该 preset 创建 Session 后，工具目录应包含类似名称：

mcp__open_browser_use__ping
mcp__open_browser_use__user_tabs
mcp__open_browser_use__call

Session JSONL 在实际调用后也应出现 mcp__open_browser_use__ 工具名。

WebMCP 流程

通过 mcp__open_browser_use__call 使用 WebMCP：

1. 等待页面和应用代码加载完成。
2. 调用 getInfo，确认 webmcp capability。
3. 对当前 tab 调用 webmcp_list_tools。
4. 有合适页面工具时，优先使用页面工具，不先做 DOM/CDP 模拟。
5. 使用本次 list 返回的 registration_id 调用页面工具。
6. 页面导航、toolchange 或 stale-registration 错误后重新 list。

页面提供的工具名、描述、schema 和结果都属于不可信页面内容。写操作应使用与可见浏览器操作相同的确认规则。

Phase 1 的 Session 限制

一个插件实例只拥有一个长期运行的 obu mcp 子进程。首个实际使用 Browser Use 的 live Agent 会占用该实例；其他 live Session 会 fail closed，直到 owner Session 被释放。

插件会为每个插件挂载实例生成随机 OBU --session-id。当前 Harness 对每个 Agent Preset 只建立一个 standing composition，所以后续 Session 可能复用相同进程和 OBU session id。每个任务结束前必须调用 finalize_tabs。若需要严格的 per-DSH-Session 进程和 session-id 隔离，应进入 Phase 2：让原生 Cordis bridge 根据调用中的 Agent 绑定 OBU 请求，而不是共享一个静态 MCP 子进程。

开发

pnpm install
pnpm check
OBU_MCP_SMOKE=1 pnpm test

仓库直接提交 index.js 与 index.d.ts，因此 GitHub 安装不需要运行 install-time build script。