前言¶
在 DSH Web 里和模型对话时，常见做法是把某段助手回复整段复制到输入框，再手写「请解释这里」。引用一长段正文会占输入 token，也容易和当前问题混在一起。社区插件 dsh-annotations（维护者 jin1254）面向官方 DSH Web：在已完成的助手回复里选中一段文字，加简短评论，再通过输入框里的紧凑标签（reference chip）随下一条用户消息一起提交；悬停可预览原文与评论，点击可回到来源位置。插件不修改宿主、不依赖自定义 API，与 DeepSeek 无隶属关系；当前 README 声明的兼容版本为 DSH 0.2.1-rc.2 Web UI，桌面版与其他发行版未验证。
这是什么¶
dsh-annotations 是 DSH 社区目录中的客户端插件（npm 包名 @jin1254/dsh-annotations，资料中版本 0.1.4，许可证 MIT）。它在 Web 对话界面注入批注能力：选中助手文本 → 写评论 → 以原生 reference chip 形式挂在 composer 上，发送时与普通正文可并存，也可只发标签。评论不会写入可编辑的正文区域；历史导航会收到可读的批注标题。
核心功能¶
下面能力均来自项目 README 与 package.json 中的说明。
选文与评论¶
- 在已完成的助手回复中选中一段文字，选择 Add to conversation。
- 编写评论：Enter 保存，Escape 取消，Shift+Enter 换行。
- 再次打开 Edit annotation 时，焦点落在评论框且不滚动整段对话；编辑器为圆角紧凑面板，随文字增高直至视口上限；底部有 Delete、Cancel、Save。Delete 会丢弃未保存的新评论或删除正在编辑的条目。
Composer 与待发送列表¶
- 保存评论后，composer 上会自动挂上紧凑标签；点击标签可展开或收起上方的待发送批注列表。
- 列表每行左侧为灰色评论、右侧为引用，中间留空；长引用最多占文本区域约四分之一宽度，过长会截断。点击引用可读原文或编辑评论全文。
- 待发送行无 hover 卡片；已发送的标签保留悬停预览与来源导航。
- 可仅含标签的草稿用 Enter 或 Send 提交，也可与 composer 中的普通文字一起发送。
来源定位与轮次¶
- 在待发送列表或历史标签中点击引用可导航回原文；自底部导航时会对齐选中文字（含长段落内定位）。
- 消息成功发送后，本轮蓝色标记会清除，下一轮编号从 1 重新开始；历史标签保留来源坐标。
- 若来源在 0.2.1-rc.2 现有 Chat 节点标记下无法唯一确定，评论仍保留，但会报告导航失败。
模型输入形态¶
批注随一条普通用户消息发出：可选 composer 正文、可读标题，以及版本化的 dsh-annotations JSON 文本块。每条 note 含编号、精确引用、来源坐标与评论。不追加 system 或 tool 消息；引用文字会计入输入 token。
本地与失败行为¶
- 未发送的批注仅保存在当前浏览器，不同设备间不同步。
- 原生提交失败时会恢复 reference chip。
- 若关页或取消导致是否已写入对话不确定，应先检查对话记录，再决定是否重新挂载批注。
- 使用本插件时，README 建议关闭其他批注类插件，避免冲突。
安装与启用¶
Release 压缩包内含预构建产物，不执行安装脚本。从 GitHub 仓库 Releases 下载 .tgz 资源后，在本地执行（路径替换为实际下载文件）：
dsh plugin --profile web add <archive-path> --ignore-scripts
按 DSH 文档完成重启后，刷新 Web 页面。package.json 中 engines.dsh 为 =0.2.1-rc.2，与 README 的兼容声明一致。
插件以当前 DSH 进程权限在 Web 客户端运行；安装前宜自行查看仓库源码与 MIT 许可证，确认注入范围符合你的环境策略。
典型用法¶
- 打开已与 0.2.1-rc.2 Web UI 对齐的 DSH Web，并确保仅启用本批注插件。
- 等助手回复完成后，拖选需要追问或标注的句子，选 Add to conversation，输入评论并 Enter 保存。
- 点击 composer 上的 reference chip，展开待发送列表；需要时用行内按钮编辑或删除，或点击引用核对原文。
- 在 composer 继续输入问题，或只发送批注标签；发送后通过标签悬停预览与点击回到来源继续迭代。
适用场景与注意¶
适合：需要在 Web 对话里对助手某句/某段做结构化备注，并把「引用 + 评论」紧凑地随下一条消息交给模型，且愿意锁定在已验证的 0.2.1-rc.2 Web 环境。
已知限制（README 原文）：
- 兼容目前仅声明 0.2.1-rc.2；来源导航依赖该版本的 Chat 节点标记。
- 不支持 reasoning、tool 卡片、跨消息选区、移动端选手势。
- 不支持 CSS Custom Highlights 的浏览器仍可保留评论，但无文本高亮填充。
社区插件目录独立于 DeepSeek / 幻方，并非官方应用商店；星标与目录页展示以站点为准（资料中 GitHub 星标为 0）。
链接¶
- 社区目录：https://www.skillhub.cn/plugins/jin1254/dsh-annotations
- 源码与 Releases：https://github.com/jin1254/dsh-annotations
以上安装命令与行为描述均以仓库 README 与 Release 说明为准；其他 DSH 版本需自行验证后再用。
