多人定期汇报汇总
多人定期提交个人Excel汇报（成果/计划/问题），需要汇总到一张按部门组织的大表，逐期追加。
首次使用：先跑演示
python scripts/make_demo_data.py --dir "<任意空目录>"
一键生成模拟文件库（含放错文件夹、无姓名命名、迟报后缀漂移等脏数据场景）并完整跑一遍建表+续期流程。确认效果后，再按 references/config-guide.md 把配置改成用户的真实组织结构。
执行流程
第1步：确认参数
- 目标期：本次要提取哪一期，如
0915。个人文件按文件名日期后缀标识版本。 - 文件库根目录：各汇报人文件夹所在路径。
- 首次为该用户服务时，先按
references/config-guide.md引导修改 scripts/consolidate.py 的 [配置区]（周期表、人员结构、特殊命名规则），改完再运行。
第2步：运行脚本
在根目录下自动找文件名日期最新的 YYYYMMDD汇报汇总表.xlsx 作为基础表，运行：
python scripts/consolidate.py --base-dir "<根目录>" --target <目标期>
可选参数：--existing "<汇总表路径>"（自动查找失败时手动指定）、--output-dir "<目录>"。
若根目录下没有汇总表（首次建表或推倒重建）：
python scripts/create_table.py --base-dir "<根目录>" --output "<输出路径>.xlsx"
依赖：openpyxl。未安装时执行 pip install openpyxl -i https://mirrors.aliyun.com/pypi/simple/ --trusted-host mirrors.aliyun.com（国内镜像加速）。
第3步：处理控制台报告中的异常
脚本输出 ✅成功/⚠️内容为空/❌未找到 三类结果。对"未找到"的，先用 Glob/Grep 全局搜索该人姓名和其已知的项目名关键词——常见原因是文件名不含姓名或存错了文件夹，找到后可把文件重命名加上姓名+日期后缀再重跑，或手动读取后用 Edit 写入汇总表。确认本期确实未交的，保留浅黄待交标记即可，不要编造内容。
第4步：验证输出
- 抽查2人的成果/计划/问题三行，与个人文件原文比对，确认无串行。
- 确认所有人员齐全，日期列写入位置正确（汇总表日期列从G列起，个人文件从第2列起）。
- 确认格式未破坏：仿宋12号、内容不加粗、文字单元格白底、日期列宽55、冻结窗格G3。完整规范见
references/format-spec.md。
第5步：汇报
向用户报告：成功人数、待交名单、输出文件路径，并提醒下期截止日期。
硬性规则（不可违反）
- 按行号提取数据（默认R2/R3/R4），绝不用标签文字匹配——不同人填的标签写法有细微差异，文字匹配会丢数据。
- 绝不覆盖原汇总表，始终另存新文件。
- 绝不编造、改写汇报内容，原文照录（含换行保留）。
- 人员或格式调整时，同步修改
references/config-guide.md记录与脚本中的 STRUCTURE 配置，保持一致。
