AskaEth/Scoreboard
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: AskaEth/Scoreboard:a61d793d799e408351f82ea531a1f06830b6218b
AskaEth/Scoreboard:main
AskaEth/Scoreboard:v0.5.9
...
compare: AskaEth/Scoreboard:v0.5.9
AskaEth/Scoreboard:main
AskaEth/Scoreboard:v0.5.9
114 Commits
a61d793d79 ... v0.5.9
Author SHA1 Message Date
AskaEth 55051fd633 fix(import): 导入提示改成「能照着改」的话 + 模板给「姓名」「队员名单」加说明；版本 dev_0.5.9 
## 起因（主人原话）
> 我应该如何用表格导入团体报名? 我现在不管怎么填的话，它都提示：
> 「第2行填写了队伍 但是这一行有运动员姓名 按个人报名处理」。但实际上我们程序里，团体报名是可以包含运动员姓名的。

## 核实结论：不是功能 bug，是提示没用
系统用「**`姓名` 列有没有填**」区分个人 / 团体报名（数据模型决定的：一条报名要么属于某个人、要么属于一支队）。
**团体报名的队员要填在「队员名单」列**（写号码布），`姓名` 列留空；队员就是这条报名的成员。
原来那条提示**只说了后果、没说动作**，所以现场只能反复换填法重试。

## 改了什么
1. **两条行级提示改成「后果 + 两步动作」**（保留旧文案里的关键词，既有断言一字未改仍通过）：
   - 队伍那条：`第 N 行填了队伍「一队」，但这一行也填了运动员姓名，系统按个人报名处理：队伍只对团体报名生效，这一格没有写进库里。要报团体（一支队）请把姓名列留空、把队员的号码布填到「队员名单」列；这一行确实是个人报名，把「队伍」这一格删掉即可`
   - 队员名单那条：同口径（`…队员只对团体报名生效，这一格只作文字名单保留、没有关联到人。要报团体请把姓名列留空、队员的号码布就填在「队员名单」列…`）
2. **导入模板加说明**：原来只有「单位编码」表头挂了批注；现在给 **`姓名`**（填了就是个人报名、团体请留空）与 **`队员名单`**（团体报名的队员写这里、**写号码布**才会关联到人）两个表头**各加一条批注 + 输入提示**，中英文两套。
3. ⚠️ **模板的表头文字、列序、13 列、工作表命名一个字没动**（动了模板就导不回去，有测试逐字钉着）。

## 文档
`docs/报名名单导入规范.md`（新增「个人报名 vs 团体报名」对照表 + 两条提示原文收进常见报错 + 队员名单分隔符说明）、
`docs/使用手册.md`（在工作台导入那节点明判据）、`docs/升级说明.md`（新增 `dev_0.5.9` 一节）。

## 验证
- **先红后绿**；全量自检两轮**全绿、`EXIT=0`**：服务端 14 包 / 前端 **944 例** 0 fail / Console 68 例 0 fail。

## 版本
`dev_0.5.8` → **`dev_0.5.9`**（**无数据迁移**）；安装器素材同步重生成（照例只动 `brand.bmp` 两张）。
 2026-09-14 23:40:31 +08:00
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 1b8a37ff8c feat(import): 报名模板按「小项 × 组别」分工作表；号码布判重改认证件号；备份改原子落盘 
三件事合成一次提交（其中两件都落在 handlers_config.go，无法按文件拆开）：

一、分工作表报名模板（新增能力）
- 新增 GET /api/entries/template.xlsx：按当前赛事的「小项 × 组别」生成模板，
  一个小项组别一张工作表，工作表名 = <小项>@<组别>（31 字符上限、重名自动去重）。
- 导入解析器认工作表名还原小项 + 组别；若与表内列冲突则报错，不静默取其一。
- 小项名与组别名禁用 @，基础数据界面 / 规则包导入 / 服务端校验三处一并拦截。
- 单表 CSV/XLSX 导入路径不回归。

二、号码布判重（修误判）
- 旧逻辑依赖证件号本身，而证件号是可选字段 → 同一个人报多个项目会被整块拦下。
- 改为：号码布相同且证件号相同 → 判定为同一人报多项，放行；
  号码布相同且证件号都能填且不同 → 仍报错（真抢号）；一方证件号为空 → 放行并给提示。
- 团体行的号码布一并纳入查重。

三、自动备份的关停与落盘（修数据安全隐患）
- export.Service 增加 Wait()：StartAuto 的协程进 WaitGroup，关停时 join（10 秒上限，
  超时只记 WARN 不拖死关闭），不再在备份写到一半时退出。
- vacuumInto 改为先写 <最终名>.tmp-<随机> 再 rename，失败则删临时文件；
  Backup / SafetySnapshot / ExportProjectZip 三个调用方一并受益。
- 新增 isFinalBackupName，ListBackups / safetyCopies / KindOfBackupName 统一过滤中间文件，
  避免半截 .db 被列进备份列表、进而被「一键恢复」选中。

文档：docs/ 五份（使用手册 / 报名名单导入规范 / 升级说明 / 部署指南 / 上线检查清单）同步。
 2026-09-14 01:10:16 +08:00
AskaEth b74768b7d5 fix(display): 实时赛况不再挤压省略 —— 单位列宽由内容算，字号把单位列一并纳入预算 
主人报：大屏「实时赛况」页在两栏显示时，单位名较长、成绩较长（如 1:12.66）会被挤压显示省略号。

实测根因：**单位列宽写死**（`.boards-2 .row` 的 `60px minmax(0,1fr) 190px …`）而单位名墨迹实测
206~343px → 必然进省略态；单栏 524 vs 694、split 166 vs 437 同理。弹性宽度全给了运动员列。
更关键的是 `fitFont.ts` 的 `fitLiveRowFontPx` **只把成绩列纳入字号计算**，单位列从未进过这笔账 ——
所以字号自适应对它一直没生效。

改法：
- `fitFont.ts` 新增 `LiveRowGeometry`（各版式行宽 1710/836/815、名次列、间距、单位列下限与预算）、
  `liveTeamColumnPx`（按单位名墨迹定列宽，含 logo 1.28em）、`liveNameColumnPx`；
  `fitLiveRowFontPx` 增加 teams/teamsWithLogo 参数，按「名次＋名字(≥4 汉字)＋单位＋成绩装得进一行」逐像素收字号；
  `resultTextEm` 更名 `textEm`（成绩与单位名共用同一套字符宽度表）。
- `LivePage.vue` 把单位名喂进字号计算并导出 `--team-width`，网格改用该变量。
- **取舍**：以收字号换完整显示（split 最狠 56→41px）；单位列封顶 380/430/900px，超过才由单位名省略
  —— **成绩与名次在任何情况下都完整**（观众最关心的先保住）。

肉眼验收（1920×1080，ReadMediaFile 逐张看过）：两栏 + 10 字单位名 + 12:34.56 → 全完整，43px（改前 44px）；
单栏同样全完整，88px；**对照组短单位名网格改前改后完全一致、0 省略**（常态数据零变化）。
测试：fitFont +5、live-page +1（单位列宽由内容算、网格不得再有写死单位列、必须把单位名喂进 fitFont），
并修正 2 条因网格写法变化而失真的既有断言；改前跑这些用例会红。前端 767/767、vue-tsc 通过。
未验证：真机 4K/投影观感与真实服务端数据（本次数据为接口桩）。
 2026-09-13 23:52:52 +08:00
AskaEth 2888200045 feat(entry): 录入界面加「补报名」入口 —— 移出报名后可以重新指定项目/组别 
需求（主人）：「导入时给运动员指定了绑定的项目和组别，但在录入界面把该项报名取消之后，
没有任何地方可以把已录入的运动员重新指定项目报名。」

其实功能一直有（`EntryPicker`「从已有名单勾选报名」，支持小项+组别+个人/团体），
只是它只出现在「基础数据 → 报名导入」页里 —— 用户在哪儿取消的、就去哪儿找，这是入口位置问题。

- `EntryPage.vue`：工具栏右侧（组别页签同一排、表格正上方）加「补报名」按钮；
  只读/示例数据模式禁用；走与批量操作同口径的三道拦截（示例数据/只读/有未保存修改）；
  点击时按需加载基础数据这份名单；提交后若提交的是本页当前小项则整表重拉并提示。
- `EntryPicker.vue`：新增 `dialog` / `presetEventId` / `presetCategoryId` 三个 props 与 `submitted` emit，
  预选当前小项与组别（组别对不上时回落到第一个）。**不传 props 时渲染与行为与以前完全一致**，
  「基础数据 → 报名导入」页的内联用法零改动（有测试钉着 `<EntryPicker />` 仍在）。
- 移出报名后的提示补一句指路「如需重新报名，点上方『补报名』…」；本组空了的空态同样指向「补报名」。
- 文档：使用手册 4.8 / 10.7 补操作路径，常见问题 Q91（批量移出那节）补「移出后想加回来」。

验证：`vue-tsc` 通过；前端 761 例全过（基线 754，新增 7）。
接口级 E2E（独立数据目录）走通「勾选报名 → 批量移出 → 补报名」，名单恢复 1 人、无重复建档、未写进别的组别。
浏览器 E2E（真实 Chromium + 临时同源代理）走通「按钮可见 → 打开同一 picker 且预选 100米/男子组 →
加入后出现在成绩表 → 移出提示 → 空态指路」，无 console 报错。
未验证：弹窗里「团体报名」页签的实际提交、窄屏布局、只读/示例数据两道拦截（仅代码核对）。
 2026-09-13 23:46:52 +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 9951a69938 feat(import): 报名导入支持中文表头，并给出中/英两套模板下载 
需求：主人要「CSV 模板的表头能改一下，或者提供两个按钮，一个中文表头一个英文表头」。

- 解析器加**中文别名**（英文仍是规范名：取值、报错、纯英文模板、勾选导出都用它）。
  12 列，顺序即模板列序：项目编码 / 组别 / 单位编码 / 姓名 / 证件号 / 性别 / 年龄 /
  号码布 / 种子 / 批次 / 状态 / 队员名单；另认一批同义写法（小项编码、参赛单位编码、
  运动员姓名、身份证号、道次、批次号、报名状态…）。
  Go 别名表 == 前端 COLUMN_ALIASES == 导入规范文档表格，三方逐列逐名一致（脚本核对）。
- **向后兼容**：纯英文表头一字不改照常导入；回归用**字面量**（不复用常量）钉死老 11 列表头
  与大写/空格变体，避免有人改常量把回归一起改掉。
- **中英可任意混排**，但**同一列出现两种写法（或写两遍）整份拦下**并说明——两列都可能带数据，
  静默取其一等于丢另一列。容错沿用既有先例：BOM（含格子中间的 U+FEFF）、全角空格/全角 ASCII、
  首尾空格、大小写。
- 缺列报错**中英并列**（「缺少列 athlete_name（姓名）」），现场拿中文模板的人一眼看懂。
- 前端两个下载按钮：「下载模板（中文表头）」「下载模板（英文表头）」，列序与列数完全一致，
  文件名可区分；示例数据模式（mock）同步，避免两条路径产出不同模板。
- 文档 `docs/报名名单导入规范.md` 补两套表头与「两套都能导入」的说明（原内容未删）。

端到端（真服务端 + curl）：中文模板填两行 → {"created":2} 且库中值取自中文列；
英文模板同一份数据 → {"updated":2} 不重复建档；缺列与表头重复分别给出上述人话报错。
自检：gofmt / go build / go vet / go test 全绿；vue-tsc + 前端 754 例全过。
 2026-09-13 21:55:37 +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
AskaEth 78b14efaa9 feat(installer): 「为所有用户安装」那趟自动放行防火墙入站 19540（装时加 / 卸时回收） 
- deploy/prepare-extra.mjs 生成的安装器脚本新增两个 !define（规则名 / 端口）与两段逻辑：
  customInstall 里当 $installMode == "all" 且当前是提权进程时，先删后加一条入站放行规则；
  customUnInstall 里只要是管理员就回收同一条规则。失败一律忽略，绝不因此让安装/卸载失败。
- 订正 docs 里「安装包按用户安装、不申请提权、改不了防火墙」这句错话（部署指南 7.5/7.9、
  上线检查清单、常见问题 Q101、升级说明）：选「为所有用户安装」会 UAC 提权，那一趟就把规则加好了；
  「仅为我安装」才需要现场手工放行。手工规则名与自动规则名不同，卸载只删自动那条。
- .gitignore 注释补上「防火墙入站规则」。

验证：四套自检全绿（服务端 13 包 / 前端 vue-tsc + 680 例 + build / Console 20 文件 + 68 例）；
生成器重跑幂等（.nsh 哈希 9edcdc31… 不变）；本机 wine 用 makensis v3.04 编译含该 .nsh 的脚本 0 error。
未验证（需真机）：提权安装后防火墙里真的出现该规则、卸载真的删掉、失败分支真机表现。
 2026-09-12 19:42:23 +08:00
AskaEth c97d3150c9 fix(admin): 局域网大屏卡片按「地址类别」判定 + 三层兜底 + 手填入口（dev_0.5.0） 
## 判断失误的修正（主人现场实测出来的）
主人现场是 **169.254 自动配置网段**（没有 DHCP，设备靠链路本地地址互访），
平板实测能访问 `http://169.254.79.190:19540/display`；而卡片一开始把链路本地地址
**排除**了，于是显示「未检测到局域网地址」。
根因：`usableLanIPv4` 排除了 `IsLinkLocalUnicast()`，理由写的是「169.254 说明没拿到 IP」
——那是**对网络健不健康的猜测**，不是**地址能不能用的事实**。

现改为按**地址类别**判定（`ipv4Scope`，全部用标准库谓词，**代码里没有任何网段字面量**）：
只排除「作为对端访问目标没有意义」的四类（回环 / 未指定 / 组播 / 广播），
链路本地与私网、全局一样进候选，只**排在最后**并带说明
「自动配置地址：本网段没有 DHCP，同网段设备可以互相访问」。
新增**反硬编码护栏用例**：函数体内不得出现 `x.x.x.x` 字面量，且必须用满 6 个谓词。
顺带修掉新用例抓出的真 bug：`ipv4Scope(nil)` 曾落进 default 被当成「可用的 global」，
而 IPv6 的 `To4()` 正是 nil → 「只有 IPv6 的网卡」会被误判成有可用地址。

## 三层兜底（离线现场必须拿得到地址）
1. **严格轮**：接口 up 且非回环；
2. **宽松轮**：严格轮为空时不再要求 up 位（某些驱动/虚拟网卡读不到），命中标 `confidence: low`；
3. **默认路由探测**：两轮皆空时用 `net.Dial("udp4", …)` 问出本机源地址
   （UDP connect 只查路由表、不握手不发包，离线安全；TCP 会等 SYN 超时，不能用），标 `confidence: route`。
接口同时回 `scope`（private/global/link-local）与 `skipped`（被跳过的网卡 + 原因，
code 收敛为 no-address / only-ipv6 / not-up / loopback——link-local 不再是「被跳过」的理由）。

## 手填入口（最后一道保险）
自动检测不到、或不是现场要用的网段时，操作员把 `ipconfig` 里的地址填进卡片，
立刻生成链接 + 二维码；排在第一条、带「手动」徽标、可删除、localStorage 持久化、
四条就地校验文案（空/含空格/不像 IP/重复），IPv6 也支持。

## 自检工具
`debug/诊断/局域网地址自检.exe` + 说明：只读、不写文件、不需管理员，
打印系统给 Go 看的网卡列表（含类别）、默认路由探测结果与可用大屏地址。
（正是它把现场定性成 169.254 网段的。）

## 真浏览器验证（四场景，非源码断言）
链接本地地址出链接+二维码+说明句 / 空态列出被跳过网卡并折叠（5 条 + 等共 N 块）/
low 与 route 两种来源提示各占一行互不顶掉 / 手填地址排第一并刷新不丢 —— 全部通过，0 页面错误。

## 文档
使用手册 §9、部署指南 7.5/7.9、上线检查清单（**防火墙放行入站 19540** 与
「另一台设备能打开局域网大屏」两条新增）、常见问题 Q101、升级说明 dev_0.5.0；
devdocs 05/07/13 同步（含这次误判的来龙去脉与「Get-NetAdapter 显示 Up ≠ 有 IP」）。
**没有数据迁移**，旧赛事包照常导入。

自检：服务端 13 包 ×2；前端 vue-tsc + 680 例 ×2 + build；Console 20 文件 + 68 例。
 2026-09-12 18:30:46 +08:00
AskaEth 9ef68c2589 feat(console,admin): kiosk 不再点击穿透 + 压住任务栏；大屏控制页新增「局域网大屏」（链接/复制/二维码）dev_0.4.0 
## ① 现场问题：kiosk 窗口点击穿透（原设计方向反了）
`displays.js` 原来对多屏 kiosk 调 `setIgnoreMouseEvents(true)`，注释写的是
「防止现场误触」——但该 API 的语义是「本窗口忽略鼠标」，点击会**落到它后面的
窗口或桌面**，现场想防的误触正好变成误点别的东西；被忽略鼠标的窗口也点不活。
现在窗口**默认吞掉鼠标、不穿透**。

配置项**改名**为 `display.allowClickThrough`（缺省 false；显式 true 才穿透）。
**旧键 `display.ignoreMouse` 完全不读**——老机器的配置文件里还写着旧版模板留下的
`ignoreMouse: true`，而配置策略是「已存在不覆盖」，只改默认值等于老机器升级后
照样穿透；改名才能让默认值真正生效。启动时若发现旧键会记一条中文提示（只记一次），
并在合并后的配置里把它剥掉，防止将来有人再读到那个陈年 true。
（不是自动改写用户配置文件：无法区分「操作员刻意写的 true」与「旧模板留下的 true」。）

## ② 现场问题：任务栏盖住 kiosk 窗口、被盖住后抢不回前台
原顺序是 `setKiosk(true)` 之后又 `setBounds(...)`，在 Windows 上会把窗口从真正的
全屏态拽回「恰好铺满该屏的无边框窗口」→ 不是 topmost，任务栏与拖过去的窗口都盖得住。
现在固定为 **先 `setBounds` 定位 → 再 `setKiosk(true)` → 最后 `setAlwaysOnTop(true,
'screen-saver')`**（默认层级 `floating` 在 Windows 上仍画在任务栏下面），并加了
「已达标就不重复进出 kiosk」的守卫避免重排白闪；非 kiosk 分支会摘掉置顶。
Win 真机行为需现场复核，代码/桩级已验（含顺序与层级的断言）。

## ③ 新功能：大屏控制页「局域网大屏」卡片
- 服务端新增 `GET /api/system/network`（recorder 及以上）：回本机可用局域网 IPv4
  （排除回环/link-local/IPv6，去重，按 192.168/10/172.16-31 优先排序）+ 真实监听端口
  + 路径；无地址回 `[]` 不报错。
- 卡片：每个地址一条可点击链接 + 复制按钮，第一个地址配二维码（148px）。
- **二维码是离线自实现的纯 TS 编码器**（版本 1–40 自动、ECC L/M/Q/H、8 种掩码择优），
  正确性用 **Python OpenCV 真解码**验收：29/29 条解出原文（含中文与边界），
  SVG 渲染后再解码 4/4，并把验证过的矩阵冻结成仓库参照用例。
- 复制按**非安全上下文**处理：面板常从 `http://192.168.x.x` 打开，那里
  `navigator.clipboard` 是 undefined，自动回退 `execCommand('copy')`。

## ④ 真机联调抓出并修掉一个时序缺陷（真浏览器 + 真服务端）
`DisplayPage` 的 `refreshLan()` 在挂载时跑，而 `auth` 是异步加载的——那一刻
`auth.readOnly` 必然为 true，卡片把「当前为只读访客」写进一个**普通 ref** 就返回了，
身份落定后没有任何东西再触发它：**管理员登录后卡片永远停在访客态，
`/api/system/network` 一次都没被请求**。
改为「gate 由 computed 直接渲染 + watch gate 变 null 时重跑加载」，并补回归钉子。
（同时修正了一条把该错误结构当成正确行为的源码断言用例。）
端到端证据：真服务 + 局域网 IP（真非安全上下文）→ 卡片列出两个地址、点击复制变
「已复制」（走 execCommand 回退）→ 浏览器渲染的二维码截图经 cv2 解出
`http://10.50.101.85:19861/display`。

## 文档
部署指南配置表与多屏行为、使用手册「大屏控制」与局域网设备段、devdocs 05/07/10/13、
升级说明新增 dev_0.4.0（含旧键废弃与启动提示）。**无数据迁移**，旧赛事包照常导入。

自检：服务端 13 包 ×2；前端 vue-tsc + 645 例 ×2 + build；Console 20 文件 + 68 例。
 2026-09-12 16:25:04 +08:00
AskaEth ed2c0b3f3c feat: 主人拍板的 4 条全部落地（单条作废/重录、破纪录驳回、历史纪录、仪表盘卡片）+ 迁移 0021（dev_0.3.0） 
## ① 成绩「作废本条 / 重新录入」——手滑填错了怎么办
- 新增 `POST /api/results/{id}/reopen`：把已发布的那条退回草稿（state=draft、
  status=ok、rank=NULL、note=原因）并重算推榜；口径与既有 `void` 完全一致
  （回滚类动作，不受 `standings.live_on_publish` 约束）。
- 成绩录入页新增「操作」列：已发布行可「作废本条」，已作废行可「重新录入」，
  两者都必填原因、确认后立即重算+推大屏。**验收用例**：作废→重录→改→重发，
  名次/流水/榜单与「一开始就填对」逐字节一致。

## ② 破纪录的驳回 / 作废
- 迁移 `0021_record_breaks_note.sql`：`record_breaks` 加一列可空 `note`。
- 新增 `GET /api/record-breaks?state=`（recorder 起可读，guest 403）与
  `POST /api/record-breaks/{id}/reject`（必填原因）：已批准的登记被作废时
  **撤回该笔加分、重算推榜、并把该级别当前纪录恢复为上一条**；`approve`
  放开为可对 rejected 再次批准。
- 破纪录页新增「已批准的破纪录」卡片（作废入口）；原先只存在浏览器内存里的
  「拒绝」改为持久化（先登记再驳回，刷新不再复现）。

## ③ 历史纪录的写入路径（`records.source` 以前恒为「本届」）
- 新增 `POST /api/records`（source 只收 history）与 `DELETE /api/records/{id}`
  （删当前纪录时恢复上一条）。纪录库卡片新增「新增历史纪录」与「删除」。
