Scoreboard/docs/使用手册.md

使用手册

面向现场操作人员与管理员。管理面板地址：http://<主机IP>:19540/admin；大屏地址：http://<主机IP>:19540/display。

具体按钮文案与页面布局以实际界面为准；本文按当前版本整理。

---

1. 角色与权限

系统只有三种身份，权限是包含关系：管理员 ⊇ 录入员 ⊇ 访客。

身份	说明	能做什么
访客 guest	未登录时的默认身份，不需要建账号	只读查看积分榜、成绩、基础数据等公开数据；不能录入、发布、改配置
录入员 recorder	现场记录员	访客全部权限 + 成绩录入 / 存草稿 / 发布 / 撤销发布 / 破纪录确认 / 积分调整 / 大屏控制 / 变更历史
管理员 admin	赛事管理员	录入员全部权限 + 系统设置、用户管理、备份、审计日志、规则包与赛事项目包导入导出

未登录也能进管理面板，只是所有写操作按钮被禁用，顶部会出现「当前为访客只读视图」提示。

个别功能对身份要求更高：「大屏控制」里的切页、公告、锁定 / 解锁、强制刷新（走服务端指令）记录员及以上可用；开窗 / 收窗 / 重新排布是服务管理程序在本机执行的操作（只在从服务管理窗口打开的面板里可用），不受角色限制；同页的「实时赛况」配置（模式与当前项目）属于赛事设置，只有管理员能保存——非管理员看到的是整组置灰加一行提示条（见第 9 节）。

1.1 登录

1. 打开管理面板地址，进入登录页；
2. 输入账号与密码，点「登录」；
3. 首次登录或密码被管理员重置后，会自动跳到「修改密码」，改完才能继续；
4. 也可以点「以访客身份只读浏览」直接查看数据。

1.2 退出

点击右上角用户名旁的退出图标，即退出登录并回到只读访客视图。

---

2. 界面总览

左侧导航按用途分组：

分组	页面
总览	仪表盘
成绩	成绩录入、成绩审核、破纪录、积分调整
榜单	积分榜、大屏控制
数据	基础数据、导出、变更历史、日志
系统	系统设置、修改密码、关于

顶部栏显示：实时连接状态、服务端版本、刷新按钮、当前账号与角色、退出按钮。左侧栏底部有快捷键提示：Ctrl+Enter 存草稿、Alt+Enter 发布。

窄窗口 / 手机：管理面板可以在窄窗口与手机浏览器里用（局域网内访问 http://<主机IP>:19540/admin 即可）。窄屏下左侧导航收成抽屉（点顶栏的菜单按钮展开）、宽表格可以横向滑动查看、对话框不会超出屏幕、按钮与分页的点击区域也放大了，触屏点得中。录入、发布、看榜这些日常操作在手机上都能完成；赛事配置这类操作条目较多，仍建议在电脑上做。

---

3. 仪表盘

用于快速掌握全局：

• 领先单位、已发布项目数 / 总项目数、纪录条目数、实时连接状态；
• 「当前赛程」列出小项及状态（已发布 / 待录入），点「录入」直接跳到该项目；
• 「实时积分 Top 3」显示前三名与奖牌数；
• 有待录入项目时显示「待办」提醒。

---

4. 成绩录入

4.1 选择项目与批次

1. 左侧「项目」列表按大项分组，点选要录入的小项；
2. 每个小项带状态徽标：已发布 或 待录入；
3. 多个组别时，表格上方出现组别页签，切换组别分别录入；
4. 组别页签旁边有批次下拉（全部 / 第 1 批 / 第 2 批 / … / 未分批），默认 全部（未分批 只在确实还有未分批的行时才出现）。选某一批后表格只显示那一批的人，方便录入员只在自己这一批里找名字，不用在一大堆人里翻；
5. 配了「按队内平均」通道的小项（例如「个人+团体」项目的团体通道），工具栏下方会出现 「平均值口径」单选：只算有效成绩（没有有效成绩的人不进分母）或 全部报名人员都计入（没成绩的按 0 计入平均）。点选后立即保存到该小项，不需要另外点保存；这是小项级设置，该小项的所有组别共用。

批次录入进度条：工具栏正下方有一条横跨整行的进度条，显示当前筛选范围的录入进度，例如 第 2 批 已录 5/8 · 3 条有错（有错的行既不算「已录」，也会在发布时被防呆拦下，所以要单独报出来）；全部录完时文字变成「已录完 8/8」、进度条变绿。分母就是当前筛选范围的行数——选了某一批就只数这一批。它和发布防呆、行上的状态徽标用的是同一套判定，不会出现「进度条说录完了、发布却说缺人」。

批次是什么：层级是 大项 → 小项 → 组别 → 批次。批次只是「把一条组别里的人分成几组，方便分批录入 / 分批查找」的录入与展示分组——不参与算分：名次与积分仍然按「小项 + 组别」整体计算，分批与否不会让分数、名次发生任何变化（评审口径不会变成「按批排名」）。批次筛选也只影响这张表格显示哪些行，不影响发布、积分榜与大屏。

怎么分批（三种方式，可混用）：

1. 手动勾选：勾选若干行 → 在「已选 N 行」工具栏里填批次号 → 点 设为第 N 批；批次号留空时输入框会提示推荐的下一个批次号（已有最大号 + 1），也可直接写新的号；点 清除批次 把选中的行改回 未分批；
2. 报名表里填：导入报名表时用可选列 heat（正整数，留空 = 未分批），见报名名单导入规范；
3. 一键均分：在同一个工具栏里填「每批 N 人」（默认 8），点 一键均分——只对未分批的行按当前表格顺序切片，批次号接着已有最大号往后排；已经分好批的行一个都不动，手工编排不会被冲掉。确认框会先说明将编排多少行、共几批、从第几批到第几批。

批次号是 1–999 的整数。切换组别后批次筛选与勾选都会重置（批次是「组别之下」的概念，换组别后旧的批次号没有意义）。 分项成绩表与导出暂不按批次分块，导出的仍是整组成绩——需要按批查看时，请在「成绩录入」页用批次下拉筛选。

团体成绩 = 该单位在本组别所有报名项成绩的平均值（成绩从每个人那一行读），由系统算出来：正常流程是给每个参赛人员各报一条（走 10.7 的「个人报名」），成绩照常录到每个人那一行，团体那一行（如果也报了）不用填成绩。 选「全部报名人员都计入」时，只报了单位、一个人都没报（或队员都没成绩）的那条报名也会按 0 进分母，会把该单位的平均成绩拉低；口径与算法见 10.2「大项 / 小项」与 10.4「计分通道」。

4.2 录入成绩

表格列依次为：号码、单位、运动员 / 队、成绩输入、名次、状态、积分（自动）、备注。「运动员 / 队」这一列在姓名后面直接跟着该人的号码布（灰色小字，例如 张伟 101）：号码列仍然保留，这一处只是省得在长表格里左右横跳找号。

列	操作
成绩输入	直接输入成绩；工具栏会提示当前单位（秒 / 米 / 次 / 分），成绩格比过去更宽，四位数也看得全；打字时格子旁边会浮出一个小提示（见下）
名次	自动排名项目由系统自动计算，不可编辑；手动名次项目（录入方式为「手动名次」或比较方式为「不比较」）可直接填名次
状态	下拉选择：有效、DNS 弃赛、DQ 取消、DNF 未完赛、退赛
积分（自动）	随成绩实时计算，仅供参考
备注	自由填写，示例文本是 可留空

成绩写法：能接受的写法比过去多，中文输入法下的全角冒号 1：06、全角数字也认。

• 时间类（单位「秒」）：66、66.33、1:06、1:06.33、1:6、1分06秒、1分6秒、1分06、1小时2分3秒；
• 距离 / 计数 / 得分类：按工具栏提示的单位填数字，如米 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）是更淡的斜体灰字，只是告诉你大概怎么写，不代表这一格已经有成绩。灰字不会被提交；点发布时如果那一格还是灰字，就按「还没录」自动跳过（本次不发布这一行），不会连累其他已填成绩的发布。过去示例文本长得和真实输入一样，容易看成「我已经填了」。

右侧「实时积分预览」显示：若现在发布，各单位积分的变化、最大分差、受影响单位数。

4.3 键盘流与批量录入

操作	效果
Tab	跳到下一个单元格（浏览器原生焦点顺序）
Enter	在成绩格之间依次移动
Ctrl+Enter	存草稿
Alt+Enter	发布当前项目
「按成绩重排」	按成绩从小到大 / 从大到小重排表格行（名次仍以比较值为准）
「下一格」	按钮方式移动焦点

从 Excel 粘贴：复制区域后，在成绩格按 Ctrl+V。

• 两列及以上：第一列按单位名称 / 简称匹配行，最后一列作为成绩；
• 单列：从当前行开始向下依次填充。

4.4 防呆校验

页面下方「防呆校验」会实时列出问题，分两档：

• 错误（阻止发布）：只有会让名次或积分算错的才挡发布，文案都会把那一格的实际内容原样打出来并对症给改法：
  • 秒位 ≥ 60：第 3 行 张三：秒位不能 ≥ 60（当前「1:70」），请写成 1:06 或 66 这类；
  • 写法无法识别：第 3 行 张三：成绩写法无法识别（当前「约1分06秒」），可用 66、66.33、1:06、1:06.33、1分06秒——非时间单位会换成对应的数字提示（不会拿时间格式去教距离项目）；
  • 手动名次项目缺少名次。
• 提醒（不阻止发布）：
  • 成绩还没录（空格子）：第 3 行 张三：还没录成绩（当前「（空）」），本次发布不计入这一行。这是中性状态，不挡发布——跑完一批就能先发一批，剩下没跑的补录后再发（见 4.6）；
  • 成绩 ≤ 0、名次重复（请确认是否并列）、成绩与赛会纪录差距过大。

有错误时点「发布」会被拦下并提示第一处问题；只有提醒（含还没录的行）时发布会照常进行，未录的行自动跳过。

这套判定与打字时格子旁的实时提示（见 4.2）同源：输入时看到的解析结果 / 报错原因，与这里、以及发布时的拦截口径完全一致。

4.5 存草稿与发布

