vocaloid-style-mv-pipeline — V 家手书 MV 流水线 Skill 技能

技能简介 vocaloid-style-mv-pipeline 是一款面向 Claude Code 的"V 家手书音乐 MV 制作"技能与项目模板，能把一首歌曲 + 官方歌词自动做成 showreel 级手写风歌词 MV。整支 MV 全部由前端代码渲染——HTML Canvas2D 绘制画面，WebGL2 合成后处理，Playwright headless 抓图，ffmpeg 编码成片。每一帧都是纯时间函数，可并行 seek 任意帧，3 个 worker 在 RTX 3080 上 4 分钟出 4 分钟 1080p30 完整 MV。包含完整工作流（听歌→概念→素材→分镜→渲染→评审→交付）与 24 个参数化场景、13 种转场、JIZURA 字面歌词层、Blender toon 3D 镜头脚本。

核心能力

1. 确定性渲染：每帧是 t 的纯函数（seeded noise、闭式粒子、无 wall-clock），并行 worker 可 seek 任意帧，无拼接缝。
2. 分层合成：scene 层（Canvas2D 插画、镜头、粒子）+ text 层（JIZURA 歌词、定制字体、HUD）+ foreground 层（角色始终在歌词前）+ WebGL2 后处理（line boil on 2s、OKLab palette 渐变映射、bloom、色差、glitch、zoom blur、grain、letterbox）。
3. 24 个参数化场景 + 13 种转场：illust、kanjiSlam、typeCard、titleRiff、ember、heart、skyShatter、fall、flame、ink、thread、wetFloor、train、memories、road、panels、burst、tunnel、converge、afterimage、ref、seq、jz、solid；cut/xfade/flash/black/iris/irisClose/barrier/wipe/slices/push/zoom/ink/shatter。
4. JIZURA 字面歌词层：内置上游引擎做字面排版，多 plans（styles）每片策展，deny-list 控制，角色镜头中心自由的版面，原生 9:16 重排版。
5. 节拍锁定剪辑：librosa 给出 beats、downbeats、bars、sections、stops、impacts、per-frame envelopes，处理 tempo drift；timeline 工具把每刀切在真 bar / beat。
6. 官方歌词 + 强制对齐：官方歌词优先；faster-whisper + 人声分离 + forced alignment 处理无文本或时间轴缺失场景，输出带 JIZURA markup 的 LRC（/ cut, *emphasis*, ! キメ line）。
7. 角色一致性：character bible → master candidates → 所有 pose 以 master 为参考图生成 → chroma key 到 RGBA；批量生成通过 Codex CLI，任何图模型同方法适用。
8. Blender toon 3D：EEVEE + Shader-to-RGB cel shading + Grease Pencil 线稿，约 0.7s/1080p 帧；镜头跟节拍图；可在引擎里以 image sequence 回放。
9. 交付：16:9 主版（NVENC CQ16 / x264）+ share encode + 9:16 二次重排 + 720p preview + review/stills/contact sheets + JIZURA 切点检视器。

安装配置

1. 前置：Python 3、Playwright、Edge headless、ffmpeg（含 NVENC）、Blender 5.x（toon 3D）、Codex CLI（图生成）；字体自动下载。
2. 检查环境：python skills/vocaloid-style-mv/scripts/check_env.py。
3. 安装 skill：mkdir -p ~/.claude/skills && cp -r skills/vocaloid-style-mv ~/.claude/skills/（macOS / Linux / Git Bash），PowerShell 用 Copy-Item。
4. 项目模板：python skills/vocaloid-style-mv/scripts/new_project.py ../my-mv --song path/to/song.wav --lyric path/to/lyric.lrc --setup，自动装 Playwright + Python 包、下字体、克隆 JIZURA。

使用步骤

1. 把 song.wav 和官方歌词 lyrics.txt 放进项目目录，启动 Claude Code。
2. 下达指令：make a V家手書き MV for this song (song.wav, lyrics.txt)。
3. agent 走 7 步：听歌 → 概念 → 素材 → 分镜 → 渲染 → 评审 → 交付；4 个检查点（概念、角色 master、首张静帧、首版整片）由你确认。
4. 评审 contact sheet，发现问题回到渲染步骤再迭代 2-3 轮。
5. 交付：final.mp4（16:9 主版）、share encode、9:16 二次重排、review sheets。

适用场景

• VOCALOID / V 家 / ボカロ 中文作品集作者
• 独立音乐人想要 showreel 级 lyric MV
• 短视频博主（TikTok / 微博）做歌词可视化
• 高校音乐 / 动画教学课程
• 翻唱圈、视频彩蛋、视觉系偶像 MV

适用人群

• 用 Claude Code 工作的音乐人、独立音乐制作人
• 想要专业 MV 但没有 After Effects / Premiere 的视频博主
• 中文/日文 VOCALOID 创作者、V 家风格爱好者
• 高校音乐制作、视觉传达、数字媒体学生

工作原理 vocaloid-style-mv-pipeline 把"音乐 → MV"流水线拆成 6 个独立步骤。每帧同时由三条流汇聚：scene 层（Canvas2D 插画与镜头）、text 层（JIZURA 字面与 HUD）、foreground 层（角色在歌词前），再统一交给 WebGL2 后处理做 line boil、palette LUT、bloom、色差、glitch、grain。节拍分析由 librosa 完成，自动按 bar / beat 切；时间轴是纯函数，可重做任意秒而无需重渲全部。Blender toon 3D 通过 image sequence 与引擎集成。

官方链接

• 仓库：https://github.com/EGSECDA/vocaloid-style-mv-pipeline
• 案例：仓库 examples/zanko/（NikusonP 原创《残光》3:46 MV，68 beat-locked shots）
• 引擎依赖：https://github.com/852wa/JIZURA
• 许可证：MIT