前言¶
在 DeepSeek Harness(DSH)里和助手对话时,经常需要针对某一段回复追问或纠错:如果只写「上面第二段不对」,模型往往不知道你指的是哪一句。把原文复制进输入框可以定位,但长回复里反复复制既打断思路,也容易漏掉上下文。
Codex 类产品里常见做法是:在回复里选中一段文字,挂上注释,再连同正文一起发送。DSH 社区里已有面向同类交互的插件思路;dsh-plugin-annotate 在 mar1259 的 dsh-plugin-codex-annotate(MIT)基础上,针对 DSH 桌面客户端(Electron)做了包名、发送流程和气泡展示等适配。下面介绍它是什么、怎么装、怎么用,以及使用时需要留意的限制。
这是什么¶
dsh-plugin-annotate 是 DSH 的客户端插件,维护者为 starash07,仓库地址:github.com/starash07/dsh-plugin-annotate。它在助手回复里提供「划词 → 写注释 → 随消息发送」的流程:选中文字后通过右键菜单添加注释,发送时注释会拼进消息,气泡里以胶囊、小号注释、细线与正文分栏显示。当前版本在 package.json 中为 1.0.0,许可证 MIT。
插件分类属于客户端侧能力,主要在桌面 profile 下验证;README 也说明可在 dsh web 环境安装,但交互以桌面端为主。
与上游 fork 的主要改动¶
了解这些差异有助于判断你是否从原版迁移,以及为何需要单独安装本仓库:
- 包名与模块 id 从
dsh-plugin-codex-annotate改为dsh-plugin-annotate。README 指出:原包名在桌面 profile 下客户端模块可能无法注册(宿主显示已启用但插槽为空),换名后同类逻辑可正常加载。 - 发送行为:拦截输入框 Enter 与主发送按钮,发送前自动拼入引用,无需再在胶囊面板里单独点「发送」。
- 消息结构:引用块放在消息最前,对话正文在后。
- 气泡渲染:用户气泡显示为
[❝ N 条注释]胶囊(可展开原文定位信息)、小号斜体注释、细线、正文;注释与正文之间用不可见分隔符 U+2063 切分,发给模型的仍是普通文本排版。 - 清单精简:移除了
dsh.client.inject/immediately声明;exports仅保留"."、"./client"与"./package.json",避免多余导出导致桌面端加载器不注册模块。
安装与启用¶
要求:DeepSeek Harness 桌面客户端(README 亦提到 dsh web,但以桌面端验证为主)。
在 desktop profile 下执行官方 README 中的安装命令:
dsh plugin --profile desktop add github:starash07/dsh-plugin-annotate
安装完成后重启桌面客户端。卸载:
dsh plugin --profile desktop remove dsh-plugin-annotate
社区目录页(与 DeepSeek / 幻方无官方从属关系,仅为独立插件站点):skillhub.cn/plugins/starash07/dsh-plugin-annotate。
典型用法¶
按 README 的可复现步骤操作即可:
- 在助手回复里选中一段文字。
- 右键选择「❝ 在此回答」。
- 在弹窗中写下注释,回车确认(弹窗内回车只确认注释,不会发送整条消息)。
- 输入框旁出现
📎 N 条注释胶囊;可继续划词累积多条。 - 在输入框正常输入正文,按 Enter 或点击发送按钮 —— 注释会随消息一起发出。
点击胶囊可展开当时引用的原文,包含消息 id、轮次、段落与字符区间等信息。README 中附有界面示意截图,可在 GitHub 仓库 README 查看。
适用场景与注意¶
适合谁:需要在 DSH 桌面端对助手回复做「点对点」追问、修订说明或带引用上下文的补充,且希望发送流程与平时打字发送一致的用户。
运行与信任:插件以当前 DSH 进程的权限在客户端运行,会依赖页面 DOM 结构(如 data-chat-flow-kind、data-composer-card、发送按钮与气泡文本节点)。安装前建议阅读仓库源码与 MIT 许可证,确认符合你的使用与合规要求。
已知限制(均来自 README):
- DSH 升级后 DOM 变化可能导致插件需要再适配。
- 气泡分栏是显示层后处理;模型侧看到的是文本引用块,不是胶囊 UI。
- 逐条删除注释不如原版列表方便,因为注释已写入消息正文。
- README 写明仅在 DSH 0.2.1-rc.2 桌面端(Electron 44)验证;其他版本行为需自行验证。
- 切勿在
package.json的exports中增加例如"./locale/*.json"、"./icon"等额外入口,否则桌面端可能出现「已启用但客户端插槽未注册」的问题。
结尾¶
dsh-plugin-annotate 把 Codex 风格的划词引用回复接到 DSH 桌面客户端上,并在 fork 中理顺了桌面 profile 下的模块注册与发送链路。若你经常在长回复里针对局部内容追问,可以按 desktop profile 安装、重启客户端后,用右键「在此回答」累积注释再正常发送。