opendance
4913760a8b
依据 Gitea v1.27.3 modules/charset/escape_stream.go 的判定规则 （analyzeDetectResults：仅当左右相邻字符都不是非 ASCII 时才标记， 且 _common 表恒定生效），把说明文档中会被标记的全角标点 （，：；？！（） 等）改为半角，并保证成对括号宽度一致。 中文语境中的全角标点（左右均为中文）保持原样，不动代码与契约语义。
42 lines
1.2 KiB
Markdown
42 lines
1.2 KiB
Markdown
# T-WIN-001 Godot 项目骨架
|
|
|
|
- **状态**: done
|
|
- **依赖**：无
|
|
|
|
## 目标
|
|
|
|
建立 Godot 4 工程骨架，配置 4 个 autoload、渲染方式与窗口，保证可无头导入与启动。
|
|
|
|
## load
|
|
|
|
```
|
|
DSH.md
|
|
project.godot
|
|
src/autoload/*.gd
|
|
src/ui/main.gd
|
|
scenes/main.tscn
|
|
```
|
|
|
|
## 交付物
|
|
|
|
| 文件 | 说明 |
|
|
|--|--|
|
|
| `project.godot` | 工程配置；autoload = AppConfig / CatalogStore / PoseReceiver / ScoreService |
|
|
| `scenes/main.tscn` | 只含一个挂载 `src/ui/main.gd` 的 Control 根节点(界面用代码构建，见 DSH.md 6) |
|
|
| `src/ui/main.gd` | 应用外壳：构建布局、切换页面、启动接收服务 |
|
|
| `src/autoload/app_config.gd` | 客户端配置，持久化到 `user://opendance.cfg` |
|
|
| `src/autoload/catalog_store.gd` | 目录缓存 + 模型下载缓存 + 关键点序列缓存 |
|
|
| `src/autoload/pose_receiver.gd` | 关键点接收服务封装 |
|
|
| `src/autoload/score_service.gd` | 评分服务封装 |
|
|
|
|
## 验收
|
|
|
|
```bash
|
|
GODOT --headless --path. --import # 无 SCRIPT ERROR
|
|
GODOT --headless --path. --quit-after 180 # 应用可启动，UI 构建无报错
|
|
```
|
|
|
|
## 结果
|
|
|
|
- 导入无编译错误；`--quit-after 180` 启动 180 帧无任何运行时错误。
|