- 至此《使用手册》6.2 承诺的「来源（本届/历史）」这一列才真正有意义。

## ④ 仪表盘补齐承诺的卡片
今天的小项（按 scheduledAt 的本地时区当天 + 进度）、草稿待发布、待确认破纪录、
大屏在线数；数据源读不到显示 `—` 而不是 0。文档里「管理端在线数」服务端没有
接口，按实际改写成本机管理端连接状态。

## 旧版数据包兼容（主人特别交代，三处验证）
迁移只加**可空**列、不重建表、不动数据行；旧赛事包导入后由 `main.go` 的
`store.MigrateEvent` 在启动时补跑迁移。证据：`migration_0021_test.go`
（旧库升级 + 幂等 + 老行取 NULL）、`migration_legacy_test.go` 扩到 0021、
`legacy_pack_upgrade_test.go`（真实旧 event.db 走 main 同一条路径后装配 API，
驳回老登记 → 加分撤回、纪录回退、旧数据逐表一行不差），另有真二进制冒烟。
未迁移的库上不存在任何新列读取。

## 文档
升级说明新增 dev_0.3.0（含「旧包仍可导入、自动补跑迁移」）；使用手册新增
§4.10 与 §6.1/§6.2 明细；常见问题新增 Q98/Q99/Q100；devdocs 04/05/07/13/02
同步（含新接口表与错误分级）。

自检：服务端 13 包 ×2 全绿（httpapi 新增 reopen/reject/records/旧包 四个用例文件）、
前端 vue-tsc + 604 例 ×2 + build、Console 19 文件 + 54 例。
 2026-09-12 01:27:09 +08:00
AskaEth 6841cf49aa fix(p2): 按审查清单修 103 条「建议修」+ 奖牌榜改名 + 两个守卫（dev_0.2.0） 
## 奖牌榜改名（主人要求）
「团体奖牌榜」→「单位奖牌榜」，界面 / 大屏渲染页 / 导出件（工作表名与
下载文件名 `单位奖牌明细.xlsx`）/ 用户文档 全部统一；`DISPLAY_PAGES` 是
大屏控制页与大屏页的共同来源，改一处两边同时生效。旧名保留为别名，
老链接与老配置（`display.pages`）照常有效。真 Chromium 验证：14 个管理端
路由 + 7 个基础数据分区 0 报错，大屏页标题已是「单位奖牌榜」。

## P2 清单（123 条，103 条标「建议修」）
按 A/B/C/D 分组、以「文件所有权互斥」分 10 个代理并行推进，另有独立复核
代理逐条核对：61 条声称已修 / 55 条证实 / 4 条部分 / 0 条不成立 / 0 垃圾。

主要交付（按风险从高到低）：
- 写入侧校验：update 路径补必填与 TrimSpace、模板 rules 重复 rank、
  「小项不存在」的四种回答、`defaultProfileId` 外键、decodeJSON 的 8MB
  上限与 413（A01–A06、D02、D03 批量上限 500）
- 危险操作：一键恢复加互斥（第二个请求当场 409）、恢复超时不再说
  「未执行」、`ConfirmDialog` pending 时锁死 ESC/遮罩/关闭
- 认证：改密与撤会话进同一事务、滑动续期写库失败不再假装成功、
  CSRF Cookie 丢失自动补发、密码长度按字符（原按字节）、
  反代 403 只在可信代理透传原 Host 时采信 `X-Forwarded-Host`（全等比较）、
  过期会话定期清理、登出补审计、登录限流可配
- 数据可见性：导出「已发布未结算」行改为 `名次 — / 积分 — / 状态未结算`、
  单位积分明细成绩列与其它导出件逐字一致、空单位也打合计行、
  基础数据包命中「已彻底删除的单位」整行跳过并报界面路径、
  报名导入换单位给明确提示、勾选报名有冲突不再假报成功
- 导入/导出：赛事包上限 512MB（**它是唯一带字体/图片的包**，字体上限
  20MB）而 multipart 内存档位独立钉在 16MB、工作簿表名尾随空格、
  导出件路由与文件名契约补全
- 前端：一次写请求只生成一个 requestId（幂等缓存此前从未命中）、
  基础数据包补 `X-Request-Id`、示例数据模式禁写扩到撤销发布/存草稿、
  访客 401 不再是裸错误、模板 `{{else if}}` 不再静默吞内容
- Console：按设计退出（切赛事/恢复）不再判成崩溃、旧数据目录读不出来
  会记日志、渲染层日志按上限截断、`service.js` 补 17 例测试

## 测试
服务端用例 610 → 674（13 包全绿，新增老库跨九条迁移升级、panic 形状、
429 落 interceptions、三态对照、avg_mode 分母、会话失效、请求体上限等）
前端 449 → 531（vue-tsc + build 通过）；Console 28 → 54（19 个文件）。
另修复一条会让整包挂死 600s 的用例（测试主协程堵在 client.Do，defer
轮不到执行 → 改为可取消 + 探针超时，改坏也 7.5s 快速失败）。

## 两个新守卫（防止再出现「组件 setup 抛异常」这类盲区）
- `web/scripts/check-declaration-order.mjs` 已进测试命令：沿 watch/
  watchEffect 的 const 依赖链查 TDZ（正是「运动员页整块空白」的根因）
- `web/scripts/smoke-admin.mjs`（`pnpm smoke`）：真 Chromium 点遍 14 个
  管理端路由 + 7 个基础数据分区 + 大屏页，任何 console 错误即失败

## 文档
- `docs/升级说明.md` 新增 dev_0.2.0 一节（三件升级必知：改名、审计前缀
  与历史记录、密码口径；现场变化；赛事包上限；反代与 CSRF）
- 使用手册 / 常见问题 / 部署指南 / 上线检查清单按实现同步
 2026-09-11 23:46:59 +08:00
AskaEth db94d9c119 test(web): 补两类守卫，专抓「组件 setup 期抛异常」这类既有测试抓不到的问题 
背景：基础数据「运动员」页整块空白的根因是 setup 期 TDZ（watch 注册时同步求值，
间接引用到后面才声明的 const），vue-tsc 与 449 条单元测试都没抓到——组件从不真正挂载。

1) scripts/check-declaration-order.mjs + src/shared/tests/declaration-order.test.ts
   静态检查：从 watch/watchEffect 的源出发沿 const 依赖链做传递闭包，
   任何声明行晚于求值行的 const 即判违规。已随既有测试命令运行（纯 node，无需浏览器）。
   变异验证：把 AthletesSection 退回 ab7662b 的写法 → 精确报
   「AthletesSection.vue:84 会求值到 filtered，但它声明在第 272 行」。

2) scripts/smoke-admin.mjs（pnpm smoke）
   真 Chromium 冒烟：14 个管理端路由 + 7 个基础数据分区 + 大屏页，
   任何 console 错误或未捕获异常即失败并给出路由名。
   变异验证：同一份代码下修复版通过、退回版报
   「/base-data › 运动员 ← ReferenceError: Cannot access 'Y' before initialization」。
   playwright 不是本仓库依赖（离线开发装不上），脚本缺依赖时会明确报错退出而不是假装通过。
 2026-09-11 22:58:19 +08:00
AskaEth 8a27f5a4fb fix(admin): 修复基础数据「运动员」页整块空白（TDZ 崩溃） 
AthletesSection 里 filteredIds 在第 73 行引用了第 272 行才声明的 filtered，
而第 84 行的 watch(filteredIds, ...) 在注册时会同步求值一次源（Vue 行为），
setup 阶段就访问到 TDZ 中的 filtered → ReferenceError:
Cannot access 'filtered' before initialization → 整个分区渲染失败，
页面只剩标签栏、下面全白。自 631c8dd（上一轮）起 dev_0.1.6/0.1.7/0.1.8 均带此缺陷。

修法：把 filtered 的定义上移到 filteredIds 之前（只依赖三个筛选 ref，上移安全），
并加注释说明为什么不能挪回去。

验证：真 Chromium（Playwright）逐个打开 14 个管理端路由 + 7 个基础数据标签，
console 错误与 pageerror 均为 0；「运动员」标签正常渲染出表格与空态。
版本 dev_0.1.8 → dev_0.1.9（热修，P2 批次另行发布）。
 2026-09-11 22:51:11 +08:00
AskaEth ab7662b7f1 docs: 新增《升级说明》（按版本记录改动与升级须知）+ 安装包随包带上升级说明 
- docs/升级说明.md：dev_0.1.8 的升级须知——「个人+团体」项目必须补录团体名次
  （旧版没有录入位置、团体分是拿个人名次顶替算的）、单位总分为何会变化、
  奖牌三层开关、即刻重算的动作清单、5 分钟核对表
- README 文档地图与《部署指南》3.4 加入口
- deploy/prepare-extra.mjs：把升级说明一并平铺进安装目录（升级说明.txt）
- debug/使用说明/：同步全部用户文档（含刷新旧的使用说明.txt 快照）
 2026-09-11 22:02:00 +08:00
AskaEth 45edfbeb71 fix: P0 计分根因 + 奖牌结算/奖牌通道 + 身份口径改回证件号 + 19 条 P1（dev_0.1.8） 
## P0：双通道项目重复发布跳分（45→85→收敛）
results.rank 一列同时充当「个人名次输出」「手工名次输入」「榜单数据源」，
团体手工通道把个人名次当团体名次又按团体表发一遍分。
- 新增 channel_ranks（每个计分通道各自持久化名次，发布时全量重建）
  与 channel_manual_ranks（按单位录入的团体手工名次，故意不挂通道外键，
  避免规则包重导时级联删掉录入数据）
- results.rank 语义收窄为「只表示个人名次」，只由 scope=athlete 通道写回；
  团体手工名次的来源改为 TeamRanks 优先、团体报名项兜底，
  个人报名项的名次绝不进团体通道
- writeLedgerTx 内重建 channel_ranks；buildRanked / export.loadRanked /
  realtime.loadRanked 三份同源 SQL 一起改读新表
- 回归：发布两次流水与名次逐字节一致（domain + httpapi 各一条，含变异验证）

## 奖牌结算开关与奖牌通道（P1(5)，新功能）
- events.award_medals + 通道 count_to_medals / count_to_team_medals
  （迁移默认 1，升级不改变既有榜单）
- 单位榜入选 = 小项结算奖牌 && 通道发奖牌 && 前三名 &&（团体项目 || 个人奖牌并入单位）
- 个人榜只取个人通道；金牌榜与积分榜同源同数据、按通道过滤独立计算
- 前端：小项「该项启用奖牌结算」、通道「发奖牌/个人奖牌并入单位金牌榜」、
  录入页新增「团体名次」区块（含新接口 GET/PUT .../team-ranks）

## 身份口径改回证件号（P1(15)，推翻第三十六轮）
- 匹配顺序恢复 证件号 → 号码布 → 姓名+单位；新增 athleteByIDCard
- 同表重复证件号 = 同一人报多个组别（notices 提示，不报错）；
  只有「同证件号 + 同小项同组别」才是真重复（conflicts[].duplicate）
- 补齐后端缺失但前端/文档已在依赖的三处契约

## 其余 P1
- 安全：会话撤销断开 ws、实时层按角色裁剪、整库快照限流（含 hello 路径，
  被限流的请求挂起并由心跳兜底补发，不丢刷新）
- 错误分级：手填名次非正数 / gender / 组别年龄 / 导出不存在的小项与单位 /
  积分模板 awardRanks → 400 或 404，不再 500
- 算分一致性：破纪录加分看得失状态；批量退赛·恢复·移出、作废成绩、
  报名导入改状态一律无条件重算推榜（不受延迟结算约束，与实时模式逐字节等价）
- 配置改动触发重算：通道 / 小项参数 / 积分模板
- 升级自愈：channel_ranks 空而已有已发布成绩时，启动时一次性全量重算
  （服务对外监听之前完成，避免升级后奖牌榜全 0）
- 示例数据模式下破坏性操作被阻断，不再假成功
- Console：修复「只剩一块屏」后屏幕监听器被永久摘掉
- 大屏模板引擎：嵌套深度与体积安全阀，任何输入都不抛异常

## 文档
- docs/：使用手册（奖牌开关、奖牌通道、团体名次、枚举列留空口径）、
  常见问题（奖牌排查、升级后奖牌榜为 0、历史重放已知限制）、
  部署指南、上线检查清单
- 版本 dev_0.1.7 → dev_0.1.8（console/package.json 同步）

自检：服务端 13 包 ×2 全绿；前端 vue-tsc + 449 例 ×2 + pnpm build；
Console 35 例 + 语法检查。
 2026-09-11 21:47:07 +08:00
AskaEth 53a0cb225c feat: 备份恢复 / 图片清理 / 单位恢复 / 审计过滤 / 模板引擎 M1 + 两个导入缺陷修复 
用户点名的三件事（模板功能、删死代码、剩余缺口）这一批全部落地，另修掉两个刚暴露的导入缺陷：

**新增能力**
- 备份恢复：`POST /api/backup/restore`（admin）。先把校验做在拍快照之前（只读打开 + integrity_check +
  关键表校验 + 异类库标志表互斥），再用 VACUUM INTO 拍「恢复前安全副本」，然后关连接、整文件替换、
  触发优雅重启；`-wal` 还在时直接拒绝（宁可失败也不让旧库 WAL 套到新库上）；恢复后审计直写"恢复之后
  还在的那份库"（不走通用 Auditor，否则记录只会落在被替换掉的旧文件上）。顺带修掉：裸服务端连续恢复
  第二次会在拍副本处崩出一句看不懂的 500，现在回 503「上次恢复后尚未重启，请先重启服务端」。
- 安全副本保留策略：每类库保留最近 5 份，独立于 .db 的 20 份滚动清理。
- 图片管理：`DELETE /api/uploads/{name}`（被引用 409 并列出引用点）、`GET /api/uploads/orphans`、
  `POST /api/uploads/orphans/delete`（只删列出的孤儿，宁漏勿误），全部 admin（与字体删除同档）；
  `deploy/backup.bat` 补上 uploads/ 归档（logs 不归档：可再生的诊断且会无上限增长）。
- 已彻底删除单位的恢复：`POST /api/teams/{id}/restore`（与 hideTeam 同档）。幂等；恢复不会把「停用」
  变成「启用」；真机确认恢复前后榜单逐字节一致、change_log 最大值不变（数据一行没动，不需要重算）。
  界面加「显示已彻底删除的单位」（仅 admin）与恢复按钮；非 admin 的删除确认框里写明"本账号无法自行恢复"。
- 审计日志按 `action` 过滤（子串模糊，输入里的 %/_/\ 转义成字面量）。
- 删除死表 recent_projects（新增 system 迁移 0006，未动已应用的迁移）。
- points_override 不再"设了没效果"：写入侧 400 + 引擎侧守卫，提示改用「积分调整」。
- 联队份额空壳清理（UnionAttribution/UnionSplit/Entry.TeamShares/resolvedShares 等；TeamShare 类型保留，
  因为 export/realtime/奖牌流水三处在生产路径上构造它）。
- 自定义大屏模板 M1：插值引擎（parseTemplate/renderTemplate），任何情况都不抛异常、未定义→空串+警告、
  警告按 (code,path) 合并计数、无 eval/innerHTML，57 个新用例。

**两个真缺陷（前两个已随 0.1.6 出包）**
- 基础数据包导入「排序」列口径不一致：小项/组别留空保持原值，单位/大项留空被写成 0（plan 没从库里
  现值起手）→ 四张表统一为「留空保持原值」。
- 同类第二处：布尔列「整列被删掉」被当成"取默认值"，会把库里所有停用的单位/大项静默改回启用 →
  改为「缺列 = 不动」（写侧与解析侧都收口，补了"缺列保持/空格子=是/显式否=停用"三组对照用例）。

**删死代码**
- createEntry / updateEntry / deleteEntry / entryEventID / checkCategoryInEvent / getEntry /
  normalizeEntryStatus / ExportBaseDataXLSX（全仓 grep 零引用）。⚠️ 随之记入文档：「组别必须属于该小项」
  这道校验现在只由导入路径"按小项+组别名解析"天然保证，将来若新增从请求体接收 categoryId 的接口，
  必须自己补校验（库层没有复合外键）。

**文档**
- devdocs 全面同步（01/02/03/04/05/06/07/09/11/12/13/README；含身份口径、延迟结算、大屏单栏新版式、
  新增路由与设置键、R18/R19 风险）；docs 复核 + 第二轮（身份口径三个易写反的分支、图片删除、备份覆盖、
  审计过滤、单位恢复、去掉硬编码版本号、上线检查清单 +5 项）；debug/使用说明 6 份逐份 diff 一致。

测试：服务端 13 包（连跑两遍）、前端 406 例、Console 28 例 + 18 文件语法检查 —— 全绿。
版本号 dev_0.1.6 → dev_0.1.7。
 2026-09-11 19:26:36 +08:00
AskaEth 631c8dd8e1 feat: 8 条功能 + 身份口径改为号码布为准（含批量退赛/移出、基础数据导入导出、登录有效期） 
用户给出的 8 条功能 + 一条口径变更，全部带真机/真浏览器验证：

① 录入页姓名后直接显示号码布（原「号码」列保留）
② 录入页批次进度条：`第 2 批 已录 5/8 · 3 条有错`，录完变绿；已录判据复用
   entryGuards.judgeEntryRow（与发布防呆同源，不会出现"进度条说录完、发布说缺 8 条"）
⑦ 小项列表双击 → 跳到该小项的组别（编辑/删除按钮不误触）
③ 赛事开关 `standings.live_on_publish`（默认开＝保持原行为）：关闭后分批发布只上屏成绩，
   名次/流水/榜单一起等该组录完再结算 —— 代理实读代码后纠正了我的前提：
   奖牌榜读的是 results.rank（buildRanked）而非流水汇总，只延迟流水会出现
   「有金牌但 0 分」。另提供 POST /api/results/settle 人工兜底 + GET /api/results/settlement 未结算清单
④ 组别「就地更新」PUT /api/events/{id}/categories/{categoryId}：有报名数据时也能改名/改年龄/
   改性别/改权重（旧路径是整表替换，一改就被 409 拦下）；改名不动报名/成绩/流水（真机逐字节比对）；
   权重真的变了才触发该组重算（容差 1e-9）
④辅 运动员列表多选+全选，POST /api/athletes/batch 一次请求完成整批停用/彻底删除（逐条回报，
   dryRun 预览走同一段 SQL 但不提交、不写审计）——这才是绕开限流的正解
新增 报名项批量：POST /api/entries/batch（scratch/restore/remove）。退赛只动 registered、
   跳过 dq/dns 并说明原因；移出是物理删除，必须显式清 score_ledger（该表 entry_id 是
   ON DELETE SET NULL，不显式删会留下"人没了分还在"的孤儿流水，验证基线 orphan=0）；
   退赛同时清 results.rank（否则出现"0 分还挂着金牌"）
⑤ GET /api/export/entries.xlsx 报名名单导出（13 列含批次，状态中文与录入页逐字一致）
⑥ 基础数据包：GET /api/export/basedata.xlsx + POST /api/export/basedata/import
   （四张表、表头只有一份定义、表头行自动定位、列缺席≠写空、按编码 upsert、绝不删除、
   行级中文错误带真实 Excel 行号、枚举走既有校验、新增单位一定是启用）
⑧ 登录有效期面板可配：系统设置新页签，1–720 小时，默认 12h → 24h；滑动续期 +
   Cookie 同步刷新（只服务端续期是假的，浏览器侧的 Max-Age 到点仍会丢 Cookie）
身份口径：号码布为唯一标识、证件号退出匹配（号码布不同=同名的两个人，新建并单独报告）；
   同一份表重复证件号不再报错；两个不同的人共用证件号仍报行级错误（唯一索引保留）

其它对齐：分项成绩表草稿行不再消失（成绩列「分数未录入」、名次/积分 `—`，没成绩的行同占位）；
大屏实时赛况单栏铺满（留白 370→78px）、字号上限 56→96px、≥7 行自动拆左右两块；
删除报名项/退赛/权重等改动都会重算并推榜单。

测试：服务端 13 包（连跑两遍）、前端 335 例、vue-tsc + build、Console 18 文件 —— 全绿。
文档：README、docs/ 四份（含 debug/使用说明 副本）、devdocs 05/08/04/13。
版本号 dev_0.1.5 → dev_0.1.6。
 2026-09-11 17:14:02 +08:00
AskaEth 8dd599bd97 fix: 实机复测六批发现的 16 条缺陷（导入编码静默错误 / 导出观感 / 错误分级 / 大屏裁切） 
先把「实机复测」能在这台 Linux 机器上验的全部自己验掉（真服务端 + 真 Chromium + 真样本），
六批全部通过，另挖出 16 条缺陷，逐条修完并复验：

导入
- 坏字节被静默替换成 U+FFFD 却报「组别不存在」→ 检测 RuneError 回 400 + 可操作中文文案
- UTF-16 无 BOM 误报「缺少列 event_code」→ 保守判据识别并正确解码
- CSV 语法错只有英文 → 中文提示，英文原文保留在 detail
- 表头缺列补「第 1 行应是表头」的指向

导出
- 名次列宽 8 → 11（放得下「3（并列）」，Excel 里不再硬裁）
- 运动员/队列宽 18 → 24（含奖牌明细的同一列）
- 聚合流水行补组别（仅单位在该小项只参加一个组别时回推；多组别宁可留空也不猜）
- docProps 作者从 excelize 默认的 xuri 改成中性名 + 真实导出时间
- Content-Disposition 补 ASCII 退化 filename（9 个下载端点，含此前没有测试的 project.zip）

错误分级与限流
- 未知大屏指令 500 → 400 VALIDATION_FAILED（传输层真失败仍走 5xx）
- 5xx 的 ERROR 日志补 role / ip（4xx 的 WARN 一直有）
- 写限流 30 → 120 次/分钟/用户（登录 5 次/分/IP 不动，性质不同）
- 赛事名含非法字符时导出给 400 + 可操作提示（原来永远 500「服务端异常」）

大屏与基础设施
- 实时赛况 2 栏成绩末位被裁（1:09.00 显示成 1:09.0）→ 成绩列按内容定宽 + nowrap；
  字号不缩，让位给可省略号截断的运动员列。真 Chromium 实测 slack −45px → +6px、0 裁切、
  scrollWidth 恒 1920（无横向滚动条）；顺带修掉 1 栏长成绩同样被裁 8px 的问题
