残疾人就业保障金申报核对（免费版）
完全本地运行：引擎已经打包在本技能里（
engine/目录）。 核对过程不需要联网、不需要 API Key、没有调用次数上限。
什么时候用
谁会在什么时候用：财务、税务岗在每年（部分地区按月或按季）申报缴纳残保金之前， 必须把这张申报表核一遍才敢提交 —— 算错就是多缴或漏缴，漏缴还有滞纳金。
为什么容易错：这张表是三条串行算式，再叠上免征与分档减缴的条件：
- 应安排残疾人就业人数 = 上年在职职工人数 × 规定比例
- 应缴金额 = （应安排人数 − 实际安排人数）× 上年在职职工年平均工资（负数按 0）
- 已缴金额与应缴金额的差异（多缴还是少缴）
第一条错，整行的应缴金额都跟着错；安排人数达标时差额为负，要按 0 填而不是填负数。 纯算术，但人眼一多就错。
不与已有能力重复：本工具核的是残保金申报表本身的口径与算术； 发票合规、工资个税、社保公积金归集都不是它做的事（见下面的边界）。
这个免费版查什么
- 应安排残疾人就业人数勾稽（上年在职职工人数 × 规定比例）
- 应缴金额勾稽（（表内应安排人数 − 实际安排人数）× 上年在职职工年平均工资，负数按 0）
- 已缴金额与应缴金额差异勾稽（多缴 / 少缴）
- 合计行逐列复核（每一列的合计是否等于各明细行之和）
- 同一所属期重复行检测
- 关键字段空缺与占位符检测
跑 node scripts/run.mjs --sample 会打印本次实际执行的检查项（以引擎的 CHECKS_* 导出为准）。
每条结论都带原文行号与出处，可被第三方用同一口径复算；
材料不足时不给结论，会明确列出还缺什么。
口径（算术依据，第三方按这个复算）
- 规定比例既认小数也认百分数：不超过 0.2 按小数比例（0.015 等于 1.5%），否则按百分数（1.5 等于 1.5%）；
- 应安排人数默认不取整（按比例算出的精确值）；各地取整口径不同，可在入参里用 should_rounding 指定 四舍五入到人（round）、向上取整到人（ceil）、向下取整到人（floor）；
- 应缴金额用表内已填的应安排人数当乘数（应安排人数本身由第 1 项单独复算），负数按 0；
- 已缴与应缴按表内「应缴金额」列比较（减免后的实缴口径属于完整档的事）。
怎么用
node scripts/run.mjs --sample # 先看样例
node scripts/run.mjs --input templates/sample.json # 跑自己的材料
入参是 JSON，text 里放从 Excel 复制出来的表头 + 明细（Tab 分隔最稳）。
需要的表头：所属期、上年在职职工人数、规定比例、上年在职职工年平均工资、
应安排残疾人就业人数、实际安排残疾人就业人数、应缴金额、已缴金额。
可选表头：减免金额、持证残疾人数、一年以上劳动合同人数、工资总额。
常见错法（这张表里真的会有人这么填）
- 上年在职职工人数填成期末在册人数。口径是上年的年平均人数；填期末数会让人数、应安排人数、应缴金额一路偏。
- 年平均工资用当年数据或月工资乘 12。要的是上年在职职工年平均工资，与在职人数、工资总额同属上一年口径。
- 规定比例一行写 1.5%、另一行写 0.015。本工具两种都认，但同一张表混用两份口径最容易把自己绕晕，全表只用一种写法。
- 安排人数已达标时把应缴金额填成负数。差额为负表示不需要缴，应缴金额按 0 填，不要填负数。
- 已缴金额与应缴金额对不上，就去改应缴金额把差异平掉。差异是结论不是错误，先查缴款凭证与减免，再动数字。
- 合计行只改明细不加合计（或只改合计不改明细）。逐列勾稽一下，几秒钟的事，漏一次就要退回重报。
- 同一所属期重复列了两行（例如总分公司各一行却没标明），合计行再统计一遍就翻倍。
- 关键格留空或写"待填"。缺一格这一行的应缴金额就算不出来，本工具不会用 0 或默认值替你填。
需要完整档时（可选）
本免费版是完整可用的核心产出，本版本不包含下面这些项：
- 免征条件判定（上年在职职工人数不超过输入给出的免征人数上限时，仍申报缴纳的部分）
- 分档减缴档位与减缴金额核对（按输入给出的档位表算档位与减缴额）
- 安排残疾人就业人数与残疾人证 / 一年以上劳动合同材料缺口
- 上年在职职工人数与年平均工资口径复核（工资总额 ÷ 人数、与输入最低工资比较）
- 多缴可退与少缴需补缴金额清单（按金额从大到小排）
同名工具的完整档是另一个独立商品（条款与条件以它自己的商品页为准）；两档的差别就是上面这些，没有别的。
边界（请务必知道）
本工具不做引擎 CHECKS_OUT_OF_SCOPE 里列的那些判断：不给税务意见、不做缴纳筹划、
不查证或套用任何地区政策参数（规定比例、免征人数上限、分档减缴档位、最低工资都由输入提供）、
不判断残疾人证真伪与劳动合同效力、不读 .xlsx。
材料不足时不给结论，也不会输出「未发现问题」。