1. 存草稿：保存当前组别的成绩，草稿不会上屏，也不计入积分榜；有未保存修改时页面会显示「有未保存修改」徽标。
   • 未保存的成绩不会被静默丢掉：有未保存修改时，点左侧菜单切到别的页面（以及浏览器前进 / 后退）会先弹出确认框，确认丢弃才离开；关闭或刷新浏览器时浏览器也会原生提示；切换项目本来就会先确认。选「取消」留在本页，改动都还在。
2. 发布：点击后弹出确认框，说明本次将发布多少人、还有多少人没成绩，以及影响的单位数与最大分差；确认后这批成绩立即上屏并重算积分榜（若管理员开了延迟结算，则只上屏成绩，名次与榜单等该组录完再更新，见 4.6、10.5）。
   • 发布前系统会自动把当前内容整组保存为草稿再发布，无需手动先存；
   • 示例数据模式下「发布」按钮不可用，避免把未落库的改动当成发布成功。

4.6 分批发布（跑一批发一批）

跑道只有 8 条、一个项目可能要分好几场跑时，不需要等所有人都跑完：每跑完一批就发一批，没跑到的先空着。

1. 这一批跑完，把已出的成绩填上（其他还没跑的行保持空白即可）；
2. 点「发布」（该组已有发布过的成绩、且还有没发的已填行时，按钮显示为「发布本批」）；
3. 确认框会写明：本组还有 N 人没有成绩，本次将发布已填的 M 人；其余保持未发布，补录后再发布即可。本次影响 … 个单位，最大分差变化 … 分。发布后立即上屏并重算积分榜。——看完再确认，系统只发布已填的那 M 人，不会把没成绩的人当成 0 分发出去（末句在延迟结算下会换成「名次与榜单等该组全部录完后再更新」，见下面）；
4. 确认后这批成绩立即上屏；实时结算（默认）下，名次与积分先按已发布的这部分算，大屏立刻有内容（延迟结算下先不动，见下）；
5. 下一批跑完，回到本页补录成绩，再点一次「发布本批」——系统会把两批放在一起重算名次与积分，先发的部分自动跟着更新；
6. 全部发完后按钮不再显示「本批」（并变为不可用），此时该组视为已全部发布，要改就得走「撤销发布 → 修改 → 重新发布」（见 4.7）。

只有「会被算错」的写法才会挡住发布（见 4.4）；空格子只是「还没录」，属于提醒，不影响发布。审核页（第 5 节）也是同一套口径：只有写错或缺名次才挡「发布整组」，空成绩只是本次跳过。

如果管理员关掉了「分批发布时实时更新榜单」（见 10.5），行为会变成这样：发布后成绩照常上屏，但名次、积分与奖牌榜都不动——要等该项目该组所有「正常参赛」的人都录完成绩才一次性结算并更新榜单（退赛 / 取消资格 / 未出场的人不算在等待里）。未结算期间：

• 录入页在进度条下方显示一条提示：延迟结算：本组 X/Y 人已出成绩，名次与榜单等该组全部录完后一起更新（本页预览的名次仍是实时的），旁边就是「立即结算」按钮；
• 该组在分项成绩 / 最新成绩里的名次显示 —（成绩照常显示）——这是有意的，免得出现「有金牌但 0 分」这种自相矛盾的画面；
• 有人永远录不出成绩时（例如已退赛但没改状态），在录入页点 「立即结算」，系统按当前已发布成绩先结算一次榜单和奖牌；之后补录完还会再自动结算。

4.7 撤销发布

已发布的组别会出现「撤销发布」按钮：

1. 点击后在确认框中确认；
2. 系统作废该组已产生的积分流水，大屏回退到发布前状态；
3. 修改后重新发布即可。全程留痕，可在「变更历史」查看。

4.8 勾选与批量操作（退赛 / 恢复 / 移出报名）

表格每行最左边有勾选框，表头那个勾选框是全选当前筛选范围内的行——它只勾当前组别、当前批次筛选下看得见的行，被筛掉的行不会被选上。勾选后工具栏里出现「已选 N 行」与三个按钮：

按钮	作用	可恢复吗
批量退赛	把选中的正常参赛者标记为退赛（弃权）：0 分、不占名次	可以，用「批量恢复」撤回
批量恢复	把选中的退赛者改回「正常参赛」	——
批量移出报名	把选中的报名项物理删除，连同他的成绩与积分流水一起删掉	不可以，需二次确认

• 批量退赛 / 恢复会立即按新名次重算积分并推到大屏——延迟结算（见 10.5）也照算，因为退赛 / 恢复改的是「谁还算数」，不是「录了多少」，名次和分数必须当场跟着改。已经是「取消资格（dq）」「未出场（dns）」的行会被跳过、不覆盖原判定（跳过的人会在确认框里逐条列出原因，例如「已被判罚取消资格（dq），跳过」）。
• 批量移出报名的确认框会列出将被删除的人（姓名｜号码布｜单位，超过 20 人只列前 20 并报剩余数量）以及将重算的小项与组别——看完再确认，删了不能恢复；删除后同样立即重算并推榜，不受延迟结算影响。
• 一次最多处理 500 条报名项，超出请分批提交；有未保存的成绩修改时，请先「存草稿」再批量操作；示例数据模式下不能批量操作。

4.9 团体名次（按单位录入）

有些项目要按单位排团体名次（例如「团体引体向上」），但场上并没有一条"单位自己的成绩"可填——名次是裁判直接给定的。这类项目在录入页会多出一块 「团体名次」 卡片。

什么时候会出现：只有该组别配了「团体名次 + 手动名次」这两项都符合的计分通道时才会出现（通道在「基础数据 → 计分通道」配，见 10.4）。没配这样通道的小项，录入页不显示这块卡片——这是正常的，说明它的团体名次另有来源（例如篮球这类纯团体项目，走的是团体报名行上的名次，仍在成绩列表里录）。

怎么填：

1. 卡片里按单位一行一个输入框（单位清单取「基础数据 → 参赛单位」里启用中的单位，已「彻底删除」的单位不出现）；
2. 在单位后面填名次（从 1 开始的正整数）；留空 = 清空该单位的名次（不需要先填一个 0）；
3. 填完点 「保存团体名次」；没有改动时按钮是灰的，改了才亮，卡片右上角会显示「未保存」。

保存后会发生什么：系统按新名次重算该组别名次与积分，并刷新积分榜与大屏（这一步与《个人名次》无关——个人名次仍然在成绩列表里录，团体名次只喂给团体通道）。保存完成后会提示「团体名次已保存 · 该组名次与积分榜会按新名次重算」。

要注意的：

• 名次重复允许并列（服务端按积分模板的并列口径处理），但输入框会描红并提示 名次 N 重复 X 次，允许并列，请确认是否为想要的结果——确认无误可以照常保存；
• 名次超出参赛单位数同样会提示（多半是笔误），但不挡保存：改不改由你决定；
• 个人名次不受影响：这块卡片改的是单位，成绩表里每个人的名次、分数一行都不动；
• 中途离开会提醒：有未保存的团体名次时，切走会有确认框（和未保存的成绩一样）；
• 权限：读得到成绩的人都能看到这块卡片（访客只读，输入框置灰并写明原因）；能保存的是录入员及以上（与成绩录入同权限）。示例数据模式下不能保存；
• 团体名次是独立保存的：点「保存团体名次」只提交这块卡片，不会顺手发布成绩；成绩仍然要另外「发布」。

---

5. 成绩审核

用于在发布前统一复核草稿。

1. 左侧「待审草稿」按「小项 + 组别」分组，显示每组草稿条数，可搜索小项 / 组别 / 单位；
2. 点选一组后，右侧显示该组成绩明细（单位、运动员 / 队、成绩、名次、状态、积分）；
3. 用「整组对比 / 逐条对比」切换，查看发布后各单位积分的变化；
4. 「发布影响」列出受影响单位与分值变化；
5. 操作：
   • 发布整组：确认框会写明本组还有多少条没有成绩、本次将发布已填的多少条；确认后只发布已填的那部分并重算积分榜（延迟结算下同样等该组录完才更新名次与榜单），没录的保持未发布，补录后再发一次即可（分批发布，见 4.6）；
   • 退回：当前版本服务端没有「退回」接口，此操作仅在管理端本地标记，不会改动成绩数据；刷新页面后标记可能消失。如需真正退回，请通知录入员到「成绩录入」修改后重新保存。

草稿态永远不会上屏；发布以「小项 + 组别」为一组整体生效，但没录成绩的条目会被跳过——它既不挡发布，也不会被当成 0 分（防呆口径与录入页一致，见 4.4）。

---

6. 破纪录

页面顶部会显示破纪录加分开关状态（来自规则包 recordBonus.enabled）。当前版本默认关闭；若当前角色读不到规则包，会如实显示「未知」，以服务端校验结果为准。

6.1 疑似破纪录

• 系统用已发布且有效的成绩与当前纪录自动比对，推导出疑似破纪录，草稿不参与；
• 列表显示小项、组别、单位 / 运动员、成绩、原纪录、档位（赛会 / 市级 / 省级 / 全国）、预计加分；
• 确认加分：登记破纪录并生成加分流水、更新纪录库；开关关闭时按钮不可用；
• 拒绝：当前版本服务端没有拒绝接口，此操作只在本地隐藏该条，刷新后会重新出现。

6.2 纪录库

• 按小项分组展示，可用「全部 / 赛会 / 市级 / 省级 / 全国」页签筛选，也可搜索小项或保持者；
• 每行显示档位、成绩、保持者、单位、达成时间、来源（本届 / 历史）以及是否为当前纪录。

---

7. 积分调整

用于人工加减分，全程留痕。

页面顶部显示人工调整开关状态（规则包 manualAdjustment.enabled）。若已关闭，「新增调整」按钮不可用。

7.1 新增调整

点「新增调整」，填写：

字段	说明
单位 *	下拉选择参赛单位
分值 *	正数加分、负数扣分，不能为 0
类别 *	处罚 / 补分 / 更正
关联项目	可选，关联到具体小项
理由 *	必填，会写入审计日志

保存后积分榜实时更新。

7.2 查看与作废

• 列表可按类别筛选、按单位或理由搜索，分页浏览；
• 点某行的「作废」，填写作废理由并确认，对应积分流水会一并作废；
• 已作废的记录仍保留在列表中，状态显示「已作废」。

---

8. 积分榜

顶部页签：单位总分榜、团体奖牌榜、个人积分榜；右侧搜索框可按单位或运动员过滤。