- logging 启动即预建两个日志目录（原来 interceptions/ 懒创建，现场会以为日志坏了）
- C→S 裸帧由静默忽略改为 WARN，并把「要套 {event,data} 外壳」写进日志
- 建单位/大项漏传 active 不再静默建成「停用」（新增 decodeJSONPresence 按键是否存在判意图）

文档
- README 单位 logo 措辞收窄到「大屏端」（管理端只负责上传配置）
- 导入规范补三类编码报错说明 + 现场另存结论 + 限流提示
- 部署指南补「导出前先看赛事名称」与「切换后怎么确认真的切过去了」
- devdocs 05/08/13 同步（含第三十五轮的完整记录与教训）

自检：服务端 13 包连跑两遍全绿；前端 257 例；vue-tsc + build 通过；Console 18 文件。
版本号 dev_0.1.4 → dev_0.1.5。
 2026-09-11 15:35:42 +08:00
AskaEth a52e6a4a3b fix: 5xx 的 detail 留在响应里，改为补日志侧留痕（自我纠正） 
前一个提交按 §4.2 的旧判据「internal(err) 把原始错误串写进响应 detail（应仅日志）」
把 5xx 的 detail 去掉了。这是改错了方向，本提交翻回来：

- 管理端 describeError()（systemApi.ts:85）是故意把 error.detail 拼进提示的，
  EventInfoPanel / UsersPanel / FontUploadField / ImageUploadField 等 5 处都在用。
  录人员常常在局域网平板上操作，够不到服务端控制台的日志面板——去掉 detail
  等于把失败原因藏在他拿不到的地方。
- 旧判据还漏了：原来真正的缺口不是「响应里有原文」，而是「日志里没有原文」。
  正确修法是补日志，不是砍响应。
- 现口径：两边都要。apiError.detail 与 apiError.logDetail 是两个独立字段
  （一个管回不回前端、一个管日志记什么），5xx 目前两者都设；要收口时只把
  detail 置 nil 即可，日志线索不受影响。
- 测试 TestServerErrorKeepsRawReasonOutOfResponse 改名并反转断言为
  TestServerErrorCarriesRawReasonToClientAndLog：同时断言响应 detail 带原文、
  ERROR 日志也带原文。

版本号 dev_0.1.3 → dev_0.1.4（0.1.2 / 0.1.3 均未交付，debug/ 只留 0.1.4）。
 2026-09-11 14:46:10 +08:00
AskaEth b4bdaef9ba fix: 健康检查探库超时 5s → 1s（Console 探活超时只有 2500ms） 
上一版把探库超时写成 5s，比 Console 的探活超时（console/main/service.js:389
的 timeout: 2500）还长。数据库是单连接，备份 VACUUM INTO 或整包重算占住连接时，
探针会等满 5s，于是整个 /api/health 请求超时，Console 把服务标成「未就绪」——
状态灯变红、托盘提示异常，console/main/index.js:671 在未就绪时还会跳过大屏重排。
为了「避免误判健康」加的探库，反而制造了另一种误判。

- healthProbeTimeout 5s → 1s：正常 SELECT 1 是亚毫秒，走满超时只可能是连接被占。
- probeDatabases 返回三态 ok / busy / error：busy 表示超时前没拿到连接（未必是故障，
  多半是备份或重算占着），error 才是真报错，两者分的错因不同，别混成一句话。
- 新增 TestHealthProbeStaysBoundedWhenDatabaseBusy：用事务占住赛事库唯一连接，
  断言 /api/health 仍回 200、db:"busy"、耗时 < 2000ms（这个数就是挡住超时被调回 2.5s 以上的护栏）。
- 更正一处写错的理由：状态码保持 200 与「避免重启循环」无关——setHealthy(false)
  只改状态与 UI，重启只发生在进程真的退出时（service.js 的 handleExit）。真正理由是
  前端 health() 见到 ok:false 会抛错，「关于」页会显示「未知（/api/health 不可达）」，
  一次数据库抖动不该让界面宣称版本未知。

版本号 dev_0.1.2 → dev_0.1.3。
 2026-09-11 14:42:57 +08:00
AskaEth 44353b2c4c chore: 版本号 dev_0.1.1 → dev_0.1.2（本轮缺陷修复批次） 2026-09-11 14:28:36 +08:00
AskaEth 2c983bcfdf fix: 枚举入参校验(500→400)、5xx 错误串不再外泄、健康检查探库、限流键清理 
服务端一批「会误导现场」的缺陷，全部补了测试：

- 枚举型入参（events 的 event_type/result_mode/result_type/compare/status、
  scoring_profiles 的 tie_mode/record_bonus_mode、entries.status、results.status）
  过去完全没有校验，非法值一路落到 SQLite 的 CHECK 约束，被统一错误处理当成
  服务端异常报成 500；现在统一在 enums.go 拦成 400 VALIDATION_FAILED，
  message 带字段名与合法取值、detail 带原始输入值。空值仍走原来的默认值。
- 5xx 响应体不再回显内部错误原文：新增 apiError.logDetail，SQLite / 引擎的
  原始错误串只进 ERROR 日志的 detail 字段。此前正好是反的——前端拿得到原文，
  日志里只有「服务端异常」。同时校准 newAPIError / internalMsg 的 skip 层数，
  拦截点不再退化成 response.go 里的构造函数。
- /api/health 新增 db / dbError：用 SELECT 1 探库（Ping 探不到「文件在、库读不动」），
  超时 5s 与 busy_timeout 同量级。状态码仍恒 200 —— Console 拿状态码当存活信号，
  数据库故障时回 5xx 只会变成重启循环，两个事实分两个字段表达。
- 修改密码时原密码错误由 401 改为 400 AUTH_FAILED（新增 wrongCredential）：
  401 的语义是「本请求没有有效会话」，而这里会话是好的。
- 限流 hits map 在键数超过阈值时清理窗口内已无记录的键（窗口内活跃的键不动，
  否则堆键数就能冲掉别人的计数）。
- createEntry / updateEntry 拒绝「A 小项的报名挂在 B 小项的组别上」。
  数据库层仍无 (event_id, category_id) 复合外键（重建 entries 会牵动 results /
  score_ledger 的级联，风险高不做），这一层先兜住。
- 补测试：枚举字段逐项正反例、CSRF 反向用例、写限流 429、健康探库（含库故障）、
  5xx 不外泄原文、限流键清理不误删。
 2026-09-11 14:28:25 +08:00
AskaEth 23fee5b818 docs: 使用手册的表头列清单补上 heat（11 列 → 12 列） 2026-09-11 04:18:03 +08:00
AskaEth 0485975cd1 docs: 用户文档补齐批次层/成绩框实时提示/窄屏支持/版本号来源/权限说明 2026-09-11 04:17:40 +08:00
AskaEth 08a5740fb2 feat: 分批发布 + 实时赛况页 + 显式批次层 + 成绩框实时提示 + 窄屏适配 + 版本号单一真相 
## 分批发布（现场：100 米跑道只有 8 条，不能等所有人跑完才发）
- 空成绩从"错误"降级为"提示"，不再阻塞发布；真会算错（写法无法识别、秒位 ≥ 60、
  手动名次缺名次）仍挡住。发布确认框说明"只发已填的 M 人，其余保持未发布"。
- 服务端核实：publishResults/computeEventScore 本就不会因缺成绩报错
  （collectCandidates 直接跳过没有 results 的报名项），根因在前端防呆。

## 实时赛况（新大屏页 + 定向接口）
- 新增 `GET /api/display/live`（guest 可读）：返回「当前项目」判定 + 该项目**全量**已发布成绩
  （不受快照 latestResults 的 20 行截断）。回退链：manual 指定 > 排期命中 > 最近发布。
  设置键 display.live_events / display.live_source。
- 大屏新页 `live`「实时赛况」：1 个项目单栏、2 个自动左右分栏；失败保留上一次画面
  （下一场开始前持续显示上一场）；30s 轮询（判定依赖当前时间）+ 快照变更触发。
- 管理端「大屏控制」新增「实时赛况」卡；该卡走 PUT /api/settings（admin-only），
  故对非管理员整组置灰 + 提示条（不新增角色）。

## 显式批次层（组别之下）
- 迁移 0019 `entries.heat`；批次仅是录入/展示分组，**不参与算分**（有"分批与不分批结果
  完全一致"的断言守住）。批量设置接口 + 导入 CSV 可选列 heat + 录入页批次下拉 +
  一键均分（按 N 人切片，已有批次号接着往后排）。

## 成绩输入框实时悬浮提示
- 聚焦格旁的浮动气泡：pointer-events:none、不占布局不改行高、贴底自动上翻；
  合法显示解析结果（1:06 → = 66 秒）、可疑/不合法显示原因并带那一格原文；
  与发布防呆共用同一套纯函数（entryGuards.ts），口径不会分叉。

## 窄屏 / 手机端布局
- 真浏览器（Playwright + chromium）在 1440/1024/768/390 四宽度逐页审计 + 溢出探针，
  四轮迭代修复；桌面端 1440 前后像素差异 < 0.25%（无回归）；修掉如「修改密码」输入框
  塌成 22px 这类真问题。

## 版本号单一真相
- 新增仓库根 `VERSION`：构建时注入二进制（-X main.version）并同步 console/package.json
  的版本（产物名跟随）。源码里不再有人工维护的版本号（兜底值改为 `dev`，故意不写数字）。

测试：服务端 13 包全绿；前端 vue-tsc 通过、249 例全过；Console 18 文件。
docs/ 与 devdocs/ 同步（FAQ 到 Q80、新增 devdocs/16 自定义大屏模板设计文档）。
 2026-09-11 04:05:02 +08:00
AskaEth e5e0944d26 feat: 分级拦截日志 + 两类日志文件；成绩录入防呆/解析/宽度修复 
## 日志（用户要求：分级 + 每个拦截都要有指出代码行的调试日志 + 两类文件）
- 新增 internal/logging：拦截点捕获（file:line + 函数名，相对路径）、两类文件轮转、
  按级别/类别分流。httpapi 与 middleware 各自薄封装，无循环依赖。
- 两类目录（数据目录下）：
  operations/     放行类（INFO「操作已放行」+ 常规运行日志，按 log.level）
  interceptions/  拦截类（WARN 中文原因 + 拦截点 + method/path/actor/role/requestId、
                  DEBUG 上下文、ERROR 服务端异常）—— **固定 debug 采集**，
                  否则默认 info 下"每次拦截的调试日志"根本看不见
- 命名 operations-YYYYMMDD[.N].log，按天+按大小轮转，每类保留 keepFiles 份；写盘失败
  降级只写控制台且只 Warn 一次。
- 所有业务错误统一走 newAPIError 捕获拦截点（11 处内联 &apiError{} 已收进构造函数，
  防止绕过）；中间件层拦截（401/403/CSRF/未改初始密码/429）也留痕，响应体与状态码一字未变。
- config.yaml 的 log 段新增 dir / maxSizeMB / keepFiles（留空即默认）。
- 服务端包数 12 → 13（新增 internal/logging）。

## 成绩录入（用户实机踩坑）
- 真因一：成绩格 placeholder 是光秃秃的 `1:06.33`，而全仓库没有任何 ::placeholder 样式，
  示例文本与真实输入长得一样 → 用户把灰字当成已填内容，那 13 格其实是空的。
- 真因二：2 条报错是秒位 ≥ 60（1:70）或全角冒号（1：06）；1:06 与 1:06.00 在解析器里
  本来就等价（都 = 66），格式不是问题。
- 真因三：成绩格没有宽度定义（旁边名次 72px、状态 110px 都有），被挤到第 4 位数字看不见。

修复：parseSecondsDetail 区分 empty/seconds-overflow/unrecognized；新增 entryGuards.ts
纯函数（录入页与审核页共用），报错**打出那一格的实际内容**并说明原因；解析器新认全角
冒号/全角数字/1分06秒 等写法；成绩格 min-width 112px（按 fontTools 实测文本宽度定）；
示例文本改 `例 1:06.33` 等并给录入表格内的 ::placeholder 加淡色斜体；新增
onBeforeRouteLeave 离开守卫（原来切菜单会静默丢未保存成绩）。

测试：服务端 13 包全绿（372 个测试函数）；前端 vue-tsc 通过、205 例全过；Console 18 文件。
docs/ 与 devdocs/ 同步（FAQ 到 Q76，部署指南新增第 10 节「服务端日志与拦截复盘」）。
 2026-09-11 01:59:58 +08:00
AskaEth 8e707e1e9b feat: 团体奖牌 / 个人积分两个榜单的专属明细导出 
用户答复「允许细化」——给另外两个榜单各做一份逐项来源导出（此前它们的「明细」共用
单位积分明细、个人榜连明细列都没有）。

- `GET /api/export/medals.xlsx` → `团体奖牌明细.xlsx`：总表 单位/大项/小项/组别/名次/奖牌/运动员-队
  + 每个有奖牌的单位一张分表（末尾小计 金X/银Y/铜Z）；无奖牌的单位不出分表。
  去重与牌色判定**完全交给 domain**（每组调 domain.BuildMedalStandings），导出侧只做
  「同一报名项归一组」，不复制任何计奖规则——双计通道只记一枚奖牌因此自动成立。
- `GET /api/export/athletes.xlsx` → `个人积分总明细.xlsx`：总表 单位/运动员/大项/小项/组别/
  名次/成绩/得分/来源 + 每个有得分的单位一张分表（按单位分，不按人分）。
  得分取**记到个人的原始分**（与个人积分榜同一口径，不看 count_to_team、不乘折算系数）。
- 管理端三个榜单的卡片头各一个导出入口（导出总明细 / 导出奖牌明细 / 导出个人明细），
  展开单位时明细卡头是「导出该单位明细」；导出页仍是 5 项，两个新导出只在积分榜页触发。

护栏（跨端点一致性，都有实测断言）：
- 奖牌明细逐单位与「团体奖牌榜」对齐，双计项目只出一行；
- 个人明细合计与「个人积分榜」一致，且把折算系数改成 0.5 后个人明细一分不变、单位总分变 5。

测试：服务端 12 包全绿（358 个测试函数）；前端 vue-tsc 通过、190 例全过；Console 18 文件。
docs/ 与 devdocs/ 同步（FAQ 到 Q72，含上一轮"个人积分榜不能导出"的修正）。
 2026-09-11 01:17:14 +08:00
AskaEth 782a38f82f feat: 大屏控制可看局域网设备并逐台切页 + 两种新导出（单页成绩 / 单位积分总明细） 
## 大屏控制（用户：管理面板只能看到本机显示器，看不到局域网设备；也不能给某块屏单独切页）
- 服务端：`POST /api/display/command` 新增可选 `targets []string` —— 空 = 广播（公告语义不变），
  非空 = 只发给点名的实例并返回命中数；命中 0 个返回 404 +「目标大屏已离线，请刷新在线列表」
  （不落审计、公告也不落库）。`DisplaySender` 签名随之扩展，新增
  `Hub.SendCommandToInstances`（与按房间的 SendCommand 并存）。
- 服务端：WS `hello` 新增可选 `screen`，`realtime.Instance` 新增 `Screen`（不带 omitempty，
  局域网浏览器恒为空串），这样管理端能把「本机显示器」与「在线实例」精确对上。
- 管理端「大屏控制」：写死的「在线看板」占位换成真实列表（5 秒轮询、页面隐藏停表），
  列出实例 id / 在线离线 / 落后 / 屏号或「局域网浏览器」/ 当前页 / 来源 / 心跳；
  每行可单独切页；本机显示器卡片补「当前页」与逐屏切页；离线时控件置灰并说明原因。
  页面下拉改为共用大屏那份页名清单（管理端两处标签随之变为「个人积分奖牌榜」「分项成绩」）。

## 导出（用户：保留多页工作簿的同时，再要一种全平铺单页；积分榜明细也要能导出）
- 新增 `GET /api/export/all-flat.xlsx` → `赛事成绩总表（单页）.xlsx`：一个工作簿一张表，
  列 = 大项/小项/组别/名次/号码/单位/运动员-队/成绩/积分/状态/备注；前三列取
  `EventSheet` 的结构化字段（不解析标题），后 8 列就是 `eventColumns` 本身（append 拼出，
  两处不可能漂移）。**既有「全部」（all.xlsx，多 sheet）一字未动。**
- 新增 `GET /api/export/teams.xlsx` → `单位积分总明细.xlsx`：一张带「单位」列的总表 +
  每个有明细行的单位一张分表；**无明细行的单位不出分表**（空表没信息量，且会把假删除的
  隐藏单位名字重新印进导出件）；已隐藏但有流水的单位照常出表（它在榜单上）。
- 积分榜页：页头「导出总明细」、单位明细面板「导出该单位明细」；导出页新增「全部（单页）」。

测试：服务端 12 包全绿 / 347 个测试函数；前端 vue-tsc 通过、184 例全过；Console 18 文件。
docs/ 与 devdocs/ 同步（含新增 Q65–Q70 与两轮进度记录）。
 2026-09-11 00:44:03 +08:00
AskaEth 793d2ac064 fix(console): 修「全屏时反而画标题栏」——窗口模式必须与 URL 的 windowed 一致 
用户实机反馈：单屏窗口化窗口按 F11 全屏后标题栏不消失，退回窗口化反而没标题栏，
表现与预期完全相反。

根因不在标题栏，而在 Console 侧的窗口模式管理：entry 没记录窗口是以什么模式建的，
layout() 每次排布都拿「整机是否单屏」的 single 去覆盖每个已存在窗口的几何与模式
（!single 时会 win.setKiosk(true) + 铺满），而页面 URL 里的 windowed=1 是建窗时定死的、
loadPage 只在页码变化时才重载 —— 于是窗口的真实模式与页面认知脱钩：
窗口化窗口被改成 kiosk 全屏而 URL 仍带 windowed=1（全屏却画标题栏），反向亦然。

修复：建立并保证「窗口几何/模式 ↔ URL 的 windowed 必须永远一致」
- entry 记 { win, page, single, manual, reloadTimer }
- createWindow(..., manual=false)；openOn() 传 manual=true（手动开的窗口不被排布改模式）
- layout() 的 existing 分支：target = manual ? entry.single : single，applyGeometry 与
  loadPage 都用同一个 target，且 modeChanged || page 变了都要重载 URL
- 删掉 isKioskWindow()（用 isFullScreen() 反推会把「窗口化窗口被 F11 全屏」误报成 kiosk），
  换成 modeOf(entry)
- F11 通信时序：enter/leave-full-screen 回调里不再回读 win.isFullScreen()（切换瞬间可能读到
  旧值，页面会收到相反状态），改为下发事件本身的确定值；F11 直接下发算出来的 next

回归测试 console/main/displays.test.js（8 例，assertModeConsistent 四处自洽）。
反向对照：修复前的 displays.js 跑同一份测试是 1 pass / 7 fail。
Console 语法检查 18 个文件、node --test 28 例全过。
 2026-09-11 00:13:09 +08:00
AskaEth 5ae49b001c feat: 参赛单位「彻底删除」= 假删除（界面隐藏，数据与榜单全保留） 
与运动员的真物理删除是**两套相反口径**，有意如此（两个按钮同名，代码与
文档里都做了显著区分）：

- 运动员 `?purge=1`：真删人员+报名+成绩+流水并重算积分（上一版 `9d4ee09`）
- 参赛单位 `?purge=1`：只置 `teams.deleted_at` + `active = 0`，让单位从列表里
  消失；报名、成绩、积分流水、人工调整、纪录、名下运动员全部原样，
  **不触发重算、积分榜不变**（单位下挂着几十号人，真删代价太大）

实现：
- 迁移 0018 `ALTER TABLE teams ADD COLUMN deleted_at TEXT`
- `listTeams` 默认排除已隐藏单位；`?includeDeleted=1` 仅 admin；
  `GET /api/teams/{id}` 对已隐藏单位：admin 200 / 非 admin 404
- 审计 `team.purge`（detail 标明是隐藏）；成功走 `writeVoid`（无统计对象）
- 报名导入按 `team_code` 命中已隐藏单位时复活（清 deleted_at、置 active=1）
- 故意不过滤的地方都加了注释：榜单补单位名、写路径与审计、导入按 code 查、
  赛事包导出、大屏快照、按 team_id JOIN 取历史单位名——过滤会让历史成绩的
  单位名变空白或让包的引用悬挂

管理端「参赛单位」行加「彻底删除」按钮 + 危险确认框（如实写明"从列表移除、
数据不受影响、积分榜不会变化"），失败原文展示、404 不降级。

顺带修一处界面文案与行为不符：单位页原写「停用后新报名不再可选该单位」，
但报名选择器其实仍会列出已停用单位供手动勾选（只有「全选」跳过它们），
已按真实行为改写（两处）。

测试：服务端 12 包全绿（新增 team_purge_test.go 与 0018 迁移用例）；
前端 172 例全过（新增 team-purge-api.test.ts 6 例）。docs/ 与 devdocs/ 同步。
 2026-09-10 23:48:28 +08:00
AskaEth 9d4ee0946c feat: 运动员彻底删除（真物理删除 + 重算积分）+ 报名表 status 容错 + 部署包带导入规范 
## 运动员「彻底删除」＝ 真删除
`DELETE /api/athletes/{id}?purge=1`（不带参数仍是「停用」软删除）。在一个事务里：
删积分流水（含已作废历史流水）→ 删破纪录登记 → 删成绩 → 删报名 → 删人员 →
对受影响的 (小项, 组别) 调 recomputeLedgerTx + applyComputedRanks 重算流水与名次 →
bumpEvent/bumpStandings 推大屏 → 审计 athlete.purge（含删除规模）。
响应带 {deletedEntries, deletedResults, deletedLedger, deletedBreaks, recomputedEvents}。
必须先删 results 再删 entries（results.entry_id 无 ON DELETE）；流水按 athlete_id / entry_id /
result_id 三种引用一把清，漏一种就留悬挂。

管理端「运动员」行加「彻底删除」按钮 + 危险确认框（如实写明报名与成绩一并删除、
相关小项排名与积分会重算），成功 toast 报出删除规模。

## 报名表 status 列容错
新增 entry_status.go 的 normalizeImportStatus：大小写不敏感（DNS/Registered 都认），
认「正常/退赛/弃赛/请假/取消资格/犯规/未出场/未到/缺席」等中文别名，留空即 registered，
认不出则给中文行级错误并跳过该行。此前原样入库，撞 entries.status 的 CHECK 约束后
抛原始 SQLite 错误，填表人看不懂。

## 修 isUniqueViolation 把 CHECK 失败误报成「已存在」
SQLite 的 CHECK / NOT NULL 失败也带 "constraint failed"，旧匹配把「小项 status 取值非法」
报成 409「小项编码已存在」，现场会去找一个根本不存在的重名编码。收紧为只认
"unique constraint failed"。实测：重复编码仍 409；非法 status 不再误报。

