前言¶
在 DeepSeek Harness（DSH）里改方案文档，常见做法是：把段落复制到聊天窗口，下一行写修改建议，再发出去。上下文容易丢，批注和正文也拆在两处。@caihua/dsh-doc-review（仓库 caihua8669/dsh-doc-review）把这一步改成在文档上划词、旁侧写意见，批注落盘为 sidecar；Agent 通过 doc_review_* 等工具读批注改稿，并在界面上回标状态。维护者为 caihua8669，社区目录分类为工作流。
这是什么¶
DSH 文档批注台是 DSH 桌面端（或任意 profile）上的插件包 @caihua/dsh-doc-review（当前资料中版本为 1.0.0）。它在会话页顶部页签栏增加「批注」，与「对话轨迹」「上下文」「白板看板」并列；同时在正常对话里支持对消息选区做会话批注。批注与改动提案写在文档旁的 .dsh-review/ 或本机 ~/.dsh/doc-review/ 下，不依赖把全文贴进输入框。
核心功能¶
文档批注三栏界面¶
左栏按优先级列出 Markdown 文档，可在目录树与平铺视图间切换；范围默认「相关」（本会话产出/编辑过的文档，以及同工作区最近若干会话碰过的文档），也可切到「工作区」或配置 roots 下的「全库」。中栏渲染 Markdown，选中文字弹出批注框，Ctrl+Enter（Mac 为 ⌘↩）保存。右栏为飞书式批注卡片，支持回复串、已处理折叠、与正文双向联动（CSS Custom Highlight 锚到划词原文）。
建议模式与待审改动¶
改稿默认走建议模式：Agent 用 doc_change_propose 登记改动（quote 原文、after 新文、note 说明），写入 <文档目录>/.dsh-review/<文件名>.proposals.json，登记时不改源文件。用户在「待审改动」面板逐条接受或拒绝；接受时才按 quote 重新定位并写盘。正文可显示红/绿内联预览与就地接受/拒绝按钮。
会话内划词批注¶
在对话界面选中文字，旁侧工具条可「批注」「复制」或使用划词提示词。会话批注落盘在 ~/.dsh/doc-review/session-notes/<sessionId>.json，由 session_note_list / session_note_resolve 供 Agent 读取与回标。保存后可把批注块追加进当前会话输入框草稿（【批注 · 请逐条回应】…【批注结束】），便于攒多条后一次发送；输入框处于斜杠命令时不改写草稿。
Sidecar 与 MRSF¶
结构化真源为：
<文档目录>/.dsh-review/<文件名>.review.json
<文档目录>/.dsh-review/<文件名>.review.md
.review.json 对齐 MRSF v1.0（Markdown Review Sidecar Format），selected_text 为权威锚点且不改写；文档变更后按 MRSF §7.4 重锚，失败则标「已失锚」并保留条目。
Agent 工具与 /doc-review 技能¶
| 工具 | 用途 |
|---|---|
doc_review_list |
读单篇或巡检带批注的文档 |
doc_review_resolve / doc_review_reopen |
标记已处理或退回 |
doc_review_reply |
在回复串追加 AI 说明 |
doc_change_propose / doc_change_list / doc_change_decide |
建议模式：提案、列表、接受/拒绝 |
session_note_list / session_note_resolve |
会话批注读与回标 |
安装时会在 ~/.dsh/skills/doc-review/SKILL.md 落技能文件，可用 /doc-review 调用；另有 doc_review_history、doc_review_mine_candidates、doc_review_rules_*、doc_review_preview_apply 等，用于从历史批注提炼规则并对新文档做预审（规则库初始为空，由用户批注沉淀）。
交给 AI 改稿¶
「批注」页可将待处理批注组装为指令，通过 remote.session.prompt 排队到当前会话，或使用「复制指令」进剪贴板。装好后可用 GET http://127.0.0.1:19387/api/dsh-doc-review/ping 确认宿主侧已挂上。
安装与启用¶
要求：DSH 桌面端（或目标 profile）+ Node 20 以上；仓库自带可运行的 lib，无需本地构建。
桌面端自带 CLI 安装示例（profile 换成你正在用的，桌面端通常为 desktop）：
dsh plugin --profile desktop add github:caihua8669/dsh-doc-review
装完后刷新页面，确认会话页顶部出现「批注」页签；并检查该 profile 的 package.json 里 dependencies 与 dsh.profile.bundles 均包含 @caihua/dsh-doc-review，且上述 ping 接口有响应。
典型用法¶
- 安装插件并刷新 DSH，打开目标 Markdown，在「批注」页左栏选文档（或粘贴绝对路径打开）。
- 在中栏选中段落，填写意见并
Ctrl+Enter保存；右栏查看卡片，必要时在回复串中补充说明。 - 点击「交给 AI 改稿 (n)」或将会话批注区一键「交给 AI」，切回对话页让 Agent 处理；Agent 应优先用
doc_review_list读取结构化批注，改完后用doc_review_resolve回标，建议模式下用doc_change_propose与doc_change_decide配合用户待审。 - 若启用规则闭环，可通过
/doc-review与doc_review_preview_apply对新稿做预审，用户在批注页对命中项接受或拒绝，以更新规则统计。
适用场景与注意¶
适合在 DSH 内长期迭代方案稿、技术说明或交付文档的团队：批注与正文同屏、落盘可版本管理，且与 MRSF 生态字段兼容。会话批注适合对对话里的结论片段留意见，而不占用输入框粘贴全文。
插件以当前 DSH 进程权限读写工作区与本机 ~/.dsh 路径；安装前请阅读仓库源码与 MIT 许可证，确认路径与数据落盘位置符合你的安全策略。全库扫描等行为受配置项（如 roots、projectSessions）影响，以 README 与仓库配置为准。DSH 社区插件目录（SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
文档批注台把「复制段落 + 聊天里写建议」收成划词、sidecar 与 Agent 工具链上的闭环。目录页与源码：
- https://www.skillhub.cn/plugins/caihua8669/dsh-doc-review
- https://github.com/caihua8669/dsh-doc-review
