前言¶
化学类论文投稿前,正文与 Supplementary Information(SI)里的收率、ee/er、HRMS、核磁积分和谱图往往要逐项对照。人工翻页容易漏掉前后不一致的数值,图片是否重复使用也需要回到原图核对。DeepSeek Harness(DSH)允许在会话里挂载工作流类插件,把读取、复算和证据留存交给插件编排,研究者再逐项确认。
下面介绍维护者 zwx000908-dev 发布的 Paper–SI Audit(仓库 zwx000908-dev/dsh-paper-si-audit),其在社区目录中的分类为「工作流」。插件面向科研论文正文与 SI 的数据核对,支持自定义数值格式、图像与表格读取,以及 HRMS 理论 m/z 复算;论文原件以只读方式处理,结果可导出报告。
这是什么¶
dsh-paper-si-audit 是 DeepSeek Harness 插件,用于核对科研论文正文与 SI 中的数据,主要面向化学论文。它帮助查找前后不一致的数值、可疑的表征记录和需要复核的图片,并把问题对应到原文位置。你可以在 Harness 会话中直接说明要检查的内容;检查结果保留原文、计算过程和图片位置,便于逐项确认后导出报告。
核心功能¶
README 中列出的检查能力如下,均可在启用后按项目设置选择性打开。
- 正文与 SI 一致性:比较可识别的收率、ee/er 和部分实验条件,保留化合物、方法和条件等上下文,提示可能对应不上的记录。
- 数据格式:自定义小数位、有效数字、舍入方式和单位;例如分别设置 ¹H、¹³C 化学位移、偶合常数 J 和 HRMS 的小数位。
- HRMS:按分子式、同位素、加合物和电荷复算理论 m/z,检查文中 calculated 与 found 的偏差;分子式含义不清时列出不同解释。
- 核磁与分子式:检查氢积分、碳信号及标注碳数;可读取谱图中的明确标签与文字表征对照。
- 实验用量与收率:在条件明确时复算质量、物质的量、浓度和收率;需要假设时写明假设及缺少的信息。
- 图片重复:提取图片后由当前多模态模型查看原图、比较局部区域;程序相似度筛查仅作辅助线索。
- 表格与文字结论:读取文字表格,或由多模态模型查看图片表格;必要时用 OCR 辅助提取文字,核对明确的图表引用及部分表格结论。
- 化合物材料清单:按化合物整理表征文字和图片,对照你设置的材料清单,标出已找到、未找到或尚未读取的项。
- 修订复查:保留历史问题与处理意见,对修订稿重新核对,并将同类问题集中展示。
图片审核主要由多模态模型完成;OCR 只辅助提取文字,不单独判定重复或科学内容是否成立。整篇材料的图像准备、可选 OCR 和分批检查可中断后继续;报告支持 Markdown、JSON 和 CSV 导出。
当前 package.json 版本为 0.10.2(main 分支开发版);兼容 Harness 目标为 0.2.2-rc.1。
安装与启用¶
安装前请自行查看仓库源码与 MIT License。插件在 Harness 进程权限下运行,读取你配置的论文目录;导入的正文、图片等可能随当前会话模型配置进入宿主日志,具体取决于 Harness 设置。
环境要求:
- DeepSeek Harness 0.2.2-rc.1(兼容目标)
- 使用源码或命令行时需 Node.js 24.9.0 或以上
官方安装命令(安装到名为 paper-audit 的独立 profile):
dsh plugin --profile paper-audit add "github:zwx000908-dev/dsh-paper-si-audit#main"
若使用桌面版 Harness,需要在桌面版对应的 desktop profile 中安装并启用插件;安装到独立 profile 不会自动启用桌面会话。
安装后在 Harness 中启用插件组合包(bundle),填写保存目录与论文目录,再按宿主提示重新加载或重启。详细步骤见仓库内 Harness 安装与使用说明。
较早的 v0.2.0 安装包 仍可下载,但不包含后续加入的核磁—分子式核对、图片查重和新版设置等功能;需要这些能力时请使用 main 开发版。
基础设置¶
在 Harness 设置 → 论文核对 中先配置两个目录:
| 设置 | 含义 |
|---|---|
dataDir |
保存核对项目和报告的目录,例如 D:/PaperAudit/projects。 |
allowedRoots |
允许插件读取论文的目录,例如 D:/Research/manuscript;目录必须存在,留空时不能导入论文。 |
同一页面可设置新项目的默认选项:核对范围(全文或仅 SI)、检查项目(HRMS、核磁、实验复算、图片查重等)、格式要求(小数位或导入 JSON/YAML 模板)、容差与批处理数量、OCR 与报告格式等。全局默认值只影响新建项目;已有项目保留自己的设置,也可在会话中临时覆盖,例如:
把这个项目设为只核对 SI,HRMS 容差设为 3 ppm。报告中保留原文证据和图片对照。
模型由 Harness 会话选择,插件没有单独的模型账号或 API Key 设置。字段说明见 设置说明。
典型用法¶
启用插件后,在会话中提供正文和 SI 的文件路径,并说明检查范围。README 中的示例:
请使用 Paper–SI Audit 核对这篇论文的正文和 SI。先告诉我哪些内容能读取、哪些不能读取,再检查数据是否一致、HRMS 是否算对、核磁记录是否与分子式相容。按我提供的模板检查格式。把需要确认的问题、原文位置和计算依据一起列出,最后导出 Markdown 和 JSON 报告。
一次核对通常包括:导入材料(区分正文、SI 与其他文件)→ 确认读取情况与检查设置 → 运行检查 → 逐项复核 → 导出或针对修订稿复查。仅做 HRMS 复算时,也可直接给出分子式与离子形式,例如按中性分子式 C2H6O 和离子 [M+H]+ 复算理论 m/z。
专查 SI 图片重复时,README 建议明确让多模态模型逐对查看原图,不只看程序筛查结果,也不把 OCR 文字当作图片审核结论。视觉复核需要当前 Harness 模型支持图片输入;图片较多时按设置分批处理,可要求继续未完成部分。
支持的文件与使用注意¶
支持 DOCX、可检索文本的 PDF、TXT/Markdown、CSV、JSON、XLSX,以及 PNG、JPEG、单帧 TIFF、WebP、BMP 图像。DOCX/XLSX 上限 128 MiB,其他输入 32 MiB。原始文件只读,项目记录与报告写入 dataDir。
阅读报告时,先看检查范围,再看问题列表。「没有发现问题」仅适用于已读取并完成相应检查的部分。README 特别强调:图片查重程序与视觉模型在真实材料上的验证仍不完整;OCR 为本地英文模型,低清扫描与复杂版式易错;核磁计数不能单独断定结构错误;插件不完成谱图结构确证、全文图表引用或自动写回 Word。
详细限制与验证记录见仓库 docs/VALIDATION.md。
结尾¶
dsh-paper-si-audit 把化学论文正文与 SI 的多类核对(格式、HRMS、核磁、实验自洽、表格与图片)收敛到 Harness 工作流里,用可导出的证据报告支撑人工复核。DSH 生态主张「一切皆插件」;社区目录 skillhub.cn 为独立站点,与 DeepSeek / 幻方无官方从属关系。
- 目录页:https://www.skillhub.cn/plugins/zwx000908-dev/dsh-paper-si-audit
- GitHub:https://github.com/zwx000908-dev/dsh-paper-si-audit