dsh-message-annotator

Quote-and-comment annotations for DeepSeek Harness (DSH), Codex-style.

English | 中文

Select any text in the chat — an assistant reply, a mid-turn step, a tool output — and a floating Annotate button appears beside the selection. Each annotation pairs the quoted passage with your note and is staged as a numbered card above the composer: aligned, editable, removable. Send them all at once: the plugin composes your draft plus every annotation into one structured message for the agent.

Features

• Selection floating trigger — select any text in the chat flow and an Annotate chip pops up next to it; the quote is the selected passage.
• Per-message action — every finalized assistant message also gets an Annotate icon in its action row (next to like/dislike); without a selection it annotates the whole message.
• Annotation dock above the composer — numbered cards (Annotation 1, Annotation 2, …) each pairing the quote with an editable note; per-card remove, clear all.
• Collapsible strip — many annotations collapse into a single chip row (hover a chip to preview, click × to remove), with Send still one click away.
• Aligned send — Send annotations composes the draft plus all annotations into one message, each quote block aligned with its note; Insert into draft only stages the composed text for your review.
• Bilingual UI (zh/en follows the shell locale), theme-token styling (fits light/dark and glass themes).

Install

Declares the official dsh.bundle manifest — one command installs and enables it:

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

Then restart dsh and reload the Web UI.

Manual install (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

then append to ~/.dsh/profiles/web/cordis.patch.yml:

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

Outbound format

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

Build

The repo ships prebuilt lib/ artifacts; rebuilding needs only node + esbuild
(see build.mjs for how esbuild is located, or set DSH_ESBUILD):

node build.mjs

How it works

Pure client plugin (no host changes): the per-message entry registers into
conversation.chat.assistant-actions, the dock into conversation.input.dock,
and both share one per-session controller; the floating trigger is a
document-level selection watcher. Sending rides the public input machine
(inputActions.setDraft + submit).

Known limitations

• The action-row button appears only on each turn's closing message (a slot constraint); use the selection trigger for mid-turn steps.
• Staged annotations are in-memory per session — a page reload drops them (sent messages are unaffected).

License

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 的收尾消息上（插槽固有约束）；批注中间步骤请用划词浮动按钮。
• 暂存批注为会话内内存态，刷新页面即丢失（已发送内容不受影响）。