feat(export/dashboard): 导出增强与大屏公开化

导出-每次考试/多考试对比：
- 合格次数阈值等标记项抽为常显区块，三类成绩表共用
- 附缺考名单扩展到多考试导出（取所选考试全都没交的人）
- 块表每场固定2列（成绩+合并空位），修复漏推空串导致的整行左移/串列
- 列宽按实际内容估算，合并区空位只给最小宽度
- 合格次数始终显示实际次数(含0)，仅 ≥ 阈值标绿底
- 打印标题改为「成绩明细」，缺考名单分页单独成页
- 打印样式加 print-color-adjust:exact，绿底/红字可正常印出

数据大屏：
- ?class= 班级大屏免登录公开访问，接口侧放行并按班级裁剪后回传
- 单班大屏移除退出按钮，仅首页保留
- 修复红绿判定真bug：membersTable 误用 window.DASH(DASH为let声明取不到)
  改为 scoreGrade() 直接读自由变量，按后台合格率正确判红/黄/绿

测试/样例/文档同步更新，全量回归通过。

docs/guide/dashboard.md

@@ -1,20 +1,43 @@
-# 数据看板
+# 数据大屏
 
-数据看板（`dashboard.php`）是**面向投屏 / 大屏**的汇总视图，适合考试进行中实时监控提交进度。
+数据大屏（`dashboard.php`）是**面向投屏 / 大屏**的汇总视图，适合考试进行中实时监控提交进度。
+它有两种形态，由 URL 决定：
 
-从主页面顶部导航 **📊 数据看板** 打开（新标签页）。
+| 形态 | 打开方式 | 长什么样 |
+| --- | --- | --- |
+| **首页（班级入口）** | 从主页面顶部导航 **📊 数据大屏** 打开，或直接访问 `dashboard.php` | 先选试卷 / 考试，下方以卡片列出该卷的所有班级；点卡片进入该班大屏 |
+| **单班大屏** | 点首页的班级卡片（等价于 `dashboard.php?pid=<问卷ID>&class=<班级名>`） | 只展示这一个班：5 张汇总卡 + 分组对比 / 成员榜 |
 
-## 顶部操作
+首页是"入口"，不是概览页——它不堆指标，只做一件事：让你**一次看到有哪些班，点进去看单个班**。
 
-| 控件 | 说明 |
-| --- | --- |
-| 问卷 / 考试 | 选择要展示的试卷 |
-| 班级 | 选择后只展示该班级（需先选试卷） |
-| 自动刷新开关 + 间隔 | 与主页面一致的 5 / 10 / 15 / 30 / 60 / 120 秒 |
-| 刷新 | 立即拉取一次（跳过缓存） |
-| ⛶ 全屏 | 进入 / 退出全屏，布局自动铺满 |
-| ← 主系统 | 返回主页面（成绩明细 / 名单 / 抽取）；全屏状态下也可直接返回 |
-| 退出 | 退出登录 |
+## 单班大屏是公开的，可以直接发链接
+
+`dashboard.php?pid=<问卷ID>&class=<班级名>` **不需要登录**，任何人打开都能看到这一个班的数据
+（顶栏带「公开 · 无需登录」角标）。适合直接把链接发到班级群让孩子或家长自己看。
+
+::: danger 公开的是"这一个班"，不是全卷
+接口在**服务端**先按 `class` 把名单和答卷裁剪掉，再回传数据：公开链接拿不到全卷汇总，
+也拿不到其它班级的成绩。想看别的班，打开那个班自己的链接即可；不带 `class` 参数的
+大屏首页仍然要求登录。
+:::
+
+::: warning 单班大屏没有回头路
+单班大屏**不显示**班级下拉、「← 主系统」和「退出」，页面内部也不存在回到首页的链接；
+浏览器**后退键同样被屏蔽**（页面加载后立刻 `pushState` 占位，任何 `popstate` 都再推回去）。
+想回主系统或换班，请在地址栏改 URL，或关闭标签页重新从首页进入。
+:::
+
+## 顶部控件
+
+| 控件 | 首页 | 单班大屏 |
+| --- | :-: | :-: |
+| 问卷 / 考试 | ✅ | ✅ 切换后若该班不在新卷名单里，会自动落到第一个班 |
+| 班级 | ✅ | ❌ 由 URL 固定，不提供切换 |
+| 自动刷新开关 + 间隔 | ✅ | ✅ |
+| 刷新 | ✅ | ✅ |
+| ⛶ 全屏 | ✅ | ✅ |
+| ← 主系统 | ✅ | ❌ 由 CSS 隐藏 |
+| 退出 | ✅ | ❌ 页面里不再渲染 |
 
 ::: tip 后台标签页会自动暂停
 切换到其他标签页后看板会**停止轮询**，切回来时立即补拉一次数据并重新开始计时——
