审稿回复核对 PerryLink/dsh-review-reply-check

dsh-review-reply-check — 审稿意见回复表覆盖度与留痕检查

dsh-review-reply-check 读取一份审稿意见回复表——稿件表头加每条意见一行——检查这张表自身的覆盖度与留痕：每条意见的文本是否记录在案，每条带意见的行是否也带作者回复，回复是否写明做了什么修改、改在哪里，每个处理状态是否取自你配置的词表，回复日期是否落在表格自己声明的修回截止日期内，表头是否声明了稿件与审稿轮次，以及意见编号是否重复。

它能回答什么

| 你的疑问 | 它的回答 |
| 某行有作者回复，但放意见文本的单元格是空的。 | RR-001 要求每行都写意见文本：没有文本，回复就没有对象，编辑也看不出它在回应哪条意见。这条规则只检查单元格是否填了——不判断意见是否成立，也不判断它是否属于学术分歧。 |
| 意见记录了，但作者回复单元格还是空的——这会被报出来吗？ | 会。RR-002 要求每个意见单元格已填的行都要有回复，因为一条被沉默略过的意见，和一场审稿人可以权衡的分歧，不是一回事。它只检查回复单元格是否填了，不判断回复是否充分、是否有说服力；某条意见确实无需修改时，本插件建议在该单元格里写明理由，而不是留空。 |
| 回复说文本已修改，但修改说明和位置列都是空的。 | RR-003 要求每个 response 已填的行都要有 revision 和 revisionLocation。它检查这两个单元格是否写了，不检查改动是否真在它们所说的位置——插件看不到稿件，所以一条定位精确、却描述了从未做过的改动的修改说明，照样能通过。 |
| 每行都填了处理状态。工具怎么判断这个值能不能接受？ | RR-004 拿 status 列的值和你配置的清单比对。这份清单出厂时是空的，也就是未配置，所以在填好之前，这条规则会在 skipped 里报告自己，而不是悄悄通过。它只检查值是否在你的清单上，不判断某个状态是否意味着意见得到了妥善处理。作为一条机构配置类规则，它的严重级别上限是 info。 |
| 回复日期晚于截止日期列——这是否意味着返修逾期了？ | RR-005 拿 respondedAt 与表格自己写入的 dueAt 比较，命中只说明两者与你记录的期限不一致——并不说明返修迟了，因为期限因期刊而异，作者也可能申请延期。规则里没有内置任何天数，也不会替你推断：dueAt 为空时，规则在 skipped 里报告自身，而不是假定一个截止日期。 |
| 两位审稿人的意见合并到一张表里，两边都从 1 开始编号，于是某个意见编号出现了两次。 | RR-007 报告 commentNo 中的重复值，因为重复会让覆盖计数出错，也会破坏与审稿单的对应关系。把合并后的意见登记在带审稿人标识的编号下——R1-3、R2-1——就能保持唯一；规则按写下的编号比较，不会合并或重新编号任何内容。 |

遵循的标准

| 文件 | 编号 | 引用它的规则 |
| 《中国高校科技期刊编排规范》 | 现行版本与条号本次未核实 | RR-001, RR-002, RR-003, RR-006, RR-007 |
| 本期刊同行评议与返修规定（本机构配置） | 无统一标准（本条依据为本机构配置的状态口径） | RR-004 |
| 本期刊同行评议与返修规定（本机构配置） | 无统一标准（本条依据为台账写明的返修期限） | RR-005 |

边界： 本插件检查审稿意见逐条回应表的覆盖与证据——每条意见都已记录，每条意见都带有作者回应，回应写明所做的修改以及修改位置，处理状态取自你的词表，回复日期落在台账写明的返修期限内，表格写明稿件与审稿轮次，意见编号唯一。它不判断回应是否充分、返修是否到位、稿件是否应被录用。

⚠️ 本插件能看到什么、看不到什么

它永远看不到稿件。 它能检查回应是否写明修改位置——永远无法检查修改是否真的在那里，也永远无法检查它是否回应了意见。RR-003 的说明和疑难解答一节都讲了这一点：一份自信、定位精准、纯属虚构的返修说明能通过本插件。

「没有回应」与「有异议」之间的关系正是 RR-002 的要点：审稿人可以接受作者的异议，但不能接受一条被沉默略过的意见，所以覆盖是返修质量最直接的指标。规则因此会在回应单元格为空时触发——它的说明建议：当某条意见确实无需修改时，记录原因，而不是把单元格留空。

没有内置任何返修期限。 期限因期刊而异，作者也可能申请延期，所以 RR-005 拿回复日期与台账中写明的期限比较，该列为空时在 skipped 里报告自身。命中意味着「这与你的记录期限不一致」，绝不意味着「你迟了」。状态词表出于同样的原因出厂时为空。
规则包里的每一条 excerpt 都明说了：没有拿到条款原文。 这套规则出自 GB/T 7713.1，也就是中国高校学报编辑规范，以及各刊自己的同行评审规则。核查环节拿不到逐字条款原文，所以规则包直接在 excerpt 字段里写明这一缺口，并把所有规则都保持在 warn 或 info。拿到原文后，把每条 excerpt 换成真正的条款，再把 kind 提到 direct。

兼容性

