• v0.5.0 aad60cbd2e

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

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

    动作预览(《DSH 开发文档 v1.6》4.11 / T-WEB-014)。契约 data-models -> 0.6.0。

    本次改动

    服务端

    1. 抽出公共 PNG 编码器 common/png.ts(模型缩略图改为复用;零原生依赖不变);
    2. 新增 motions/motion-thumbnail.ts:关键点序列 -> 正视图骨架 PNG
      (复用 33 点父表连线,包围盒按整段计算,低置信度点不画);
    3. motions.thumbnail_asset_id(迁移 AddMotionThumbnail)+ AssetKind.MotionThumbnail;
    4. /api/motions/:id/preprocess 生成缩略图并落库,失败只记 warning,不影响预处理;
    5. MotionDto.thumbnailUrl(契约 data-models 0.6.0)。

    管理端(重点)
    6. 新增 MotionPreview 3D 回放:懒加载 GET /api/motions/:id/keypoints(NDJSON)→
    骨架线框 + 关节球体,支持 播放/暂停、上一帧/下一帧、时间轴拖动、0.25x-2x 变速、循环,
    叠加「第 N/M 帧 · 当前时间 · 总时长」,按整段包围盒自动取景;
    7. 动作管理列表新增 40px 骨架缩略图列(点击即开预览)与「预览 / 收起预览」按钮 + 内联预览面板;
    8. three.js 单独分包(lazy + Suspense):主包 241 kB 不涨(three 568 kB 独立 chunk)。

    已有动作请重新预处理

    缩略图在 /preprocess 时生成,已有动作需要重跑一次预处理才会出现缩略图:

    # 管理端「动作管理」逐条点「预处理」,或对每个动作调用:
    curl -X POST http://127.0.0.1:3000/api/motions/<id>/preprocess
    

    预览功能本身不需要缩略图,只要动作处于 done 状态即可播放。

    校验

    opendance-web-v0.5.0.tar.gz sha256: 67afe31e51e192b0d766fff219381577b3a9c4e326c256093b5219d4b58d21c3

    Downloads