前言¶
在 DeepSeek Harness（DSH）里和模型长对话时，常见做法是复制助手回复里某一段，贴到输入框再写问题。段落一多，上下文容易散，模型也不容易按「第几处、第几处」逐条回应。DSH 社区插件 dsh-annotation（维护者 zuojinxin）面向桌面版 Web 客户端：在对话正文或工作区文件预览里选中文字，写批注（可留空仅标位置），回车后批注块与问题一并发给模型，回复侧按 Annotation 1 … Annotation N 逐条对照，编号可悬停回看原文与批注。
这是什么¶
dsh-annotation 是 DSH 的客户端类插件：在浏览器注入交互层，不替代宿主对话逻辑，而是在选中处挂工具条、角标与待发清单，并把结构化批注块拼进 outgoing 消息。仓库：github.com/zuojinxin/dsh-annotation；社区目录页：skillhub.cn/plugins/zuojinxin/dsh-annotation。许可证 MIT；当前 package 版本 1.6.0。说明文档写明面向 DeepSeek Harness 0.2.1-rc.3（桌面版），实现依赖宿主 CSS 类名与 DOM 结构，DSH 大版本升级后可能需要作者或社区适配。
核心功能¶
下面按 README 已列能力归纳，不超出资料范围。
选中即批注¶
选中助手消息正文，或工作区文件预览里的文字（Markdown、纯文本、代码），选区上方出现工具条，点「批注」写备注；备注留空也能保存，等于只标位置。选中助手正文时，插件会接管宿主自带的引用浮层，只保留批注入口。
编号角标与跨回合收集¶
保存后在原文旁显示蓝色编号角标，滚动时跟随正文，靠近视口边缘会自动避让；悬停角标会高亮对应原文并显示该条批注。可在任意多条消息、多个回合里继续追加，编号从 1 起统一递增。
待发清单与发送形态¶
输入框旁出现 N 条批注 标签，悬停列出全部待发项，可逐条删除。回车发送时，模型收到完整批注块（编号 + 原文 + 批注）以及你输入的问题；用户气泡里只保留问题与标签，批注块在浏览器绘制前从气泡中移除，刷新历史也会按同样规则呈现。消息里带格式约束，模型按 Annotation 1: … 到 Annotation N: … 回答；回复中的编号变为可悬停芯片，便于对照原文与批注。
文件预览与边界¶
侧边栏文件预览与对话正文走同一套流程；引用带文件路径，刷新后角标可恢复，同一句话出现在两个文件里也不会串批注。资料明确不支持 PDF、图片、iframe 内 HTML。界面文案与批注协议跟随宿主 locale（中文 / 英文，可运行时切换）。待发批注保存在浏览器 localStorage，换浏览器或清站点数据会丢失。禁用插件后，由插件添加的 DOM 与样式会全部移除。
安装与启用¶
先做安装，再重启 DSH 桌面版使客户端注入生效。安装命令以仓库 README 为准：
dsh plugin --profile desktop add 'github:zuojinxin/dsh-annotation'
装完重启 DSH 桌面版生效。插件在 DSH 进程与 Web 视图所具备的权限下运行；安装前建议阅读仓库源码与 MIT 许可证，确认符合你的环境与合规要求。DeepSeek Harness 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文仅介绍该开源插件本身。
典型用法¶
交互流可概括为以下步骤（与 README 流程图一致）：
- 在对话或文件预览中选中文字 → 工具条点「批注」→ 写备注或留空 → 原文高亮并出现编号角标。
- 需要时可跨多轮继续选中并追加批注；输入框旁查看
N 条批注，悬停核对或删除单项。 - 在输入框写问题，回车发送；模型侧收到批注块 + 问题，回复按编号逐条展开，你在回复里悬停芯片回看上下文。
资料中的动图与截图位于仓库 docs/images/demo.gif 及 docs/screenshots/，并在 docs/preview.html 匿名示意页用虚构会话名演示，不含真实账号数据。
适用场景与注意¶
适合：需要在 DSH 桌面 Web 里对助手长文或工作区文本做「多点标注、一次提问、逐条答疑」的开发者或日常深度使用者；中英文界面均可。
注意：
- 仅 desktop profile 安装路径与 Web 客户端注入；与 0.2.1-rc.3 对齐，升级 DSH 后若 UI 结构变化，需关注插件更新。
- 批注数据在本地
localStorage，不做跨设备同步。 - 不支持 PDF / 图片 / iframe 内选区。
结尾¶
dsh-annotation 把「选中 → 批注 → 随消息发送 → 按编号回复」收成一条可重复的 Web 内链路，减少复制粘贴与编号对不上的摩擦。进一步了解功能与开发测试方式，见 GitHub 仓库 README；从社区目录进入同一插件页：https://www.skillhub.cn/plugins/zuojinxin/dsh-annotation。
