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,76 @@
+project: opendance-windows-client
+version: 0.1.0
+repository: opendance-windows
+default_branch: main
+engine: Godot 4.7.2
+contracts_version: 0.1.0
+
+# 契约变更流程（文档 §7.2）：
+#   任何跨端契约变更必须先在 opendance-web 修改 contracts/ 并提升版本，
+#   再在本项目创建适配任务。本项目内的 contracts/ 只是只读快照。
+
+dependencies:
+  - name: opendance-web
+    kind: rest-api
+    contract: contracts/rest-api.yaml
+    usage: 曲目/动作/模型目录与关键点序列
+  - name: opendance-android
+    kind: websocket-consumer
+    contract: contracts/websocket-keypoints.md
+    usage: 本端为服务端，Android 主动连入推流
+
+tasks:
+  - id: T-WIN-001
+    file: tasks/001-scaffold.md
+    scope: Godot 项目骨架
+    status: done
+  - id: T-WIN-002
+    file: tasks/002-rest-client.md
+    scope: 调用 Web 服务端 API
+    status: done
+  - id: T-WIN-003
+    file: tasks/003-websocket-receiver.md
+    scope: 接收 Android 关键点帧
+    status: done
+  - id: T-WIN-004
+    file: tasks/004-keypoint-deserialize.md
+    scope: 239 字节帧反序列化
+    status: done
+  - id: T-WIN-005
+    file: tasks/005-vrm-loader.md
+    scope: VRM 模型加载
+    status: done
+  - id: T-WIN-006
+    file: tasks/006-skeleton-retarget.md
+    scope: 关键点 → VRM 骨骼重定向
+    status: done
+  - id: T-WIN-007
+    file: tasks/007-scoring-dtw.md
+    scope: DTW 评分引擎
+    status: done
+  - id: T-WIN-008
+    file: tasks/008-game-ui.md
+    scope: 主界面 + 游戏界面 + 结算
+    status: done
+  - id: T-WIN-009
+    file: tasks/009-source-display.md
+    scope: 模型/动作来源信息展示
+    status: done
+  - id: T-WIN-010
+    file: tasks/010-about-page.md
+    scope: 关于页面 + 开源声明
+    status: done
+  - id: T-WIN-011
+    file: tasks/011-build-script.md
+    scope: Windows 打包脚本
+    status: done
+
+deliverable:
+  artifact: opendance-windows-v0.1.0.zip
+  packaging: Godot 导出脚本（Linux 直接导出 / Windows 兜底）
+  includes:
+    - OpenDance.exe
+    - OpenDance.pck
+    - THIRD_PARTY.md
+    - README.txt
+    - contracts/          # 当前版本契约快照