docs: 消除 Gitea 模棱两可 Unicode 告警(全角标点紧邻 ASCII 时改为半角)

依据 Gitea v1.27.3 modules/charset/escape_stream.go 的判定规则
(analyzeDetectResults:仅当左右相邻字符都不是非 ASCII 时才标记,
且 _common 表恒定生效),把说明文档中会被标记的全角标点
(,:;?!() 等)改为半角,并保证成对括号宽度一致。
中文语境中的全角标点(左右均为中文)保持原样,不动代码与契约语义。
This commit is contained in:
opendance
2026-09-15 21:45:51 +08:00
parent ab88231ea0
commit 68783c37b6
18 changed files with 147 additions and 147 deletions
+5 -5
View File
@@ -1,7 +1,7 @@
# T-AND-005 WebSocket 推流 + 自动重连
- **状态**:done
- **依赖**:T-AND-004
- **状态**: done
- **依赖**: T-AND-004
## 目标
@@ -17,7 +17,7 @@ app/src/main/java/com/opendance/studio/net/PoseWebSocketClient.kt
## 交付物
`net/PoseWebSocketClient.kt`:OkHttp WebSocket 封装 + 状态流 + 统计。
`net/PoseWebSocketClient.kt`: OkHttp WebSocket 封装 + 状态流 + 统计。
## 关键实现
@@ -25,7 +25,7 @@ app/src/main/java/com/opendance/studio/net/PoseWebSocketClient.kt
|--|--|--|
| 子协议 | 请求头 `Sec-WebSocket-Protocol: opendance.pose.v1` | 契约 1 |
| 二进制帧 | `socket.send(ByteString)` | 契约要求生产链路用二进制 |
| 控制帧 | `send(text)`,JSON | hello / stats / bye |
| 控制帧 | `send(text)`, JSON | hello / stats / bye |
| 自动重连 | 指数退避 1s -> 2s -> 4s... 上限 15s,连接成功即重置 | 避免抖动时打爆对端 |
| 非连接态发送 | 直接丢弃并计入 `droppedFrames` | **绝不阻塞相机线程** |
| 心跳 | OkHttp `pingInterval(15s)` | 及时发现半开连接 |
@@ -37,7 +37,7 @@ app/src/main/java/com/opendance/studio/net/PoseWebSocketClient.kt
- **hello**(连接后立即发):protocol / device / appVersion / cameraFacing /
targetFps / resolution
- **welcome**(收):记录服务端 sessionId
- **config**(收):服务端可下发 mirror / targetFps / upperBodyOnly / resolution,
- **config**(收):服务端可下发 mirror / targetFps / upperBodyOnly / resolution,
通过 `onRemoteConfig` 回调
- **stats**(每秒发):fps / dropped / latencyMs / confidenceAvg
- **bye**(主动断开时发)