Chrome 浏览器桥 alenjdl/dsh-chrome-operation

dsh-chrome-operation

一个 DSH 插件，把本地 Chrome 浏览器变成一组 DSH 工具。它和 chrome operation（chrome-operation）MV3 Chrome 扩展配合使用：扩展在浏览器内运行一个 WebSocket 桥接服务，DSH 插件通过 loopback 拨号连接该桥，并把浏览器操作暴露为 DSH 工具，从而让 DSH 智能体可以驱动一个真实的本地 Chrome 浏览器。

工作原理

1. chrome-operation 扩展（MV3）运行一个后台 service worker，监听 ws://127.0.0.1:18765/ext/bridge（带 15 秒 keep-alive ping，避免 Chrome service worker 空闲后断开连接）。
2. dsh-chrome-operation DSH 插件启动后连接该 WS 桥，并注册 browser_ 工具。
3. 当 DSH 调用某个 browser_ 工具时，请求经桥转发，由扩展在真实的 Chrome 标签页中执行操作。

安装

1. 加载 Chrome 扩展

1. 打开 chrome://extensions。
2. 开启 开发者模式（右上角）。
3. 点击 加载已解压的扩展，选择 chrome-operation 扩展目录。
4. 扩展会把 token 写入 chrome.storage.local.token（由扩展 / issue-token 开发脚本管理）。

2. 安装 DSH 插件

插件以 npm 包 dsh-chrome-operation 形式分发。

dsh plugin add dsh-chrome-operation

3. 重启 DSH

插件在 profile 重启时激活。重启 DSH 桌面端，然后确认连接（插件会记录 bridge ready / extension connected）。

暴露的工具

browser_snapshot、browser_get_text、browser_navigate、browser_open_tab、browser_list_tabs、browser_close_tab、browser_click、browser_type、browser_press、browser_scroll、browser_wait、browser_back、browser_forward、browser_reload。

配置

- 桥接服务只监听 loopback（127.0.0.1）——仅限本地使用。
- 扩展从 chrome.storage.local 读取 token。
- 默认 WS pingIntervalMs 为 15000（可通过桥接配置端点 /ext/bridge-config 修改）。Chrome 的 service worker 约 30 秒空闲会挂起，15 秒 ping 可让其保持活跃。

备注

- 需要 Chrome（扩展为 MV3，使用 service worker）。
- 在复杂页面 browser_snapshot 可能返回空；读取内容时建议优先使用 browser_get_text + 导航。
- 若 DSH 对 dshWorkshop 字段报错，删除该顶层键即可——插件仍通过 cordis.patch.yml 加载。

许可证

MIT