From 06c2fd688b57b2493d3f28191115ca68498072b6 Mon Sep 17 00:00:00 2001 From: zijunchiang Date: Tue, 15 Sep 2026 21:36:41 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=85=A8=E8=A7=92=20=EF=BD=9C=20?= =?UTF-8?q?=EF=BC=8F=20=EF=BC=9F=20=E6=94=B9=20ASCII=EF=BC=88Gitea=20?= =?UTF-8?q?=E6=B7=B7=E6=B7=86=E5=AD=97=E7=AC=A6=E6=A3=80=E6=B5=8B=E7=9A=84?= =?UTF-8?q?=E5=89=A9=E4=BD=99=E8=A7=A6=E5=8F=91=E9=A1=B9=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- tasks/005-model-upload.md | 2 +- tasks/010-deploy.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/tasks/005-model-upload.md b/tasks/005-model-upload.md index 98847bc..e371181 100644 --- a/tasks/005-model-upload.md +++ b/tasks/005-model-upload.md @@ -74,7 +74,7 @@ web-server/scripts/import-default-model.mjs | ZIP 读取 | `common/zip-reader.ts` | 中央目录/EOCD、STORE(0)+DEFLATE(8)、ZIP64 大小字段、Shift-JIS/GBK 文件名回退；拒绝 zip-slip 与加密条目；不支持的压缩方式报错 | | 选主模型 | `model-convert.ts` | 格式优先级 `.vrm` -> `.glb` -> `.gltf` -> `.pmx` -> `.fbx`；同一优先级内"`MODEL_CONVERT_PMX` 指名字（默认 `Hatsune Miku.pmx`，大小写不敏感）-> 目录最浅 -> 文件最大" | | 直接导入 | `importModelFile()` | `.vrm`/`.glb`/`.gltf` 原样入库；`.glb` 若含 `VRMC_vrm`/`VRM` 扩展会被识别为 VRM | -| 转换 | `convertModelFile()` / `convertModelArchive()` | `MODEL_CONVERT_FORMAT=glb`（默认）｜`vrm`；超时 `MODEL_CONVERT_TIMEOUT_MS`（默认 180000） | +| 转换 | `convertModelFile()` / `convertModelArchive()` | `MODEL_CONVERT_FORMAT=glb`（默认）|`vrm`；超时 `MODEL_CONVERT_TIMEOUT_MS`（默认 180000） | | 回读校验 | `exportAndValidate()` | 每步产物**必须** `assimp info` 回读；退出码 0 但产物损坏也判失败 | | GLB 打包 | `gltf-packer.ts` | GLB 直出失败时导出 `.gltf`，把 `.bin` 与外部贴图自行合成单文件 GLB | | VRM 封装 | `vrm-writer.ts` | `MODEL_CONVERT_FORMAT=vrm` 时只改 JSON chunk 补 `extensions.VRMC_vrm`；humanoid 骨骼不全 -> **回退交付 GLB**，缺失骨骼写进说明 | diff --git a/tasks/010-deploy.md b/tasks/010-deploy.md index ac9938e..7fd51a9 100644 --- a/tasks/010-deploy.md +++ b/tasks/010-deploy.md @@ -181,7 +181,7 @@ install.sh 检测到缺 deploy/.env - **模型转换配置**（`deploy/.env.example` 已写入）： - `ASSIMP_BIN=assimp`：上传 `.zip` 模型包或 `.pmx`/`.fbx` 单文件时**必须**能调用到， 否则转换失败 **422** - - `MODEL_CONVERT_FORMAT=glb`（默认）｜`vrm`：只影响需要转换的 PMX/FBX 的交付格式。 + - `MODEL_CONVERT_FORMAT=glb`（默认）|`vrm`：只影响需要转换的 PMX/FBX 的交付格式。 `glb` 通用，两个客户端都原生加载；`vrm` 在 GLB 之上补 `VRMC_vrm` 扩展 （humanoid 骨骼 / 表情语义），**humanoid 骨骼名映射不全时自动回退交付 GLB** 并写进 `models.conversion_note`。产物一律 `assimp info` 回读校验