dsh-reze-render

dsh-reze-render

用 reze-engine 离线出一段 MMD 视频——一个工具调用，拿回成品与判据。

爱丽丝（Alice）的自研插件 · DSH（DeepSeek Harness）· v0.1.0

---

快速开始

1) 装依赖（在目标 profile 的 package.json 加 link 依赖）：

"dsh-reze-render": "link:E:/alice/self-plugins/dsh-reze-render"

2) 挂组合：

- id: dsh-reze-render
  name: dsh-reze-render

3) 30 秒验证：reze_status → 应报浏览器 / ffmpeg / ffprobe / 引擎 bundle 四项就绪 + 资产清单

它做什么

reze-render 把「用 WebGPU 引擎离线渲染 MMD」这条链路封成三个工具：

判据不是装饰：帧间变化 来自 ffmpeg -f framemd5 的逐帧哈希去重比值——1.0 表示每一帧都不同（画面一直在动），接近 1/总帧数 则说明画面静止。"帧数对了"不等于"片子出来了"。

安装

# 1. 放到 self-plugins 下并挂载（DSH 常规流程）
dsh plugin --profile web add link:<path>/dsh-reze-render

# 2. 准备资产（第三方素材，本仓不含）
#    资产根下需要：models/**/*.pmx 与 animations/*.vmd
#    reze-engine 仓库自带的演示资产可直接用：<engine>/web/public/{models,animations}

# 3. 配置资产根与产物目录（profile 的 cordis.patch.yml 或插件配置）
#    assetRoot: E:/alice/assets/media/mmd-assets   ← 本机真身（models/ animations/ stages/ accessories/）
#    outDir:    E:/alice/reze-out                  ← 不存在会自动创建（mkdir recursive）

使用

reze_status                                  # 先看能不能出片、有哪些料
reze_preview  model=models/reze/reze.pmx motion=animations/IRIS\ OUT.vmd at=6 distance=36
reze_render   model=models/reze/reze.pmx motion=animations/IRIS\ OUT.vmd seconds=8 fps=30 width=1920 height=1080 distance=36 start=6

配置

技术要点（踩过的坑，写进实现）

1. 无头浏览器必须带 --no-sandbox：只加 --enable-unsafe-webgpu 时 navigator.gpu 根本不存在，加 --no-sandbox 才拿得到 adapter（本机 Intel gen-12lp 实测）。这条配方来自 reze 引擎自带的 tools/validate-wgsl.mjs。
2. 引擎 npm 包不能直接被浏览器 import：reze-engine 的 dist/ 相对 import 不带扩展名（给打包器看的）。本仓内置 assets/engine/reze-engine.js（reze-engine@0.56.11 的 esbuild 打包产物）：

   npm i reze-engine@0.56.11 esbuild && echo 'export * from "reze-engine"' > entry.js
   npx esbuild entry.js --bundle --format=esm --outfile=assets/engine/reze-engine.js --loader:.wgsl=text
   

3. setCameraTarget 有两个重载、运行时 duck-typing 分派：传数组会被当成 Model 重载，随后崩在 m.getBoneWorldPosition is not a function。本插件只用数值机位旋钮（distance/alpha/beta）。
4. 帧数据不经过模型上下文：出帧页把 PNG POST 回本地临时服务器落盘，工具只回路径与读数。一次 240 帧若不这么做，上下文会被烧穿。
5. 进程自清理：运行结束（含失败路径）按 PID 树 kill 自己启动的浏览器并删临时 profile——只杀自己启动的那个 PID，不按进程名清场。

语义文档与验收

• 语义文档：docs/semantic.md（定位/不变量/契约/边界/可证伪验收/未决问题）
• 端到端实测（本机）：reze_status ready=true（Chrome + ffmpeg 8.1 + bundle + 资产根，4 模型 / 12 动作）；reze_preview 4.9 s 出 960×540 PNG；reze_render 1920×1080 / 4 s / 120 帧，帧间变化 1.0、时长与帧数自洽、产物 573 KB，全程 15.4 s

版权

• 本插件只处理调用者自备的第三方资产（MMD 模型/动作有其自己的使用规约，例如常见条款为「请勿二次配布 / 请勿商用」）——本仓不含任何模型或动作，也不下载、不分发。
• 内置的 assets/engine/reze-engine.js 是 reze-engine（MIT）的构建产物，版权归原作者。

License

MIT

测试

⚠ 本插件的测试跑法见 package.json 的 test script（用 node --test "tests/*.test.mjs" 可能跑不到用例——不是没测试，是跑法不对）。