用途:给已剪好的口播视频做字幕。前提是剪辑账本 edit-list.json 已存在,且项目内有 transcript.json 逐词稿;产出 subtitles.json。它不重新转录,也不做物理剪切、分镜、动画或成片渲染。
主要能力:字幕屏只存词 id 列表与显示文字,不存秒数,时间每次从账本现算,因此剪辑改动可精确定位到第几屏、丢了哪些字。改字分两步:词典(固定写法,不看上下文直接改)与作者文稿对齐(逐处要证据,对不上报“不敢定”)。分屏按四条规则:删话处、任何标点、段落边界加停顿(仅无标点时)、句内长停顿;碎片会被并掉但不跨句号。
使用方式:先做就绪检查,再运行 ensure-running.cjs 与 videocut-cli.cjs inspect 断言账本与逐词稿存在。改字用 transcript dictionary 与 transcript align,应用提案用 transcript correct。分屏用 subtitle build,已有字幕时须加 --replace 并先征得用户同意。复核用 open 打开 Studio 的“字幕”标签页逐屏查看。
适用场景:刚剪完或删改后需要加字幕、改字幕、重新分屏、字幕不对时。
限制:需要账本与逐词稿,缺失时停止而非自行生成;不重新转录;词典可能改错,需人工看清单;专名无法确认时不许猜,应补词典;产出止于 subtitles.json,导出 mp4 中暂无字幕,报告须写明该后果。