前言¶

DSH 的插件生态里，浏览器调试类能力可以放在插件中扩展。浏览器 UI 问题如果只用文字描述，通常缺少具体元素上下文。dsh-annotate 让使用者在 Chrome 或 Chromium 中直接选择元素，把 selectors、DOM facts、computed-style highlights、accessibility data、comments 和可选 viewport screenshots 一起交给 Agent。

这是什么¶

dsh-annotate 是 BrambleXu 维护的 DeepSeek Harness 插件，定位为：

Browser element annotation bridge for DeepSeek Harness

它通过 local loopback WebSocket bridge，把浏览器中的元素标注结果发送到 Agent。

已核实信息：

• 许可证：MIT
• Node.js：^22.19 或 >=24
• 0.1 目标：一个本地 Chrome/Chromium 浏览器、一个活动标签页、可见视口截图

核心功能¶

下面介绍已核实的能力。

• 通过 /annotate 在 Chrome 或 Chromium 中直接选择元素。
• 捕获 selectors、DOM facts、computed-style highlights、accessibility data、comments，以及可选 viewport screenshots。
• 通过 local loopback WebSocket bridge 将 structured annotations 发送给 Agent。
• 对浏览器连接做限制：loopback host、extension origin、optional extension ID。

连接限制的具体规则：

• 服务器拒绝非 loopback host。
• 服务器拒绝 origin 不是 chrome-extension:// 的浏览器连接。
• allowedExtensionId 为空时，接受任意本地已安装 Chrome 扩展。
• 如需更严格隔离，应配置精确的扩展 ID。

安装与启用¶

资料给出的本地安装命令如下：

dsh plugin --profile demo add ./dsh-annotate

这是资料中的本地路径示例；远程安装命令未确认。

安装前应检查插件源码与 MIT 许可证。dsh-annotate 会以当前 dsh 进程权限运行，因此不建议直接安装来源不明的修改版。

典型用法¶

可以从 DSH 侧发出标注命令：

/annotate
/annotate http://localhost:3000

接着按页面操作：

1、点击一个元素。
2、输入该元素的 comment。
3、如需要，重复选择其他元素。
4、Submit 后，所有已捕获事实与可见标签页截图会发送到 Agent。
5、Escape 取消当前标注。

适用场景与边界¶

适合需要把本地浏览器元素上下文交给 DeepSeek Harness Agent 的调试、检查或开发场景，尤其是元素定位、样式观察、accessibility 信息整理这类工作。

需要注意以下边界：

• 0.1 面向本地 Chrome/Chromium 浏览器、一个活动标签页和可见视口截图。
• 远程浏览器、full-page capture、edit recording、inline draggable note cards 被明确 defer。
• allowedExtensionId 为空会接受任意本地已安装 Chrome 扩展，建议按需配置精确 ID。
• 插件以当前 dsh 进程权限运行，使用前应确认源码与许可证。

链接¶

GitHub 仓库：

https://github.com/BrambleXu/dsh-annotate

目录页线索，未确认：

https://www.skillhub.cn/plugins/BrambleXu/dsh-annotate