## 安装包平铺《报名名单导入规范》
deploy/prepare-extra.mjs 改清单式，部署包根目录除 使用说明.txt 外新增
报名名单导入规范.txt。

测试：服务端 12 包全绿（新增 athlete_purge_test.go、entry_status_test.go）；
前端 vue-tsc 通过、166 例全过；Console 语法检查 17 文件。
另在真二进制 + 真 SQLite 上跑通破坏性路径：删人后本人痕迹全为 0、他人不受影响、
榜单按新排序重算、foreign_key_check 无悬挂。docs/ 与 devdocs/ 同步更新。
 2026-09-10 22:37:25 +08:00
AskaEth 22ab49e73a docs: 新增《报名名单导入规范》，给各单位填表人看的导入格式说明 
面向非技术读者写清楚报名表到底长什么样、每一列怎么填：

- 11 列逐列说明（哪些必填、值域、示例），表头大小写不敏感、
  列顺序可调、多余列忽略；event_code/team_code 抄系统编码、
  category 填组别名称、status 只能填 registered/scratched/dq/dns 小写
- 个人项目 / 团体项目 / 「个人+团体」三种项目的完整示例表格
- 导入前自检清单、常见报错逐条对照（含中文乱码与「缺少列 event_code」）、
  重传是整条覆盖（空值会清掉原值、status 会被重置）这条容易踩的坑
- 一页版「给填写人的最短提示」

同时：README 文档索引、使用手册 §10.7、常见问题 Q51 交叉引用该文档；
debug/使用说明/ 也放了一份，方便直接发给填表人。
 2026-09-10 19:05:25 +08:00
AskaEth fc96d17660 feat: 字体可配并随赛事包打包 + 大屏调试标识收敛 + 报名表 CSV 编码兼容 
三块改动，均为现场反馈：

一、字体配置与随包打包（此前「没有入口可以配置字体」，导出包也不带字体）
- 服务端新增 httpapi/fonts.go 与 4 条路由：GET /api/fonts（recorder）、
  POST /api/fonts（admin，multipart file）、DELETE /api/fonts/{name}（admin）、
  GET /uploads/fonts/{name}（匿名——大屏 @font-face 不带会话）
- 上传限 ttf/otf/woff/woff2、单个 20 MiB；文件名经 safeFontName 收敛且需与
  fontContentType 往返一致，挡住路径穿越；重名 409、删除被引用字体 409
- 新增设置键 display.font_title / display.font_body（DTO fontTitle/fontBody，
  随快照下发给大屏），写入时校验取值合法
- 导出：接上一直没被赋值的 IncludeFonts/FontsDir；包内落点用 uploads/fonts/
  （运行时只读这里，落顶层 fonts/ 等于没人读）
- 大屏按配置动态注册字体并挂 --display-font-title/body，加载失败静默回落默认字体
- 管理端「赛事信息」新增字体区块：标题/正文字体下拉、上传、字体库、实时预览

二、大屏显示收敛
- 数据版本号角标 vN 彻底移除（原先只有窗口化窗口会显示，两处显隐口径不一致）
- 窗口化窗口按 F11 全屏后自绘标题栏不让位：根因是 Console 用 win.setFullScreen()
  做窗口级全屏，而页面用 document.fullscreenElement 判断，后者恒为 null；
  新增 display-preload.js 下发窗口级全屏状态，页面侧 shell.ts 把两级全屏取或，
  无 preload 时（浏览器直连 /display）回落到文档级监听

三、报名表 CSV 编码兼容（用户报「解析中文字符遇到编码问题」）
- 服务端不再把原始字节直接喂给 csv.Reader：先摘 UTF-8 BOM，再认 UTF-16 LE/BE
  BOM，其余非合法 UTF-8 按 GB18030 解（GBK 是其子集）
- 修复前症状：GBK 文件（Excel 另存为 CSV 的默认编码）中文变乱码；带 BOM 的文件
  （Excel「CSV UTF-8」，也正是我们自己模板的格式）把 BOM 拼进第一列表头，
  报「报名表缺少列 event_code」——连「下载模板→填→传回来」都走不通
- golang.org/x/text 由 indirect 提升为直接依赖，未新增外部依赖

测试：服务端 12 包全绿（新增 fonts_test.go / fonts_internal_test.go /
handlers_import_encoding_test.go）；前端 vue-tsc 通过、pnpm build 通过、157 例全过；
Console 语法检查 17 个文件通过。docs/ 与 devdocs/ 同步更新。
 2026-09-10 17:45:11 +08:00
AskaEth 9c6d0bd3b3 docs: 用户文档补齐「个人+团体」等新功能，修正切换赛事与账号存储位置的说法 
按 407abec 之后落地的功能，对照代码逐条更新四份用户文档与 README：

- 使用手册：补「个人+团体」是什么与完整配置链路、平均值口径两种分母、
  榜单口径（全局）折算系数、公告（全屏→底栏常驻）、报名导入两个页签、
  单位 logo 显示位置、17.5 调试标识；修正「账号存在各个赛事库里」的错误说法
  （账号与会话在数据目录的 system.db），在线看板改为指向服务管理窗口的实例卡片
- 部署指南：新增 7.5 显示器菜单 / 7.6 公告 / 7.7 调试标识与单位 logo；
  重写 8.5 赛事项目包（导入 ≠ 切换、包内四类内容、不能覆盖运行中的项目），
  并把 -project 启动参数明确标为「不要用来切赛事」
- 上线检查清单：补当前赛事、显示器菜单、单位 logo、公告四项现场核对，
  修正「切换后登录状态失效」
- 常见问题：重编号 Q1–Q48，新增个人+团体算分、平均值口径、只报单位、
  折算系数、公告底栏、单位 logo、调试标识 8 条；切换赛事与数据迁移按实测重写
- README：功能概览与文档索引同步
 2026-09-10 15:16:17 +08:00
AskaEth 6bd7bd1627 feat: 「个人+团体」项目真正落地——通道级不计入单位 + 队内平均排名 
口径（用户确认）：
- 个人分按个人成绩排名给，**不计入单位总分**（下沉到通道级开关，不再动全局系数）
- 团体成绩 = 每队成员成绩的**平均值** → 排名（并列顺延）→ 团体模板给分 → 计入单位总分
- 平均值口径是**小项级单选项**：默认「只算有效成绩」；「全部报名人员计入」= 分母为报名条数、
  没成绩按 0 加入分子；在**成绩录入页**就地切换并立即保存

服务端：
- 迁移 0017：score_ledger 加 count_to_team（重建，无子表）；event_score_channels 加 count_to_team；
  events 加 avg_mode（默认 valid）
- 规则包 Channel 加 countToTeam（缺省 true）；channelTemplates 支持 individual_team →
  默认 athlete(result, 不计入单位) + team(aggregate 队内平均)
- 计分引擎：SumByTeam 跳过 count_to_team=0 的流水；实现 basis=aggregate 的队内平均团体排名
  （valid 分母=有有效成绩人数；all 分母=报名人数；某队 0 有效成绩不参与）

前端：
- 计分通道页：每行通道「计入单位总分」勾选 + basis 下拉「按队内平均」
- 成绩录入页：仅有队内平均通道的小项显示「平均值口径」单选（默认只算有效成绩），改动即存
- 录入页「实时积分预览」按新口径对齐（原先按主体求和且双通道重复计入，与发布后不一致）
- 大屏/管理端团体成绩只显示数值，不出现「平均」字样

自检：服务端 12 包全绿；前端 vue-tsc + build、node --test 134/134；console 16 文件通过。
 2026-09-10 12:02:00 +08:00
AskaEth 592e47aef7 feat: 小项类型加「个人+团体」+ 报名导入拆团体/个人两部分 
小项类型：
- 迁移 0016 给 events.event_type 的 CHECK 增加 individual_team。SQLite 改不了 CHECK，
  而 events 被多张子表引用（含 ON DELETE CASCADE/SET NULL），事务内 DROP 重建会级联删数据，
  故用 writable_schema 就地改写建表语句文本（只追加一个枚举值，'match' 在建表语句里仅出现一次，
  无副作用），零数据搬动
- domain 加 EventTypeIndividualTeam；管理端下拉加「个人+团体」并提示会同时走两条通道；
  guards/rules 的 eventType 白名单同步（否则会被降级成 individual）
- 注意：该类型目前只解决「能被选出来」，双计的算分语义（个人分不计入单位、团体按队内平均排名）
  尚未实现，等口径确认后再动数据模型

报名导入：
- 卡片拆成「个人报名 / 团体报名」两个 tab，小项+组别提到 tab 之上共享
- 团体报名 = 从已配置单位清单里多选（默认全不勾，正好表达「部分单位不参加」），
  可逐单位为登记队员（0 人即纯单位报名），一次提交为多个单位各建一条报名
- 已报名单位仍可覆盖名单，但会提示「提交将清空原名单」，且「全选」只勾启用中且未报名的单位

自检：服务端 12 包全绿；前端 vue-tsc + build、node --test 117/117；console 16 文件通过。
 2026-09-10 11:19:31 +08:00
AskaEth b5f40642ff feat: 公告持久化（底栏常驻）+ 团体可单独报名 + 榜单系数开关 
公告：
- 服务端把当前公告落库到 settings（display.announce_text / announce_seconds），
  作为 display.announce 随 snapshot 与 /api/settings 下发（非 admin 快照也保留）
- announce 指令除转发外写库；新增 announce_clear 清空并广播；两者写审计
- realtime 协议登记 announce_clear（补上，使清除能即时推到大屏）
- 大屏把「全屏推送」与「底栏常驻」拆开：推送 seconds 秒后只退出全屏态，公告留在底栏，
  直到被替换或清除；新增公告状态机（可测）与底栏取值优先级
  推送中 > 服务端持久值 > 「暂无公告」；管理端加「清除公告」与当前公告状态

团体报名：
- EntryPicker 团体/对抗模式允许不勾队员直接报名该单位（此前必须勾人，导致
  「只想给单位报个团体项目」做不到、单位下没有运动员时完全报不了）
- 核实录入页团体行：显示/填名次/保存/发布/算分闭环无缺陷（用真实服务端跑过），
  抽出共享的 entryRowLabel 供两处复用

榜单口径：
- 基础数据 → 积分模板页新增「榜单口径（全局）」卡片：individualToTeamWeight
  数字输入（默认 1、0–100），说明「个人项目得分按该系数折算计入单位总分」，
  保存走 PUT /api/settings；因该值在服务端是全局键、模板表里没有此字段，
  故做成独立卡片并标注全局，不塞进模板表单

自检：服务端 11 包全绿；前端 vue-tsc + build、node --test 99/99。
 2026-09-10 11:06:58 +08:00
AskaEth cded54e440 feat(display): kiosk 全屏不再显示数据版本号角标 
那个 vN 是 change_log 的数据版本号（不是软件版本），用途是现场核对「这块屏有没有
跟上服务端」——与管理面板里的版本号一致就说明已同步。属调试信息，按「实例 · 屏」
同一规矩处理：只在窗口化调试时显示，kiosk 全屏不出现。
 2026-09-10 10:35:03 +08:00
AskaEth 8c74a82da4 feat(display): 分项成绩与个人榜也显示单位 logo（个人榜在姓名前） 
- 服务端补下发：dto.EventResultRow 与 athleteStandingDTO 各加 logoPath，
  分别取「该行单位」与「该运动员所属单位」的 teams.logo_path；空串统一收敛为 null
- 大屏抽出 TeamLogo.vue（1em / object-fit:contain / 加载失败保留占位、@load 复原），
  原先在积分榜与团体奖牌榜各写一遍的逻辑收敛成一份，四处复用
- 分项成绩页：单位列名字前显示 logo；个人积分榜：运动员姓名前显示其单位 logo
- guards/mock 同步解析与补字段；补 11 条测试（类型解析 + SFC 模板断言）

顺带修：管理端示例数据 athleteStandings 缺新必填字段导致的 vue-tsc 报错。

自检：服务端 11 包全绿；前端 vue-tsc + build、node --test 80/80。
 2026-09-10 10:32:19 +08:00
AskaEth 6f47849e1e fix(display): 隐藏调试标识 + 积分榜显示单位 logo 
- TopBar 的「实例 N · 屏 N」只在该窗口确实处于调试态时渲染：非 windowed（kiosk）不显示，
  窗口化下按 F11 全屏也不显示（同时监听 fullscreenchange，与 App.vue 口径一致）
- 积分榜与团体奖牌榜的队名左侧渲染单位 logo：数据本来就下发了（dto/standings.go 的
  LogoPath），只是页面没画。图标 1em 随行字号浮动、object-fit:contain，行高不会被撑开；
  无 logo 不占位，加载失败 visibility:hidden 保留占位避免队名跳动，@load 会复原
- resolveAssetUrl（路径归一化）从 admin 目录收敛到 web/src/shared/asset.ts，
  管理端与大屏共用一份；原 image-path 测试随之迁到 shared/tests

未做（需服务端 DTO 支持，本次未授权）：分项成绩页与个人榜的单位列同样没有 logoPath 字段，
所以那两个页面仍无法显示单位 logo。

自检：vue-tsc + pnpm build 通过；前端 node --test 69/69。
 2026-09-10 10:20:03 +08:00
AskaEth 407abec3b0 fix: 大屏背景图被兜底渐变盖住 + 配置/规则也搬到用户数据目录 
1) 大屏背景图不生效：App.vue 里 .bg 与 .bg-fallback 都是 absolute inset:0，
   而兜底渐变是不透明的且在图片之后绘制 → 配了背景图也只看得到渐变。
   改成 v-if/v-else 互斥（用无头 Chromium 真渲染对照验证：修复后取到图片像素，
   回退版本只剩渐变）。新增 background-layer.test.ts 锁住层次关系。

2) 规则/config 仍在安装目录，覆盖安装/卸载会连配置一起删：现在三样都落在
   %LOCALAPPDATA%\ScoreboardConsole\（与数据目录同一基座）：
   - console\config.json（Console 读写都用这份）
   - config.yaml（Console 用绝对路径 -config 传给服务端与 passwd）
   - rules\（首次从安装目录复制过去，之后只认用户目录那份）
   首次运行复制迁移、已存在不覆盖、不可写则回落安装目录并记日志（不影响启动）；
   开发态行为不变。备份脚本与文档同步。
   注意 resolveExecutable 必须显式传部署包根目录，否则会去用户目录找 scoreboard.exe。

自检：服务端 11 包全绿；console 语法 16 文件 + node:test 20/20；
前端 vue-tsc + build、node --test 69/69。
 2026-09-10 10:06:21 +08:00
AskaEth 2d207fd654 feat: 赛事项目切换 + 记住上次打开的赛事（修「导入赛事包后没数据」） 
根因：服务端启动只认 -project（缺省 default），Console 从不传；导入只是把包解到
event_projs/<名字>，没有任何切换入口 → 导入的赛事永远打不开，页面看到的是空的 default。

- 服务端 -project 缺省改为空串；解析顺序：显式 flag（并写回记忆）> <dataDir>/active_project.txt
  > default；backup/passwd 口径一致；启动日志打印生效项目与来源
- GET /api/projects（admin）列出各赛事（是否当前/是否有 event.db/大小/更新时间）
- POST /api/projects/activate（admin）：校验后原子写记忆文件 → 审计 → 返回
  {ok,name,restarting:true} → 触发优雅关闭；Console 对非用户发起的退出会自动拉起，
  重启后即打开新赛事（无需改 Console）。本来就是当前赛事则 restarting:false 不重启
- 管理端「导出」页新增赛事项目列表与「切换为当前赛事」；导入成功后提示「已导入为 X，
  但还不是当前赛事」并给「立即切换并重启服务端」；切换后轮询 /api/health 等它回来再刷新
- 文档：使用手册（导入≠切换、生效四步）、常见问题（导入后看不到数据）

自检：服务端 12 包全绿；前端 vue-tsc + build、node --test 66/66；console 14 文件通过。
 2026-09-10 09:47:06 +08:00
AskaEth 005b51b2ec fix: 数据目录移出安装目录，修掉「覆盖安装/卸载即丢数据」 
根因：数据目录是 <安装目录>\data（config.yaml 的 dataDir 相对服务端工作目录），
而 electron-builder 的卸载器结尾执行 RMDir /r $INSTDIR，且覆盖安装会先跑旧卸载器
（installSection.nsh:52 的 uninstallOldVersion）→ 赛事库/规则/用户/审计/上传图片
连同安装目录被整个删除，再装新版。卸载一次同样如此。

- 服务端新增 -data <dir>（主命令、backup、passwd 三处），非空时覆盖 config.yaml 的
  dataDir；不传时行为完全不变（兼容便携/手工运行）
- Console 把数据指到当前用户目录 %LOCALAPPDATA%\ScoreboardConsole\data（卸载器不会碰
  这里；没有用 app.getPath('userData')，因为 %APPDATA%\<AppName> 正是被删的那个）
- 一次性迁移：目标为空且 <安装目录>\data 有数据时整体改名过去；两边都有数据时不动作
  只记警告；任何失败都保留原地数据、绝不删除
- passwd 也带 -data（否则重置的是安装目录下那个空库里的账号）
- deploy/backup.bat 指向同一数据目录
- 文档：部署指南新增「数据放在哪里（升级/卸载都不会删）」+ 备份/恢复/迁移路径改写，
  上线检查清单与使用手册同步

自检：服务端 12 包全绿；console 语法 14 文件 + datadir 单测 11/11；backup.bat 保持纯 ASCII。
 2026-09-10 09:17:56 +08:00
AskaEth 6483acf9ad feat: 人员年龄/号码布、图片上传、多显示器菜单、Console 两栏、exe 改名等一批改动 
人员与报名：
- 人员唯一标识改为「证件号 或 号码布」二选一（0013/0014 迁移 + 导入匹配/回填/冲突）
- 人员新增「年龄」（0015 迁移）：表单/列表/导入模板表头 11 列；冲突比较只在两边
  都有值且不同时才算差异，旧数据不误报
- 冲突决策键改为「证件号优先 → 号码布」（前端原先只用 idCard，号码布行会互相覆盖）
- 报名选择器支持无证件号但有号码布的运动员

大屏与 Console：
- 大屏控制新增「显示器」菜单：可给指定显示器重建全屏窗口；单屏/主显示器强制窗口化，
  限制在 Console 侧判定，不信任页面传参
- Console 服务管理窗口改左右两栏，运行日志独占右栏满高；窗口默认尺寸 1280×860
- 大屏右上角时钟精确到秒（同时把刷新间隔 15s 改为 1s）

图片与配置：
- 新增图片上传 POST /api/uploads（recorder+，png/jpg/webp/gif，≤5MiB）与匿名静态
  访问 GET /uploads/{name}（防目录穿越）；文件落赛事项目目录 uploads/，随赛事包
  一起导出/导入
- 「赛事信息」新增赛事会标 / 大屏会标 / 大屏背景图三个上传项
- 参赛单位 logo 输入框右侧加上传按钮

关于页与构建：
- 构建时间打通：version.BuildTime + /api/system/about 返回 + build.bat 注入
  （用 PowerShell 取时间戳，避免本地化 %DATE% 的非 ASCII 星期）

安装包：
- 主程序改名 Scoreboard_Console.exe（win.executableName；productName/显示名不变）
- 记住上次安装目录：自定义 NSIS 宏优先沿用自存路径（卸载不清除），并在 customInit
  里补写回 electron-builder 的键，避免安装模式页把 $INSTDIR 打回默认

自检：服务端 12 包全绿；前端 vue-tsc + build 通过、node --test 58/58；console 12 文件通过。
 2026-09-10 09:05:06 +08:00
AskaEth 24fff8dd08 feat: 人员唯一标识改为证件号 + 导入冲突逐条决策 
需求：人员以证件号为准（避免重名）；批量导入时若证件号已存在于本地人员数据，
先导入其余人员，再把重复的人单独列出，由用户逐条/多选决定保留已有数据还是新数据。

服务端：
- 迁移 0013：athletes 增加 id_card + 部分唯一索引（空值可共存）
- athleteDTO/CRUD 读写 idCard，重复返回 409
- 导入表头新增可选列 id_card/gender；有姓名的行必须给证件号
- 匹配顺序：证件号 → 姓名+单位（且库中证件号为空则回填）→ 新建人员
- 证件号命中但姓名/性别/单位不一致 → 冲突，本轮不落库（报名也不建）
- 新增 POST /api/entries/import/resolve（file + decisions），keep-existing/keep-new
- 10 个新测试覆盖匹配/回填/冲突/决策/唯一索引

前端：
- 运动员表单与列表新增「证件号」，搜索支持证件号
- 报名导入：新模板 10 列；导入后冲突面板（每行复选框 + existing↔incoming 差异高亮
  + 全选/清空 + 保留已有数据/使用新数据 批量与逐条），未决策项始终可见
- 勾选报名（EntryPicker）缺证件号的运动员禁止勾选并提示
- 新增 import-conflicts.test.ts 等，前端测试 39/39

文档：使用手册（运动员证件号、导入表头与冲突流程）、常见问题（证件号重复怎么办）。

注：报名行的 team_code 与人员绑定单位不一致会计入冲突，由用户决策，不会静默改单位。
 2026-09-10 02:09:15 +08:00
AskaEth c9d5b8ea89 feat(admin): 报名导入新增「从已有名单勾选报名」 
原来只能上传 CSV/XLSX。现在同一个 tab 上方多一个选择器：选小项 → 组别 → 单位，
从该单位已有运动员里勾人，一键加入报名。

- 个人项目：勾 N 人 → N 条报名（一人一行）
- 团体/对抗项目：勾 N 人 → 1 条报名，姓名拼进 member_names（再次提交即更新队员名单）
- 已报名的人/单位会标「已报名」并禁止重复勾选
- 复用服务端唯一报名入口 POST /entries/import：勾选结果转成同格式 CSV 提交，
  字段校验、按 (组别,单位,运动员) upsert、行级报错回显与表格导入完全一致
- 纯函数 entrySelection.ts（表头唯一来源 + RFC 4180 转义）+ 4 个单测；
  表头定义从 ImportSection/mockBaseData 收敛到一处
- 号码布/种子仍走表格导入，界面与文档都写明

自检：vue-tsc + pnpm build 通过，前端 node --test 30/30。
 2026-09-10 02:03:16 +08:00
