履约保证金与保函台账核对（免费）

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

什么时候用

谁会在什么时候用：财务、出纳等岗位在每月结账 / 对账 / 盘点这类固定节点上， 必须把这张表核一遍才能往下走。

这张表会逐项核对什么：履约保证金与保函台账的逐行算术、合计勾稽、重复与空缺检测。

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

这个免费版查什么

免费档逐行执行这 6 项（跑 --sample 会打印实际执行了哪些）：

1. 应退金额复算：已缴金额 − 已退金额 = 应退金额。少减一笔已退，就是一笔钱躺在对方账上。
2. 保函余额复算：保函金额 − 已释放金额 = 保函余额。
3. 合计行逐列复核：合计行每一列都必须等于各明细行之和。
4. 同一项目同一类型重复行检测：同项目 + 同保证金类型出现两行即报（会重复统计、重复退款）。
5. 空白与占位符检测：必需列空着，或写成 -、待补、无，都会被点出来。
6. 金额为负检测：已缴金额、已退金额、保函金额、已释放金额、保函费用出现负数即报。

本版不执行（会如实列进 scope.checks_not_run，不会用默认值编结论）： 已退金额超过已缴金额、保函到期日早于项目结束日、保函余额为负、 保证金超过合同金额比例上限、已缴金额为零却有保函费用。

常见错法（这张台账最容易填错的 5 处）

1. 把「合同金额」填进「已缴金额」：履约保证金一般只是合同金额的 3%~10%， 一填成全额，整行的应退金额与比例关系全部虚高。
2. 「应退金额」直接抄「已缴金额」：忘了减掉已经退过的部分 —— 已在退款流程里的项目会被再退一次（漏退和重退都出在这一列）。
3. 「保函余额」填成「保函金额」：保函已经部分释放却没写进「已释放金额」， 余额看着还在，实际可用额度早就不够覆盖。
4. 「保证金类型」写得太笼统（只写「保证金」）或项目名前后不一致（多一个空格、带「（一期）」）： 重复行检测是按「项目 + 类型」配对的，配不上就查不出重复行。
5. 「保函到期日」写成「长期」「无」「—」：日期认不出来时本工具不下结论 （而不是编一个结论），这一列的到期敞口就整列漏检。

怎么用

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

需要完整档时（可选）

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

• 已退金额超过已缴金额检测
• 保函到期日早于项目结束日提示
• 保函余额为负检测
• 保证金超过合同金额比例上限（10%）提示（参考口径）
• 已缴金额为零却有保函费用检测

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

使用次数与完整档

本免费版每次运行结束后会向服务端做一次匿名次数统计：只发送本包标识和一个不含任何材料的匿名安装标识（由主机名与用户名做短哈希得到），不发送你的材料、不写任何文件。

· 前 3 次：服务端不返回任何内容，输出与现在完全一样； · 第 4 次起：服务端会返回一段完整档说明（完整档是另一个独立商品，条款与价格以它自己的商品页为准），届时才会打印这一行； · 统计不可用（离线/超时/被拦截）时什么都不做，核对结果与退出码不受任何影响。

本版本不包含的检查项见上一节；需要完整档时按服务端返回的官方口令执行，付款由用户本人确认。

边界（请务必知道）

本工具不做引擎 CHECKS_OUT_OF_SCOPE 里列的那些判断； 材料不足时不给结论，也不会输出「未发现问题」。