8.1 单位总分榜

• 列：名次、单位、总分、金、银、铜、变化、明细；
• 「变化」列显示名次升降（如 ↑2、↓1）；
• 点「展开」下钻该单位的积分明细，右侧面板显示合计与每一条得分来源（项目、组别、运动员、成绩、名次、积分），每一分都可溯源。

8.2 团体奖牌榜 / 个人积分榜

• 团体奖牌榜显示金、银、铜与合计；
• 个人积分榜显示运动员、单位、个人总分与奖牌数；
• 团体奖牌榜那一列的「明细」展开的是同一个单位积分明细面板（见 8.1），不是奖牌专属明细；但这份榜单本身有专属的逐枚奖牌导出（见 8.3）；
• 个人积分榜没有明细列（不能点开下钻），但它的逐条得分来源也有专属导出（见 8.3）。

8.3 导出明细（xlsx）

• 三个榜单的卡片头各有一个导出按钮，按钮跟着当前页签切换；展开某个单位时，右侧明细卡头还有 导出该单位明细；
• 导出总明细（单位总分榜卡片头）：导出 单位积分总明细.xlsx——一张带「单位」列的总表，外加每个有数据的单位一张分表；没有积分的单位不出分表；
• 导出奖牌明细（团体奖牌榜卡片头）：导出 团体奖牌明细.xlsx——第一张总表逐枚奖牌列出「单位 / 大项 / 小项 / 组别 / 名次 / 奖牌 / 运动员、队」，奖牌 列是 金牌 / 银牌 / 铜牌；其后每个有奖牌的单位一张分表（列同上、去掉「单位」，末尾一行小计 金 X / 银 Y / 铜 Z），没有奖牌的单位不出分表。口径与「团体奖牌榜」一致：同一个报名项在「个人+团体」这类双计通道下只记一枚奖牌，不会重复计数；
• 导出个人明细（个人积分榜卡片头）：导出 个人积分总明细.xlsx——第一张总表逐条列出「单位 / 运动员 / 大项 / 小项 / 组别 / 名次 / 成绩 / 得分 / 来源」；其后每个有得分的单位一张分表（按单位分，不按人分），没有得分流水的人不出现在表里。得分 是记到个人的原始分，与「个人积分榜」逐个数字一致，且不乘榜单口径里的个人项目得分折算系数（那个系数只作用于单位总分）；
• 导出该单位明细（右侧单位明细面板头部）：先展开某个单位再点，导出 单位积分明细.xlsx（列：序号、大项、小项、组别、运动员、名次、成绩、来源、积分、备注，末行是「合计」）。团体奖牌榜展开的也是这个单位积分明细面板，所以想按单位逐条看时同样用它；
• 这些导出都是只读下载（访客也能用），不需要写权限；导出过程中按钮会变成「导出中…」并禁用，避免重复下载。

8.4 推送明细到大屏

1. 展开某个单位的明细；
2. 点「推送到大屏」；
3. 所有大屏会弹出半屏明细覆盖层，60 秒后自动关闭；
4. 想立即关闭，点页面顶部「关闭大屏明细」并确认。

---

9. 大屏控制

区块	操作
切页	选择「总积分榜 / 团体奖牌榜 / 个人积分奖牌榜 / 分项成绩 / 实时赛况 / 公告」，点「立即跳转」（所有大屏一起切）；只想切某一块屏或某台设备，用右侧「在线大屏」卡片里那一行的下拉与「切到此页」
锁定与刷新	锁定：停止自动轮播并停在当前页；解锁：恢复轮播；强制刷新：让所有大屏重新拉取快照，用于排障
公告	输入公告文字，设置「滚动时长」（5–120 秒，实际是全屏展示的秒数），点「推送公告」；点「清除公告」撤下当前公告

页面顶部徽标显示当前是「轮播中」还是「已锁定」。

权限：本页的切页、公告、锁定 / 解锁、强制刷新（服务端指令）记录员及以上都能用；开窗 / 收窗 / 重新排布由服务管理程序在本机执行，不受角色限制（该卡片只在从服务管理窗口打开的面板里可用）；只有「实时赛况」卡片（模式与当前项目）属于赛事设置，仅管理员能保存，非管理员看到的是整组置灰 + 一行提示条。

公告：点「推送公告」后所有大屏先全屏展示这条公告，到时间后自动退回原来的页面（没锁定就继续轮播），公告正文留在底栏的「公告」槽位继续显示，直到被新公告替换或点「清除公告」。公告卡片顶部徽标显示「当前公告：有 / 无」，徽标下面那一行就是当前公告正文（没有公告时显示「暂无公告（大屏底栏显示占位）」）。公告会随赛事设置保存：新开的大屏窗口、断线重连之后，会先把当前公告再全屏播一遍（默认 15 秒）后留在底栏；点「清除公告」后底栏回到「暂无公告」占位。

实时赛况：「实时赛况」卡片决定大屏「实时赛况」页显示哪几个项目（最多 2 个）。

• 自动判定 / 人工指定：卡片右上角徽标显示当前模式。选「自动判定」时按三条依据依次判定——人工指定 → 排期命中（项目开始时间前后 30 分钟内）→ 最近发布过成绩的项目；选「人工指定」时只显示下面指定的项目，不做任何回退；
• 项目 1 / 项目 2 两个下拉：从当前赛事的小项里选（选项里有「未指定」），已选的行可以「清除」；同一个项目不会重复占两个槽位；
• 当前生效：显示此刻大屏实际会显示的项目与入选原因，格式如 男子 100 米（排期命中）；没有可显示的项目时显示「当前没有可显示的项目」。旁边的「刷新」只重新读取，不改配置；
• 保存：改完模式或项目后点「保存」，提示「实时赛况设置已保存」后大屏按新配置显示；卡片底部注明「当前项目最多 2 个」；
• 该卡片的「保存」需要管理员身份（见本节开头的权限说明）；示例数据模式下不能保存。

在线大屏：右侧「在线大屏」卡片列出的是真实的在线实例，直接读服务端 GET /api/display/instances，打开页面时每 5 秒自动刷新一次（浏览器切到后台时暂停，切回来立刻补一次）。每个实例一行，显示实例 ID、在线 / 离线徽标、「局域网浏览器」或「屏 N」标记、当前所在页、来源地址与最后心跳；服务端判定某个实例落后时还会多一个「落后」徽标（大屏可能在卡或网络差）。本机用 Console 打开的大屏窗口、以及局域网设备打开 /display 连上的浏览器，都会出现在这里——局域网浏览器没有屏号，那一栏显示「局域网浏览器」。离线实例会在服务端保留一段时间，方便排查它是什么时候掉的。

逐屏 / 逐设备切页：在线大屏列表里每一行都在「当前页」旁带一个页面下拉和「切到此页」按钮，只把这一块屏 / 这一台设备切过去，其他屏不受影响；上方「切页」卡片里的「立即跳转」则是所有大屏一起切。离线实例的下拉与按钮是灰的，发不到它；点名的大屏一台都没收到指令时会明确提示「目标大屏已离线，请刷新在线列表」，不会谎报成功。列表读取失败时页面会提示「读取在线大屏失败」，并保留上一次的结果，不会把列表清空。

9.1 显示器菜单（重建被关掉的大屏窗口）

扩展屏上的大屏窗口平时由服务管理程序（Console）按配置自动开出来，只有在有人手动关掉了某块屏的大屏窗口时才需要这一节。

这张「显示器」卡片只在从服务管理窗口点「打开服务端管理面板」打开的面板里可用；用浏览器直接打开管理面板时，卡片只显示一行提示，这是正常的。

1. 窗口页面：先选好新窗口锁定显示哪一页（默认「总积分榜」）；
2. 显示器列表：逐块屏列出名称、分辨率、缩放、是否主显示器、当前是否已开窗口（「已开窗口（全屏）」「已开窗口（窗口化）」或「未开窗口」），以及该屏窗口当前在哪一页（没开窗口时显示「窗口未开」；窗口开着但还没上报时显示「未上报」）；
3. 每行的按钮：
   • 该屏的窗口已连上服务端（列表里能找到对应的在线实例）→ 页面下拉 + 切到此页：只把这一块屏切过去，不影响别的屏；找不到对应在线实例时这两个控件是灰的，行内会注明原因（「该屏窗口已关闭（实例离线），先开窗或等它重连」或「该屏窗口未开，或大屏没上报屏号」）；
   • 该屏已经有窗口 → 聚焦窗口：把窗口提到最前，不重建、不打断正在展示的比分；
   • 该屏还没有窗口，且允许多屏全屏 → 创建全屏窗口；
   • 该屏还没有窗口，但不允许全屏 → 创建窗口（窗口化），行内会注明「单显示器 / 主显示器只能窗口化」；
   • 已开窗口的行还有一个 关闭窗口：全屏大屏窗口是锁定鼠标的，万一开到了错误的屏上，从大屏本身退不出来，用这个按钮收掉；
4. 重新排布（按设置重建全部窗口）：按服务管理程序里的选屏配置重建所有大屏窗口。不在该配置范围内的窗口会被关掉，所以日常只想恢复某一块屏时，请优先用上面的「创建」按钮。

为什么单显示器 / 主显示器只能创建窗口化窗口：全屏窗口会盖住整块屏，而且没有标题栏和关闭按钮。单显示器上开全屏，等于把操作人员的桌面整个盖住；主显示器上开全屏，会把服务管理窗口、管理面板这些工作窗口全部遮住——现场又没有键盘可以退出来。所以这两种情况下按钮只提供窗口化：窗口约占屏幕 80%、居中显示、带标题栏，随时可关。只有「本机有多于一块显示器，且目标不是主显示器」时才放行全屏。

副屏全屏窗口被误关后，一键恢复：

1. 在服务管理窗口点「打开服务端管理面板」；
2. 进入管理端「大屏控制」页；
3. 在「显示器」卡片里找到那块副屏（那一行没有「主显示器」标记，且分辨率/缩放与副屏一致），点它的 创建全屏窗口；
4. 列表刷新后该行显示「已开窗口（全屏）」，副屏上即出现全屏积分榜。

多块副屏都被关掉时，在同一张卡片里逐块点「创建全屏窗口」即可；改用「重新排布」也行，但前提是这些屏都在 Console 的选屏配置里。

