归档登记核对 PerryLink/dsh-archive-check

dsh-archive-check — 归档登记表完整性与保管期限检查

dsh-archive-check 读取一份归档登记表——表里有哪些条目、登记表带哪些列，再加上全宗和它覆盖的年度——然后检查登记表在机械层面能被追究的东西：每个条目是否带上了你配置的著录字段、档号在登记表内是否唯一、件号是否连续无缺号、保管期限是否用了你自己保管期限表里的术语、形成日期能否解析并与登记表年度一致，以及超过你配置的移交期限的条目是否被挑出来。

它能回答什么

| 你问 | 它回答 |
| 我没有配置任何必填著录字段。著录检查是不是就悄悄通过了？ | 不是。requiredFields 为空时，AR-001 会在 skipped 里报告自己，所以差异列表为空不会被读成「什么都不缺」。一旦你列出自己的列名，它就只检查每个条目的该字段是否已填——空字符串算未填——它不判断著录内容是否准确。 |
| 两个条目档号相同，但其中一个中间多了个空格。这还算重复吗？ | 算。AR-002 比较档号时忽略空白，所以「A-2026-001」和「A-2026- 001」算同一个号。它上限为 warn，因为它引用的条款把唯一性写成编制原则，而不是逐字禁止同一登记表内出现重复；命中通常意味着重复登记，或者档号打错了，还得人来确认。 |
| 保管期限列写的东西，我们的保管期限表里没有。检查会报什么？ | AR-003 把两种情况分开：解析器根本读不出保管期限术语的值（它认得「永久」「长期」「定期N年」和「N年」），以及能识别但不在你配置的 retentionTerms 列表里的术语。两者要改的地方不同，所以报成不同的消息。这条规则从不判定一份文件该定哪个保管期限，期限比国家框架更长也不算错误——本包引用的条款把企业数字定为下限。 |
| 件号是 1、2、4——缺的 3 会报出来吗？ | 会，但只针对纯数字写法的件号：AR-004 只对这些检查连续性；含字母或空格的件号不参与比较，完全不报差异。缺号本身不算缺陷——这个号可能只是没用——所以命中只是请你确认是否有条目漏登。checkSequence: false 时这条规则不运行。 |
| 形成日期写成「二〇二六年三月十五日」。这能读出来吗？ | 不能。AR-005 会报「无法解析」，这与年份和登记表年度不一致的日期是两条不同的消息——两者指向不同的修改。跨年度归档是允许的，这条规则不判定一份文件该归到哪个年度。 |
| 检查怎么知道该移交了？ | AR-007 会把每一条的 形成日期 和你配置的 transferAfterYears 做比较，只报告在你设定的年限下这个期限是否已经过了。这个参数默认是 0，表示没配置，所以在你设置之前，规则会把自己列进 skipped；如果开了 requireFormedAt: true，没有 形成日期 的条目会单独报出来，因为日期缺失就算不出到期日。规则不判断移交该提前还是延后。 |

遵循的标准

| 文件 | 编号 | 引用它的规则 |
| 《归档文件整理规则》 | DA/T 22—2015 | AR-001, AR-002, AR-004, AR-005, AR-006 |
| 《中华人民共和国档案法实施条例》 | 国务院令第772号 | AR-001, AR-003, AR-007 |
| 《机关文件材料归档范围和文书档案保管期限规定》 | 国家档案局令第8号 | AR-003 |
| 《企业文件材料归档范围和档案保管期限规定》 | 国家档案局令第10号 | AR-003 |
| 《中华人民共和国档案法》 | 2020年修订（主席令第四十七号） | AR-007 |

边界： 这个插件检查的是一份 归档登记表，只看登记表在机械层面能被追究的东西——每条描述得够不够完整、能不能归档后再次找到，档号 是否唯一，件号 是否连续无缺号，保管期限是否出自你的期限表，形成日期 能否解析、是否和登记表的年份对得上。它不判断某份文件该不该进档案，也不判断它该定多长的保管期限。那些是档案人员的判断。

⚠️ 这个插件拒绝做的三件事，以及为什么

1. 它绝不判断某份文件该定多长的保管期限。 没有一张全国统一的保管期限表可以直接套用。《档案法实施条例》第十九条第二款 和 国家档案局令第8号第十二条 要求每个机构自己编制 归档范围 和 保管期限表，并报档案 主管部门批准；国家档案局令第10号第十一条 又说企业的那套数字是下限——企业可以合法地选更长的期限。所以 AR-003 只检查措辞是不是你配置过的，并且有测试断言：规则包会说更长的期限「不算错误」。

2. 它把移交年限放在该放的地方。 20 年 / 10 年这两个数字在 《档案法实施条例》第二十条第二款，挂钩的是接收档案馆的级别，不是单位是不是企业。《档案法》第十五条 一个年限数字都没有——它只说「按照国家有关规定，定期」。把「满20年」安到档案法第十五条头上就是编造，有测试断言规则包不会这么干。

3. 它不用过时的第一条。 国家档案局令第8号 的 第一条 引的是 1999 年《档案法实施办法》，而 2024 年条例（国务院令第772号）已在 第五十二条 废止了它。规则包从不引用它，有测试断言这一点。

有两份清单是你的，不是法律定的：必填描述字段（AR-001）和你的保管期限词表（AR-003）。两者默认都是空的，清单没设的规则会把自己列进 skipped，而不是悄悄放过。

兼容性

| 层面 | 状态 |
| 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 |

它做什么

