用途:为已剪好的口播视频生成字幕,处理做字幕、加字幕、改字幕、重新分屏等需求;不用于删词剪辑、物理剪切、分镜动画或成片渲染。前提是已存在账本 edit-list.json 与逐词稿 transcript.json,产出 subtitles.json。
主要能力与原理:字幕一屏存词 id 列表与显示文字,不存秒数,时间每次由账本现算,因此不导出、不重新转录也能得到剪后时间。改字分两步:词典(固定写法,不看上下文直接改,需用 references/ai-term-dictionary.md)与文稿(transcript align 逐处要证据,只报不改,应用需转成 [{wordId, text}] 再跑 transcript correct)。分屏按四条优先级规则:跨删词边界、任何标点、无标点时的段落边界加停顿、句内长静音;碎片合并但不跨句号。
使用方式:先做 Runtime 预检,从 Codex 已启用插件列表取得 chengfeng-videocut 的 source.path,运行 scripts/ensure-runtime.cjs(加 --install-if-missing)确认就绪,再依次运行 inspect 断言输入、transcript dictionary / align / correct、subtitle build、open 打开 Studio 在“字幕”标签页逐屏复核(回车另起一屏、行首退格并入上一屏、参数内含四个字幕预设)。
限制与注意:已有字幕时 build 会拒绝,必须询问用户后才可加 --replace,因为会覆盖人工分屏与措辞;改几个字应直接在 Studio 改。Runtime 不可用或安装失败应停止并给出结构化诊断,不得自制替代界面继续。报告需区分 API readback 与人工目视复核,未实际看过时为 human listening UNVERIFIED。字幕尺寸为画面百分比,烧进画面与渲染成片不在本技能范围,当前导出的 mp4 尚无字幕。词典报读不懂行说明表格行格式损坏,correct 报不得改 id、时间或 gap 标志。其他收费、价格等信息暂未提供。