zijunchiang/opendance-windows
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 7 Wiki Activity
42 Commits 2 Branches 7 Tags
0ffb2d43bb1af395d220386b82953040e57fe9b1
Commit Graph
9 Commits
Author SHA1 Message Date
zijunchiang c3a227c6df feat(net): 连接保活 / 设备去重 / 连接状态机（T-WIN-015，契约 websocket-keypoints 0.2.0） 
与 Android 端 T-AND-011「两端一起改」：契约先在 opendance-web 修改并提升到
websocket-keypoints 0.2.0（向后兼容：子协议名与二进制帧 version 均不变，
只新增可选控制字段与一种新控制类型），再同步三端快照。

修掉本端的 3 处根因/放大器：
1. 静默超时 5s 过短且未声明，客户端无从得知。OkHttp 的协议层 ping 由底层库
   自动应答、**不暴露给应用层**，无法刷新 last_seen_ms，于是"画面里没人"时
   每 5 秒必然踢一次连接 -> 客户端重连 -> 再被踢。
   - CLIENT_TIMEOUT_MS 5s -> 15s，新增 HEARTBEAT_INTERVAL_MS = 5s；
   - welcome_payload() 在 welcome 中声明 silentTimeoutMs / heartbeatIntervalMs，
     config 广播同样带上（契约 §1.1：心跳必须 < 静默超时的一半，5000*2 < 15000）；
   - 处理应用层 ping 并回 pong（回显 sentAtMs + serverAtMs，供对端算 RTT）。
2. 反复重连被计成多台设备。按契约 §5 用 hello.deviceId 去重：同一设备只保留
   最新连接，旧连接以 close(1000) 关闭——刻意用 1000，因为对端按契约 §7
   收到 1000 不会重连，否则会形成"挤掉-重连-再挤掉"的循环；
   新增 device_count() 与 device_replaced 信号，界面一律显示去重后的设备数。
3. 只有 handshaken 布尔量，日志看不出卡在哪一步。按契约 §8 逐客户端维护与
   Android 端同名的状态（connecting -> handshaking -> streaming -> degraded，
   主动停止/超时/被替换为 stopped），并记录 close code/reason、协商子协议、
   连接/握手/首帧时间；degraded 保持时长做成可覆盖字段便于测试。

验收测试（tests/test_pose_server.gd 新增 7 项，总计 720 通过 / 0 失败）：
welcome 声明保活参数、ping->pong 回显、同 deviceId 去重（旧连接 1000 关闭且
设备数仍为 1）、8 个状态名与契约一致、状态随握手/首帧推进到 streaming、
丢帧进入 degraded 后恢复、snapshot 暴露设备数与保活参数。

同时更新 README/README.txt/tasks 与 Credits 的契约版本（0.2.0）。
 2026-09-17 01:11:48 +08:00
opendance 47e11af7d0 chore(contracts): 同步 0.5.0/0.7.0/0.4.0（场景管理路由与 Scene 模型） 2026-09-17 00:27:08 +08:00
opendance 47fc8e76b7 chore(contracts): 同步 data-models 0.6.0（Motion 增 thumbnailUrl） 2026-09-17 00:21:00 +08:00
opendance 9ff5f2b302 feat(model): humanoid 骨名映射对齐 MMD/中文（契约 skeleton-topology 0.2.0） 
- CANDIDATES 由服务端表生成写入（与 model-inspector.ts 逐字一致，parity 测试断言）
- normalize() 保留 CJK/假名并把全角 ASCII 折半角，修复 MMD 骨名归一化成空串导致
  humanoid 覆盖率恒为 0/22 的问题
- contracts/ 同步至 0.5.0 / 0.2.0
 2026-09-17 00:10:07 +08:00
opendance efb2484125 chore(contracts): 同步契约 0.5.0（模型一律转 VRM，Model 增 usable/unusableReason） 
来自 opendance-web 的契约变更，按 DSH 文档 7.2「先改 Web 端 contracts/ 再同步另两端」：
- model-formats.md -> 0.5.0：主力格式 VRM + humanoid 门槛与回退
- data-models.md -> 0.5.0：Model 增 usable / unusableReason
- VERSION 同步
 2026-09-17 00:05:02 +08:00
zijunchiang 5a13167739 chore(contracts): 同步契约到 0.4.0/0.3.0（GLB/VRM 主力格式、模型审核与骨骼分析） 2026-09-15 20:37:58 +08:00
zijunchiang f4cf2c70de chore(contracts): 同步契约到 rest-api/data-models/model-formats 0.3.0、database 0.2.0（模型压缩包转换与默认模型规则） 2026-09-15 13:55:59 +08:00
zijunchiang 8f303c0595 chore(contracts): 同步契约到 v0.2.0（rest-api / data-models / model-formats） 
Web 端需求变更带来的契约字段级改动：
- MotionFormat 枚举新增 vmd（MikuMikuDance 动作数据）
- rest-api 服务地址说明改为双端口语义（软件 API 端口给客户端 / 管理端端口给浏览器）
- model-formats 新增 §2.3 VMD 解析约定（标准 MMD 骨架、腿部 IK/FK 判定、手性转换）

三库契约文件保持逐字节一致。
 2026-09-15 08:45:06 +08:00
zijunchiang 0b7083d026 chore(contracts): 引入 opendance-web v0.1.0 契约只读快照 2026-09-14 20:04:53 +08:00