注册 archive_check 工具。它读取一个寄存器 —— 寄存器所携带的列、条目，加上它覆盖的全宗和年度 —— 应用一套带版本的规则包，返回一份报告。

| 规则 | 检查内容 | 严重级别 | 依据类型 |
| AR-001 | 每个条目都带有你要求的著录字段（默认关闭） | info | local |
| AR-002 | 档号在寄存器内唯一 | warn | principle |
| AR-003 | 保管期限使用你保管期限表里的术语（默认关闭） | info | local |
| AR-004 | 件号在寄存器内唯一且无断号 | warn | principle |
| AR-005 | 形成日期可解析，且年份与寄存器年度一致 | warn | principle |
| AR-006 | 寄存器声明了它的全宗和年度 | warn | principle |
| AR-007 | 条目超过你配置的移交期限（默认关闭） | info | local |

安装

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

配置

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

值得了解的规则级参数：

- AR-001 requiredFields —— 一行必须填写的列，例如 [档号, 题名, 保管期限, 责任者]。
留空表示该规则不运行。空白单元格算作未填写。
- AR-003 retentionTerms —— 你的保管期限表使用的术语，例如 [永久, 定期30年, 定期10年]。也可以在单次调用时传入，做一次性比对。
- AR-004 checkSequence —— 设为 false 可停止检查件号连续性。
- AR-006 requireHeader —— 如果你的寄存器本来就不带全宗或年度，设为 false。
- AR-007 transferAfterYears —— 你的档案馆的移交期限：中央 / 省级 / 副省级接收档案馆填 20，县级填 10（《档案法实施条例》第二十条第二款）。
0 表示该规则不运行。AR-007 requireFormedAt 让缺失形成日期列成为一条发现项，而不是跳过，因为没有它就算不出期限。

材料格式

工具接受 JSON 或 YAML：

fonds: 某单位 year: 2026 items:
- { 档号: A-2026-001, 题名: 关于第一项工作的通知, 保管期限: 永久, 形成日期: 2026-03-15, 件号: "1" }
- { 档号: A-2026-002, 题名: 关于第二项工作的通知, 保管期限: 定期30年, 形成日期: 2026-04-01, 件号: "2" }

列名从 档号/档案号、题名/文件题名/标题、保管期限/期限、形成日期/成文日期/日期、件号/序号 中识别。只给一串题名也可以——每个字符串会成为一条记录的题名。数字按字符串接受，所以表格导出不用清洗。

保管期限 有两种读法：永久/长期 表示永久，N年/定期N年/裸 N 表示固定期限。读不出来的期限会报为不可读，这和期限不在你配置的清单里是两回事——两者产生不同的发现项，因为需要不同的修法。

规则来源

规则数据放在 rules/archive-check.yaml。每条规则都带一份文件、一个文号、按来源自身编号的条款、一段逐字摘录，以及摘录读自哪个 URL。加载器会强制校验：摘录必须是至少八个字符的真实引文；依赖一般原则或本地政策的检查，永远不能定为 error。

引用的条款来自：

- 《中华人民共和国档案法》（2020-06-20 修订，主席令第四十七号，2021-01-01 施行）——第十三条至第十五条、第二十一条、第三十七条、第三十九条
- 《中华人民共和国档案法实施条例》（国务院令第772号，2024-01-12 公布，2024-03-01 施行；其第五十二条废止 1999 年《档案法实施办法》）——第十九条、第二十条、第二十四条、第三十九条、第四十条
- 《机关文件材料归档范围和文书档案保管期限规定》（国家档案局令第8号）——第三条、第四条、第六条、第十二条、第十四条
- 《企业文件材料归档范围和档案保管期限规定》（国家档案局令第10号）——第七条、第十一条、第十五条、第十六条
- 《归档文件整理规则》（DA/T 22—2015）——5.2.2、5.3.1、5.4.1、5.4.3 e)、5.5.2

有三处更正塑造了这套规则包，记录在其头部：

1. 法规被替换了。 国务院令第772号自 2024-03-01 起施行，废止 1999 年的实施办法，所以令第8号的第一条（引用已废止文本）从不引用。
2. 移交年限写在条例里，不在法律里。 第二十条第二款载有 20/10 年这两个数字，并把它们对应到接收档案馆的级别；《档案法》第十五条完全没有年限。
3. 不存在通用的保管期限表。 每个机构自行编制并各有获批的版本，企业的数字是法定下限，不是上限。

完整的条款核验报告，包括已核查并排除的来源，在 rules/evidence/clause-verification.md。

故障排查

- AR-001 和 AR-003 自报为跳过。 它们的清单是空的。AR-003 还可以按次传入，所以一次性比对不用改规则包。
- AR-004 什么都不报。 解析为纯整数的件号少于两个——字母数字编号被有意排除在连续性检查之外，而不是去猜。
- AR-005 在我能读出的日期上触发。 读取器接受 2026-03-15 和 2026-03-15 09:30；像 二〇二六年三月十五日 这样的中文数字日期会被有意报为无法解析，好让你决定是否规范化导出。
- 读取器拒绝了一份它以前接受的登记表。 它没找到任何已知的档案列；
- 报错信息会列出它看到的列名。
- 插件装上了，但工具一直不出现。 检查 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-archive-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, paired fixtures per rule
pnpm run build # tsdown -> lib/index.mjs + lib/index.d.mts
node ../scripts/sync-shared.mjs dsh-archive-check # refresh src/shared from ../_shared

许可证

Apache License 2.0 © 2026 dsh-archive-check contributors。