dsh-browser-plugin
中文 · English
DeepSeek Harness(DSH)的侧边栏浏览器插件。每个对话使用独立的 Chrome 和 profile:你在边栏中登录、填写表单后,智能体会在同一浏览器中继续操作,其他对话无法访问登录状态。
功能
- 右侧边栏中的可交互浏览器:点击、滚动、输入、地址栏和多标签页。
- 15 个
browser_* 工具,供智能体浏览、读取和操作网页。
- 人工操作与智能体操作实时同步,并在同一对话中自动排队。
- 支持无头和隐身模式;隐身模式会显示真实 Chrome 窗口。
- 支持性能/高清画质切换,以及右键打开当前页面的 DevTools。
安装
将以下内容加入 $DSH_HOME/profiles/<profile>/cordis.patch.yml,并替换为仓库实际绝对路径:
- insert:
- id: dsh-browser-plugin
name: "file:///D:/desktop/repos/dsh-browser-plugin/lib/index.js"
- id: dsh-browser-gate
name: "file:///D:/desktop/repos/dsh-browser-plugin/lib/gate.js"
也可以安装仓库:
dsh plugin add --profile web /path/to/dsh-browser-plugin
安装或更新后重启 dsh web;只改客户端界面时刷新 DSH 页面即可。
使用
- 打开一个 DSH 对话,在右侧边栏中打开「浏览器」。
- 手动访问网站、登录或完成需要人工确认的步骤。
- 让智能体调用
browser_* 工具继续操作同一页面。
当状态栏显示智能体正在使用浏览器时,边栏操作会等待当前调用结束,避免互相覆盖。
常用配置
完整配置见 src/config.ts。
| 配置 | 默认值 | 说明 |
|---|
chromePath | 系统 Chrome 路径 | Chrome/Chromium 可执行文件路径。 |
isolation | 'session' | 每个对话独立浏览器;设为 'shared' 时全部对话共用。 |
maxBrowsers | 4 | 同时保留的浏览器上限。 |
stealth | false | 默认使用隐身模式。 |
paneQuality | 'perf' | 初始画质:'perf' 或 'hd'。 |
allowSubagents | false | 是否允许子智能体操作浏览器。 |
注意事项
- 会话隔离意味着每个对话需要单独登录。
- 隐身模式仅减少部分自动化特征,不能保证通过网站验证。
- 请优先在侧边栏中操作;直接点击隐身模式弹出的 Chrome 窗口不会经过串行队列。
- 右键 DevTools 需要网络访问 Chrome 托管的调试前端。
开发
需要 Node.js 20 或更高版本。
npm run build
npm test
修改 src/ 后需重新构建并提交 lib/ 产物。
许可
MIT,见 package.json。