22 Commits
Author SHA1 Message Date
zijunchiang ab88231ea0 docs: 全角 | / ? 改 ASCII(Gitea 混淆字符检测的剩余触发项) 2026-09-15 21:36:41 +08:00
zijunchiang 91e56135fc docs: 其余易混淆字符(x/>=/<=/~/OK 取代 × − ≥ ≤ ≈ ✓) 2026-09-15 21:34:50 +08:00
zijunchiang 264786134c 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 文档网段
2026-09-15 21:33:27 +08:00
zijunchiang 203dcd8a9c chore(contracts): 同步 rest-api(新增 POST /api/models/{id}/reanalyze) 2026-09-15 21:18:21 +08:00
zijunchiang 5563a78e07 chore(contracts): 同步契约到 0.4.0/0.3.0(GLB/VRM 主力格式、模型审核与骨骼分析) 2026-09-15 20:37:58 +08:00
zijunchiang cee82c7b36 chore(contracts): 同步契约(默认模型改用压缩包 sha256 匹配,补 sourceSha256 与确定性说明) 2026-09-15 19:36:42 +08:00
zijunchiang f9e88901dd chore(contracts): 同步契约到 rest-api/data-models/model-formats 0.3.0、database 0.2.0(模型压缩包转换与默认模型规则) 2026-09-15 13:55:59 +08:00
zijunchiang 6f15d119ed chore(contracts): 同步契约到 v0.2.0(rest-api / data-models / model-formats)
Web 端需求变更带来的契约字段级改动:
- MotionFormat 枚举新增 vmd(MikuMikuDance 动作数据)
- rest-api 服务地址说明改为双端口语义(软件 API 端口给客户端 / 管理端端口给浏览器)
- model-formats 新增 §2.3 VMD 解析约定(标准 MMD 骨架、腿部 IK/FK 判定、手性转换)

三库契约文件保持逐字节一致。
2026-09-15 08:45:06 +08:00
zijunchiang eb534ed7ee docs(contracts): 服务地址描述由 Docker 部署改为 Linux 业务服务部署(Web 端已去 Docker) 2026-09-15 01:27:50 +08:00
zijunchiang e9ea1b5811 fix(android): 修复进入推流页立即闪退(未捕获 Error)
用户反馈:扫描到客户端后点击「开始推流」立刻闪退。

根因:PoseDetector.initialize() 只 catch (Exception),而 MediaPipe 初始化
失败会抛 UnsatisfiedLinkError / NoClassDefFoundError / ExceptionInInitializerError
—— 这些都是 Error,不是 Exception,会直接冒泡成进程崩溃。

证据(对照实验):新增 Robolectric 组合测试后
  改回 catch (Exception):5 项测试 2 项失败
    - java.lang.UnsatisfiedLinkError: no mediapipe_tasks_jni in java.library.path
    - java.lang.NoClassDefFoundError: Could not initialize class ...PoseLandmarker
  改为 catch (Throwable):5 项全部通过

修复与加固:
- PoseDetector / CameraController 全部改为捕获 Throwable,失败只提示不崩溃
- 移除 accompanist-permissions 0.34.0(2024-02 发布,会传递引入
  compose animation-core 1.6.0,与 Compose BOM 存在版本偏斜风险),
  改用平台 Activity Result API
- MediaPipe 回调在相机线程:所有 Compose 状态写入统一 post 回主线程
- WebSocket 连接、相机启动、单帧分析全部包上失败保护
- 新增 CrashLogger:未捕获异常落盘到 filesDir/crashes/,
  并在连接页直接展示堆栈(免去连 adb 抓 logcat)
- 新增 ScreenCompositionTest(Robolectric):真实组合三个页面,
  覆盖「进入页面即崩溃」这一类缺陷,共 30 项单元测试
2026-09-14 22:43:03 +08:00
zijunchiang fd50a7fdf3 docs(android): 用实现说明替换阶段三占位 README v0.1.0 2026-09-14 20:40:38 +08:00
zijunchiang 570b12c215 chore(android): 合并占位说明与阶段三实现 2026-09-14 20:40:22 +08:00
zijunchiang 84da39ad17 docs(android): 任务说明、DSH 约束与交付文档 2026-09-14 20:40:16 +08:00
zijunchiang 8f0eeb7697 feat(android): T-AND-007/008 连接页/运行页/关于页 + 骨架叠加 2026-09-14 20:40:16 +08:00
zijunchiang 5737a66afd feat(android): 设置持久化(推流参数与连接信息) 2026-09-14 20:40:16 +08:00
zijunchiang d27845ef43 feat(android): T-AND-005/006 WebSocket 推流 + 主机发现 2026-09-14 20:40:16 +08:00
zijunchiang 30c316a1cc feat(android): T-AND-003 MediaPipe Pose 端侧推理 2026-09-14 20:40:16 +08:00
zijunchiang 7a8dcfba25 feat(android): T-AND-002 CameraX 采集(KEEP_ONLY_LATEST) 2026-09-14 20:40:16 +08:00
zijunchiang 94ec0a68d9 feat(android): T-AND-004 239 字节帧编解码 + 跨端金标准向量测试 2026-09-14 20:40:16 +08:00
zijunchiang 2f6212d5bf feat(android): T-AND-001 工程骨架(AGP 8.7.3 + Gradle 8.9 + Compose) 2026-09-14 20:40:16 +08:00
zijunchiang 568664a9aa chore(contracts): 引入 opendance-web v0.1.0 契约只读快照 2026-09-14 20:40:15 +08:00
zijunchiang ce2d71d22e docs: 初始化占位说明与契约依赖 2026-09-14 19:02:39 +08:00