前言¶
在使用 DeepSeek Harness (DSH) 与 Agent 交互时，开发者常需针对回复中的特定片段给出反馈或修正意见。直接复制文本或重写整条消息容易丢失上下文，且难以精确对应。dsh-message-annotator 插件参考了 Codex 桌面版的交互模式，旨在解决这一痛点，提供一种结构化的引用与批注机制。
是什么¶
dsh-message-annotator 是一个客户端插件，由 Theoz001 维护。它的核心功能是在 DeepSeek Harness Web 界面中，允许用户对 Assistant 的回复（包括中间步骤或工具输出）进行引用和批注。用户可以将选中的文本与批注内容暂存为编号卡片，随后将这些卡片与草稿对齐合并，作为一条结构化的消息发送给 Agent。
核心功能¶
该插件提供以下主要功能：
- 划词浮动触发：在聊天流中选中任意文本（Agent 回复、中间步骤、工具输出），选区旁会浮出“Annotate”按钮。点击后，引用内容即锁定为选中文本。
- 逐消息动作：每条已完成的 Assistant 消息的操作栏（点赞/点踩按钮旁）也会出现“Annotate”按钮。不选中文本时，点击该按钮可对整条消息进行批注。
- 批注停靠栏：输入框上方会列出所有暂存的批注，以编号卡片形式展示（如 Annotation 1, Annotation 2…）。每张卡片包含引用原文和可编辑的批注内容，支持单条移除和一键清空。
- 折叠条：当批注数量较多时，卡片会折叠为单行 Chip。悬停可预览内容，点击 × 可移除，发送按钮始终可用。
- 对齐发送：
- Send annotations：将当前草稿与所有批注合并为一条消息发出，每条引用块与批注内容严格对齐。
- Insert into draft：仅将排版好的文本（包含引用和批注结构）插入到输入框草稿中，供用户检查。
- 双语界面：界面语言跟随系统环境，支持中英文切换。
安装与启用¶
通过官方命令行安装该插件：
dsh plugin --profile web add github:Theoz001/dsh-message-annotator
执行命令后，需要重启 dsh 并刷新 Web UI 以使插件生效。
典型用法¶
- 创建批注：在聊天界面中选中一段代码或文本，点击出现的“Annotate”按钮，在弹出的编辑框中输入批注内容。
- 管理批注：在输入框上方的停靠栏中，可以查看、编辑或删除已创建的批注卡片。
- 发送消息：
- 若需 Agent 根据批注调整内容，点击“Send annotations”。
- 若需先检查生成的结构化文本，点击“Insert into draft”。
注意事项¶
- 触发限制：操作栏上的“Annotate”按钮仅出现在每个回合的结束消息上（这是插槽的固有约束）。对于中间步骤或非结束消息，请使用划词浮动按钮进行批注。
- 数据持久性：暂存的批注仅在当前会话的内存中有效。刷新页面后，批注内容会丢失（已发送的消息不受影响）。
- 安全提示：安装前建议检查插件的源码与许可证。
