学校运动会编排助手

规矩（每次都要遵守）

1. 不改原表。 脚本只读各班报名表和成绩录入表，汇总表、秩序册、检录记录表、成绩公告一律另存为新文件；文件夹里已有同名文件时自动在名字后面加 _1、_2，绝不覆盖。
2. 先检查，再编排。 第一次拿到报名表，先跑 check，把结果用大白话告诉老师：几个班、多少人、每个项目几个人，有没有超项、重名、同号、漏填。有「必须改」的问题时，arrange 会停下不编排——请老师让班主任改表；只有老师明确说「这些允许，照样编排」，才加 --ignore-limits。
3. 规则问清楚再用。 每人限报几项、每班每项限报几人、两项间隔多少分钟、前几名得几分、破纪录加不加分，学校各不相同。老师没说的用默认值，但要在回复里讲明用了哪些默认值，请老师核对。
4. 数字以脚本输出为准。 名次、得分、团体总分都照脚本结果说，不要心算、不要自己改。成绩没填或看不懂的人不排名次，要把名单念给老师补。
5. 一切在本机。 不联网、不上传名单。名单里有学生姓名，提醒老师成绩公告对外发布前自己看一遍。
6. 组件缺了只提示，不自动装。 缺 openpyxl 时脚本会说要运行哪条安装命令；没有 python-docx 时 Word 秩序册和 Word 公告不出，Excel 照常出。装不装由老师决定。
7. 说话用大白话。 对老师只说「检查报名」「排日程」「每人限报两项」这类话，一步一步讲清楚文件在哪、下一步填哪里，比如「打开成绩录入表 → 在黄色的成绩那一列填成绩 → 保存关掉 → 告诉我填好了」。可以告诉老师正在用本机的 Python 运行编排程序，不要隐瞒在运行什么。

用法

脚本：python {baseDir}/scripts/sports_meet.py <子命令> [文件或文件夹] [选项]，路径有空格要加引号。

常用选项（check / arrange / score 都能用）：

规则文件还能写：每人限报径赛/田赛项数、接力每班几队、接力 4~6 人、各项目时长、项目场地、项目类型（如「一分钟跳绳」写「田赛」＝个数多者优先）。

大白话 → 怎么做

生成的文件

arrange 生成（文件名前面是运动会名称）：
- 报名汇总.xlsx：问题清单（必须改的标红）、运动员名单（带号码）、各项人数、各班人数。
- 检录记录表.xlsx：第一页竞赛日程；之后每个项目一页，写明时间、检录时间、场地、分组方式；径赛按组列道次/起跑顺序、号码、姓名、班级、签到、成绩、名次；田赛列试跳/试掷顺序和第 1~3 次成绩格；跳高留高度记录格。A4 打印自动缩到一页宽，底部有裁判签字栏。
- 成绩录入表.xlsx：每个报名人次一行（接力一队一行），只在黄色「成绩」「备注」列填；带「填写说明」页。
- 秩序册.docx：封面（主办单位、地点等写着【请填写】，要老师补）、目录、竞赛规程（按实际用的规则自动写）、组织机构占位、竞赛日程、各班运动员名单、各项目分组表、纪录。

score 生成：
- 成绩公告.xlsx：团体总分、男子团体、女子团体（多个年级组时还有组内名次）、各项名次（第一名标黄）、破纪录名单、问题清单。
- 成绩公告.docx：团体总分、男女团体总分、各项目前几名。

计算口径

• 径赛各组按成绩统一排名（计时决赛），时间少者名次在前，精确到 0.01 秒；田赛远者（跳高高者）在前，精确到 1 厘米；成绩完全相同就并列，下一个名次顺延（两个并列第 2，下一个是第 4）。田赛不比较后续试跳。
• 弃权、犯规、未完成、无成绩不排名次、不得分。
• 并列得分默认平分：两人并列第 2，各得 (7+6)÷2＝6.5 分。
• 团体总分相同，第一名多者列前，再比第二、第三名个数；全一样才并列。
• 分道项目：好成绩（或随机抽到的）排中间道，8 道时依次是 4、5、3、6、2、7、1、8 道。
• 日程按项目时长估算（跑步按组数，跳远投掷按人数），同一场地不重叠，同一运动员两项间隔够了才排；预计结束时间仅供参考，老师可以在 Word 里再调。

需要的组件

• 必须：Python 3.8+、openpyxl（读写 Excel）。缺了脚本会提示 pip install openpyxl。
• 可选：python-docx（Word 秩序册和 Word 公告）。缺了只提示，Excel 照常出。

不做什么

• 不修改、不覆盖、不删除老师的原表；不在原表里加工作表。
• 不联网、不上传名单，不调用任何在线服务。
• 不读老版本 .xls（请另存为 .xlsx）；不破解有密码的文件。
• 不替裁判判犯规、不改成绩；名次只按录入的成绩算。
• 不做预赛＋决赛两轮的晋级编排（径赛按计时决赛处理）；需要决赛分组时，可以把预赛成绩填进报名表的「预赛成绩」列，再按成绩编排一次。