检测样品流转与留样期限核对（免费版）

完全本地运行：引擎已经打包在本技能里（engine/ 目录）。 核对过程不需要联网、不需要 API Key、没有调用次数上限。

什么时候用

谁会在什么时候用：第三方检测机构 / 企业实验室的样品管理员、质量部（QA）、内审员， 在每个月固定的样品盘点与留样核对节点上，以及 CMA / CNAS 评审、飞行检查、内审前的自查时， 必须把当月的样品台账核一遍才能往下走。

为什么必须核：按 CMA、CNAS 与质量体系要求，样品要唯一标识、状态受控、留样到规定期限、到期处置有记录， 并且「收样 — 流转 — 检测 — 留样 — 处置」每个环节的数量都要对得上。 评审与飞行检查最常见的整改项就是这三条：

• 留样数量对不上：台账的「收样 / 已检 / 退样 / 留样」四列算不平，交接单与台账两边数量或编号不一致；
• 留样超期未处置：留样开始日期加期限早已到期，台账状态还挂在「留样」；
• 流转记录断档：同一委托同一检测项目重复登记、处置了却没有处置人和处置日期、状态长期不更新。

这张表具体会逐项核：样品数量勾稽、留样期限与应处置日期、交接单与台账一致性、重复登记、 合计行逐列复核、空白与格式与状态值校验。 每条结论都带原文行号与原文行内容，可被第三方用同一口径复算； 材料不足时不给结论，会明确列出还缺什么。

这个免费版查什么

免费版执行下面 6 项表内核对（就是引擎 CHECKS_GIVEN 里的 6 条）：

1. 样品数量勾稽 —— 逐行复算 收样数量 − 已检数量 − 退样数量 = 留样数量，差额不为零即列出并给出差额；
2. 留样期限核对 —— 留样开始日期 + 留样期限 = 应处置日期，用核对基准日给出超期天数；已处置的核对是否逾期处置；
3. 交接单与台账一致性 —— 「交接数量」对「收样数量」、「交接样品编号」对「样品编号」，不一致即给两处原文；
4. 同一委托编号 + 同一检测项目重复登记检测；
5. 合计行逐列复核 —— 数量类列（收样/已检/退样/留样/交接/处置）合计行与明细逐列相加比对；
6. 空白 / 占位符 / 日期格式 / 样品状态值非法检测 —— 含数量无法解析、数量为负、留样期限无法解析。

必需列（缺列只报「材料不足」，绝不给结论）： 样品编号、委托编号、样品名称、检测项目、收样日期、收样数量、已检数量、退样数量、留样数量、 留样开始日期、留样期限(天)、样品状态、处置日期、处置人。 另可带：委托单位、样品类型、检测标准、交接数量、交接样品编号、检测完成日期、承诺完成日期、处置数量、备注。

完整档追加的 5 项（本免费版不实现，只如实列出）：超期未处置清单、 处置记录与交接单不一致、样品状态与检测记录冲突、留样期限按样品类型/检测标准不一致、 分检测项目 × 分委托单位的超期汇总清单与 consolidated_actions。

怎么用

node scripts/run.mjs --sample                 # 先看样例
node scripts/run.mjs --input 你的材料.json     # 跑自己的材料

入参写法：{"text": "（把台账的**表头**和若干行一起从 Excel 复制进来，Tab 分隔最稳）"}。 核对基准日默认取表内事实日期（收样/留样开始/检测完成/处置）的最大值，也可以在入参里给 asOf（如 "2025-07-31"）指定。

常见错法（样品与留样管理岗位上最常踩的 5 个坑）

1. 把「退样」当成「已检」：退回委托方的样品没在「退样数量」里减出来，或者退样只在备注写一句 —— 收样 − 已检 − 退样 = 留样 永远差那几件。退样必须有退回回执并单独登记数量。
2. 留样开始日期填成收样日期，或者干脆空着：应处置日期是从留样入库那天起算的， 填成收样日期会让整列到期日提前，超期了也看不出来；空着则整行算不出应处置日期。
3. 同一委托下多件样品做同一检测项目时样品编号写重复（甚至直接把委托编号当样品编号） —— 会被判「同一委托同一项目重复登记」，检测数量虚增，评审时说不清到底检了几件。
4. 留样期限写成「按标准」「6 个月左右」「视情况」：算不出应处置日期，等于没有期限。 写月数要能折算成天（本工具按 30 天/月折算并在结论里写明），并且要在体系文件里把每个样品类型的期限定死。
5. 处置了只在备注写「已销毁」，不填处置日期与处置人；或者合计行是手工维护、补录新行后忘了重算合计 —— 前者让处置记录断档（缺责任人），后者让合计行与明细对不上，两条都是内审直接开不符合项的地方。

需要完整档时（可选）

本免费版是完整可用的核心产出，本版本不包含下面这些项：

• 超期未处置清单（应处置日期已过但仍为「留样」状态的样品，点名样品编号与超期天数，按超期天数排序）
• 处置记录与交接单不一致（处置数量 > 台账留样数量、已登记处置日期却缺处置人）
• 样品状态与检测记录冲突（已检但无检测完成日期 / 在检但已过承诺完成日期）
• 留样期限按样品类型/检测标准不一致（同类样品出现多个期限值，给两处原文）
• 分检测项目 × 分委托单位的超期汇总清单（按超期数量排序并给出可整改动作）与 consolidated_actions

同名工具的完整档是另一个独立商品（条款与条件以它自己的商品页为准）；两档的差别就是上面这些，没有别的。

边界（请务必知道）

本工具不做引擎 CHECKS_OUT_OF_SCOPE 里列的那些判断： 不判定样品是否合格、不判定检测结论是否成立、不替你认定「这类样品应该留多久」是否符合某部标准、 不判定留样室环境与样品唯一性标识体系是否达标、不读 .xlsx/.pdf 原件、核对过程不联网核验资质证书真伪。 材料不足时不给结论，也不会输出「未发现问题」。