这是视频剪辑链条的最后一段,负责把此前所有标注(账本切片段、字幕、HTML 画面层)烧录成一个成片文件。
用途与输入:需要 edit-list.json(必须)、subtitles.json、visuals.json 及 modules/,产出成片.mp4。前提是机器上有 Google Chrome 用于把字幕和动画画成图;桌面安装来源的 FFmpeg/FFprobe 随 App 进入受管目录,纯 CLI 安装要求系统 ffmpeg ≥ 6。缺 Chrome 会明确报错。
用法:先跑 node "<插件根>/scripts/ensure-running.cjs" --json 做就绪检查,再执行 node "<插件根>/scripts/videocut-cli.cjs" export <project>,支持 --dry-run、--out、--scale、--keep-work 等参数。先 --dry-run 报计划(片长、帧数、字幕屏数、画面层数、推近段数、输出尺寸),再真跑。清晰度上源片是天花板:源宽 ≥2560 用 --scale 1,源宽 <1920 建议先找同次录制的高清导出,确实没有再用 --scale 2;不要为清晰度调 --fps。
验收要求三件事:命令成功返回、抽帧看像素(覆盖推近段、整屏动画段、仅字幕段、层边界)、人耳听感。抽帧可用 ffmpeg -v error -ss 8.84 -i 成片.mp4 -frames:v 1 -y frame.png。判推近要找被裁掉一半的元素等判别性地标。
限制:导出只读,不改项目文件、不做 CAS 写入、不推进 stage,重跑覆盖;不得用预览截图、DOM 或日志代替成片抽帧;没人听过不得报 human listening PASS。