工程与项目结算技能包（免费版）
完全本地运行：引擎已经打包在本技能里（
scripts/engine/）。 核对过程不需要联网、不需要 API Key、没有调用次数上限、不写任何文件。
什么时候用
谁会在什么时候用：工程公司的项目会计、成本岗，以及代建方 / 业主方的工程管理岗， 在每期计量报量、分包结算、开票回款、竣工转固这些固定节点上。 工程结算底稿从来不是一张表：本期产值与计量、进度款与质保金扣留、质保金退还、项目开票与回款、 挣值（EVM）、在建工程转固与利息资本化、维修资金专项付款、分包结算、预付款冲抵、 违约金与索赔结算、安全生产费提取使用、投标保证金收退、软件外包里程碑付款 —— 每一张都有自己的勾稽关系，逐张手核既慢又容易漏，而且每个项目、每一期都要重复一遍； 少扣一笔质保金、多付一笔进度款、转固金额算错，后果比多花半小时严重得多。
这个包做的事只有一件：--input <项目目录>（每个子目录 = 一个项目 / 一套材料），
一次跑完所有项目，每个项目一行结论。
这个免费版查什么
下面 14 项，每个项目都跑一遍（检查项名字与引擎 CHECKS_GIVEN 逐条一致）：
- 工程产值与进度确认核对
- 工程进度款与质保金核算核对
- 工程质量保证金扣留与退还核对
- 项目开票与回款核对
- 项目挣值分析（EVM）核对
- 在建工程转固与利息资本化核对
- 在建工程转固核对
- 维修资金与专项工程付款核对
- 分包结算与产值核对
- 预付款与预付账款核销核对
- 罚款与违约金结算核对
- 安全生产费用提取与使用核对
- 投标保证金收退核对
- 软件外包里程碑验收与付款核对
引擎里的 CHECKS_WITHHELD（本免费版不执行的项）会逐条打印出来，例如
「跨项目汇总台账」「结算风险排序清单」「跨项目共性问题归类」「结算台账导出」——
它们是"未执行的检查项"的说明文本，不是实现。
另外，每个成员检查包自己没做的子检查（SUB_CHECKS_WITHHELD，本包合计 71 项）也在结果里
scope.sub_checks_not_run 如实列出 —— 两个档位都没实现它们，不会因为「买了完整档」就让买家以为这些项被跑了。
怎么用
node scripts/run.mjs --sample # 单项目样例（内置）
node scripts/run.mjs --sample-batch # 3 个项目的批量样例（干净 / 有硬伤 / 没交材料）
node scripts/run.mjs --input 项目目录 # 批量：每个子目录 = 一个项目
node scripts/run.mjs --input 项目目录 --json # 机器可读
项目目录怎么放（每个子目录里放该项目的一套工程结算材料，每项用 === 检查项 === 分段，Tab 分隔最稳）：
项目目录/
滨江路改造工程/工程结算材料.txt
城东安置房项目/工程结算材料.txt
也可以把 14 张表拆成 14 个文件放进同一个子目录 —— 引擎会自己认表头找对应的那一项。
templates/sample.json 是引擎自己的样例，可以直接 --input 它先跑通一遍。
退出码：0 已执行检查 / 1 缺少入参 / 3 材料不足 / 4 入参读不到或无法解析 / 9 未预期错误。 材料不足（一个项目的材料都没有、材料为空或只有几行、认不出任何一张表）时， 本工具不做任何认定、也不给任何结论，打印缺什么并以退出码 3 结束 —— 不会把"没查"说成"通过"。
结论怎么读
- 每个项目一行：
[结论] 项目名｜问题 N 项（P0/P1/P2）｜每一项:通过 / 有问题(n) / 未执行； - 有价值的是问题明细：每条都带
项目 + 检查项 + 来源文件:行号 + 类别 + 具体数字， 第三方可以拿同一份材料复算； - 行号一律以你的原文内容为准落位（成员引擎内部的行号口径不统一，本包只按"这一行在原文里真的存在" 来定位），所以拿行号回原文一定找得到那一行。
常见错法
- 把 14 项的材料全塞进一个文件却不分段：引擎按
=== 检查项 ===分段找每一项的表； 不分段时只有第一段能被认出，其余 13 项会如实标成「未执行」并报一条「材料只覆盖了一部分」， 不是"查过了没问题"。 - 一个项目一个目录：
--input指向的目录里，每个子目录 = 一个项目。 把所有项目的结算表放进同一个子目录，会被当成一个项目，跨项目的差异与汇总也就无从谈起。 - 以为「未执行」=「通过」：某项目只交了 3 张表，那 3 项之外的 11 项是没有核， 结论里写的是「未执行」，并且会单独报一条覆盖缺口。
- 把"上期累计"和"本期发生"两列混着填：进度款、质保金、转固金额这些勾稽都要用到 "期初 + 本期 − 本期支出 = 期末"这类滚动关系，缺一列该项就会如实标「未执行」。
- 拿
--sample的输出当自己的结论：样例只是让你确认「跑得通、格式对」， 真正的结论必须来自你自己的材料。
需要完整档时（可选）
本免费版是完整可用的核心产出，本版本不包含下面这些项：
- 跨项目汇总台账（全部项目 × 全部 14 项检查合并成一张总表）
- 结算风险排序清单（按 P0/P1/P2 排序，带项目名与原文文件行号）
- 跨项目共性问题归类（同一问题命中 2 个及以上项目时合并成一条共性项）
- 结算台账导出（Markdown 与 CSV 文本，直接用于结算复核说明与付款审批附件）
同名工具的完整档是另一个独立商品（条款与条件以它自己的商品页为准）；两档的差别就是上面这些，没有别的。
边界（请务必知道）
- 不做工程款该不该付、结算金额该不该审定的判断（属于合同履约与工程造价判断， 请按合同约定与造价咨询 / 监理签证结论执行）；
- 不判断定额套用、取费标准、工程量计算规则该按哪一版执行（以合同约定的计价依据为准）；
- 不代替审计，也不出具鉴证意见或审计意见；不核对签证单、监理报告、发票、银行回单的真伪；
- 不读取工程造价软件 / ERP / 资金系统的导出文件 —— 需要你先导出成文本，每个项目一个目录。