dsh-browseruse

August 30, 2026 · View on GitHub

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