DSH Markup · 对话批注与文档审阅
包名：dsh-markup。原名 dsh-doc-review，从 0.2.0 起统一更名。
简体中文 · English
把模型的长回复当成一份稿子来审：原地批注、像读文档一样阅读、让 Agent 直接改正文。一个 DeepSeek Harness（dsh）插件。
中文简介： 为 DeepSeek Harness 的模型回复添加多处批注、文档阅读、评论线程和正文修订，并将阅读摘要带回主对话。
English summary: Review DeepSeek Harness responses with inline annotations, document reading, comment threads, and text revisions, then bring a reading summary back to the main conversation.
解决什么问题
模型给了一大段回复，你有好几处想说的：这句不对、那段太啰嗦、这里讲得好别动。平时只能在输入框里复制原文、写"第二段那句……"，一条一条描述位置，又累又容易漏；想就某一句追问，又怕把主对话带偏；模型改完之后，也看不出到底改了哪。
这个插件让你直接在回复上标注，然后一次性发回去；或者把回复打开成文档，边读边高亮、评论，让 Agent 在评论里回答、直接改正文。
能做什么
对话模式：原地批注，一次发回
对话模式批注
- 选中回复里的任意文字，弹出工具栏：评论（主操作）、认可、反对（一键，理由可选）。
- 批注以卡片形式显示在回复右侧，原文对应位置会被标出。
- 底部发送条选择发送方式：逐条回应（模型按编号逐条答复）或 出修订版（模型输出修改后的完整版本）。
- 发出的消息在对话里折叠成一张小卡片，不会刷屏；点开可以看全文。
文档模式：像读文档一样读回复
点回复下方的 以文档模式阅读，回复会在 dsh 里打开成一份文档，不跳转。
文档模式
- 高亮：标记讲得好的地方（再选中可以取消高亮）。
- 评论：评论以线程形式显示在右侧边栏。Agent 默认在线程里回复（开关会记住你的选择，也可以在评论里写 @Agent）。
- 直接改正文：在评论里说"帮我改简洁一点""删掉这句"，Agent 会直接修改文档，修改处会闪一下，随时可以撤销。
- 所有评论共享同一份上下文，Agent 知道你在别处问过什么。
- 右上角的评论面板可以按 未解决 / 已解决 查看全部评论。
读完带回主对话
退出文档模式时会问你要不要把这次阅读带回主会话：
带回主会话
选 带回主会话 后，阅读摘要（高亮、评论、讨论、修订后的全文）会作为参考材料附在输入框上方，随你的下一条消息一起发给 Agent：
摘要附在输入框上方
安装
需要 dsh 0.2.1-rc.3 或更新版本；当前验证版本为 0.2.1-rc.3。
桌面版推荐在 插件 → 添加插件 中输入 dsh-markup 安装，也可输入 GitHub 地址或本地 .tgz 完整路径。下方桌面 CLI 命令需要桌面版提供的命令行入口；若提示 desktop profile 由 Electron 管理，请使用应用内安装。
发布状态（2026-10-27）： 0.2.0 安装包已在 GitHub Release 发布；新 npm 包等待作者重新登录后发布，当前请使用下方 GitHub 或本地安装方式。
从 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
将 /path/to/ 替换为安装包所在目录的完整路径。
安装后重启桌面版（或刷新网页）。profile 名称以你本机为准，可以用 ls ~/.dsh/profiles 查看。
卸载：dsh plugin --profile desktop remove dsh-markup
0.2.0 更名与迁移
已安装旧包 dsh-doc-review 的用户，请在同一个 profile 中移除旧包，再安装新包，避免重复加载。桌面版可直接在「插件」页卸载旧包，再添加 dsh-markup；支持桌面管理的 CLI 或网页版也可使用下列命令：
# 桌面版；网页版请把 desktop 换成 web
dsh plugin --profile desktop remove dsh-doc-review
dsh plugin --profile desktop add dsh-markup@latest
然后完全退出并重新打开桌面版（网页版刷新）。请先安装新包再继续编辑；不要同时启用新旧两个包。
更名保留原有本地存储格式和引用标识。在同一 DSH profile、同一页面存储环境中，已有批注、高亮、评论、正文修订、设置和待发送阅读摘要可继续读取。卸载旧包不会清除这些记录；不要清空浏览器或应用数据。已发送的对话历史仍由 DSH 管理。
GitHub 仓库、安装包和文档统一使用 dsh-markup；旧 GitHub 地址保留重定向。旧 npm 包仅作为历史版本和迁移入口保留。
0.1.1 中的桌面拖动修复继续保留：批注浮层不覆盖原生拖动区域，文档模式顶部空白处可拖动窗口。
说明
- 文档模式里的 Agent 回复，来自从当前对话分出的一个临时会话（侧边栏会出现"文档模式 · …"），会正常消耗 token；退出文档模式后它会自动归档。
- 批注、高亮和评论保存在本机浏览器存储里，不会跨设备同步。
- 窗口较窄、回复右侧放不下卡片时，批注会收成编号标记，点击查看。
- 插件用到了 dsh 的一些内部接口，dsh 升级后如有异常，请更新插件或提 issue。
数据访问与模型调用
| 操作 | 读取、保存或发送的内容 |
|---|
| 选中文字、添加批注或高亮 | 读取当前回复及所选文字。批注、文档正文副本、评论、修订记录和相关设置保存在当前 DSH 页面环境的 localStorage 中；插件不提供跨设备同步。 |
| 点击「逐条回应」或「出修订版」 | 将选中文字、批注和整体意见与当前输入框草稿一起，通过 DSH 的正常消息发送流程提交给当前会话。 |
| 文档评论中请求 Agent 回复 | 首次请求时，从主对话分出一个临时会话，保留其对话上下文；发送当前文档全文、选中文字和评论，文档修改后会再次发送全文。调用使用 DSH 配置的模型服务，会消耗 token，可能产生费用。 |
| 关闭评论的 Agent 开关 | 当前评论暂不触发模型调用；输入 @Agent 仍会请求回复。之后在这份文档里请求 Agent 回复时，此前评论可能作为上下文一并发送。 |
| 选择「带回主会话」 | 将高亮和评论讨论附到输入框；正文被修订时还会附上修订后的全文。材料随下一条消息发送，发送前可移除。 |
| 退出文档模式 | 尝试停止并归档插件创建的临时会话；未完成归档的会话会在后续加载时重试。归档不等于删除历史记录。 |
插件代码不直接读写工作区文件，不要求单独填写 API Key，也没有自建的数据上传服务或分析埋点。文档模式通过 DSH 的正常会话运行，Agent 的可用工具与权限由宿主配置和授权流程控制；正文渲染使用 DSH 的 Markdown 组件，外部图片等资源仍可能产生网络请求。
卸载插件不会主动删除它已经保存在 localStorage 中的记录，也不会删除已经发送到 DSH 会话中的消息。对话批注可在发送前逐条删除或清空，待发送的阅读材料可从输入框移除；会话历史由 DSH 管理。
市场展示资料
仓库根目录的 screenshots.json 声明了 4 张演示截图及其展示顺序。中英文简介、兼容性信息和收录申请草稿见 市场投稿资料。
本地开发
使用 Node.js 20 或更新版本，在项目目录运行：
npm ci
npm run build
npm pack
npm pack 会先重新构建，确保安装包包含最新代码。
License
MIT
