消息批注 Theoz001/dsh-message-annotator

dsh-message-annotator

为 DeepSeek Harness (DSH) 提供引用并评论的注释功能，Codex 风格。

在聊天中选择任意文本——助手回复、回合中间步骤、工具输出——选区旁会浮现一个 Annotate 按钮。每条注释将引用的段落与你的笔记配对，并以编号卡片的形式排列在输入框上方：对齐、可编辑、可删除。一次性全部发送：插件会将你的草稿加上所有注释组合成一条结构化消息发送给智能体。

功能

- 选区浮动触发 —— 在聊天流中选择任意文本，旁边会弹出 Annotate 标签；引用内容即为所选段落。
- 单条消息操作 —— 每条已完成的助手消息的操作行中（点赞/点踩旁边）也会有一个 Annotate 图标；未选择文本时则注释整条消息。
- 输入框上方的注释停靠区 —— 编号卡片（Annotation 1、Annotation 2……），每张卡片将引用与可编辑的笔记配对；支持单卡删除、全部清空。
- 可折叠条 —— 注释较多时折叠为单行标签（悬停标签可预览，点击 × 可删除），Send 依然一键可达。
- 对齐发送 —— Send annotations 会将草稿加上所有注释组合成一条消息，每个引用块与其笔记对齐；Insert into draft 仅将组合后的文本暂存到草稿中供你审阅。
- 双语界面（zh/en 跟随外壳语言环境），主题令牌样式（适配浅色/深色及玻璃主题）。

安装

声明了官方 dsh.bundle 清单——一条命令即可安装并启用：

dsh plugin --profile web add github:Theoz001/dsh-message-annotator

然后重启 dsh 并重新加载 Web UI。

手动安装（macOS/Linux）：

git clone https://github.com/Theoz001/dsh-message-annotator
ln -s "$PWD/dsh-message-annotator" ~/.dsh/profiles/node_modules/@deepseek-ai/dsh-client-ui-annotator

然后追加到 ~/.dsh/profiles/web/cordis.patch.yml：

- insert:
- id: ui-annotator
name: '@deepseek-ai/dsh-client-ui-annotator'

出站格式

adjust per the annotations

My annotations on this reply (2 in total, each quote paired with its note):

[Annotation 1]
the index should be on user_id
No — queries filter by order_id, index that instead

[Annotation 2]
(whole message)
Direction is fine; please add error handling

构建

仓库已附带预构建的 lib/ 产物；重新构建只需 node + esbuild （关于 esbuild 的定位方式见 build.mjs，或设置 DSH_ESBUILD）：

node build.mjs

工作原理

纯客户端插件（无需改动宿主）：单条消息入口注册到 conversation.chat.assistant-actions，停靠区注册到 conversation.input.dock，两者共享同一个按会话划分的控制器；浮动触发器是一个文档级选区监听器。发送依托公开的输入状态机（inputActions.setDraft + submit）。

已知限制
- 操作条按钮只出现在每个回合的收尾消息上（插槽约束）；批注中间步骤请使用划词浮动按钮。
- 暂存批注为会话内内存态——刷新页面即丢失（已发送消息不受影响）。

许可证

MIT

中文说明

在 DeepSeek Harness Web 聊天界面里对 Agent 的回复划重点、写批注：批注以卡片形式暂存在输入框上方、逐条与引用对齐，随后一键合并发送给 Agent。交互参考 Codex 桌面版的 quote-and-comment 模式。

功能

- 划词浮动批注：聊天流里选中任意文字（Agent 回复、中间步骤、工具输出均可），选区旁浮出蓝色「批注」按钮，点击弹编辑框，引用即选中文本。
- 逐消息批注入口：每条已完成的 Agent 回复的操作条（复制/点赞那一行）上也有「批注」按钮；不划词时批注整条回复。
- 批注条：输入框上方列出全部暂存批注——编号、引用原文、可编辑批注内容、单条移除、一键清空。
- 缩略模式：批注多时可「收起」为一行 chip（悬停看内容、× 单删），发送按钮保留，点标题处展开。
- 合并发送：「发送批注」把当前草稿 + 编号对齐的批注块合成一条消息发出；「插入草稿」只排版进输入框供检查。

发送格式示例

按批注调整一下

以下是我对这条回复的批注（共2条，引用与批注逐条对应）：

[批注 1] 这里的索引应该建在 user_id 上不对，查询条件是 order_id，索引要跟着查询走

[批注 2] （整条回复）整体方向可以，再补一下错误处理

安装

dsh plugin --profile web add github:Theoz001/dsh-message-annotator

重启 dsh、刷新 Web UI 即生效。

已知限制

- 操作条按钮只出现在每个 turn 的收尾消息上（插槽固有约束）；批注中间步骤请用划词浮动按钮。
- 暂存批注为会话内内存态，刷新页面即丢失（已发送内容不受影响）。