@@ -22,14 +45,41 @@
 **刷新中断（仍显示上次数据）**，鼠标悬停可看到具体原因。
 :::
 
-## 汇总卡片
+## 首页：班级入口卡片
 
-`总人数 / 已提交 / 缺考 / 提交率 / 平均分 / 合格率(≥X%满分)`
+每张卡片给出该班的速览，点整张卡片（或聚焦后按回车）进入该班大屏：
+
+`总人数 / 已提交 / 缺考 / 平均分 / 合格率` + 一条提交率进度条；没交过卷的班也能一眼看到缺考数。
+
+::: tip 首页也在自动刷新
+首页同样受自动刷新开关控制（默认 15 秒），卡片上的数字会跟着变，适合把整层楼/整个年级的
+提交进度投在一块屏上。
+:::
+
+## 汇总卡片（单班大屏）
+
+`总人数 / 已提交 / 缺考 / 平均分 / 合格率(≥X%满分)`
 
 合格率卡片的阈值标签会随 [每卷配置](./project-config.md) 实时变化。
 
+## 成绩的红绿怎么定的
+
+成员榜（以及「刷 N 次」下钻弹窗）里的成绩颜色**完全按 [每卷配置](./project-config.md) 里
+管理员设的满分与合格率**判定，不是写死的：
+
+| 占满分的比例 | 颜色 |
+| --- | --- |
+| ≥ 90%（合格线本身高过 90% 时则以合格线为准） | 🟢 绿 |
+| ≥ 合格率 × 满分（合格但未达优秀） | 🟡 黄 |
+| < 合格率 × 满分（不及格） | 🔴 红 |
+
+例如把本卷满分改成 150、合格率改成 80%，那么 100 分只占 66.7% → 判红，130 分（86.7%）判黄，
+145 分（96.7%）判绿。鼠标悬停在分数上会显示「占满分 xx%　合格线 xx 分」。
+
 ## 班级 / 组别下钻
 
+（即单班大屏的主体部分）
+
 看板主体按**班级**分块，每块内再按**组别**对比，指标与统计口径完全相同：
 总人数、已提交、缺考、提交率、平均分、合格率、最高分、最低分、平均用时。
 

docs/guide/export-print.md

@@ -1,88 +1,194 @@
 # 导出与打印
 
-## 导出成绩明细
+工具栏下方只有一个 **导出** 按钮，所有导出与打印的选项都收在这个弹窗里，不再散落多个小按钮。
+选项在你打开弹窗前就配好了会**自动记住**（存本地），下次打开就是上次的设置。
 
-工具栏下方「导出」条里的 **导出成绩**，生成 `.xlsx`（零依赖，仓库内自行实现 XLSX 写入，不需要 `zip` 扩展也能用）。
-导出控件单独成行，与筛选、刷新分开，不会挤在一起。
+> 生成的是 `.xlsx`：零依赖，仓库内自行实现 XLSX 写入，没有 `zip` 扩展也能用。
 
