前言¶
在 DeepSeek Harness（DSH）里长对话时，常见做法是把某段原文复制进输入框再写批注。草稿会变长，引用和说明混在一起，发送前也不易一眼看清「引了哪几句、各自写了什么」。若还要在分组或嵌套流程里对多段内容分别标注，更需要一种不污染整段草稿、又能随发送展开完整引文与注释的机制。
下面介绍社区客户端插件 DSH Selection Comments（包名 @o-oii/dsh-selection-comments），维护者为 O-OII，在 Web 或 Windows Desktop 的 DSH 会话界面中，对选中段落添加编号锚点注释，并在草稿里用紧凑引用占位，提交时再展开为完整引文与你的说明。
这是什么¶
DSH Selection Comments 属于 DSH 生态中的客户端类插件：在对话界面注入选区操作与注释 UI，不依赖把大段复制文本堆进 composer。插件当前版本 0.3.3（见仓库 package.json），许可证 MIT。
社区目录页：skillhub.cn 插件页。源码与说明：GitHub — O-OII/dsh-selection-comments。目录站点为社区独立收录，与 DeepSeek / 幻方无官方从属关系；DSH 本身遵循「一切皆插件」的扩展思路，安装与审阅源码仍由使用者自行负责。
核心功能¶
以下能力均来自项目 README 与 package.json 声明，可按需对照 兼容性矩阵 与 用法说明。
-
选区注释与编号锚点
在会话中选中一段文字，通过 注释 / Comment 添加说明；段落旁显示带编号的徽章（badge），便于定位。 -
紧凑草稿引用
引文与注释在草稿中合并为一条紧凑引用；正常提交时，引用会展开为原始选段与你的注释内容，而不是只留一个编号。 -
分组 / 嵌套流程（0.3.3）
在 DSH 的分组或嵌套 process flow 中仍可使用选区操作，并在隔离的多个对话 pane 之间分别生效。 -
发送后与历史消息（0.3.2 起）
在兼容的宿主上，已发送消息及兼容的历史记录以可展开的编号引文/注释卡片展示，而非原始 XML 标签；队列预览保持紧凑。Expand 可查看全文。卡片是发送时文本的快照；未发送注释的编辑/删除不会改变已发送卡片。模型上下文与消息的 Copy/Edit 仍保留完整原文。不支持官方 user-text 扩展接缝的宿主会继续显示原始 XML，详见文档 发送后与历史消息卡片。 -
编辑与管理
从编号徽章或草稿引用可编辑、删除或重新添加注释；All comments 集中查看引文、说明与草稿状态。Delete all comments 会清除本会话的注释、草稿引用及插件标签页缓存。 -
界面语言
默认简体中文（即使用英文浏览器或 DSH 界面）。注释对话框内可选 English 或 Follow DSH；Esc关闭对话框。 -
Composer 保持简洁
不常驻注释工具栏，也不在页脚增加永久计数器。 -
同标签页恢复
刷新后可在同一浏览器标签页内通过sessionStorage恢复注释；不是跨标签、云同步或安全擦除，见 privacy and limits。
插件客户端 bundle 已随仓库提供，安装后无需自行 build。filled comment 相关按钮会使用当前 skin 的主色/前景/hover token（含透明底皮肤）。
安装与启用¶
面向 DSH Web 或 Windows Desktop；API 基线与测试范围见 compatibility.md。package.json 中 engines 要求 Node >= 22，dsh >= 0.2.1-rc.2 且 < 0.3.0。请使用与你目标安装匹配的官方 DSH CLI；将下面命令里的 desktop 换成你的 profile。
git clone https://github.com/O-OII/dsh-selection-comments.git
cd dsh-selection-comments
dsh plugin --profile desktop add --ignore-scripts .
插件以当前 DSH 进程的权限运行。安装前应阅读源码、LICENSE（MIT）及 SECURITY.md，确认符合你的环境与安全要求。
典型用法¶
README 归纳的四步流程可直接复现：
- 在对话中选中一段文字，点击 注释 / Comment。
- 输入说明，选择 Add comment，或按
Ctrl/⌘+Enter。 - 点击编号徽章或草稿引用，进行编辑、删除、重新添加，或打开 All comments。
- 在 DSH 中照常发送：引用会展开为原始引文与你的注释，而非仅显示编号。
发送后，在兼容宿主上可展开卡片查看完整引文与注释；需要通览时打开 All comments 对话框管理本会话全部条目。
更细的语言选项、迁移与限制见 docs/usage.md；开发与可复现截图见 docs/development.md；范围与替代方案见 docs/scope.md。
适用场景与注意¶
适合谁： 需要在 DSH 长对话里对多处段落做结构化批注、又不想把 composer 塞满复制文本的 Web/Desktop 用户；需要在草稿中保留紧凑引用、发送时再展开完整上下文的场景；希望默认中文注释 UI、必要时切换英文或跟随 DSH 语言的用户。
注意：
- 注释恢复依赖同标签页的
sessionStorage，换标签或换设备不会自动同步。 - 发送后卡片展示依赖宿主是否提供官方 user-text 扩展接缝；否则行为回退为 XML 展示。
- 插件通过 Cordis patch（
cordis.patch.yml）注入@deepseek-ai/dsh-client-ui-conversation、dsh-client-ui-input-trigger、dsh-client-locale等客户端模块，升级 DSH 主版本时需对照engines.dsh与兼容性文档。
结尾¶
DSH Selection Comments 把「选段—编号—紧凑草稿—发送展开」串成一条可复现的工作流，并附带 All comments 与会话内标签页级恢复，适合在 Harness 里做细粒度对话标注。进一步了解可访问 社区目录页 与 GitHub 仓库。
