📜 更新历程

📌 版本信息

口径说明：这里写的是应用版本（v3.10 这类，跟着代码走）；容器镜像另有日期标签（如 2026-10-08-19-25-37）。 要确认线上到底跑的是哪一版，直接看 /api/schema/status 的 app_version。

v3.10.1 2026-10-10 最新

• 修复：录分页按「本次成绩/姓名」排序后，回车、自动跳格、整列粘贴仍按原名单顺序走——现在全部跟随排序后的可见顺序，并自动跳过缺考置灰格
• 修复：缺考学生的分数框被硬禁用，取消勾选「缺考」后依然没法输入——补考/补录成绩再也锁不死；取消勾选后分数框自动聚焦，直接填分保存即可
• 修复：取消勾选缺考但没填分数时，保存后缺考标记清不掉、重进页面又弹回勾选——现在明确取消缺考即恢复为「未录入」，改动照常留 score_log 痕迹
• 录分页：场次被管理员锁定时，「缺考」勾选框也一并禁用，锁定状态下不再能改动缺考标记

v3.10 2026-10-08

• 修复：新建场次后会被弹回登录页——建/锁/删场次以前一律跳 /admin（只有管理员能进），科组长、备课组长建完就像掉线；现改为回到操作前那一页并给出结果提示
• 修复：新建的考试无法删除——删除场次从「仅管理员」放宽到「本年级管理者」（科组长全校、备课组长本年级），并在有成绩时先列出「这一删会带走多少条成绩」再二次确认
• 新增：📅 场次管理页（/exams）——新建 / 编辑（类型·周次·名称·考试日期）/ 锁定·解锁 / 删除 / 批量锁定·解锁·删除，管理员与科组长看全校、备课组长只看本年级
• 权限落地：科组长、备课组长可维护本权限范围内的学生名单（增删学生、导入名单）；名单页/导入接口此前只有管理员能写，与界面上的角色说明不符
• 权限提示：已登录但没权限时不再被弹到登录页，改为带到场次管理页并说明「你需要什么身份」；页脚/登录页/更新历程页统一显示真实版本号
• 更新历程页补版本信息卡：应用版本、数据库结构版本与迁移时间、数据表数量，并说明「应用版本 vs 镜像日期标签」两种口径

v3.9 2026-10-06

• 对接智批：新增 POST /api/import/zhipi 成绩推送接收接口（X-Zhipi-Token 共享密钥鉴权，真值只在 NAS compose）
• 对接智批：按班级名找班、同年级同名同类型场次复用/新建，学生按学号→姓名匹配，总分幂等覆盖写入并留 score_log 痕迹（who=智批推送）
• 对接智批：锁定场次拒收（409）、未匹配学生逐人回报，物理周测成绩不再录两遍

v3.8 2026-10-06

• 安全加固：密码哈希升级为 pbkdf2（12万轮+盐），旧 sha256/明文账号登录一次即透明升级，无需重置
• 安全加固：登录限流改记真实客户端 IP（适配反向代理 X-Forwarded-For），修掉“一人爆破全员被锁”的连带误伤
• 安全加固：启动巡检仍为明文/旧哈希的账号并告警，提示管理员处理
• 稳定性：SQLite 开启 WAL + 写锁等待 10 秒，多教师同时录分不再撞 database is locked
• 文档：README 重写对齐模块化后的真实现状；冒烟门禁新增 4 条安全断言（错密码拒绝/哈希升级/真实IP/限流）

v3.7 2026-10-03

• 框架优化：发版门禁上线——构建镜像前自动跑冒烟测试（语法/契约文档新鲜度/真服务全链路/备份自检），不过不发版
• 框架优化：管理后台 admin.py（791行）按域拆为 4 个模块（页面壳/账号/组织/数据），路由表逐条比对一致
• 框架优化：自动备份升级为 VACUUM INTO 一致快照 + 完整性校验 + 原子落位，保留份数 BACKUP_KEEP 可配（默认7）
• 新增：/api/backup/list 管理员备份清单接口（do_backup=1 可立刻补一份）
• 修复：版本号/更新日志曾在 main.py 与 meta.py 双份定义，统一以 meta.py 为唯一来源