-### 三种可选模式
+## 导出弹窗
+
+| 分区 | 内容 |
+| --- | --- |
+| **导出内容** | 成绩明细 / 每次考试 / 缺考名单 / 多考试对比（四选一，选中后下方分区跟着变） |
+| **统计范围** | 班级 / 组别多选（不选 = 全部，按住 `Ctrl` / `⌘` 多选） |
+| **成绩口径与列** | 每人成绩（最新 / 最高）、排序、出表方式、按班级分工作表、附缺考名单 |
+| **多考试对比** | 表格形态、对比成绩、勾选要对比的考试 |
+| **附加内容** | 附缺考名单（成绩明细 / 每次考试 / 多考试对比 都出工作表） |
+| **标记与合格次数** | 合格次数阈值、最高分标红、输出「合格次数」行 |
+| **打印设置** | 纸张方向、打印标题 |
+
+- 分区随「导出内容」显隐：选 **缺考名单** 时只保留范围与打印设置；
+  选 **多考试对比** 时才出现考试勾选表；
+- **附加内容** 与 **标记与合格次数** 是三类成绩表共用的，不随导出内容消失；
+  「按班级分工作表」只有成绩明细支持（置灰不可勾选）；
+- 弹窗底部有**一句话汇总**（导什么、哪些考试、多大范围），导错了一眼能看出来；
+- 打印走隐藏 iframe 调起，**不会被浏览器弹窗拦截挡掉**，也不会多开标签页。
+
+### 成绩明细：每人最新成绩 / 最高成绩
+
+**默认按每人最新成绩显示**（最近一次真实提交），可选 **最高成绩**（该生在这些考试里的最高分）。
 
 | 选项 | 效果 |
 | --- | --- |
-| 导出排序 | `按提交时间` / `按学号` / `按成绩降序` / `按成绩升序` |
-| 按最新成绩 | 每人**只导一行**：最近一次成绩 + 最高分 + 考试次数 |
-| 按班级分表 | 一个班级一个工作表（xlsx 多工作表） |
+| 每人成绩 | `最新成绩`（默认）/ `最高成绩` —— 每人一行时的代表成绩 |
+| 排序 | `按提交时间` / `按学号` / `按成绩降序` / `按成绩升序` |
+| 出表方式 | `每人一行（汇总）`（默认）/ `每次考试一行（明细）`：明细模式保留每位学生的历史提交 |
+| 附缺考名单 | 默认开；只导成绩时取消勾选（接口 `noAbsent=1`）。**每次考试 / 多考试对比 也支持**，口径为「名单里有、所选考试全都没交」 |
+| 按班级分工作表 | 一个班级一个工作表（xlsx 多工作表） |
 
-### 列
+默认列：`学号 / 姓名 / 班级 / 组别 / 成绩 / 最高分 / 考试次数 / 最近提交时间 / 考试时长 / 考试时长(秒)`。
 
-默认列（全部记录模式）：
+## 「每次考试」块表（多场对比，主推格式）
 
-`学号 / 姓名 / 班级 / 组别 / 成绩 / 考试次数 / 第几次 / 提交时间 / 考试时长 / 考试时长(秒)`
+勾选多场考试，选 **两行表头** 形态。**一列「第几次」被所有考试共用**，每场考试占 2 列，
+学生块末尾多一行 **合格次数**。
 
-按最新成绩模式：
+| 学号 | 姓名 | 第几次 | 第一次月考·数学 | | 第一次月考·英语 | |
+| --- | --- | --- | --- | --- | --- | --- |
+| | | | 成绩 | | 成绩 | |
+| （合并） | （合并） | 1 | 112 | 112 | 130 | |
+| （合并） | （合并） | 2 | 100 | | 129 | |
+| （合并） | （合并） | 3 | **136** | | **133** | |
+| （合并） | （合并） | **合格次数** | 3 | | 3 | |
+| 356002 | 李四 | 1 | （合并）**未考** | | 128 | |
+| （合并） | （合并） | **合格次数** | | | 1 | |
 
-`学号 / 姓名 / 班级 / 组别 / 最新成绩 / 最高分 / 考试次数 / 最近提交时间 / 考试时长 / 考试时长(秒)`
+规则：
 
