成绩学情批量分析器 专业版
> 定位：把"班主任对着教务导出的多班多科Excel手工统计"变成"上传即出学情诊断"。核心是教务模板自动识别与不要求用户改表头，不做AI预测学生分数。
一、适用人群与真实痛点
- 班主任/备课组/年级组长：每次月考、期中、期末，拿到教务系统导出的多班多科成绩Excel，手工统计平均分、优秀率、及格率、进退步、偏科，耗时耗力。
- 教务表格格式五花八门：不同学校、不同教务系统导出的表头差异大，人工清洗麻烦。
- 普通工具要求用户先规整表格、只支持单份文件，没有面向国内教务业务的分层模型和正式报告。
二、信息收集
必填
stage（枚举，必选）：小学 / 初中 / 普通高中score_excel_files（Excel数组，必选）：教务导出成绩表格，支持分批上传多份不同考试文件
选填
layer_config（JSON配置）：学生分层自定义规则；不传则使用系统默认分层规则class_name（文本）：班级名称（不填则按表内班级识别）
高级模式（付费解锁）
enable_advanced（布尔，默认 false）：多考试历史对比、PDF正式学情报告、脱敏结构化导出。置 true 即为付费模式。
三、工作流程
- 选择学段；上传教务原始 Excel，不需要用户手动调整表头，Skill 内部自动识别教务模板。
- 可分批上传多次考试成绩，用于进退步历史对比。
- 可自定义分层规则；触发分析。
- 快速模式返回 Markdown 简单统计预览；付费模式输出完整报告与导出文件。
四、输出框架
快速模式（免费体验）
- 单份表格基础统计（平均分、及格率）Markdown 预览，无多考试对比。
付费高级模式输出（核心价值）
- 平均分、优秀率、及格率统计；进退步名单、偏科筛查
- 多考试跨轮次学生成绩变化追踪
- 按配置规则完成学生二维分层
- 备课组会议可直接打印 PDF 学情报告
- 脱敏后结构化 Excel 导出（学生敏感数据会话内处理，不上第三方持久存储）
五、方法论（统计与分层规则）
- 教务模板自动识别：内置国内中小学常见教务导出模板识别库（学号/姓名/班级/各科列/总分列），自动定位，无需用户改表头。
- 异常数据清洗：识别并标记缺考、转班、异常分数（如总分>满分、单科为负），不静默纳入统计。
- 统计口径：
- 平均分 = 参考人数加权平均；优秀率 = 优秀线（默认90分或前10%，可配）以上人数/参考人数；及格率 = ≥60分人数/参考人数。
- 进退步 = 同一学生在两次考试中班级排名/分数差值，跨考试对比时按同一学生匹配。
- 偏科筛查 = 单科成绩与自身总分水平显著偏离（标准差判定）。 - 二维分层：横轴按总分档（优/良/中/待提升），纵轴按进步趋势（上升/持平/下滑），两两组合形成分层矩阵，供分层教学参考。
- 合规红线：学生成绩仅会话内存处理，会话结束清除，禁止第三方持久存储学生成绩敏感信息。
六、完整示例
示例一（初中·快速模式）
班主任上传本次月考单份成绩 Excel，选择"初中"，未开启高级。
- 返回：班级平均分、及格率 Markdown 预览；异常数据提示（2人缺考已标记，不纳入统计）。
示例二（普通高中·付费高级模式）
年级组长上传高一期中、期末两份成绩 Excel，enable_advanced=true，自定义分层规则。
- 交付：PDF 学情报告（各科平均分/优秀率/及格率、进退步名单、偏科筛查）、二维分层矩阵、脱敏 Excel 导出（学号替代姓名）、跨轮次成绩变化追踪。
七、边界与禁止事项
- 不做 AI 预测学生分数（不做成绩预测）。
- 不替教务系统出分：只做统计诊断，不改动原始成绩。
- 异常数据（缺考/异常分数）必须标记并说明处理方式，不静默删除。
- 学生成绩敏感数据仅会话缓存，会话结束清理。
八、付费链路说明
本 Skill 为支付宝按量付费（ON_DEMAND）：每次生成一份完整学情诊断收费。调用约定：
- 首次请求返回
402 Payment-Needed，提示完成支付宝支付（probe 探测）。 - 用户支付后获得
Payment-Proof（含 tradeNo 与 signature）。 - 携带 Payment-Proof 调用 complete 完成验证（verifyPaymentProof 校验），返回
ack+fulfillment.confirm后交付完整学情报告。 - 同一订单重复 complete 幂等返回，不重复计费。
付费脚本位于 scripts/paid.mjs，服务端完整 A2M 实现位于 scripts/server.mjs（含真实验付与履约确认）。
九、合规约束
- 学生成绩仅会话内存处理，会话结束清除，禁止第三方持久存储学生成绩敏感信息。
- 导出文件默认脱敏（可用学号代替姓名）。
- 输出标注统计口径与异常数据处理方式，保证可追溯。
