Skip to content

Releases: caob23/dsh-browser-control

v1.0.4

Choose a tag to compare

@caob23 caob23 released this 23 Aug 12:20

DSH Browser Control v1.0.4

Chrome 浏览器扩展 + DeepSeek Harness 插件,让 AI Agent 像人一样操控你的真实浏览器。

本版本起采用 AGPL-3.0 许可证。

附件

文件 用途
DSH-Browser-Control-1.0.4.zip Chrome 扩展(解压后加载)
dsh-browser-control-plugin-v1.0.4.zip dsh 插件(离线兜底用,在线装不需要)

一、安装 Chrome 扩展(30 秒)

  1. 下载 zip,解压到固定文件夹
  2. Chrome 打开 chrome://extensions → 开启「开发者模式」
  3. 点「加载已解压的扩展程序」→ 选解压后的文件夹
  4. 工具栏出现鲸鱼图标 → 绿点呼吸 = 已连接

需要 Chrome 116+。

二、安装 dsh 插件(1 分钟)

前置:pnpm 在 PATH 上;首次使用会自动初始化目标 profile。

方式 A:从 npm 安装(推荐)

dsh plugin --profile web add @caob23/dsh-browser-control

卸载:

dsh plugin --profile web remove @caob23/dsh-browser-control

方式 B:从 GitHub 安装

dsh plugin --profile web add "github:caob23/dsh-browser-control#v1.0.4"

方式 C:离线安装(无网环境)

下载 dsh-browser-control-plugin-v1.0.4.zip 解压到任意目录,然后:

dsh plugin --profile web add "file:D:\解压目录\dsh-browser-control-1.0.4"

⚠️ 本地目录必须用 file: 前缀,裸路径会被当作 link: 导致启动时解析不到。

从旧版「复制进源码树」方式迁移:先删掉 packages/web/browser-bridge/ 旧副本
并还原 base bundle 三处配置,否则 browser-bridge id 会重复挂载。
旧版布局保留在 GitHub 的 v1.0.2 tag。

三、使用

重启 DSH → 设置 → 插件 → DSH 浏览器控制 → 开启 → 扩展自动连接 → 对话说自然语言就行。

状态页:http://127.0.0.1:9777/

许可证 · License

本项目采用 GNU Affero General Public License v3.0 (AGPL-3.0)

  • 个人 / 学术 / 非商业用途:完全免费,在遵守 AGPL-3.0 的前提下自由使用、修改、分发
  • 企业 / 商业用途:AGPL-3.0 要求通过网络使用本软件也构成"分发",必须公开衍生代码。若企业在闭源产品中嵌入、基于本项目构建 SaaS 服务而不愿开源,需要联系作者获取商业许可(另行协商授权条款)
  • 商业许可咨询GitHub Issues 或邮箱 caob2333@outlook.com

完整许可证文本见 LICENSE 文件(AGPL-3.0)。

v1.0.4 更新

