AskaEth
9ef68c2589
## ① 现场问题：kiosk 窗口点击穿透（原设计方向反了） `displays.js` 原来对多屏 kiosk 调 `setIgnoreMouseEvents(true)`，注释写的是 「防止现场误触」——但该 API 的语义是「本窗口忽略鼠标」，点击会**落到它后面的 窗口或桌面**，现场想防的误触正好变成误点别的东西；被忽略鼠标的窗口也点不活。 现在窗口**默认吞掉鼠标、不穿透**。 配置项**改名**为 `display.allowClickThrough`（缺省 false；显式 true 才穿透）。 **旧键 `display.ignoreMouse` 完全不读**——老机器的配置文件里还写着旧版模板留下的 `ignoreMouse: true`，而配置策略是「已存在不覆盖」，只改默认值等于老机器升级后 照样穿透；改名才能让默认值真正生效。启动时若发现旧键会记一条中文提示（只记一次）， 并在合并后的配置里把它剥掉，防止将来有人再读到那个陈年 true。 （不是自动改写用户配置文件：无法区分「操作员刻意写的 true」与「旧模板留下的 true」。） ## ② 现场问题：任务栏盖住 kiosk 窗口、被盖住后抢不回前台 原顺序是 `setKiosk(true)` 之后又 `setBounds(...)`，在 Windows 上会把窗口从真正的 全屏态拽回「恰好铺满该屏的无边框窗口」→ 不是 topmost，任务栏与拖过去的窗口都盖得住。 现在固定为 **先 `setBounds` 定位 → 再 `setKiosk(true)` → 最后 `setAlwaysOnTop(true, 'screen-saver')`**（默认层级 `floating` 在 Windows 上仍画在任务栏下面），并加了 「已达标就不重复进出 kiosk」的守卫避免重排白闪；非 kiosk 分支会摘掉置顶。 Win 真机行为需现场复核，代码/桩级已验（含顺序与层级的断言）。 ## ③ 新功能：大屏控制页「局域网大屏」卡片 - 服务端新增 `GET /api/system/network`（recorder 及以上）：回本机可用局域网 IPv4 （排除回环/link-local/IPv6，去重，按 192.168/10/172.16-31 优先排序）+ 真实监听端口 + 路径；无地址回 `[]` 不报错。 - 卡片：每个地址一条可点击链接 + 复制按钮，第一个地址配二维码（148px）。 - **二维码是离线自实现的纯 TS 编码器**（版本 1–40 自动、ECC L/M/Q/H、8 种掩码择优）， 正确性用 **Python OpenCV 真解码**验收：29/29 条解出原文（含中文与边界）， SVG 渲染后再解码 4/4，并把验证过的矩阵冻结成仓库参照用例。 - 复制按**非安全上下文**处理：面板常从 `http://192.168.x.x` 打开，那里 `navigator.clipboard` 是 undefined，自动回退 `execCommand('copy')`。 ## ④ 真机联调抓出并修掉一个时序缺陷（真浏览器 + 真服务端） `DisplayPage` 的 `refreshLan()` 在挂载时跑，而 `auth` 是异步加载的——那一刻 `auth.readOnly` 必然为 true，卡片把「当前为只读访客」写进一个**普通 ref** 就返回了， 身份落定后没有任何东西再触发它：**管理员登录后卡片永远停在访客态， `/api/system/network` 一次都没被请求**。 改为「gate 由 computed 直接渲染 + watch gate 变 null 时重跑加载」，并补回归钉子。 （同时修正了一条把该错误结构当成正确行为的源码断言用例。） 端到端证据：真服务 + 局域网 IP（真非安全上下文）→ 卡片列出两个地址、点击复制变 「已复制」（走 execCommand 回退）→ 浏览器渲染的二维码截图经 cv2 解出 `http://10.50.101.85:19861/display`。 ## 文档 部署指南配置表与多屏行为、使用手册「大屏控制」与局域网设备段、devdocs 05/07/10/13、 升级说明新增 dev_0.4.0（含旧键废弃与启动提示）。**无数据迁移**，旧赛事包照常导入。 自检：服务端 13 包 ×2；前端 vue-tsc + 645 例 ×2 + build；Console 20 文件 + 68 例。
244 lines
22 KiB
Markdown
244 lines
22 KiB
Markdown
# 升级说明
|
||
|
||
> **按版本倒序，最新在最上面。** 每次升级前先看「要升到的那一版」这一节，照着做完再开赛。
|
||
> 数据、配置、规则包都在用户数据目录（`%LOCALAPPDATA%\ScoreboardConsole\`），**覆盖安装不会丢**，见《部署指南》3.4 / 3.5。
|
||
> 常规升级流程（停服务 → 覆盖安装 → 启动 → 核对）见《部署指南》3.1 / 3.4。
|
||
|
||
---
|
||
|
||
## dev_0.4.0（当前版本）
|
||
|
||
### 一句话
|
||
|
||
**没有数据迁移，旧赛事项目包照常导入**：本版修了两个现场问题（kiosk 窗口误点穿、kiosk 窗口被任务栏盖住）并新增一个功能（大屏控制页的「局域网大屏」卡片）。⚠️ 唯一要留意的：**老机器配置文件里的 `display.ignoreMouse: true` 已废弃、不再生效**——升级后大屏窗口自动变成「不穿透」，想恢复穿透要改用新键名。
|
||
|
||
### ① kiosk 窗口不再点击穿透，旧键 `display.ignoreMouse` 已废弃
|
||
|
||
- **以前**：多屏 kiosk 窗口默认开启 `setIgnoreMouseEvents(true)`，本意是「不接收误触」，但它的真实语义是「**本窗口完全忽略鼠标**」——点击会落到大屏**后面**的窗口或桌面上，现场想防的误触反而变成误点别的东西；被忽略鼠标的窗口也点不活、被别的窗口盖住后抢不回前台。
|
||
- **现在**：大屏窗口**默认吞掉鼠标点击、不穿透**，点击不会漏到后面的窗口或桌面，被盖住后点一下就能回到最前。
|
||
- **开关改名**：`display.ignoreMouse` → **`display.allowClickThrough`**（默认 `false`）。旧键现在**完全不读**——老机器配置文件里那个 `ignoreMouse: true` 不会再让大屏穿透。
|
||
- **为什么换键名而不是只改默认值**：旧版默认就是穿透，而且旧版模板已经把 `ignoreMouse: true` 写进了现场机器的配置文件（`%LOCALAPPDATA%\ScoreboardConsole\console\config.json`），而 Console 的规矩是**已存在的用户配置绝不覆盖**——光改默认值救不了老机器，配置文件里那个显式 `true` 会一直压着默认值；也没法区分「操作员刻意要穿透」和「旧模板留下的 true」。换个新键名，旧文件里的旧键自然失效，现场不动配置文件就回到「不穿透」。
|
||
- **升级后第一次启动**，如果配置文件里还留着旧键，Console 会在 `logs\console.log` 里记一条**中文警告（只记一次，不随大屏重排重复刷）**，原文是：
|
||
|
||
> 警告：配置项 display.ignoreMouse 已废弃、不再生效：本机配置文件里写的 ignoreMouse: true 会被忽略。大屏窗口现在默认「不穿透」，点击不会再漏到大屏后面的窗口或桌面；要让大屏恢复点击穿透，请改用 display.allowClickThrough: true
|
||
|
||
（`ignoreMouse` 后面跟的值会原样照抄你配置文件里写的内容。）**旧键的值一律忽略，也不会被自动改写进你的配置文件。**
|
||
- **确实需要穿透**（把大屏当纯展示层、同一块屏上还要操作别的窗口）才显式写 `display.allowClickThrough: true`，代价是：点击会漏到大屏后面的窗口 / 桌面（误触会点到别的东西），大屏也点不活。
|
||
|
||
### ② kiosk 窗口现在压得住任务栏
|
||
|
||
- **以前**：先 `setKiosk(true)` 再 `setBounds(...)`，在 Windows 上会把窗口从真正的全屏态拽回「恰好铺满该屏的无边框窗口」——它不是置顶层，**任务栏与任何拖到这块屏上的窗口都能盖在它上面**；再叠加上一条的穿透，大屏被盖住后还点不活。
|
||
- **现在**：多屏 kiosk 窗口固定置顶在 **`screen-saver` 层级**（Windows 上 `setAlwaysOnTop(true)` 的默认层级 `floating` 仍画在任务栏**下面**，只有 pop-up-menu 及以上才压得住任务栏）。效果：**任务栏盖不住它，别的窗口拖到这块屏上也盖不住它，被盖住后点一下就能回到最前**。
|
||
- 调用顺序固定为「**先 `setBounds` 定位 → 再 `setKiosk(true)` → 最后 `setAlwaysOnTop(true, 'screen-saver')`**」，并加了「已经是对的状态就直接返回」的守卫，避免重排时反复进出 kiosk 导致大屏白闪。窗口化（单屏调试态）会把置顶摘掉。
|
||
|
||
### ③ 大屏控制页新增「局域网大屏」卡片
|
||
|
||
- 卡片列出主机在局域网里**可用的地址**，拼成完整链接（形如 `http://192.168.1.5:19540/display`）：链接可点开，旁边有**复制**按钮（复制成功短暂显示「已复制」），**第一个地址还带二维码**，手机扫码即可打开；
|
||
- 地址与端口由服务端 `GET /api/system/network` 下发（真实监听端口与路径，不是写死的），按现场最可能用到的顺序排（`192.168.*` → `10.*` → `172.16–31.*` → 其它）；
|
||
- 没有可用地址时显示「未检测到局域网地址（可能是没插网线 / 只有回环）。」——这不是故障，表示主机当前没有别的设备能连上的地址；
|
||
- 这张卡片**需要录入员（recorder）及以上**登录才看得到，只读访客会被提前拦住。
|
||
|
||
### ④ 没有数据迁移
|
||
|
||
- 本版**没有任何数据库迁移**，也没有设置项迁移；旧赛事项目包照常导入、切换、导出，已有榜单数字与升级前一致。
|
||
- 配置文件里那份旧键我们**不会**替你删改（现场那份原样留着，人自己决定），它只是不再生效。
|
||
|
||
### ⑤ 升级后 3 分钟核对
|
||
|
||
1. 启动 Console，打开 `logs\console.log`：确认没有意外的报错；
|
||
2. 看多屏大屏：窗口应当压住任务栏、点一下能回到最前，且**点击不会再点到桌面或后面的窗口**（即不穿透）；
|
||
3. 若有老机器配置文件里写着 `ignoreMouse: true`，日志里应能看到上面那条「已废弃」警告——这是正常的，行为已是「不穿透」；
|
||
4. （可选）确实要穿透的机器：在 `%LOCALAPPDATA%\ScoreboardConsole\console\config.json` 里写 `"allowClickThrough": true`，重启 Console；
|
||
5. 用录入员及以上账号进「大屏控制」页，确认右侧有「局域网大屏」卡片，点「复制」能复制链接、手机能扫第一个地址的二维码打开大屏；
|
||
6. 用《上线检查清单》过一遍。
|
||
|
||
### ⑥ 详细说明在哪
|
||
|
||
| 想了解 | 看 |
|
||
| --- | --- |
|
||
| 多屏 kiosk 的鼠标 / 置顶行为 | 《部署指南》6.2 配置表、7.4 |
|
||
| 「局域网大屏」卡片怎么用 | 《使用手册》第 9 节 |
|
||
| 接口与字段 | `devdocs/05` 大屏控制与运维 |
|
||
|
||
---
|
||
|
||
## dev_0.3.0
|
||
|
||
### 一句话
|
||
|
||
**旧版赛事项目包仍可导入**：本版只有一条迁移（**0021**），只给破纪录登记表加一列可空的「理由」。升级后榜单数字应当与升级前一致；新增四个现场入口（作废 / 重新录入成绩、作废已批准的破纪录、录入历史纪录、仪表盘四张新卡片）。
|
||
|
||
### ① 迁移只有一条（0021），而且只是「加一列」
|
||
|
||
- 迁移 **`0021_record_breaks_note.sql`**：给 `record_breaks` 表加一列 **`note`**（TEXT，**可空**，默认 NULL）——记「这条破纪录登记为什么被驳回 / 作废」。
|
||
- 它**只加列**：不重建表、不改任何既有数据行；老登记的 `note` 保持 `NULL`（「本来就没有理由」是事实，不会被写成一条假理由）。
|
||
- ✅ **旧版赛事项目包仍可导入**。导入一个不含 `note` 列的旧包后，它**成为当前赛事时（切换过去、服务端启动打开赛事库时）会自动补跑迁移**，**不需要任何手工处理**；旧的破纪录登记、纪录库、成绩与积分一行不丢。
|
||
- 备份同理：升级前的备份文件（旧 `event.db`）照常能恢复，恢复后再打开时也会自动补迁移。
|
||
|
||
### ② 四个新入口
|
||
|
||
| 入口 | 位置 | 做什么 |
|
||
| --- | --- | --- |
|
||
| **作废本条 / 重新录入** | 成绩录入页每行的「操作」列 | 手滑填错了不必整组撤销发布：已发布的行仍然是锁的，但可以点「作废本条」（**必填原因**）让这一条退出名次与积分；已作废的行显示红徽标「已作废」，点「重新录入」（必填原因）退回草稿，改完再发布本组。两者都**立即重算并推大屏**，不受「分批发布时实时更新榜单」这个延迟结算开关影响 |
|
||
| **已批准的破纪录 / 作废** | 破纪录页新增的「已批准的破纪录」卡片 | 批错的破纪录可以撤回：点「作废」（**必填原因**）→ 撤回该笔加分、重算推榜，并把该级别的当前纪录**恢复为上一条** |
|
||
| **新增历史纪录 / 删除** | 破纪录页「纪录库」卡片 | 赛前手工登记历史纪录（小项 / 级别 / 成绩值或文本 / 保持人 / 保持单位 / 创造日期）；每行可「删除」，删的是当前纪录时会恢复上一条。**「来源」列现在真的会显示「历史」或「本届」**（以前没有历史录入入口，实际只会是「本届」） |
|
||
| **仪表盘四张新卡片** | 仪表盘 | 今天的小项（按排期 + 进度）、草稿待发布、待确认破纪录、大屏在线数；旧卡片保留 |
|
||
|
||
### ③ 「拒绝」从内存改持久带来的行为变化
|
||
|
||
- 以前点「拒绝」只在**本机浏览器里**把这条疑似破纪录藏起来，刷新就回来。现在改成**先登记再驳回**：服务端会登记一条破纪录记录并立即驳回（理由写「现场判定不是破纪录」），**刷新后不再出现**；谁在什么时候否掉了哪一条，也能在审计日志里查到。
|
||
- ⚠️ **升级前在本机「拒绝」过的疑似破纪录，升级后刷新会重新出现一次**——因为那次拒绝从来没有写到服务端。重新点一次「拒绝」即可（这次会落到服务端）。
|
||
- 只有真的写不进去时（示例数据模式 / 未连接服务端）才退回本机隐藏，提示会如实说明「刷新页面后该条会重新出现」。
|
||
|
||
### ④ 升级后 5 分钟核对
|
||
|
||
1. 打开一次「成绩录入」页，确认表格最后一列是「操作」；
|
||
2. 打开「破纪录」页，确认多出「已批准的破纪录」卡片，且「纪录库」卡片有「新增历史纪录」按钮与每行的「删除」；
|
||
3. 打开仪表盘，确认多出今天的小项 / 草稿待发布 / 待确认破纪录 / 大屏在线数四张卡片；
|
||
4. 旧赛事包核对：导入一个**升级前导出的赛事项目包**并切换为当前赛事，确认能正常打开、破纪录与纪录库数据都在（迁移 0021 会自动补跑）；
|
||
5. 用《上线检查清单》过一遍。
|
||
|
||
### ⑤ 详细说明在哪
|
||
|
||
| 想了解 | 看 |
|
||
| --- | --- |
|
||
| 手滑填错一条成绩怎么改 | 《使用手册》4.10；《常见问题》Q98 |
|
||
| 破纪录批错了 / 怎么拒绝 | 《使用手册》6.1；《常见问题》Q99 |
|
||
| 历史纪录怎么录 | 《使用手册》6.2；《常见问题》Q100 |
|
||
| 仪表盘四张卡片 | 《使用手册》第 3 节；开发侧 `devdocs/07` §7 |
|
||
|
||
---
|
||
|
||
## dev_0.2.0
|
||
|
||
### 一句话
|
||
|
||
**没有需要迁移的数据**：这一版是 100 多项缺陷与体验修复的合集（含一次改名、几处口径收紧）。升级后榜单数字应当与升级前一致。
|
||
|
||
### ① 三件升级前必须知道的事
|
||
|
||
**1）「团体奖牌榜」改名为「单位奖牌榜」**，导出件也跟着改了名：
|
||
- 界面上：大屏控制页的切页下拉、大屏奖牌榜页标题、管理端「积分榜」页的页签，都叫 **单位奖牌榜**；
|
||
- 导出件：下载文件名由 `团体奖牌明细.xlsx` 改为 **`单位奖牌明细.xlsx`**，Excel 里的工作表名同步改为 **`单位奖牌榜`** / **`单位奖牌明细`**。
|
||
→ **如果你把旧文件名写进了对账脚本、打印模板或交接文档，记得改**。
|
||
- **旧名仍然可用**：老链接（`?page=团体奖牌榜`）与老配置（`display.pages` 里写 `medals` 或旧名）照常生效，不用改。
|
||
|
||
**2）审计日志的动作前缀统一了**（`entries.import` → `entry.import`，`entries.import.resolve` → `entry.import.resolve`）：
|
||
- **升级前落库的历史记录不会跟着改**——它们仍写着旧前缀。所以**查历史时请用子串 `import` 筛**（新旧都能筛到）；用 `entry.` 只能筛到升级之后的记录。审计是只追加的，我们不会改写历史。
|
||
|
||
**3）密码长度改成按「字符」数**（原来是按字节）：
|
||
- 下限仍是 8 **位**，但现在按字符算：**7 个汉字（原来 21 字节能过）现在会被拒**；`3 个汉字 + 5 个字母`（8 字符）正常通过。
|
||
- 上限仍是 72 字节（bcrypt 的边界），文案里会分别写清「位」与「字节」。
|
||
|
||
### ② 现场会看到的变化
|
||
|
||
- **导出件里的「未结算」**：开了延迟结算时，「已发布但那一组还没结算」的行，导出的「分项成绩表 / 全部 / 全部（单页）」现在写 **名次 `—` / 积分 `—` / 状态 `未结算`**（成绩照常打印）。原来这三列是「空名次 + 0 分 + 有效」，读起来像「算出来就是 0 分」。
|
||
- **基础数据包导入遇到「已彻底删除的单位」**：那一行**整行跳过**并在导入结果里说明原因（不再更新它的字段、也不会把它翻出来）；要让单位回来，先到「基础数据 → 参赛单位」勾选「显示已彻底删除的单位」再点「恢复」。
|
||
- **报名名单导入换了单位会明确提示**：「第 N 行：某某 换了单位，原单位 A 在本组别的报名已移出，已改在单位 B 加入」——数据行为没变（一直是这样），现在会说出来了。
|
||
- **「从已有名单勾选报名」有冲突时不再报「已加入」**：会明确提示「有 N 行没有加入，需要逐条确认」，并在页内列出是哪几行。
|
||
- **导出核对更省事**：单位积分明细的「成绩」列与分项成绩表、个人明细**逐字一致**（原来少个单位，如 `11.58` vs `11.58 秒`）；空单位的「单位积分明细」也会打印末行「合计」。
|
||
- **收不到回执的危险操作不再误导**：一键恢复请求超时/断连时，提示由「恢复未执行」改为「**没收到回执，恢复可能已经生效**」，并单独放宽了超时时间；两个管理员同时点恢复时，第二个会拿到「正在恢复，请稍后」。
|
||
|
||
### ③ 部署相关的两处
|
||
|
||
- **赛事包上传上限是 512MB**（名单 CSV 与基础数据包那一档仍是 32MB，赛事包刻意放宽——它要装字体、背景图、各单位 logo；字体单个就允许 20MB）。超限会提示「解析上传失败」。
|
||
- **反向代理（nginx 等）**：若以前遇到「登录一定 403」，本版起错误提示会指明原因与修法；正解是让代理透传原 Host（`proxy_set_header Host $host;`），或配置可信代理并把原 Host 透传在 `X-Forwarded-Host` 上。**不要**为了绕过它把校验放宽——那等于开登录 CSRF 的口子。
|
||
- 顺带：**丢了 CSRF Cookie 不再等于「能看不能写」**——管理面板会自动补发，症状消失后无需再刷新页面。
|
||
|
||
### ④ 升级后 5 分钟核对
|
||
|
||
1. 打开服务管理窗口的运行日志：**这一次升级没有那条「通道名次自愈」记录是正常的**（本版没有新迁移，不需要重算）；若看到它，说明你从上上版直接跳过来，等它跑完即可；
|
||
2. 刷新积分大屏与管理面板：**单位总分榜、单位奖牌榜、个人积分榜的数字与升级前一致**；
|
||
3. 随便挑一个小项导出一次「分项成绩表」，确认表头与列都对；
|
||
4. 用《上线检查清单》过一遍。
|
||
|
||
### ⑤ 详细说明在哪
|
||
|
||
| 想了解 | 看 |
|
||
| --- | --- |
|
||
| 榜名/导出文件名的变化 | 本文件 ①；《使用手册》8.2、11.1 |
|
||
| 导出里三种「还没出结果」的行 | 《使用手册》11.1；《常见问题》Q90 |
|
||
| 基础数据包遇到已删除的单位 | 《使用手册》11.4；《常见问题》Q88 |
|
||
| 恢复与安全副本保留份数 | 《部署指南》8.3；《常见问题》Q40 |
|
||
| 反代/登录 403 | 《部署指南》7.x 与应用内提示 |
|
||
|
||
---
|
||
|
||
## dev_0.1.8
|
||
|
||
### 一句话
|
||
|
||
修掉了一个**会多算单位总分**的计分缺陷；奖牌改成可以按小项、按通道开关；报名名单认人改成**以证件号为准**。
|
||
|
||
### ① 升级后必须补的一件事（本版唯一需要人工补录的地方）
|
||
|
||
**「团体引体向上」这类「个人+团体」项目的团体名次，要到成绩录入页补录一遍。**
|
||
|
||
原因是旧版**没有录团体名次的地方**：这类项目的团体分是拿**个人名次顶替**着算出来的（所以会算多）。本版改成从「团体名次」区块读，**没录就是 0 分**。
|
||
|
||
- 补录位置：**成绩录入**页 → 选中该小项与组别 → 表格下方 **「团体名次」** 卡片 → 按单位填名次 → **保存团体名次**（留空 = 清空该单位；名次允许并列；个人名次不受影响）。
|
||
- 如果某单位不参加该项，留空即可。
|
||
- **不想手填的替代方案**：把该小项的团体通道从「手动名次」改成「按队内平均」（**基础数据 → 计分通道**），系统会按每队成员成绩自动算团体名次。
|
||
**两种口径二选一，由赛会规则决定**——「团体引体向上」这条现在还挂着旧模板（手动名次），要按领导定的口径确认一次。
|
||
|
||
### ② 分数会变，这是对的（不是坏了）
|
||
|
||
- **单位总分**：旧版在「个人+团体」项目上会把**个人**名次当成**团体**名次、按团体表再发一次分。实测某队在成绩没改的情况下，第一次发布 45 分、再点一次发布变 85 分。
|
||
本版已修正：**同一份数据无论发布几次，结果完全一致**。
|
||
- 所以升级后如果你之前录过并发布过这类项目，**单位总分会出现变化**（变小是正常的，那是修正后的值）。按 ① 把团体名次补录完，再核对一次即可。
|
||
- **个人积分不受影响**（个人通道的算法没变）；奖牌数可能变化（见 ③）。
|
||
|
||
### ③ 现场会看到的新东西
|
||
|
||
**奖牌可以开关了**（三层，从粗到细）：
|
||
|
||
1. 小项级：**基础数据 → 大项 / 小项 → 编辑小项**，「选项」里有 **「该项启用奖牌结算」**（**默认勾上**）。取消 = 这个小项只出积分、一块牌都不发；
|
||
2. 通道级：**基础数据 → 计分通道**，表里多了 **「奖牌通道」**列，两个开关——**「发奖牌」**（这条通道的名次发不发牌）与 **「个人奖牌并入单位金牌榜」**（个人项目拿的牌算不算进单位金牌总数）；
|
||
3. 名次仍然只发给**前三名**（并列口径不变）。
|
||
|
||
> ⚠️ 迁移默认把三个开关都设成**开**，也就是和升级前一致，不会让既有小项突然掉牌。要改哪个小项，按赛事规则逐个去关。
|
||
|
||
**成绩录入页多了「团体名次」卡片**——只在配了「团体名次 = 手动名次」通道的小项上出现；纯团体项目（篮球等）和「按队内平均」的项目不会出现，那是正常的。
|
||
|
||
**报名名单认人改成以证件号为准**：匹配顺序 **证件号 → 号码布 → 姓名 + 单位**。同一份表里同一证件号出现多次 = 同一个人报多个组别（会给提示，不再报错）；只有「同证件号 + 同一个小项同一个组别」才会进冲突面板问你保留哪一条。
|
||
|
||
**下面这些动作现在会立刻重算并刷新大屏，即使管理员开了「延迟结算」**：
|
||
撤销发布 / 作废单条成绩 / 批量退赛·恢复·移出报名 / **报名名单导入改了状态**（例如把某人改成退赛）。
|
||
「延迟结算」只影响**发布成绩**这一件事（不因一批成绩跳动榜单），不会让退赛、作废这类「谁还算数」的改动被拖着。
|
||
|
||
### ④ 其它修复
|
||
|
||
- 管理员**撤销会话 / 停用账号 / 改密码**后，那台机器上还开着的实时连接会立刻断开，不再继续收数据；
|
||
- 访客（guest）身份收不到系统配置类的实时推送；
|
||
- 导出一份不存在的小项 / 单位、手填名次填 0 或负数、性别或年龄填了非法值 → 现在是**明确的错误提示**，不再是「服务端异常」；
|
||
- **示例数据模式**（后端连不上时的演示模式）下，批量停用 / 批量或单条彻底删除会被拦下并提示，不会假成功；
|
||
- **服务管理窗口**：显示器短暂只剩一块（拔线 / 电视待机）之后，再把扩展屏插回来会**自动恢复全屏**，不用重启程序；
|
||
- **自定义大屏模板**：嵌套过深或体积过大的模板会给出明确提示，不会让大屏白屏。
|
||
|
||
### ⑤ 升级后 5 分钟核对
|
||
|
||
1. 打开服务管理窗口的**运行日志**，看有没有那两行自愈记录（`检测到通道名次为空但已有已发布成绩…` / `一次性全量重算完成…`），**这是正常的**；
|
||
2. 刷新积分大屏 / 管理面板：**奖牌榜不是全 0**；
|
||
3. **单位总分与升级前一致**（除了 ② 说的「个人+团体」项目）；
|
||
4. 打开一次成绩录入页，确认该录团体名次的小项上有**「团体名次」**卡片；
|
||
5. 打开一次**基础数据 → 大项 / 小项**，确认「该项启用奖牌结算」是按赛事规则勾的；
|
||
6. 用《上线检查清单》从头过一遍。
|
||
|
||
### ⑥ 详细说明在哪
|
||
|
||
| 想了解 | 看 |
|
||
| --- | --- |
|
||
| 奖牌开关怎么用 / 什么时候关 | 《使用手册》10.2（小项）、10.4（计分通道） |
|
||
| 奖牌榜没牌 / 金牌数不对怎么查 | 《常见问题》Q94 |
|
||
| 团体名次怎么录 / 为什么没有那一块 | 《使用手册》4.9、《常见问题》Q95 |
|
||
| 升级后奖牌榜是空的 | 《部署指南》3.4、《常见问题》Q96 |
|
||
| 名单导入怎么认人、怎么填 | 《报名名单导入规范》 |
|
||
| 延迟结算下哪些动作会立刻生效 | 《使用手册》4.8、《常见问题》Q91 |
|
||
| 历史成绩版本重放与团体名次 | 《常见问题》Q97（已知限制） |
|
||
|
||
---
|
||
|
||
## dev_0.1.7 及更早
|
||
|
||
本文件从 **dev_0.1.8** 起维护；更早版本的改动不再逐版补记。若需要，可在《使用手册》与当时的发布记录里查。
|