文档部署到 /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；
  看板顶栏窄屏下拉与按钮换行，消除横向滚动

tests/run-all.sh

@@ -4,9 +4,18 @@
 set -e
 cd "$(dirname "$0")/.."
 
-PHP="${PHP_BIN:-C:/Users/Zhang/.workbuddy/binaries/php/php.exe}"
-NODE="${NODE_BIN:-C:/Users/Zhang/.workbuddy/binaries/node/versions/22.22.2-2/node.exe}"
+# 运行期路径：优先用环境变量，其次用本机工作区路径，最后退回 PATH 里的 php / node
+# （工作区 node 的版本目录会随升级变化，写死路径会直接 No such file or directory）
+pick() {
+  local cand="$1" fallback="$2"
+  if [ -n "$cand" ] && [ -x "$cand" ]; then echo "$cand"; return; fi
+  command -v "$fallback" 2>/dev/null || echo "$fallback"
+}
+PHP="$(pick "${PHP_BIN:-C:/Users/Zhang/.workbuddy/binaries/php/php.exe}" php)"
+NODE="$(pick "${NODE_BIN:-}" node)"
 INI="-d extension_dir=C:/Users/Zhang/.workbuddy/binaries/php/ext -d extension=pdo_sqlite"
+echo "PHP  = $PHP"
+echo "NODE = $NODE"
 
 echo "================ PHP 自测 ================"
 for f in tests/test-aggregate.php tests/test-new-features.php tools/test-xlsxwriter.php; do

tests/test-new-features.php

@@ -1,10 +1,9 @@
 <?php
 /**
  * 新功能回归测试：
- * 1) 异常检测 detectAnomalies（短时长高分 / 高频重考 / 雷同成绩）
- * 2) 成绩快照 Snapshot::summarize / trend
- * 3) 成绩明细排序：再次提交应置顶（last_submit_ts 排序）
- * 4) XlsxWriter 多工作表 renderMulti（分表 + 名字去重/截断）
+ * 1) 成绩明细排序：再次提交应置顶（last_submit_ts 排序）
+ * 2) XlsxWriter 多工作表 renderMulti（分表 + 名字去重/截断）
+ * 3) 名单导入列识别 rowsToStudents（表头识别 / 去重 / Excel 数字尾巴）
  */
 declare(strict_types=1);
 require __DIR__ . '/../bootstrap.php';
@@ -18,75 +17,6 @@ function check(string $name, bool $cond, string $detail = ''): void
     else       { $fail++; echo "  ❌ {$name}  {$detail}\n"; }
 }
 
-/* ============ 1) 异常检测 ============ */
-echo "\n== 异常检测 ==\n";
-
-// 构造：3 人同分（雷同）、1 人短时长高分、1 人高频重考
-function mkRow(string $sid, string $name, ?float $score, ?int $duration, int $attempts): array
-{
-    return [
-        'sid' => $sid, 'name' => $name, 'cls' => '1班', 'grp' => 'A',
-        'score' => $score, 'duration' => $duration, 'duration_txt' => $duration === null ? '-' : ($duration . '秒'),
-        'attempts' => $attempts, 'best_score' => $score,
-    ];
-}
-
-$rows = [
-    mkRow('S01', '甲', 90.0, 600, 1),
-    mkRow('S02', '乙', 90.0, 610, 1),   // 与甲同分
-    mkRow('S03', '丙', 90.0, 620, 1),   // 三人同分 → 雷同
-    mkRow('S04', '丁', 95.0, 30,  1),   // 短时长（30s）+ 高分
-    mkRow('S05', '戊', 70.0, 500, 9),   // 高频重考 9 次
-];
-$stats = ['avg_duration' => 600, 'max_score' => 100.0];
-$anom = DataService::detectAnomalies($rows, $stats);
-
-check('雷同成绩：捕获 90 分 3 人组', count($anom['identical']) >= 1 && (float)$anom['identical'][0]['score'] === 90.0,
-    json_encode($anom['identical'], JSON_UNESCAPED_UNICODE));
-check('雷同成绩：人数 = 3', (int)($anom['identical'][0]['count'] ?? 0) === 3);
-check('短时长高分：捕获丁', count($anom['fast_high']) >= 1 && ($anom['fast_high'][0]['sid'] ?? '') === 'S04',
-    json_encode($anom['fast_high'], JSON_UNESCAPED_UNICODE));
-check('高频重考：捕获戊（9 次）', count($anom['frequent']) >= 1 && ($anom['frequent'][0]['sid'] ?? '') === 'S05',
-    json_encode($anom['frequent'], JSON_UNESCAPED_UNICODE));
-check('正常学生（甲 1 次）不被误报高频', !in_array('S01', array_column($anom['frequent'], 'sid'), true));
-
-/* ============ 2) 快照 summarize / trend ============ */
-echo "\n== 成绩快照 ==\n";
-
-$result1 = [
-    'project' => ['id' => 'P1', 'name' => '数学测验'],
-    'stats'   => ['avg_score' => 85],
-    'rows'    => [
-        ['sid' => 'S01', 'name' => '甲', 'cls' => '1班', 'grp' => 'A', 'score' => 90, 'best_score' => 95, 'attempts' => 2, 'last_submit_at' => '2026-09-10 10:00:00'],
-        ['sid' => 'S02', 'name' => '乙', 'cls' => '1班', 'grp' => 'A', 'score' => 80, 'best_score' => 80, 'attempts' => 1, 'last_submit_at' => '2026-09-10 10:05:00'],
-    ],
-];
-$result2 = [
-    'project' => ['id' => 'P1', 'name' => '数学测验'],
-    'stats'   => ['avg_score' => 88],
-    'rows'    => [
-        ['sid' => 'S01', 'name' => '甲', 'cls' => '1班', 'grp' => 'A', 'score' => 92, 'best_score' => 96, 'attempts' => 3, 'last_submit_at' => '2026-09-10 12:00:00'],
-        ['sid' => 'S03', 'name' => '丙', 'cls' => '2班', 'grp' => 'B', 'score' => 88, 'best_score' => 88, 'attempts' => 1, 'last_submit_at' => '2026-09-10 12:10:00'],
-    ],
-];
-
-$snap1 = Snapshot::summarize($result1, '第一次');
-$snap2 = Snapshot::summarize($result2, '第二次');
-$snap1['at'] = 100; $snap2['at'] = 200;   // 固定时间戳便于排序
-
-check('summarize 抽取学生数 = 2', count($snap1['students']) === 2);
-check('summarize 保留 best_score', (float)$snap1['students'][0]['best_score'] === 95.0);
-check('summarize 按学号排序', $snap1['students'][0]['sid'] === 'S01' && $snap1['students'][1]['sid'] === 'S02');
-
-$trend = Snapshot::trend([$snap1, $snap2]);
-check('trend 列数 = 2（两份快照）', count($trend['columns']) === 2, 'got ' . count($trend['columns']));
-check('trend 列按时间升序（先第一次后第二次）', $trend['columns'][0]['label'] === '第一次' && $trend['columns'][1]['label'] === '第二次');
-check('trend 行数 = 3（S01/S02/S03 并集）', count($trend['rows']) === 3, 'got ' . count($trend['rows']));
-$s01 = null; foreach ($trend['rows'] as $r) { if ($r['sid'] === 'S01') $s01 = $r; }
-check('S01 两次快照成绩 = 95 / 96', $s01 !== null && $s01['scores'][$trend['columns'][0]['key']] == 95 && $s01['scores'][$trend['columns'][1]['key']] == 96);
-$s02 = null; foreach ($trend['rows'] as $r) { if ($r['sid'] === 'S02') $s02 = $r; }
-check('S02 第二次快照缺席记 null', $s02 !== null && !array_key_exists($trend['columns'][1]['key'], $s02['scores']));
-
 /* ============ 3) 排序：再次提交置顶 ============ */
 echo "\n== 排序（last_submit_ts 置顶）==\n";
 // 甲：代表成绩=最高分(98，早提交)；最近一次提交=重考 70（晚提交）→ last_submit_ts 更晚，应排在乙前
