dsh-reze-render
DiscoveredDSH plugin for offline rendering of MMD videos using reze-engine: reze_status / reze_preview / reze_render (headless WebGPU per-frame rendering + ffmpeg encoding + on-the-fly criterion calculation)
dsh-reze-render
用 reze-engine 离线出一段 MMD 视频——一个工具调用,拿回成品与判据。
爱丽丝(Alice)的自研插件 · DSH(DeepSeek Harness)· v0.1.0
它做什么
reze-render 把「用 WebGPU 引擎离线渲染 MMD」这条链路封成三个工具:
| 工具 | 干什么 |
|---|---|
reze_status | 这台机器现在能不能出片、手里有哪些料(浏览器 / ffmpeg / 引擎 bundle / 资产根 + 模型与动作清单) |
reze_preview | 出静帧看机位(支持一次出多张候选做机位对照) |
reze_render | 出视频,并返回现算的判据读数:帧数 · 期望帧数 · 分辨率 · 时长 · 编码 · 字节数 · 帧间变化 |
判据不是装饰:帧间变化 来自 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/media/reze
# outDir: E:/alice/reze-out
使用
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
配置
| 字段 | 默认 | 说明 |
|---|---|---|
assetRoot | 空(必填才能出片) | 资产根:其下需有 models/ 与 animations/ |
outDir | 系统临时目录 /reze-render | 产物目录;每次运行在 runs/<时间戳>/ 下工作 |
chromePath | Chrome 默认安装路径 | 无头浏览器可执行文件 |
ffmpegPath / ffprobePath | ffmpeg / ffprobe(走 PATH) | 编码与探针 |
技术要点(踩过的坑,写进实现)
- 无头浏览器必须带
--no-sandbox:只加--enable-unsafe-webgpu时navigator.gpu根本不存在,加--no-sandbox才拿得到 adapter(本机 Intel gen-12lp 实测)。这条配方来自 reze 引擎自带的tools/validate-wgsl.mjs。 - 引擎 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 setCameraTarget有两个重载、运行时 duck-typing 分派:传数组会被当成 Model 重载,随后崩在m.getBoneWorldPosition is not a function。本插件只用数值机位旋钮(distance/alpha/beta)。- 帧数据不经过模型上下文:出帧页把 PNG
POST回本地临时服务器落盘,工具只回路径与读数。一次 240 帧若不这么做,上下文会被烧穿。 - 进程自清理:运行结束(含失败路径)按 PID 树 kill 自己启动的浏览器并删临时 profile——只杀自己启动的那个 PID,不按进程名清场。
语义文档与验收
- 语义文档:
docs/semantic.md(定位/不变量/契约/边界/可证伪验收/未决问题) - 端到端实测(本机):
reze_statusready=true(Chrome + ffmpeg 8.1 + bundle + 资产根,4 模型 / 12 动作);reze_preview4.9 s 出 960×540 PNG;reze_render1920×1080 / 4 s / 120 帧,帧间变化 1.0、时长与帧数自洽、产物 573 KB,全程 15.4 s
版权
- 本插件只处理调用者自备的第三方资产(MMD 模型/动作有其自己的使用规约,例如常见条款为「请勿二次配布 / 请勿商用」)——本仓不含任何模型或动作,也不下载、不分发。
- 内置的
assets/engine/reze-engine.js是 reze-engine(MIT)的构建产物,版权归原作者。
License
MIT
Comments
Loading…
Similar plugins
by ayst-z
DSH 插件:把一支 MV 写成代码(music-code-mv)。确定性的 Canvas2D / Three.js 镜头在无头 Chrome 里逐帧渲染,再用 ffmpeg 编码;并带一个中文图形界面「MV 工坊」。 / DSH plugin: render code-driven music videos, with a Chinese MV Studio GUI.
★ 4
MIT
JavaScript
Oct 15, 2026
dsh plugin --profile web add dsh-music-code-mvby full-aigc-plugins
Analyze shots, approve an edit by hash, and render videos locally with FFmpeg.
★ 0
JavaScript
Nov 9, 2026
dsh plugin --profile web add video-factoryby zemul
dsh-better-sidebar 的视频文件预览插件: 在侧边栏打开 .mp4 .webm .mov .mkv .avi 等视频文件时,内联渲染一个可播放、可拖拽进度条的 <video> 播放器。
★ 11
↓ 912/wk
MIT
JavaScript
Nov 14, 2026
dsh plugin --profile web add dsh-video-previewby Ebony-Vinyl
DeepSeek Harness 本地视频制作与设计插件:多轨剪辑、模板与设计体系、原生预览画布和真实文件导出
★ 1.8k
↓ 3k/wk
AGPL-3.0
JavaScript
Nov 8, 2026
dsh plugin --profile web add eac-design-worldby feigo313
DSH 侧边栏的内联音视频预览插件(dsh-better-sidebar 伴生):自带 /media 路由支持 HTTP Range,mp4/mkv/mp3/flac 直接播、可拖时间轴,无需先下载
★ 0
JavaScript
Oct 23, 2026
dsh plugin --profile web add dsh-av-previewby chenjie1129
Remotion video creation and verified rendering plugin for DeepSeek Harness
★ 3
↓ 44/wk
MIT
TypeScript
Nov 4, 2026
dsh plugin --profile web add @chenjie1129/dsh-remotion-video-plugin