yzd6552-commits/dsh-browseruse

dsh-browseruse

browser-use 风格的浏览器自动化插件，专为 DeepSeek Harness (DSH) 打造。

通过 playwright-core 驱动一个专用 Google Chrome 实例（独立资料目录、cookie 持久），像真人一样“看页面 → 决策 → 操作”，不影响你日常使用的 Chrome。

一个面向 DeepSeek Harness 的 browser-use 风格自动化插件。它通过 playwright-core 驱动一个专用 Google Chrome 实例（独立资料目录、cookie 持久），让 agent 能像真人一样浏览网页——而不触碰你日常使用的 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 前后），当前版本是否仍有此问题尚无定论，总之小心为上。

社区警告——安装需谨慎。 安装前请备份你的 DSH 环境（~/.dsh 和部署目录），并检查 harness 内嵌的 Node.js 版本。有用户遇到了运行时版本冲突：插件只能跑在 harness 内嵌的 Node 上（无法切换），而该内嵌 Node 本身又难以升级——两头都堵死。之后每次浏览器工具调用都返回空结果，整个会话崩溃；排查数小时后只能重装 harness。反馈时间约为 10 天前（2026 年 8 月初）；当前版本是否仍受影响尚未确认——请务必小心。

- Node 版本要求：本插件与 playwright-core 均要求 Node ≥ 20。插件运行在 harness 内嵌的 Node 上，请在安装前用 node --version（或看 DSH 安装路径，形如 ~/.local/share/node-v24.19.0/）确认版本；内嵌 Node /plugins/browseruse
cd ~/.dsh/.agent-presets//plugins/browseruse
npm init -y && npm install dsh-browseruse

在预设的 agent.cordis.yml 中追加：
yaml
- 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