中小学教学质量监测系统:四份 Excel,七步出积分表与 A4 存档
适用场景:期中 / 期末 / 质量监测的班级与教师积分计算、结果打印与归档
适用对象:中小学教务处、年级组、备课组
运行环境:Windows 10 / 11,单机离线;无需联网,无需安装 Office
当前构建:2026-11-20(内置自检全部通过,71 项单元测试通过)
一、这个工具解决什么问题
一次考试结束后,把下面四份 Excel 交给程序:
- 出口成绩(本次考试成绩)
- 进口成绩(上次考试成绩,用于算吻合率)
- 分数段统计(县前 100 / 300 / 500 / 1000 / 1500 / 2000 名等分数线)
- 教师任课表
经过七步向导,直接产出:
- 班级积分表:吻合率 40 + 及格率 40 + 平均分 20,满分 100;A 组 / B 组县名次吻合率分析
- 教师积分表:按真实任课关系自动分摊
- 异常核对表:校验异常、进口未匹配学生、出口未参评学生、考号配对裁决
- XLSX 存档版:含计算过程复核工作表,便于复查口径
- 四套 A4 打印任务:① 班级积分表、② 教师积分表、③ 附页(参数 / 异常 / 核对表 / 各班成绩单)、④ 完整存档(①+②+③ 合成一份)
全部计算在本地完成,学生成绩不上传任何服务器。
二、七步工作流
| 步骤 | 名称 | 主要工作 |
|---|---|---|
| ① | 任务信息 | 考试名称、时间、学校;新建 / 打开 / 保存工程;生成标准模板 |
| ② | 基础设置 | 年级、学科、满分、A/B 组规则、班级与参评人数 |
| ③ | 出口数据 | 导入本次成绩,列映射,班级对照,名单核对 |
| ④ | 进口数据 | 导入上次成绩,学校简称,与出口名单配对(考号 / 姓名拼音候选) |
| ⑤ | 分段人数确认 | 从分数段表带入或手工填写各班各分数段人数 |
| ⑥ | 任课表与校验 | 全量读入教师任课表(自动处理合并单元格),裁决考号配对与异常 |
| ⑦ | 计算与输出 | 计算积分、查看结果、导出 XLSX / PDF、打印预览、直接打印 |
首次使用建议:在 ① 页点「生成标准模板」,按模板准备四份 Excel,再依次走七步。
工程文件为 .qmproj(JSON),保存全部设置与手工裁决,下次换表复用;三个版本工程双向兼容,一端保存另一端都能打开,数据不丢、积分一致。
三、仓库位置信息
| 项目 | 信息 |
|---|---|
| 代码仓库 | https://gitee.com/findwings/school-office-toolbox |
| 本工具路径 | /教务/考试质量/ |
| 根目录许可 | AGPL-3.0-or-later(仓库根 LICENSE) |
| 工具说明 | /教务/考试质量/README.md |
| 官网 / 论坛 | https://bbs.edunode.cn |
| 联系邮箱 | edunode@163.com |
仓库还收录了 Excel 文件比较工具、营养餐就餐汇总与月报工作流等其它学校办公工具。本工具目录包含完整源码、三份标准 Excel 模板、71 项单元测试、自检脚本与打包脚本;仓库只存源码,不存 EXE,EXE 由维护者另行分发。
源码自检与打包方式(详见工具目录 README):
pip install -r requirements.txt
python main.py :: 启动
python main.py --self-test :: 内置自检,退出码 0 = 全部通过
python tools/build_exe.py :: 自行打包单文件 EXE
四、三个版本:获取方式与功能差异
三个版本共用同一套计算引擎与向导,积分口径、工程格式、输出产物完全一致;差别只在「获取方式、授权状态、若干手工精调能力」三处。
版本一:开源版(AGPL-3.0-or-later)
获取方式:从 Gitee 仓库克隆或下载源码,进入 /教务/考试质量/,按 README 用 python main.py 运行,或用 python tools/build_exe.py 自行打包单文件 EXE。
git clone https://gitee.com/findwings/school-office-toolbox.git
cd school-office-toolbox/教务/考试质量
pip install -r requirements.txt
python main.py
特点:完整的积分计算、成绩导入、考号配对、核对表、XLSX 存档与 A4 打印能力;无试用期限、无任何授权机制。按 AGPL-3.0-or-later 自由使用、修改、再分发;分发修改版时须一并提供完整对应源代码。
边界:五项商业增强功能以「自动推断 + 只读查看」形式提供(详见第五节)。
版本二:共享版(免费试用 30 天)
获取方式:在本帖附件或官网论坛(https://bbs.edunode.cn)下载 中小学教学质量监测系统_共享版.exe,Windows 下双击即用,无需安装 Python 与依赖。
特点:首次运行起 30 天试用,试用期内全部功能(含五项商业增强)开放,与正式版体验一致。顶部步骤条右侧显示剩余天数,剩 7 天时提醒。适合用一个真实考试周期验证流程与结果。
试用结束后:①~⑥ 的数据录入、导入、配对裁决、分段、任课校验照常可用,工程文件的打开与保存永远可用(数据不被锁死);⑦ 计算与输出整步锁定,新导出文件叠加浅色提示水印(只作用于新导出,不追溯已有档案,不加密、不设打开密码)。
30 天不是随手定的:质量监测是学期节点性工作,从准备数据到归档往往跨越数周,14 天不够一个完整备考周期。
版本三:商业版(正式授权,一机一码)
获取方式:使用共享版 EXE(或向作者索取同版程序),在窗口底部点「授权…」→ 点「复制」取得本机机器码(24 位,形如 XXXX-XXXX-XXXX-XXXX-XXXX-XXXX)→ 将机器码连同单位名称、需要的电脑台数发至 edunode@163.com(官网论坛私信或微信好友亦可)→ 收到以 QMS1. 开头的授权码后粘贴进授权窗口点「✔ 激活」;也可把作者提供的 license.lic 放在 EXE 同目录,重启自动识别。状态显示「✔ 已授权:单位名(剩余 N 天)」即激活成功。
授权规则:一机一码、离线验签,机器码允许 1 项硬件变动;换电脑、换主板需重新签发,续期无需重发机器码。到期后有购买时长 10% 的宽限期(保底 3 天、封顶 7 天),宽限期内全功能且不加水印;超出宽限期降为受限模式。检测到系统时间回拨超过 7 天也会降级,请校准系统日期后重启。
特点:五项商业增强全部开放,⑦ 计算与输出不受限,到期前不产生水印;按授权期限使用。
商业版与共享版是同一个程序,区别只在授权状态;输入授权码后共享版即成为已授权的商业版,无需重装、无需换文件。
五、功能差异速查表
| 对比项 | 开源版 | 共享版(试用 / 到期后) | 商业版(已授权) |
|---|---|---|---|
| 获取方式 | Gitee 仓库源码,自行运行或打包 | 本帖附件 / 官网论坛下载 EXE | 联系作者取得授权码激活 |
| 许可 | AGPL-3.0-or-later | 试用授权 | 闭源商业许可(一机一码) |
| 使用期限 | 无限制 | 首次运行起 30 天 | 按授权期限,到期有 3~7 天宽限 |
| 七步向导、积分计算、核对表 | 完整 | 完整(到期后 ①~⑥ 仍可用) | 完整 |
| ⑦ 计算与输出 | 始终可用 | 试用期内可用;到期锁定 | 授权期内可用 |
| 批量添加班级 | 仅逐行添加 | 试用期内可用;到期退回逐行 | 可用 |
| 批量填充参评人数 | 仅「生成班名」补全 | 试用期内可用;到期退回补全 | 可用 |
| 学校简称手工编辑 | 自动推断,只读查看 | 试用期内可用;到期只读 | 可用 |
| 班级对照手工精调 | 自动推断,只读查看 | 试用期内可用;到期只读 | 可用 |
| 异常原因手工填写 | 只读查看 | 试用期内可用;到期只读 | 可用 |
| 工程文件打开 / 保存 | 始终可用 | 始终可用 | 始终可用 |
| 到期水印 | 无 | 仅受限后新导出文件有提示水印 | 无(宽限期内亦无) |
| 「关于」窗口(仓库 / 官网 / 邮箱 / 二维码) | 无 | 有 | 有 |
| 离线运行、数据不上传 | 是 | 是 | 是 |
| 工程双向兼容 | 是 | 是 | 是 |
关于「商业增强」的补充说明:这五项只控制「能否手工精调」,不影响任何数据与计算——自动推断照常工作,且与手工指定结果一致;工程里的精调值照常读写,受限状态或开源版打开时不丢失、只读显示。因此先用共享版试用、再决定是否激活,或先用开源版跑通流程,都不存在数据迁移成本。
六、常见问题
| 现象 | 处理 |
|---|---|
| 提示「授权码签名无效」 | 授权码被截断或不属于本产品,请重新完整复制 QMS1. 开头的码 |
| 提示「机器码不匹配」 | 授权码绑定的是另一台机器,核对机器码后联系作者重新签发 |
| 提示「系统时间回拨」 | 系统日期被改早超过 7 天或 CMOS 电池没电,校准日期后重启 |
| 点 ⑦ 步「下一步」没反应 | 处于受限模式,点底部「授权…」输入授权码 |
| 导出文件页眉有「请续费激活」 | 导出时处于降级状态,续费后重新导出即可,历史文件不受影响 |
| 想换电脑使用 | 一机一码不转移,把新机器码发给作者签新码 |
| 机器码里没有 I / L / O / U | 故意为之:Crockford Base32 去掉易混字符,输入时 I/L 按 1、O/U 按 0 容错 |
| 底部「授权…」按钮变成竖条 | 旧版按钮布局问题,升级到当前版本即可,正常应在底部按钮行最左侧 |
程序内置自检,可快速确认安装是否完整:
中小学教学质量监测系统.exe --self-test
:: 报告写到同目录 output\自检报告.txt,结论「全部通过」即正常
七、联系与交流
- 代码与问题反馈:https://gitee.com/findwings/school-office-toolbox (Issues)
- 官网论坛:https://bbs.edunode.cn (版本发布、使用交流、改进建议)
- 联系邮箱:edunode@163.com (授权、续期、定制改进)
- 微信:程序右下角「关于」窗口内有微信好友码与收款码,可点击放大、右键另存
本系统基于本校质量监测业务需要创建,也可适用于河南省南召县内中小学使用。如需改进版以适应自己学校需求,欢迎发邮件或加微信与开发者联系;也欢迎进入官网论坛交流。
许可声明:仓库源码为 AGPL-3.0-or-later,可自由使用、修改与再分发(须遵守 AGPL 的源代码提供义务);闭源商业 EXE 与授权服务需另行取得商业许可。程序按「原样」提供,不附带任何明示或默示担保。