Releases: caob23/dsh-browser-control
Release list
v1.0.4
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 秒)
- 下载 zip,解压到固定文件夹
- Chrome 打开
chrome://extensions→ 开启「开发者模式」 - 点「加载已解压的扩展程序」→ 选解压后的文件夹
- 工具栏出现鲸鱼图标 → 绿点呼吸 = 已连接
需要 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 浏览器控制 → 开启 → 扩展自动连接 → 对话说自然语言就行。
许可证 · 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
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 秒)
- 下载 zip,解压到固定文件夹
- Chrome 打开
chrome://extensions→ 开启「开发者模式」 - 点「加载已解压的扩展程序」→ 选解压后的文件夹
- 工具栏出现鲸鱼图标 → 绿点呼吸 = 已连接
需要 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 浏览器控制 → 开启 → 扩展自动连接 → 对话说自然语言就行。
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
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 秒)
- 下载 zip,解压到固定文件夹
- Chrome 打开
chrome://extensions→ 开启「开发者模式」 - 点「加载已解压的扩展程序」→ 选解压后的文件夹
- 工具栏出现鲸鱼图标 → 绿点呼吸 = 已连接
需要 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/,然后:
- packages/bundle/base/package.json 的 dependencies 加:
"@deepseek-ai/dsh-browser-bridge": "workspace:^"
- cordis.patch.yml 的 plugins 列表加:
- id: browser-bridge
name: '@deepseek-ai/dsh-browser-bridge'
config:
enabled: false
- tsconfig.host.json 的 references 加:
{ "path": "./packages/web/browser-bridge" }
三、使用
dsh 设置 → 插件 → DSH 浏览器控制 → 开启 → 扩展自动连接 → 对话说自然语言就行。
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
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 秒)
- 下载 zip,解压到固定文件夹
- Chrome 打开
chrome://extensions→ 开启「开发者模式」 - 点「加载已解压的扩展程序」→ 选解压后的文件夹
- 工具栏出现鲸鱼图标 → 绿点呼吸 = 已连接
需要 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/,然后:
- packages/bundle/base/package.json 的 dependencies 加:
"@deepseek-ai/dsh-browser-bridge": "workspace:^"
- cordis.patch.yml 的 plugins 列表加:
- id: browser-bridge
name: '@deepseek-ai/dsh-browser-bridge'
config:
enabled: false
- tsconfig.host.json 的 references 加:
{ "path": "./packages/web/browser-bridge" }
三、使用
dsh 设置 → 插件 → DSH 浏览器控制 → 开启 → 扩展自动连接 → 对话说自然语言就行。
v1.0.1 更新
- 🔴→🟢 修复:已连接时圆点显示为绿色呼吸动画(此前误显示红色)
- ✂️ 新增:弹窗一键「断开连接」,断开后不再自动重连,点「立即连接」恢复
- 🖼️ README 新增鲸鱼插画横幅、中英双语(中文默认)
- 🔒 SECURITY.md 补充可见性边界与漏洞私下报告指引
v1.0.0
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 秒)
- 下载
DSH-Browser-Control-1.0.0.zip,解压到固定文件夹 - Chrome 打开
chrome://extensions→ 开启「开发者模式」 - 点「加载已解压的扩展程序」→ 选解压后的文件夹
- 工具栏出现鲸鱼图标 → 点击显示「已连接」= 成功
二、安装 dsh 插件(1 分钟)
方式 A:一键安装(推荐)
clone 仓库后运行:
./install.sh /你的路径/deepseek-harness
方式 B:手动安装
下载 dsh-browser-bridge-plugin-v1.0.0.zip,解压到 deepseek-harness 的 packages/web/browser-bridge/。
然后补充三处配置:
-
packages/bundle/base/package.json加一行依赖:"@deepseek-ai/dsh-browser-bridge": "workspace:^"
-
cordis.patch.yml的 plugins 列表加:- id: browser-bridge
name: '@deepseek-ai/dsh-browser-bridge'
config:
enabled: false
- id: browser-bridge
-
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 构建验证