blob: e08e869a9fdaee511698779475a622071c457872 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
|
# 启动/主菜单/HUD 与用户标准差距审计（P41，2026-09-28）
> 本文件仅为审计与候选清单，**本单不实现任何 UI 改动**，供 Hermes 选择后续切片。
> 审计依据：现有源码（`LaunchScreen.fs` / `TitleScreen.fs` / `MenuState.fs` / `HudLayout.fs` /
> `Game.fs` 的 `DrawSplash` / `DrawMenu` / `DrawWorldView`）与已录证据
> `docs/evidence/p38-splash-1.png`、`p38-splash-2-menu.png`、`p38-hud-day.png`、
> `p38-hud-night.png`、`p38-hud-closeup-2x.png`。
用户标准（三项）：① 精美启动动画；② 无大黑块；③ 星露谷式布局。
## 一、现状（可核对事实）
### 启动动画（LaunchScreen）
- 时长固定 `durationFrames = 150`（60Hz 约 2.5s），标题淡入 `fadeInFrames = 45`，全程帧计数纯函数、确定性可复现。
- 图层：5 段天色带 → 屋脊/屋檐剪影随暗幕上浮 → 水面色带 → 中文主标题「江南水乡」（投影+亮面，淡入上浮）→ 英文副标题 → 底部「ESC 或 空格 跳过」呼吸提示；整屏暗幕 1→0 退场。
- **无大黑块**：色带 + 剪影 + 窄条提示，结构上不会整屏纯黑；`check-no-white-blocks.py` 亦覆盖白块。
### 主菜单（TitleScreen / MenuState）
- 复刻启动画面的静态背景（同色带/屋脊/水面色带），右侧单一面板列出条目；游标独立列避免压字。
- 6 个页面：MainMenu / OccupationSelect / Settings / Controls / LoadError / Playing。
- 交互仅键盘（方向/回车/Esc），无鼠标、无手柄；菜单本身**无动效**（无入场滑动、无选中脉冲、无环境动画）；除启动淡入外背景完全静止。
### HUD（HudLayout / DrawWorldView）
- 顶部单条窄带 `barHeight = 36`，常驻 5 段：时段/时间/倍速/体力/钱币；每段为 7x7 原创点阵图标（`iconScale = 2`）+ 文字，数值取自真实世界状态。
- **无底部快捷栏/物品栏、无背包网格、无右上日历钟卡、无体力条形图、无头像对话框**；世界内提示是 `FloatingPrompt` 的纯文字暗底小条。
## 二、差距清单（对照三项标准）
| # | 标准 | 差距 | 影响面 |
|---|------|------|--------|
| G1 | 精美启动动画 | 启动仅为「色带+屋脊+文字」的淡入，无环境动效（水面涟漪/灯笼呼吸/云影/视差）；信息密度低、无品牌/序列帧层次 | 首屏观感 |
| G2 | 星露谷式布局 | HUD 仅顶部纯文字条；缺底部 hotbar、物品/背包网格、右上日历钟卡、体力条形图；布局与星露谷差异大 | 常驻可玩观感 |
| G3 | 星露谷式布局 | 对话/交互仅 `FloatingPrompt` 文字小条，缺头像框+名字+九宫格对话框 | 叙事/交互观感 |
| G4 | 精美启动动画 | 主菜单背景静止、无环境动效，选中态无脉冲/滑动；与启动画面割裂 | 首屏→菜单过渡 |
| G5 | 无大黑块（已基本达标） | 无已知黑块；潜在风险：菜单面板/提示条在极端字号或宽高比下留白偏大，非黑块但显空 | 边缘分辨率 |
## 三、候选改进（按「观感收益 / 实现成本」排序，供 Hermes 选）
1. **C1 菜单/启动环境动效（最高优先）**
在现有 splash + 菜单背景上叠加纯函数的环境动效：水面逐格涟漪、灯笼呼吸光晕、屋脊上方缓慢视差/云影。
- 复用现有 `waterFrameTickAt` / `lanternGlowLayers`，零新素材；帧计数纯函数保持确定性，便于回归。
- 收益：直接命中「精美启动动画」，且同一实现同时改善主菜单静止感。
2. **C2 HUD 星露谷化：右上日历钟卡 + 图形化体力条 + 底部 10 格 hotbar**
保留顶部窄带或改为右上角卡片（季节/日/时段/时钟），体力改条形图，底部加空格键位的快捷栏（先占位图标）。
- 纯布局/点阵扩展，走 `HudLayout` 纯模型 + 回归测试；不引入外部素材。
- 收益：最大程度贴近星露谷布局；成本中等。
3. **C3 对话框升级：头像框 + 名字牌 + 九宫格对话框**
用现有角色 atlas 取头像切片，`FloatingPrompt` 升级为带边框/名字的对话框，保留纯函数布局与回归。
- 收益：叙事观感显著；成本中高（需角色头像定位）。
4. **C4 启动动画加层：村民剪影视差 + 序列帧/信息层**
在启动画面加入岸边村民剪影与灯笼微动，或 2-3 段镜头推进；可配合短序章。
- 收益：进一步「精美」；成本中，且需注意不引入黑块。
5. **C5 菜单交互反馈与输入扩展（鼠标/手柄 + 选中脉冲/滑动）**
选中态加脉冲与滑动、进入/返回加动效；补充鼠标 hover/点击与手柄导航。
- 收益：手感与完成度；成本中，需改 `MenuState`/输入层。
### 建议排序理由
C1 以最低成本同时改善启动与菜单观感，应先行；C2 是「星露谷式布局」的核心缺口，建议紧随；C3/C4/C5 按叙事优先级与交互完整度后续排期。
## 四、验收建议（后续切片）
- 像素级：`check-no-white-blocks.py` 继续覆盖新帧；环境动效须为帧计数纯函数（同参逐字节可复现）。
- 布局级：`HudLayout`/`TitleScreen` 纯模型新增回归断言（矩形不重叠、段位不越界）。
- 视觉级：出 `docs/evidence/p41-*` 三帧（splash/菜单/HUD）供 4x 裁剪 vision 判读。
|
