• v0.7.0 f2e231c0b2

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

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

    补齐场景管理前端(《DSH 开发文档 v1.6》4.12 / T-WEB-015)。
    契约保持 rest-api -> 0.5.0、data-models -> 0.7.0、database -> 0.4.0(三端一致,本次无契约变更)。

    本次改动

    1. 新增管理端「场景管理」页(左侧导航 → 场景管理,路由 /scenes):
      • 场景列表:审核状态、格式、可用性、GLB 体积、更新时间;
      • 上传:拖拽 .glb / .gltf / .zip / .pmx / .fbx(zip 自动解包、非 GLB 由服务端 Assimp 转 GLB);
      • 审核操作:通过 / 驳回(上传一律先落 pending,复用 /api/reviews/scene/:id/...);
      • 删除:同时清理对象存储中的源文件、GLB 与缩略图。
    2. 物理参数可视化编辑(对应 SceneConfig,冻结在 data-models 7.1):
      • 重力向量((0,-9.8,0) 默认,各分量 ±200)、质量无关的常量加速度;
      • 风:基础风向量 + 阵风(幅度 0100、频率 0.015Hz、方向、world/local);
      • 地面:摩擦 01、弹性 01、坡度上限 0~89 度;碰撞体 auto/mesh/none;
      • 环境:环境光颜色与强度、雾浓度;出生点(≤16)与相机(follow/fixed/orbit)。
      • 编辑期即做与后端相同的夹紧/回退(admin/src/lib/scene-physics.ts,与 scene-config.ts 同规则),
        保存前不会产生非法枚举;服务端仍会再收敛一次,服务端只存参数、不跑物理。
    3. 3D 预览:预审场景可展开惰性加载的 GLB 预览(与模型预览共用加载器),便于确认坐标系与尺寸。
    4. 版本号:管理端左下角显示当前版本(构建期由 web-server/package.json 注入),本次显示 v0.7.0。

    校验

    • 类型检查通过;vitest 245 项全绿(新增 test/scene-config.spec.ts 边界用例);
    • contracts:check 通过、check-routes 35 条路由一致;
    • 管理端生产构建通过;
    • opendance-web-v0.7.0.tar.gz sha256: 6ed1b0fd63697f38f5b4e40e25923d53d693d0742e4ef4c4093282e3c0942eab

    部署

    curl -fLO https://gitea.kasugano.cn/zijunchiang/opendance-web/releases/download/v0.7.0/opendance-web-v0.7.0.tar.gz
    curl -fLO https://gitea.kasugano.cn/zijunchiang/opendance-web/releases/download/v0.7.0/SHA256SUMS
    sha256sum -c SHA256SUMS
    tar -xzf opendance-web-v0.7.0.tar.gz && cd opendance-web-v0.7.0
    bash deploy/install.sh
    

    下一步(同一目标内继续)

    • Windows 端场景选择与物理落地(T-WIN-013)、发布整包(T-WIN-014);
    • Android 端重连与 MediaPipe 修复(T-AND-011/012)。
    Downloads