docs: 用户文档补齐批次层/成绩框实时提示/窄屏支持/版本号来源/权限说明

docs/使用手册.md

@@ -18,6 +18,8 @@
 
 > 未登录也能进管理面板，只是所有写操作按钮被禁用，顶部会出现「当前为访客只读视图」提示。
 
+> 个别功能对身份要求更高：「大屏控制」里的**切页、公告、锁定 / 解锁、强制刷新**（走服务端指令）记录员及以上可用；**开窗 / 收窗 / 重新排布**是服务管理程序在本机执行的操作（只在从服务管理窗口打开的面板里可用），不受角色限制；同页的「**实时赛况**」配置（模式与当前项目）属于赛事设置，**只有管理员能保存**——非管理员看到的是整组置灰加一行提示条（见第 9 节）。
+
 ### 1.1 登录
 
 1. 打开管理面板地址，进入登录页；
@@ -45,6 +47,8 @@
 
 顶部栏显示：实时连接状态、服务端版本、刷新按钮、当前账号与角色、退出按钮。左侧栏底部有快捷键提示：`Ctrl+Enter` 存草稿、`Alt+Enter` 发布。
 
+**窄窗口 / 手机**：管理面板可以在**窄窗口与手机浏览器**里用（局域网内访问 `http://<主机IP>:19540/admin` 即可）。窄屏下左侧导航收成抽屉（点顶栏的菜单按钮展开）、宽表格可以**横向滑动**查看、对话框不会超出屏幕、按钮与分页的点击区域也放大了，触屏点得中。录入、发布、看榜这些日常操作在手机上都能完成；赛事配置这类操作条目较多，仍建议在电脑上做。
+
 ---
 
 ## 3. 仪表盘
@@ -60,12 +64,24 @@
 
 ## 4. 成绩录入
 
-### 4.1 选择项目
+### 4.1 选择项目与批次
 
 1. 左侧「项目」列表按大项分组，点选要录入的小项；
 2. 每个小项带状态徽标：**已发布** 或 **待录入**；
 3. 多个组别时，表格上方出现组别页签，切换组别分别录入；
-4. 配了「按队内平均」通道的小项（例如「个人+团体」项目的团体通道），工具栏下方会出现 **「平均值口径」单选**：`只算有效成绩`（没有有效成绩的人不进分母）或 `全部报名人员都计入`（没成绩的按 0 计入平均）。点选后立即保存到该小项，不需要另外点保存；这是小项级设置，该小项的所有组别共用。
+4. 组别页签旁边有**批次下拉**（`全部` / `第 1 批` / `第 2 批` / … / `未分批`），默认 `全部`（`未分批` 只在确实还有未分批的行时才出现）。选某一批后表格只显示那一批的人，方便录入员**只在自己这一批里找名字**，不用在一大堆人里翻；
+5. 配了「按队内平均」通道的小项（例如「个人+团体」项目的团体通道），工具栏下方会出现 **「平均值口径」单选**：`只算有效成绩`（没有有效成绩的人不进分母）或 `全部报名人员都计入`（没成绩的按 0 计入平均）。点选后立即保存到该小项，不需要另外点保存；这是小项级设置，该小项的所有组别共用。
+
+**批次是什么**：层级是 **大项 → 小项 → 组别 → 批次**。批次只是「把一条组别里的人分成几组，方便分批录入 / 分批查找」的**录入与展示分组**——**不参与算分**：名次与积分仍然按「小项 + 组别」整体计算，分批与否不会让分数、名次发生任何变化（评审口径不会变成「按批排名」）。批次筛选也只影响这张表格显示哪些行，不影响发布、积分榜与大屏。
+
+**怎么分批**（三种方式，可混用）：
+
+1. **手动勾选**：勾选若干行 → 在「已选 N 行」工具栏里填批次号 → 点 **设为第 N 批**；批次号留空时输入框会提示推荐的**下一个批次号**（已有最大号 + 1），也可直接写新的号；点 **清除批次** 把选中的行改回 `未分批`；
+2. **报名表里填**：导入报名表时用可选列 `heat`（正整数，留空 = 未分批），见[报名名单导入规范](./报名名单导入规范.md)；
+3. **一键均分**：在同一个工具栏里填「每批 N 人」（默认 8），点 **一键均分**——只对**未分批**的行按当前表格顺序切片，批次号接着已有最大号往后排；**已经分好批的行一个都不动**，手工编排不会被冲掉。确认框会先说明将编排多少行、共几批、从第几批到第几批。
+
+> 批次号是 1–999 的整数。切换组别后批次筛选与勾选都会重置（批次是「组别之下」的概念，换组别后旧的批次号没有意义）。
+> 分项成绩表与导出**暂不**按批次分块，导出的仍是整组成绩——需要按批查看时，请在「成绩录入」页用批次下拉筛选。
 
 > 团体成绩 = 该单位在本组别所有报名项成绩的平均值（成绩从每个人那一行读），由系统算出来：正常流程是给每个参赛人员各报一条（走 10.7 的「个人报名」），成绩照常录到每个人那一行，团体那一行（如果也报了）不用填成绩。
 > 选「全部报名人员都计入」时，只报了单位、一个人都没报（或队员都没成绩）的那条报名也会按 0 进分母，会把该单位的平均成绩拉低；口径与算法见 10.2「大项 / 小项」与 10.4「计分通道」。
