浏览器桥接 liyongzheng666/dsh-browser-bridge

dsh-browser-bridge

DeepSeek Harness（DSH）浏览器桥接插件：让 DSH 智能体通过本地 WebSocket 读取和控制真实浏览器。

+--------------------------+ WebSocket +--------------------------+
| DeepSeek Harness (dsh) | ws://127.0.0.1:3080/ | Firefox / Chrome / Edge |
| browser_* 工具 | bridge | DSH Browser Bridge |
+--------------------------+ <---------------------> +--------------------------+

功能

服务端提供 13 个模型端工具：

- browser_status
- browser_list_tabs
- browser_activate_tab
- browser_navigate
- browser_snapshot
- browser_read_page
- browser_click
- browser_type
- browser_press
- browser_scroll
- browser_wait
- browser_screenshot
- browser_eval

浏览器扩展负责执行这些命令：标签页管理、DOM 操作、键盘输入、滚动、等待、截图、页面 JS 求值。

本仓库同时提供：

- lib/：DSH 服务端插件（npm 包）
- extension/：Firefox WebExtension 源码（Manifest V2）
- cordis.patch.yml：DSH 插件安装补丁
- package.json：带 dsh.bundle 声明的 npm 包

npm 安装

dsh plugin --profile web add dsh-browser-bridge

或手动注册到 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: browser-bridge
name: 'dsh-browser-bridge'

浏览器扩展安装

Firefox

1. 打开 about:debugging#/runtime/this-firefox
2. 「临时加载附加组件...」选择 extension/manifest.json

Chrome / Edge（原 Chromium MV3 变体）

可使用原仓库对应的 Chromium 扩展，或参照 extension/ 适配。

默认配置

| 配置 | 默认值 | 说明 |
| path | /bridge | WebSocket 路径 |
| commandTimeoutMs | 60000 | 命令超时 |
| screenshotDir | ~/.dsh/browser-bridge | 截图保存目录 |
| maxMessageBytes | 8 MiB | WebSocket 最大消息 |

快速开始

1. 安装服务端插件：
dsh plugin --profile web add dsh-browser-bridge

2. 加载 Firefox 扩展：
- 打开 about:debugging#/runtime/this-firefox
- 「临时加载附加组件...」选择 extension/manifest.json
3. 在 DSH 对话中调用： browser_status

4. 应看到： Browser bridge: connected

插件市场

- npm 包：dsh-browser-bridge
- DSH 插件市场收录：通过 awesome-dsh-plugin 提交。
- Firefox 扩展：可上传 Mozilla AMO 发布，或临时加载本仓库 extension/。

安全说明

- 桥接默认只绑定 127.0.0.1，无鉴权，只建议本机使用。
- browser_eval 可执行页面 JS，功能强大，请仅授权可信智能体。
- 扩展需要 <all_urls> 权限以读取标签页和操作任意网页。

License

MIT