feat(0.5.1): 业务逻辑审查 9 条 P0 全修 + 自绘安装器 + 现场反馈四项

## 算分正确性（6 份只读审查 → 收敛成 5 个病根，均先复现失败再修）
- 「人工名次」与「自动名次回写」互斥：原来同一份成绩**发布两次分数不同**
  （团体报名项 dual 通道 10/8/6 → 25/18/14），现在连发多次逐字节一致
- 删小项时在同一事务作废旧流水并推榜：原来分数**永久残留**在总榜、任何重算都打不到
- 规则包导入整体事务化：原来中途失败会清空名次表且补不回（奖牌全丢）；
  另加守卫「compare=none 的小项不得配 basis=result/aggregate」
- 末位归零只抹真正落在末位的那一档：原来跨末位的并列组会被整组抹 0
  （7 人三人并列第 5 时第 5、6 名的分也一起没了）
- 模板「分值表档位超出录取名次」现在拒绝保存：原来静默截断成 0 分

## 现场反馈（主人实测报的）
- 已发布成绩可改：行内「修改本条」+ 成绩格/状态格可点（退回草稿→改→重新发布本组），
  与「作废」语义分开；取消路径不产生任何副作用
- 单位积分明细补「运动员 / 来源」列，并显示「已修订 ×N（时间·原因）」：
  管理端、大屏覆盖层、xlsx 备注列三处同源
- 单位奖牌榜改为按奖牌独立排名（金→银→铜→单位编码），与积分榜解耦
- 历史孤儿积分流水清理（迁移 0022，只动 result/record_bonus，人工调整分不受影响）

## 新功能
- 团体项目聚合口径二选一：平均（默认）/ 总和（迁移 0023，通道编辑器可切）

## 安装器
- 自绘五页安装界面：无边框、自绘标题栏、DPI 自适应（4K@200% 实测）、
  安装/卸载逻辑复用 electron-builder 宏不变；默认「为所有用户安装」并自动放行防火墙 19540
- 构建期校验：安装器素材里的版本号必须与 VERSION 一致，否则构建失败

自检：服务端 14 包 ×2 / 前端 vue-tsc + build + 742 例 ×2 / Console 20 文件 + 68 例 ×2，全绿。
端到端对拍：修前 vs 修后，纯团体 / 双计 / 普通个人三形态**逐字节一致**，仅出 bug 的双通道形态按要求改变。

docs/升级说明.md

@@ -6,7 +6,94 @@
 
 ---
 
