mux-voice-tracklisted
Install: claude install-skill huodebing-alt/Agentic-Headshot-Video-Studio
# Mux Voice Track / 合一旁白轨
## When to use / 何时使用
After tts-batch when a single continuous voice track is needed for timing reference or radio cut.
批量配音完成后,需要一条连续旁白轨用于时间线对齐或纯音频版本。
## Inputs / 输入
- `workspace/voice/manifest.json`.
- `--gap-ms` default 350.
## Output / 输出
- `workspace/voice/master.wav` (48 kHz, 24-bit, mono).
- `workspace/voice/master.cues.json`: per-segment start/end timestamps.
## Steps / 步骤
1. Sort manifest by segment id.
2. Build ffmpeg concat list with silence padding `--gap-ms` between entries.
3. Run ffmpeg concat + loudnorm to -16 LUFS.
4. Emit cues JSON.
## Examples / 示例
```
ffmpeg -f concat -safe 0 -i list.txt -af loudnorm=I=-16:TP=-1.5 -ar 48000 master.wav
```
## Failure recovery / 失败回退
- If any seg MP3 missing, fail loudly and list missing ids.
- If loudnorm fails (very short clip), fall back to volume normalization.