opendance
eebccd55b4
背景（用户反馈 + 本地用真 Assimp 6.0.4 复现）： PMX 的着色模型（卡通阶梯 + 球面贴图 + 平坦环境光）与 glTF PBR 不是一回事， Assimp 转换会丢掉其中一部分。实测样本【奥黛塔】_by_原神.zip（39 个材质）： 1. 主因：PMX 里 36 个材质带 drawFlag bit0（不剔除背面），而导出的 GLB 里 doubleSided 一个都没有 -> 头发/裙摆/睫毛这类薄片被单面剔除， 看起来就是颜色/贴图不对； 2. PMX 的 shininess/specular/ambient 与 PBR 无映射；Assimp 还会带上 KHR_materials_specular / KHR_materials_volume 等与 MMD 无关的扩展； 3. Assimp 把 accessor.min/max 写坏（实测 min = 2.2250738585072014e-308）， Godot 等客户端用它算包围盒。 修复： 1. 新增 src/models/pmx-materials.ts：只读 PMX 材质段（布局与权威库 mmd-parser 一致，注意贴图索引宽度是 1 字节），拿到 name/diffuse/specular/shininess/ ambient/drawFlag/球面贴图/toon/faceCount； 2. 新增 src/models/glb-materials.ts：转换后按索引把 PMX 参数补回 GLB —— doubleSided、metallicFactor=0、roughnessFactor=clamp(1-shininess/100,0.5,1)、 baseColorFactor x diffuse(含 alpha)；清掉与 MMD 无关的扩展； 修正全部浮点 accessor 的 min/max；支持 KHR_materials_unlit（MODEL_SHADING）； 3. 抽出 src/common/glb-chunks.ts（JSON/BIN chunk 读写），vrm-writer 改为复用； 4. 能力边界写清楚：PMX 的球面贴图（该模型 15 项）与 toon 阶梯在 glTF core 里 没有对应槽位，任何转换器都无法保留，数量写进 conversion_note 供审核查看； 5. 新增 test/mmd-materials.spec.ts 9 项；规模 15 文件 / 220 项； 6. 新增 MODEL_SHADING 配置（默认 pbr，可选 unlit），文档同步（README.md/.txt、DSH.md、.env.example）。
73 lines
2.6 KiB
YAML
73 lines
2.6 KiB
YAML
project: opendance-web-server
|
||
version: 0.2.5
|
||
repository: opendance-web
|
||
default_branch: main
|
||
contracts_version: 0.4.0
|
||
|
||
# 契约变更流程（文档 7.2）：
|
||
# 任何跨端契约变更必须先在本项目修改 contracts/ 并提升版本，
|
||
# 再在 opendance-windows / opendance-android 创建适配任务。
|
||
|
||
database:
|
||
# 使用现有实例，本项目不部署、不管理 MySQL
|
||
managed_by: external
|
||
engine: MySQL 兼容（含 MariaDB 10.5+）
|
||
name: opendance
|
||
charset: utf8mb4
|
||
migrations: TypeORM migration
|
||
synchronize: forbidden
|
||
|
||
tasks:
|
||
- id: T-WEB-001
|
||
file: tasks/001-scaffold.md
|
||
scope: NestJS 骨架 + 连接现有 MySQL
|
||
status: done
|
||
- id: T-WEB-002
|
||
file: tasks/002-db-migration.md
|
||
scope: TypeORM 迁移生成 opendance 表结构
|
||
status: done
|
||
- id: T-WEB-003
|
||
file: tasks/003-song-crud.md
|
||
scope: /api/songs CRUD
|
||
status: done
|
||
- id: T-WEB-004
|
||
file: tasks/004-motion-upload.md
|
||
scope: 动作数据上传（BVH / VMD / FBX / glTF / keypoints）+ 来源字段
|
||
status: done
|
||
- id: T-WEB-005
|
||
file: tasks/005-model-upload.md
|
||
scope: 模型上传（GLB/VRM 直接导入 + PMX/FBX 转换 + .zip 自动搜索）+ 自动分析/缩略图 + 上传即待审
|
||
status: done
|
||
- id: T-WEB-006
|
||
file: tasks/006-keypoint-preprocess.md
|
||
scope: BVH / VMD / FBX -> 关键点序列预处理
|
||
status: done
|
||
- id: T-WEB-007
|
||
file: tasks/007-upload-review.md
|
||
scope: 上传审核流程
|
||
status: done
|
||
- id: T-WEB-008
|
||
file: tasks/008-admin-ui-songs.md
|
||
scope: 歌曲管理界面
|
||
status: done
|
||
- id: T-WEB-009
|
||
file: tasks/009-admin-ui-models.md
|
||
scope: 模型管理界面 + 来源展示
|
||
status: done
|
||
- id: T-WEB-010
|
||
file: tasks/010-deploy.md
|
||
scope: 部署脚本（双端口：软件 API 3000 + 管理端 3001，不部署 MySQL）+ deploy/.env 初始化引导（init-env.sh，HOST 默认 0.0.0.0）
|
||
status: done
|
||
|
||
deliverable:
|
||
artifact: opendance-web-v0.2.5.tar.gz
|
||
packaging: Linux 业务服务（系统服务托管，双端口：软件 API + 管理端，不含 MySQL、不含反向代理、不使用 Docker）
|
||
includes:
|
||
- web-server/ # NestJS 源码 + 构建产物（含 BVH / VMD 内置解析、ZIP 读取与模型压缩包转换）
|
||
- admin/ # React 管理端构建产物
|
||
- deploy/ # install.sh / init-env.sh / systemd / openrc / initd / ctl.sh / .env.example（PORT、ADMIN_PORT、HOST）
|
||
- deploy/proxy/ # 反向代理说明（nginx / IIS，仅供参考不部署）
|
||
- contracts/ # 当前版本契约快照（0.4.0）
|
||
- THIRD_PARTY.md # 开源声明
|
||
- README.txt # 使用说明
|