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`），登录一次长期记住，密码不落盘

📦 安装 / 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](./LICENSE)

Source facts

Install

Check the source files