v3.6 2026-09-26

• 外观大更新：接入「一家亲」四应用统一设计系统（蓝灰中性色/圆角16px/双层柔和阴影/统一功能色，品牌靛紫保留）
• 动画体系：卡片与指标卡交错入场、按钮按压微交互、消息弹入回弹、登录卡弹入、折叠面板淡入
• 指标数字滚动动效（600ms 缓出），支持系统「减弱动态效果」自动降级
• 纯前端表现层更新，录分/统计/打印等业务逻辑零改动

v3.5 2026-09-24

• 修复：录分进度总表缺考学生不计入已交，导致班级永远显示未录完
• 修复：管理后台场次「已录」人数同样漏算缺考
• 账号管理：支持删除账号（名下班级自动转未分配，学生数据保留）
• 账号管理：批量添加老师（一行一个粘贴导入，可省略登录名/密码/角色）
• 账号管理：列表多选批量操作（批量设角色/指定年级/重置密码/删除）

v3.4 2026-09-24

• 修复：录分页勾选缺考后保存无效的 bug（禁用输入框不随表单提交导致缺考状态丢失）
• 录分页：点整行即可切换缺考，缺考行整行置灰更醒目
• 管理后台重构为分标签页：常用操作零滚动直达，低频信息折叠，手机端横滑切换
• 教师中心改版：我的班级卡片墙置顶（人数/最新成绩/临界生角标），录分操作居中，低频内容收进折叠区
• 录分进度页新增「一键催交」：手动把未交清单立即推送到群
• 新增周报自动推送：每周五把各年级录分完成率与平均分概览推送到群（管理后台可开关）
• 学生详情页新增「打印成绩条」：单个学生成绩条 A4 打印，谈话/家长会随身带
• 看板统计加 30 秒缓存，场次多了打开依然流畅
• 支持 compose + Watchtower 自动更新：发新镜像后 NAS 自动升级，无需手动操作

v3.3.2 2026-09-23

• 班级成绩总览：点任意列表头即可排序（分数/平均分/学号，再点切换升降序），新增姓名/学号筛选框
• 修复 v3.3/v3.3.1 镜像代码路径问题（run.py 加载路径与打包路径不一致导致更新不生效）

v3.3 2026-09-22

• 新增「更新历程」页，页面底部常驻显示当前版本号
• 新增科组长角色：全校数据可见，可管理考试（新建/锁定）、监督录分、导出报表；不接触账号管理与系统设置
• 修复：筛选学期/年级后考试下拉与默认选中不按时间顺序的问题
• 看板默认进入时间上最新一场已录分考试，不用再手动倒回去
• 新板块「班级成绩总览」：本班全体学生 × 本学期各次考试分数矩阵，含班内排名、年级排名、升降箭头
• 排行榜布局可自由设置（每段班级列数/显示名次/显示分数），新增一键导出 Excel（A4 规整单元格样式）
• 权限细化：教师中心新增本班「临界生」卡片（临界优秀/临界及格/连续低分），谈话前一眼掌握
• 录分体验优化：录入为主（自动暂存草稿防丢、未保存提醒、整列粘贴），Excel 上传收进折叠区为辅
• 管理后台新增成绩修改日志分页查询，改分全程可追溯

v3.0 ~ v3.2 2026-09-14

• 多年级/多学期架构：八年级九年级独立考试，学生升级、毕业归档、学期切换
• 名单批量导入（文本/Excel），学号年级内唯一校验，学生调班
• 历史基线导入（上学期期末），大考按时间线自动对比
• 登录门禁与长会话，排行榜按老师折叠，打印版复刻 Excel 样式
• 催交自动推送（企业微信/飞书 webhook），每日自动备份

v2.0 ~ v2.2 2026-09-11

• 大考（一段/二段/期末）与周测分轨对比，考试日期字段
• 第一次周测不显示进步模块；临界生名单折叠
• 手机端界面重做，排行榜拆分网页版与 A4 打印版