--- description: "在 DSH 中阅读、批注与修改 Markdown 稿件,查看 AI 提案、逐词差异及相对上次审阅的累计变化。" kind: "package-bundle" --- # DSH Article Review [English](README.md) | 中文 在 [DSH](https://github.com/deepseek-ai/deepseek-harness) 对话旁读论文、写批注、与 AI 逐段修稿。AI 提交修改提案,你查看差异、接受、拒绝或要求重写。 经历多轮修改后,每段仍对照**你最后确认已审的版本**,待审变化一目了然。 ![查看 AI 提案的渲染效果与源码差异](docs/screenshots/review-proposal.png) *截图使用虚构稿件,含真实模型提案。* ## 核心功能 - **阅读批注**:高亮、下划线、评论与全文搜索。 - **AI 修稿**:替换、增删和重写提案,支持标题、列表、表格。 - **审阅进度**:标记、锁定已审段落,追踪后续变化。 - **版本对比**:逐词对比与 Markdown 源码差异。 - **图表审阅**:预览、提议换图,保留前后副本。 - **配套文档预览**:使用 DSH 原生预览打开 Markdown、PDF、Office 等文件,保留当前审稿状态。 - **文献管理**:绑定 BibTeX,定位引用,检查新增引用键。 ## 安装 支持 DSH Web `0.2.1-alpha.4` 和 Desktop `0.2.0-rc.2`,沿用现有模型配置。 ### Desktop App App 自带运行环境,无需另装 Node。 1. 在 App 左侧打开 **Plugins(插件)**,点击 **Add plugin(添加插件)**。 2. 粘贴 npm 包名及版本: `dsh-article-review@0.2.1-alpha.2` 3. 安装完成后点击 **Enable now(立即启用)**,按提示重启。 4. 选择本地工作区并打开一个对话,在右侧栏选择**阅读、批注与局部修改**。 5. 点击**浏览工作区 → 选择本地文件**打开 Markdown 稿件。系统选择窗口属于 App,文件必须位于当前对话工作区内。BibTeX 和替换图片也使用同一 Desktop 选择器。 Desktop 使用独立的 `desktop` 配置,安装到 `web` 不会同时安装到 App。若之前通过 GitHub 安装了旧包 `@deepseek-ai/dsh-experimental-paper-review`,先在 Plugins 中卸载旧包,再安装上述 npm 包并按提示重启;工作区中的 `.paper-review/` 审阅记录继续使用。macOS Desktop 已实测;Windows 要求见[支持范围与兼容性](docs/development.zh.md#scope-and-compatibility)。 可选择 npm 官方源或中国大陆镜像。镜像尚未同步新版本时,先切回官方源。GitHub 安装地址为 `github:Biogod2020/dsh-article-review#v0.2.1-alpha.2`。若 GitHub 地址连接超时,可下载[预构建发行归档](https://codeload.github.com/Biogod2020/dsh-article-review/tar.gz/refs/tags/v0.2.1-alpha.2),在 **Plugins → Add plugin** 中输入本地归档的绝对路径,无需解压或构建。`v0.2.1-alpha.1` 及更早 tag 保留旧包名,两种包名请选择一种安装。 ### Web 需要 Node.js 22(≥22.19)或 24+: ```sh dsh plugin --profile web add 'dsh-article-review@0.2.1-alpha.2' dsh web ``` 安装后重启正在运行的 Web 配置。GitHub 安装请使用预构建 tag;`main` 是开发源码。 ## 开始审阅 1. 在右侧栏选择**阅读、批注与局部修改**,打开 Markdown 稿件。 2. 选中文字添加批注,附到对话输入框,发送修改要求。 3. 在**审阅变更**中接受、拒绝或要求重写,检查后确认已审。 接受提案更新正文,保留已审基线。审阅记录位于 `.paper-review/`,随稿件备份,勿提交公开仓库。段落锁仅约束本插件。 ## 操作截图 选中文字,右键添加高亮或批注。 ![选区操作菜单](docs/screenshots/select-text.png) 保存批注,把修改要求附到对话。 ![批注与高亮](docs/screenshots/annotate.png) 查看已审进度,跳转章节与段落。 ![审阅进度与导航](docs/screenshots/review-outline.jpg) 比较两个版本,直接查看字词变化。 ![版本对比](docs/screenshots/versions-rendered.jpg) 预览 PDF、审阅换图、浏览文献。 ![PDF 预览](docs/screenshots/figure-pdf.jpg) ![换图前后对比](docs/screenshots/figure-replacement.jpg) ![文献浏览](docs/screenshots/references.jpg) 窄屏也能顺畅阅读。 窄屏阅读 ## 文档 - [使用指南](docs/user-guide.zh.md):操作与配置。 - [开发与兼容性](docs/development.zh.md):构建、工具与持久化。 编辑 Markdown 稿件,图表支持图片与 PDF。[其他格式与平台](docs/development.zh.md#scope-and-compatibility)。 [MIT 许可证](LICENSE)