Scoreboard/docs/升级说明.md

升级说明

按版本倒序，最新在最上面。 每次升级前先看「要升到的那一版」这一节，照着做完再开赛。 数据、配置、规则包都在用户数据目录（%LOCALAPPDATA%\ScoreboardConsole\），覆盖安装不会丢，见《部署指南》3.4 / 3.5。 常规升级流程（停服务 → 覆盖安装 → 启动 → 核对）见《部署指南》3.1 / 3.4。

---

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 起维护；更早版本的改动不再逐版补记。若需要，可在《使用手册》与当时的发布记录里查。