---

10. 基础数据

页面分七个分区，从左到右依次是：参赛单位、大项 / 小项、组别、计分通道、积分模板、运动员、报名导入。

10.1 参赛单位

1. 点「新增单位」；
2. 填写代码 *（唯一，字母 / 数字 / _ / -，最长 16 位）、全称 *、简称、主题色、排序、logo（可点输入框右侧「上传图片」直接传，png / jpg / webp / gif，单张不超过 5 MiB；也能手填已有路径，留空则不显示）；
3. 每行有三个动作：编辑、停用（已停用的单位显示为「启用」）、彻底删除。

停用与彻底删除的区别

状态	单位列表里	还能被报名选中吗	它的报名 / 成绩 / 积分	能恢复吗
启用（默认）	在	能	保留	——
停用	还在（标「已停用」）	仍可手动选（「全选」不会自动带上它）	保留	点「启用」即可
彻底删除	默认不在列表里（管理员勾选「显示已彻底删除的单位」后可见，标「已删除」）	不能	保留	管理员可在列表里点「恢复」；再次导入用到它的编码也会自动回来

「停用」还是软删除：单位留在列表里，历史成绩与积分流水保留，随时能再「启用」。「彻底删除」是假删除——只把这个单位从参赛单位列表里移除，它的报名、成绩、积分流水、人工调整、纪录与名下的运动员一条都没删，积分榜也不会变化，不会触发任何重算。操作步骤：

1. 点该行右侧红色的「彻底删除」；
2. 在确认框里核对提示（会写明该单位从列表与报名选择里移除、已有报名与积分不受影响、积分榜不变，以及恢复要找谁），再点一次「彻底删除」；
3. 完成后该单位从默认列表里消失，页面提示「已彻底删除「XX」」。

怎么恢复：只有管理员能在参赛单位页勾选「显示已彻底删除的单位」把它们翻出来，点该行的「恢复」即可。恢复是幂等的——它本来就还在时会提示「本就未被彻底删除」；如果这个编码已经被另一个可见单位占用（只能来自手工改库），会拒绝并说明原因。录入员（recorder）界面上看不到这个开关，删错了要找管理员恢复（删除确认框里也写了这句）。

「彻底删除」之后会发生什么

• 该单位不再出现在默认的参赛单位列表里，报名选择（含团体报名、运动员的「所属单位」下拉）里也选不到；
• 它的报名、成绩、积分流水、人工调整、纪录与名下运动员全部保留——消失的只是这个单位本身；
• 积分榜照旧显示它：单位本来有分数的话，总积分榜、团体奖牌榜上仍有它的名字与分数。这是刻意设计（数据没删，分数就不该凭空消失），不是故障；
• 再次导入报名表时，如果用到这个单位的编码，它会自动复活并重新出现在列表里——这里和人员不同：删掉的人再次导入是以新档案建档（旧数据回不来），删掉的单位则是原来那条记录直接恢复，报名、成绩与积分一直都在（见 10.7）；
• 单位名下还有运动员时同样可以删，这些运动员不会被一起删掉，但他们编辑起来会有些不便（见常见问题 Q64）。

⚠️ 别和运动员的「彻底删除」混为一谈：两个页面上的按钮同名，行为完全不同。运动员的「彻底删除」是真删除——人员档案连同他名下的报名、成绩与积分流水一起从库里删掉，并重算受影响小项的排名与积分（见 10.6）；参赛单位的「彻底删除」是假删除——业务数据一条不删，只让单位从列表里消失，积分榜不变。

上传的 logo 会显示在大屏的总积分榜、团体奖牌榜、分项成绩与个人积分奖牌榜上（个人积分奖牌榜显示在运动员姓名前面）；没传 logo 的单位不占位，队名不会因此错位。管理端页面不显示 logo。

10.2 大项 / 小项

1. 左侧选择或新增大项（编码、名称、简称、默认积分模板、排序）；
2. 右侧维护该大项下的小项：点「新增小项」，填写编码、名称、类型（个人 / 团体 / 对抗 / 比赛 / 个人+团体）、录入方式（自动排名 / 手动名次）、成绩类型（时间 / 距离 / 计数 / 得分 / 无成绩）、比较方式（越小越好 / 越大越好 / 不比较）、状态、是否计分、是否结算奖牌等；
3. 小项行上的「配置组别」「配置计分通道」可直接跳到对应分区；
4. 删除大项 / 小项会二次确认。

「该项启用奖牌结算」开关（新增）

小项表单下方的「选项」里，"是否计分"旁边有一个 「该项启用奖牌结算」 勾选框，默认勾上。

• 勾上（默认）：这个小项按名次发奖牌——第 1 名金、第 2 名银、第 3 名铜，和以前一样；
• 取消勾选：这个小项的名次与积分照常计算、照常上屏，但一块奖牌都不发——金牌榜（团体奖牌榜）与个人积分榜的奖牌列里都不再出现它。

什么时候该关掉它？"算分但不发牌"的项目——例如赛会规则只记名次分、不设金银铜的项目，或者现场临时决定不发牌、但分数仍要计入单位总分的项目。

注意别和「计分」搞混：取消勾选「计分」的项目（只排名不计分）本来就不发奖牌，那种情况不用动这里；「该项启用奖牌结算」管的是"计分的项目里哪些要发牌"。

它保存后立即生效：系统会马上重算该小项，金牌榜随之更新。想恢复发牌，把勾重新勾上保存即可。 这是"小项级"的总闸；某个小项里单独某条计分通道不发牌，另有开关，见 10.4。

「个人+团体」是什么

用于团体与个人赛事合并的项目：同一条成绩会同时按个人通道与团体通道记分（具体通道见 10.4「计分通道」）。

• 个人通道按个人成绩排名给分，分只记在个人积分榜，不计入单位总分；
• 团体通道把本单位成员在该组别的成绩取平均后排名，按团体模板给分，这部分才进单位总分；
• 平均值的分母（「平均值口径」）在成绩录入页选，见 4.1：只算有效成绩时，一个人都没成绩的单位不参与团体排名、不得分；全部报名人员都计入时，没成绩的按 0 计入，分母是本单位在该组别的报名条数（一人一条报名时就是报名人数）。

配一个「个人+团体」小项的完整链路

1. 在「大项 / 小项」新建小项，类型选「个人+团体」，保存；
2. 到「组别」分区配置组别（团体平均是按组别算的，参赛的组别都要有）；
3. 到「计分通道」分区配上两条通道并「保存全部」——新建小项不会自动生成通道：
   • 个人通道：名次范围 个人名次、名次来源 按成绩自动排名、选个人积分模板、「计入单位总分」取消勾选；
   • 团体通道：名次范围 团体名次、名次来源 按队内平均、选团体积分模板、「计入单位总分」保持勾选；
   • （导入规则包时，规则包里的 channelTemplates 会按项目类型自动生成这两条通道，见 11.3。）
4. 到「报名导入」把参赛人员报上：切到「个人报名」一人报一条（团体平均取的就是这些人的成绩）——注意「个人+团体」类型默认停在「团体报名」页签，要手动切过去；只想让某个单位参加团体、暂不登记具体人员时，也可以用「团体报名」只报单位；
5. 到「成绩录入」逐人录成绩，顺便在「平均值口径」里选好分母口径；发布后个人榜与单位总分同时更新。

「个人+团体」项目的个人通道要有成绩才给分，所以参赛人员必须按人报名（团体报名只报单位不会产生个人成绩）。

10.3 组别

1. 先在上方选中一个小项；
2. 点「新增组别」，填写名称、权重、性别、年龄上下限、排序；
3. 用「上移 / 下移」调整顺序，「移除」删除；
4. 点「保存」提交。已有报名数据的小项：改名 / 改年龄 / 改性别 / 改权重 / 改排序会就地保存——组别本身不重建，挂在它下面的报名、成绩与积分流水一条不动；其中改权重会立即按新权重重算该项目已发布成绩的积分与榜单，改名 / 改年龄 / 改性别 / 改排序不会。新增或删除组别仍走「整体替换」，有报名数据时服务端会拒绝（组别一重建，挂在它下面的报名就断链了）——要增删请先撤掉增删操作、只保存字段修改。

组别之下还有「批次」：批次（第 1 批、第 2 批…）是在成绩录入页给报名行分的录入 / 展示分组，不属于这里的组别配置，也不参与算分——名次与积分仍按「小项 + 组别」整体计算。怎么分批见 4.1。

10.4 计分通道

通道 = 「排谁的名次 + 名次从哪来 + 用哪张积分模板」。

1. 先选中一个小项；
2. 点「新增通道」逐条配置，同一「名次范围 + 名次来源」只能有一个通道；
3. 点「保存全部」整体替换该小项的通道配置；
4. 标记为「不计分」的小项，通道可以保存但不参与积分计算；
5. 「名次来源」选「按队内平均」时，把同一个单位（或个人）在该组别的成绩取平均后排名，并列按积分模板的并列口径处理（默认顺延）；平均值分母取录入页选的「平均值口径」——只算有效成绩时是本单位有有效成绩的条数（一个人都没有效成绩的单位不参与团体排名、不得分），全部报名人员都计入时是本单位在该组别的报名条数（没成绩的按 0 计入）。报名表里 status 不是 registered 的报名项（弃赛 / 取消）既不算参与，也不进分母；
6. 每条通道有一个「计入单位总分」开关，默认打开。关掉后该通道的分只记在个人头上，不进单位总分——「个人+团体」项目的个人通道就靠它做到只记个人；
7. 每条通道还有一个**「奖牌通道」**列，里面是两个开关（都默认打开）：

开关	默认	关掉之后
发奖牌	打开（该通道的名次发奖牌）	这条通道算出来的名次只出积分、不发奖牌：名次与分数照旧，金牌榜与个人榜里不再为它记牌
个人奖牌并入单位金牌榜	打开	只对「名次范围 = 个人名次」的行显示。关掉后这条通道的个人奖牌仍然进个人积分榜的奖牌列，但不计入单位的金牌榜（团体奖牌榜 / 单位总分榜的金银铜）

怎么用：

