技能介绍

加班台账很少只错一处：一张表里可能同时混着已驳回却仍入账的单据、离职人员的新加班记录、法定节假日却用调休抵掉的条目，以及早已透支却没人发现的调休账户。等到算工资时才对，就只剩推诿。《阿拉丁加班管家工坊》（@user_d18c97ea/aladin-overtime-forge）解决的是发薪前最后一步：把两份导出表查成可以关账的结论。

它做什么

输入加班记录台账（必需，姓名/加班日期/时长或起止时间）和调休使用记录（可选，--comp），必要时再给在册名单（--staff）与离职名单（--leavers）。技能先做清洗归一：中文表头别名、四种日期写法、19点30 这类时间、UTF-8/GBK 编码，以及完全重复行都能处理；加班类型缺失时按星期推断，并带 * 标注。

接着跑 OT1-OT12 十二条规则，按 P0 当日 / P1 一周 / P2 建议分级，并给出 CLEAR / WATCH / ALERT 门禁：月累计破 36 小时红线、驳回单仍入账、幽灵加班人、离职后仍有加班、单笔超 16 小时、连续 ≥7 天加班、法定节假日用调休补偿、调休透支或结余偏高、使用单未审批、缺事由、深夜收工、关键字段缺失。每人调休账户按 挣得 − 已用 = 结余 结算，透支立即标红。

输出四件套：自包含的 ot_report.html 看板（无外链）、可逐条勾选的 ot_actions.md 整改清单、Excel 直开的 ot_ledger.csv，以及供下游薪酬或排班工具消费的 _ot_ir.json / _ot.json 结构化契约。工作流是三段脚本：scripts/ot_ingest.py 清洗接入，scripts/ot_audit.py 稽核结算，scripts/ot_report.py 出报告；P0 处理完重跑，直到门禁变 CLEAR 再关账。

边界与注意点

它只处理本地导出文件，不接考勤机、OA 或 HR 系统，也不联网；加班费具体金额请走薪酬核算，技能只在法定节假日等场景标注“应按 300% 计薪”等提醒。参数可按企业口径调整：--monthly-cap（默认 36 小时）、--daily-cap（默认 3 小时）、--night-hour（默认 23 点）。综合计算工时制的跨月分摊需要自行按核算周期调参。36 小时红线与 300% 口径是通用合规提示，不是法律意见书；技能也不改原始台账，只输出待整改清单，认定与处理仍由 HR 和主管决定。