前言¶
浏览器自动化任务往往依赖已打开的页面和登录状态。传统的做法通常需要启动新的自动化浏览器实例,或者导出 Cookie,这会增加环境配置成本,并丢失当前的会话上下文。DeepSeek Harness 的插件生态旨在解决这类问题,dsh-doyourweb 就是为此而生的一个联网工具插件,它允许你直接引用并控制已登录的 Chrome 或 Edge 标签页,从而复用现有的会话状态。
插件定位¶
- 功能描述:Reference and control existing Chrome and Edge tabs from DeepSeek Harness(从 DeepSeek Harness 引用并控制现有的 Chrome 和 Edge 标签页)。
- 维护者:SheepofSheep。
- 类别:联网工具。
- 许可证:MIT。
核心功能¶
- 复用现有会话:直接复用 Chrome 和 Edge 中已登录的 HTTP/HTTPS 标签页,无需重新登录。
- 菜单集成:通过 DSH 的
@和/菜单列出页面标题、站点和图标。 - 紧凑阅读:支持通过选择器或查询缩小范围,并使用光标分页。初始引用上下文默认 2,400 字符预算。
- 批量操作:支持批量执行动作,每次调用最多 12 个动作,遇到失败或导航会停止。
- 数据提取:可提取文本、值和 href 字段,每次提取最多 20 行。
- 本地截图:将 PNG 截图保存到本地并返回路径,不使用 base64 嵌入。
- WebMCP 优先控制:实验性功能,优先使用页面提供的 WebMCP 工具,若没有则回退到 DOM 快照。
安装与启用¶
安装命令:
在 DeepSeek Harness 中打开 Plugins > Add Plugin,选择官方 npm 注册表,输入:
dsh-doyourweb
若官方仓库未同步或返回 404,可使用本地构建方式安装:
git clone --branch ver0.1.1 https://github.com/SheepofSheep/dsh-doyourweb.git
cd dsh-doyourweb
npm ci
npm run build
在 DSH 中打开 Plugins > Add Plugin,输入构建后的项目目录绝对路径。
连接浏览器:
1. 在 DSH 中输入 /browser 打开本地连接页面。
2. 在 Chrome 或 Edge 中启用开发者模式,加载 extension/ 文件夹(未打包扩展)。
3. 对比扩展的 4 位配对代码与连接页面的请求,确认后批准。
4. 在 DSH 中使用 @ 选择已打开的页面。
典型用法¶
- 引用页面:在对话中使用
@选择一个已打开的标签页,然后描述任务。 - 读取内容:使用
browser_read工具。默认mode: "auto"会优先尝试发现 WebMCP 工具,否则返回 DOM 快照。若需指定 DOM 快照,使用mode: "dom"并配合selector、query或depth进行筛选。cursor支持分页,limit控制字符长度(400-8,000)。 - 执行操作:使用
browser_act工具,传入最新的 snapshot ID,执行点击、填充、按键或选择等操作。
注意事项¶
- 环境要求:需要 Node.js 22+ 和 DeepSeek Harness 0.2.0-rc.2。
- 数据存储:数据目录位于
<DSH_HOME>/browser-tabs/(默认为~/.dsh/browser-tabs/)。 - 预算机制:字符预算计算 JavaScript 字符(包含 JSON 转义和元数据),而非模型 token。它限制返回上下文,不限制 DOM 遍历时间。
- 配对机制:插件和浏览器扩展必须通过 4 位代码配对,配对后后台自动重连,无需保持弹窗打开。
- 无演示:目前没有公共托管的演示。
结语¶
dsh-doyourweb 降低了浏览器自动化对全新环境的依赖,让模型能直接利用已打开的标签页工作。配合 DSH 的插件机制,它是处理网页内容、执行批量操作的实用工具。更多细节可参考 GitHub 仓库。