• 什么该关「发奖牌」：一条通道只用来给分、名次不该算奖牌时——例如个人通道的分要记、但这批名次不是赛会正式名次；
• 什么该关「个人奖牌并入单位金牌榜」：某个个人项目不按单位计牌时（单位金牌榜只统计团体项目的牌子、或该项目被判定为个人项目不计入单位成绩）；
• 「名次范围 = 团体名次」的行不显示第二个开关：团体名次本来就是记在单位头上的，不存在「个人奖牌并入单位」这回事；
• 两个开关都在「保存全部」之后生效，保存后系统会重算该小项并更新榜单；
• 这些开关只决定发不发牌、算不算单位榜，不改变积分（积分由「计入单位总分」与积分模板决定，见第 6 条）。

三个层次一起决定一枚奖牌：小项的「该项启用奖牌结算」（见 10.2）→ 通道的「发奖牌」→ 名次在前三。三者都满足才有奖牌；「计入单位金牌榜」再决定这枚牌算不算到单位头上。 想知道某个小项到底发不发牌：在「大项 / 小项」页选中它，页面下方「当前小项的计分通道」摘要里，关掉的开关会直接标出 不发奖牌 与 个人奖牌不并入单位榜。

10.5 积分模板

1. 左侧点「新建」创建模板，填写编码、名称、并列处理、破纪录加分、录取名次、末位归零；
2. 在「名次 → 分值」表格里添加 / 移除分值明细；
3. 保存会整体替换该模板的分值明细，请核对后再保存；
4. 页面下方的「榜单口径（全局）」卡片设置个人项目得分折算系数（默认 1，步进 0.1，必须大于 0 且不超过 100）：单位总分 = Σ 只记单位的流水 + 系数 × Σ 记到个人的流水。它是全局设置（键名 standings.individual_to_team_weight，不随某一张模板保存，所有模板与所有计分通道共用；导入规则包时，规则包里的同名配置会覆盖它），只有管理员能改，点「保存榜单口径」后榜单按新系数立即变化。「个人+团体」项目的个人通道已经用「计入单位总分」关掉了折算，这里的系数对它没有影响。

同一张卡片里的「分批发布时实时更新榜单」开关（默认开）

• 开（默认）：每发布一批成绩就立即重算名次、各单位总分与奖牌榜，即 4.6 描述的行为；
• 关 = 延迟结算：分批发布时只把成绩上屏，不动积分与名次；等该项目该组所有批次都录完（报名状态不是「正常参赛」的人——退赛 / 取消资格 / 未出场——不算在等待里）才一次性结算，更新榜单与奖牌。未结算的组在分项成绩 / 最新成绩里的名次显示 —（成绩照常显示）——这是有意的，否则会出现「有金牌但 0 分」的自相矛盾；
• 有人永远录不出成绩时，到成绩录入页点 「立即结算」 兜底：按当前已发布成绩先结算一次，补录完还会再自动结算；
• 勾选 / 取消后点「保存结算方式」生效；只有管理员能改。

10.6 运动员

1. 点「新增运动员」，填写姓名 *、性别、年龄、所属单位 *、工号 / 学号、证件号、号码布等（年龄可留空，填了必须是 0–120 的整数）；
2. 证件号（如身份证号）是单人的唯一标识，同名同姓的人靠它区分，两个人的证件号不能重复；没有身份证信息的人只填号码布，此时号码布顶替证件号认人（报名导入会先按证件号认人，没有证件号或库里那条证件号为空时再按号码布认人），两个人的号码布同样不能重复。两项都不填也能保存档案，但这样的人员不能在「报名导入 → 个人报名」里勾选（系统认不出是谁）。已有历史数据两项可以都为空；
3. 每行有三个动作：编辑、停用（停用后按钮变成「启用」）、彻底删除；
4. 个人项目的报名项会关联到运动员，团体项目可以留空；
5. 多选与批量操作：列表每行有勾选框，表头是「全选当前筛选结果」（只勾当前筛出来的人）。选中后顶部出现「已选 N 人」与 批量停用 / 批量彻底删除 两个按钮，整批只提交一个请求，不用一个个点；批量彻底删除会先预览将删掉谁、重算哪些小项，确认后才执行，规则与单个「彻底删除」完全一致（见下）。

停用与彻底删除的区别

状态	人员列表里	还能被报名选中吗	他名下的报名 / 成绩 / 积分	能恢复吗
启用（默认）	在	能	保留	——
停用	还在（标记「已停用」）	不能	保留	点「启用」即可
彻底删除	不在了	不能	一并删除	恢复不了

「停用」是软删除，只是不让他再报名；「彻底删除」是真删除。操作步骤：

1. 点该行右侧红色的「彻底删除」；
2. 在确认框里核对提示（会写明报名与成绩一并删除、相关小项的排名与积分会重算），再点一次「彻底删除」；
3. 完成后页面给出删除规模，例如「已彻底删除「张伟」：报名 1 条、成绩 1 条、积分流水 2 条，已重算 1 个小项的积分与名次」。

「彻底删除」会永久删掉什么

• 这个人的人员档案：从运动员名册里消失，报名选择器里也选不到，界面上再也恢复不了；
• 他名下的报名与成绩；
• 这些成绩产生的积分流水（含已作废的历史流水）与破纪录记录。

删掉成绩会改变同组其他人的名次与得分，所以系统在同一个动作里按新排序重算受影响小项的排名与积分，并把结果推到大屏。因此：

• 已经有成绩的比赛，删人会让名次和积分发生变化（例如原来的第二名升到第一、得分跟着变），删完请核对一下榜单；
• 只是想暂时不让他报名，请用「停用」——它保留全部历史数据，随时可以再启用；
• 该人的姓名也不会再出现在「分项成绩表」「个人积分榜」上：这些榜单是现算的，数据删了他就不在榜里。

10.7 报名导入

报名有两种方式，都在本页完成：从已有名单勾选适合零散补报，表格导入适合批量录入。

从已有名单勾选

这张卡片分成「个人报名 / 团体报名」两个页签，页签下方的小项与组别选择是两个页签共用的。选中某个小项后会自动切到与该小项类型相符的页签（个人项目 → 个人报名；团体 / 对抗 / 个人+团体 → 团体报名），也可以手动切换；切到的页签与小项类型不符时页面会提示一句，生成的报名以当前页签为准。

个人报名（一人一条报名）

1. 选择单位，按姓名 / 工号搜索并在运动员列表里勾选：已报名的运动员显示「已报名」且不可重复勾选；证件号与号码布都没有的运动员显示「缺证件号/号码布」、不能勾选，请先到「运动员」分区补齐其中一项；
2. 点「加入报名」，结果同样显示新增 / 更新 / 跳过数量；报名会自动带上该运动员的证件号与号码布。

团体报名（一个单位一条报名）

1. 在参赛单位清单里勾选要参加本组别的单位，默认一个都不勾——不参加的单位不勾即可；每行显示该单位是否「已报名」、已登记几名队员；
2. 要登记队员时点该行的「登记队员」展开名单逐个勾选（可按姓名 / 工号搜索）；一个队员都不勾就是纯单位报名，队员名单之后还能再补；
3. 勾选「已报名」的单位会出现「提交将清空原名单」提醒：再次提交是用本次登记的队员覆盖原名单；
4. 点「加入报名」，一次为所有勾选的单位各建一条报名。
   • 「全选」只勾启用中且还没报名的单位（已停用的单位要单独勾），且不会展开队员面板；「清空」只取消单位勾选，已登记的队员名单留着，重新勾上就回来。

表格导入

报名表的完整格式、每一列怎么填、个人 / 团体 / 「个人+团体」三种项目的填法和常见报错对照，见单独一份文档 报名名单导入规范——可以直接把那份文件发给各单位填表人。

1. 点「下载 CSV 模板」获取表头样例；
2. 表头共 12 列：event_code、category、team_code、athlete_name、id_card、gender、age、bib、seed、heat、status、member_names（大小写不敏感）。其中 id_card（证件号）、gender（性别）、age（年龄）、heat（批次）为可选列，缺失不影响导入，其余列必须包含；
3. 只要有姓名的行，id_card 与 bib 必须至少填一个，否则该行报错并跳过；gender 只认「男」「女」，其他值忽略；age 可留空，填了必须是 0–120 的整数；证件号是系统认人的第一依据，同一个证件号在同一份文件里重复出现不报错（同一个人报多个组别时会重复，导入结果里会给一条「证件号 XXXX 在本表中出现 N 次（同一人报名多个组别）」提示）；同一小项同一个组别里出现两次同样的证件号才按真重复进冲突列表；同一个号码布给了两个不同的人会报错并跳过（同一个人报多个组别时号码布可以重复）；
4. 人员匹配顺序（证件号是单人的唯一标识）：
   1. 先按 id_card（证件号）匹配：命中即认作同一人；姓名 / 性别 / 年龄 / 单位 / 号码布与他的档案对不上时进「冲突」列表，等你逐条决定（见下）；
   2. 证件号为空、或库里那条还没登记证件号，再按 bib（号码布）匹配：命中即认作同一人，差异同样进「冲突」列表；
   3. 证件号与号码布都没找到，再按「姓名 + 单位」找：
      • 恰好一人，两边给的证件号（或号码布）对得上或有一边没填 → 认作同一人，表里给的证件号 / 号码布 / 年龄会回填进他的档案（不算冲突），重传不带证件号的名单不会把每个人复制一份；
      • 恰好一人，但他已有另一个证件号（或号码布）且与表里不同 → 按「同名的另一个人」新建档案，并在导入结果里单独列出（姓名 / 单位 / 原证件号或号码布 / 新证件号或号码布）提醒核对，不算错误、不拦截；
      • 多人 → 分不清是谁，进「冲突」列表；
   4. 都没匹配到则新建人员（姓名、性别、年龄、单位、证件号、号码布）——被「彻底删除」的人（见 10.6）档案已经不在库里，匹配不到他，再次导入会当作新人员重新建档，他以前的报名与成绩不会回来；
   5. 一个证件号只能属于一个人：表里给的证件号若已是别人的，这一行会按证件号认到那个人，姓名 / 单位等对不上就进冲突列表让你决定；确实无法认到（例如同时又给了别人的号码布）时会报「证件号 X 已被另一个人占用（姓名 Y，号码布 Z）」并跳过，不会把证件号抢过来；
