Install
ugk task install video-zh-dubber
This task installs 7 files from the official manifest, including 2 script files.
Runtime input
videoPath必填,本地视频文件路径,例如 C:\\Users\\...\\video.mp4。必须原样提取为路径字符串。
subtitlePath必填,源英文字幕路径,支持 .srt 或 .vtt。必须原样提取为路径字符串。
zhSubtitlePath可选,如果用户已经有中文字幕文件,填它的本地路径;没有就留空,worker 需要把 subtitlePath 翻译为 outputDir/translated.zh.srt。
voice可选 MiMo 预置音色 ID,必须精确填 ID,不能填自然语言描述。完整列表: mimo_default、冰糖、茉莉、苏打、白桦、Mia、Chloe、Milo、Dean。中文女声: 冰糖/茉莉; 中文男声: 苏打/白桦。dispatcher 应根据用户想要的语言、性别和气质选择最接近的 ID,把语气、节奏、感染力等表达方式写入 stylePrompt。
stylePrompt可选 MiMo 风格控制提示。默认使用自然清晰、适合视频解说的中文语气。
maxChars可选,每个 TTS 分组的最大中文字符数,默认 120。数值越小越贴近字幕时间轴,但 API 调用次数更多。
subtitleColor可选,硬字幕文字颜色。只允许 white、yellow、pink。用户说白色填 white,黄色填 yellow,粉色填 pink。默认 white。
Acceptance
checktranslated.zh.srt 存在,可解析,包含中文,且 cue 数量等于源字幕。
checkdub.zh.wav 存在,ffprobe 可解析,且 duration > 0。
checkfinal.zh.mp4 存在,ffprobe 可解析,且包含视频流、音频流和字幕流。
checkfinal.zh.hardsub.mp4 存在,ffprobe 可解析,且包含视频流和音频流。
checkdub-summary.json 存在且记录 voice、subtitleColor、cue 数、speechGroupCount、dubAudioPath、finalVideoPath,且 voice 等于本次输入 voice。