前言¶
在 DeepSeek Harness（DSH）里和 Agent 对话时，常见做法是复制某一段回答、贴进输入框，再写一句「这里不对」或「请展开」。多段意见就要重复多轮，或者自己拼成一大段文字，上下文容易乱。
dsh-annotate 面向的是另一种节奏：在助手回答里选中原文、为每处选区单独写备注，备注先以芯片形式挂在输入框上方，最后在输入框按 Enter，把草稿（若有）和整批标注合成一条消息发给 Agent。下面按安装、用法和限制说明这个插件能做什么、不能做什么。
这是什么¶
dsh-annotate 是 DSH 的回答标注插件，维护者为 DWJZ，在社区目录中归类为工作流。它解决的是「对同一条回答多处点评，却不想拆成多条用户消息」的问题：引用和评论在发送前在浏览器里暂存，发送时按固定模板编号输出，便于 Agent 逐条回应。
它不是消息锚点，也不做持久化；引用文本会写进你发出的那条消息里，Session 后续轮次和他人阅读记录仍能看到内容，但页面刷新后芯片列表会清空。
核心功能¶
选区标注¶
在助手回答中选中一段文字，选区旁会出现 Annotate 按钮。点开后为该段写备注：Enter 保存，Shift+Enter 换行。可以多次重复：每次独立对应自己的引用和评论。
输入框上方的待发送列表¶
未发送的标注以芯片形式排在输入框上方一行，展示引用片段与评论，可单独删除。插件不提供单独的发送按钮；在输入框按 Enter 即发送（Shift+Enter 仍只换行、不发送）。
与草稿合并为一条消息¶
输入框里可以留自己的文字，也可以留空。按 Enter 时：若有草稿，先发草稿内容，再把标注批次接在后面，作为一条消息；若输入框为空，则只发送标注批次。
发送后，标注会被编成带编号的英文引导语，例如：
Please address each of my annotations on your answer above:
1. Quote: "this step overwrites the original file"
Comment: it should back it up first
2. Quote: "about 3 seconds"
Comment: where does that number come from?
高亮（尽力而为）¶
在选区 DOM 仍有效时，插件用 CSS Custom Highlight API 在页面上高亮已标注段落。回答重新渲染（例如流式输出结束、切换 Session）后高亮可能消失；以芯片列表为准，列表在发送前保持完整。
安装与启用¶
插件以当前 DSH 进程的权限运行，安装前建议浏览 GitHub 仓库 源码与 MIT 许可证。Web 侧安装命令来自官方 README：
# from GitHub
dsh plugin --profile web add github:DWJZ/dsh-annotate
本地开发时，可用 link 方式把检出目录挂到 profile（修改后重启生效）：
# local development (the profile links the checkout, so edits apply on restart)
dsh plugin --profile web add link:/path/to/dsh-annotate
Desktop 应用的 desktop profile 需通过应用自带的插件管理器添加，README 未给出与 web 相同的单行命令。
package.json 标明运行环境为 Node ^22.19 || >=24，当前发布版本为 0.1.0。
典型用法¶
README 给出的步骤可直接复现：
- 在助手回答中选中一段文字。
- 点 Annotate，写备注，点 Save。重复 1–2 即可攒多条。
- 在输入框按 Enter（可带或不带你自己的补充说明）。
经过上面的步骤，Agent 会收到一条结构化的批注请求，而不是多条零散复制粘贴。
适用场景与注意¶
适合谁：经常需要对同一条长回答做多点评审、希望 Agent 按条回复的 DSH 用户；分类上属于工作流类增强，而不是存储或会话管理。
务必知晓的限制（来自 README Known limitations）：
- 宿主侧（
index.js）主要是注册行；客户端图由 Loader 扫描声明了dsh.client的包组装，没有该行则client/不会加载。 - 标注不持久化：刷新页面后芯片列表丢失（已发送的内容仍在消息里）。
- 高亮经不起重新渲染；流式输出或切换 Session 可能导致高亮错位，列表仍完整。
- 在回答仍在流式输出时也可以标注，但排版变化可能导致高亮偏离原文。
DSH 生态强调「一切皆插件」；SkillHub 目录页 是社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-annotate 把「选中回答 → 写备注 → 一次性发给 Agent」收成一条固定格式的消息，减少来回复制。若要安装或看实现细节，可访问目录页 dwjz/dsh-annotate 与仓库 github.com/DWJZ/dsh-annotate。