@@ -76,7 +92,7 @@
 
 | 列 | 操作 |
 | --- | --- |
-| 成绩输入 | 直接输入成绩；工具栏会提示当前单位（秒 / 米 / 次 / 分），成绩格比过去更宽，四位数也看得全 |
+| 成绩输入 | 直接输入成绩；工具栏会提示当前单位（秒 / 米 / 次 / 分），成绩格比过去更宽，四位数也看得全；打字时格子旁边会浮出一个小提示（见下） |
 | 名次 | 自动排名项目由系统自动计算，不可编辑；手动名次项目（录入方式为「手动名次」或比较方式为「不比较」）可直接填名次 |
 | 状态 | 下拉选择：**有效**、**DNS 弃赛**、**DQ 取消**、**DNF 未完赛**、**退赛** |
 | 积分（自动） | 随成绩实时计算，仅供参考 |
@@ -88,6 +104,15 @@
 - 距离 / 计数 / 得分类：按工具栏提示的单位填数字，如米 `12.34`、次 `12`、分 `96.5`；
 - 秒位 ≥ 60 仍然拒绝（`1:70` 不是 70 秒），但报错会写明原因（见 4.4）。
 
+**打字时的实时提示**：光标停在某个成绩格里打字时，**这一格旁边会浮出一个小提示**，边打边告诉你系统怎么理解它——不用等发布才知道对错。提示分三种：
+
+- **合法** → 直接显示**解析结果**，例如打 `1:06` 显示 `= 66 秒`、打 `66.33` 显示 `= 66.33 秒`（米 / 次 / 分项目显示对应单位），让你确认系统理解的和你想的是同一个数；
+- **可疑** → 例如 `成绩 ≤ 0，疑似录入错误`，放行但提个醒；
+- **不合法** → 直接说明原因，并**带出那一格的实际内容**，例如 `秒位不能 ≥ 60（当前「1:70」），请写成 1:06 或 66 这类`、`成绩写法无法识别（当前「约1分06秒」），可用 66、66.33、1:06、1:06.33、1分06秒`；
+- **空格子不提示**（还没录是正常状态）；提示只是浮层，**不接收点击、不占布局、不会改变行高**，继续打字不受影响；靠屏幕底部时提示会自动翻到格子上面显示。
+
+这个提示与发布前的「防呆校验」（见 4.4）**用的是同一套判定**，不会出现「打字时说没问题、发布时却被拦下」这种自相矛盾。
+
 **示例文本不是已填内容**：空格子里显示的 `例 1:06.33`（距离 `例 12.34`、计数 `例 12`、得分 `例 96.5`）是**更淡的斜体灰字**，只是告诉你大概怎么写，**不代表这一格已经有成绩**。灰字不会被提交；点发布时如果那一格还是灰字，就按「还没录」自动跳过（本次不发布这一行），不会连累其他已填成绩的发布。过去示例文本长得和真实输入一样，容易看成「我已经填了」。
 
 右侧「实时积分预览」显示：若现在发布，各单位积分的变化、最大分差、受影响单位数。