AskaEth 7531ea29e1 fix(admin): 组别填了年龄后「保存全部」无反应（number 字段被当字符串处理） 
Vue 3 对 <input type="number"> 的 v-model 会自动 parseFloat（空值仍为 ''），
所以填了年龄后 row.ageMin/ageMax 是 number，而校验里写的是 row.ageMin.trim()，
点击处理器抛 TypeError 直接中断 —— 界面毫无反应；留空时是 ''，.trim() 正常，所以能保存。

- CategoriesSection：新增 toAge() 统一取值（String() 包一层，非法值返回 NaN 交给校验标红），
  validate 与 buildInputs 都改用它；CategoryRow 的数值字段类型如实标注为 string | number
- AdjustmentsPage：调整分值的 formDelta.value.trim() 同样会崩，改为 String(...).trim()

自检：vue-tsc + pnpm build 通过，前端 node --test 26/26。
 2026-09-10 01:58:04 +08:00
AskaEth c2696e768e fix(admin): 写操作不再被实时连接状态拦截 
原来 canWrite 依赖 realtimeStatus === 'online'，WS 一断（服务端重启、网络瞬断、
以及之前那个 1008 停重连的 bug）整个管理端就变只读：基础数据的「保存全部」、
录入、发布、积分调整、大屏控制全部按钮变灰，且只是变淡、看不出原因。

写路径本来就是 HTTP，服务端会做完整校验，所以：
- stores/event.ts 的 canWrite 恒为 true（保留签名，角色判断由各页面叠加 auth.readOnly）
- useBaseData.canWrite 简化为 !auth.readOnly
- 顶部「连接中断」的提示改为「数据可能不是最新」，不再声称写操作停用
- 文档同步：FAQ 与使用手册区分「示例数据」（改动只在界面）与「连接中断」（照常提交）

新增 web/src/admin/tests/base-data.test.ts 锁住该行为（离线可写 / 访客不可写）。
 2026-09-10 01:56:07 +08:00
AskaEth 0c9a6b6a27 fix(console): 开机自启改为「注册但不启用」，开关切换 enabled 
上一版把「关闭」实现成不写登录项。实际在 Windows 上实测 Electron：
  setLoginItemSettings({ openAtLogin: true, enabled: false })
  → openAtLogin=true、launchItems[0].enabled=false、executableWillLaunchAtLogin=false
即登录项已注册（任务管理器「启动」里可见、显示为已禁用）但不会随系统拉起。
所以改成始终注册登录项、只用 enabled 控制是否真正启动，语义与用户要求一致：
  - applyOpenAtLogin / setOpenAtLogin 都走 loginItemSettings(wanted)
  - macOS 无 enabled 参数，仍按注册/注销处理
  - 状态快照的 openAtLogin 以系统实际状态为准（打包后读 executableWillLaunchAtLogin）
  - 文档同步：默认「已注册但未启用」
 2026-09-10 00:09:49 +08:00
AskaEth 1b78c38bb8 feat(console): 开机自启默认关闭，服务管理窗口加手动开关 
- DEFAULTS.startup.openAtLogin 与随包 config.json 默认改为 false；
  applyOpenAtLogin 只有显式 true 才注册登录项（缺省/null/false 都不注册）
- config.js 新增 updateConfig()：只写回文件里已有的键 + 目标键，不把 DEFAULTS 落盘
- 主进程 setOpenAtLogin()：改内存 → 写回 config.json → setLoginItemSettings，
  任一失败都回滚，返回 {ok, openAtLogin}；状态快照新增 openAtLogin / openAtLoginSupported
- 渲染层：服务端状态卡片新增「开机自启」滑块（纯 CSS，无依赖），
  切换即时生效并有本地意图守卫，避免被随后到达的陈旧快照冲掉
- 文档：console/README.md 与 docs/部署指南.md 同步

注意：旧包 config.json 里已显式写 true 的用户升级后仍会自启（不悄悄改既有行为），
在窗口里关一次即可；全新安装默认不注册。
 2026-09-10 00:06:59 +08:00
AskaEth 7c59dba9b9 chore: debug/ 加入 gitignore（本地构件与规则配置的中转目录） 2026-09-09 23:27:38 +08:00
AskaEth a5941be9c4 fix(admin): 改密后管理面板永久「连接中断」+ 顶部版本号多一个 v 
- /ws 身份在握手时确定，而 startRealtime() 全生命周期只建一次连接；改密会作废
  服务端全部会话，服务端以 1008 关闭该连接，前端对 1008 是永久停止重连
  （给真鉴权失败设计的）→ 重新登录后无人重启连接，界面一直显示「连接中断」，
  只有重开窗口才会用新会话重新握手。
  修：新增 restartRealtime()，登录成功与退出登录时各重启一次（同时修掉
  「访客浏览后登录，旧连接仍是 guest 身份」的问题）；1008 语义保持不变。
- AdminLayout 顶部版本号模板写死 v 前缀，而 serverHealth 已是完整版本串
  （dev_0.1.0）→ 显示成 vdev_0.1.0。

新增 web/src/admin/tests/event-realtime.test.ts 锁该行为（临时置空 restartRealtime
会失败）；为让 node --test 能加载真实 store，测试解析钩子补 @/ 别名。
 2026-09-09 23:19:23 +08:00
AskaEth 27bddefaad fix: 上线前快修（大屏自愈 / 奖牌口径 / 聚合作废 / 密码可发现性） 
- P0 慢客户端关闭码 1008 → 4000：前端把所有 1008 当「登录失效」并永久停止重连，
  大屏被踢后再也不自愈（服务端 markSlow 改用自定义码，前端逻辑不动）
- P1 REST 与 WS 的奖牌榜补 events.scored = 1 过滤，与导出成绩册口径一致
  （否则「只排名不计分」项目只要挂着通道就会在大屏凭空出奖牌）
- P1 聚合流水作废去掉 source_id 子查询：改通道会重建通道 id，旧聚合流水
  永远匹配不上 → 再插一份 → 分数翻倍
- P1 审核页/历史页的折算系数兜底由 ?? 1 改为 >0 ? : 1：/ws 快照对非 admin
  会把 individualToTeamWeight 置 0，recorder 看到的个人折算分全是 0
- P2 删掉 signature.local.txt 后清理残留的 signature.build.txt，避免继续注入旧署名
- 初始管理员密码：banner 加纯 ASCII 锚 INITIAL ADMIN CREATED，文档改为搜它
  （原来教的 findstr "password=" 已经失效，且中文 findstr 本身不可靠）

自检：服务端 12 包全绿；前端 vue-tsc + build 通过、node --test 24/24；console 语法通过。
 2026-09-09 23:13:20 +08:00
AskaEth 045b0f5d95 docs: 上线清单补一条安装目录写权限提醒 2026-09-09 22:47:25 +08:00
AskaEth a0a4824dda docs: 新增上线检查清单（当天照着走一遍的核对表），README 加链接 2026-09-09 22:47:14 +08:00
AskaEth 8039da384d fix(build): 署名自检改用 Node 字节比对（findstr 在 chcp 65001 下匹配不了 UTF-8 中文） 
findstr 会误报 NOT found，而实测 exe 里署名是存在的。改成 verify-signature.mjs
读字节 includes 比对，缺失时让构建硬失败。
 2026-09-09 22:21:28 +08:00
AskaEth e7948088df fix(build): 署名注入改走 Node 规范化 + for /f 直读文件 
上一版用 PowerShell 管道读取：PS 5.1 的 Get-Content 默认按 ANSI 读，输出再经
cmd(chcp 65001) 解码一次，中文署名被转成乱码 —— 日志写着 injected，但 exe 里的
字节与预期不符（实测 sig_in_exe=False）。
改为 deploy/prepare-signature.mjs 读 UTF-8 并剥 BOM/空白，写出 signature.build.txt
（gitignore），build.bat 用 for /f 直接读文件（不经过任何编码转换）。
另加一条 findstr 自检：注入后若 exe 里找不到署名就打印 [warn]。
 2026-09-09 22:19:01 +08:00
AskaEth 13f1f03cd0 fix: 修掉十路审查发现的 9 个 P0 与一批 P1（数据正确性 / 越权 / 现场可用性） 
P0（9 条全修）：
- 多通道项目奖牌重复计数：domain 层按 (EventID,CategoryID,EntryID/Subject) 去重，
  通道优先级 athlete→team→id
- 「只排名不计分」项目（scored:false）不再进奖牌榜，REST/WS/导出口径统一
- aggregate 流水 entry_id 恒 NULL 导致重算后分数翻倍：作废范围改按 event+category 定位
- 已发布成绩仍可被「存草稿」覆盖并清空 rank：服务端 409 STATE_INVALID + 前端禁编辑
- voidResult / 规则导入重算后名次不回写：接住 Ranked 调 applyComputedRanks
- 赛事包覆盖导入可能「旧项目已删、新项目没成」：先改名成功再清理，失败回滚
- 导入赛事包可覆盖正在运行的赛事目录：name==当前项目直接 400
- Console spawn 失败后守护器永久卡死：清 child/pid + 调度重启 + stop 超时兜底
- /ws 快照向非 admin 下发 admin-only 配置：按角色裁剪 settings

P1（计分口径 / 契约 / 现场）：
- standings.tieBreak 三处接线；profiles[].recordBonusMode 生效；破纪录校验
  RecordEligible 与 entry 归属；破纪录登记校验已发布成绩
- export.loadRanked 与主路径对齐；ListBackups reason 解析；CLI backup 前缀修正
  （原来只增不减会撑爆磁盘）；单位积分明细/导出统一权重折算；停用单位展示
- 规则导入原子化（重算并入同一事务）+ 返回 compatible/affectedEventCount/
  recalculatedLedgerRows；登录审计 user_id 修正
- WS 策略性断开用 Close(code,reason)；HelloMessage 补 page/instanceId；
  实例注册表清理；settings/单位/项目写操作补 change_log 触发大屏刷新
- 大屏：全量快照不再被版本守卫丢弃；个人积分榜刷新；公告返回页/轮播；行数截断；
  REST 竞态；1008 停止重连；握手超时；时区补 Z；401 仅 AUTH_REQUIRED 才登出
- 管理端：published 行禁编辑；saveDraft 补 unit（1:06.33 显示）；前端预览改用服务端
  points；空成绩行不再恒「已修改」；修订详情按 id 拉取；切项目请求序号与 dirty 保护；
  发布后刷新项目状态；NAV/路由按角色过滤；recorder 不再打 admin-only 接口
- Console：大屏窗口销毁后重建；大屏 URL 复用 host 归一化；backup.bat 改纯 ASCII
  （已在 Meowhome 实跑验证）

自检：服务端 gofmt/build/vet 通过、12 包测试全绿；前端 vue-tsc + build 通过、
node --test 24/24；console check-syntax 12 文件通过。
 2026-09-09 22:16:58 +08:00
AskaEth 96cf181ae3 docs: 服务管理窗口补充「已连接的大屏实例」说明 2026-09-09 21:42:35 +08:00
AskaEth 2c9ff65fc4 feat: 补齐第一批已知缺口（关闭握手 / 定时备份 / Origin 白名单 / DTO 收敛） 
- httpapi：新增 POST /api/shutdown（admin 会话或 X-Shutdown-Token 常量时间比对）
  与 GET /api/rules/switches（recorder 可读，只回布尔开关）；settings/standings 的
  重复 DTO 收敛到 internal/dto；standings.showIndividualMedals 贯通到设置读写与前端
- export：抽出 export.Service，新增自动备份定时任务（backup.intervalMinutes/keep），
  自动、手动、发布前三类备份共用同一把互斥锁与滚动清理
- realtime：/ws 去掉 InsecureSkipVerify，改用 OriginPatterns（同源与无 Origin 放行，
  跨站需命中 server.allowedOrigins）
- console：停止服务改走 POST /api/shutdown 优雅关闭（5 秒宽限后回退强杀），
  服务管理器新增「已连接的大屏实例」卡片
- deploy：build.bat 改用 for /f 读内部署名——set /p 在 chcp 65001 下返回空，
  导致最近这次构建的 exe 里根本没注入署名
- docs：备份策略、关闭超时、Origin 配置的说明与实现对齐
 2026-09-09 21:41:08 +08:00
AskaEth 4d56c73ae6 fix(build): build.bat 注释改回纯 ASCII 
cmd.exe 会错解 .bat 里的 UTF-8 文本，上一版加的中文 REM 让构建日志里
冒出一行 "'PNPM_IGNORED_BUILDS' is not recognized"。文件头部本来就写明必须纯 ASCII。
 2026-09-09 21:38:23 +08:00
AskaEth 33d4b39eb9 fix(build): pnpm 11 用 allowBuilds 放行 electron 安装脚本 
pnpm 11 起 onlyBuiltDependencies 列表形式被静默忽略，导致
ERR_PNPM_IGNORED_BUILDS 让 pnpm run 的依赖校验直接失败（pnpm run dist 都起不来）。
改为 pnpm 自己写入的 allowBuilds 映射形式，并去掉 build.bat 里的 --ignore-scripts。
另外修复 set VAR=value && ... 的尾随空格：它会把 ELECTRON_MIRROR 变成
'.../electron/ v38.8.6/...' 从而 404。
 2026-09-09 21:35:21 +08:00
AskaEth 52edecfa4c fix(build): 钉 @electron/get@3.1.0 修 electron-builder 打包崩溃 
app-builder-lib@26.15.3 声明 @electron/get ^3.0.0，但代码用了 3.1.0 才导出的
ElectronDownloadCacheMode，导致 pnpm run dist 报
TypeError: Cannot read properties of undefined (reading 'ReadWrite')。
pnpm-workspace.yaml 里 override 到 3.1.0 并重新生成锁文件。
 2026-09-09 21:30:50 +08:00
AskaEth d50f5d7524 fix(build): 恢复安装器许可页文案生成（挪到 prepare-extra.mjs，避免中文进批处理） 2026-09-09 21:19:30 +08:00
AskaEth fc3361f766 fix(build): ensure_electron 始终补写 path.txt 2026-09-09 21:11:50 +08:00
AskaEth d5b45761d7 fix(build): 恢复手动放置 Electron 运行时的步骤（electron-builder 自下会撞 Node 24 bug） 2026-09-09 21:11:02 +08:00
AskaEth c3d2c1416f fix(build): console 安装用 --ignore-scripts，绕开 pnpm 11 的 ERR_PNPM_IGNORED_BUILDS 2026-09-09 21:10:21 +08:00
AskaEth 1399bae59e fix(build): build.bat 全 ASCII + Node 脚本处理中文路径 + pnpm-workspace.yaml 构建脚本白名单 2026-09-09 21:09:38 +08:00
AskaEth de4bd63594 fix(build): build.bat 块内改 ASCII（cmd 对 UTF-8 中文块解析错乱）+ pnpm 允许 electron 构建脚本 2026-09-09 21:09:02 +08:00
AskaEth 7f9701c465 fix: 审查修复波次（P0x4 + P1x30+） 
- domain/rules: 计分与排名解耦、破纪录按组别、tieBreak 生效、调整分不丢、移除 aggregate 假能力
- realtime: 新建 internal/dto，快照三项契约对齐，/ws 只认会话身份
- httpapi: 流水幂等、standings 整表载荷、广播接线、强制改密、XFF 防伪造、records 写入、审计、赛事包内容、发布前备份、result.points、实例列表
- web: FormData 上传、YAML 解析、快照归一化、大屏解析层、bootstrap 降级、访客判定、主题切换
- console: 优雅关闭握手、中文化、免验证改管理员账号、选屏与日志轮转修复
- docs: 用户文档三份 + README
- 主代理: 破纪录加分接线（levels 未加载导致恒 0）
 2026-09-09 21:06:40 +08:00
AskaEth 8dae63ee70 feat(server): passwd 子命令支持 -new-username 同时改用户名 2026-09-09 20:59:42 +08:00
AskaEth b80c64a115 fix: 补 .gitattributes(CRLF for .bat) + README 端口 19540 + 提交 console 锁文件 2026-09-09 20:57:58 +08:00
AskaEth c121111f51 build: 快捷方式名改为中文「赛事积分榜」 2026-09-09 20:41:39 +08:00
AskaEth 7f183d5327 build: 安装器许可页顶部文案自动注入内部署名（构建时生成 .nsh） 2026-09-09 20:39:02 +08:00
AskaEth 1bc439d8e1 build: 补充 console/package.json author，修正 exe CompanyName 2026-09-09 20:25:33 +08:00
AskaEth 2c4547d210 chore: 版本号更新为 dev_0.1.0 2026-09-09 20:22:56 +08:00
AskaEth 2f75c31509 build: 回归 electron-builder 打包（win.icon 写入 PE 图标），下载走 gh-proxy 2026-09-09 20:20:04 +08:00
AskaEth ad3770cfc9 build: 用 rcedit 给 Scoreboard Console.exe 嵌入图标与版本信息 2026-09-09 20:19:02 +08:00
AskaEth 74e48bf5bc build: 署名注入用单引号包裹，支持含空格的值 2026-09-09 20:15:09 +08:00
AskaEth 76e725ca96 feat: 内部署名改为编译期注入（构建机本地文件，不进仓库）；关于页展示 2026-09-09 20:07:59 +08:00
AskaEth d288e2bb22 feat(admin): 基础数据/审核/破纪录/调整/导出/系统/日志/变更历史/关于 全部页面 + App 图标 + 大屏窗口化标题栏 2026-09-09 20:00:03 +08:00
AskaEth 5ae55b8057 fix(server): 赛事包导出传入项目名，修复 GET /api/export/project.zip 恒 500 2026-09-09 19:57:23 +08:00
AskaEth 72462792ec feat(server): 用户管理与变更历史接口；修复 result_revisions.parent_id 从未写入 2026-09-09 19:51:50 +08:00
AskaEth f3813171d3 fix(console): 停止服务时同步关闭扩展屏大屏窗口 2026-09-09 19:38:09 +08:00
AskaEth e86ca24d0e build: 输出改为 dist\ScoreboardConsole，运行时直接从官方 zip 解压（绕开损坏目录） 2026-09-09 19:36:02 +08:00
AskaEth 7243de93ce build: 运行时只装一次，避免覆盖只读文件被拒 2026-09-09 19:34:28 +08:00
AskaEth 1af62a690e build: build.bat 改用 ASCII 注释 + chcp 65001，避免中文注释被 GBK 解析拆行 2026-09-09 19:33:44 +08:00
AskaEth 29162f5c1d build: Console 改为就地覆盖组装，规避 .pak 只读删除失败 2026-09-09 19:33:07 +08:00
AskaEth 8b792496d6 build: 用 PowerShell 强制清理只读的 Console 产物目录 2026-09-09 19:32:29 +08:00
AskaEth 68ee99a5a2 build: 组装 Console 前先结束旧进程，避免文件占用 2026-09-09 19:31:47 +08:00
AskaEth ab2f4d1cec feat(admin): 修改密码页 + 首次登录强制改密；自绘标题栏与管理面板 Electron 窗口 2026-09-09 19:30:59 +08:00
AskaEth 4cbf5a74f0 feat(server): 新增修改密码接口 POST /api/auth/password（验原密码、作废会话） 2026-09-09 19:26:35 +08:00
AskaEth ad2322d558 feat(server): 新增 passwd 子命令，可重置用户密码并作废会话 2026-09-09 19:23:58 +08:00
AskaEth e47251658b fix(console): 默认端口改 19540；打包改为手动组装便携版（不依赖 GitHub 下载） 2026-09-09 19:15:13 +08:00
AskaEth c92b404f6e chore: 服务端端口 8080 → 19540 2026-09-09 19:09:05 +08:00
AskaEth bc8b1ee6c0 feat: M3-M7 全模块落地 + 集成接线 
- M3 认证/权限/审计/限流 + 全部 REST 接口
- M4 管理面板（MIUIx + 成绩录入/积分榜下钻/大屏控制）
- M5a 大屏页面（六页 + 明细覆盖层 + 缩放适配）
- M6 WebSocket 实时同步中心
- M7 xlsx 导出 + 赛事包 zip + 备份
- 规则包 YAML 导入导出（差异预览）
- 字体 vendor 子集化（4 套 x2 字重）
- 集成：realtime/export/rules 接入 main+httpapi；backup 子命令
- 修复：中间件包装 ResponseWriter 丢失 Hijacker，导致 WS 握手 501
 2026-09-09 19:02:24 +08:00
AskaEth d0e3b93e76 chore(server): 预置 M3/M6/M7 所需依赖 2026-09-09 18:47:34 +08:00
AskaEth 0d32903b1a build: 增加 Windows 一键构建脚本 deploy/build.bat 2026-09-09 18:41:03 +08:00
AskaEth b62bb022bd fix(web): 构建后补回 assets/.gitkeep，保证新克隆可直接 go build 2026-09-09 18:39:00 +08:00
AskaEth 7d5d94f815 feat: M0-M2 骨架落地（服务端/前端/宿主/数据库/积分引擎） 
- server: Go 单二进制骨架，embed 内嵌前端，配置/迁移/HTTP 路由
- store: system.db + event.db 两套迁移，业务表 + 种子数据
- domain: 积分引擎（并列三口径/计分通道/流水/排名/破纪录）+ 68 个测试
- web: Vite + Vue 三入口骨架 + shared 层（类型/API/WebSocket 客户端）
- console: Electron 宿主骨架（选屏/防熄屏/进程守护/托盘）
 2026-09-09 18:36:40 +08:00
750 changed files with 164338 additions and 6 deletions
Expand all files Collapse all files

No files matched your search

