feat(publish): 「以决赛成绩发布」开关 —— 非决赛发布只更新名次、不计分；版本 dev_0.5.8

## 需求（主人原话）
> 只有在最后一轮(决赛)的成绩才算分，你给发布按钮边上带一个选项，勾选之后**当前小项/组以决赛成绩发布**，
> 不然的话就**只更新名次(非决赛) 不加分**。

**设计好处**：不引入「轮次」模型，而是**在已有的「发布」动作上加一个口径** —— 分轮次比赛时，同一批人各轮成绩各发各的，
榜单只认决赛那一轮的分。引擎本来就有一条「只排名不计分」的通路，这次是**把它在发布入口露出来**，没有另造算分分支。

## 契约
`POST /api/results/publish` 请求体新增 **`rankOnly: boolean`**：
- **缺省 / `false`** = 计分发布，**与改动前逐字节一致**（老客户端不带这个字段走现状路径）；
- **`true`** = 本次只更新名次。

**只更新名次时写**：`results.state/verified_by/verified_at`（照旧）、`results.rank`（预赛排名次是刚需）、
整小项录完时的 `events.status`、`result_revisions`（message 写明本次口径）、`change_log(entity=result)`（大屏据此重拉名次）。
**不写**：`score_ledger`（**既不加，也不作废任何已有流水**）、`channel_ranks`（不重建也不删除）、榜单快照版本。

⇒ 于是会出现预期的「**名次变了、分还是旧的**」（本组上次按决赛发布过时）—— 确认框与录入页常驻提示都点名说了这件事。

## 界面
- 录入页「发布」按钮**左边**：勾选框「**以决赛成绩发布（勾选才计分发牌）**」，**默认不勾**；
  旁边徽标随状态切「**只更新名次（不计分）**」（警示色）/「**计分发布（算分发牌）**」（绿色）。
- 确认框：标题切「确认按决赛成绩发布该组？」/「确认发布该组（只更新名次）？」；不勾时不再报「影响 N 个单位、最大分差 X 分」；
  已有在榜分时加一句「本组已有 X 分在榜…那份积分与奖牌会原样保留、不随名次变动」。
- **常驻「在榜口径」提示**：系统不记「上次勾了什么」，判据用**榜面事实**（已发布成绩的流水合计）——
  「本组在榜上只有名次（上次是按只更新名次发布的）」/「本组在榜上是已计分的成绩（已有 X 分来自上一次按决赛发布）」。
- **发布成功后勾选复位**：勾选是「这一次发布」的口径，不是页面设置（免得换小项时把预赛当决赛算分）。
- ⚠️ **审核页是第二个发布入口**，同样加了口径 —— 否则从审核页发布预赛会被**悄悄算成分**。

## 兼容性（回答「能不能兼容现有数据包」）
- **没有任何数据库变更、没有迁移**：纯行为改动，多带一个请求字段。
- 旧客户端 / 旧数据包 / 旧库照旧工作；不带该字段时与改动前**逐字节一致**（用改动前采集的整份写库 golden 对拍证明）。
- 反向（用新版导出的项目包去旧版本导入）仍是不支持的，与之前几版一致。

## 验证
- **先红后绿**：改动前跑新用例，红在「只更新名次的发布动了已有流水」（贴出 `score_ledger` 前后对比）；
- 另有 `rank_only_heal_test.go` 钉住「只更新名次发布过的库，**启动自愈不许把它算成分**」；
- 全量自检两轮**全绿、`EXIT=0`**：服务端 14 包 / 前端 **944 例** 0 fail / Console 68 例 0 fail。

## 文档
`docs/升级说明.md` 新增 `dev_0.5.8` 一节。

## 版本
`dev_0.5.7` → **`dev_0.5.8`**（无数据迁移）；安装器素材同步重生成（照例只动 `brand.bmp` 两张）。

docs/升级说明.md

@@ -6,7 +6,46 @@
 
 ---
 
-## dev_0.5.7（当前版本）
+## dev_0.5.8（当前版本）
+
+### 一句话
+
+**没有数据迁移，升级后不用重配任何东西**：给「发布」加了一个**口径开关** —— 分轮次比赛（预赛 / 复赛 / 决赛）时，**只有决赛那次发布才计分发牌**；预赛发布**只更新名次、不计分**。这样同一个项目的多轮成绩可以各发各的，而榜单上只认最后那一轮的分。
+
+### ① 新增：「以决赛成绩发布」开关
+
+- **位置**：成绩录入页（以及**成绩审核页**）的「发布」按钮旁边，一个勾选框：**「以决赛成绩发布（勾选才计分发牌）」**，**默认不勾**。旁边有一个小徽标随时告诉你当前是哪种口径：**只更新名次（不计分）** / **计分发布（算分发牌）**。
+- **不勾（默认）**：这次发布**只更新名次** —— 名次会照常算出来、写进系统（预赛也要排名次），但**不产生积分、不发奖牌**。
+- **勾上**：与升级前**完全一样** —— 算分、发牌、上榜。
+- **勾选是"这一次发布"的口径，不是页面设置**：发完自动复位（免得您换到别的小项时，把预赛当成决赛算分）。
+- ⚠️ **不勾时不会动已有的分**：如果这个小项之前已经**按决赛发布过**（榜上已有分），现在再用「只更新名次」发一次（比如改个名次），那份积分与奖牌会**原样保留、不随名次变动**。界面上会明确提示这一点（见下）。
+
+### ② 界面会告诉你「这一组现在在榜上是什么」
+
+发过一次之后，录入页会常驻显示一行**在榜口径**：
+
+- 「**本组在榜上只有名次**（上次是按只更新名次发布的）」——还没有分；
+- 「**本组在榜上是已计分的成绩**（已有 X 分来自上一次按决赛发布）」——分已经在榜上。
+
+文案说得比代码准：系统不记「上次勾了什么」，它看的是**榜面上有没有分**这个事实。
+
+**确认框里也会写清这次会发生什么**：勾选时标题是「确认按决赛成绩发布该组？」，不勾时是「确认发布该组（只更新名次）？」；不勾时不会再报「影响 N 个单位、最大分差 X 分」（那是计分才有的效果），而已有在榜分时会加一句提醒。
+
+### ③ 两条使用上的提醒
+
+1. **两个发布入口都有这个开关**：成绩录入页与成绩审核页 —— 从哪一页发布口径都一样（否则从审核页发布预赛会被悄悄算成分）。
+2. **只在"分轮次"的项目上用**：一次就比完的项目照旧**勾上**发布（与以前一样），别漏勾 —— 漏勾的话名次会更新，但**不会计分**，榜上不会有这一项的分（界面上有徽标和在榜口径提示，发布前看一眼就不会错）。
+
+### ④ 升级后 5 分钟核对
+
+1. 打开一个**已经发布过成绩**的小项，看发布按钮旁边的徽标与那行「在榜口径」提示是否说得对（有分的应显示「已计分的成绩」）；
+2. 找一个可以试的项目：不勾选发布一次，确认**名次更新了、分数没动**；
+3. 再勾选发布一次，确认**分数按决赛口径正常算出来**；
+4. 其余照旧：**不需要重新导入规则包，也不需要重配任何东西**。
+
+---
+
+## dev_0.5.7
 
 ### 一句话