@@ -122,6 +147,8 @@
 
 有**错误**时点「发布」会被拦下并提示第一处问题；只有提醒（含还没录的行）时发布会照常进行，未录的行自动跳过。
 
+> 这套判定与打字时格子旁的实时提示（见 4.2）**同源**：输入时看到的解析结果 / 报错原因，与这里、以及发布时的拦截口径完全一致。
+
 ### 4.5 存草稿与发布
 
 1. **存草稿**：保存当前组别的成绩，草稿**不会上屏**，也不计入积分榜；有未保存修改时页面会显示「有未保存修改」徽标。
@@ -260,6 +287,8 @@
 
 页面顶部徽标显示当前是「轮播中」还是「已锁定」。
 
+> **权限**：本页的**切页、公告、锁定 / 解锁、强制刷新**（服务端指令）记录员及以上都能用；**开窗 / 收窗 / 重新排布**由服务管理程序在本机执行，不受角色限制（该卡片只在从服务管理窗口打开的面板里可用）；只有「实时赛况」卡片（模式与当前项目）属于赛事设置，**仅管理员能保存**，非管理员看到的是整组置灰 + 一行提示条。
+
 **公告**：点「推送公告」后所有大屏先**全屏**展示这条公告，到时间后自动退回原来的页面（没锁定就继续轮播），公告正文留在底栏的「公告」槽位继续显示，直到被新公告替换或点「清除公告」。公告卡片顶部徽标显示「当前公告：有 / 无」，徽标下面那一行就是当前公告正文（没有公告时显示「暂无公告（大屏底栏显示占位）」）。公告会随赛事设置保存：新开的大屏窗口、断线重连之后，会先把当前公告再全屏播一遍（默认 15 秒）后留在底栏；点「清除公告」后底栏回到「暂无公告」占位。
 
 **实时赛况**：「实时赛况」卡片决定大屏「实时赛况」页显示哪几个项目（**最多 2 个**）。
@@ -268,7 +297,7 @@
 - **项目 1 / 项目 2** 两个下拉：从当前赛事的小项里选（选项里有「未指定」），已选的行可以「清除」；同一个项目不会重复占两个槽位；
 - **当前生效**：显示此刻大屏实际会显示的项目与入选原因，格式如 `男子 100 米（排期命中）`；没有可显示的项目时显示「当前没有可显示的项目」。旁边的「刷新」只重新读取，不改配置；
 - **保存**：改完模式或项目后点「保存」，提示「实时赛况设置已保存」后大屏按新配置显示；卡片底部注明「当前项目最多 2 个」；
-- 该卡片的「保存」需要**管理员**身份（实时赛况属于赛事设置，只有管理员能改）；示例数据模式下不能保存。
+- 该卡片的「保存」需要**管理员**身份（见本节开头的权限说明）；示例数据模式下不能保存。
 
 **在线大屏**：右侧「在线大屏」卡片列出的是**真实**的在线实例，直接读服务端 `GET /api/display/instances`，打开页面时每 5 秒自动刷新一次（浏览器切到后台时暂停，切回来立刻补一次）。每个实例一行，显示实例 ID、在线 / 离线徽标、「局域网浏览器」或「屏 N」标记、当前所在页、来源地址与最后心跳；服务端判定某个实例落后时还会多一个「落后」徽标（大屏可能在卡或网络差）。**本机用 Console 打开的大屏窗口、以及局域网设备打开 `/display` 连上的浏览器，都会出现在这里**——局域网浏览器没有屏号，那一栏显示「局域网浏览器」。离线实例会在服务端保留一段时间，方便排查它是什么时候掉的。
 
@@ -374,6 +403,8 @@
 3. 用「上移 / 下移」调整顺序，「移除」删除；
 4. 点「保存全部」整体替换该小项的组别配置。**若该项目已有报名数据，服务端会拒绝替换。**
 
+> **组别之下还有「批次」**：批次（`第 1 批`、`第 2 批`…）是在**成绩录入页**给报名行分的录入 / 展示分组，不属于这里的组别配置，也**不参与算分**——名次与积分仍按「小项 + 组别」整体计算。怎么分批见 4.1。
+
 ### 10.4 计分通道
 
 通道 = 「排谁的名次 + 名次从哪来 + 用哪张积分模板」。