 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
|
4913760a8b
|
docs: 消除 Gitea 模棱两可 Unicode 告警（全角标点紧邻 ASCII 时改为半角）
依据 Gitea v1.27.3 modules/charset/escape_stream.go 的判定规则
（analyzeDetectResults：仅当左右相邻字符都不是非 ASCII 时才标记，
且 _common 表恒定生效），把说明文档中会被标记的全角标点
（，：；？！（） 等）改为半角，并保证成对括号宽度一致。
中文语境中的全角标点（左右均为中文）保持原样，不动代码与契约语义。
|
2026-09-15 21:45:51 +08:00 |
|
|
zijunchiang
|
68a5ca0a87
|
docs: 其余易混淆字符（x/>=/<=/~/OK 取代 × − ≥ ≤ ≈ ✓）
|
2026-09-15 21:34:50 +08:00 |
|
|
zijunchiang
|
9f7b926a9a
|
docs: 新增「初次部署（从零跑起来）」；去混淆字符与真实内网信息
- README.md / README.txt 新增初次部署章节：前置条件、获取代码、首次运行、
配置服务端地址（API 3000 / 管理端 3001 分离）、与 Android 的 WebSocket 联通、
打包导出、自检清单、常见问题
- 三库同源契约：':=' 写法修回、去掉真实 MariaDB 版本串
- 全文去除易被 Gitea 判为「模棱两可 Unicode」的字符（- - ... -> 取代 — – … § →）
- 真实内网地址与库名改占位符
|
2026-09-15 21:33:27 +08:00 |
|
|
zijunchiang
|
0b7083d026
|
chore(contracts): 引入 opendance-web v0.1.0 契约只读快照
|
2026-09-14 20:04:53 +08:00 |
|