-> 学号等长数字列统一按**文本格式**写入，不会被 Excel 转成科学计数法，也不会被当作公式执行。
+- **学生块高度** = 该生在所有勾选考试里最多的那次次数 + 1（末行是合格次数）；
+- **学号 / 姓名**按学生块纵向合并；**第几次**只合并到最后一次考试行，末行留给「合格次数」标签；
+- **考试名称横跨 2 列**，第二行是 `成绩` 小标题；
+- **没考的考试**（整场没有该生记录）→ 该场 2 列 × 学生块高合并成一个 **`未考`** 格子；
+- **排序**：学生按学号升序（出现班级 / 组别列时按 班级 → 组别 → 学号）；
+- **暂存草稿**：默认不导出、也不占「第几次」编号。
+
+### 单场考试的宽表版式
+
+只导出 **一场** 考试时，改用更清楚的宽表：每人一行，第几次直接做列名。
+
+| 学号 | 姓名 | 第1次 | 第2次 | 第3次 | 合格次数 |
+| --- | --- | --- | --- | --- | --- |
+| 356001 | 张三 | 112 | 100 | **136** | 3 |
+| 356002 | 李四 | **128** | | | 1 |
+
+导出与打印用的是同一套判定，所以单场和「多场块表」的标记完全一样。
+
+## 红 / 绿标记
+
+| 标记 | 条件 | 效果 |
+| --- | --- | --- |
+| **最高分标红** | 该场该生成绩 = 该场最高分 | 红字加粗（同分只标最早达成的那次） |
+| **合格次数标绿** | 该场该生达到合格线的次数 ≥ 阈值 | 绿底加粗 |
+| 合格次数未达标 | 未达阈值 | **仍显示实际次数**（含 0 次），只不标绿 |
+
+- 合格线 = 该场**本卷满分 × 合格率**（每个试卷各自的配置，不是全场统一一条线）；
+- 阈值在弹窗里可改（默认 1 次）；关掉「最高分标红」或「合格次数行」就只出表不标记；
+- 整场没考的不参与合格次数判定，直接是 `未考`；
+- 学号等长数字列统一按**文本格式**写入，不会被 Excel 转成科学计数法，也不会被当公式执行；
+- 打印与导出的 Excel 用同一份服务端装配结果（红字 / 绿底也来自同一份 `cell_styles`），
+  不存在「导出一个样、打印另一个样」。
+
+## 班级 / 组别列什么时候出现
+
+| 选择情况 | 班级列 | 组别列 |
+| --- | --- | --- |
+| 只选 1 个班级、未选组别 | 不出 | 不出 |
+| 选 ≥2 个班级 | **出** | 未选组别时按数据判断（数据跨多组才出） |
+| 只选 1 个班级但选 ≥2 个组别 | 不出 | **出** |
+| 什么都不选（= 全部） | 数据跨 ≥2 个班级才出 | 数据跨 ≥2 个组别才出 |
+
+- 出列时**连续相同班级 / 组别的单元格会纵向合并**（顺序按 班级 → 组别 → 学号），一个班只占一格；
+- 也可以用接口参数 `withCls=1` / `withGrp=1` 强制出列（`=0` 强制不出）。
+
+### 其它形态
+
+| 表格形态 | 产出 |
+| --- | --- |
+| 两行表头（每次考试 + 合格次数） | 上面那套块表（**默认**） |
+| 成绩对比（每人一行） | 一行一个学生、一列一场考试，成绩取「最新」或「最高」 |
+| 两者都出 | 第一张块表 + 第二张成绩对比表 |
 
 ### 文件名
 
 ```
-成绩明细_<试卷名>[_<班级>][_<组别>][_最新成绩]_<YYYYMMDD_HHMMSS>.xlsx
+成绩明细_<试卷名>[_<班级>][_<组别>][_最新成绩|_最高成绩]_<YYYYMMDD_HHMMSS>.xlsx
+每次考试_<试卷名>[_<班级>][_<组别>]_<YYYYMMDD_HHMMSS>.xlsx
+缺考名单_<试卷名>[_<班级>][_<组别>]_<YYYYMMDD_HHMMSS>.xlsx
+多考试成绩对比_<N>场[_<班级…>][_<组别…>]_<最新成绩|最高分>_<YYYYMMDD_HHMMSS>.xlsx
+每次考试与成绩对比_<N>场[_<班级…>][_<组别…>]_<YYYYMMDD_HHMMSS>.xlsx   # 两者都出
 ```
 
 ### 跟随筛选
 
 导出**完全跟随页面当前的班级 / 组别筛选**，缺考口径也与页面一致
