zijunchiang/opendance-web
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 17 Wiki Activity

17 Releases 17 Tags

RSS Feed
  • v0.3.0 39bfd390e3
    Compare

    OpenDance Studio Web 服务端 v0.3.0 Stable

    zijunchiang released this 2026-09-17 00:05:02 +08:00 | 21 commits to main since this release

    OpenDance Studio -- Web 管理服务端 v0.3.0

    模型主力格式全面转为 VRM（契约 data-models / model-formats -> 0.5.0）。
    按《DSH 开发文档 v1.6》4.9 与第十一章实现的第一步（Web 端）。

    本次改动

    1. 所有上传的模型一律转 VRM：MODEL_CONVERT_FORMAT 默认改为 vrm
      （.pmx/.fbx 走 assimp -> GLB -> VRM 1.0；.glb/.gltf 导入后包装为 VRM）。
      支持库：自研 vrm-writer / vrm-inspector + 外部 assimp（可选 @gltf-transform/core 校验）。
    2. humanoid 硬门槛 + 可用性标记（按你的选择「入库但标记不可用，不进入已发布目录」）：
      • 必需骨齐全 -> 交付 VRM，usable=true，可发布可选用；
      • 不达标（如 MMD 日文骨名 0/22）-> 回退交付 GLB、usable=false，
        可入库、可审核，但不进入 catalog/export（/api/catalog/version 指纹同步过滤），
        resolveDefaultModelId 也不会选中它；
      • 管理端模型列表与审核面板显示「不可用」及原因
        （如 humanoid 不达标（0/22），未产出 VRM）；待骨骼按 skeleton-topology
        标准重绑定后重新导入即转为可用（下一步 T-WEB-013）。
    3. 管理端左下角展示当前版本号（v1.5 文档第十一章）：构建期从
      web-server/package.json 注入，与 GET /health 的 version 同源；
      顺带修掉了侧栏里写死的「契约 rest-api 0.1.0」。
    4. 契约：data-models / model-formats -> 0.5.0（三端契约文件逐字节一致，
      已同步 opendance-windows / opendance-android 仓库）。
    5. 测试规模 16 文件 / 225 项。

    升级注意

    • 升级后新上传/重新导入的模型才会走 VRM 管线；存量 GLB 模型会显示为「不可用」，
      不再出现在客户端目录里 —— 这是本次策略变更的预期结果。
    • 想保留旧行为可显式设置 MODEL_CONVERT_FORMAT=glb（不推荐，与 0.5.0 契约不符）。

    校验

    opendance-web-v0.3.0.tar.gz sha256: 46c19e8f51a38f083bfc41e190fc45548dd0b248bd9a0932fdeaddd9988feb81

    Downloads