5. status 列很宽容：大小写不敏感（DNS、Registered、registered 都认），也认中文别名——
   • 正常 / 正常参赛 / 参赛 → 正常参赛；
   • 退赛 / 弃赛 / 请假 → 退赛；
   • 取消资格 / 犯规 → 取消资格；
   • 未出场 / 未到 / 缺席 → 未出场。 留空即「正常参赛」。真正认不出的写法会给出中文行级错误、该行跳过，例如「第 12 行：status「已报到」无法识别，只能填 registered / scratched / dq / dns（或留空）」；
6. bib 列会同时写入人员档案与报名记录；从已有名单勾选生成的报名也会带上人员的证件号与号码布；
7. 把 .csv 或 .xlsx 拖入虚线框，或点击选择文件（单个文件不超过 16MB；xlsx 只解析第一个工作表）；
   • CSV 编码不用管：UTF-8、带 BOM 的 UTF-8（Excel 的「CSV UTF-8」）、GBK / GB18030（中文 Windows 上 Excel「另存为 CSV」的默认编码）、UTF-16 都能直接导入，中文不会乱码，服务端会自动识别；
8. 点「开始导入」，页面显示新增 / 更新 / 跳过数量；匹配不到的行会跳过并回显行号，修正后可重新上传。

导入会同步重算受影响的小项与组别：报名名单改的是「谁还算数」（新建报名、或把正常参赛改成退赛 / 取消资格 / 未出场），所以导入完成后系统会按新名单重算这些组别的名次与积分，并刷新榜单与大屏——不受「分批发布时实时更新榜单」这个延迟结算开关影响（同 4.8 的批量退赛）。「只改了姓名 / 号码布 / 批次」这类不影响算分的改动不会白算一遍。

人员信息冲突的处理

导入时如果按证件号（或号码布、「姓名 + 单位」唯一命中）找到的人在系统里已有记录，但表里的姓名、证件号、性别、年龄、单位或号码布与他的档案不一致，这个人会被列为冲突，本次不写入（该人的报名也不会创建）。处理办法：

1. 导入结果里会单独列出冲突人员，每条显示已有数据、新数据，以及不一致的字段（含证件号、年龄与号码布）；
2. 用左侧复选框选中一条或多条（也可以全选），再点「保留已有数据」或「使用新数据」：
   • 保留已有数据：人员字段沿用系统里已有的，按这个人的信息建 / 更新报名；
   • 使用新数据：用表里的姓名、证件号、性别、年龄、单位、号码布等更新该人员，再建 / 更新报名；
3. 没有做决定的冲突不会被写入，可以稍后再处理；全部处理完后冲突列表清空。
   • 有一种冲突卡片底部写着**「本表内重复行」**：同一证件号 + 同一个小项同一个组别在表里出现了两次。这种卡片上可能一个字段都没高亮，是正常的——两条本来就可能一模一样。保留已有 = 已经导入的那条报名保持不动，使用新数据 = 用这一行的值覆盖它。

「从已有名单勾选」走的是同一个导入通道，人员匹配与冲突处理规则完全一致。

「同名的另一个人」提醒（不是冲突）

如果表里某人的证件号（或号码布）与库里「同名 + 同单位」的人不同，系统按同名的另一个人给他新建档案，并在导入结果里单独列出一块：以下 N 人按同名的另一个人新建了档案（证件号 / 号码布不同），逐条显示 姓名（单位）：证件号 XXX → XXX；号码布 XXX → XXX。这些行已经导入成功、不会拦截，只是提醒你核对证件号与号码布有没有写错；若确认是本人写错了号，到「基础数据 → 运动员」把档案里的号改回来、并删掉多出来的那条档案即可。

同一证件号在本表里出现多次时，导入结果里还会给一条 证件号 XXXX 在本表中出现 N 次（同一人报名多个组别） 的提示——这是正常情况，只提醒你别把不同的人写成同一个证件号。

种子等字段无法在勾选界面填写，仍需通过表格导入；号码布取自人员档案，勾选时会自动写入报名。团体报名登记的队员名单只存姓名，不会带动运动员档案。

---

11. 导出

页面分四个页签：结果导出 / 基础数据 / 赛事项目包 / 规则包。

11.1 结果导出（xlsx）

导出项	内容	文件名
总表	总积分榜 + 团体奖牌榜 + 个人积分奖牌榜，一个工作簿	总积分榜.xlsx
全部	总表 + 全部分项，多 sheet 工作簿，适合归档打印	赛事成绩总表.xlsx
全部（单页）	所有单位、所有项目、所有成绩平铺在一张表里（一个工作簿只有一张表），适合筛选与二次统计	赛事成绩总表（单页）.xlsx
分项成绩表	选择一个小项导出成绩与积分	分项成绩表.xlsx
单位积分明细	选择一个单位，逐项列出得分来源	单位积分明细.xlsx
报名名单	本页下方的「报名名单」卡片：按小项 / 组别 / 单位 / 批次筛选后导出报名数据（不填 = 全部）。13 列：小项编码、小项名、组别、单位编码、单位名、姓名、证件号、号码布、批次、性别、年龄、状态、备注；号码布按文本导出，前导零不会丢	报名名单.xlsx
团体奖牌明细	在「积分榜 → 团体奖牌榜」页操作：逐枚奖牌列出单位 / 大项 / 小项 / 组别 / 名次 / 奖牌 / 运动员、队，每个有奖牌的单位一张分表（末尾小计）	团体奖牌明细.xlsx
个人积分总明细	在「积分榜 → 个人积分榜」页操作：逐条列出单位 / 运动员 / 大项 / 小项 / 组别 / 名次 / 成绩 / 得分 / 来源，每个有得分的单位一张分表	个人积分总明细.xlsx

• 「分项成绩表」需先选择小项，「单位积分明细」需先选择单位；「报名名单」的四个筛选（小项 / 组别 / 单位 / 批次）都可以留空，留空就是不筛这一维度（全导）；
• 录了但还没发布的成绩也会占一行（「分项成绩表」「全部」「全部（单页）」都是）：这类行的成绩列写 分数未录入、名次与积分列写 —、状态列写「草稿」，人不会从表上消失；完全没有录成绩的报名行（连草稿都没有）照样占一行——名次 / 成绩 / 积分三列都写 —（不是空、也不是 0）、状态列写「未录入」；
• 「全部」与「全部（单页）」的区别：两者内容同源，覆盖的都是全部小项的全部报名 / 成绩；「全部」把每个小项放成一张分表（多 sheet 工作簿），「全部（单页）」把所有行平铺进同一张表，每行前面补「大项 / 小项 / 组别」三列以便脱离表名也能看懂。单页表的列是：大项、小项、组别、名次、号码、单位、运动员/队、成绩、积分、状态、备注；
• 「团体奖牌明细」与「个人积分总明细」不在本页，在「积分榜」页对应榜单的卡片头点「导出奖牌明细」「导出个人明细」（见 8.3）；个人积分总明细里的「得分」与个人积分榜一致，不受榜单口径折算系数影响；
• 导出文件由浏览器直接下载，表头、合并单元格与字体已按打印模板预设。

11.2 赛事项目包

服务端一次只打开一个赛事项目，页面上看到的数据全部来自「当前」的那一项，其余项目只是躺在数据目录里的数据。

赛事项目列表

• 列出数据目录下的全部项目，含项目名、更新时间与占用大小，当前打开的那一项带「当前」徽标；
• 每行的「切换为当前赛事」用于切换（仅管理员），切换过程见下面「导入后怎样才算生效」；
• 列表里出现「缺 event.db」的项目不可切换，说明该目录不是完整的赛事包。

导出 zip：包内含 meta.yaml、event.db、uploads/、rules.yaml，整包拷走即可在另一台机器复现整场赛事。uploads/ 里除了会标、背景图与单位 logo，还包含上传到赛事信息里的字体（在 uploads/fonts/ 下），字体设置也随赛事库一起走，导入后不用重新上传字体。

导入 zip（仅管理员）：选择 .zip，可填「重命名」，勾选「覆盖同名项目」会先二次确认。导入只把数据解到数据目录，不会自动切换当前赛事，所以导入完成后页面会提示「已导入为 xxx，但它还不是当前赛事」。

导入后怎样才算生效

1. 在导入完成的结果框里点「立即切换并重启服务端」（也可以稍后在赛事项目列表里点该项目的「切换为当前赛事」）；
2. 服务端把项目名写进数据目录根下的 active_project.txt（不在赛事项目目录里）后退出，由服务管理窗口自动拉起，并打开刚切换的赛事；下次启动即使不带启动参数，也仍然是这个赛事；
3. 期间页面显示「正在重启服务端…」，每 1.5 秒探测一次服务端是否回来，恢复后自动刷新页面（最多等 60 秒）；
4. 超过 60 秒仍未恢复时，页面会提示打开服务管理窗口确认服务端状态，待其显示「运行中」后手动刷新本页。

切换会让服务端重启，正在录入的成绩页会短暂无法提交，请避开比赛进行中操作。 账号与会话存在数据目录根下的 system.db（系统库）里，属于整个系统而不属于某个赛事库，所以切换赛事不会让你退出登录；万一重启后页面变成只读访客视图，登录一次即可，忘记密码用 scoreboard.exe passwd 重置（见常见问题「忘记密码怎么办」）。

11.3 规则包

规则包文件放在 %LOCALAPPDATA%\ScoreboardConsole\rules\（安装包里附带的那份会在首次启动时复制过去；见部署指南 3.5）。

• 导出 rules.yaml：导出积分模板、并列规则、破纪录加分、计分通道与项目覆盖；
• 导入（仅管理员）：
  1. 选择 .yaml / .yml 文件（就是上面那个 rules\ 目录里的）；
  2. 点「预览差异」，查看格式是否兼容、影响多少个小项、逐条改动；
  3. 确认无误后点「确认导入并全量重算」，服务端会按新规则重算全部已发布积分。

规则导入会立即改变积分榜与大屏，且不能一键撤销，纠错需重新导入旧规则包。

11.4 基础数据（单位 / 大项 / 小项 / 组别）

「基础数据」页签有导出与导入两张卡片，用于批量维护基础数据（单位 / 大项 / 小项 / 组别）。

导出基础数据包：点「导出 xlsx」导出一个工作簿，含四张工作表：单位 / 大项 / 小项 / 组别（组别表带所属小项编码）。列名是中文表头；导出的文件可以直接原样导回来，识别到的差异为 0。导出是只读下载，不需要管理员权限（访客也能用）。

导入基础数据包（仅管理员）：

