Files

T

nxxy335 25a2e8a42c 文档部署到 /ny-exam-platform 子路径 + 移除快照/趋势/异常 + 打印与 UI 全面完善

文档站（#88）
- base 默认改为 /ny-exam-platform/，可用 DOCS_BASE=/ 覆盖本地预览
- 新增 DOCS_OUT 环境变量，避免构建时清空输出目录失败导致产物半截
- 新增 tools/docs-preview.js：按子路径重写路由的本地预览服务
- 删除 docs/guide/snapshot.md，同步清理全部相关文档

移除存快照 / 趋势 / 异常（#89）
- 后端：删除 api.php 的 snapshot_save/list/delete/trend 四个 action 与
  $WRITE_ACTIONS 中的同名条目；删除 lib/Snapshot.php 与自动加载注册；
  DataService 移除 detectAnomalies() 及其调用
- 前端：移除三个按钮与三个弹窗、相关 JS 处理与 state 字段
- 测试：移除对应用例，补充 5 条名单导入列识别断言（17+9+18+32+29+11 全过）

打印完善（#90）
- 改用隐藏 iframe 输出，规避弹窗拦截；@page A4 支持纵向/横向
- 表头每页重复、行内不跨页断开、全表连续名次、可选「是否合格」列
- 分组小计（人数/平均/最高/最低/合格人数与合格率）、可附缺考名单另起一页
- 末尾签字栏；缺考名单打印改为同一套输出

UI / 交互 / Bug 修复（#91）
- dashboard.php：补「← 主系统 / 退出」入口（此前全屏后无法离开）；
  修复成员下钻 onclick 里 JSON.stringify 双引号提前闭合属性导致点击报错，
  改为 data-sid 事件委托；补 Esc 关弹窗；后台标签页暂停轮询、切回自动补拉；
  刷新中断原因写入 title；数值字段统一兜底，避免 NaN / undefined%
- draw.php / draw.js：结果表新增「登陆账号」列（导出前可核对，缺失显示 学号 ⚠）；
  弹窗只关最上层且支持 Esc；「全部」改为跟随候选池，手工改人数即解除；
  候选池不足时给出明确提示；自定义比例框隐藏时清空，避免旧权重被误读
- app.js / dashboard.php：成绩着色改为按「占本卷满分的百分比」判断，
  修复满分不是 100 时整列误标红
- style.css：数值列右对齐；新增 subbar、draw-stage-sub；
  看板顶栏窄屏下拉与按钮换行，消除横向滚动

2026-09-11 16:23:08 +08:00

4.1 KiB

Raw Blame History

成绩明细与统计口径

这一页说明每个数字到底是怎么算出来的，以及表格里的每一列是什么含义。

统计卡片

卡片	计算方式
名单总人数	名单条目数；被当前试卷设为免考的人不计入
已提交	匹配到名单、且提交了答卷的人数（去重后的代表成绩行数）
缺考	`max(0, 名单总人数 − 已提交)`
提交率	`已提交 ÷ 名单总人数 × 100%`——考试进行中最该盯的指标
提交率	`已提交 ÷ 名单总人数 × 100%`
平均分	所有有成绩的答卷成绩平均值；无成绩者不计入分母
最高分 / 最低分	同上，取自所有有成绩的答卷
合格率	`成绩 ≥ 满分 × 合格率阈值` 的人数 ÷ 已提交人数。阈值全局默认 60%，可在试卷设置针对单卷覆盖
平均用时	所有有时长的答卷时长平均值（秒），格式化为「X 分 Y 秒」

::: tip 卡片标题会跟着配置变合格率卡片的标题会实时显示当前阈值，例如「合格率 (≥70%满分)」，避免你误以为还是 60%。 :::

班级 / 组别联动

选择顶部班级下拉后：

全部统计卡片只统计该班级；
成绩明细只显示该班级；
缺考名单只显示该班级，标题右侧计数同步变化；
切换班级是本地即时重算，不会额外请求服务器。

再选组别可做二次切片。

成绩明细列

列	说明
学号 / 姓名 / 班级 / 组别	来自名单；未匹配到的答卷不会进入本表
成绩	卷王返回的 `examScore`；该问卷不是考试模式时为 `-`
考试次数	该学生全部提交次数，与「去重」开关无关
提交时间	最近一次提交时间（重考低分也会让这行按最新时间排序到最上面）
考试时长	最近一次答卷的时长；后台手动录入等没有起止时间的答卷为 `-`

点击任意一行可查看该学生的每一次提交（时间、成绩、时长），最佳成绩有标记。

成绩颜色

成绩按占本卷满分的百分比着色，而不是写死的 90 / 60 分：

颜色	条件
绿色	≥ 满分的 90%
橙色	≥ 合格率线（默认满分的 60%，可在每卷配置里改）
红色	低于合格率线

这样把满分改成 50 分或 20 分制时，不会因为绝对分数偏低而整列误标红。数据看板的成员榜使用同一套规则。

排序与搜索

点击表头即可排序，支持学号 / 姓名 / 班级 / 组别 / 成绩 / 考试次数 / 提交时间 / 时长；
默认排序键是最近提交时间，所以刚交卷的人一定在最上面；
搜索框支持学号 / 姓名模糊匹配，200 ms 防抖；
成绩明细无分页，采用虚拟滚动，几千行也不卡；页面切到后台时自动暂停刷新。

新数据高亮

每次刷新时，与上一次相比新出现的提交（按学号判断）整行显示绿色底纹， 30 秒后自动清除；也可以点 清除高亮 立刻去掉。首屏加载不标记。

去重策略

设置里的「同一学号去重」只决定代表成绩取哪一份（最新 / 最高）：

开关	成绩明细	考试次数	点击行内的历史
开启	一人一行	仍是全部次数	仍是全部提交
关闭	一人多行	仍是全部次数	仍是全部提交

best_score 字段始终是跨全部尝试的真实最高分。

未匹配答卷

提交了、但姓名不在名单中的答卷会单独成面板。常见原因：

姓名前后有空格、写了别名、用了繁体字；
姓名题选错了（到 姓名字段 下拉里手动指定）；
名单里根本没有这个人。

可直接在面板里点 加入名单 补录。

缺考名单

名单中有、但未提交的人。支持 复制学号（逗号分隔）、复制姓名、打印。

4.1 KiB Raw Blame History Unescape Escape