技能介绍

要解决什么问题

手里只有一首 MP3，却需要带段落节奏、歌词字幕和简单视觉叙事的成片 MV——手工在剪辑软件里对轴、切场景、做字幕，往往要反复听几遍歌。这个技能把「能量分析 → 时间轴配置 → HTML 动画 → 可选录屏出片」串成固定流水线，面向单人歌曲纪念、班级/团队向歌词视频这类不需要专业 NLE 的场景。

技能如何工作

音频侧：scripts/analyze_audio.py 读 MP3 能量包络，给出时长、intro_end / outro_start 以及 low_energy_regions，用来对齐前奏、间奏和段落切换。

编排侧：按 Intro / Verse / Chorus / Bridge / Outro 写 lyric_sections，为每段指定 scene（背景色调与特效组合）；name_cards 用 section、行号与 offset 把 polaroid 名片钉到具体歌词；fallback_times 提供每行歌词的起始秒数，移动版依赖这条时间轴而不是浏览器里再分析音频。

成片侧：scripts/build_mv.py 填充 assets/mv_template.html，产出桌面预览 mv.html（含 Web Audio 增强）与单文件 mobile-mv.html（MP3 以 data:audio/mp3;base64 内嵌，点击播放再设 audio.src，降低白屏风险）。需要通用格式时，scripts/record_mv.js 在本地 HTTP 预览移动版，用 headless Chrome 静音驱动动画、CDP 截帧，再经 ffmpeg 合 H.264 与音轨得到 mv.mp4。scripts/make_mv.py 可串起分析、生成、起服、录屏与清理。

适用边界与注意点

视觉是模板化五场景 + Canvas 粒子/名墙/毕业动画，不是按语义自动生成剧情分镜；歌词与人名、时间轴需你在 JSON 里填准。
录屏路径依赖 Python 3.10+、Node 18+、系统 Chrome、puppeteer-core、ffmpeg（可用 imageio-ffmpeg 自带二进制）；录屏时长接近歌曲实时，长歌会慢。
沙箱或权限限制写入时，可先输出到工作目录再复制；帧率不稳时应用实际帧时间戳算 fps。细节见技能内 references/troubleshooting.md。