docs: 消除 Gitea 模棱两可 Unicode 告警（全角标点紧邻 ASCII 时改为半角）
依据 Gitea v1.27.3 modules/charset/escape_stream.go 的判定规则 （analyzeDetectResults：仅当左右相邻字符都不是非 ASCII 时才标记， 且 _common 表恒定生效），把说明文档中会被标记的全角标点 （，：；？！（） 等）改为半角，并保证成对括号宽度一致。 中文语境中的全角标点（左右均为中文）保持原样，不动代码与契约语义。
This commit is contained in:
opendance
+17
-17
@@ -43,7 +43,7 @@ OpenDance.exe 的用户看第一节即可。
|
||||
|
||||
1. 前置条件
|
||||
|
||||
- 操作系统：Windows 10/11（x86_64）。开发与导出可在 Windows 或 Linux。
|
||||
- 操作系统：Windows 10/11(x86_64)。开发与导出可在 Windows 或 Linux。
|
||||
- Godot 4.7.x 标准版（GDScript）。不需要 .NET / C# 版。
|
||||
- 渲染后端为 GL Compatibility，运行需 OpenGL 3.3 级别的显卡与驱动。
|
||||
- 导出模板：仅打包导出时需要，必须与编辑器完全同版本。
|
||||
@@ -68,7 +68,7 @@ OpenDance.exe 的用户看第一节即可。
|
||||
|
||||
4. 配置服务端地址
|
||||
|
||||
主界面顶部「服务端地址」填好后点「保存并测试」，配置字段名为 api_base_url：
|
||||
主界面顶部「服务端地址」填好后点「保存并测试」，配置字段名为 api_base_url:
|
||||
|
||||
http://<服务器地址>:3000
|
||||
http://192.0.2.10:3000
|
||||
@@ -81,7 +81,7 @@ OpenDance.exe 的用户看第一节即可。
|
||||
- Android 辅助 App -> 本端 WebSocket：本端是服务端，默认监听
|
||||
0.0.0.0:8765，路径 /pose，子协议 opendance.pose.v1。Android 端填写
|
||||
本端主界面显示的「接收地址」，形如 ws://<本机局域网地址>:8765/pose。
|
||||
本端可在 opendance.cfg 改 listen_host / listen_port / ws_subprotocol，
|
||||
本端可在 opendance.cfg 改 listen_host / listen_port / ws_subprotocol,
|
||||
改后点「重新连接接收服务」生效。
|
||||
- Web 服务端：需先在服务端发布曲目 / 动作 / 模型，动作还须完成关键点
|
||||
预处理，客户端才有可选内容。
|
||||
@@ -94,7 +94,7 @@ OpenDance.exe 的用户看第一节即可。
|
||||
# Windows（兜底）
|
||||
powershell -ExecutionPolicy Bypass -File build\export-windows.ps1
|
||||
|
||||
产物在 build/windows/：OpenDance.exe（约 104 MB，PE 头 MZ 校验通过）
|
||||
产物在 build/windows/: OpenDance.exe（约 104 MB, PE 头 MZ 校验通过）
|
||||
+ OpenDance.pck（约 107 KB，必须与 exe 同目录）；可能附带
|
||||
OpenDance.console.exe。
|
||||
|
||||
@@ -121,7 +121,7 @@ OpenDance.exe 的用户看第一节即可。
|
||||
8. 部署相关常见问题
|
||||
|
||||
Q: 模型加载失败：缺少骨骼
|
||||
A: 模型无 Skeleton3D，或骨骼命名不在映射表内；换用标准 VRM（VRoid
|
||||
A: 模型无 Skeleton3D，或骨骼命名不在映射表内；换用标准 VRM(VRoid
|
||||
Studio 导出）。人形覆盖率低于 60% 会提示「骨骼覆盖偏低」。
|
||||
|
||||
Q: 连不上服务端 / 显示「服务端不可达」
|
||||
@@ -130,7 +130,7 @@ OpenDance.exe 的用户看第一节即可。
|
||||
|
||||
Q: 导出失败：未找到导出模板
|
||||
A: 安装与编辑器同版本的 export templates。Linux 放
|
||||
~/.local/share/godot/export_templates/<版本>.stable/；
|
||||
~/.local/share/godot/export_templates/<版本>.stable/;
|
||||
Windows 放 %APPDATA%\Godot\export_templates\<版本>.stable\。
|
||||
|
||||
Q: 接收服务启动失败（端口 8765 可能被占用）
|
||||
@@ -169,12 +169,12 @@ OpenDance.exe 的用户看第一节即可。
|
||||
|
||||
可配置项：
|
||||
|
||||
api_base_url Web 服务端地址（默认 http://127.0.0.1:3000）
|
||||
listen_host WebSocket 监听地址（默认 0.0.0.0）
|
||||
listen_port WebSocket 监听端口（默认 8765）
|
||||
ws_subprotocol 子协议（默认 opendance.pose.v1）
|
||||
api_base_url Web 服务端地址(默认 http://127.0.0.1:3000)
|
||||
listen_host WebSocket 监听地址(默认 0.0.0.0)
|
||||
listen_port WebSocket 监听端口(默认 8765)
|
||||
ws_subprotocol 子协议(默认 opendance.pose.v1)
|
||||
dtw_band DTW 带宽，单位帧（默认 15 ~ 0.5 秒抖动容忍）
|
||||
score_tolerance 评分容差：平均每步代价达到该值即 0 分（默认 0.25）
|
||||
score_tolerance 评分容差：平均每步代价达到该值即 0 分(默认 0.25)
|
||||
mirror_preview 镜像预览
|
||||
|
||||
--
|
||||
@@ -196,9 +196,9 @@ OpenDance.exe 的用户看第一节即可。
|
||||
- 每帧特征 = 33 点 x (x,y,z) + 9 个关节角余弦 = 108 维
|
||||
（与 Web 服务端预处理产物、Android 端推流结构完全一致）
|
||||
- 置信度低于 0.5 的关键点不参与代价计算，避免遮挡导致误判
|
||||
- 采用带约束 DTW（|i-j| <= band）对齐，能吸收一定的节奏快慢差异
|
||||
- 采用带约束 DTW(|i-j| <= band)对齐，能吸收一定的节奏快慢差异
|
||||
- 得分 = clamp(1 - 平均代价 / 容差, 0, 1) x 100，并做指数平滑
|
||||
- 等级：S >= 95，A >= 85，B >= 70，C >= 55，D 其余
|
||||
- 等级：S >= 95, A >= 85, B >= 70, C >= 55, D 其余
|
||||
|
||||
--
|
||||
七、从源码构建
|
||||
@@ -212,7 +212,7 @@ OpenDance.exe 的用户看第一节即可。
|
||||
# Windows 上兜底导出
|
||||
powershell -ExecutionPolicy Bypass -File build\export-windows.ps1
|
||||
|
||||
产物位于 build/windows/：OpenDance.exe + OpenDance.pck
|
||||
产物位于 build/windows/: OpenDance.exe + OpenDance.pck
|
||||
（脚本会校验产物存在且为合法 PE 文件）
|
||||
|
||||
运行测试：
|
||||
@@ -230,8 +230,8 @@ OpenDance.exe 的用户看第一节即可。
|
||||
export_presets.cfg 导出预设（必须在项目根目录）
|
||||
project.yaml 任务清单与状态
|
||||
DSH.md 本项目 DSH 执行约束
|
||||
tasks/ 单任务说明书（T-WIN-001 ~ 011）
|
||||
contracts/ 只读契约快照（来源 opendance-web v0.1.0）
|
||||
tasks/ 单任务说明书(T-WIN-001 ~ 011)
|
||||
contracts/ 只读契约快照(来源 opendance-web v0.1.0)
|
||||
scenes/main.tscn 根节点
|
||||
src/autoload/ AppConfig / CatalogStore / PoseReceiver / ScoreService
|
||||
src/net/ 239 字节编解码、WebSocket 服务、REST 客户端
|
||||
@@ -255,7 +255,7 @@ A: 动作必须先在管理端完成「预处理」（BVH -> 关键点序列）
|
||||
|
||||
Q: 模型加载失败 / 动作不完整
|
||||
A: 游戏界面会显示「人形覆盖率」。低于 60% 说明模型的骨骼命名不被识别，
|
||||
请换用标准 VRM（VRoid Studio 导出）模型。
|
||||
请换用标准 VRM(VRoid Studio 导出)模型。
|
||||
|
||||
Q: 连上了手机但分数一直是 0
|
||||
A: 确认手机端已开始推流；主界面的「查看接收状态」会显示累计帧数与丢帧数。
|
||||
|
||||
Reference in New Issue
Block a user