1. 选择 .xlsx 文件（只认 xlsx：四张表装不进一个 CSV）；
2. 点「预览差异」：先看到 新增 N 条 / 更新 M 条 / 无变化 K 条 / 错误 K 条 与逐行变化（哪个字段从什么变成什么），这一步不写库；
3. 确认无误后点「确认写入」才真正写库；有错的行会被跳过，合法的行照常写入（与报名导入一致）；行级错误是中文并带真实 Excel 行号，例如 单位 第 3 行：单位编码必填。

几条现场要记住的规则：

• 按编码匹配：单位 / 大项按编码，小项按编码，组别按「小项编码 + 组别名」；存在就更新、不存在就新建；
• 绝不删除：文件里没有的行（表里没有、或整张工作表没放）不会被删掉，也不会被停用；
• 列不在表里 = 不动该字段（布尔列也一样——把整列「启用」删掉再导回，不会把所有停用的单位/大项改成启用）；列在表里但格子留空 = 按该列的默认口径处理：简称 / 颜色 / 场地 / 备注等文本列与年龄上下限会清空，权重留空按 1、启用 / 计分 / 计破纪录等布尔列留空按「是」，排序留空则保持原来的值（四张表口径一致，单位 / 大项留空同样不会被改写）。改数据前先想清楚这一点；
• 枚举列是唯一的例外：列在表里但格子留空 = 不改动，不是"取默认值"。小项的类型 / 结果模式 / 结果类型 / 比较方式 / 状态 / 平均口径、组别的性别都属于这一类：留空就沿用这一行在系统里原来的值（只有新建的行才用默认值，例如新建组别时性别留空 = 不限）。这么定是为了防手滑——表格里误清一格，不会把一个已发布的小项打回「待录入」、也不会把「团体」改成「个人」；
• 表头行可以不在第一行：从系统导出的包表头在第 4 行（上面是标题与副标题），手工整理的表表头在第 1 行，两种都能识别（识别范围是前 20 行）；
• 枚举列要填系统里的英文规范值（表头是中文，容易踩）：类型 individual / team / match / individual_team，录入方式 auto / manual，成绩类型 time / distance / count / score / none，比较方式 asc / desc / none，小项状态 pending / ongoing / finished / published，平均口径 valid / all；布尔列（启用 / 计分 / 计破纪录）填 是 / 否；组别表的「性别」填 男 / 女（列在表里但格子留空 = 不改动；新建的组别留空 = 不限）；
• 最稳的用法：先「导出基础数据包」，在导出件上直接改，再导回来——表头与取值天然对得上；手工整理的表格请照导出件的表头写；
• 被「彻底删除」的单位不在导出件里；导入不会把它翻出来（已有的隐藏记录只更新字段，仍是隐藏状态）。

---

12. 变更历史

仿 Git 图谱的只读操作记录。

1. 顶部可筛选小项，以及「全部时间 / 近 24 小时 / 近 7 天」；
2. 左侧时间轴最新在上，节点显示动作（发布 / 撤销发布 / 编辑）、项目、操作人、时间与备注；
3. 点节点，右侧显示操作人、影响单位与成绩前后对比（diff）；
4. 本页不提供一键回滚。纠错请到「成绩录入」走「撤销发布 → 修改 → 重新发布」。

---

13. 日志

审计日志，只读、不可删除，记录谁在什么时候改了什么。

1. 可按「动作」「实体」筛选，点「清除筛选」复位。动作是子串模糊匹配、由服务端在全库范围执行（比如填 entry.、import、team.purge 都能筛出一批），实体筛选与分页作用于返回的最近 200 条窗口；
2. 列表显示时间、操作人、IP、动作、实体、请求 ID；关键动作会带「关键」标记；
3. 点某行「对比」展开，查看改动前后的 JSON 差异；
4. 动作筛选不受 200 条窗口限制（服务端按全库匹配后再取回），实体筛选与翻页只在窗口内；
5. 该页面仅管理员可查看。

本页是业务审计（谁在什么时候改了什么），只记放行的操作。想看「某次操作为什么被系统拦下」——比如保存被拒、导入报错、切页提示离线——那要看服务端写在数据目录 logs\ 下的两类日志文件（放行类 / 拦截类）：我们主动拦下的报错会写明中文原因、拦截点 文件:行 函数名、操作人与 requestId。位置、轮转与复盘步骤见部署指南 · 服务端日志与拦截复盘。

---

14. 系统设置

页面分五个页签：用户管理 / 登录有效期 / 备份 / 图片资源 / 赛事信息。前四个需要管理员权限，非管理员只看到「赛事信息」（其余页签不显示）。

14.1 用户管理

操作	说明
新建用户	填写账号 *、显示名 *、角色 *（管理员 / 录入员）、初始密码 *（至少 8 位）；新用户首次登录强制改密
编辑	修改显示名、角色、启用状态；账号创建后不可改
停用	二次确认后该用户无法登录，正在使用的会话也会失效
重置密码	生成随机密码，只显示一次，可复制后交给用户；旧密码立即失效

访客身份由系统默认提供，不需要也不允许建「访客账号」。

14.2 备份

• 列表显示备份文件名、来源、大小、创建时间；
• 点「立即备份」马上生成一份；
• 服务端默认每 5 分钟自动备份一次，自动、手动、发布前备份都按 backup.keep（默认 20 份）滚动保留；⚠️ deploy\backup.bat 额外产出的 *-uploads-*.zip（上传图片与字体）不在这个滚动清理里，要手工清理；
• 每行备份都有**「恢复」**按钮（仅管理员）：用那份备份覆盖当前库——服务端会先自动留一份「恢复前安全副本」（pre-restore-…db，不参与滚动清理），替换文件后优雅重启，页面自动等待刷新。恢复是覆盖式的（会丢备份时间点之后的改动），恢复系统库会连账号与会话一起换掉，不会带回上传的图片与字体；右侧「恢复说明」列出细节与停机手工恢复步骤（详见部署指南第 8 节）。

14.3 赛事信息

字段	说明
赛事名称 *	必填
副标题 / 主办方	可选，显示在大屏顶部
赛事会标	图片，显示在大屏左上角。点「上传图片」选文件即可（png / jpg / webp / gif，单张不超过 5 MiB）；上传的图片存在赛事项目目录的 uploads/ 里，会随赛事包一起导出/导入
大屏标题 / 大屏副标题	大屏顶部标题区
大屏会标	图片，只对大屏生效；留空则用上面的「赛事会标」
大屏背景图	图片，铺满大屏底层；留空则用内置深色背景
轮播间隔（秒）	控制大屏底部滚动条（奖牌榜 Top3 / 最新完成项目 / 公告）的切换间隔，5–120 秒
主题色	大屏主色，如 #3482FF
个人积分榜上屏	开关；关闭后大屏不展示个人积分榜
个人榜奖牌列	开关，默认展示；关闭后个人积分榜不显示金 / 银 / 铜三列
标题字体 / 正文字体	下拉选择，分别作用于大屏标题与大屏正文；第一项是「默认（跟随系统）」，之后是四款内置字体与已上传的字体。只影响大屏画面，管理端界面字体不变
字体库	「上传字体」按钮与已上传字体列表（每行显示字体名与地址，可「删除」）

改完点「保存」；未保存时显示「未保存」徽标，点「放弃修改」可还原。

字体区块

四款内置字体随程序分发，不用上传：Noto Sans SC（思源黑体同源）、Noto Serif SC（思源宋体同源）、MiSans、Source Han Sans CN（思源黑体）。区块底部的「预览」会按当前所选字体实时渲染一行中文，先看效果再保存。

上传自己的字体：

1. 在「字体库」点「上传字体」，选择本地字体文件；
2. 只支持 .ttf / .otf / .woff / .woff2，单个文件不超过 20 MiB；格式不符或超过上限会在上传前直接提示；
3. 上传成功后，新字体立刻出现在两个下拉里（按文件名显示）；文件名重复会被拒绝，需要先删掉旧文件或改名后再传；
4. 字体文件落在当前赛事项目目录的 uploads/fonts/ 下，列表里会显示它的地址 /uploads/fonts/<文件名>；文件名里的中文会保留，其他特殊字符会被换成下划线。

选好字体后点「保存」提交：服务端会校验字体是否真实存在，选了无效字体会被拒绝并给出中文提示。保存后大屏按新字体重新渲染；字体文件加载失败时大屏自动回落到默认字体，不会出现方块或空白。

删除已上传的字体：

1. 在「字体库」列表里点该行的「删除」，二次确认后生效；
2. 正在被标题字体或正文字体使用的字体不能删，会提示「正在被大屏使用，请先在赛事信息里改掉标题/正文字体」：先把下拉改成别的字体并保存，再回来删。

字体文件就在赛事的 uploads/fonts/ 里，所以导出赛事项目包会连字体一起带走，导入后直接可用、不用重新上传；字体设置存在赛事库里，也随包走（见 11.2）。

修改大屏标题、主题色、字体等会立即影响所有在线大屏，请避开颁奖或播报时段。

14.4 登录有效期

「登录有效期」页签（仅管理员）设置这台机器上所有人的登录能待多久。它是机器级配置（存在系统库 system.db 里），不随赛事项目包走。

项	说明
登录有效期（小时）	可填 1–720 的整数（最长 30 天），默认 24 小时；原先固定 12 小时的做法已取消
当前会话将于 X 过期	页面顶部与右上角用户菜单里都会显示当前登录的到期时间

• 滑动续期：只要在有效期内继续操作（两次操作的间隔不超过设定时长），到期时间会自动往后顺延——不会因为「登录满 N 小时」被踢。因此比赛期间可以从早用到晚不重新登录，例如把有效期设成 72 小时（三天）；
• 改有效期不会当场踢人：已经登录的会话不会在改设置的一刻被判定过期（库里到期时间不动），它们会在下一次操作时按新的有效期续期——调长会立即顺延（例如从 12 小时调到 72 小时，正在用的会话下次有请求就顺延成 72 小时），调短也只影响之后的续期，不会把正在用的人下线；
• 页面开着不动时，管理端每 10 分钟会自动续期一次，所以只要页面还开着就不会掉线；
• ⚠️ 不是「永不掉线」：如果超过设定的有效期（默认 24 小时）一直没有操作（例如浏览器关了、机器关机过夜），再打开时仍会要求重新登录。
• 忘记密码时用 scoreboard.exe passwd 重置（见常见问题「忘记密码怎么办」）。

