dsh-annotate：在 DeepSeek Harness 里点选网页元素并写下批注

它是做什么的？

TheYoungChen/dsh-annotate 是 DeepSeek Harness（DSH）的网页元素标注插件，让你直接点选任意网页元素并写下意见，连同 DOM 事实一起发进对话。它解决的是「用文字描述 UI 问题永远说不精确」的麻烦：模型收到的不是截图，而是选择器、语义属性、组件链、几何信息与计算样式等结构化事实，能精确定位到那一行代码。它同时支持在线站点与本地 HTML 文件，内置侧边栏浏览器，由 TheYoungChen 维护，采用 MIT 协议，用 TypeScript 编写。

核心功能

• 元素标注：点选页面元素后自动采集 CSS 选择器与命中数量、aria-label / data-testid / role 等语义属性、React 或 Vue 组件链、位置尺寸与关键 CSS 样式，形成模型可读的结构化事实。
• 评论反馈：选中元素后写下你的意见再发送，直接告诉模型哪里不对、应该怎么改；也可以只选中直接发送让模型先看看这个元素。
• 在线与本地通吃：https 在线站点、http 本地服务、以及拖进浏览器打开的 file:// 本地 HTML 原型图都能标注，弥补同类工具只能覆盖其中一端的缺口。
• 侧边栏内置浏览器：无需担心 X-Frame-Options 与跨源读不到 DOM 的问题，扩展的 content script 运行在目标页面内部，可读 DOM、可高亮、可监听点击，并保留你已登录的 cookie 与登录态。
• 一键开关在线访问：首次在非本地地址标注时会弹出开关，默认关闭，开启后对所有站点生效，关闭后立即停止。
• 数据不出本机：标注通过本地回环通道发送给本机 DSH，不修改页面、不采集密码与信用卡等敏感字段，页面文本被标记为数据而非指令。

怎么使用这个插件？

在 DSH 中启用插件后，按 Ctrl+Shift+A（macOS 为 ⌘+Shift+A）打开标注模式，打开侧边栏浏览器访问任意页面，点「标注」后悬停高亮、点击选中元素，再写评论并发送。发送有两种方式：选中后按 Enter 直接发送，或选中后写意见再发送；Esc 退出标注模式，Shift+Enter 在批注内换行，Ctrl/⌘+点击可保存并发送整批，Tab 在重叠元素间切换。首次在非本地地址使用时需在弹窗中显式开启在线访问，该开关默认关闭。插件还提供 host、port、allowedExtensionId、requestTimeoutMs、maxPayloadBytes、includeScreenshot 等配置项，可按需调整连接与采集行为。

报错怎么排查？

标注在 about:blank 或特殊协议页面上不可用，这是浏览器本身的限制，换用 http、https 或 file:// 页面即可。若在在线站点上无法读取页面结构，通常是尚未开启在线访问开关，按官方说明在设置中显式开启后即可恢复。若模型读不到组件链，是因为组件路径只在开发构建下可用，生产构建下该字段会缺失，属预期行为而非故障。