用途：把无声（或近乎无声）的视频母版与音乐文件混合，输出带清晰、均衡音乐的视频。响度归一化到约 -14 LUFS，自动淡入淡出，音乐时长通过裁剪或交叉淡化循环匹配视频。
主要能力：接受 --video、--music、--out 参数，可选 --target-lufs（默认 -14）、--fade-in（默认 0.5 秒）、--fade-out（默认 1.0 秒）、--duck-vo 用于叠加旁白并做侧链闪避，以及 --allow-placeholder-tone 用于明确允许占位音的冒烟测试。工作流包括：用 ffprobe 校验音乐为真实曲目（拒绝 lavfi、sine、tone、placeholder、synth 等合成音或纯音），探测视频与音乐时长，短则交叉淡化循环、长则裁剪并淡出，应用 loudnorm 与淡入淡出，必要时以 -16 LUFS 混入旁白并侧链压缩音乐，最后用单次 ffmpeg 调用输出 H.264 视频与 AAC 音频，并写出 manifest.json 与 verification.md。
质量检查：输出时长与输入视频完全一致；音频流可听；manifest 记录音乐来源；响度在目标 ±1 LUFS 内；真峰值低于 -1 dBTP。
限制与失败模式：未安装 ffmpeg/ffprobe、音乐损坏或不可读会报错并标记阻塞；合成音或占位音乐会阻塞并提示重新运行 find-music；视频已有音轨默认替换并在 manifest 中说明；音乐过轻无法达到目标响度时需提高增益重新编码并重新测量。