dsh-doc-review

dsh-doc-review

简体中文 · 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。

从 npm 安装：

# 桌面版
dsh plugin --profile desktop add dsh-doc-review

# 网页版
dsh plugin --profile web add dsh-doc-review

也可以从 GitHub 安装：

# 桌面版
dsh plugin --profile desktop add github:nickzhangcomes/dsh-doc-review

# 网页版
dsh plugin --profile web add github:nickzhangcomes/dsh-doc-review

也可以从 Releases 下载 .tgz 安装包，再运行：

dsh plugin --profile desktop add file:/path/to/dsh-doc-review-0.1.1.tgz

将 /path/to/ 替换为安装包所在目录的完整路径。

安装后重启桌面版（或刷新网页）。profile 名称以你本机为准，可以用 ls ~/.dsh/profiles 查看。

卸载：dsh plugin --profile desktop remove dsh-doc-review

0.1.1 更新

• 修复安装插件后桌面窗口无法通过标题栏拖动、双击缩放的问题。批注浮层不再覆盖整扇窗口的原生拖动区域。
• 文档模式顶部空白区域也支持拖动窗口；按钮和正文仍可正常点击、选择。

已安装 0.1.0 的用户可以运行下面的命令，然后完全退出并重新打开桌面版：

dsh plugin --profile desktop add dsh-doc-review@latest

说明

• 文档模式里的 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