-（筛选后名单 − 筛选后已提交，按学号匹配），不会出现"页面上 30 人、导出 50 人"的情况。
+（筛选后名单 − 筛选后已提交，按学号匹配），不会出现「页面上 30 人、导出 50 人」的情况。
 
-## 导出缺考名单
-
-工具栏 **导出缺考**，列为 `学号 / 姓名 / 班级 / 组别`，按学号升序。
-
-## 打印成绩明细
-
-成绩明细面板右上角 **打印**，弹窗里可设置：
+## 打印
 
 | 选项 | 说明 |
 | --- | --- |
-| 打印标题 | 默认「试卷名 + 成绩明细」，可改成学校/考试正式名称 |
-| 排序方式 | 成绩降序（默认）/ 升序 / 学号 / 提交时间 |
-| 分组对比 | 按班级或组别分段，段首给出小计（人数/平均/最高/最低/合格人数与合格率） |
-| 纸张方向 | A4 纵向（列少清晰）或横向（列多不折行） |
-| 显示名次 | 全表连续编号，不分组也不会因为分段重新从 1 开始 |
-| 显示「是否合格」列 | 低于合格线的成绩与「不合格」标红，一眼定位 |
-| 显示考试次数 | 便于发现反复重考的人 |
-| 附缺考名单 | 成绩表后**另起一页**附缺考名单，带空白备注列供手写 |
+| 打印标题 | 默认按考试名自动生成，可改成学校 / 考试正式名称 |
+| 纸张方向 | 多考试打印默认 **横向**（列多不折行），可改纵向 |
+| 成绩明细的分组对比 | 按班级或组别分段，段首给出小计（人数 / 平均 / 最高 / 最低 / 合格人数与合格率） |
+| 成绩明细的显示选项 | 显示名次、显示「是否合格」列、显示考试次数、附缺考名单 |
 
-其它细节：
+- 表头在**每一页自动重复**，行不会被切断到两页；两行表头都放进 `<thead>`；
+- 页眉含范围（班级 / 组别）、打印时间、人数、平均分、最高 / 最低、合格人数与合格线；
+- 页脚含**教师 / 教研组长签字栏与日期**，可直接签字归档。
 
-- 表头在**每一页自动重复**，行不会被切断到两页；
-- 页眉含范围（班级/组别）、打印时间、人数、平均分、最高/最低、合格人数与合格线；
-- 页脚含**教师 / 教研组长签字栏与日期**，可直接签字归档；
-- 打印走隐藏 iframe 调起，**不会被浏览器的弹窗拦截挡掉**，也不会多开标签页。
+成绩明细面板右上角的**打印**与导出弹窗里的打印设置是同一套（打印标题、方向、分组对比都在弹窗里改）。
 
-## 打印缺考名单
+::: tip 绿底 / 红字要能印出来
+打印样式里写了 `print-color-adjust: exact`，**不需要**在打印对话框里手动勾选「背景图形」，
+Chrome / Edge 会照常输出绿底与红字。若仍看不到底纹，检查是否换用了不支持该属性的浏览器。
+:::
 
-缺考名单面板右上角 **打印**：按班级分组、班内按学号排序，同样带页眉与签字栏，
-备注列留空供手写说明（请假、缓考等）。
+::: tip 缺考名单单独成页
+勾选「附缺考名单」后，缺考名单工作表会在打印时**另起一页**（不会挤在成绩表底部），便于分开归档。
+:::
 
 ## 直接调用导出接口
 
 需要对接其它系统时，可以带参数直接 GET（需已登录）：
 
 ```
-api.php?action=export&projectId=xxx&cls=1&grp=A&mode=latest&split=cls&sort=score_desc&cols=sid,name,score
+# 成绩明细（每人一行最新 / 最高）
+api.php?action=export&projectId=xxx&cls=1班,2班&grp=A组&mode=latest&scoreMode=best&sort=score_desc
+# 「每次考试」块表（多场）
+api.php?action=export_multi&projectIds=a,b&mode=block&passTimes=1
+# 单场宽表版式（每人一行，第几次做列名）
+api.php?action=export_multi&projectIds=a&mode=block&wide=1
+# 多考试：成绩对比 / 两者都出
+api.php?action=export_multi&projectIds=a,b&mode=summary&scoreMode=highest
+api.php?action=export_multi&projectIds=a,b&mode=both
+# 「多考试打印」用的数据（不下载文件，返回 rows / merges / header_rows / cell_styles）
+api.php?action=export_multi&projectIds=a,b&mode=block&format=json
+# 缺考名单
+api.php?action=export_absent&projectId=xxx
 ```
 
 | 参数 | 取值 | 说明 |
 | --- | --- | --- |
