fatmind/dsh-plugin-browser-use

dsh-plugin-browser-use

🌐 English | 中文版

dsh (DeepSeek Harness) 的浏览器自动化插件：把 webclaw3 注册为 dsh 原生工具（wc3_），驱动你自己已登录的 Chrome 干活——跳过重复登录、授权弹窗，也不容易触发反爬。

- 抓取与导出——搜索结果、表格、下载内容
- 登录墙页面照样抓——小红书、公众号、微博、淘宝、各类后台……
- 页面交互——点按钮、填表单、发内容
- 直达 SPA 数据层——React fiber / Vue data / __NEXT_DATA__

工作原理

dsh（web profile）
└─ 本插件：wc3_ 工具 + 浏览哲学系统提示词（按需自动启动 relay）
└─ webclaw3 引擎（仓库内 webclaw3/，上游 fatmind/webclaw3）
└─ relay（HTTP 127.0.0.1:3459 ↔ WebSocket）
└─ wc3-chrome 扩展 ──> 你已登录的 Chrome

插件是纯适配层：把 relay 的 HTTP API 翻译成 dsh 工具，把 webclaw3 的浏览哲学（SKILL.md）浓缩成系统提示词。引擎与说明书只在上游维护一份，scripts/sync-webclaw3.sh 同步进来。

注意：dsh 环境下不需要（也不要）再把 webclaw3 安装为 skill——插件已完整接管引擎加载与使用指引，双装会出现两份指引、一个 relay 的混乱。

安装

前置：dsh、Node >= 22、pnpm、Chrome。

curl -fsSL https://raw.githubusercontent.com/fatmind/dsh-plugin-browser-use/main/scripts/install.sh | bash

或本地 checkout：

git clone https://github.com/fatmind/dsh-plugin-browser-use
cd dsh-plugin-browser-use && ./scripts/install.sh

安装脚本会：装依赖 → 注册到 web profile（link:）→ 下载并解压 wc3-chrome 扩展。之后：

1. Chrome 打开 chrome://extensions，右上角开启「开发者模式」，「加载已解压的扩展程序」选择脚本提示的扩展文件夹；
2. 重启 dsh（profile 只在启动时加载）；
3. 对 dsh 说一句「检查浏览器环境」——模型会调 wc3_doctor 完成自检并告诉你缺什么。

重复运行安装脚本即为更新。

工具一览

| 工具 | relay op | 说明 |
|---|---|---|
| wc3_doctor | - | 通道自检（Node/引擎/relay/扩展），relay 未跑时自动拉起 |
| wc3_tabs | tab.list | 列出标签页，拿 tabId；[当前]=Chrome 前台页，[默认]=wc3 最近激活页 |
| wc3_tab_open | tab.create | 新 tab 打开 URL（后台打开，不抢焦点）；新开的页自动成为默认目标 |
| wc3_tab_close | tab.close | 关闭自己开的 tab；关掉默认页时默认目标自动清空 |
| wc3_tab_activate | tab.list + 本地状态 | 把指定 tab 设为默认操作目标（解决「当前页漂移」） |
| wc3_snapshot | page.ariaTree | Aria 树快照，[ref_N] 编号用于交互定位 |
| wc3_get_text | page.getText | 整页纯文本，陌生页面侦察 |
| wc3_eval | page.eval | 页面内执行任意 JS，结构化数据提取首选 |
| wc3_click / wc3_fill / wc3_scroll_to | page.click / page.fillForm / page.scrollTo | 按 ref_N 交互（React/Vue 安全） |
| wc3_search | page.search | 按关键词找页面元素 |
| wc3_wait_for | page.waitForElement | 等待元素出现 |

页面类工具（snapshot/get_text/eval/click/fill/scroll_to/search/wait_for）的 tabId 可省略：缺省自动作用于 wc3 最近激活的标签页（新开的页、最近显式用过的页、或当前激活页，wc3_tabs 里标 [默认]）。wc3_tab_close 的 tabId 为必填（防误关）。扩展偶发断连时工具会自动等待重连（默认约 10 秒内自愈）再报错。

工具结果均为文本（含必要的用户指引）；每个结果默认上限 50000 字符，超长自动截断。

配置

安装后可按需编辑 packages/browser-use/cordis.patch.yml：

| 字段 | 默认 | 说明 |
|---|---|---|
| relayHost / relayPort | 127.0.0.1 / 3459 | relay 地址 |
| toolTimeoutMs | 60000 | 单次工具调用超时（ms） |
| maxResultChars | 50000 | 单个结果字符上限 |
| autoStartRelay | true | relay 未运行时自动 webclaw3.mjs start |
| engineDir | ""（自动定位） | 引擎目录；也可用环境变量 DSH_WC3_ENGINE_DIR |

License

MIT