BrambleXu/dsh-annotate
50最近提交 2026年8月14日
dsh-annotate DSH 插件
dsh-annotate 是一个 DSH 插件，允许你在 Chrome/Chromium 浏览器中指向元素，并捕获选择器、DOM 事实、计算样式亮点、无障碍数据、注释以及可选的视口截图。它通过回环 WebSocket 桥接器与 Agent 通信，使视觉反馈变得精确且结构化。配套的 Chrome 扩展负责元素选择。
如何安装 dsh-annotate DSH 插件
dsh plugin --profile demo add ./dsh-annotate复制不会执行命令。安装 dsh-annotate DSH 插件前请核对仓库和版本。
dsh-annotate DSH 插件数据来源
dsh-annotate DSH 插件快照日期：2026年8月16日
discovered
dsh-annotate DSH 插件能做什么
- 通过 `/annotate` 命令直接选择 Chrome 或 Chromium 中的元素。
- 捕获每个选中元素的 CSS 选择器、DOM 属性、计算样式亮点和无障碍数据。
- 为注释附加评论和可选的视口截图。
- 通过本地回环 WebSocket 桥接器向 Agent 发送结构化注释。
- 通过回环主机、扩展来源和可选的扩展 ID 限制浏览器连接以提高安全性。
dsh-annotate DSH 插件适合哪些场景
- 指出 Agent 应在网页上交互的按钮或输入框。
- 通过高亮精确元素及其计算样式来报告视觉缺陷。
- 通过捕获元素的无障碍角色和属性来提供无障碍反馈。
- 在带注释的元素旁发送可见视口的截图以提供上下文。
- 通过附加 DOM 事实和样式高亮来调试 UI 布局问题。
dsh-annotate DSH 插件适合谁
- 使用 DeepSeek Harness 自动化浏览器任务或 UI 测试的开发者。
- 需要向 AI Agent 提供精确网页元素视觉反馈的质量保证工程师。
dsh-annotate DSH 插件的限制
- 0.1 版本仅支持单个本地 Chrome/Chromium 浏览器和单个活动标签页。
- 截图仅限于可见视口，不支持全页截图。
- 远程浏览器、编辑录制和内联可拖动便签卡片等功能已推迟。
- 需要安装配套的 Chrome 扩展并以解压缩方式加载。
- WebSocket 桥接器仅接受来自回环主机和 chrome-extension:// 来源的连接。
dsh-annotate DSH 插件的仓库 README 摘录
以下文字摘自 dsh-annotate DSH 插件的上游仓库 BrambleXu/dsh-annotate 的 README，版权归原作者，仅作引用。
Visual browser feedback for DeepSeek Harness. `/annotate` asks the companion Chrome extension to enter selection mode; each selected element contributes a selector, DOM facts, computed style highlights, accessibility data, a comment, and an optional viewport screenshot to the agent's next turn. ## Why this exists 💡 Browser UI problems are difficult to describe precisely through plain text. `dsh-annotate` lets you point at the relevant element and send the Agent the surrounding browser facts, so visual feedback stays attached to the page element instead of becoming a vague description or a copied screenshot. ## Features ✨ - Select elements directly in Chrome or Chromium through `/annotate`. - Capture selectors, DOM facts, computed-style highlights, accessibility data, comments, and optional viewport screenshots. - Send structured annotations to the Agent through a local loopback WebSocket bridge. - Restrict browser connections by loopback host, extension origin, and optional extension ID. ## Install 📦 Add the plugin project to a Harness profile: ```sh dsh plugin --profile demo add ./dsh-annotate ``` Then install the companion extension: 1. Open `chrome://extensions` in Ch
阅读完整 README仓库许可: MIT
dsh-annotate DSH 插件常见问题
如何安装 dsh-annotate？
在 DeepSeek Harness 环境中运行 `dsh plugin --profile demo add ./dsh-annotate`。然后打开 Chrome 或 Chromium，进入 `chrome://extensions`，启用开发者模式，点击“加载已解压的扩展程序”，选择项目中的 `browser-extension` 目录。打开扩展弹出窗口，保持默认的桥接端点即可。
我可以使用远程浏览器吗？
不可以，0.1 版本仅支持单个本地 Chrome/Chromium 浏览器和一个活动标签页。远程浏览器功能已推迟到未来版本。出于安全考虑，WebSocket 桥接器仅接受回环主机连接。
如何更改插件监听的端口或主机？
你可以在 Harness 配置文件的 dsh-annotate 配置段中设置。需要修改 `host`、`port`、`allowedExtensionId`、`requestTimeoutMs`、`maxPayloadBytes` 和 `includeScreenshot` 等参数。服务器会拒绝非回环主机。
注释会捕获哪些数据？
对于每个选中的元素，它会捕获 CSS 选择器、DOM 事实（如标签名、id、类）、计算样式亮点、无障碍数据（ARIA 属性、角色等）、你输入的注释以及可选的视口截图。所有这些数据会以结构化格式发送给 Agent。
扩展 ID 是必须设置的吗？
不是必须的。如果你将 `allowedExtensionId` 留空，任何连接到桥接器的本地 Chrome 扩展都会被接受。为了更严格的隔离，可以复制弹出窗口中显示的扩展 ID 并填入配置。桥接器还会限制连接必须来自回环主机和 `chrome-extension://` 来源。