dsh-browseruse
browser-use 风格的浏览器自动化插件，专为 DeepSeek Harness (DSH) 打造。
通过 playwright-core 驱动一个专用 Google Chrome 实例（独立资料目录、cookie 持久），像真人一样"看页面 → 决策 → 操作"，不影响你日常使用的 Chrome。
A browser-use style automation plugin for DeepSeek Harness. It drives a dedicated Google Chrome instance (independent profile, persistent cookies) through playwright-core, so an agent can browse the web like a human — without touching your everyday Chrome.
✨ 功能 / Features
| 能力 | 说明 |
|---|
| 👀 细粒度工具 | browser_open / browser_snapshot（文本+元素序号+截图）/ browser_click / browser_type / browser_scroll / browser_navigate / browser_tabs / browser_fill_form / browser_download |
| 🧠 自主任务 | browser_task("自然语言目标") —— 插件内部循环"看页面 → 调用当前模型决策 → 操作"，默认上限 30 步，后台运行可用 job_output 跟踪 |
| ⏰ 定时任务 | browser_schedule("目标", "HH:MM" / ISO 时间 / 秒数) —— 到点自动开跑（抢购/抢票场景），本会话内有效 |
| 🛡️ 危险操作确认 | 支付/下单/删除/注销等敏感动作自动识别，动手前弹窗征求用户同意 |
| 🧩 验证码人工接管 | 检测到验证码时暂停并截图询问，用户可在专用 Chrome 窗口亲自处理后继续 |
| 🖼️ 截图回传 | 每步操作截图进入对话（模型支持图片输入时） |
| 🍪 登录态持久 | 独立 profile（默认 $DSH_HOME/.browseruse/chrome-profile），登录一次长期记住，密码不落盘 |
⚠️ 安装前须知 / Before You Install
来自社区用户的提醒（请谨慎安装）：安装前先给 DSH 环境做好保护——备份 ~/.dsh 和 DSH 部署目录，再检查 harness 内嵌的 Node.js 版本。曾有用户踩坑：运行时版本冲突——插件只能跑在 harness 内嵌的 Node 上（自己改不了），内嵌 Node 版本又难以单独升级，两头都堵死；结果一调用浏览器工具就返回空结果，接着整个会话崩溃，排查无果最后只能重装 harness。该反馈来自约十天前（2026-08-08 前后），当前版本是否仍有此问题尚无定论，总之小心为上。
Community warning — install with care. Back up your DSH environment (~/.dsh and the deployment directory) and check the harness's embedded Node.js version before installing. A user hit a runtime version conflict: the plugin can only run on the harness's embedded Node (no way to switch it), while that embedded Node itself is hard to upgrade — both ends stuck. Every browser tool call then returned empty results and the whole session crashed; after hours of debugging they had to reinstall the harness. Reported ~10 days ago (early Aug 2026); whether current versions are still affected is unconfirmed — be careful.
- Node 版本要求：本插件与 playwright-core 均要求 Node ≥ 20。插件运行在 harness 内嵌的 Node 上，请在安装前用
node --version（或看 DSH 安装路径，形如 ~/.local/share/node-v24.19.0/）确认版本；内嵌 Node < 20 时请先升级 DSH，不要强行安装。
- 验证状态：本插件在 DSH 0.1.0-rc.6 + 内嵌 Node v24.19.0 下开发并实测通过（13 个工具挂载与调用正常）。
- 出问题时的速查：工具调用返回空 → 会话崩溃，先怀疑运行时版本冲突：核对 Node 版本、用安装前的备份回滚，比现场硬修更快。
📦 安装 / Install
需要本机装有 Google Chrome（插件通过 CDP 连接已安装的 Chrome，无需下载浏览器二进制）。
方式一：作为 profile bundle（推荐）
# 从 GitHub 安装
dsh plugin --profile web add github:yzd6552/dsh-browseruse
# 或从 npm 安装
dsh plugin --profile web add dsh-browseruse
安装后 browser_* 工具对该 profile 的所有会话可见。重启 dsh web 后生效。
方式二：作为 agent 预设插件行
mkdir -p ~/.dsh/.agent-presets/<你的预设>/plugins/browseruse
cd ~/.dsh/.agent-presets/<你的预设>/plugins/browseruse
npm init -y && npm install dsh-browseruse
在预设的 agent.cordis.yml 中追加：
- id: tool-browseruse
name: ./plugins/browseruse/node_modules/dsh-browseruse/index.js
🚀 使用 / Usage
1. browser_open "https://www.baidu.com" # 打开页面（自动弹出专用 Chrome 窗口）
2. browser_snapshot # 读取页面文本 + 元素序号 + 截图
3. browser_type {"text": "苹果发布会"} # 输入搜索词
4. browser_task "搜索苹果发布会并总结前三条结果" # 或一句话全自动
5. browser_schedule {"goal": "抢购...", "at": "20:00:00"} # 定时开跑
首次调用任意 browser 工具会自动启动专用 Chrome（可见窗口）；你在窗口里登录一次，之后 cookie 一直记住。
🔧 工具清单 / Tools
| 工具 | 作用 |
|---|
browser_open | 打开网址（自动启动浏览器，可新标签） |
browser_snapshot | 页面快照：URL、标题、文本、可交互元素序号、截图 |
browser_click | 按序号或文字点击（敏感元素先确认） |
browser_type | 输入文字（支持回车提交） |
browser_scroll | 滚动页面 |
browser_navigate | 后退 / 前进 / 刷新 |
browser_tabs | 标签页列表 / 切换 / 关闭 / 新建 |
browser_fill_form | 按字段批量填表（可选提交，敏感提交先确认） |
browser_download | 触发并保存下载到 ~/Downloads |
browser_task | 自主任务（后台运行，job_output 跟踪） |
browser_schedule | 定时任务（本会话内有效） |
browser_status | 运行状态、标签页、配置目录、待执行排程 |
browser_close | 关闭专用 Chrome（登录态保留） |
⚙️ 默认路径 / Defaults
| 项 | 路径 |
|---|
| Chrome 资料目录（登录态） | $DSH_HOME/.browseruse/chrome-profile（无 DSH_HOME 时为 ~/.dsh/...） |
| 下载目录 | ~/Downloads |
⚠️ 说明 / Notes
- 插件运行在 DSH 主进程，只消费宿主服务（
tools/llm/userQuestions/attachments/jobs），不发布服务。
- 定时任务在会话内有效；DSH 重启后需重新排程。
- 危险操作确认与验证码暂停依赖会话的
ask_user_question 通道；子代理上下文中无法询问时会采取保守策略（阻止危险操作）。
- 纯 JavaScript 实现，无构建步骤；需要 Node >= 20、本机已装 Google Chrome。
👥 贡献者 / Contributors
- DeepSeek Harness Agent（deepseek-v4-pro） — 架构设计、全部代码实现与验证
本插件由 DeepSeek Harness 上的 AI 代理开发完成。
📄 License
MIT
