用途:对渲染完成的视频做四层质检,按成本从低到高执行。L1 用 ffprobe/ffmpeg 检查黑帧、卡帧、闪光帧、解码错误、时长、静音、LUFS 与削波;L2 在每处对白剪辑点做转写边界检查(截断词、重复短语、接缝静音、字幕覆盖、拼接卡嗒声)并做孤立接缝复测;L3 可选,用多模态模型观看并聆听 480p 代理视频(音频完整),5fps 采样,强制 JSON,用于提示问题位置;L4 为单窗口生成检查包(缩略图墙、标注波形、词级转写、音频统计)供修改前核对。
使用方式:先安装引擎并运行。install:npm --prefix tools/video-qa install。常用命令:npm --prefix tools/video-qa run qa:video -- --manifest <p>/spec.qa-manifest.json --words <p>/transcript.json;--lane hyperframes --video <p>/out.mp4 --edl <p>/edl.json --words <p>/words-master.json --words-are-output;仅技术加语义:--video <p>/out.mp4;检查包:qa:inspect;分镜:qa:storyboard;强制层级:--require-layers technical,transcript。退出码 0 PASS、1 PASS_WITH_WARNINGS、2 FAIL,报告写入 <video dir>/_qa/<stem>/qa-report.{md,json}。
限制:需 node>=20、ffmpeg/ffprobe(可设 FFMPEG_PATH/FFPROBE_PATH),L3 需 GEMINI_API_KEY,缺失则跳过;无编辑意图清单时仅跑 L1+L3;L3 时间戳约 ±2s,只能提示位置;分镜静态检查不验证实际渲染可见性;不得整段重转写后 diff。
资料未提供的部分:报告未给出安装包版本、计费方式、平台支持范围与具体性能指标的完整说明。