AskaEth/Scoreboard
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
116 Commits 1 Branch 1 Tag
c5ce1878fcc1efbcac925d98153cffca974655fc
Commit Graph
15 Commits
Author SHA1 Message Date
AskaEth c5ce1878fc 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` 两张）。
 2026-09-14 22:57:03 +08:00
AskaEth d11cab31db fix(entry): 补报名弹窗的搜索框支持「号码布」；版本 dev_0.5.7 
## 现场问题（主人原话）
> 成绩录入界面的补报名按钮窗口里面的搜索框只能查姓名和工号，不能查号码布，加一下。

号码布是本系统里**运动员的唯一标识**（定稿口径），现场拿号码布找人是常态，所以这条是刚需。

## 改了什么
- 抽出纯函数 `athleteMatchesKeyword(athlete, keyword)` 作为**选人搜索的唯一口径**：姓名、工号、**号码布** 三维并列；
  关键字归一（`trim()` + `toLowerCase()`）与仓库既有写法逐字一致，空搜索仍不筛人。
- `EntryPicker.vue` **两处**搜索都改成走它：
  - `filteredAthletes`（个人报名名单）
  - `membersByTeam`（团体队员名单）
- 两个搜索框的提示文字从「搜索姓名 / 工号」改成「**搜索姓名 / 工号 / 号码布**」。
- ⚠️ 收口成一个函数的意义：两个框**不会再各走各的** —— 这次就是因为两处各写了一份过滤条件，改一处漏一处。

## 验证
- **先红后绿**：新增 `web/src/admin/tests/athlete-search-bib.test.ts`（号码布能搜到、姓名/工号不回归、大小写与空格处理、空搜索不筛人）。
- 全量自检两轮**全绿、`EXIT=0`**：服务端 14 包 / 前端 929 例 0 fail / Console 68 例 0 fail。

## 顺带
`debug/使用说明/` 里落后的 4 份（使用手册 / 升级说明 / 报名名单导入规范 / 使用说明.txt）已补刷，与 `docs/` 逐份一致；
`docs/升级说明.md` 新增 `dev_0.5.7` 一节。

## 版本
`dev_0.5.6` → **`dev_0.5.7`**（无数据迁移）；安装器素材同步重生成（照例只动 `brand.bmp` 两张）。
 2026-09-14 21:54:05 +08:00
AskaEth 99c91f99f7 feat(entry): 团体报名「队员身份」—— 一条报名挂多个运动员，标识用号码布；版本 dev_0.5.6 
## 需求（主人原话）
> 「双打我给他定义的是团队赛事，团队赛事不应该本来就是可以配置多个人的吗」
> 「把队员身份证留住，**应该是服务于整个团体报名**」

**现状问题**：界面（`EntryPicker`）**本来就能勾多个运动员**，但提交时只把姓名拼成文字
（`entrySelection.ts` 的 `input.athletes.map(a => a.name)` 存进 `entries.member_names TEXT`）→ **身份全丢**
→ 系统不知道队里坐着谁 → **所有团体/对抗项目都给不出个人分、个人奖牌，上不了个人积分榜**。

## 口径
- **运动员的唯一标识是号码布**（主人明确更正，不是证件号）。
- **每个队员各拿一份完整的个人分** —— 是「**复制**」不是「拆」（与联队 `splitSharePoints` 正好相反）。
- **个人奖牌每人各一枚**；**单位总分与单位奖牌不受影响**（由通道开关 `count_to_team` / `count_to_team_medals` 控制）。

## 一、数据
- 迁移 `0026_entry_athletes.sql`：新表 `entry_athletes(entry_id, athlete_id, sort_order)`，PK `(entry_id, athlete_id)`，两个外键都 `ON DELETE CASCADE`。
  `entries` **一个字节没动**（`member_names` 保留为显示用名单；多队唯一键 `(category_id,team_id,squad) WHERE athlete_id IS NULL` 未触碰）。
- **老数据回填（尽力而为）**：拿 `member_names` 去 `athletes` 匹配 —— **号码布优先**，其次「姓名 + 单位」且同单位同名唯一；**匹配不上留空**，不硬猜。

## 二、引擎
- `RankedResult.MemberCopy`（报名项那份 `false`、队员副本 `true`）；**只在 `scope=athlete` 通道展开**（`scope=team` 与 `basis=aggregate` 不展开）。
- **单位维度不重复计算的三道锁**（本单最大的坑）：
  1. 队员副本流水 `count_to_team` **恒为 false** —— 单位总分那条 SQL 第一句就跳过它，而个人榜不看这个开关；
  2. 单位奖牌仍按**报名项**去重、且报名项那份**排在最前**；
  3. 队员副本**照抄 `TeamID` 与 `Shares`**（不换单位、不另造份额 —— 联队报名尤其危险）。
  反面也测了：个人奖牌若按报名项去重会**一枚都发不出来**（被 `AthleteID=0` 那份吃掉），故改为按「报名项 + 运动员」去重。

## 三、写 / 读
- `PUT /api/entries/{id}/athletes`（recorder+、CSRF）：body `{"athletes":[{"athleteId":12}],"requestId":"..."}`，**只认 athleteId**；空数组＝清空；
  改完当场重算推榜。400：athleteId 缺/不存在、同一人两次、>30 人、个人报名不能挂队员。
- 读：`entryDTO.athletes: [{athleteId, name, bib}]`（**始终是数组**）；`memberNames` 原样保留，**两者可并存**（没档案的人只能留文字）。

## 四、导入
- 报名表「队员名单」列现在**按号码布认人**（命中即关联，同时保留文字）；⚠️ **姓名完全不做匹配**（同名会认错，而认错的分已经上了榜）；匹配不上**不报错、只当文字**。
- 边界逐条有 notice/报错：跨单位号码布**照关联 + notice**（号码布是唯一标识）；同格重号只关联一次 + notice；**个人行**写了号码布只留文字 + notice；**认出 >30 人整行拦下**；成功时一条汇总 notice。
- **更新路必须重算**：老表先导入、成绩已发布，之后补上号码布重传 —— 不在更新路重算就会出现「名单里有队员、榜上没有他」（删掉该条件即红）。

## 五、界面与显示
- 补报名勾的人**真正提交**（导入成功后追加 `PUT /athletes`，**只发需要变的**：勾了人的单位、以及原来有队员这次一个没勾的（发 `[]`）；一个都没勾且原来也没队员的一律不发）；**队员写失败单独提示**（报名本身已加入，不冒充「加入报名失败」）。
- **改队员**：录入页「运动员/队」那格的**「队员」小按钮**（只有纯团体行才有），弹窗勾选式名单；**与「成员单位与份额」是两个独立写请求**（份额管「分给哪些单位」、队员管「这条报名里有哪几个人」）。
- 显示统一写法 **`姓名（号码布）`**（导出件；大屏只写姓名与 ` / ` 分隔 —— 号码布太长会把整屏字号压下去）；**没有队员关联的老数据一个字不变**；
  ⚠️ **一条报名仍只占一行**（有护栏测试钉着）；`squad`（队）与 `athletes`（队员）**正交**。

## 验证
- 全量自检两轮**全绿、`EXIT=0`**：服务端 14 包 / 前端 **921 例** 0 fail / Console 68 例 0 fail。
- 各块先红后绿并留原始输出；**老数据零变化**有 golden 对拍（引擎层 / 接口层 / 导出层逐行 dump）。

## 文档
`docs/报名名单导入规范.md`（队员列语义升级，列数仍是 13）、`docs/使用手册.md`（新增 4.13 团体报名的队员）、
`docs/升级说明.md`（新增 `dev_0.5.6` 一节）。

## 版本
`dev_0.5.5` → **`dev_0.5.6`**（含数据迁移 `0026`）；安装器素材同步重生成（照例只动 `brand.bmp` 两张）。
 2026-09-14 14:05:48 +08:00
AskaEth 7a3e4ad365 feat(entry): 团体项目多队（迁移 0025）+ 修联队团体名次 / 大屏分项成绩 / 预览算分口径；版本 dev_0.5.5 
## 一、新能力：团体项目多队
现场：羽毛球双打，一个单位可能派两个队，一个单位两个队各占一个名次。
- 迁移 `0025_entry_squad.sql`：`entries` 加 `squad TEXT NOT NULL DEFAULT ''`（自由文本队名，空串＝不区分队伍）；
  唯一索引由 `(category_id, team_id) WHERE athlete_id IS NULL` 换成 `(category_id, team_id, squad) WHERE athlete_id IS NULL`
  —— 原来那条正是「一个单位在一个组别只能报一条团体报名」的拦路虎。
- 导入：**第 13 列「队伍」**（`squad` / 队伍 / 队名 / 队伍名，可选，放最后）；老 12 列表照常导入。
- 显示：`单位名 + 队名`（不加括号），榜单不写队名（分与牌本来就归单位）。
- 新增「改队名」：`PUT /api/entries/{id}/squad` + 「成员单位与份额」弹窗里的队伍输入框（只对纯团体报名显示）。
  改队名**不需要重算**（`grep squad server/internal/domain/` = 0 处，改名前后流水/名次/榜单逐字节相同）。
- **老数据零变化**：接口层 JSON 剥掉新字段后逐字节相同；导出层 9 份导出件全单元格 750 行 dump 的 md5 相同。

## 二、修：团体名次控件没体现联队
联队的成员单位在「团体名次」里各占一行 → **合并成一行**（标签用大屏/导出一致的联队名），名次**只落主单位**；
成员单位不再进保存载荷，顺手堵掉「看 A、B 各一行，给 B 也录一个名次 → B 重复拿分」。
被并掉的成员单位原来若录过名次，区块里点名提示「已并入联队那一行，保存后清除」，不静默吞。

## 三、修：大屏「分项成绩」排名错乱
现场：第 3 栏列出的项目排名跳着显示（3、6、9、14、15、16），羽毛球单打第 1 名不显示。
**根因**：`group.rows.slice(0, 6)` 取的是**数据到达顺序**，整条渲染链**没有一处读 `rank`**。
修法：按名次升序（并列保持原先后、无名次排最后）再截断 —— 与同页「实时赛况」的既有口径一致。
复现证据：修前 `actual: [3,6,9,14,15,16]`（与现场数字一致）、`expected: [1,2,3,4,5,6]`。
顺带澄清：「只有第 3 栏出问题」不是栏的问题，是那一栏分到的数据次序不成立。

## 四、修：录入页预览算分与后端口径不一致（四处 + 一条延伸）
现场：手动录名次的项目（台球）「积分（自动）」列全是 0，而后端**有分**。
1. **预览不读 `channel_manual_ranks`、也不按通道 scope 分名次来源** → 「按单位录名次」的项目预览全 0，反过来名次填在成绩表时预览有分而服务端 0；
2. **末位归零判据不同**：预览原本「区间跨末位就整组归零」，与后端的 `startRank == lastPlace` 不符（并列第 1 时预览 0、服务端 10）；
3. **`compare=none` 时预览静默降级成 manual**（后端此时直接报错）→ 改为同口径：显示**原因**而不是一个算不出来的数字；
4. **管理端保存计分通道缺守卫**：`compare=none + basis=result/aggregate` 原先只有规则包导入拦，手工能配出来、到发布才报错 → 保存前 400 + 人话。
延伸：预览的「已发布分」基线**只扣行分**，不挂报名项的分（团体名次那类）没扣 → 发布确认框「最大分差」虚高；新增 `unitPoints` 一并扣。

## 五、修：手录名次项目的「成绩」列空白
`displayResult()` 在 `resultValue`/`resultText` 都拿不到时**漏出空值**（且函数声明返回 `string`）→
新增占位 `—`、类型收紧，实时赛况与底栏对齐同一口径。

## 文档
`docs/报名名单导入规范.md`（12 → 13 列）、`docs/使用手册.md`（多队章节）、
`docs/升级说明.md`（新增 `dev_0.5.5` 一节）、`debug/使用说明/` 七份同步。

## 验证
- 全量自检两轮**全绿、`EXIT=0`**：服务端 14 包 / 前端 **883 例** 0 fail / Console 68 例 0 fail。
- 各块都先写会红的测试、留了原始输出（含现场报的那组数字与「预览全 0」）。

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

## 下一批
`dev_0.5.6` = **团体报名队员身份**（把队员从文字名单变成人员关联，标识用**号码布**），工单见 `devdocs/20-团体报名队员身份.md`。
 2026-09-14 11:45:32 +08:00
AskaEth 9663d5bfb0 fix(entry): 修「团体名次 / 批次号 / 每批人数」填数字导致整页白屏（P0）；版本 dev_0.5.4 
## 现场现象
在「按单位手动录名次」的项目（例如篮球）的录成绩页，往底部「团体名次」输入框里填一个数字，
**整个录入页立刻变空白**，控制台 `TypeError: e.trim is not a function`（栈里是 computed 的 getter）。

## 根因（老 bug，不是联队引入）
- 模板是 `v-model="row.input"` + `type="number"`。
- **Vue 3 的 `vModelText` 对 `type="number"` 会自动做数值转换**
  （`castToNumber = number || (vnode.props && vnode.props.type === 'number')`）→ 填了数字之后值是
  `number`；只有**清空**时 `looseToNumber('')` 才留空串。当初的注释只写了后一半，漏了前一半。
- `teamRanks.ts` 的 `parseTeamRankInput(raw: string)` 里直接 `raw.trim()` → TypeError；
  而它的三个调用点（保存载荷 / 重复名次提示 / 描红）**全在渲染期的 computed 里** → 整页白屏。

证据：0.5.2（联队之前）的 `EntryPage.vue` 里就已是这套写法，`teamRanks.ts` 本轮一个字没改过。

## 修复
- `teamRanks.ts`：`parseTeamRankInput` 参数与 `TeamRankRow.input` 类型如实标注 `string | number`，
  解析前 `String(raw).trim()`；`teamRanksDirty` 归一后比较（否则 `number 3` 与 `string '3'` 会被判成
  「已修改」，保存按钮空亮着却什么都没改）。
- `EntryPage.vue`：**同类第二处** —— 「批量设置批次」的 `heatInput` / `heatSizeInput` 同样是
  `type="number"` 且下游 `.trim()`，**同样会整页白屏**，一并修掉。
- 写法与仓库既有的正确实现保持一致（`CategoriesSection.vue` / `AthletesSection.vue` 的 `toAge()`）。

## 同类隐患体检
把全仓库 **21 个 `type="number"` 的 v-model 绑定点**逐个追了下游用法（解析 / 比较 / `.trim()` / 传接口）：
**真正会炸的只有上面这 3 处**，其余 18 处本来就用 `Number()` 归一，安全。

## 验证
- **先红后绿**：修复前 3 例红（`raw.trim is not a function` 原地复现：number 解析抛错、computed 调用链抛错、
  脏判断误报 `true !== false`），修复后 13/13 通过。
- 前端用例 809 → **813**，0 fail；`vue-tsc` / `pnpm build` 退出码 0。
- 全量自检两轮全绿（服务端 14 包 / Console 68 例）；退出码直接读，未用管道吞。

## 版本
`dev_0.5.3` → **`dev_0.5.4`**（0.5.3 已产出并记过哈希，不重出同名包）；安装器素材同步重生成
（版本号烙在位图里，实测仍只有 `brand.bmp` 的 1x/2x 两张变化）。
 2026-09-14 09:57:02 +08:00
AskaEth 830a4dbdb7 feat(joint-team): 联队 + 份额分成 —— 迁移 0024、引擎按份额拆、导出 / 大屏 / 录入三路打通；版本 dev_0.5.3 
## 需求
现场 6 项球类比赛里，有两个单位因参赛人数不足**合并成一个单位参赛**。
做法不是新建「联队单位」（那样榜单会多出第 8 个单位，且分和奖牌分不到原单位头上），
而是**一条报名挂多个单位、按份额拆**。

## 拍板口径
- 份额**可配、默认均分**
- 积分**平均拆、接受 .5**（团体第 1 名 15 分 → 两个单位各 7.5 分）
- 奖牌**各记一枚**（两个单位各 1 枚完整金牌，不是各 0.5 枚）
- 显示上把联队名字写全（形如 `第一分公司+第二分公司联队`），成员单位的 logo 都放
- 导入表里单位编码写 `A+B`

## 一、核心层（数据模型 + 引擎 + 存储 + 报名写入 + 导入解析）
- 迁移 `0024_entry_team_shares.sql`：新建 `entry_team_shares(entry_id, team_id, points_share,
  medal_share, sort_order)`。**两个口径分开表达**是刻意的——积分要拆成小数（7.5）、奖牌要整枚
  各记，用一个数表达就会把「7.5 分」和「半枚金牌」绑在一起，奖牌榜立刻错。
  `entries.team_id` 保留为**主单位**；老数据 `INSERT OR IGNORE` 回填成「主单位独占 100%」。
- 引擎：`ResolveShares`（引擎与读侧共用）、`splitSharePoints`（按权重归一、**末位吞余数**，
  各份之和恒等于原来那一份）、`TeamShare.Medal`（缺省整枚）。积分按权重拆，奖牌每个份额各记整枚。
- 报名写入：`PUT /api/entries/{id}/team-shares`（recorder 及以上，保存后当场重算该小项组别并推榜）。
- 导入：`team_code` 支持 `A+B`（主单位 = 加号左边，均分，奖牌各整枚）；非法形态
  （`A+` / `+B` / `A++B` / `A+A` / 成员 >5 / 单位不存在）**行级拦下、不落库**，给人话报错。

## 二、导出与导入模板
- 11 份导出件：联队写全成员单位（`第一分公司+第二分公司联队`），并注明**分拆给了哪几家、各多少**
  （份额占比 + 各单位实得积分，取自按份额拆完的流水）。
- 单位奖牌明细：奖牌格写「金牌（联队 …，各单位各记 1 枚）」；含联队时副标题说明
  「各单位奖牌数之和会大于实际颁发数」——这是口径 3 的必然结果，**不是 bug**。
- 按单位筛选导出把成员单位一起算上（否则 B 单位导自己的名单会看不到自己参加的那场联队比赛）。
- 分工作表模板：`A+B` 写法挂在「单位编码」表头的**单元格批注 + 输入提示**（中英各一份）；
  **表头文字、列序、12 列、工作表命名一个字未动**（动了模板就导不回去）。

## 三、前端与大屏
- 录入页 / 复核页「单位」列：联队显示 `联队 第一分公司 67%（权重 2） 第二分公司 33%`，
  点该格打开「成员单位与份额」弹窗（加/删成员、改权重、主单位徽标、实时比例预览）。
  **普通报名（单单位）的文案、元素、类名一字未动**，只多了一个 `@click` 入口与悬停提示。
- 大屏：分项成绩 / 实时赛况单位列显示联队全名并**放上两个单位的 logo**（单位列宽按该行的
  logo 数留位）；底栏同理。

## 四、验证（都留了证据）
- **老数据逐字节不变**（改算分引擎的硬门槛）：引擎层 golden `a2aa1c97…`、接口层 golden
  `aa6cea37…`，两个哈希由主会话**在修前树上亲手重跑确认**；导出层另有 11 份导出件逐行对拍，
  差异 **0 处**。
- 前端 773 → **809 例**全绿（旧用例一行未改）；服务端 14 包两轮全绿；Console 68 例全绿。
- 真机联调：录入页份额弹窗、大屏两个 logo、奖牌榜 A/B 各 1 金、写路径（移除成员 → 保存 → 200）。

## 五、版本
`dev_0.5.2` → **`dev_0.5.3`**（本批含数据迁移 0024 + 新功能，必须与上一包区分开）；
安装器素材重生成（版本号烙在位图里，实测只有 `brand.bmp` 的 1x/2x 两张变化，其余 92 张逐字节未变）。
 2026-09-14 03:52:34 +08:00
AskaEth b631418a85 chore(release): 版本号 dev_0.5.1 → dev_0.5.2（安装器素材与版本落点同步） 
本批代码内容就是 1b8a37f（分工作表报名模板 + 号码布判重 + 备份原子落盘），
这里只把它作为一个**能和上一批区分开**的版本发出去——上一批与它同名同版本号，
`debug/` 里会被同名覆盖，现场两份包分不出来。

- `VERSION` 是唯一真相：`dev_0.5.1` → `dev_0.5.2`
- 安装器素材重生成（`console/installer/art-gen/gen_art.py`）：版本号是**烙在位图里**的，
  所以必须重跑。实测**只有 `brand.bmp` 的 1x / 2x 两张变化，其余 92 张逐字节未变**；
  `art/version.txt` 同步成 `0.5.2`（构建期 `prepare-extra.mjs` 拿它和 `VERSION` 核对，对不上直接构建失败）
- `console/package.json` 同步（构建期会按 `VERSION` 重写，这里是让仓库自洽，免得构建机 pull 撞冲突）
- `docs/升级说明.md` 新增 **dev_0.5.2** 一节（① 分工作表模板 ② 号码布判重 ③ 备份原子落盘
  ④ 升级后 5 分钟核对），并把「（当前版本）」标记从 0.5.1 节移到新节；
  这一份是正源，`console/extra/升级说明.txt` 由 `prepare-extra.mjs` 从它生成（该目录 gitignore）

本地跑过一次 `node deploy/prepare-extra.mjs` 预检：`installer art version matches (0.5.2)` /
`version dev_0.5.2 -> deploy/version.gen.bat` / `console/package.json version is 0.5.2`，退出码 0。
 2026-09-14 02:40:56 +08:00
AskaEth a57df78f99 fix(installer): 安装位置识别与模式切换目录（真机四因根除） 
主人真机复验：① 不能像原版那样自动识别「已安装程序的安装位置」；② 选「为所有用户安装」却装到
%LOCALAPPDATA% 而不是 Program Files。

真机打点（instrumented 副本 + WM_COMMAND/BM_CLICK/WM_SETTEXT 驱动）读出四个根因：
1. 切换安装模式单选钮只改状态位图，**不同步输入框**；
2. setInstallModePerAllUsers/PerUser 会按记忆/默认**重算 $INSTDIR**，把「框里定下的值」
   （用户手改、浏览选择、记忆）**无条件冲掉** —— 这是两条症状的共同根因
   （打点：after-normalize=[D:\SBCustom\Scoreboard Console] → after-mode=[C:\Program Files (x86)\…]）；
3. 记忆读取 HKCU 优先、**不看安装模式** → 一条更早的用户级记忆顶掉刚装好的机器级目录；
4. 无人值守会话里 $LOCALAPPDATA 解析成 C:\ProgramData →「仅为我」默认成了 C:\ProgramData\Programs\…。

改法：
- 新增 ModeDefaultDir：「为所有用户」→ $PROGRAMFILES64\${APP_FILENAME}（本包是 x64）；
  「仅为我」→ SHGetKnownFolderPath(FOLDERID_UserProgramFiles)，失败才退回 $LOCALAPPDATA\Programs；
- 新增 PathTouched（框里的文本 != 程序设定的值 = 用户手改过）与 SyncPathToMode：
  切模式时**只有用户没改过**才把框与 $INSTDIR 同步成该模式默认目录（不冲掉用户刚填的）；
- PageDirLeave 用 $pathKeep 保住路径，跑完上游两个宏后再恢复 —— 只让宏改模式与 SHELL_CONTEXT，不再改路径；
- .onInit 在 customInit 之后**按当前模式**重读自家记忆键（all → HKLM，否则 HKCU）。

真机六条全过（含落盘复核）：进 P3 显示记忆目录；点「为所有用户」→ C:\Program Files\Scoreboard_Console；
点「仅为我」→ %LOCALAPPDATA%\Programs\…；点回去再正确切换；手塞自定义路径以它为准；改过后再切模式不被冲掉。
静默无回归：/S 6.6s exit=0 落记忆目录；/S /D= 6.4s exit=0 且 /D= 优先。
wine 回归：人手速度拖动、原生控件隐藏、P3→P5 自动翻页、✕ 退出无 StdUtils 报错、旧版在跑时 /S 关掉旧进程。
 2026-09-13 23:32:00 +08:00
AskaEth b1c6d5d54a fix(installer): 定时器分辨率 1.5 秒 → 改用 nsDialogs 定时器（拖不动/进度跳/卡收尾三症状同根） 
真机取证：StdUtils.TimerCreate 实测**每 ~1500ms 才跳一次**（真机 tick 计数 7 次/10.7 秒），
且请求 4/20/60/250ms 四个间隔出来的都是 1500ms 且完全同步 —— 等于与请求值无关的低分辨率实现。
上一版拿它做 60ms 轮询，于是：

- **窗口拖不动**：1.5 秒才采一次光标，而人手一次拖（按下→移动→松开）不到 1.5 秒，
  永远采不到「左键按下」那一刻。判别性实验（wine，人手速度 ~0.6 秒）：旧代码 dx=0/dy=0，
  新代码 dx=200/dy=100。（上一轮 wine 测的是 6 秒慢速拖，慢到 1.5s 的 tick 也能采到，所以漏了。）
- **进度只显示 0% 与 100%**：真因不是 tick，而是分段耗时极不均匀（几乎全在解压，后 4 段每段 <1ms）
  → 每段加 400ms 下限，真机 trace 407/484/656ms，肉眼可见。
- **装完卡在「收尾」**：翻页那次 BM_CLICK 只发一次，丢了就永远停在第 4 页 → 改成装完后每 tick 重试
  （$instDone 门防止安装途中的 Sleep 泵出 tick 乱点）。
- 顺带修好 P5「完成」页：定时器改为每页重建，P5 有独立一份，悬停与拖动都恢复。

改法：${StdUtils.TimerCreate} → ${NSD_CreateTimer}（挂在当前页对话框上，每页 NewPage 重建、
KillTick 里 ${NSD_KillTimer}，删掉 $timerId）；Stage 加 STAGE_DWELL 400 + GetTickCount 补 Sleep。

真机验证：每页 tick ≈63ms 且 P1..P5 都活着；分段停留 ≥400ms；P4 自动翻到完成页；
静默 /S exit=0 / 7.8s、旧版在跑时 exit=0 / 10.5s 且 running_after=0。
wine 回归：人手速度拖动、原生控件隐藏、P3 翻页、✕ 退出无 StdUtils 报错、/S /currentuser /D= 正常。
真机无输入桌面，鼠标驱动的悬停/拖动只能靠 wine 几何证据 + 真机 tick 频率证据。
 2026-09-13 21:13:02 +08:00
AskaEth f09cb07a23 fix(installer): 静默安装挂死 —— 旧版卸载器在无人值守会话里弹了没人能点的模态框 
真机挂死（/S 原地升级 600 秒超时）的根因不是探测方式，而是旧版本卸载器那一步：
CheckAdmin 修好后静默 /S 从「按用户」变成「为所有用户」，于是 DoInstall 里
uninstallOldVersion 真的去跑上次装的卸载器；那个旧卸载器自己又要一次 UAC，无人值守
会话里被系统取消（1223=ERROR_CANCELLED），重试 5 轮后上游 handleUninstallResult 弹出
MessageBox（无 /SD）→ 模态框没人点 → 永久挂住。
真机取证：枚举该进程窗口得到隐藏的 #32770「Failed to uninstall old application files…: 1223」
且线程处于 Wait: UserRequest；另用探针给 GetProcessInfo / nsProcess / 令牌查询 / netsh
逐步计时（真机全部 ≤234ms），排除「cmd|tasklist 无超时挂住」这条猜测。

改法：
- 接管上游的两个卸载失败钩子（放在 !include "installUtil.nsh" 之前）：静默只 DetailPrint 并
  继续覆盖安装；交互才 MB_OK|MB_ICONEXCLAMATION|MB_TOPMOST + SetErrorLevel 2 + Quit
- 静默安装整段跳过旧卸载器（旧卸载器随时可能弹出无人能点的 UAC，唯一能保证有界行为的做法）；
  交互路径保留上游行为
- 保留上一轮的 nsProcess 化（不再起 cmd|tasklist|findstr）

真机实测（构建机 SSH）：/S 原地升级 exit=0 / 7.2s（改前 600s 超时），目录 85 文件、卸载器重写且为 MZ；
先跑起旧版（含 scoreboard.exe 共 6 进程）再 /S → exit=0 / 9.9s、running_after=0；
交互窗口起得来不挂、原生控件可见性全 0。wine 回归全过（拖动/原生控件/翻页/退出无 StdUtils 报错/静默卸载）。
 2026-09-13 19:55:21 +08:00
AskaEth 23ba8a1830 fix(installer): 管理员判定误报（真机）+ 安装时真正关闭旧版本进程 
## 一、CheckAdmin 在真机永远判「非提权」
真凶：GetTokenInformation 的 ReturnLength 传了 NULL（`p 0`）。真机 Windows 直接返回
ERROR_INVALID_PARAMETER(80) → rc=0 → $gIsAdmin 恒为 0 → 明明已经 UAC 提权，P3 选
「为所有用户安装」仍弹「当前账户没有管理员权限…已改为仅为我安装」。wine 不校验该参数，
所以本地怎么点都复现不出来。
真机探针取证：NULL → rc=0 err=80 val=0；改传真实指针 → rc=1 val=1。

- ReturnLength 改用 System::Call 分配的真指针；取值寄存器写 .R9（写 .0 插件不认，
  $0 会保持空串导致判定恒真）；查询失败按非提权并把原始值落到 %TEMP% 便于取证
- un.onInit 里那句判定原先恒为真 → 每次卸载/升级白弹一次 UAC，一并修正

## 二、安装时没有关闭在跑的旧版本
根因两个：① 上游 CHECK_APP_RUNNING 的 MessageBox 被我们的自绘窗口压在下面（复现时可见
305×82 黑矩形），用户看不见但流程被阻塞，于是旧程序一直没被关掉；② 上游探测只按 $INSTDIR
前缀或 %USERNAME% 过滤，绿色版/别的账户实例一律漏掉。

改为自写 CloseRunningApp（安装/卸载共用）：tasklist+findstr 按映像名找 → 温和 taskkill →
强制 /F /T /IM（连带 scoreboard.exe 子进程）→ 兜底 /F /IM → 仍关不掉时交互给置顶重试框、
静默直接非 0 退出。两条路都绝不静默往下一路装完。

回归（wine）：拖动精确；原生控件 IsWindowVisible=0；P3→P4→P5 翻页；退出无 StdUtils 报错；
/S /currentuser /D=... 落对目录且卸载器为 MZ。
 2026-09-13 18:16:27 +08:00
AskaEth 67eadd7fe6 fix(installer): 真机四条 UI 问题 + 提权改为 highestAvailable 
主人真机实测报出四个问题，全部只有在真 Windows 上才暴露（wine 渲染/移动循环/UAC/插件卸载时序都不同）：

1. **窗口拖不动**：原来把移动交给 DefWindowProc 的移动循环（ReleaseCapture + WM_NCLBUTTONDOWN HTCAPTION），
   我们摘掉了 WS_CAPTION，真机上那个循环不启动。改成自己算位移：按下时记锚点（GetCursorPos + GetWindowRect），
   之后每个 tick 用 SetWindowPos 跟光标走。注意起拖后不能因为光标甩出标题栏就停（否则变成「拖一下就断」）。
2. **原生按钮透出**：内层对话框只「盖住」了原生控件，鼠标划过时按钮自己重绘就露出来。现在每页显式隐藏
   11 个原生 ID（Next/Cancel/Back + 品牌字 + 页眉），并断言 IsWindowVisible 为假；隐藏后 BM_CLICK 翻页仍有效。
3. **P3 点下一步闪一下没反应**：不是目录校验，是提权失败分支末尾的 Abort（默认选中「为所有用户安装」时
   真机必然走到）。现在不再 Abort，降级为按用户安装并弹一句说明后继续。
4. **退出时弹 StdUtils::TimerCreate「Plug-in unloaded before all timers were destroyed」**：
   定时器从来没销毁过。加哨兵 $timerOn，在 .onGUIEnd 与 MUI_CUSTOMFUNCTION_ABORT 两条退出路径上幂等销毁；
   定时器全程只建一次（翻页不叠加）。对照实验：把销毁段掏空即复现该报错窗口。

**提权策略**（主人拍板「一启动就提权」）：RequestExecutionLevel highest。
原先没写这条指令时 NSIS 默认是 requireAdministrator —— 受限账户机器上根本起不来；highest 在管理员机器上
行为与 admin 完全一致（启动即 UAC、全程提权、防火墙必然放行），但给受限账户留了降级路径。
同时去掉 P3 的中途 UAC_RunElevated（那正是「闪一下没反应」的来源）。

验证（wine）：五页走完 + 点完成/点 ✕ 退出均无 StdUtils 报错；原生按钮 vis=000；拖动位移精确；
/S /currentuser /D=... 与 /S /D=...（非提权时降级按用户）都 exit 0 且写出真卸载器。
UAC 本身与四条观感须真机复验。
 2026-09-13 16:49:20 +08:00
AskaEth a1aeed3c55 fix(installer): 静默安装落到 /D= 而不是记忆目录 + 静默路径绕开 UAC 插件 
真机实测发现：`安装包.exe /S /currentuser /D=D:\tmp\sbsilent` 退出码 0、耗时 12 秒，
但 /D= 目录是空的 —— 安装其实**落到了「安装目录记忆」里的那个目录**。

（我最初的判断「DoInstall 从未被调用」是错的：给 Section/DoInstall 打 trace 后实测整条链
从头跑到尾，只是 $INSTDIR 被 customInit 用注册表记忆值盖掉了；空目录是 .onInit 的
SetOutPath 先建出来的假象。）

- **/D= 优先级最高**：.onInit 先取 GetDParameter，customInit 之后再盖回 $INSTDIR
  （/D= 不进 ${GetParameters}，必须走 StdUtils.GetAllParameters）
- **静默入口**：Section "install" 在 ${Silent} 时 Call DoInstall + quitSuccess；
  DoInstall 加一次性守卫 $instStarted，Tick 与 Section 谁先到谁干活，绝不装两遍
- **静默不弹 UAC**：per-machine 分支在静默时改用查进程令牌，非管理员退回按用户安装
- **${UAC_IsAdmin} 全局换成 CheckAdmin**（按 BUILD_UNINSTALLER 分流成 un.CheckAdmin）：
  构建期生成的 installer-custom.nsh 里 netsh 放行前那句判断原来走 UAC 插件，
  无页窗口时不返回，是静默跑不通的最后一关
- 脚本不带 BOM（BOM 会被拼进大脚本中间），本机用 -INPUTCHARSET UTF8 编译

验证（wine）：非静默 P1→P5 走完且目录/卸载器齐全；静默 /S /currentuser /D=C:\v4 → exit 0、
文件与真卸载器都在 C:\v4；再静默卸载 → 目录消失、注册表零残留；/S /D=... 亦落在 /D=。
真机由主代理复验。
 2026-09-13 15:55:40 +08:00
AskaEth 9fee6f2da5 fix(installer): 安装器脚本不能带 BOM —— 它会拼进大脚本中间让 makensis 报 Invalid command 
构建机上真实失败：`Invalid command: "?;"` / `Error in script "<stdin>" on line 83`。
本机单编这个脚本一切正常，只有 electron-builder 出包才炸。

根因：electron-builder 把「它的共享头部 + 我们的脚本」拼成一个整脚本、经 stdin 喂给 makensis，
而 Node 的 readFileSync(…, 'utf8') **不会**吃掉文件开头的 BOM —— 那个 U+FEFF 落在拼接结果
中间某一行的行首，makensis 就把它当成命令名的一部分（控制台显示成问号）。

- 去掉 console/installer/installer.nsi 的 UTF-8 BOM
- deploy/prepare-extra.mjs 的检查反向：从「必须有 BOM」改成「必须没有 BOM」，并把原因写进注释，
  避免下一个人再按直觉加回去；中文编码改由 makensis 的 -INPUTCHARSET UTF8 保证
  （electron-builder 本来就会传这个参数，本机手工编译也要带）

验证：无 BOM → prepare-extra 退出 0；临时加回 BOM → 退出 1 且提示准确。
 2026-09-13 15:25:01 +08:00
AskaEth 877ff15823 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 的双通道形态按要求改变。
 2026-09-13 15:20:18 +08:00