货运险投保与货损理赔核对（免费版）

货运险投保与货损理赔台账逐票复算（保费=投保金额×费率、应赔金额=定损金额−免赔额、理赔差额=应赔−实收、投保比例=投保金额÷货值，外加同一保单号重复、关键字段空缺与金额负值、合计行复核），每条结论引用原文行号。本免费版执行引擎自己声明的免费检查项。触发词包括 货运险核对、货运险台账、货损理赔、理赔差额对不上、投保比例不对、保费算错。

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

什么时候用

谁会在什么时候用：物流公司、货代、外贸企业的商务或财务，每月与保险对账时， 以及每一次货损索赔立案与赔款到账时，都要把货运险台账核一遍。

为什么非核不可：这张表是几条纯算术关系串起来的 —— 保费 = 投保金额 × 费率；应赔金额 = 定损金额 − 免赔额（负按 0）；理赔差额 = 应赔 − 实收； 投保比例 = 投保金额 ÷ 货值。任意一条填错，当期就少收赔款或多付保费。

这个免费版逐票复算什么（检查项由引擎的 CHECKS_GIVEN 导出，跑 --sample 会打印）：

• 保费 = 投保金额 × 费率
• 应赔金额 = 定损金额 − 免赔额（负数按 0）
• 理赔差额 = 应赔金额 − 实收理赔款
• 投保比例 = 投保金额 ÷ 货值
• 同一保单号重复检测
• 关键字段空缺、占位符与金额负值检测
• 合计行逐列复核（每一列的合计是否等于各行之和）

每条结论都带原文行号，可被第三方用同一份输入复算； 材料不足时不给结论，会明确列出还缺什么。

怎么用

bash

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

入参就是一张含表头的台账（Tab 分隔最稳），可以写成 {"text": "…"} 的 JSON， 也可以直接把 Excel 里复制出来的文本存成文件。表头要能认出上面那几列； 认不出来时本工具只报缺哪列，不给任何结论。

常见错法（这张表里真的会有人这么填）

1. 费率填成万分号口径：保单写 0.8‰ 的时候顺手填 0.8，保费会算成 10 倍；本列统一按百分数填（0.08 就是 0.08%）。
2. 定损金额没超过免赔额，却把应赔填成负数：应赔是 max(0, 定损 − 免赔额)，负数会让理赔差额跟着错一整行。
3. 赔款分次到账，只填最后一笔：实收理赔款要填累计到账数，否则差额凭空变小、少赔看不出来。
4. 投保金额与货值分开改：改了货值忘了改投保金额（或反过来），投保比例这一列的勾稽立刻对不上。
5. 一张保单保多票货时整行复制：保单号会在多行重复出现并触发重复检测；请把它列成保单明细并注明，别把整行复制。
6. 有定损金额却没填货损数量：索赔要能对上"坏了多少件、定损多少钱"，数量空着复核时会被打回。
7. 合计行手工写死：明细行增删后合计没跟着更新，逐列复核会直接报出差额。

需要完整档时（可选）

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

• 少赔判定（非拒赔行实收低于应赔的差额）
• 拒赔但实际应赔判定（拒赔行的定损金额高于免赔额）
• 同一票货重复投保判定（同一运单号在多个保单下投保）
• 漏保判定（货值高于投保金额的未保部分）
• 索赔处理清单（按金额从大到小排序并附行号与处理动作）

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

边界（请务必知道）

本工具不做引擎 OUT_OF_SCOPE 里列的那些判断：不判断保险条款是否适用、这笔损失该不该赔； 不判断免赔额、费率、投保比例是否合理；不处理共同海损、代位求偿、追偿时效；不读 Excel 原文件。 材料不足时不给结论，也不会输出「未发现问题」。