opendance
4913760a8b
依据 Gitea v1.27.3 modules/charset/escape_stream.go 的判定规则 （analyzeDetectResults：仅当左右相邻字符都不是非 ASCII 时才标记， 且 _common 表恒定生效），把说明文档中会被标记的全角标点 （，：；？！（） 等）改为半角，并保证成对括号宽度一致。 中文语境中的全角标点（左右均为中文）保持原样，不动代码与契约语义。
43 lines
1.3 KiB
Markdown
43 lines
1.3 KiB
Markdown
# T-WIN-007 DTW 评分引擎
|
|
|
|
- **状态**: done
|
|
- **依赖**: T-WIN-004、T-WIN-002
|
|
|
|
## 目标
|
|
|
|
用 DTW 把实时关键点序列与服务端参考序列比对，产出 0~100 分与等级。
|
|
|
|
## load
|
|
|
|
```
|
|
DSH.md
|
|
contracts/skeleton-topology.md # 锚点：5 派生特征
|
|
contracts/model-formats.md # 锚点：2.1 预处理产物
|
|
src/score/pose_features.gd
|
|
src/score/dtw.gd
|
|
src/score/scoring.gd
|
|
```
|
|
|
|
## 特征（契约 5 冻结）
|
|
|
|
每帧 = `[33 x (x,y,z), 9 个关节角余弦]` = **108 维**。
|
|
低置信度点（conf < 0.5）对应维度**权重置 0**，不参与代价计算。
|
|
|
|
## DTW
|
|
|
|
- Sakoe-Chiba 带状约束 `|i - j| <= band`（默认 15 帧 ~ 0.5 秒）
|
|
- `DtwMatcher.compute_full()` 离线段；`StreamingDtw` 逐帧流式推进，
|
|
每帧只计算带内一行，总体复杂度 O(n m band) 但摊到每帧 O(m band)
|
|
- 归一化：代价 / max(i,j)+1，得到「平均每步代价」
|
|
|
|
## 评分规则(`scoring.gd`)
|
|
|
|
`score = clamp(1 - cost/tolerance, 0, 1) x 100`, EMA 平滑抑制抖动，
|
|
等级 S(>=95) / A(>=85) / B(>=70) / C(>=55) / D，连击阈值 70。
|
|
|
|
## 验收
|
|
|
|
`tests/test_dtw.gd` + `tests/test_pose_features.gd`：相同序列距离为 0、
|
|
路径单调且起于 (0,0)、带宽约束、时间伸缩吸收、流式与离线一致、
|
|
低置信度维度不参与距离、角度计算正确性。
|