-| `projectId` | 试卷 ID | 必填 |
-| `cls` / `grp` | 班级 / 组别 | 与页面筛选一致 |
-| `mode` | `latest` | 每人一行最新成绩；缺省导出全部记录 |
+| `projectId` | 试卷 ID | 必填（`export_multi` 用 `projectIds`，逗号分隔，可只传一场） |
+| `cls` / `grp` | 班级 / 组别 | 与页面筛选一致；`export_multi` 支持**多选**（逗号分隔），空 = 全部 |
+| `mode` | `latest` / `all` | `export` 的成绩明细：每人一行（默认，取最新）/ 每次考试一行 |
+| `scoreMode` | `latest` / `best` | 每人一行的代表成绩：最新（默认）/ 最高 |
+| `mode`（`export_multi`） | `block` / `summary` / `both` | 每次考试块表（默认）/ 成绩对比 / 两者都出；旧值仍兼容：`matrix`→`summary`、`merged`·`attempts`→`block` |
+| `wide` | `1` | 单场 `block` 时改用宽表版式（每人一行、第几次做列名） |
+| `passTimes` | 正整数 | 合格次数达标阈值（默认 1） |
+| `markBest` | `0` | `=0` 取消「最高分标红」 |
+| `passRow` | `0` | `=0` 不输出「合格次数」行（也就没有绿底） |
+| `format` | `json` | 不下载文件，返回 `sheets`（`rows` / `merges` / `header_rows` / `cell_styles`）供打印渲染 |
+| `withCls` / `withGrp` | `1` / `0` | 强制出 / 不出班级、组别列；缺省按上表规则自动判断 |
+| `noAbsent` | `1` | 成绩明细不附缺考名单 |
+| `skipTemp` | `1` | `mode=all` 时排除暂存草稿 |
+| `includeTemp` | `1` | 每次考试块表保留暂存草稿（标注为 `第N次（草稿）`） |
+| `sort` | `time` / `sid` / `score_desc` / `score_asc` | 成绩明细排序（块表恒按 班级 → 组别 → 学号 / 学号） |
 | `split` | `cls` | 按班级拆分多工作表 |
-| `sort` | `time` / `sid` / `score_desc` / `score_asc` | 排序 |
-| `cols` | 逗号分隔列名 | 从默认列中挑选 |
+| `cols` | 逗号分隔列名 | 从默认列中挑选（仅 `export`） |
+
+`format=json` 返回的 `cell_styles` 是 `行,列 → red | green`，行与列都是 **1-based**；
+前端据此加红字 / 绿底，合并区间内的非首格继承左上角首格的标记。
 
 ## 相关
 

docs/guide/introduction.md

@@ -31,9 +31,10 @@ NY 问卷考试系统数据平台是一个**零第三方运行依赖**的 PHP 8
 | 试卷设置 | 为当前选中的试卷单独设置满分 / 合格率 / 免考名单，试卷间互相隔离 |
 | 导出 / 打印 | 成绩明细、缺考名单 `.xlsx`；成绩明细按成绩降序打印，支持分组小计、合格标记、附缺考名单、签字栏 |
 
-### 数据看板 `dashboard.php`
+### 数据大屏 `dashboard.php`
 
-大屏看板，适合投屏。支持全屏切换与自动刷新。
+首页先选试卷，再用卡片列出该卷的班级；点卡片进入该班专属大屏。
+大屏页支持全屏切换与自动刷新，**没有返回按钮，浏览器后退键也被屏蔽**（只能靠地址栏或关标签页离开）。
 
 ### 随机抽取 `draw.php`