AI核对型 AI 工具

SKU级利润核算（免费版）

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

什么时候用

谁会在什么时候用：电商卖家、跨境电商运营与财务，在每月结账时必须按 SKU 复算一遍真实毛利，

找出"看着赚钱、实际亏"的链接 —— 平台后台的「毛利」常常只扣了成本和平台佣金，

漏掉头程运费、广告费与退货损失。

这个免费版交付什么（完整可用的核心产出）

1. 逐 SKU 复算真实毛利与毛利率（结果里的 sku_profit，每个 SKU 一行）：

折算后售价、平台佣金、单件广告费、退货损失、真实毛利、毛利率逐项写清，每一格都能手算复现；

1. 逐行标出"算错的"：你表里给了「真实毛利」/「毛利率」列时，就与复算值逐行对比，不一致即报（带行号与差异）；
2. 逐行标出"毛利率异常低的"：毛利率低于参考线（10%）的行标 margin_band: "LOW" ——

只逐行标注，不做亏损排序、不给调价建议（那些属于完整档，见下）。

免费档执行的 6 项检查（也可以直接跑 --sample 看引擎实际执行了哪些）：

#	检查项	判据
1	真实毛利复算	售价×汇率 − 成本 − 头程运费 − 折算后售价×平台佣金率 − 广告费÷销量 − 折算后售价×退货率
2	毛利率复算	真实毛利 ÷ 折算后售价
3	合计行逐列复核	广告费、销量（这张表里只有这两列是可加列；单件价与比率相加没有意义）
4	同一 SKU 编号重复行检测	同编号列了两行 ⇒ 广告费/销量/毛利会被重复汇总
5	空白与占位符检测	任一必需列空着，或写着 待填 / - / N/A
6	金额或比率为负检测	售价/成本/头程运费/广告费/销量/汇率与各比率

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

怎么用

node scripts/run.mjs --sample                    # 先看样例（一张干净的 SKU 利润表）
node scripts/run.mjs --input 你的利润表.json       # 跑自己的表
node scripts/run.mjs --input 你的利润表.json --json

入参写法（必须含表头，从 Excel 复制成文本时 Tab 分隔最稳）：

{"text":"SKU编号\t商品名称\t售价\t成本\t头程运费\t平台佣金率\t广告费\t退货率\t汇率\t销量\nSKU-1001\t无线耳机\t39.90\t62.00\t8.50\t15%\t2600.00\t3%\t7.20\t400"}

表里可以再带 真实毛利 / 毛利率 两列（平台后台或你自己的口径）——带了就逐行比对，不带就只交付复算值。

口径（写死在结果里，第三方可复算）

• 真实毛利（单件，人民币） = 售价×汇率 − 成本 − 头程运费 − 售价×汇率×平台佣金率 − 广告费÷销量 − 售价×汇率×退货率
• 毛利率 = 真实毛利 ÷（售价×汇率） —— 分子分母同一口径
• 售价 按原币填（如美元），汇率 = 1 原币兑多少人民币（境内电商填 1.00）；

成本 / 头程运费 / 广告费 按人民币填；广告费 是本期总额，会按销量摊到单件。

• 容差：金额 0.01 元、比率 0.05 个百分点；合计行差额 ≤1.00 元只提示复核（P2），>1.00 元判 P0。
• 净利润还会受税费、仓储、支付手续费、人工等影响 —— 本表只核你填进来的六项，不会替你把没填的成本项补上。

常见错法（SKU 利润核算里真的会犯的错）

1. 漏掉头程运费。 头程是货到海外仓/前置仓这一段的运费与关税，每件都要付，

但它常常记在"物流费"科目里，做 SKU 毛利时就漏了 —— 一件头程 8.5 元、月销 400 件就是 3400 元，

漏掉它，一个本来微亏的链接会显示成"赚 8%"。

1. 广告费按总额填、不摊到 SKU。 广告后台给的是账户/计划总额，

必须 ÷ 该 SKU 的销量才是单件广告成本；直接拿总额当单件成本（或干脆不摊）会让单件利润错几十倍。

本工具按 广告费 ÷ 销量 摊，所以这两列必须填同一个期间的数。

1. 佣金率含不含推广费说不清。 平台的"佣金率"通常只含交易佣金，

不含推广服务费、支付手续费、达人佣金、联盟佣金。把"含推广"的综合费率填进 平台佣金率 会重复扣一次；

反过来，只填佣金率又以为它含推广，就会漏扣 —— 这一列到底含什么，必须与你的对账口径写一致。

1. 退货率只扣了货值，没扣运费与头程。 退货损失不只是退回的货值：

回程运费、被平台扣走的佣金、二次销售的折价都要算进去。

本工具按 售价×退货率 计退货损失（退回一件 ≈ 损失一件的折算后售价），这是保守且可复算的口径；

如果你的退货还能部分二次销售，请在表外另作说明，不要偷偷把退货率改小。

1. 汇率用错口径或方向。 汇率 必须写成 1 原币 = X 人民币（美元 7.20 就填 7.20），

填成 0.1389（1 人民币 = 多少美元）会让毛利直接算反；另外分子分母要用同一个汇率 ——

拿人民币毛利除以原币售价，会得到一个偏大的假毛利率。境内电商这一列填 1.00。

使用次数与完整档

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

· 前 3 次：服务端不返回任何内容，输出与现在完全一样；

· 第 4 次起：服务端会返回一段完整档说明（完整档是另一个独立商品，条款与价格以它自己的商品页为准），届时才会打印这一行；

· 统计不可用（离线/超时/被拦截）时什么都不做，核对结果与退出码不受任何影响。

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

需要完整档时（可选）

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

• 亏损 SKU 按亏损金额排序的清单
• 每条亏损 SKU 的调价建议/停售建议（含目标价）
• 广告费占比（广告费 ÷ 折算后销售额）诊断
• 整体月度亏损估算
• 跨期对比（与上月/上季度的毛利、毛利率对比）

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

边界（请务必知道）

本工具不做引擎 OUT_OF_SCOPE（也导出为 CHECKS_OUT_OF_SCOPE）里列的那些判断：

• 不替你做选品决策（这个 SKU 该不该上、该进多少货、该不该砍）；
• 不做竞品比价与市场价判断（对手卖多少钱、该不该跟价）；
• 不接入平台 / ERP / 广告后台 API 取数（佣金、广告、退货一律以你导出的表为准）；
• 不替代会计口径（收入确认时点、存货计价、税费、汇兑损益与账务处理）。

材料不足时不给结论：text 为空、只有表头、缺必需列或入参类型不对时，

返回 insufficient_input 并列出缺什么，既不认定"算错了"也不认定"没问题"，

更不会输出「未发现问题」。每条结论都可由第三方用同一份输入复算。