前言¶
在 DeepSeek Harness（DSH）里和 Agent 协作写 PRD、调研或方案时，审阅 Markdown 往往要不断在「预览」和「对话框」之间切换：选中原文、复制、粘贴、写意见，再回来继续读。意见一多，来回操作会挤占真正审阅的时间。
dsh-md-review 是 DSH 的 Web 客户端插件，把批注留在右侧栏的文档预览里，最后把多条意见合并成一条结构化消息发给当前会话的 Agent。下面按定位、功能、安装与用法说明。
这是什么¶
- 名称：
dsh-md-review（仓库 Sara-Chen111/dsh-md-review） - 维护者：Sara-Chen111（Sara Chen）
- 分类：客户端（
dsh.client.platform: web） - 版本 / 许可证：1.0.0，MIT
- 目录页：skillhub.cn 插件条目
插件在右侧栏打开 .md 等文档预览时提供「批注视图」（Review view）：选中文字写修改意见，原文高亮并带编号，右侧列出批注卡片；确认后可一次性发送到对话。内置的 Markdown / Code / Plain text 查看器仍可通过预览右上角「打开方式」切回，插件不接管全部预览能力。
核心功能¶
以下能力均来自仓库 README 与 package.json 说明。
- 就地批注：在预览正文选中文字，点浮层「添加批注」，无需离开文档。
- 可视化跟踪：已批注原文为琥珀色高亮，行尾有编号；右侧批注栏显示全部意见卡片；点卡片可跳回原文，支持编辑、删除。
- 统一发送：批注栏底部可写整份文档的补充说明；「发送到对话」将未发送批注合并为一条消息（含文件名、路径、行号、章节与原文引用）；也可「仅填入对话」，先在输入框修改再发。发送后标记「已发送」，可「清除已发送」归档。
- 本地持久化：批注存在浏览器
localStorage，刷新或重新打开同一文件可恢复；Agent 改稿后按「引文 + 前后文」重定位，行号与章节会更新，定位失败则显示「原文已修改」。 - 会话维度：批注按「文件 + 会话」保存（预览 resource address 含会话 id）；同一会话内同一文件会恢复批注，换会话则为独立一份。
- 发送依赖：通过会话输入区的
inputActions（标准 slot props）发消息，仅在右侧栏文档预览场景内生效。
环境要求（README 写明）：
- 运行环境：DeepSeek Harness Desktop 或
dsh web；作者在0.2.2-rc.1、2026-11 验证过。 - 浏览器：需支持 CSS Custom Highlight API（Chrome / Edge / Safari 17+）。
安装与启用¶
安装前请自行查看仓库源码与 MIT 许可证。插件以后台与 Web 客户端形式接入 DSH，与 DSH 当前进程权限一致，只应从可信来源安装。
从 GitHub 安装（README 推荐）¶
在 DSH Plugins → Add plugin 中粘贴：
github:Sara-Chen111/dsh-md-review
或在命令行执行：
dsh plugin add github:Sara-Chen111/dsh-md-review
安装完成后刷新 DSH Web 页面。右侧栏打开任意 .md 文件时，默认进入批注视图。
卸载¶
在 Plugins 页面移除该插件，或使用插件管理器：
plugin_manager action=remove_bundle target=dsh-md-review
README 另提供「克隆仓库后本地 install_bundle」方式，路径需为绝对路径；若你采用该方式，按 README「安装 → 方式二」操作即可。
典型用法¶
按 README「使用」一节，可复现的流程如下：
- 在右侧栏打开任意
.md文件。 - 选中正文一段文字 → 点击「添加批注」→ 填写修改意见 → 保存（
⌘Enter）。 - 重复添加多条批注；必要时在批注栏底部输入框写整份文档的补充说明。
- 点击「发送到对话」，将未发送批注合并为一条消息发到当前会话。
- 发送后批注变为「已发送」；需要时用「清除已发送」归档。
Agent 收到的是结构化单条消息，便于按文件、行号与引用逐条处理。
适用场景与注意¶
适合谁
- 经常在 DSH 右侧栏预览 Markdown，并需要把多条审阅意见一次性交给 Agent 的开发者或写作者。
- 希望批注留在文档上下文中核对，而不是在聊天里零散粘贴引文的协作流程。
使用前须知
- 批注仅保存在当前浏览器
localStorage，不跨设备同步；清理浏览器数据会丢失。 - 超大文件依赖预览分页加载，需滚动加载全文（与内置预览一致）。
- 若整段引文被 Agent 删除，对应批注会显示「原文已修改」，可手动删除或重新选段引用。
- 社区目录 skillhub.cn 与 DeepSeek / 幻方无官方从属关系；DSH 生态以「一切皆插件」为思路，本插件为社区维护的客户端扩展。
结尾¶
dsh-md-review 把「读文档 → 留意见 → 发给 Agent」收拢在右侧栏预览内，减少复制粘贴与会话切换。需要安装规格与开发说明时，以 GitHub 仓库为准：
- 目录页：https://www.skillhub.cn/plugins/Sara-Chen111/dsh-md-review
- 源码与 README：https://github.com/Sara-Chen111/dsh-md-review
