opendance
4913760a8b
依据 Gitea v1.27.3 modules/charset/escape_stream.go 的判定规则 （analyzeDetectResults：仅当左右相邻字符都不是非 ASCII 时才标记， 且 _common 表恒定生效），把说明文档中会被标记的全角标点 （，：；？！（） 等）改为半角，并保证成对括号宽度一致。 中文语境中的全角标点（左右均为中文）保持原样，不动代码与契约语义。
41 lines
1.4 KiB
Markdown
41 lines
1.4 KiB
Markdown
# T-WIN-008 主界面 + 游戏界面 + 结算
|
|
|
|
- **状态**: done
|
|
- **依赖**: T-WIN-002、T-WIN-003、T-WIN-006、T-WIN-007
|
|
|
|
## 目标
|
|
|
|
三页式体验：主菜单（选曲/选动作/选模型）-> 游戏页(3D 角色 + 实时评分 HUD)-> 结算页。
|
|
|
|
## load
|
|
|
|
```
|
|
DSH.md
|
|
src/ui/main.gd
|
|
src/ui/main_menu.gd
|
|
src/ui/game_screen.gd
|
|
src/ui/result_screen.gd
|
|
src/ui/ui_kit.gd
|
|
```
|
|
|
|
## 页面
|
|
|
|
| 页面 | 能力 |
|
|
|--|--|
|
|
| 主菜单 | 三栏选择（曲目 / 可评分动作 / 模型）、服务端地址编辑与测试、目录刷新、接收服务状态与重启 |
|
|
| 游戏页 | SubViewport 3D 角色、自动定机位、实时分数/等级/连击、进度条、连接状态提示、来源展示 |
|
|
| 结算 | 等级大字、平均/最终分、完成度、最高单帧、最长连击、评语、来源展示 |
|
|
|
|
## 关键实现
|
|
|
|
- 界面全部代码构建（见 DSH.md 6），主菜单只列出 `preprocessState == "done"` 的动作
|
|
- 游戏页订阅 `PoseReceiver.frame_received` 驱动骨骼，`ScoreService` 独立订阅做评分
|
|
- 未连接设备时给出明确提示而非静默失败；模型/序列拉取失败时显示可读原因并允许重试
|
|
- 参考序列走完自动结算
|
|
- 切换模型时正确 `dispose()` 旧场景，避免泄漏
|
|
|
|
## 验收
|
|
|
|
`GODOT --headless --path. --quit-after 180` 启动无运行时错误；
|
|
主菜单、游戏页、结算页的构造路径均被该启动流程覆盖。
|