docs: 0.5.12 用户文档同步 —— 记住上次录入的小项（改名丢按钮的真相）+ 清空本组/本批成绩

- 《使用手册》：§1 录入员权限行补「清空成绩」；4.1 新增「回到录入页会记住上次录的小项」
  （三级优先顺序 + 记忆只在本机 + 失效自动退回默认）；4.7 改为「撤销发布 / 清空成绩」，
  给出「成绩内容留不留」对照表、两颗按钮出现条件、必须勾选、权限与留痕；§18 补交叉引用
- 《升级说明》：新增「## dev_0.5.12」一节（① 修的根因不是改名 ② 新增清空本组/清空本批
  ③ 升级后 5 分钟核对 ④ 详细说明在哪）
- 《常见问题》：新增 Q102（改了小项名称后「撤销发布」按钮不见了 —— 你看到的是两个不同的小项）；
  Q8 补清空的交叉引用

无代码改动、无数据库迁移；已有成绩、榜单与导出件一字不变。

docs/升级说明.md

@@ -6,6 +6,56 @@
 
 ---
 
+## dev_0.5.12
+
+### 一句话
+
+**这不是一次「数据迁移级」的变更：没有任何一行已有数据被改动，升级后不用重配、不用重新导入规则包**，已有的成绩、名次、积分、榜单与导出件**一个字不变**。这一版做两件事：**修好**「在基础数据里改了小项的显示名称，回到成绩录入页发现**「撤销发布」按钮不见了**」——**根因不是改名**，是回到录入页时**不记得上次录的是哪个小项**（见 ①）；**新增**「**清空本组 / 清空本批**」成绩（把一组或一批成绩整个作废重来，**危险操作**，要勾选确认，见 ②）。
+
+（修的是**纯前端**的一处选择逻辑：录入页记住上次录入的小项。没有任何结构迁移、没有动过一条成绩。）
+
+### ① 修：「改了小项名称之后，撤销发布按钮消失」
+
+**先说结论：这不是改名弄坏的。** 改名那条路一直是干净的——录入页加载报名名单、读成绩、引擎算分**全都按小项的 ID 关联**，**不看名字**（这一版还补了一条「小项名 + 组别名一起改」的回归用例，证明改完之后录入页状态、积分流水、榜单**逐字节不变**）。
+
+**真正的原因**：进入「成绩录入」页时，系统**不记得你上次录的是哪个小项**，于是兜底挑**第一个「待录入」的小项**；而**刚发布完的小项状态已经是「已发布」**，正好被这条兜底排除——所以你离开一趟（例如去基础数据改个名字）再回来，右侧已经被换成**另一个小项**；而「撤销发布」按钮是**按当前这张表里有没有已发布的行**显示的，换到那个还没发过的小项上，按钮自然就不在。
+
+⇒ 现场看到的「**左栏那个小项仍写着已发布**」「**单位成绩仍有加分**」「**撤销发布按钮不见了**」这三条**本来不矛盾 —— 它们说的是两个不同的小项**。
+
+**现在会怎样**：录入页**记住你上次录的那个小项**（按 ID 存在本机），离开再回来仍是它，按钮就在。优先顺序是：地址里带的小项（例如仪表盘点「录入」进来的）→ **上次录的那个**（已发布的也算）→ 第一个「待录入」的 → 列表第一个。**记忆失效时会自动退回原来的兜底**（那个小项被删了、或浏览器不允许存本机数据，例如隐私模式），**不会把人挡在录入页外面**。
+
+### ② 新增：「清空本组 / 清空本批」成绩
+
+右侧表格上方的**工具栏**里（**和「撤销发布」并排**）多了「**清空本组**」；上面选了某一批次时，旁边还会出现「**清空本批**」。用途是**这一组 / 这一批整个录错了，要从头再来**。
+
+⚠️ **清空 = 先撤销发布、再把成绩内容一起清掉**：这一范围里每一行的成绩、名次、备注、以及行上的状态（DNS / DQ / DNF / 这类标记）都回到没录过的样子，原来已发布的分**一并收回**，榜单与大屏跟着回退。清**整组**时还会**一并清掉这一组按单位录入的「团体名次」**（否则会出现「成绩都清了、榜上还有分」）。
+
+**「撤销发布」与「清空」的区别（这两个最容易混）**
+
+| 动作 | 成绩内容 | 已产生的分 |
+| --- | --- | --- |
+| **撤销发布** | **保留**（退回草稿，改完重新发布即可） | 收回（该范围的积分流水作废） |
+| **清空** | **一起清掉** | 也收回 |
+
+**只想收回分数、成绩内容留着改 —— 用「撤销发布」；想让这一组回到「没录过」—— 才用「清空」。**
+
+**清空前必须先勾选**：点按钮会弹确认框，写明**哪个小项、哪个组别、清多少条、其中多少条已发布**、以及会收回多少分；**必须勾上「我知道这会清掉已发布的分数」**，确认键才点得动（服务端也会再兜一次，没勾选一律拒绝）。**没有「清空整个小项」这个按钮**——清空以「小项 + 组别（或其中一批）」为界。
+
+**谁会看到这两粒按钮**：**录入员及以上**（与录成绩同一档）。**访客 / 未登录**时按钮是灰的并写明原因；**示例数据模式**下不可用（与「发布」「撤销发布」同一口径）。**谁清空了什么**会记进审计日志（审计里的动作名是 `result.clear`：谁、什么时候、哪个小项哪个组、哪个范围、清了几条、收回多少分），「变更历史」里也会多一个版本节点并写明清了多少条。
+
+### ③ 升级后 5 分钟核对
+
+1. 打开「成绩录入」，选中一个**已发布**的小项 → 切到别的页面 / 去「基础数据 → 小项」随手改一下这个小项的显示名称 → **回到「成绩录入」页**：应当**还是刚才那个小项**，工具栏上的「**撤销发布**」按钮**还在**（这就是这一版修的那条）；
+2. 拿一个**可以随便试的小项**（动手前最好先做一次备份，见《部署指南》8.2 与《使用手册》14.2），选一个小项 + 一个组别，点「**清空本组**」：确认框里应写明清多少条、其中多少条已发布，**不勾选那行字时确认键点不动**；确认后看**积分榜**：这一组原先贡献的分应当**同步降下来**（大屏也会跟着回退）；
+3. 想只收回分、把成绩留着改，仍然用原来的「**撤销发布**」——它不会清掉成绩内容；
+4. 其余照旧：**不需要重新导入规则包，也不需要重配任何东西**；已有成绩、榜单与导出件**一个字不变**。
+
+### ④ 详细说明在哪
+
+《使用手册》4.7（撤销发布与清空的并列口径、两颗按钮的出现条件与勾选要求）、4.1（回到录入页记住上次的小项）、《常见问题》Q102（「我改了小项名称，回来发现撤销发布按钮没了」）。
+
+---
+
 ## dev_0.5.11
 
 ### 一句话