阿拉丁考勤对账官

痛点：发薪前的考勤核对为什么总是那么慢

月底核算薪资前，HR 或行政通常需要将考勤机、企业微信或钉钉导出的打卡流水，与当月排班表逐条比对。面对成百上千条记录，人工排查迟到、早退、缺卡和未登记的加班不仅耗时费力，还容易因为疲劳导致漏判。

工作原理：三步离线稽核流水线

该技能通过纯 Python 标准库实现的三步流水线，将耗时的人工核对压缩到分钟级。

• Step 1 数据解析与归一化：

支持导入 CSV/TSV/JSON 格式的打卡文件，自动识别“签到+签退”双列或“打卡时间”流水格式（自动取最早/最晚）。结合模糊匹配技术，能直接处理包含“员工/名字”、“上班/上午”等非标准中文表头的文件。

• Step 2 规则化稽核引擎：

内置 A1 到 A8 共 8 条稽核规则，覆盖排班缺勤、缺卡、迟到、早退、超时加班未确认、未排班打卡、周工时超限及连续出勤超 7 天等场景。
* 针对复杂考勤制度，提供 6 个关键参数接口，例如 --grace（迟到宽限分钟）、--ot-threshold（加班判定阈值）以及 --weekly-cap（周工时上限）。

• Step 3 结果产出与门禁：

运算结束后产出包含健康分与 gate 结论的机器可读文件 _attend.json（契约 aladin.attend/v1）。同时生成自包含的 HTML 稽核看板、UTF-8-SIG 编码的 Excel 台账 attend_ledger.csv 以及可直接发群的 attend_report.md。

适用边界与注意点

这是一个只读稽核工具，设计初衷是确保数据的绝对安全与可复现性：

1. 只做考勤，不做算薪：该技能仅提供经过稽核的工时台账，不涉及工资、加班费金额或个税的具体计算。
2. 非实时集成：针对离线导出文件进行批处理，不支持接入考勤机 API 进行实时数据拉取。
3. 夜班处理限制：无法自动拆分跨天夜班，这类特殊班次必须在排班表中显式定义时段。
4. 数据安全性：所有结果均写入独立的 build/ 目录，绝不回写原始打卡文件。