前言¶
在使用 DeepSeek Harness (DSH) 进行对话时，经常需要对助手的回复内容进行即时批注，以便后续让模型针对特定片段进行回应。传统的批注方式往往需要在回复后手动复制粘贴或切换上下文，不够流畅。dsh-inline-comments 插件旨在解决这个问题，允许用户在对话流中直接选中文本并添加注释，发送时将这些批注与正文一起交给模型。
这是什么¶
该插件由 zenvertao 维护，属于「记忆」类别工具。它的核心逻辑是：在助手回复文本上选中内容，触发批注编辑器，保存后生成高亮与编号；发送对话时，批注内容会以特定格式（--- 分隔）置于正文之前，模型随后逐条回应。发送后批注自动清理。
核心功能¶
行内交互
选中助手回复文本，浮出「＋ 添加注释」按钮。点击后进入编辑器，回车保存，Shift+回车换行。
状态反馈
保存后，被批注文本高亮显示，右上角出现编号气泡。输入框上方出现「N 条注」胶囊。
胶囊管理
悬停胶囊可查看详情，支持删除单条或清空全部。
发送逻辑
发送时，批注区（格式包含 [i] 原文：… / 批注：…）置于正文之前，中间以 --- 分割，模型逐条回应。发送后自动清理批注。
持久化与清理
支持跨刷新持久化至宿主 JSON 文件（默认路径为 ~/.dsh/dsh-inline-comments.），浏览器 localStorage 仅作同页快速镜像。发送后自动清理，不留残留。
可靠性与兼容
记录选中文字前后的上下文，确保定位准确。若原文变动导致找不到，胶囊与详情会标出「原文已变」。支持多窗口/多端安全合并（按批注 id 合并，删除带时间戳）。
安装与启用¶
使用官方安装命令添加插件：
dsh plugin --profile web add dsh-inline-comments
典型用法¶
- 在助手回复里用鼠标选中一段文字。
- 点浮出的「＋ 添加注释」。
- 输入批注，回车保存。
- （可选）再选别的文字继续加；胶囊里可管理 / 删除。
- 直接回车（或点发送）——正文会带上批注，模型逐条回应。
适用场景与注意¶
该插件适合需要在对话流中即时标注上下文并传递给模型进行逐条回应的场景。使用时需注意：
- 插件面向最新版 DSH 开发，不追求兼容所有旧版本。
- 若接口取不到，会出现
[dsh-inline-comments]开头的告警。 - 测试基准为桌面版 0.1.7-rc.2。
插件遵循 MIT 许可证。
短结尾¶
dsh-inline-comments 解决了在对话流中即时标注上下文并传递给模型的需求。更多细节可查阅插件目录或源码。