⚖️ 许可证变更:MIT → AGPL-3.0

  • 个人 / 学术 / 非商业用途:完全免费,使用、修改、分发自由不变
  • 企业 / 商业用途:AGPL-3.0 要求网络使用同样构成分发、需公开衍生代码;闭源商用可联系作者购买商业许可(Issues 或 caob2333@outlook.com
  • npm 包元数据同步更新为 AGPL-3.0-only

📄 文档与清理

  • SECURITY.md 支持两种报告渠道:私下 Security Advisories(推荐)或直接提 Issue(不含可利用细节时)
  • dsh-config/README.md 重写为配置项参考(patch 字段含义、默认值、profile 用户层覆盖示例)
  • 仓库瘦身:移除测试夹具与未使用的图标文件,英文文档归档至 docs/en/

v1.0.3

Choose a tag to compare

@caob23 caob23 released this 23 Aug 11:41

DSH Browser Control v1.0.3

Chrome 浏览器扩展 + DeepSeek Harness 插件,让 AI Agent 像人一样操控你的真实浏览器。

本版本起插件已上架 npm,一条命令安装

附件

文件 用途
DSH-Browser-Control-1.0.3.zip Chrome 扩展(解压后加载)
dsh-browser-control-plugin-v1.0.3.zip dsh 插件(离线兜底用,在线装不需要)

一、安装 Chrome 扩展(30 秒)

  1. 下载 zip,解压到固定文件夹
  2. Chrome 打开 chrome://extensions → 开启「开发者模式」
  3. 点「加载已解压的扩展程序」→ 选解压后的文件夹
  4. 工具栏出现鲸鱼图标 → 绿点呼吸 = 已连接

需要 Chrome 116+。

二、安装 dsh 插件(1 分钟)

前置:pnpm 在 PATH 上;首次使用会自动初始化目标 profile。

方式 A:从 npm 安装(推荐)

dsh plugin --profile web add @caob23/dsh-browser-control

卸载:

dsh plugin --profile web remove @caob23/dsh-browser-control

方式 B:从 GitHub 安装

dsh plugin --profile web add "github:caob23/dsh-browser-control#v1.0.3"

方式 C:离线安装(无网环境)

下载 dsh-browser-control-plugin-v1.0.3.zip 解压到任意目录,然后:

dsh plugin --profile web add "file:D:\解压目录\dsh-browser-control-1.0.3"

⚠️ 本地目录必须用 file: 前缀,裸路径会被当作 link: 导致启动时解析不到。

从旧版「复制进源码树」方式迁移:先删掉 packages/web/browser-bridge/ 旧副本
并还原 base bundle 三处配置,否则 browser-bridge id 会重复挂载。
旧版布局保留在 GitHub 的 v1.0.2 tag。

三、使用

重启 DSH → 设置 → 插件 → DSH 浏览器控制 → 开启 → 扩展自动连接 → 对话说自然语言就行。

状态页:http://127.0.0.1:9777/

v1.0.3 更新

📦 一条命令安装

  • 插件按 dsh Profile Bundle 规范打包,dsh plugin add 自动注册进 profile 分层,重启即加载
  • 上架 npm:@caob23/dsh-browser-control
  • 支持 npm / GitHub / 本地 file: 三种安装来源,新增卸载命令

🏗️ 独立构建

  • 插件源码脱离 harness 工作区独立编译(tsc + tsdown),构建产物随仓库提交,GitHub 安装零编译
  • 包名由 in-tree 的 @deepseek-ai/dsh-browser-bridge 变更为 @caob23/dsh-browser-control
  • 单元测试 25/25 通过,publint 通过,npm / GitHub / 本地三种安装路径均实测验证

v1.0.2

Choose a tag to compare

@caob23 caob23 released this 23 Aug 10:25

DSH Browser Control v1.0.2

Chrome 浏览器扩展 + DeepSeek Harness 插件,让 AI Agent 像人一样操控你的真实浏览器。

附件

文件 用途
DSH-Browser-Control-1.0.2.zip Chrome 扩展(解压后加载)
dsh-browser-bridge-plugin-v1.0.2.zip dsh 插件

一、安装 Chrome 扩展(30 秒)

  1. 下载 zip,解压到固定文件夹
  2. Chrome 打开 chrome://extensions → 开启「开发者模式」
  3. 点「加载已解压的扩展程序」→ 选解压后的文件夹
  4. 工具栏出现鲸鱼图标 → 绿点呼吸 = 已连接

需要 Chrome 116+。

二、安装 dsh 插件(1 分钟)

方式 A:一键安装

git clone https://github.com/caob23/dsh-browser-control.git
cd dsh-browser-control
./install.sh /你的路径/deepseek-harness

脚本只复制文件,完成后仍需下面三处配置,改完重启 dsh。

方式 B:手动安装

下载插件 zip 解压到 deepseek-harness 的 packages/web/browser-bridge/,然后:

  1. packages/bundle/base/package.json 的 dependencies 加:

"@deepseek-ai/dsh-browser-bridge": "workspace:^"

  1. cordis.patch.yml 的 plugins 列表加:
    - id: browser-bridge
      name: '@deepseek-ai/dsh-browser-bridge'
      config:
        enabled: false
  1. tsconfig.host.json 的 references 加:

{ "path": "./packages/web/browser-bridge" }

三、使用

dsh 设置 → 插件 → DSH 浏览器控制 → 开启 → 扩展自动连接 → 对话说自然语言就行。

状态页:http://127.0.0.1:9777/

v1.0.2 更新

16 项验收意见修复 + 饱和回归中新发现并修复的 10 个缺陷(回归 A~H 全部 8 组通过,长稳 195 ops 零错误)。

🔔 弹窗全自动应答

  • alert / confirm / prompt / beforeunload 打开即自动处理(默认按 OK),不再卡死自动化
  • 新增 dialog 命令:切换 accept / dismiss / manual 策略,可查最近 50 条弹窗记录
  • 连续链式弹窗(一次点击多个 prompt)逐个依次应答

⌨️ 真实键盘输入

  • 输入新增 type 模式:逐字符真实按键,React 受控组件、带联想的搜索框都能用(百度搜索实测直达结果页)
  • 中文、emoji 原样输入,不再变成 ?
  • 修复字符被插入两次、Enter 不触发表单提交两个缺陷
  • 🪟 绝不修改你的窗口:尺寸、位置、最大化状态一律不动;最小化时明确报错提示你手动还原,而不是擅自恢复

💥 求值更可靠

  • 页面跳转中断求值 → 返回结构化 context_destroyed,不再挂满 60 秒超时
  • DOM 节点 / 函数 / Map 诚实报错,不再静默返回空 {};普通对象完整转移
  • eval 支持 timeoutMs 竞速超时、同源 iframe(frameSelector)、参数注入(argNames + args

🧭 导航与等待

  • 死站点导航返回 siteUnreachable: {dns | unreachable},中英文错误页都能正确分类
  • 新增 wait 命令:selector / text / fn 三种条件轮询等待,最长 120s

📤 工具输出更可信

  • click 返回命中校验(hitVerified)与实际命中点,遮挡时能看出来
  • screenshot 支持按元素裁剪截图,返回元素坐标
  • tabs.list 紧凑结构,snapshot 增加计数与元素详情

v1.0.1

Choose a tag to compare

@caob23 caob23 released this 23 Aug 03:57

DSH Browser Control v1.0.1

Chrome 浏览器扩展 + DeepSeek Harness 插件,让 AI Agent 像人一样操控你的真实浏览器。

附件

文件 用途
DSH-Browser-Control-1.0.1.zip Chrome 扩展(解压后加载)
dsh-browser-bridge-plugin-v1.0.1.zip dsh 插件

一、安装 Chrome 扩展(30 秒)

  1. 下载 zip,解压到固定文件夹
  2. Chrome 打开 chrome://extensions → 开启「开发者模式」
  3. 点「加载已解压的扩展程序」→ 选解压后的文件夹
  4. 工具栏出现鲸鱼图标 → 绿点呼吸 = 已连接

需要 Chrome 116+。

二、安装 dsh 插件(1 分钟)

方式 A:一键安装

git clone https://github.com/caob23/dsh-browser-control.git
cd dsh-browser-control
./install.sh /你的路径/deepseek-harness

脚本只复制文件,完成后仍需下面三处配置,改完重启 dsh。

方式 B:手动安装

下载插件 zip 解压到 deepseek-harness 的 packages/web/browser-bridge/,然后:

  1. packages/bundle/base/package.json 的 dependencies 加:

"@deepseek-ai/dsh-browser-bridge": "workspace:^"

  1. cordis.patch.yml 的 plugins 列表加:
    - id: browser-bridge
      name: '@deepseek-ai/dsh-browser-bridge'
      config:
        enabled: false
  1. tsconfig.host.json 的 references 加:

{ "path": "./packages/web/browser-bridge" }

三、使用

dsh 设置 → 插件 → DSH 浏览器控制 → 开启 → 扩展自动连接 → 对话说自然语言就行。

状态页:http://127.0.0.1:9777/

v1.0.1 更新

  • 🔴→🟢 修复:已连接时圆点显示为绿色呼吸动画(此前误显示红色)
  • ✂️ 新增:弹窗一键「断开连接」,断开后不再自动重连,点「立即连接」恢复
  • 🖼️ README 新增鲸鱼插画横幅、中英双语(中文默认)
  • 🔒 SECURITY.md 补充可见性边界与漏洞私下报告指引

v1.0.0

Choose a tag to compare

@caob23 caob23 released this 22 Aug 16:02

DSH Browser Control v1.0.0

Chrome 浏览器扩展 + DeepSeek Harness 插件,让 AI Agent 像人一样操控你的真实浏览器。

附件

文件 用途
DSH-Browser-Control-1.0.0.crx Chrome 扩展(直接拖入安装)
DSH-Browser-Control-1.0.0.zip Chrome 扩展(解压后加载)
dsh-browser-bridge-plugin-v1.0.0.zip dsh 插件

一、安装 Chrome 扩展(30 秒)

  1. 下载 DSH-Browser-Control-1.0.0.zip,解压到固定文件夹
  2. Chrome 打开 chrome://extensions → 开启「开发者模式」
  3. 点「加载已解压的扩展程序」→ 选解压后的文件夹
  4. 工具栏出现鲸鱼图标 → 点击显示「已连接」= 成功

二、安装 dsh 插件(1 分钟)

方式 A:一键安装(推荐)

clone 仓库后运行:

./install.sh /你的路径/deepseek-harness

方式 B:手动安装

下载 dsh-browser-bridge-plugin-v1.0.0.zip,解压到 deepseek-harness 的 packages/web/browser-bridge/

然后补充三处配置:

  1. packages/bundle/base/package.json 加一行依赖:

    "@deepseek-ai/dsh-browser-bridge": "workspace:^"

  2. cordis.patch.yml 的 plugins 列表加:

    • id: browser-bridge
      name: '@deepseek-ai/dsh-browser-bridge'
      config:
      enabled: false
  3. tsconfig.host.json 的 references 加:

    { "path": "./packages/web/browser-bridge" }

重启 dsh → 设置页出现「DSH 浏览器控制」→ 开启即可。

三、使用

dsh 设置 → 插件 → 开启 → Chrome 扩展自动连接 → 对话说自然语言就行。

http://127.0.0.1:9777/ 查看状态。

工具清单

工具 功能
browser_navigate 导航到 URL
browser_read 读取页面文本/HTML
browser_snapshot 页面快照 → ref 交互树
browser_click 点击元素(by ref / selector)
browser_type 在输入框填入文本
browser_press 模拟键盘按键
browser_scroll 滚动页面
browser_tabs 标签页管理(列表/新建/关闭/切换)
browser_evaluate 执行任意 JS
browser_screenshot 截取页面截图
browser_cleanup 清理临时文件

v1.0.0 更新

  • 🐳 新增鲸鱼 Logo(扩展 + 弹窗 + 状态页 SVG)
  • 📌 持久 debugger 附着(控制期间 Chrome 横幅始终显示)
  • 🔧 端口配置(简化自完整 URL)
  • 🖥️ 状态页左上角 SVG logo + 暗色卡片样式
  • ✅ 29/29 测试通过,host 构建验证