把腾讯会议考勤交给 AI：一个 Skill 的做法

要解决的问题

线上打卡群每天都要统计考勤。腾讯会议能导出「成员参会概况」，麻烦在昵称：有人带地区后缀，有人英文大小写不一，有人手机和平板同时入会，有时还是家长代为入会。手工一个个对名单，又慢又容易错。

花名册是唯一基准

花名册写四样东西：在册人员、名字映射、规则、排除人员。下面三种情况脚本会自动处理，不用登记：

• 昵称和规范名完全相同；
• 只多了括号后缀，比如「A004(三组)」；
• 只是英文大小写不同，比如「a007」。

其余的变体在映射表里登记一次就行。有人加入、退出、改昵称时，先改花名册，再统计。

规则写清楚，边界精确到秒

• 准时线：首次入会时间不晚于准时线算准时。06:00:00 算准时，06:00:01 就算迟到。
• 缺勤线：晚于缺勤线才入会，算缺勤；可以不设。
• 统计日：不在统计日的导出照样出日报，但标注「仅供参考」，周报不计入。
• 每周免罚请假：每周前 N 次请假不计，超出的次数在周报里按迟到计。

怎么证明它没算错

通用化之前，我用真实的导出表把新脚本和原来的脚本逐人比对，700 人次的结果完全一致。现在仓库里有 16 个测试，示例数据全部虚构，人名一律用代号。

怎么用

python3 scripts/attendance_stat.py examples/exports/*.xlsx \
  --roster examples/roster.example.md --leave-file examples/leaves.example.csv --out out

或者把文件夹装进 Claude Code、WorkBuddy 这类 AI 工具，对 AI 说「统计今天的考勤」。源码在 GitHub，MIT 许可。