统计结果怎样变成教师可用的导出文件

在学校的教研与备考管理中，系统计算出数据仅仅走完了第一步。在真实的教学场景中，年级组长需要打印各班达线矩阵，备课组长需要带着薄弱学科名单开研讨会，班主任则需要拿着“临界生”名单进行个别谈话。

这些使用场景要求导出保留屏幕上的统计口径、筛选条件与名单依据。SCORE 因此逐步补充专项统计规则，并把工作簿的内容组织和桌面可读性纳入检查范围。

1. 从简单前后名单到可配置专项统计

在最初的版本中，详情页仅提供简单的“前 N 名”和“后 M 名”展示。然而，实际教研需要解决的问题远比这丰富：

• “全校总分前 100 名在各班的分布情况如何？”
• “各班各学科不及格或处于极端低分段的学生有哪些？”
• “某分数区间段内的学生在不同选科组合中的表现如何？”

为了满足这些深度需求，SCORE 将零散的查询动作升级为规则驱动的专项统计面板：

• 教师可自由组合统计对象（全校/指定班级）、分析指标（均分、中位数、四分位距 IQR、标准 Z 分数）以及条件阈值（如校排名前 50、各科后 10%）；
• 系统支持保存查询草稿，避免教师每次进入页面都要重新配置繁琐的筛选条件；
• 对于跨校联考数据，系统智能识别并保留联盟提供的基准指标，并在面板中明确标注统计口径来源，防止教师将不同样本池计算出的指标直接做不严谨的混比。

2. 临界生识别：从宏观比例到具体名单

在高考和中考备战中，“临界生”（即成绩在重点线或本科线附近上下浮动的学生）是学校教学干预的关键对象。

早期版本侧重班级层面的临界命中比例与矩阵。5 月 22 日需求进一步要求输出具体名单，让教师能够查看哪位学生、哪门学科、哪条线命中了配置区间。

为此，临界生识别从比例统计扩展到多条线的独立配置与名单输出。下图分数仅用于说明配置关系：

年级基准分数线配置（如特控线 560、本科线 480）

临界线 1：默认跟随上层线目标 560，浮动 [-3, +3]

临界线 2：自定义覆盖目标 480，下浮 -5，上浮 +2

两条临界线汇入

单场考试多科成绩扫描

多维临界生名单（按学科/临界线分组，保留完整命中证据）

临界线 1 与临界线 2 的配置结果各自进入同一场考试的多科成绩扫描。

2.1 多线独立与非对称浮动

• 教师可为不同学科分别启用多条临界线（如特控临界线、一本临界线、本科临界线）；
• 默认采用 [-3, +3] 的闭区间对称浮动（如目标分 100，浮动区间为 [97, 103]），同时也支持自定义非对称区间（如下浮 5 分、上浮 2 分）；
• 某条线被手动微调后转为“自定义状态”，不再被上层模板的全局变动覆盖，同时提供“恢复跟随”功能。

2.2 保持命中的多重归属

当一名学生在数学学科命中了特控线临界，在物理学科同时命中了本科线临界时，系统在生成名单时按“学科 + 临界线”维度完整列出所有命中项。系统严禁粗暴地按学生姓名去重，确保各备课组教师都能在各自的学科报表中看到完整的名单依据。

3. 工作簿不是网页截图的替代品

把网页表格直接转成文件，还不足以满足报表需求。下载后仍需要看得出统计对象、分组、数值单位和配置来源，长名称与说明也需要足够的展示空间。

SCORE 按报表用途组织工作簿：

• 按类型生成工作表：成绩表、班级分布、分线达成和临界名单有各自的输出需求。材料中曾有两张、四张工作表等阶段方案，不能合并成所有报表固定包含的一套工作表。
• 按有效配置输出内容：复用已有统计结果，保留必要统计块，避免无意义空表；体育相关内容根据数据条件生成。具体工作表以对应版本和报表类型为准。
• 保留阅读上下文：表头、列宽、分组、数值格式、数据来源和筛选条件都属于导出内容。页面与导出使用同一组配置时，应能核对相应名单和统计结果。

4. 走向桌面 Excel 的真实交付检验

在 9 月的专项重构与验收中，团队发现了一个极易被自动化测试遗漏的现实问题：后端生成一个格式正确的 XLSX 二进制包，并不等于教师在桌面 Excel 中打开时具有良好的可读性。

验收发现，普通成绩表、单人追踪和趋势工作簿的列宽不足，较长的考试名称或说明会被截断；趋势报告还曾把真实统计误标为样本输出。前者需要调整布局，后者需要修正统计来源的读取与标注，不能只靠改列宽一起解决。

针对这些问题，导出专项分别处理了结构、来源与布局：

• 布局、数据与序列化解耦：将报表数据提取、工作簿排版布局与底层二进制序列化拆解为三个独立层级，使列宽计算与换行策略能够独立演进；
• 区分统计来源与样本回退：直接读取统计来源，分别标注实际统计结果、样本回退和预览附件，修正趋势报告的来源误标。
• 模型与桌面检查分开：19 对工作簿模型用于比较数值与未受影响的工作表，不是像素比对。随后通过浏览器下载文件，在桌面 Microsoft Excel 中只读检查了 7 个合成文件、15 个目标工作表的列宽、换行、行高与视图设置。这个结果只覆盖相应文件与软件环境，没有证明所有数据长度、其他表格软件或跨平台排版都已通过。

这轮修订把导出验证分成了两件事：模型对照检查计算与内容是否保持，桌面检查确认目标文件能否读清。文件能够下载是起点，能看懂其对象、口径和结果，才符合这类报表的使用要求。