前言¶
浏览器自动化任务往往依赖已打开的页面和登录状态。传统的做法通常需要启动新的自动化浏览器实例，或者导出 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 仓库。