| 层面 | 状态 |
| Harness | 对等版本范围 >=0.1.2-rc.1 <0.2.0 \|\| >=0.2.0-0 <0.3.0 —— 已验证可接受 0.2.0-rc.2 和 0.2.1-alpha.1。故意不声明 engines.dsh：它没有读取方，也无法拒绝宿主 |
| Node | ^22.19.0 || >=24.0.0 |
| 平台 | 全部（纯 ESM；无原生代码、无网络、不调用模型） |
| 工具模式 | 在 native、ptc 和 both 下都能用；要生成完整回复信请用 ptc |

功能

注册 review_reply_check 工具。它读取一张回复表——稿件抬头加每条意见一行——套用带版本的规则包，返回报告。

| 规则 | 检查内容 | 严重级别 | 依据类型 |
| RR-001 | 记录了意见原文 | warn | principle |
| RR-002 | 每条意见都有回复 | warn | principle |
| RR-003 | 回复写明修改内容及其位置 | warn | principle |
| RR-004 | 状态取自你的词表（默认关闭） | info | local |
| RR-005 | 回复日期落在记录的截止期限内 | info | local |
| RR-006 | 表格写明稿件编号与轮次 | warn | principle |
| RR-007 | 意见编号唯一 | warn | principle |

安装

dsh plugin --profile <name> add dsh-review-reply-check
dsh --profile <name> --dump-config | grep 'dsh-review-reply-check'

配置

| 键 | 类型 | 默认值 | 说明 |
| rulesFile | string | rules/review-reply-check.yaml | 规则包路径，相对于包根目录 |
| disabledRules | string[] | [] | 停止运行的规则 id；每条都会出现在 skipped 里 |
| onlyRules | string[] | [] | 只运行这些规则 id；留空则运行全部规则 |
| skipNotes | string | "" | 附加到每条 skipped 原因后的备注 |
| timeoutMs | number | 120000 | 协作式工具超时预算 |

几个值得了解的规则级参数：

- RR-004 的 values —— 你的状态词表，例如 [已修改, 部分修改, 不修改并说明理由, 已删除]。留空表示不检查。
- RR-005 读取登记表的 返修期限 / dueAt 列。插件绝不会按天数推算截止期限。
- RR-002 和 RR-003 用 conditionField / requiredFields —— 决定什么情况触发对应要求。
- RR-007 以意见编号列为键。多位审稿人的意见合并后，按审稿人分别编号（R1-3、R2-1），规则才能区分开。

材料格式

工具接受 JSON 或 YAML：

manuscriptNo: XYZ-2026-0186
title: 某某研究 journal: 某某学报 round: 第 1 轮 dueAt: 2026-05-10 rows:
- { 序号: R1-1, 审稿人: 审稿人一, 意见类型: 方法, 指向位置: 第 3 节 3.2,
审稿意见: 3.2 节的样本量未说明估算依据，请补充。, 作者回应: 同意补充。已在 3.2 节末增加样本量估算说明，并引用既往研究作为依据。, 修改说明: 新增一段样本量估算依据，引用两项既往研究并给出效应量假设。, 修改位置: 第 8 页第 12—18 行（修订稿 3.2 节末）, 处理状态: 已修改, 回应人: 通讯作者, 回应日期: 2026-05-06 }

列名匹配不区分大小写，并忽略空格、下划线和连字符；表格自身的列名会保留，所以每条发现都会指明它读取的是哪一列。

规则来源

规则数据放在 rules/review-reply-check.yaml。规则包的头部完整说明了引文缺口，每条规则的 note 会重复该规则相关的部分。加载时的守卫通常强制要求「引文必须是至少八个字符的真实引用」，但它分不清引用和描述——所以这个规则包靠头部、每条规则的 note，以及一个断言每条 excerpt 都承认该缺口的测试来兜底。

疑难排查

- RR-003 放过了一条描述从未做过的修改的修改说明。 它只检查位置有没有写明，从不检查改动是否真的在那里。要比对就得看稿件，而插件看不到稿件。
- RR-002 对我选择不处理的意见报错。 把理由写进回应单元格。审稿人能接受有理有据的不同意见；空着单元格会被读成「未处理」。
- RR-005 报告自己被跳过。 登记表里没有记录修改截止日期，插件不会凭空编一个。
- RR-004 从不运行。 它的词表是空的；用你期刊的状态填满它。
- RR-007 对不同审稿人的意见报错。 按审稿人分别编号，合并后的表格才不会产生歧义。
- 插件装上了，工具却一直不出现。 检查 main 是否指向 lib/index.mjs，以及 pnpm run build 是否生成了它；main 写错会让加载器静默跳过入口。
- dsh plugin add 以不兼容为由拒绝该包。 peer 范围覆盖 0.1.x 和 0.2.x；如果你的运行时不在其中，显式授予豁免： dsh plugin --profile <name> allow-version dsh-review-reply-check@0.1.0 --dsh-version <runtime> --accept-risk
- check 报告 manifest-peers 失败。 静态检查器比对的是一个硬编码的 peer 范围，它早于 0.2 系列。运行时会在安装时强制校验 peer 兼容性，所以声明的范围才是正确的；这是 dsh-plugin-dev 里已知的上游问题。

开发

pnpm install
pnpm run typecheck # tsc --noEmit
pnpm test # vitest, the shared table-plugin suite plus paired fixtures
pnpm run build # tsdown -> lib/index.mjs + lib/index.d.mts
node ../scripts/sync-shared.mjs dsh-review-reply-check # refresh src/shared from ../_shared

这个插件是纯数据的：src/model.ts 声明表格结构，共享工具包提供读取器和检查引擎，规则包声明每一项检查。

License

Apache License 2.0 © 2026 dsh-review-reply-check 贡献者。