Visant Video Editor 是一套以 POSIX shell 脚本为核心的视频剪辑流程工具,用于把原始手机素材整理成 vlog、活动视频或视频课程。它不提供 Node 环境,也没有图形界面,全部通过命令行运行。
用途方面,它主要处理从数十到数百个手机拍摄片段组成的素材文件夹,片段长度约 1 至 120 秒,方向可能混排,各片段音频电平差异较大。工具将工作分为两部分:确定性的自检环节判断整条流程能否稳定产出完整视频;剪辑取舍则由使用者阅读 breakdown 后自行决定,包括选用哪个片段、顺序和时长。
主要能力包括:自检脚本在独立沙箱中生成夹具并验证流程,覆盖静默失败场景;ingest 读取全部素材元数据并按拍摄时间排序生成清单;cutlist 在时长上限内生成剪辑单,长于 25 秒的语音片段默认保留,超限时先收紧各类片段上限,再对 b-roll 做均匀抽样;breakdown 输出逐条剪辑明细、按天章节和带编号缩略图的联系表;build 对每条剪辑归一化后拼接输出成片,并可校验响度、时长和联系表。工具支持 youtube(16:9 1920x1080,完整语音)、reels(9:16 1080x1920,单段语音最长 8 秒,总长上限约 1 分钟)、archive(16:9 完整保留)三种配置。
使用方式上,先运行 scripts/self-test.sh 自检,再依次运行 ingest.sh、cutlist.sh、breakdown.sh,在用户查看剪辑单和总时长并批准后,运行 build.sh 输出 _out/vlog.mp4,最后用 ffprobe 和 ebur128 检查时长与响度,并打开联系表确认开头片段。用户已批准配置时可运行 SRC=/path/media PROJ=/path/project PROFILE=youtube bash scripts/all.sh。剪辑单 _build/edl.txt 采用 TAB 分隔,每行包含文件、入点和出点,注释行可剔除片段而不删除源文件。
对于带解说的剪辑,工具提供 transcribe.sh 生成带时间码的句子、frames.sh 找片段入口、plan.py 按论证逻辑构建剪辑单,语音与画面可来自不同文件。对于课程录屏,则采用逐句处理流程:先转写,再人工决定保留哪些句子并手写剪辑单,扫描音频异常后构建,重点避免在词或论述中途剪切,并注意保留课程结尾的评价句。若素材中单条片段内部有大量静音,可在 ingest 前用 auto-editor 处理。素材位于云盘挂载时读取会触发下载,编码和读取耗时较长,建议后台运行并提前告知用户成本。
限制方面,工具自身不决定剪辑取舍,需要人工审阅;自检通过不代表成片质量合格,仍需查看联系表;转写依赖 faster-whisper,静音裁剪依赖可选的 auto-editor;README 建议在新增工具前先查阅 references/tools.md。