14.5 图片资源（清理没在用的图）

「图片资源」页签（仅管理员）列出 uploads\ 里没有被任何配置引用的图片（也就是「孤儿」），用来清掉换图后留下的旧文件。表格显示预览、文件名、大小、修改时间，可单张「删除」或勾选后「删除选中」；删除前有危险确认框，删掉不可恢复。

什么算「被引用」——下面四处任意一处指向它，它就不算孤儿、不会出现在列表里：

• 赛事会标、大屏会标、大屏背景图（「赛事信息」页签里的三个图片字段）；
• 任何一个参赛单位的单位图标（logo 字段）——已被「彻底删除」的单位也算，因为它还能被恢复，logo 得留着。

用法（典型的「换图后清旧图」）：

1. 在「赛事信息」或「参赛单位」里把对应字段改成新图（或清空）并保存，旧图就没人引用了；
2. 到「图片资源」页签点「刷新」，旧图会出现在孤儿列表里；
3. 核对预览确认是那张没用的图，勾选 → 「删除选中」→ 确认。

• 若某张图在你打开页面之后刚被配到别处（比如别人同时改了单位 logo），服务端会拒绝删除并在结果里说明被谁引用——这是有意的「宁可漏删、不误删」；
• 这个页签只管图片；上传的字体在「赛事信息 → 字体库」里各自删除（被标题 / 正文字体引用的不能删，见 14.3）；
• 这些图片与字体都是文件，在赛事项目的 uploads\ 里：备份的 .db 快照与「一键恢复」都不含它们（见 14.2、常见问题 Q37）。

---

15. 修改密码

1. 输入原密码；
2. 输入新密码（至少 8 位）并再次确认；
3. 点「修改密码」；
4. 修改成功后所有会话作废，需要用新密码重新登录。

首次登录或密码被管理员重置后，会强制进入本页。

---

16. 关于

展示系统名称、版本号、构建时间、运行模式，以及技术栈与开源许可、字体清单（四款内置字体的用途与授权；给大屏换字体见 14.3）、键盘快捷键、部署信息（服务端端口、访问地址、赛事项目名）。

---

17. 大屏端使用

17.1 页面

大屏支持六个页面：

页面	内容
总积分榜	名次、单位（单位 logo + 单位名）、总分，以及名次升降箭头（约 2 秒后淡出）
团体奖牌榜	名次、单位（带单位 logo）、金 / 银 / 铜、合计
个人积分奖牌榜	名次、姓名（姓名前显示所属单位 logo）、单位、总分、奖牌
分项成绩	最新已完成项目的成绩，单位列名字前显示单位 logo
实时赛况	当前正在进行项目的实时排名（见下方说明）
公告	管理端推送的公告：推送后先全屏展示，之后常驻底栏的「公告」槽位

实时赛况：专门给「现在正在比的项目」用，每一行显示名次、运动员 / 队、单位（带单位 logo）、成绩，按名次升序。

• 显示哪个项目由管理端判定（见第 9 节的「实时赛况」卡片）：优先按人工指定的项目，其次按项目排期（开始时间前后 30 分钟内），都没有时显示最近发布过成绩的项目——所以在下一场开始之前，这一页会一直保持显示上一场的成绩；
• 1 个项目单栏铺开，2 个项目自动左右分栏（最多 2 栏，对应「两个项目时间撞在一起」的现场）；
• 只显示已发布的成绩：配合分批发布，发一批这一页就更新一批（见 4.6）；
• 同一个小项分了多个组别时，栏里显示最近发布的那一组，标题旁用「另有 N 组」标注；该项目还没有已发布成绩时栏内显示「该项目暂无已发布的成绩」；
• 每栏最多列前 10 个名次；一个项目都没有时整页显示「暂无进行中的项目」（刚切到本页、结果还没回来时显示「正在获取当前项目…」）。

单位 logo 取自「基础数据 → 参赛单位」里上传的图片（见 10.1），按行内文字大小显示，不会撑开行高；没传 logo 的单位不占位，图片临时加载不出来时保留占位、刷新后恢复，队名不会跳动。

大屏的标题字体与正文字体取自「系统设置 → 赛事信息 → 字体」（见 14.3）：可选四款内置字体，也可以上传自己的字体；上传字体加载失败时自动回落到默认字体，画面不会出现方块或空白。

除了 Console 开出来的本机大屏窗口，局域网设备（另一台电脑、电视浏览器）打开 http://<主机IP>:19540/display 也能当大屏用。这类设备会出现在管理端「大屏控制 → 在线大屏」列表里（标记为「局域网浏览器」），也能被单独切页，用法见第 9 节；它们不受 Console 的 kiosk、防熄屏控制（另见常见问题 Q29）。

17.2 轮播与锁定

• Console 启动的多屏大屏窗口默认每屏锁定一页，不轮播；
• 在管理端「大屏控制」点「解锁」后开始整页轮播，每 20 秒切换一页；
• 公告页是手动触发的页面，不参与自动轮播；个人积分榜可在「赛事信息」里关闭上屏；「实时赛况」页参与轮播（见 17.1）；
• 底部滚条固定有「公告」槽位：管理端推送过公告就一直显示最近那条，没有公告时显示「暂无公告」（见第 9 节）；
• 点「锁定」可停在当前页。

17.3 明细覆盖层

• 管理端推送单位积分明细后，大屏右侧弹出半屏覆盖层，显示该单位每一分的来源；
• 默认 60 秒后自动关闭并恢复轮播；
• 管理端「关闭大屏明细」可立即关闭。

17.4 断线与自愈

• 与后端断开时，大屏顶部显示离线角标，并继续展示本地缓存的最近一份快照；
• 连接恢复后自动拉取最新数据；
• 大屏每 24 小时自动重载一次，Console 同时启用防熄屏。

17.5 调试标识

窗口化（带标题栏的调试窗口）且没有全屏时，右上角会显示一行「实例 x · 屏 x」，用来分辨这块屏是哪个实例。除此之外没有别的调试标识——数据版本号 vN 角标已经去掉，任何情况下都不再显示；需要核对某块屏有没有跟上服务端时，用管理端仪表盘「实时连接」里的「版本 N」对照。

• kiosk 全屏窗口（多屏时每屏一个）不显示任何调试标识，正式上屏的画面是干净的；多屏 kiosk 也不响应 F11。
• 单屏窗口化窗口按 F11 全屏后，自绘标题栏与「实例 · 屏」会一起消失、画面铺满整块屏；再按一次 F11 回到窗口化，标题栏与标识一起回来。

---

18. 常见操作问题

Q：为什么录入的成绩大屏上没有？ 草稿不会上屏。需要点「发布」（或 Alt+Enter），发布成功后立即更新。

Q：发布后发现有错怎么办？ 到「成绩录入」找到该组，点「撤销发布」→ 修改 → 重新发布。撤销会作废该组积分流水，大屏回退；全程可在「变更历史」追溯。

Q：并列名次怎么显示？ 成绩相同（或手动名次相同）即视为并列，显示同一名次，例如两个「3」。积分按规则包里的并列口径计算，默认是「顺延」：并列第 3 各得第 3 名的分，无第 4 名，下一名是第 5 名。奖牌也按并列处理，并列第 1 各记 1 金、无银牌。

Q：为什么「发布」按钮是灰的？ 可能原因：当前是访客未登录（只读）、处于示例数据模式，或校验存在错误。页面会给出对应提示。

顶部显示「连接中断」不会再禁用按钮：实时推送断了只意味着数据可能不是最新，写操作照常提交并由服务端校验。

Q：为什么页面显示「示例数据」？ 说明前端连不上后端或接口未就绪，此时操作不会写入真实赛事。请检查 Console 里服务端是否为「运行中」，恢复后刷新页面。

Q：大屏上的积分明细怎么关？ 在「积分榜」页点「关闭大屏明细」，或在「大屏控制」里锁定 / 切换页面；不操作时 60 秒后自动关闭。

Q：公告怎么发？多久消失？ 在「大屏控制 → 公告」输入文字，设置「滚动时长」（5–120 秒，即全屏展示的秒数）后点「推送公告」：大屏会先全屏显示，到时间后自动回到原来的页面，公告不会消失，会留在底栏「公告」槽位继续显示，直到你推一条新的或点「清除公告」。公告卡片上会显示当前公告正文与「当前公告：有 / 无」；新开的大屏、断线重连后会把当前公告再全屏播一遍（默认 15 秒）后留在底栏。

Q：怎么切换到另一个赛事项目？ 在「导出 → 赛事项目包」的赛事项目列表里找到目标项目，点「切换为当前赛事」：服务端会退出并由服务管理窗口自动拉起，页面显示「正在重启服务端…」，恢复后自动刷新，同时记下「上次打开的赛事」，下次启动即使不带参数也仍打开它。详见部署指南第 8.5 节。别用 Console 的 config.json 给 server.args 加 -project 来切赛事：那样每次启动都会优先打开并写回这个项目，页面里切完、重启后又被拉回去。

Q：导出的文件在哪里？ 结果导出和赛事包由浏览器下载到默认下载目录；服务端自身也会在数据目录下的 exports\ 里生成临时包（导出完成后自动删除）。数据目录默认是 %LOCALAPPDATA%\ScoreboardConsole\data，详见部署指南第 3.4 节。

Q：登录多久会过期？ 默认 24 小时，可由管理员在「系统设置 → 登录有效期」里改成 1–720 小时（最长 30 天）；比赛期间建议设成 72 小时。会话是滑动续期的：有效期内继续操作会自动顺延到期时间，不会因为「登录满 N 小时」被踢；但超过设定的有效期一直没操作（比如浏览器关了、机器关机过夜），就需要重新登录。当前到期时间在右上角用户菜单与「系统设置 → 登录有效期」里都能看到。

Q：为什么登录失败次数多了会被暂时拒绝？ 登录有频率限制（每个 IP 每分钟 5 次），写操作也有频率限制（每个用户每分钟 120 次）。稍等一分钟再试即可。

Q：为什么有些页面 / 按钮看不到或不可用？ 权限按角色控制：访客只能只读；变更历史、日志、系统设置、备份、用户管理、规则包与赛事项目包导入需要相应角色。请用对应账号登录。