@@ -101,7 +31,7 @@ usort($aggRows, static function (array $x, array $y) use ($sortTs): int {
 });
 check('重考后的甲（last_submit_ts=5000）排在乙前', $aggRows[0]['sid'] === 'S01', json_encode($aggRows, JSON_UNESCAPED_UNICODE));
 
-/* ============ 4) XlsxWriter 多工作表 ============ */
+/* ============ 2) XlsxWriter 多工作表 ============ */
 echo "\n== XlsxWriter 多工作表 ==\n";
 $sheets = [
     ['name' => '1班', 'rows' => [['学号', '姓名'], ['S01', '甲']], 'widths' => [16, 14]],
@@ -132,6 +62,24 @@ if (class_exists('ZipArchive')) {
 check('产出 5 个工作表文件', count($names) === 5, 'got ' . count($names) . ': ' . json_encode($names));
 check('sheet 文件名连续 sheet1..sheet5', in_array('xl/worksheets/sheet5.xml', $names, true));
 
+/* ============ 3) 名单导入列识别 ============ */
+echo "\n== 名单导入列识别 ==\n";
+$meta   = [];
+$parsed = Roster::rowsToStudents([
+    ['学号', '姓名', '班级', '组别', '登陆账号'],
+    ['2024012001.0', '张三', '1班', 'A', 'stu001'],
+    ['2024012002', '李四', '1班', 'B', 'stu002'],
+    ['2024012001', '张三重复', '1班', 'A', 'stu001'],  // 学号重复 → 跳过
+    ['', ''],                                          // 空行 → 跳过
+], $meta);
+check('识别到 2 人（重复学号与空行被跳过）', count($parsed) === 2, json_encode($parsed, JSON_UNESCAPED_UNICODE));
+check('学号去掉 Excel 数字尾巴 .0', ($parsed[0]['sid'] ?? '') === '2024012001', (string)($parsed[0]['sid'] ?? ''));
+check('识别班级 / 组别 / 登陆账号列',
+    ($parsed[0]['cls'] ?? '') === '1班' && ($parsed[0]['grp'] ?? '') === 'A' && ($parsed[0]['login'] ?? '') === 'stu001',
+    json_encode($parsed[0] ?? [], JSON_UNESCAPED_UNICODE));
+check('重复学号记入 duplicates', (int)($meta['duplicates'] ?? 0) === 1, (string)($meta['duplicates'] ?? ''));
+check('空行记入 skipped', (int)($meta['skipped'] ?? 0) === 1, (string)($meta['skipped'] ?? ''));
+
 echo "\n========================================\n";
 echo "通过 {$pass} · 失败 {$fail}\n";
 exit($fail === 0 ? 0 : 1);