-## dev_0.5.0（当前版本）
+## dev_0.5.1（当前版本）
+
+### 一句话
+
+**两条数据迁移、三处计分口径变化、安装器换新，升级后建议重新导入一次新版规则包**：迁移 `0022` 把「小项已被删除、积分流水却还挂在榜上」的历史脏数据一次性作废（**只影响分数，不影响名次与奖牌，人工调整分不受影响**）；迁移 `0023` 给计分通道加一列「聚合口径」（默认「平均」，不切就与升级前一样）；**单位奖牌榜改为按奖牌数独立排名，可能与积分榜顺序不同**；安装界面全面重做（**安装逻辑不变**）。
+
+### ① 数据迁移：两条（0022 / 0023）
+
+**`0022` —— 历史孤儿积分流水一次性作废**（现场可能少几分，那是升级前就该清掉的分）
+
+- **它清理什么**：升级前删掉一个「只按单位录名次、没有报名行」的小项时，它名下**已经产生**的积分流水会留在库里、并且没有被作废——分数继续算在单位总分里，但这个小项已经不存在，此后任何一次重算都再也碰不到这些流水（只能改库才能清）。
+- **只作废「成绩流水」与「破纪录加分」**：这两类流水一定挂着小项，空小项 = 小项已被删除。**人工调整分不受影响**——人工调整本来就可以不挂小项，是合法的，不会被误清。
+- **影响面**：**只影响分数**。这些流水本来就没有名次、也没有奖牌，所以**名次与奖牌一件不变**；作废后这些分在**单位总分与单位积分明细里一起消失**（不会出现「榜上无分、明细有分」）。它是**作废不是删除**：流水行与作废时间都留着，并注明是升级时清理的历史数据，事后查得到。
+- **怎么确认**：启动一次 Console，在运行日志或 `logs\operations\` 当天文件里能看到迁移记录（`已应用迁移 … name=0022_void_historical_orphan_ledger.sql`）。**现场确认删过「带分的小项」的机器上，相应单位的总分会少一点**——那是清掉了历史脏数据，不是这次升级算错了。
+- **想核对到条**：升级前先导出一次单位积分明细存底（「积分榜」页的「导出该单位明细」或「导出总明细」），升级后再导一次对比，就能看出少了哪几条。
+
+**`0023` —— 计分通道新增一列「聚合口径」**（只加列、不动既有数据）
+
+- 老通道一律取默认**「平均」**（团体成绩 = 该单位成员成绩的平均值），**升级前后榜单一分不差**；想改成「总和」的，到「基础数据 → 计分通道」手工切（见《使用手册》10.4）。
+
+### ② 三处口径变化（现场看到的数字 / 顺序可能不同）
+
+**1）「末位归零」：末位不再丢分**
+
+- 本版随包规则包里两个模板的「末位归零」都设成**关**：**参赛人数少于表里档位数时，最后一名按表拿分**（例：3 人参赛、模板有 6 档，第 3 名按表拿 6 分），不再被抹成 0。重新导入规则包会把库里这个开关一起写成「关」——**此前在模板页手工勾过它、或导入过把它勾上的规则包**的机器，这一步之后末位分数会变（这是定稿口径：规则里没配的名次分数就是 0 分，分只按表发）。
+- 另外，**开关打开时也只抹「真正落在最末那一档」的那一条**：并列档位从更靠前的名次起步、区间跨过末位的并列组**不再被整组抹 0**，按他们并列到的名次照表拿分（7 人里三人并列第 5、前六档表 → 每人按第 5 名拿分；升级前是 0 分）。
+- **名次与奖牌不受影响**：这一段改的只是「这一组拿多少分」。
+
+**2）单位奖牌榜改为按奖牌数独立排名**
+
+- 顺序与名次：**金牌 → 银牌 → 铜牌 → 单位编码**，**不再跟着单位总分榜**。所以「金牌多、总分低」的单位在奖牌榜上排前面、在单位总分榜上排后面——**这是口径不同，不是数据错了**（升级前奖牌榜沿用总分榜顺序，会出现「金牌多的排在后面」）。
+- 三处同一个口径：管理端「积分榜 → 单位奖牌榜」、大屏的单位奖牌榜页、大屏底栏滚动的奖牌 Top3。
+- 「导出奖牌明细」（`单位奖牌明细.xlsx`）逐枚列出奖牌的总表不受影响；各单位**分表的先后仍按单位总分排**（得分高的在前），与奖牌榜的顺序不同，这不是错。
+
+**3）同分并列段的排列按规则包的排序口径**
+
+- 总积分榜（及个人积分榜）里**总分相同**的单位那一段内，先后按规则包里的排序口径排——本赛会包的默认是 **总分 → 金 → 银 → 铜 → 单位编码**。
+- 重新导入规则包会把这条口径按规则包的值写回库里（本赛会包是 **总分 → 金 → 银 → 铜 → 单位编码**）：**此前导入过排序口径写法不同的规则包**的机器，这一段里单位的先后可能变化——**变的是顺序，分数与奖牌都不变**，看到顺序变了不要当成故障。
+- **单位奖牌榜不受这条影响**：它固定按金 → 银 → 铜 → 单位编码（见上面第 2 条）。
+
+### ③ 安装器换新（界面重做，安装逻辑不变）
+
+- 安装程序（`Scoreboard Console-<版本>-x64.exe`）**界面全面重做**：欢迎 / 目录 / 许可 / 进度 / 完成各页与按钮换成新素材，并**支持 4K 高 DPI**（系统缩放到 200% 时界面按缩放后的尺寸排布，字与按钮不会糊成一团）。
+- **安装逻辑一个字没改**：装到哪、装什么、桌面快捷方式（「赛事积分榜」）、卸载方式、覆盖安装时先静默跑一遍旧卸载器、数据与配置在 `%LOCALAPPDATA%\ScoreboardConsole\`（**覆盖安装不会丢**）——全部与升级前一致。
+- 默认安装模式是**「为所有用户安装」**（装到 Program Files，安装时提一次权）；**这台机器上次装过时，向导沿用上次的装法**，静默安装也可以用 `/allusers` / `/currentuser` 指定。这一趟**仍然自动放行防火墙入站 19540**（在防火墙里能看到规则 `Scoreboard Console (TCP 19540)`），局域网大屏不用再手工放行；选「仅为我安装」的机器要手工放行（命令见《部署指南》7.5）。
+
+### ④ 升级后建议：把新版规则包重新导入一次
+
+**做法**：管理端「导出 → 规则包 → 选择 YAML → **预览差异** → 确认导入并全量重算」，导入随本次发布的新版规则包。
+
+**为什么建议做**：旧包缺少本次修正的通道配置（几个双计项目的团体通道口径、纯团体项目该走「按成绩自动排名」还是「人工名次」等），**不重新导入就不会生效**。
+
+⚠️ **动手前先看清这个前提**：**导入会按规则包重写各小项的计分通道配置**——规则包覆盖到的小项，库里现有的通道会被整包替换。所以：
+
+- **建议先导入、再按需要手工微调个别项目**；顺序反过来（先微调再导入），手工改动会被这次导入覆盖掉；
+- 导入前先看「预览差异」里列出的通道增删改，确认没有把现场专门配过的项目改掉；发现被改，导入后到「基础数据 → 计分通道」改回来即可（保存后该小项会重算）；
+- 导入会**全量重算积分并刷新榜单**，尽量安排在**没有正在进行的项目**时做；
+- 导入后正是上面那三处口径变化的生效点，请对着 ② 逐条看一遍榜单。
+
+### ⑤ 升级时可能遇到的拦截（这两处以前会静默通过）
+
+- **导入规则包时**：如果这份规则包存在**配置冲突**——典型情形是某个小项的**名次是靠人工录入的**（例如球类、拔河这类由裁判判名次的项目），规则包却给它配了**「按成绩自动排名」**（或「按队内平均」）的通道——导入会被**整包拒收**，一个字节都不写，并直接说明**是哪个小项、为什么不行、怎么改**（给这个小项单独写一段人工名次的通道配置，或调整规则包的匹配条件别套到它身上）。升级前这种情况是「先把通道换掉、紧接着重算时才报错」，名次表会停在半空（分数还在、奖牌却清零），自愈与重试导入都会因为同一个小项再失败一次——**现在不会留下这种坏状态**。
+- **保存积分模板时**：如果**分值表里配的名次超过了「录取名次」**（例如分值表配到第 7 档、录取名次还留着 6），保存会被**拒绝**并说明怎么改：要么把录取名次改成 7、要么改成 0（0 = 不按名次封顶），要么删掉超出录取名次的那几档（例子里的第 7 档）。升级前这种配置能安静存下来，但第 7 档及以后在榜上恒为 0 分，界面上看不出任何异常——**现在会在保存这一步就说清楚**。
+
+### ⑥ 升级后 5 分钟核对
+
+1. 启动一次 Console，看运行日志 / `logs\operations\` 当天文件：应能看到 `0022` 与 `0023` 两条迁移记录，没有别的报错；
+2. 刷新管理端「积分榜」：**单位总分榜、个人积分榜的数字与升级前一致**（除了 `0022` 清掉的历史脏数据）；**单位奖牌榜的先后可能变了**（现在按金 → 银 → 铜排）；
+3. **看到「同分单位的先后变了」不要当故障**：重导规则包会把排序口径按规则包的值写回（本赛会包是 总分 → 金 → 银 → 铜 → 单位编码），**变的是顺序，分数与奖牌一件不变**（见 ② 第 3 条）；
+4. 打开「基础数据 → 计分通道」，选中一个双计项目（例如团体引体向上），确认「聚合口径」一列是**「平均」**——不切换就与升级前口径一致；
+5. 打开「成绩录入」页：已发布的行右侧应**并排**「修改本条」与「作废本条」两个按钮；点一下成绩格会弹确认框（**点「取消」什么都不做**）；
+6. 按 ④ 导入新版规则包，导入后核对该项目的计分通道与榜单；
+7. 用《上线检查清单》过一遍。
+
+### ⑦ 详细说明在哪
+
+| 想了解 | 看 |
+| --- | --- |
+| 已发布成绩怎么改（修改 / 作废的区别） | 《使用手册》4.10；《常见问题》Q98 |
+| 单位明细里的运动员 / 来源 / 已修订 | 《使用手册》8.1、8.3、17.3 |
+| 团体分的「平均 / 总和」口径 | 《使用手册》10.4；《常见问题》Q15 |
+| 单位奖牌榜为什么与积分榜顺序不同 | 《使用手册》8.2 |
+| 导入被拒 / 保存模板被拒是什么原因 | 本文件 ⑤ |
+| 迁移与安装 | 本文件 ① ③；《部署指南》3.1、7.5 |
+
+---
+
+## dev_0.5.0
 
 ### 一句话