课时消耗与教师课时费核对（免费版）

课时消耗与教师课时费明细表逐项核对（课时费=课时数×课时单价逐行复算、正课/试听/补课口径区分、学员消课课时与系统课耗课时逐笔勾稽、合计行逐列复核、课时单价低于合同保底单价、重复课时记录与关键字段空缺），每条结论引用原文行号。本免费版执行引擎声明的免费检查项。触发词包括 课时消耗与教师课时费核对、课时消耗与教师课时费明细表对不上、课时费算错了、学员消课和系统课耗对不上、课时单价低于保底。

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

什么时候用

谁会在什么时候用：教培机构的教务 / 财务 / 校区主管，在每月算教师课时费这条流程上： 先把学员课时包的「课耗」导出来，再按排课记录算老师该拿多少课时费，两张数必须对到一起才能发钱。 月底一次要核好几张表（多个教师、多个校区），核完就得往下走。

这张表会逐项核对什么（全是纯算术，几十上百行没人愿意手核）：

• 课时费 = 课时数 × 课时单价：逐行复算，单价录错一位、课时数漏乘都是钱
• 正课 / 试听 / 补课的口径不一样：试听与补课不消耗学员课时（补课是服务补救，原课次已经扣过）， 正课必须有课耗 —— 把两种口径混着填，学员课时包和教师课时费两边都对不平
• 学员消课课时 = 系统课耗课时：两条线的数必须逐笔相等，差一笔就有一边算错了
• 合计行逐列复核：课时消耗合计、课时费合计、代课补贴合计必须等于明细之和
• 课时单价 ≥ 合同保底单价：低于保底的排课直接亏
• 重复课时记录与关键字段空缺：同一教师同一天同一课型同样课时数的重复行、缺格与占位符

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

怎么用

bash

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

入参就是这张表本身：把表头和数据行一起复制成文本贴进来（从 Excel 复制，Tab 分隔最稳）， 写成 {"text": "…"} 或直接粘纯文本都行；也可以用 file 字段给个材料名，结论里的行号会带上它。 表头必须能认出这 11 列：教师、校区、课程类型、上课日期、课时数、课时单价、课时费、 代课补贴、学员消课课时、系统课耗课时、合同保底单价（少一列就会直接说"材料不足"，不会猜）。

出参

run(payload) 返回 {status, result}：

• status：success（已执行检查）或 insufficient_input（材料不足，此时没有 result，也不给任何结论）
• result.findings[]：每条 = level（P0/P1）、category、line（原文行号）、amount、 message（带具体数字）、evidence（文件名:行号）、advice（怎么改）
• result.summary：条数、P0/P1 计数、hours_total / pay_total / subsidy_total / consumed_total / sys_consumed_total、verdict（NO_ISSUE_FOUND / NEEDS_REVIEW / ERROR_FOUND）
• result.checks_executed / checks_withheld：本次真的执行了哪些、哪些没有执行（如实列出，不伪造）

常见错法（本产品专属）

1. 拿「上课课时数」当学员课耗：老师上了 2 课时，可学员请假后没扣课时 —— 两边用的根本不是同一个数。
2. 试听 / 补课也扣学员课时：试听不该扣；补课是服务补救，原课次已经扣过，再扣就是重复扣费。
3. 课时费与「课时数 × 单价」对不上：常见是调价后只改了单价没重算课时费，或者课时费那一格直接手填。
4. 只贴数值区不贴表头：表头缺了或认不出来，本工具直接说材料不足，而不是猜哪一列是什么。
5. 合计行漏改：明细里加了一行，合计行没跟着更新，表面看一切正常，课时消耗合计却对不上。
6. 同一节课录两遍：同一教师同一天同一课型同样课时数出现两行，课时费会翻倍；本表没有学员列， 要区分不同学员请自己加一列学员或课次编号。
7. 课时单价低于合同保底价：低价排课（体验价、内部价）必须先有特批依据，否则就是在亏。

本版本不包含什么

本免费版是完整可用的核心产出；下面这些检查项不在本版本里执行（引擎会如实列在 checks_withheld 里，绝不会假装做过）：

• 跨教师 / 跨校区汇总台账（逐组汇总课时、课耗、实发课时费与差额，按差额从大到小排序）
• 按差额排序的处理清单（先核哪几笔，带原文行号与金额）
• 课时费差额归因：课时数差异 / 单价差异 / 代课补贴 / 录入口径残差
• 同一教师同一课程类型的课时单价一致性检测（同一课型不该出现两个价）
• 同一教师同一日课时数超过单日上限检测

需要这一层能力的是另一个独立商品，条款与条件以它自己的商品页为准； 两档的差别就是上面这些，没有别的。

需要完整档时（可选）

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

• 跨教师 / 跨校区汇总台账（逐组汇总课时、课耗、实发课时费与差额，按差额从大到小排序）
• 按差额排序的处理清单（先核哪几笔，带原文行号与金额）
• 课时费差额归因：课时数差异 / 单价差异 / 代课补贴 / 录入口径残差（四项之和恒等于总差额）
• 同一教师同一课程类型的课时单价一致性检测（同一课型不该出现两个价）
• 同一教师同一日课时数超过单日上限检测（默认 8 课时）

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

边界（请务必知道）

本工具不做引擎 CHECKS_OUT_OF_SCOPE 里列的那些判断： 不判断排课、考勤与上课是否真实发生（那是教务排课系统与签到记录的事）、 不判断课时包售价、退费与赠课规则是否合规、不判断课时单价与代课补贴标准本身是否合理合法、 不处理跨月结转、跨校区调课、离职结算与个税社保代扣、不直接读 .xlsx / .pdf。 材料不足时不给结论，也不会输出「未发现问题」。