docs: P16 启动画面/开始界面/HUD 精美化实施与取证记录

1 files changed, 25 insertions, 0 deletions

diff --git a/docs/维护说明.md b/docs/维护说明.md
index 0761aef..614de78 100644
--- a/docs/维护说明.md
+++ b/docs/维护说明.md
@@ -144,6 +144,28 @@ dotnet src/LivingVillage.Headless/bin/Release/net8.0/LivingVillage.Headless.dll
 - 门槛：`final_digest=953775FAEB2FDDE97289491AA260BD8D390C571E48A7A13AD2CB6FB7124F7F6C` 三次一致，
   `performance_determinism=PASS`；Kernel 89 / Desktop 94 全绿。
 
+## P16 批验：启动画面 / 开始界面 / HUD 精美化
+
+- ①启动画面：新增纯函数模块 `LaunchScreen.fs`（`durationFrames=150`、`fadeInFrames=45`、
+  `title/subtitle/skipHint`、`revealProgress/veilAlpha/isComplete/skipRequested`）；`Game.DrawSplash`
+  以真实游戏内渲染绘制标题/副标题，Esc 或空格可跳过，`splashFrame` 单调推进。
+- ②开始界面：`MenuState.items` 收敛为三项——无存档 `[NewGameItem; LoadItem; ExitItem]`、有存档
+  `[ContinueItem; LoadItem; ExitItem]`；标签 开始/继续/读档/退出；设置与操作说明不再占位（游戏内
+  F1/F2/F3 与 P 仍可开）。
+- ③HUD：原 `DrawM5Overlay` 拆为 `DrawHudBar`/`DrawTransientStatus`/`DrawPanel`；顶部窄信息条承载
+  时段/时间/倍速/体力/钱币，无大黑块；`HudLayout.fs` 固化 `barHeight=36`/`accentHeight=3`/
+  `paddingX=16`/`segmentGap=20`/`textScale=2` 与昼/夜调色板（冬夜冷色）。`FloatingPrompt` 顶避让改为
+  全宽 `hudTopBarHeight=39`，移除 `hudTopRightWidth/Height`。
+- ④文本：全部新 UI 文案走 CJK 图集；图集 228→238 字（补 `币 段 跳 过 空 格 清 晨 黄 昏`），行数仍 15、
+  PNG 仍 384×360；`Assets/cjk-glyphs.txt`、`CjkGlyphAtlas.characterTable`、`requiredUiLabels` 三者一致，无缺字。
+- ⑤回归：新增 `P16UiTests.fs`（启动跳过/菜单导航/HUD 布局确定性）；Desktop 94→104，Kernel 89 不变
+  （未触碰 Kernel/Sim.fs 数值路径）。
+- ⑥证据：`/tmp/opencode/lv-p16-art/`（`frame-day-0{1,2,3}.png`、`frame-night-0{1,2,3}.png`、
+  `frame-splash-01.png`、`frame-menu-0{1,2}.png`、`hud-bar-day.png`、`hud-bar-night.png`、`sample.mp4`
+  13.1 s、`final_verification.txt`）；`check-no-white-blocks.py` 对 92 帧 0 命中。
+- 门槛：clean rebuild 0 警告 0 错误；`final_digest=953775FAEB2FDDE97289491AA260BD8D390C571E48A7A13AD2CB6FB7124F7F6C`
+  一致、`performance_determinism=PASS`。
+
 ## 已验证命令
 
 ```bash
@@ -201,6 +223,9 @@ python3 scripts/check-no-white-blocks.py evidence/night-run
 - `/tmp/opencode/lv-p13/evidence/`（P13：`walk-idle-frames.png`、`water-3phase.png`、
   `smoke-3phase.png`、`water-2frame.png`、`smoke-2frame.png`、`day-panorama.png`、
   `night-lantern.png`、`day-night-compare.png`、`walk-real-run.png`、`day-run/`、`night-run/`）
+- `/tmp/opencode/lv-p16-art/`（P16：`frame-day-0{1,2,3}.png`、`frame-night-0{1,2,3}.png`、
+  `frame-splash-01.png`、`frame-menu-0{1,2}.png`、`hud-bar-day.png`、`hud-bar-night.png`、
+  `sample.mp4`、`final_verification.txt`；沙箱不允许 `/tmp/lv-p16-art`，故落此路径）
 - `/tmp/opencode/lv-p13-evidence/`（P14 修复后重录：`day-panorama.png`、`night-lantern.png`、
   `day-night-compare.png`、`chimney-closeup.png`、`night-lantern-closeup.png`、
   `white-block-check.txt`、`day-run/`、`night-run/`；同步一份到 `evidence/`）