.gitattributes
+22
View File
@@ -0,0 +1,22 @@
# Windows 批处理必须是 CRLF：cmd.exe 在纯 LF 下可能解析不了标签（:label）与多行 if 块
*.bat text eol=crlf
*.cmd text eol=crlf
# 其余文本统一 LF，避免跨平台 diff 噪声
*.go text eol=lf
*.ts text eol=lf
*.vue text eol=lf
*.css text eol=lf
*.html text eol=lf
*.json text eol=lf
*.yaml text eol=lf
*.yml text eol=lf
*.md text eol=lf
*.nsh text eol=crlf
# 二进制资源不做行尾转换
*.png binary
*.ico binary
*.woff2 binary
*.zip binary
*.exe binary
.gitignore
+14
View File
@@ -1,5 +1,6 @@
# 构建产物
dist/
debug/
*.exe
*.test
@@ -11,6 +12,14 @@ data/
rules/*
!rules/README.md
# 内部署名（构建期注入，绝不进仓库）
deploy/signature.local.txt
deploy/signature.build.txt
# 版本注入脚本（构建时由 deploy/prepare-extra.mjs 从仓库根 VERSION 生成）
deploy/version.gen.bat
# 安装器自定义脚本：许可页署名 + 上次安装目录记忆 + 防火墙入站规则（构建时生成）
console/resources/installer-custom.nsh
# 开发文档（内部设计文档，不进仓库）
devdocs/
@@ -29,6 +38,11 @@ logs/
# 前端
web/node_modules/
web/dist/
console/node_modules/
# 前端构建产物（构建时生成，随 Go embed 内嵌）
server/internal/webui/assets/*
!server/internal/webui/assets/.gitkeep
# 编辑器 / 系统
.vscode/*
README.md
+27 -6
View File
@@ -14,26 +14,47 @@
- **可追溯、可撤销**：草稿不上屏；发布后纠错走「撤销发布 → 改 → 重新发布」，全程留痕
- **变更历史**：仿 Git 图谱，一眼看清成绩是怎么变成现在这样的
- **现场公开**：积分明细可下钻，争议时一键推送到大屏
- **全屏公告**：推送后先全屏显示（5–120 秒），随即常驻大屏底部公告栏，直到替换或清除
- **分批发布**：一个项目分多场跑（如跑道 8 条、30 人分 4 场）时，**每跑完一批就能先发布一批**——空成绩只是提示、**不再挡发布**，未录的行自动跳过，补录后再发一次即自动重算；名次与积分先按已发布的那部分算，大屏立刻有内容
- **实时赛况大屏页**：新增「实时赛况」页，显示当前进行中项目的实时排名（名次 / 运动员·队 / 单位 / 成绩）；1 个项目单栏、2 个自动左右分栏；当前项目按「人工指定 → 排期命中（开始时间前后 30 分钟）→ 最近发布过成绩的项目」判定，**下一场开始前持续显示上一场**；可在「大屏控制 → 实时赛况」卡片配置
- **显式批次层**：组别之下可再分批（`第 1 批`、`第 2 批`…），录入页按批筛选、只在自己这一批里找人；支持手动勾选设置批次、报名表可选列 `heat`、以及按人数「一键均分」。**批次只是录入 / 展示分组，不参与算分**——名次与积分仍按「小项 + 组别」计算
- **成绩框实时提示**：聚焦成绩格打字时旁边浮出小气泡——合法显示解析结果（`1:06` → `= 66 秒`）、可疑 / 不合法直接说原因并带出那一格原文；不挡输入、不改行高，与发布前防呆同一套口径
- **窄屏 / 手机可用**：管理面板适配窄窗口与手机浏览器（局域网访问 `/admin`）：侧栏收成抽屉、宽表格横向滑动、对话框不超出屏幕、触控目标放大
- **小项类型齐全**：个人 / 团体 / 对抗比赛 / **个人+团体**（同一个项目同时按个人与团体通道记分）
- **多显示器**：支持多屏各锁一页（kiosk 全屏），也能在管理端为指定显示器单独开窗或收窗；「大屏控制」页的「在线大屏」列表实时显示每个在线实例（含局域网浏览器打开的 `/display`）当前在哪一页，可逐屏 / 逐设备单独切页
- **规则可配置**：积分规则以规则包（YAML）描述，可导入导出、跨赛事复用
- **赛事独立存档**：每个赛事一个独立项目目录，可整包导出/导入
- **结果导出**：Excel 总表与分项可单独导出
- **运动员名册**：启用 / 停用 / **彻底删除**三档——「停用」保留全部历史数据、随时可启用；「彻底删除」把人员档案连同他名下的报名、成绩与积分流水一起删掉且不可恢复，并自动按新排序重算受影响小项的排名与积分（大屏同步更新）
- **参赛单位名册**：启用 / 停用 / **彻底删除**三档——「停用」保留全部历史数据、随时可启用；「彻底删除」是**假删除**，只把单位从列表里移除（界面上没有恢复入口），它的报名、成绩、积分流水与名下运动员全部保留，**积分榜不会变化**；报名表里再次用到该单位编码会让它自动恢复
- **赛事独立存档**：每个赛事一个独立项目目录，整包可导出/导入（含会标、背景图、单位 logo 与上传的字体），并可在管理端页内一键切换当前赛事
- **结果导出**：Excel 总表、全部（多 sheet）、**全部（单页）**、分项成绩表、单位积分明细可分别导出；「积分榜」页三个榜单的卡片头各有自己的明细导出——单位总分榜**导出总明细**（总表 + 每个有数据的单位一张分表）、团体奖牌榜**导出奖牌明细**（逐枚奖牌列出来源）、个人积分榜**导出个人明细**（逐条得分来源，与个人榜一致且不受折算系数影响），展开单位还能**导出该单位明细**
- **日志可复盘**：服务端在数据目录 `logs\` 下按「放行 / 拦截」两类分目录落盘——`operations\` 记放行的写操作与常规运行日志，`interceptions\` 记我们主动拦下的报错与服务端异常；拦截日志带中文原因与**拦截点 `文件:行 函数名`**、操作人与 requestId，两类都按天 + 按大小轮转并自动清理旧文件（见部署指南第 10 节）
- **成绩写法容错**：时间类接受 `66`、`66.33`、`1:06`、`1:06.33`、`1分06秒`、`1小时2分3秒` 等写法（全角冒号 / 全角数字也认），秒位 ≥ 60 会被拒但报错写明原因；成绩格里的示例是带「例」字的淡色斜体灰字，不会和已填内容混淆
- **单位 logo**：**大屏端**的积分榜、奖牌榜、分项成绩表与个人榜都会显示参赛单位 logo（个人榜显示在姓名前；管理端页面只负责上传与配置，不显示 logo）
- **大屏字体可配**：标题字体与正文字体可在「系统设置 → 赛事信息 → 字体」里从四款内置字体中选，或上传自己的字体（ttf / otf / woff / woff2，单个不超过 20 MiB）；只作用于大屏，加载失败自动回落默认字体，字体文件随赛事项目包一起导出/导入
## 快速开始
1. 解压部署包
2. 双击 `scoreboard.exe`（Linux 下执行 `./scoreboard`）
2. 双击 `Scoreboard_Console.exe`（现场推荐：守护服务端、把大屏投到扩展屏、防熄屏、开机自启）
3. 浏览器打开终端提示的地址
```
大屏 http://<主机IP>:8080/display
管理面板 http://<主机IP>:8080/admin
大屏 http://<主机IP>:19540/display
管理面板 http://<主机IP>:19540/admin
```
> 也可以直接双击 `scoreboard.exe`（Linux 下执行 `./scoreboard`）只跑服务端，大屏投放与进程守护需自行接管。
>
> 完全离线运行，不依赖外网，不需要安装任何运行时。
## 文档
- 使用说明、操作手册：随正式版发布补充
- [升级说明](./docs/升级说明.md)：**每次升级前先看**——这一版改了什么、升级后要补做什么、分数/奖牌为什么变化、5 分钟核对清单
- [上线检查清单](./docs/上线检查清单.md)：比赛当天照着走一遍的核对表（含交付物、目标机、首次启动、赛事项目包与规则包导入、大屏与公告、备份与回退）
- [部署指南](./docs/部署指南.md)：运行环境、安装与首次启动、端口与配置、大屏接线、赛事项目包导入/切换、备份恢复、故障排查
- [使用手册](./docs/使用手册.md)：角色权限、各功能页面的操作步骤、大屏端使用、常见操作问题
- [报名名单导入规范](./docs/报名名单导入规范.md)：报名表该用什么格式、11 列逐列怎么填、个人/团体/「个人+团体」三种项目的填法、常见报错对照（可直接发给各单位填表人）
- [常见问题（FAQ）](./docs/常见问题.md)：账号、成绩与积分、大屏、数据备份、导出导入
- 规则包格式：见 [rules/README.md](./rules/README.md)
## 许可证
Scoreboard.png
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.5 MiB

VERSION
+1
View File
@@ -0,0 +1 @@
dev_0.5.9
config.yaml
+24
View File
@@ -0,0 +1,24 @@
# 服务端启动配置
server:
host: 0.0.0.0
port: 19540
# WebSocket 跨站 Origin 白名单（可选，path.Match 模式）；同源与不带 Origin 的客户端始终放行
allowedOrigins: []
# 运行时数据目录（数据库 / 备份 / 上传资源）
dataDir: data
# 自动备份：按间隔把 system.db 与赛事库快照到 dataDir/backups
backup:
intervalMinutes: 5 # 备份间隔（分钟）；<=0 关闭自动备份
keep: 20 # 每个库滚动保留的份数，超出的旧备份自动删除
log:
level: info # debug | info | warn | error（作用于控制台与 operations 放行类日志）
# 日志根目录，其下分两类：
# operations/ 放行的操作 + 常规运行日志（按上面的 level 过滤）
# interceptions/ 我们主动拦截的报错 + 服务端异常（固定按 debug 采集，便于复盘"为什么被拦/在哪一行拦的"）
# 留空 = <数据目录>/logs
dir: ""
maxSizeMB: 20 # 单个日志文件大小上限（MB）；<=0 用内置默认
keepFiles: 10 # 每类保留的份数（含当前文件）；<=0 用内置默认
console/.gitignore
+3
View File
@@ -0,0 +1,3 @@
# deploy/build.bat 在打包前把 docs/使用说明.txt 暂存到这里（extraFiles 指向该目录）
extra/*
!extra/.gitkeep
console/README.md
+209
View File
@@ -0,0 +1,209 @@
# Scoreboard Console
赛事积分榜系统的桌面宿主（Electron）。它只做六件事：
1. 拉起并守护同目录（或配置指定）的 `scoreboard.exe`，把它的 stdout/stderr 接管到管理窗口与日志文件；
2. 用 `screen.getAllDisplays()` 枚举显示器，把大屏页面投到扩展屏；
3. `powerSaveBlocker.start('prevent-display-sleep')` 防熄屏；
4. 提供启动/停止/状态/日志的管理 GUI 和托盘菜单；
5. 默认注册登录项但不启用（不随系统启动），可在服务管理窗口的「开机自启」开关里开启；
6. 在服务管理窗口展示服务端在线的大屏实例（`GET /api/display/instances`）。
规范来源：`devdocs/06-大屏端设计.md` 第 6 节、`devdocs/10-部署与现场方案.md` 第 4 节。
## 目录结构
```
console/
├── package.json # main 指向 main/index.js；electron-builder 配置
├── config.json # 运行配置模板（打包后首次启动复制到用户数据目录，改这里的只在开发态生效）
├── main/
│ ├── index.js # 应用入口：窗口 / 托盘 / IPC / 生命周期
│ ├── config.js # 配置加载与合并、exe 路径解析
│ ├── datadir.js # 数据目录解析 + 旧数据一次性迁移
│ ├── datadir.test.js # 数据目录的单元测试
│ ├── userpaths.js # 配置/规则目录解析 + 首次复制迁移（config.json / config.yaml / rules）
│ ├── userpaths.test.js # 配置/规则路径的单元测试
│ ├── service.js # 服务端子进程守护：spawn / 日志转发 / 健康检查 / 自动重启
│ ├── service.test.js # 守护逻辑的单元测试（注入假 spawn/时钟/HTTP）
│ ├── instances.js # 已连接大屏实例看板：复用管理面板登录态读 /api/display/instances
│ ├── account.js # 管理员账号重置：参数校验 + 调 scoreboard.exe passwd
│ ├── displays.js # 大屏窗口管理：选屏、kiosk、排布、24h 重载
│ ├── displays.test.js # 大屏窗口模式与 URL 一致性的回归测试
│ ├── log-bus.js # 日志环形缓冲 + 落文件 + 广播
│ └── tray-icon.js # 托盘图标（base64 内嵌，无外部资源文件）
├── scripts/
│ └── check-syntax.js # pnpm check：跨平台递归 node --check
├── extra/ # 打包前由 deploy/prepare-extra.mjs 暂存 使用说明.txt 与 报名名单导入规范.txt（extraFiles 指向它）
└── renderer/
├── index.html # 管理窗口（含自绘标题栏）
├── styles.css
├── app.js
├── preload.js # 管理窗口的 contextBridge 白名单
├── display-preload.js # 大屏窗口的 window.displayShell 白名单（窗口级全屏状态，供页面收放自绘标题栏）
└── shell-preload.js # 服务端管理面板窗口的 window.desktopShell 白名单（窗口控制 + 显示器菜单）
```
## 运行方式
```bash
cd console
pnpm install # 首次需要下载 Electron
pnpm start # 等价于 electron .
```
开发时把 `scoreboard.exe` 放在以下任一位置都能被找到（`config.json` 里的相对路径会按顺序探测）：
1. `console/`
2. 当前工作目录
3. 仓库根目录
4. `dist/`
现场（部署包）形态：
```
scoreboard-windows-amd64/
├── Scoreboard_Console.exe
├── resources/app.asar # 内含 main/ renderer/ config.json
├── config.json # exe 旁边的配置模板（首次启动复制到用户数据目录）
├── scoreboard.exe
├── config.yaml # 服务端配置模板（同上）
├── rules/ # 规则包模板（同上）
└── logs/console.log # 运行时生成（日志仍留在安装目录）
```
数据、配置与规则都不在安装目录里，都在 `%LOCALAPPDATA%\ScoreboardConsole\` 下（见下文两节）。
打包后 `config.json` 读取顺序：`SCOREBOARD_CONSOLE_CONFIG` 环境变量 → 用户数据目录 `<用户根>\console\config.json`（首次启动从 exe 旁边的模板复制）。开发态（`pnpm start`）三者都不接管，仍用仓库里的 `console/config.json`。
## 数据目录（重要）
electron-builder 生成的卸载器结尾是 `RMDir /r $INSTDIR`，而**覆盖安装会先静默跑一遍旧版卸载器**，所以装在安装目录里的 `data\` 会被整体删掉；`%APPDATA%\Scoreboard Console` 卸载时同样会删，因此也不能用 `app.getPath('userData')`。最终方案：
| 场景 | 数据目录 |
| --- | --- |
| 打包态，`server.dataDir` 留空（默认） | `%LOCALAPPDATA%\ScoreboardConsole\data`（卸载器不碰这个位置） |
| 配置了 `server.dataDir` | 配什么用什么：绝对路径直接用；相对路径以安装目录为基准 |
| 开发态（`pnpm start`），`server.dataDir` 留空 | 不接管，沿用服务端默认（工作目录下的 `data`），仓库里的 `data/` 不受影响 |
- Console 把最终目录通过服务端的 `-data <绝对路径>` 传下去，`passwd` 子命令带同一个参数，保证改的是同一个库里的账号；
- 迁移只在**打包态**做一次：**目标目录为空（或不存在）且 `<安装目录>\data` 有数据**时，用 `fs.renameSync` 把旧目录整体改名过去（同盘秒完成）。跨盘、权限不足等任何失败都只记日志，旧数据原地保留；
- **「没有旧数据」与「读不到旧目录」分开处理**：旧目录不存在/存在但空才是 `no-legacy`（不写日志）；旧目录读不出来（EACCES、ENOTDIR 等）返回 `legacy-unreadable` 并写一条「读不到旧数据目录」警告，绝不当成「没有旧数据」静默跳过（回归测试见 `main/datadir.test.js`）；
- 两边都有数据时**不做任何动作**，只写一条醒目日志提示人工确认，两份都不会被自动删除；
- 迁移结果与最终数据目录都写进 `logs/console.log`（搜「数据目录」「已把旧数据从」）；
- 数据目录若仍在安装目录内，启动时会额外打一条警告。
改完 `datadir.js` 跑 `node --test main/datadir.test.js`（Node 内置测试运行器，无额外依赖）。
## 配置与规则目录（重要）
同样因为卸载器会删掉整个安装目录，随包的 `config.json`、`config.yaml`、`rules\` 也不放在安装目录里，而是跟数据目录同一基座：
| 内容 | 打包态（`planUserPaths` mode=`user`） | 开发态（mode=`install`） |
| --- | --- | --- |
| Console 配置 | `<用户根>\console\config.json` | 仓库 `console/config.json` |
| 服务端配置 | `<用户根>\config.yaml` | 仓库 `config.yaml` 的位置不变 |
| 规则目录 | `<用户根>\rules\` | 仓库 `rules/` |
（`<用户根>` = `%LOCALAPPDATA%\ScoreboardConsole`，与数据目录同一处。）
- `userpaths.js` 只做三件事：解析这三个落点、首次复制、失败回落；`planUserPaths` 是纯函数（只算路径），`prepareUserPaths` 才碰磁盘，便于单测；
- **首次运行复制**：目标不存在且安装目录里有那份模板 → `fs.copyFileSync` / `fs.cpSync`（规则目录先拷到 `<target>.tmp-<pid>` 再整体 rename，失败不会留下半份）。安装目录那份**留作模板**，不做移动；
- **已存在就绝不覆盖**：用户目录里已经有的那份一律优先，既不覆盖也不删除（用户改过的配置、自己加的规则包都不会被模板顶掉）；
- 拉起服务端时 `-config` 的值被换成 `<用户根>\config.yaml` 的绝对路径（`withConfigArg`：参数里有 `-config` 就改值，没有就补一条），`passwd` 用同一份；这样服务端读的配置不再取决于 cwd；
- 任一项目标目录建不出来或不可写时只记日志并**回落到安装目录里那份**（`serverConfig` 回落时返回 `null`，拉起服务端时沿用 `server.args` 原值），绝不抛异常、绝不删用户文件；
- 拿不到 `%LOCALAPPDATA%` 时三项全回落安装目录并记一条警告；
- 日志文件 `logs/console.log` 是个例外：仍然相对**部署包根目录**（打包态 = 安装目录，开发态 = `console/`）解析，不跟着配置搬（易失的排查材料，搬了反而与文档、现场习惯不一致）。
改完 `userpaths.js` 跑 `node --test main/*.test.js`。
## 行为说明
| 场景 | 行为 |
| --- | --- |
| 只有一块屏 | 窗口化（屏幕 80% 大小、居中），不做多屏编排，**不跟随** `display-metrics-changed`（分辨率/缩放变化不重排，行为冻结）；`display-added` / `display-removed` 一直听着，电视插回来会自动排布回 kiosk。监听常驻、只有 `closeAll()`（服务停止 / 应用退出）才摘（回归测试见 `main/displays.test.js`）；`F11` 手动切换全屏，窗口级全屏状态经 `display-preload.js` 下发给页面，页面据此收起自绘标题栏。窗口化窗口**不置顶、不穿透**：F11 全屏完全由用户控制，置顶会把它变成一块收不掉、盖住一切的覆盖层 |
| 模式与 URL | **必须永远一致**：模式（窗口化 / kiosk）记在窗口的 entry 上，谁改模式谁按新模式重载 URL。`layout()` 只对排布自己开的窗口套用全局 `single`，管理面板手动开的窗口保持自己的模式——否则会出现「窗口化窗口被改成 kiosk 全屏、URL 里还留着 `windowed=1`」这种页面认知与窗口真实模式脱钩、标题栏画反的问题（回归测试见 `main/displays.test.js`）|
| 多块屏 | 除内置屏外的每块屏一个 kiosk 窗口，按 `display.bounds`（DIP）定位，光标由页面 CSS 隐藏。窗口**默认吞掉鼠标、不穿透**：`setIgnoreMouseEvents(true)` 的语义是「本窗口忽略鼠标」，点击会落到它后面的窗口或桌面上（现场想防的误触反而变成误点别的东西），被忽略鼠标的窗口也点不活、抢不回前台；只有确实要把大屏当纯展示层、同一块屏上还要操作别的窗口时才显式配 `display.allowClickThrough: true`。这个开关是从 `display.ignoreMouse` **改名**来的：旧版默认穿透，而且旧版模板已经把 `ignoreMouse: true` 写进了现场机器的用户配置（`userpaths.js` 不覆盖用户文件），只改默认值救不了老机器——换个新键名，旧键自然失效；启动时若发现配置里还留着旧键，会在 `logs/console.log` 里记一条提示（只记一次），说明它已废弃、现在默认不穿透、想穿透该写哪个键。窗口**置顶在 `screen-saver` 层级**（Windows 上 `setAlwaysOnTop(true)` 的默认层级 `floating` 仍画在任务栏下面，只有 pop-up-menu 及以上才压得住任务栏），所以别的窗口拖到这块屏上盖不住它、任务栏也盖不住它，被盖住后点一下就能回到最前。调用顺序**必须**是「先 `setBounds` 定位 → 再 `setKiosk(true)` → 最后置顶」：反过来会把窗口从真正的全屏态拽回「恰好铺满该屏的无边框窗口」，既不是 topmost、也压不住任务栏（回归测试见 `main/displays.test.js`）|
| 选屏 | 运行时枚举，不写死坐标；`selection` 可选 `all-secondary`（默认，用 `display.internal` 排除内置屏）/ `all` / `specified` |
| 页面锁定 | 每块屏各锁一页，URL 形如 `http://127.0.0.1:19540/display?page=standings&lock=1&screen=<id>&instance=<host>-<id>`，页序按 `display.pages` 轮转 |
| 防熄屏 | Console 启动即生效，退出时释放；前台后台都算 |
| 服务端就绪 | 首次 `/api/health` 通过后开大屏窗口；等待超过 `display.waitForServerMs` 也先开，避免现场只见桌面 |
| 服务端崩溃 | 按 `restartDelayMs` **线性**退避（第 N 次等 N × `restartDelayMs`，最多 5 倍）自动重启（`maxRestarts=0` 为无限）；持续健康 `healthyResetMs` 后崩溃计数清零；恢复健康后自动重载大屏 |
| 服务端按设计退出 | 切换赛事 / 一键恢复时服务端**先回执 200 再自己优雅退出**（退出码 0）。这种退出**不当崩溃**：状态是「重启中」（黄灯，不是红灯）、崩溃计数不 +1、同样按 `restartDelayMs` 自动拉起。判定见 `service.js` 的 `isPlannedExit`：退出码 0 **且**落在预期退出窗口内（最后一次健康检查通过后最多 15 秒，HealthInterval 更大时按两个探测周期放宽）——刚起来就退 0 或卡死很久才退 0 都仍按崩溃处理 |
| 数据目录 | 默认 `%LOCALAPPDATA%\ScoreboardConsole\data`（安装目录之外，覆盖安装/卸载都不删），启动时按 `-data <绝对路径>` 交给服务端；打包态首次启动做一次性迁移（见「数据目录」一节），开发态不接管 |
| 配置与规则 | 同样在 `%LOCALAPPDATA%\ScoreboardConsole\`（`console\config.json`、`config.yaml`、`rules\`），打包态首次从安装目录复制、之后只用用户目录那份；拉起服务端时 `-config` 传绝对路径（见「配置与规则目录」一节） |
| 停止服务 | 先 `POST server.shutdownPath` 并带 `X-Shutdown-Token`（启动时用 `crypto.randomBytes(32)` 生成，经环境变量 `SCOREBOARD_SHUTDOWN_TOKEN` 只交给该子进程）请求服务端优雅关闭；受理后最多等 `shutdownTimeoutMs`，超时或接口不可用（404/连接失败）再强杀 |
| 已连接大屏实例 | 管理窗口打开时每 5 秒读一次服务端 `GET /api/display/instances`（复用管理面板的 `scoreboard_session` Cookie，需记录员及以上），显示实例数、页面名与在线状态；窗口隐藏即停表，未登录/服务未启动时显示占位文案 |
| 关管理窗口 | 只隐藏到托盘，服务端继续运行；退出必须走托盘「退出」 |
| 开机自启 | 默认「已注册但未启用」；在服务管理窗口的「开机自启」开关里控制（`startup.openAtLogin`），仅打包后的 Windows/macOS 生效，开发态不注册 |
| 窗口外观 | 管理窗口与服务端管理面板窗口都是 `frame: false` 无边框，标题栏与最小化/最大化/关闭三键由页面自绘（拖拽区 `-webkit-app-region: drag`，按钮 `no-drag`，双击标题栏切最大化，关闭键 hover 变红） |
| 服务端管理面板 | 用独立无边框 Electron 窗口加载 `http://127.0.0.1:<port>/admin`（`shell-preload.js` 暴露 `window.desktopShell`），不再调系统浏览器；面板页在浏览器里直接打开时标题栏自动不渲染 |
| 显示器菜单 | 面板页的「大屏控制 → 显示器」卡片经 `display:list` / `display:open` / `display:close` / `display:relayout` 指挥本机开窗：按屏创建、聚焦、收窗。**全屏只在「多于一块屏 + 非主屏」时放行**，判定在主进程做，页面传 `fullscreen: true` 也会被降级为窗口化；面板页只拿到这几条白名单通道，拿不到 `ipcRenderer` |
| 管理员账号 | 主进程 `spawn` 同目录 `scoreboard.exe passwd -config <同一份配置> -data <同一个数据目录> -user <当前用户名> -new-username <新用户名> -password <新密码>`（留空 = 不改 / 随机生成）。本机进程、不经 HTTP，因此免登录验证；用户名/密码含空格、制表符或换行会被主进程拒绝，密码不进日志。`passwd` 会作废该用户全部会话，UI 提交前二次确认并提示 |
| 日志 | 内存环形缓冲（`log.maxLines`）+ 文件 `logs/console.log`（超 `maxFileBytes` 轮转一份 `.1`，轮转前会删掉旧 `.1` 以兼容 Windows）；文件固定落在部署包根目录（打包态 = 安装目录），不随配置搬到用户数据目录；管理窗口按同一个 `log.maxLines` 截断（超上限从头部丢，长跑不变卡） |
| 服务管理窗口的路径显示 | 「服务端程序」「配置文件」两行分别是解析出的 `scoreboard.exe` 与 Console 自己那份 `config.json` 的绝对路径（打包态后者在用户数据目录里，见上一节） |
## 配置项（`config.json`；打包态生效的是用户数据目录里那份）
| 键 | 默认值 | 说明 |
| --- | --- | --- |
| `server.exe` | `scoreboard.exe` | 相对路径会以部署包根目录（打包态 = exe 所在目录，开发态 = `console/`）、当前目录、上级目录、`dist\` 依次探测，也可写绝对路径 |
| `server.args` | `["-config","config.yaml"]` | 传给服务端的参数；其中 `-config` 的值会被换成解析出的绝对路径（`<用户根>\config.yaml`），其余参数（如 `-project`）原样传 |
| `server.dataDir` | `""` | 数据目录；空串 = 用默认位置（打包态 `%LOCALAPPDATA%\ScoreboardConsole\data`），填了就按它来（相对路径以部署包根目录为基准）。Console 会把它作为 `-data <绝对路径>` 追加到服务端参数后 |
| `server.host` / `server.port` | `127.0.0.1` / `19540` | 健康检查、关闭握手与管理面板地址（`0.0.0.0` 会自动换成回环地址探测） |
| `server.autoStart` | `true` | Console 启动后是否立刻拉起服务端 |
| `server.healthIntervalMs` | `5000` | 健康检查间隔 |
| `server.restartDelayMs` | `3000` | 重启基础退避：**第 N 次等 N × 本值**（×1..×5，线性，不是翻倍） |
| `server.maxRestarts` | `0` | 0 = 无限重启 |
| `server.shutdownPath` | `/api/shutdown` | 优雅关闭握手接口（需服务端实现并校验 `X-Shutdown-Token`），不可用时回退强杀 |
| `server.shutdownTimeoutMs` | `5000` | 服务端受理关闭请求后等待其自行退出的上限，超过则强杀 |
| `server.healthyResetMs` | `60000` | 连续健康多久后清零崩溃计数 |
| `display.selection` | `all-secondary` | `all-secondary` / `all` / `specified` |
| `display.displays` | `[]` | `specified` 时生效，填 display id 或 0 起序号 |
| `display.pages` | `["standings","medals","individual","results"]` | 按屏序轮转锁定；只填大屏支持的页名 |
| `display.pageParam` | `page` | 页面 URL 参数名 |
| `display.kiosk` | `true` | 多屏时是否 kiosk（单屏恒窗口化） |
| `display.allowClickThrough` | `false` | 多屏 kiosk 窗口是否**允许点击穿透**（`setIgnoreMouseEvents(true)`）。写 `true` 后该窗口忽略所有鼠标事件：点击落到它后面的窗口/桌面（现场误触会点到别的东西），大屏也点不活、被盖住后抢不回前台。只把大屏当纯展示层、且要在同一块屏上操作别的窗口时才开 |
| `display.ignoreMouse` | — | **已废弃 → 见 `display.allowClickThrough`**。旧版默认 `true` 且被旧模板写进现场机器的用户配置，只改默认值救不了老机器，所以换了键名；本键现在**完全不读**，配置文件里留着它只会让启动日志多一条提示，不影响行为 |
| `display.reloadEveryHours` | `24` | 定时重载兜底，0 = 关闭 |
| `display.waitForServerMs` | `20000` | 服务端未就绪时开大屏的兜底等待 |
| `display.backgroundColor` | `#0b0f1a` | 窗口底色，减少加载白闪 |
| `startup.openAtLogin` | `false` | 默认注册但不启用（任务管理器可见、已禁用）；在服务管理窗口「开机自启」开关里控制（开发态不注册） |
| `admin.width` / `admin.height` | `1280` / `860` | 管理窗口初始尺寸（服务端管理面板窗口按 `width` 不小于 1100 取用） |
| `log.maxLines` / `log.file` / `log.maxFileBytes` | `2000` / `logs/console.log` / `4194304` | 日志缓冲与文件；`log.file` 相对部署包根目录解析（不随配置搬到用户数据目录） |
配置缺项自动用内置默认值，文件不存在或 JSON 语法错误时回落到全默认值，并在管理窗口顶部给出提示。配置里如果还留着已改名的旧键（目前是 `display.ignoreMouse`），启动时会在 `logs/console.log` 里记一条中文提示（只在启动记一次，不随大屏重排重复刷），说明该键已废弃、现在默认不穿透、要穿透该写哪个键；旧键的值一律忽略，**不会**被自动改写进用户的配置文件。
## 打包（electron-builder）
`package.json` 里已写好 `build` 段：
```bash
cd console
pnpm install
pnpm check # 跨平台语法检查（scripts/check-syntax.js）
pnpm dist # electron-builder --win --x64 → ../dist/console/
pnpm pack # 只出目录，不生成安装包，便于现场调试
```
- 产物：NSIS 安装包 + zip，文件名形如 `Scoreboard Console-<版本>-x64.*`。`<版本>` 不是手写的：`deploy/prepare-extra.mjs` 在打包前读仓库根 `VERSION`（当前 `dev_0.1.8`）去掉 `dev_` 前缀写进 `console/package.json` 的 `version`，`artifactName` 用 `${productName}-${version}-${arch}.${ext}` 展开 —— 也就是说**这里不要手改版本号**，改仓库根的 `VERSION`。
- `extraFiles` 会把 `../dist/scoreboard.exe`、`../config.yaml`、`config.json`、`../rules` 拷到安装目录 —— 这四样里的后三样（`config.json`、`config.yaml`、`rules/`）在打包态只当**模板**：首次启动时复制到用户数据目录，之后 Console 与 `backup.bat` 都只用用户目录那份（见「配置与规则目录」一节）。`config.json` 缺失时 Console 会回落到内置默认值。
- 部署包根目录的说明书是可选的：`deploy/prepare-extra.mjs` 在打包前按一张清单暂存到 `console/extra/`（`extraFiles` 会把该目录内容平铺到安装目录根）：`docs/使用手册.md` → `使用说明.txt`，`docs/报名名单导入规范.md` → `报名名单导入规范.txt`（各自优先取 `docs/` 下的同名 `.txt`）。缺哪个就在构建日志里注明并跳过。
- 图标在 `resources/icon.ico`（`package.json` 的 `win.icon` 指向它）。
- 主程序文件名由 `win.executableName` 决定，现在是 `Scoreboard_Console.exe`；`productName` 仍是 `Scoreboard Console`（显示名、`userData` 目录不变）。
- `nsis.include` 指向 `resources/installer-custom.nsh`（构建时由 `deploy/prepare-extra.mjs` 生成，已 gitignore）：许可页顶部文案 + 记住上次安装目录（重装时默认沿用，不退回系统默认路径）。
- 已在 Windows 构建机上通过 `deploy\build.bat` 实跑（含 `pnpm dist`，产出 NSIS 安装包 + zip）；Linux 开发机未安装 Electron/electron-builder。
## 尚未实机验证
以下内容只做了静态语法检查，需要在 Windows + 真实多显示器环境跑一遍：
- 多屏 kiosk 定位与 `display-metrics-changed` 重排（改分辨率 / 缩放 / 插拔 HDMI）。
- kiosk 窗口的置顶（`setAlwaysOnTop(true, 'screen-saver')`）与任务栏覆盖：能否稳定压住任务栏、别的窗口拖到该屏上会不会盖住它、点击后能否回到最前——`screen-saver` 层级在 Windows 上的实际效果只能在真机上验；`setKiosk` / `setBounds` 的先后顺序同理（Linux 开发机没有 Electron 运行时）。
- 管理面板显示器菜单：真正的 kiosk 全屏 / 窗口化结果、`screen.getAllDisplays()` 的 `label` 与主屏判定、`display:list` 返回的 scaleFactor 是否与现场一致。
- `powerSaveBlocker` 在长时间后台下的实际效果。
- 托盘图标在 Windows 任务栏的显示效果（16px 缩放）。
- `scoreboard.exe` 真实拉起、日志转发、健康检查与崩溃重启的端到端链路。
- 数据目录迁移实机路径：老版本安装目录里的 `data\` 是否被整体搬到 `%LOCALAPPDATA%\ScoreboardConsole\data`、跨盘安装（安装目录在 D 盘、`%LOCALAPPDATA%` 在 C 盘）时的失败日志与「旧数据原地保留」表现。
- 配置/规则首次复制实机路径：老版本升级到本版本后，安装目录里的 `config.json` / `config.yaml` / `rules\` 是否被复制到 `%LOCALAPPDATA%\ScoreboardConsole\` 下对应位置、改过配置后覆盖安装是否仍然生效、`%LOCALAPPDATA%` 不可写（或被杀毒软件拦截）时是否只记日志并回落到安装目录里那份。
- electron-builder 打包已通过 `deploy\build.bat` 实跑；NSIS 安装包在真机上的安装 / 卸载流程尚未验证。
console/config.json
+39
View File
@@ -0,0 +1,39 @@
{
"server": {
"exe": "scoreboard.exe",
"args": ["-config", "config.yaml"],
"dataDir": "",
"host": "127.0.0.1",
"port": 19540,
"autoStart": true,
"healthIntervalMs": 5000,
"restartDelayMs": 3000,
"maxRestarts": 0,
"shutdownPath": "/api/shutdown",
"shutdownTimeoutMs": 5000,
"healthyResetMs": 60000
},
"display": {
"selection": "all-secondary",
"displays": [],
"pages": ["standings", "medals", "individual", "results"],
"pageParam": "page",
"kiosk": true,
"allowClickThrough": false,
"reloadEveryHours": 24,
"waitForServerMs": 20000,
"backgroundColor": "#0b0f1a"
},
"startup": {
"openAtLogin": false
},
"admin": {
"width": 1280,
"height": 860
},
"log": {
"maxLines": 2000,
"file": "logs/console.log",
"maxFileBytes": 4194304
}
}
console/extra/.gitkeep
View File
Whitespace-only changes.
console/installer/art-gen/gen_art.py
+597
View File
@@ -0,0 +1,597 @@
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""自绘安装器的位图素材生成器（构建期工具，产物随仓库一起提交）。
为什么要有这个脚本：安装器窗口是 NSIS 自绘的无边框窗口（760×480），界面本身就是一堆
钉死在固定坐标上的位图，NSIS 只负责「把图贴到点上」。窗口尺寸、文案、配色每改一次就要
重出一整套图，手工导图必然会出 1x/2x 不同步、半像素发虚、缺字形变方框这些问题，所以
整套素材全部由代码生成。
用法：
python3 console/installer/art-gen/gen_art.py
产出：
console/installer/art/1x/ 常规 DPI 用
console/installer/art/2x/ 4K@200% 缩放用（同一套常量乘 2）
debug/安装界面预览/06-五页预览.png 人眼验收用的五页联络图（不参与打包）
改了设计就重跑本脚本，不要手改 art/ 里的位图：改图不改脚本，下次重跑就被覆盖，
而且 1x/2x 会悄悄失去同步。
几条硬约定：
- 所有坐标/尺寸都按 1x 设计稿书写，2x 由同一套常量乘 2 得到，不写第二套数值；
- 「✕ / — / ✓ / 圆点」这类符号在 Noto Sans SC 里没有字形，一律用线段和圆画出来；
- 字体只用 noto-sans/sc 目录下的简体字重，tc（繁体）目录缺简体字形，会把字渲染成方框。
"""
import os
from PIL import Image, ImageDraw, ImageFont
# ---------------------------------------------------------------- 路径
HERE = os.path.dirname(os.path.abspath(__file__)) # console/installer/art-gen
REPO = os.path.dirname(os.path.dirname(os.path.dirname(HERE))) # 仓库根
ART_DIR = os.path.join(os.path.dirname(HERE), "art") # console/installer/art
CONTACT_SHEET = os.path.join(REPO, "debug", "安装界面预览", "06-五页预览.png")
# 图标源文件放在仓库根，打包脚本和安装器素材共用同一份，避免出现两个版本的应用图标
ICON_SRC = os.path.join(REPO, "Scoreboard.png")
# 字体不在仓库里（三套字重加起来 25MB，装进仓库不划算），所以按本机绝对路径引用；
# 换机器构建时把这个常量改掉即可，字体缺失会在 font() 里直接报错而不是悄悄退化
FONT_DIR = "/home/Aska/Fonts/noto-sans/sc"
def repo_version():
"""读仓库根 VERSION（版本号唯一真相），去掉 dev_ 前缀给安装包显示用。"""
with open(os.path.join(REPO, "VERSION"), encoding="utf-8-sig") as fh:
return (fh.readline().strip() or "0.0.0").removeprefix("dev_")
# ---------------------------------------------------------------- 配色
NAVY = "#0b1e3a" # 标题栏 / 品牌栏渐变起点
NAVY_END = "#16406f" # 品牌栏渐变终点
CONTENT_BG = "#f6f9fd" # 右侧内容区底色
TXT = "#16233a" # 正文深色
TXT_DIM = "#5a6b85" # 次要文字
BRAND_WEAK = "#8ba6c6" # 品牌栏弱文字
BRAND_WEAKER = "#6b86a8" # 品牌栏最弱（版本号）
PRIMARY = "#2f9bf0" # 主色
PRIMARY_HOVER = "#3fa9f5"
PRIMARY_PRESSED = "#1f86d8"
PRIMARY_SOFT = "#f0f6ff" # 次要按钮悬停底色
PRIMARY_SOFT_DOWN = "#dce9fa" # 次要按钮按下底色
CYAN = "#4fd8ff" # 品牌栏字标点缀
BORDER = "#cfdcec"
DIVIDER = "#e3ebf5"
CLOSE_HOVER = "#e5484d"
CLOSE_PRESSED = "#c93b40"
SUCCESS = "#34c759"
TB_DIVIDER = "#1e3e69" # 标题栏底部分隔线
TB_TEXT = "#cfe3ff"
TB_MIN = "#96afcd"
TB_MIN_HOVER = "#cfe3ff"
TB_CLOSE = "#bed2eb"
TB_HOVER = "#1b2d4a" # 白色 8% 叠在海军蓝上的等效色
TB_HOVER_DOWN = "#2d3e56" # 白色 14% 叠在海军蓝上
# ---------------------------------------------------------------- 版面
WIN_W, WIN_H = 760, 480
TITLE_H = 40
SIDE_W = 240
BRAND_H = WIN_H - TITLE_H
PAGE_X, PAGE_Y = SIDE_W, TITLE_H
PAGE_W, PAGE_H = WIN_W - SIDE_W, WIN_H - TITLE_H
PAD_L, PAD_T = 32, 28
CONTENT_W = PAGE_W - PAD_L * 2 # 456
DIVIDER_Y = 376 # 页面内按钮条的上边线
BTN_W, BTN_H = 108, 36
BTN_Y = 416
BTN_PRIMARY_X = 728 - BTN_W # 620，右边缘对齐内容区右边线
BTN_SECONDARY_X = 608 - BTN_W # 500，与主按钮间距 12
TB_MIN_BOX = (672, 0, 44, 40)
TB_CLOSE_BOX = (716, 0, 44, 40)
SS = 4 # 超采样倍数：PIL 画圆/圆角矩形没有抗锯齿，4 倍渲染再缩回来才有干净边缘
_font_cache = {}
def font(weight, size, k):
"""取字重字体；size 是 1x 设计字号，k 是当前渲染倍率（= 输出倍率 × 超采样倍数）。"""
key = (weight, size, k)
if key not in _font_cache:
path = os.path.join(FONT_DIR, "NotoSansSC-%s.otf" % weight)
if not os.path.exists(path):
raise SystemExit("字体缺失：%s（本机请确认 noto-sans/sc 三个字重在位）" % path)
_font_cache[key] = ImageFont.truetype(path, size * k)
return _font_cache[key]
def U(k):
"""返回 1x 设计坐标 → 渲染像素的换算函数。
统一四舍五入：设计稿里存在 12.5、11.5 这类半像素字号和坐标，不取整会让
线条落在半像素上，缩回来变成两行灰边。
"""
return lambda v: int(round(v * k))
def down(im):
"""超采样降采样，得到最终位图。"""
return im.resize((im.width // SS, im.height // SS), Image.LANCZOS)
def hgrad(w, h, c0, c1):
"""横向线性渐变。品牌栏底色与品牌栏位图共用本函数，两者叠加才不会露出接缝。"""
a, b = ImageColor_rgb(c0), ImageColor_rgb(c1)
im = Image.new("RGB", (w, h))
d = ImageDraw.Draw(im)
for x in range(w):
t = x / max(w - 1, 1)
d.line([(x, 0), (x, h)], fill=tuple(round(a[i] + (b[i] - a[i]) * t) for i in range(3)))
return im
def ImageColor_rgb(s):
s = s.lstrip("#")
return tuple(int(s[i:i + 2], 16) for i in (0, 2, 4))
def box(p, x, y, w, h):
"""1x 的 (x, y, 宽, 高) → PIL 的闭区间 bbox（PIL 的右下角是含在内的）。"""
return [p(x), p(y), p(x + w) - 1, p(y + h) - 1]
def text_top(d, p, x, y, s, f, fill):
"""按「字形可见顶部」定位。
中英文混排时 ascender 高度不一致（数字/英文比汉字矮），直接给 y 会让同一组的
几行文字看起来忽高忽低，所以按实际墨迹框归位。
"""
b = d.textbbox((0, 0), s, font=f, anchor="la")
d.text((p(x), p(y) - b[1]), s, font=f, fill=fill, anchor="la")
def text_bottom(d, p, x, y, s, f, fill):
"""按「字形可见底部」定位，用于版本号这种按底边距对齐的文字。"""
b = d.textbbox((0, 0), s, font=f, anchor="la")
d.text((p(x), p(y) - b[3]), s, font=f, fill=fill, anchor="la")
def text_center(d, p, cx, cy, s, f, fill):
"""按墨迹框居中，用于按钮文字。"""
b = d.textbbox((0, 0), s, font=f)
d.text((p(cx) - (b[2] + b[0]) / 2, p(cy) - (b[3] + b[1]) / 2), s, font=f, fill=fill)
def dot(d, p, cx, cy, r, fill):
"""画圆点。要点符号 fonts 里没有，只能画。"""
d.ellipse([p(cx - r), p(cy - r), p(cx + r), p(cy + r)], fill=fill)
def check(d, p, pts, color, width):
"""对勾用折线画。✓ 字形在 Noto Sans SC 里缺，硬渲染会出方框。"""
d.line([(p(x), p(y)) for x, y in pts], fill=color, width=p(width), joint="curve")
def paste_icon(im, p, x, y, w, h):
"""把应用图标等比缩放进 (x, y, w, h) 的方框并居中。
源图自带圆角透明背景，必须带 alpha 贴；另外先裁掉四周透明留白，否则同一张图
在标题栏和品牌栏两处的视觉大小会对不上。
"""
src = Image.open(ICON_SRC).convert("RGBA")
src = src.crop(src.getchannel("A").getbbox())
tw, th = p(w), p(h)
r = min(tw / src.width, th / src.height)
nw, nh = max(1, int(round(src.width * r))), max(1, int(round(src.height * r)))
src = src.resize((nw, nh), Image.LANCZOS)
im.paste(src, (p(x) + (tw - nw) // 2, p(y) + (th - nh) // 2), src)
# ---------------------------------------------------------------- 背景与框架
def draw_base(k):
"""底层：标题栏 + 品牌栏渐变 + 内容区底色。
品牌栏渐变在这里也要画一遍（上面还会贴 brand.bmp），这样底图本身就是完整的，
单独看 base.bmp 也不会露出一块空白。
"""
p = U(k)
im = Image.new("RGB", (p(WIN_W), p(WIN_H)), CONTENT_BG)
im.paste(hgrad(p(SIDE_W), p(BRAND_H), NAVY, NAVY_END), (0, p(TITLE_H)))
d = ImageDraw.Draw(im)
d.rectangle(box(p, 0, 0, WIN_W, TITLE_H), fill=NAVY)
return down(im)
def draw_brand(k):
"""品牌栏内容。底色是同一段渐变，贴在 base 的品牌栏上无缝。"""
p = U(k)
im = hgrad(p(SIDE_W), p(BRAND_H), NAVY, NAVY_END)
d = ImageDraw.Draw(im)
# 图标 x 与下方文字的左边距（36）取齐，不留出那 12px 的错位
paste_icon(im, p, 36, 48, 96, 96)
text_top(d, p, 36, 172, "赛事积分榜", font("Bold", 26, k), "#ffffff")
text_top(d, p, 36, 219, "S C O R E B O A R D", font("Medium", 11, k), CYAN)
text_top(d, p, 36, 250, "一拖二 · 实时积分大屏", font("Regular", 12, k), BRAND_WEAK)
text_top(d, p, 36, 272, "裁判长管理面板", font("Regular", 12, k), BRAND_WEAK)
# 版本号按「左边距 36 / 底边距 40」定位，底部对齐比顶部对齐更稳
# 版本从仓库根 VERSION 读（唯一真相）：烘焙进位图意味着发新版必须重跑本脚本，
# deploy/prepare-extra.mjs 里有一道校验，版本对不上会直接让构建失败，不会悄悄发错版本
text_bottom(d, p, 36, BRAND_H - 40, f"版本 v{repo_version()}", font("Regular", 11, k), BRAND_WEAKER)
return down(im)
def draw_titlebar(k):
"""标题栏：图标 + 标题 + 右侧最小化/关闭。
两个按钮图形按 44×40 按钮框居中画，和 tb-*.bmp 的图形位置严格一致 —— 悬停时
NSIS 用按钮位图盖住这块区域，位置不一致的话图形会跳一下。
"""
p = U(k)
im = Image.new("RGB", (p(WIN_W), p(TITLE_H)), NAVY)
d = ImageDraw.Draw(im)
paste_icon(im, p, 14, 10, 20, 20)
text_top(d, p, 44, 12, "赛事积分榜 安装程序", font("Medium", 14, k), TB_TEXT)
min_cx = TB_MIN_BOX[0] + TB_MIN_BOX[2] / 2
close_cx = TB_CLOSE_BOX[0] + TB_CLOSE_BOX[2] / 2
d.line([(p(min_cx - 7), p(20)), (p(min_cx + 7), p(20))], fill=TB_MIN, width=p(2))
d.line([(p(close_cx - 6), p(14)), (p(close_cx + 6), p(26))], fill=TB_CLOSE, width=p(2))
d.line([(p(close_cx + 6), p(14)), (p(close_cx - 6), p(26))], fill=TB_CLOSE, width=p(2))
# 底部分隔线画在标题栏位图内部（画在 base 上会被标题栏位图盖掉）
d.rectangle(box(p, 0, TITLE_H - 1, WIN_W, 1), fill=TB_DIVIDER)
return down(im)
# ---------------------------------------------------------------- 五个页面
def page_base(k):
"""页面公共底：内容区底色 + 按钮条上边线。"""
p = U(k)
im = Image.new("RGB", (p(PAGE_W), p(PAGE_H)), CONTENT_BG)
d = ImageDraw.Draw(im)
d.rectangle(box(p, 0, DIVIDER_Y, PAGE_W, 1), fill=DIVIDER)
return im, d
def page_head(d, p, k, title, desc=None):
text_top(d, p, PAD_L, PAD_T, title, font("Bold", 20, k), TXT)
if desc:
text_top(d, p, PAD_L, 62, desc, font("Regular", 13, k), TXT_DIM)
def draw_page_welcome(k):
p = U(k)
im, d = page_base(k)
page_head(d, p, k, "欢迎安装", "本向导将把《赛事积分榜》安装到这台计算机。")
items = [
"一拖二部署：一个服务端，同时带实时积分大屏与裁判长管理面板",
"完全离线运行，不需要外网",
"数据与赛事配置存在当前用户目录，覆盖安装不会丢",
]
f = font("Regular", 13, k)
y = 118
for it in items:
b = d.textbbox((p(52), p(y)), it, font=f, anchor="la")
# 圆点对齐每行墨迹的垂直中点，行内英文/数字混排时也不会跑偏
dot(d, p, PAD_L + 4, (b[1] + b[3]) / 2 / k, 4, PRIMARY)
d.text((p(52), p(y)), it, font=f, fill=TXT, anchor="la")
y += 32
return down(im)
def draw_page_license(k):
p = U(k)
im, d = page_base(k)
page_head(d, p, k, "许可协议", "请阅读以下条款。继续安装表示你接受这些条款。")
lines = [
"本软件以 MIT 许可协议发布，你可以自由使用、修改和分发。",
"分发或再发布时，必须保留原始的版权声明与许可声明。",
"本软件按「现状」提供，不附带任何形式的明示或默示担保。",
"因使用本软件造成的任何损失，作者不承担任何责任。",
]
f = font("Regular", 13, k)
y = 104
for ln in lines:
text_top(d, p, PAD_L, y, ln, f, TXT)
y += 22
# 只画外框，里面的协议正文由真控件渲染（位图放不下整篇协议）
d.rectangle(box(p, PAD_L, 196, CONTENT_W, 176), outline=BORDER, width=p(1))
return down(im)
def draw_page_dir(k):
p = U(k)
im, d = page_base(k)
page_head(d, p, k, "选择安装位置", "安装程序将把《赛事积分榜》装到下面的目录。")
# 这一条是「目录输入行」的外框：框内左侧跑真编辑框，右侧 96×34 的「浏览…」
# 按钮位图直接压在外框右端（框高 34 与按钮等高，所以按钮正好卡在框内）
d.rectangle(box(p, PAD_L, 110, CONTENT_W, 34), outline=BORDER, width=p(1))
text_top(d, p, PAD_L, 170, "安装模式", font("Medium", 13, k), TXT)
# 文字从 56 起排，左边 24px 留给单选钮位图
text_top(d, p, 56, 222, "仅为我安装（不需要管理员权限）", font("Regular", 12.5, k), TXT)
text_top(d, p, 56, 262, "为所有用户安装（会弹 UAC，并自动放行防火墙 19540）",
font("Regular", 12.5, k), TXT)
return down(im)
def draw_page_progress(k):
p = U(k)
im, d = page_base(k)
# 进度页正文区留空：阶段文案和进度条都用独立位图贴上去（NSIS 换图＝换状态）
page_head(d, p, k, "正在安装")
d.rounded_rectangle(box(p, PAD_L, 140, CONTENT_W, 8), radius=p(4), fill=DIVIDER)
return down(im)
def draw_page_finish(k):
p = U(k)
im, d = page_base(k)
page_head(d, p, k, "安装完成", "《赛事积分榜》已安装到这台计算机。")
# 成功标记在内容区水平居中：绿实心圆 + 白对勾
cx = PAGE_W / 2
cy = 164
d.ellipse([p(cx - 24), p(cy - 24), p(cx + 24), p(cy + 24)], fill=SUCCESS)
check(d, p, [(cx - 11, cy + 0.5), (cx - 3, cy + 8.5), (cx + 12, cy - 8.5)], "#ffffff", 3.5)
# 勾选项文字从 56 起排，左边 24px 留给勾选框位图
text_top(d, p, 56, 300, "立即运行 赛事积分榜", font("Regular", 13, k), TXT)
text_top(d, p, PAD_L, 336, "安装位置：D:\\Program Files\\Scoreboard_Console",
font("Regular", 11.5, k), TXT_DIM)
return down(im)
# ---------------------------------------------------------------- 按钮
def draw_button(k, label, w, h, kind, state):
"""圆角按钮三态。圆角外填内容区底色，贴到按钮条上才不会露出白角。"""
p = U(k)
im = Image.new("RGB", (p(w), p(h)), CONTENT_BG)
d = ImageDraw.Draw(im)
if kind == "primary":
bg = {"normal": PRIMARY, "hover": PRIMARY_HOVER, "pressed": PRIMARY_PRESSED}[state]
fg, border = "#ffffff", None
else:
bg = {"normal": "#ffffff", "hover": PRIMARY_SOFT, "pressed": PRIMARY_SOFT_DOWN}[state]
border = BORDER if state == "normal" else PRIMARY
fg = TXT
d.rounded_rectangle([0, 0, p(w) - 1, p(h) - 1], radius=p(8), fill=bg,
outline=border, width=p(1) if border else 0)
text_center(d, p, w / 2, h / 2, label, font("Medium", 13, k), fg)
return down(im)
def draw_tb_button(k, kind, state):
"""标题栏按钮。常态底色＝标题栏底色，贴上去和标题栏融为一体。"""
p = U(k)
im = Image.new("RGB", (p(44), p(40)), NAVY)
d = ImageDraw.Draw(im)
if kind == "close":
bg = {"normal": NAVY, "hover": CLOSE_HOVER, "pressed": CLOSE_PRESSED}[state]
fg = "#ffffff" if state != "normal" else TB_CLOSE
else:
bg = {"normal": NAVY, "hover": TB_HOVER, "pressed": TB_HOVER_DOWN}[state]
fg = {"normal": TB_MIN, "hover": TB_MIN_HOVER, "pressed": "#ffffff"}[state]
d.rectangle(box(p, 0, 0, 44, 40), fill=bg)
if kind == "min":
d.line([(p(15), p(20)), (p(29), p(20))], fill=fg, width=p(2))
else:
d.line([(p(16), p(14)), (p(28), p(26))], fill=fg, width=p(2))
d.line([(p(28), p(14)), (p(16), p(26))], fill=fg, width=p(2))
return down(im)
# ---------------------------------------------------------------- 控件
def draw_check(k, on):
p = U(k)
im = Image.new("RGB", (p(16), p(16)), CONTENT_BG)
d = ImageDraw.Draw(im)
if on:
d.rounded_rectangle(box(p, 0, 0, 16, 16), radius=p(4), fill=PRIMARY)
check(d, p, [(4.5, 8.5), (7, 11), (11.5, 5.5)], "#ffffff", 2)
else:
d.rounded_rectangle(box(p, 0, 0, 16, 16), radius=p(4), fill="#ffffff",
outline=BORDER, width=p(1))
return down(im)
def draw_radio(k, on):
p = U(k)
im = Image.new("RGB", (p(16), p(16)), CONTENT_BG)
d = ImageDraw.Draw(im)
if on:
d.ellipse(box(p, 0, 0, 16, 16), fill="#ffffff", outline=PRIMARY, width=p(2))
d.ellipse(box(p, 5, 5, 6, 6), fill=PRIMARY)
else:
d.ellipse(box(p, 0, 0, 16, 16), fill="#ffffff", outline=BORDER, width=p(1))
return down(im)
def draw_progress(k, step):
"""进度条 0..5 档，20% 一格。
进度条底与凹槽位图尺寸完全一致，NSIS 直接叠在凹槽上即可；填充部分左端保留圆角、
右端切齐，符合进度条「推进」的视觉。
"""
p = U(k)
im = Image.new("RGB", (p(456), p(8)), CONTENT_BG)
d = ImageDraw.Draw(im)
d.rounded_rectangle(box(p, 0, 0, 456, 8), radius=p(4), fill=DIVIDER)
frac = step / 5
if frac > 0:
# 用整体圆角矩形做蒙版，再按进度裁掉右半边，这样左端圆角自然、右端是直边
mask = Image.new("L", (p(456), p(8)), 0)
ImageDraw.Draw(mask).rounded_rectangle(box(p, 0, 0, 456, 8), radius=p(4), fill=255)
fill_im = Image.new("RGB", (p(456), p(8)), PRIMARY)
cut = max(1, int(round(p(456) * frac)))
region = (0, 0, cut, p(8))
im.paste(fill_im.crop(region), (0, 0), mask.crop(region))
return down(im)
def draw_stage(k, text):
"""阶段文案位图，贴到进度页 (32,116)：进度条上方一行，文案换行＝状态切换。"""
p = U(k)
im = Image.new("RGB", (p(456), p(18)), CONTENT_BG)
d = ImageDraw.Draw(im)
f = font("Regular", 12.5, k)
b = d.textbbox((0, 0), text, font=f, anchor="la")
d.text((0, (p(18) - (b[3] - b[1])) / 2 - b[1]), text, font=f, fill=TXT_DIM, anchor="la")
return down(im)
# ---------------------------------------------------------------- 汇总
def all_art(s):
"""逐张产出某个倍率的全部素材。
为什么用生成器：k=8 时单张底图就有 70MB，一次性把几十张都留在内存里没必要。
"""
k = s * SS
yield "base.bmp", draw_base(k)
yield "brand.bmp", draw_brand(k)
yield "titlebar.bmp", draw_titlebar(k)
yield "page-welcome.bmp", draw_page_welcome(k)
yield "page-license.bmp", draw_page_license(k)
yield "page-dir.bmp", draw_page_dir(k)
yield "page-progress.bmp", draw_page_progress(k)
yield "page-finish.bmp", draw_page_finish(k)
for label, name in (("下一步", "next"), ("安装", "install"), ("完成", "finish")):
for st in ("normal", "hover", "pressed"):
yield "btn-%s-%s.bmp" % (name, st), draw_button(k, label, BTN_W, BTN_H, "primary", st)
for label, name in (("取消", "cancel"), ("上一步", "back")):
for st in ("normal", "hover", "pressed"):
yield "btn-%s-%s.bmp" % (name, st), draw_button(k, label, BTN_W, BTN_H, "secondary", st)
for st in ("normal", "hover", "pressed"):
yield "btn-browse-%s.bmp" % st, draw_button(k, "浏览…", 96, 34, "secondary", st)
for name in ("min", "close"):
for st in ("normal", "hover", "pressed"):
yield "tb-%s-%s.bmp" % (name, st), draw_tb_button(k, name, st)
for st in ("off", "on"):
yield "check-%s.bmp" % st, draw_check(k, st == "on")
yield "radio-%s.bmp" % st, draw_radio(k, st == "on")
for i in range(6):
yield "progress-%d.bmp" % i, draw_progress(k, i)
for i, t in enumerate(["正在解压程序文件…", "正在写入注册表…", "正在创建快捷方式…",
"正在放行防火墙…", "正在收尾…"], start=1):
yield "stage-%d.bmp" % i, draw_stage(k, t)
# ---------------------------------------------------------------- 联络图
def compose(art, page, overlays):
"""按真实层级拼出 760×480 的成品观感图：底图 → 品牌栏 → 页面 → 标题栏 → 按钮/控件。"""
im = Image.new("RGB", (WIN_W, WIN_H), CONTENT_BG)
im.paste(art["base.bmp"], (0, 0))
im.paste(art["brand.bmp"], (0, TITLE_H))
im.paste(art["page-%s.bmp" % page], (PAGE_X, PAGE_Y))
im.paste(art["titlebar.bmp"], (0, 0))
for name, (x, y) in overlays:
im.paste(art[name], (x, y))
return im
def build_contact_sheet(art):
"""五页各拼一张成品图，纵向排成长图给人眼过一遍。
单看素材文件看不出层级和对位问题（例如标题栏图形与按钮位图错位、按钮压住正文），
所以验收必须看合成结果，而不是逐个位图看。
"""
# 标题栏按钮和底部按钮条按窗口坐标贴，页面内的控件按「页内坐标 + 页面原点」贴，
# 两类坐标混用很容易少加一次偏移，所以这里用 loc() 明确区分
def loc(x, y):
return x + PAGE_X, y + PAGE_Y
tb = [("tb-min-normal.bmp", (TB_MIN_BOX[0], TB_MIN_BOX[1])),
("tb-close-normal.bmp", (TB_CLOSE_BOX[0], TB_CLOSE_BOX[1]))]
cancel = ("btn-cancel-normal.bmp", (BTN_SECONDARY_X, BTN_Y))
back = ("btn-back-normal.bmp", (BTN_SECONDARY_X, BTN_Y))
next_ = ("btn-next-normal.bmp", (BTN_PRIMARY_X, BTN_Y))
pages = [
compose(art, "welcome", tb + [cancel, next_]),
compose(art, "license", tb + [cancel, next_]),
compose(art, "dir", tb + [
("btn-browse-normal.bmp", loc(392, 110)),
("radio-off.bmp", loc(32, 220)), ("radio-off.bmp", loc(32, 260)),
back, next_,
]),
# 进度页取中间一档（第 3 段 / 60%），静态图里最能说明「安装中」的样子
compose(art, "progress", tb + [
("stage-3.bmp", loc(PAD_L, 116)),
("progress-3.bmp", loc(PAD_L, 140)),
cancel,
]),
compose(art, "finish", tb + [
("check-on.bmp", loc(32, 298)),
("btn-finish-normal.bmp", (BTN_PRIMARY_X, BTN_Y)),
]),
]
gap = 16
sheet = Image.new("RGB", (WIN_W + gap * 2, gap + len(pages) * (WIN_H + gap)), "#202a38")
for i, page in enumerate(pages):
sheet.paste(page, (gap, gap + i * (WIN_H + gap)))
os.makedirs(os.path.dirname(CONTACT_SHEET), exist_ok=True)
sheet.save(CONTACT_SHEET)
print("写出 %s %s" % (CONTACT_SHEET, sheet.size))
def write_version_marker():
"""把烘焙进位图的版本号另写一份纯文本旁证。
为什么需要这个文件：版本号是画在 brand.bmp 像素里的，构建脚本没法从位图反读出
版本，因此「素材是旧版本生成的、但打包用的是新版本号」这种错配完全看不出来，
会悄悄发出一个界面上写着错版本号的安装包。这里把 repo_version() 的结果落到
art/version.txt，构建脚本拿它和仓库根 VERSION 一比，对不上就让构建失败。
"""
path = os.path.join(ART_DIR, "version.txt")
with open(path, "w", encoding="utf-8", newline="\n") as fh:
fh.write(repo_version() + "\n")
print("写出 %s" % path)
def main():
art1x = {}
for s in (1, 2):
out = os.path.join(ART_DIR, "%dx" % s)
os.makedirs(out, exist_ok=True)
n = 0
for name, im in all_art(s):
im.save(os.path.join(out, name))
n += 1
if s == 1:
art1x[name] = im # 联络图直接用 1x 成品，不要把 2x 缩一半再用（字会发虚）
print("%s：%d 张" % (out, n))
write_version_marker()
build_contact_sheet(art1x)
if __name__ == "__main__":
main()
console/installer/art/1x/base.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.0 MiB

console/installer/art/1x/brand.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 309 KiB

console/installer/art/1x/btn-back-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-back-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-back-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-browse-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 9.6 KiB

console/installer/art/1x/btn-browse-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 9.6 KiB

console/installer/art/1x/btn-browse-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 9.6 KiB

console/installer/art/1x/btn-cancel-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-cancel-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-cancel-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-finish-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-finish-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-finish-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-install-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-install-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-install-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-next-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-next-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/btn-next-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/check-off.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 822 B

console/installer/art/1x/check-on.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 822 B

console/installer/art/1x/page-dir.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 670 KiB

console/installer/art/1x/page-finish.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 670 KiB

console/installer/art/1x/page-license.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 670 KiB

console/installer/art/1x/page-progress.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 670 KiB

console/installer/art/1x/page-welcome.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 670 KiB

console/installer/art/1x/progress-0.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/progress-1.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/progress-2.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/progress-3.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/progress-4.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/progress-5.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

console/installer/art/1x/radio-off.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 822 B

console/installer/art/1x/radio-on.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 822 B

console/installer/art/1x/stage-1.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 24 KiB

console/installer/art/1x/stage-2.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 24 KiB

console/installer/art/1x/stage-3.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 24 KiB

console/installer/art/1x/stage-4.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 24 KiB

console/installer/art/1x/stage-5.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 24 KiB

console/installer/art/1x/tb-close-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 5.2 KiB

console/installer/art/1x/tb-close-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 5.2 KiB

console/installer/art/1x/tb-close-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 5.2 KiB

console/installer/art/1x/tb-min-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 5.2 KiB

console/installer/art/1x/tb-min-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 5.2 KiB

console/installer/art/1x/tb-min-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 5.2 KiB

console/installer/art/1x/titlebar.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 89 KiB

console/installer/art/2x/base.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 4.2 MiB

console/installer/art/2x/brand.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 1.2 MiB

console/installer/art/2x/btn-back-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-back-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-back-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-browse-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 38 KiB

console/installer/art/2x/btn-browse-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 38 KiB

console/installer/art/2x/btn-browse-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 38 KiB

console/installer/art/2x/btn-cancel-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-cancel-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-cancel-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-finish-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-finish-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-finish-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-install-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-install-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-install-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-next-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-next-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/btn-next-pressed.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 46 KiB

console/installer/art/2x/check-off.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.1 KiB

console/installer/art/2x/check-on.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.1 KiB

console/installer/art/2x/page-dir.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.6 MiB

console/installer/art/2x/page-finish.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.6 MiB

console/installer/art/2x/page-license.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.6 MiB

console/installer/art/2x/page-progress.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.6 MiB

console/installer/art/2x/page-welcome.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 2.6 MiB

console/installer/art/2x/progress-0.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 43 KiB

console/installer/art/2x/progress-1.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 43 KiB

console/installer/art/2x/progress-2.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 43 KiB

console/installer/art/2x/progress-3.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 43 KiB

console/installer/art/2x/progress-4.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 43 KiB

console/installer/art/2x/progress-5.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 43 KiB

console/installer/art/2x/radio-off.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.1 KiB

console/installer/art/2x/radio-on.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 3.1 KiB

console/installer/art/2x/stage-1.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 96 KiB

console/installer/art/2x/stage-2.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 96 KiB

console/installer/art/2x/stage-3.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 96 KiB

console/installer/art/2x/stage-4.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 96 KiB

console/installer/art/2x/stage-5.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 96 KiB

console/installer/art/2x/tb-close-hover.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 21 KiB

console/installer/art/2x/tb-close-normal.bmp
BIN
View File
Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 21 KiB

Loaded 100 of 750 files, more files were not shown because too many files have changed in this diff. Show more