前言¶
在 DeepSeek Harness（dsh）里和 Agent 对话时，模型常会给出很长一段回复。若有多处要改、要追问、要保留不动，常见做法是在输入框里复制片段、用「第二段那句……」逐条描述位置，既费时又容易漏；想针对某一句深挖，又怕把主线程带偏；改完一轮后，也不容易对照到底改了哪里。
下面介绍的 dsh-markup（npm 包名 dsh-markup，原名 dsh-doc-review，自 0.2.0 起统一更名）是维护者 nickzhangcomes 发布的 客户端 插件：把模型回复当成稿子来审，支持原地批注、文档式阅读、评论线程与正文修订，并在退出文档模式时把阅读摘要带回主对话。仓库：github.com/nickzhangcomes/dsh-markup；社区目录页：skillhub.cn/plugins/nickzhangcomes/dsh-markup（独立站点，与 DeepSeek / 幻方无官方从属关系）。
这是什么¶
一句话定位：为 dsh 的模型回复增加 多处批注、文档阅读、评论对话、正文修订，并将 阅读摘要 附在下一条发往主会话的消息里。
插件不直接读写工作区文件，不要求单独填写 API Key，也没有自建数据上传服务；批注、高亮和评论保存在当前 DSH 页面环境的 localStorage 中，不会跨设备同步。文档模式里请求 Agent 时，会走 dsh 配置的模型服务并消耗 token。安装前建议自行查看源码与 MIT 许可证，确认与当前 dsh 版本及权限模型相符。
核心功能¶
对话模式：原地批注，一次发回¶
在回复里选中任意文字，会弹出工具栏：评论（主操作）、认可、反对（一键，理由可选）。批注以卡片形式显示在回复右侧，原文对应位置会被标出；窗口较窄、右侧放不下卡片时，会收成编号标记，点击查看。
底部发送条可选择：
- 逐条回应：模型按编号逐条答复。
- 出修订版：模型输出修改后的完整版本。
发出的消息在对话里折叠成一张小卡片，点开可看全文，避免刷屏。
文档模式：像读文档一样读回复¶
点回复下方的 以文档模式阅读，回复会在 dsh 内打开成一份文档，不跳转外部页面。
- 高亮：标记讲得好的段落；再次选中可取消。
- 评论：线程显示在右侧边栏。Agent 默认在线程里回复（选择会记住；也可在评论里写
@Agent）。 - 直接改正文：在评论里说明修改意图（例如改简洁、删某句），Agent 会直接改文档，修改处会闪一下，可随时 撤销。
- 评论共享同一份上下文；右上角面板可按 未解决 / 已解决 查看全部评论。
文档模式里的 Agent 回复来自从当前对话分出的 临时会话（侧边栏会出现「文档模式 · …」），会正常消耗 token；退出文档模式后会自动归档。
读完带回主对话¶
退出文档模式时可选择 带回主会话。选该项后，阅读摘要（高亮、评论、讨论、以及若有的修订后全文）会附在输入框上方，随你的下一条消息一起发给 Agent；发送前可移除其中材料。
安装与启用¶
需要 dsh 0.2.1-rc.3 或更新版本；README 中当前验证版本为 0.2.1-rc.3。桌面版可在 插件 → 添加插件 中输入 dsh-markup 安装，也可输入 GitHub 地址或本地 .tgz 完整路径。若 CLI 提示 desktop profile 由 Electron 管理，请改用应用内安装。
从 npm 安装：
# 桌面版
dsh plugin --profile desktop add dsh-markup
# 网页版
dsh plugin --profile web add dsh-markup
从 GitHub 安装：
# 桌面版
dsh plugin --profile desktop add github:nickzhangcomes/dsh-markup
# 网页版
dsh plugin --profile web add github:nickzhangcomes/dsh-markup
也可从 Releases 下载 .tgz，再执行（将路径换成本机完整路径）：
dsh plugin --profile desktop add file:/path/to/dsh-markup-0.2.0.tgz
安装后 重启桌面版（或刷新网页）。profile 名称以本机为准，可用 ls ~/.dsh/profiles 查看。
卸载示例：
dsh plugin --profile desktop remove dsh-markup
从 dsh-doc-review 迁移（0.2.0 更名）¶
若曾安装旧包 dsh-doc-review，请在同一 profile 中 先移除旧包再装新包，不要同时启用两个包：
# 桌面版；网页版请把 desktop 换成 web
dsh plugin --profile desktop remove dsh-doc-review
dsh plugin --profile desktop add dsh-markup@latest
然后完全退出并重新打开桌面版（网页版刷新）。同一 profile、同一页面存储下，已有批注、高亮、评论、修订与待发送摘要一般可继续读取；卸载旧包不会清除这些 localStorage 记录。
典型用法¶
审一篇长回复、多处意见一次发回
- 在对话里选中需要指出的句子，用评论 / 认可 / 反对添加批注。
- 在底部选择 逐条回应 或 出修订版，发送折叠卡片中的内容。
边读边改、再回主线程继续聊
- 点 以文档模式阅读。
- 高亮重点、在侧栏开评论；需要改稿时在评论里说明，或关闭 Agent 开关后仅用
@Agent触发。 - 退出时选 带回主会话，确认输入框上方的摘要，再发下一条主对话消息。
适用场景与注意¶
适合：技术方案审阅、长文润色、教学反馈、任何需要在 不离开当前 dsh 会话 的前提下对模型输出做结构化反馈的场景。
务必注意：
- 插件依赖 dsh 内部客户端接口；dsh 升级后如有异常，请更新插件或在 GitHub 提 issue。
- 文档模式与批注数据在 本机浏览器存储，换设备或清数据会丢失未同步的本地状态；已发送到 dsh 会话的消息仍由 DSH 管理。
- 插件以当前 dsh 进程及宿主配置的模型与工具权限运行；文档渲染使用 dsh 的 Markdown 组件，外部图片等资源仍可能产生网络请求。
当前 npm 版本为 0.2.0，许可证 MIT。
结尾¶
dsh-markup 把「对长回复的反馈」从输入框里的零散描述，变成 选中即批注 与 文档式线程讨论，并可选 带回主会话，减少漏项和主对话被带偏的成本。DSH 生态强调「一切皆插件」；若要安装或看更新说明，可打开 目录页 与 GitHub 仓库。
