高中物理六段式分析报告

做高中物理考试分析时，老师和学生常卡在几个环节：试卷PDF、答案PDF、学生答题Excel、学生反思文件分散，手动整理逐题得分、模块统计耗时久；错题分析易停在“粗心”“审题错”这类表面归因，提分建议常是“多做题”这类空话；学生的自我认知偏差（比如觉得“都会”但分数上不去）也难发现和纠正。

核心能力与工作流程

• 输入文件确认：先验证试卷PDF、答案PDF、学生答题Excel、学生反思文件（.docx/.pdf）是否可读，微信临时目录的文件可能失效，需引导重新发送；明确要生成报告的学生名单。
• 结构化数据提取：运行scripts/exam_analysis.py，自动识别单选题/多选题/主观题列，从答案PDF提取标准答案批改客观题，计算每题正确率、班级统计、知识模块得分率和学生排名，可用--exclude-qs排除合并给分的题号，--extract-only仅输出JSON。
• 学生反思读取：对目标学生，用python-docx提取.docx反思文本，用PyMuPDF（fitz）提取.pdf文本，每道错题需引用学生反思原文（如有）。
• 知识点配置准备：从试卷PDF提取每道题的知识点（exam_point具体考点、common_mistakes常见错误、weight满分权重），若无已有配置则创建，用于后续错题分析和模块加权计算。
• AI深度分析：对每位学生结合数据和反思，完成：

- 逐题分析：错题需写根因（追问“概念清晰还会粗心吗”，不归因表面原因）、针对性建议（具体数量、步骤，比如“做5道活塞+气体定律综合题，用三步法：受力分析→列平衡方程→联立状态方程”）；
- 知识模块诊断：按得分率从低到高排列，总结涉及题号、考点和问题模式，给模块级建议；
- 反思深度分析：纠正学生自我认知偏差，总结亮点；无反思则改为“学习习惯与方法分析”；
- 提分路径规划：三阶段（急救期1-2周、补强期2-4周、巩固期4-6周），每阶段有目标和4-5条具体行动项，时间不够失分则第一阶段加时间管理训练；
- 个人留言：用“你”形成对话感，先提具体优点，再以鼓励方式说核心问题，给第一步行动建议，结尾鼓励。

• 报告生成与交付：将分析结果整理为JSON，运行scripts/build_personalized_report.py生成DOCX，格式含蓝色表头（#4472C4）、红色题目标题（#C00000）、列表建议，用✗/△/✓标记状态，保存到指定位置。

适用边界与注意点

• 需同时提供试卷PDF、答案PDF、学生答题Excel、学生反思文件，缺则无法完成全六段分析；
• 排除的题号（如合并给分题）不在任何分析中出现；
• 多选题需分类讨论漏选/选错/选错且漏选，给不同建议；
• 生成报告依赖python-docx、openpyxl、PyMuPDF（fitz），报错先检查依赖；
• Python文件需用UTF-8编码，避免中文显示异常。