docs: 新增「初次部署(从零跑起来)」;去混淆字符与真实内网信息

- README.md / README.txt 新增初次部署章节:前置条件(JDK 17 / SDK 34 / Gradle 8.9)、
  获取代码与本地配置(local.properties 不入仓)、Debug/Release 构建、装到手机与相机权限、
  连接配置(只连 Windows 客户端,默认 8765 / /pose)、第一次跑通、自检清单、常见问题
- 单测数量按实际(30 项)修正
- 三库同源契约:':=' 写法修回、去掉真实 MariaDB 版本串
- 全文去除易被 Gitea 判为「模棱两可 Unicode」的字符
- 本机 JDK 路径与内网示例地址改占位符 / RFC 5737 文档网段
This commit is contained in:
2026-09-15 21:33:27 +08:00
parent 203dcd8a9c
commit 264786134c
20 changed files with 485 additions and 172 deletions
+12 -8
View File
@@ -1,4 +1,4 @@
# DSH.md —— opendance-android(OpenDance Studio 项目三:Android 辅助 App)
# DSH.md -- opendance-android(OpenDance Studio 项目三:Android 辅助 App)
## 0. 本文件的作用
@@ -17,12 +17,12 @@ WebSocket 推给 Windows 客户端。
ws://<windows-host>:8765/pose
```
**画面不离开设备** —— 只有关键点坐标经网络发送。
**画面不离开设备** -- 只有关键点坐标经网络发送。
## 2. 技术栈
| 组件 | 选型 |
|---|---|
|--|--|
| 语言 | Kotlin 2.0.21 |
| 构建 | AGP 8.7.3 + Gradle 8.9 + JDK 17 |
| 相机 | CameraX 1.4.0 (Apache 2.0) |
@@ -50,7 +50,7 @@ WebSocket 推给 Windows 客户端。
## 4. 上下文预算
| 项 | 建议值 |
|---|---|
|--|--|
| 单任务文件数 | ≤ 6 |
| 单任务代码行数 | ≤ 1500 |
| 单任务 Token | ≤ 12K |
@@ -91,7 +91,7 @@ opendance-android/
也是与「上传视频做云端推理」方案的本质区别。
2. **239 字节帧格式冻结**。任何字段改动都要先改 `opendance-web` 的
`contracts/websocket-keypoints.md` 并提升版本。
本端序列化器有金标准字节向量测试守护(见 §8)。
本端序列化器有金标准字节向量测试守护(见 8)。
3. **33 点顺序冻结**。MediaPipe Pose 的原始索引顺序**就是**契约顺序,
不得重排或插入。
4. **镜像语义**:发送**未镜像**的原始坐标,是否镜像由 `flags.bit0` 声明;
@@ -103,14 +103,18 @@ opendance-android/
## 7. 验证(每任务执行)
```bash
export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64 # AGP 8.7 需要 JDK 17
export ANDROID_HOME=/path/to/android-sdk
export JAVA_HOME=<JDK 17 路径> # AGP 8.7 需要 JDK 17
export ANDROID_HOME=<Android SDK 路径>
./gradlew testDebugUnitTest # JVM 单元测试,无需设备
bash build/build-apk.sh all # debug + release APK,并校验签名与产物
bash build/verify.sh # 一键跑完上述全部并附加产物校验
```
首次部署(前置条件、本地配置、安装到手机、配置联通、自检清单、常见问题)
见 `README.md` 的「初次部署(从零跑起来)」与 `README.txt` 对应小节。
文档中的地址、路径、口令一律使用占位符,真实值不得写入仓库。
## 8. 跨端一致性验证(本项目最重要的测试)
`KeypointFrameTest.goldenVectorMatchesWebImplementation` 使用
@@ -125,7 +129,7 @@ Kotlin(本端)。任何一端私自改动字段布局都会立刻失败。
## 9. 上下文超标时的拆分策略
| 超标原因 | 拆分方式 |
|---|---|
|--|--|
| 单任务涉及多个界面 | 按界面拆(连接/运行/关于) |
| 单文件过大 | 按类拆,先生成接口再分实现 |
| 契约全文加载 | 改用锚点引用 |