电商与平台结算技能包（免费版）
完全本地运行：引擎已经打包在本技能里（
scripts/engine/）。 核对过程不需要联网、不需要 API Key、没有调用次数上限、不写任何文件。
什么时候用
谁会在什么时候用：在电商平台卖货的商家、连锁/加盟品牌、商场联营专柜、餐饮门店， 以及做直播、OTA、会员与促销的运营与财务岗，在每个结算周期对账之前。 结算从来不是一张单：电商平台结算核对、退货退款与货款结算核对、平台账期与在途资金核对、 直播佣金与坑位费结算核对、OTA 佣金与净结算核对、商场联营抽成与保底核对、 加盟抽成与最低保底核对、连锁加盟门店结算核对、会员积分与储值卡核销核对、 促销补贴与核销核对、采购返利与阶梯核算核对、整车厂返利与商务政策核对、 寄售代销结算核对、餐饮门店日营业款核对 —— 每一份都有自己的勾稽关系，逐份手核既慢又容易漏， 而平台少结的那部分就是真金白银。
这个包做的事只有一件：--input <客户目录>（每个子目录 = 一个客户 / 一套材料），
一次跑完所有客户，每个客户一行结论。
这个免费版查什么
下面 14 项，每个客户都跑一遍（检查项名字与引擎 CHECKS_GIVEN 逐条一致）：
- 电商平台结算核对
- 退货退款与货款结算核对
- 平台账期与在途资金核对
- 直播佣金与坑位费结算核对
- OTA佣金与净结算核对
- 商场联营抽成与保底核对
- 加盟抽成与最低保底核对
- 连锁加盟门店结算核对
- 会员积分与储值卡核销核对
- 促销补贴与核销核对
- 采购返利与阶梯核算核对
- 整车厂返利与商务政策核对
- 寄售代销结算核对
- 餐饮门店日营业款核对
引擎里的 CHECKS_WITHHELD（本免费版不执行的项）会逐条打印出来，例如
「跨客户汇总台账」「结算差异风险排序清单」「跨客户共性问题归类」「电商与平台结算台账导出」——
它们是"未执行的检查项"的说明文本，不是实现。
另外，每个成员检查包自己没做的子检查（SUB_CHECKS_WITHHELD，本包合计 68 项）也在结果里
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) / 未执行； - 有价值的是问题明细：每条都带
客户 + 检查项 + 来源文件:行号 + 类别 + 具体数字， 第三方可以拿同一份材料复算； - 行号口径与本包无关：成员引擎的"第几行"各不相同，本包以原文内容为准重新落位 —— 用该条结论里的原文片段回到你交的那份材料里核对，一定对得上同一行；
- 本包的
--sample用的是 14 份成员样例拼起来的干净稿（各自自证 0 条发现）， 想看它怎么报问题请用--sample-batch（第二个客户就是那种"有硬伤"的稿子）。
常见错法
- 一个客户一个目录：
--input指向的目录里，每个子目录 = 一个客户。 把所有客户的结算单放进同一个子目录，会被当成一个客户，跨客户的差异与汇总也就无从谈起。 - 把 14 项的材料全塞进一个文件却不分段：引擎按
=== 检查项 ===分段找每一项的表； 不分段时只有第一段能被认出，其余 13 项会如实标成「未执行」并报一条「材料只覆盖了一部分」， 不是"查过了没问题"。 - 以为「未执行」=「通过」：某客户只交了 3 张表，那 3 项之外的 11 项是没有核， 结论里写的是「未执行」，并且会单独报一条覆盖缺口。
- 把平台补贴 / 活动扣款 / 保证金扣除混在"佣金"里：这些列必须单独成列， 否则「销售额 − 佣金 − 服务费 − 运费 − 退款 = 结算金额」这一条勾稽根本算不起来，该项会如实标「未执行」。
- 拿
--sample的输出当自己的结论：样例只是让你确认「跑得通、格式对」， 真正的结论必须来自你自己的材料。
需要完整档时（可选）
本免费版是完整可用的核心产出，本版本不包含下面这些项：
- 跨客户汇总台账（全部客户 × 全部 14 项检查合并成一张总表）
- 结算差异风险排序清单（按 P0/P1/P2 排序，带客户名与原文文件行号）
- 跨客户共性问题归类（同一问题命中 2 个及以上客户时合并成一条共性项）
- 电商与平台结算台账导出（Markdown 与 CSV 文本，直接用于与平台/商场对账说明）
同名工具的完整档是另一个独立商品（条款与条件以它自己的商品页为准）；两档的差别就是上面这些，没有别的。
边界（请务必知道）
- 不判断平台佣金率、商场抽成比例、返利与补贴政策定得合不合理（那是商务谈判与平台/商场规则的事）；
- 不核对平台 / 商场 / 加盟商是否真的打了款，也不核对退货、积分与储值卡是否真实发生；
- 不代替审计，也不出具鉴证意见或审计意见；
- 不读取平台后台 / OTA / 商场系统 / POS / 会员系统的导出文件 —— 需要你先导出成文本，每个客户一个目录。