docs(win): 任务说明、DSH 约束与交付文档

2026-09-14 20:04:54 +08:00
parent 315cf79708
commit a83e4f6a1f
15 changed files with 975 additions and 0 deletions
@@ -0,0 +1,41 @@
+# 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 帧无任何运行时错误。