SuperAPI AI 工具集

video-review-loop

设计与创作

查看项目

更新于 10-24 16:22

技能介绍

视频审核循环(video-review-loop)是一个面向渲染成片审核的技能。其核心原则是:成片才是产品,截图只能证明某一帧,无法证明时序、节奏、转场连续性、闪烁、丢帧或冻结、音频同步、结尾行为,以及只在运动中出现的缺陷;因此最终签核需要视频证据。

用途方面,该技能用于最终渲染审核、已有 MP4 或 MOV 审核、交付前技术闸门、带时间码的运动缺陷记录、黑屏或冻结区间检测、音视频漂移检查、意外静音或削波风险评估、结尾保持验证、证据接触表生成,以及修复后的复审。它明确不替代 motion-director 的创意指导、源级几何审计、阿拉伯语排版指导、品牌审查、渲染器,以及人类或智能体对叙事与品味的判断。

主要能力包括:通过捆绑脚本 review_video.py 发起审核轮次,可指定期望宽度、高度、帧率、音频要求,也可传入参考视频与参考契约文件,生成参考与输出的配对证据,并把需保留机制写入审核清单。工具默认要求 GPU 执行重型审核;若环境确实无受支持 GPU 且明确接受 CPU 工作,可加 --allow-cpu。基础轮次返回 round_dir 后,可运行 strict_video_signals.py 做严格帧级信号审计,发现接触表可能遗漏的单帧亮度闪烁和帧间极端亮度变化,这些属于审核候选而非自动判定失败,需在实际视频上逐一检查。

证据包位于 .motion-review/rounds/<round-id>/ 下,工具会创建或尝试创建 manifest.json、technical.json、findings.json、strict-signals.json、review.md、visual-findings.json、review-state.json,以及 evidence/contact-sheet.jpg、有音频时的 waveform.png、采样场景帧和机器分析日志。源视频默认不复制进轮次;.motion-review/ 为本地私有证据并生成独立 .gitignore,除非用户明确要求,不应提交审核轮次。

严重度模型分为三级:hard 表示交付契约事实性失败,如尺寸错误、帧率不符、缺失必需音频、时长超出明确容差、音视频时长漂移超硬阈值、未证明所需结尾保持,hard 结果阻断签核;warning 表示机器证据可疑、需视觉确认,如黑屏区间、片中冻结、长静音、削波风险、可变帧率信号、分析流程失败,warning 不自动视为缺陷;review 表示机器无法判断的问题,如视觉层级弱、裁剪难看、阿拉伯语字形错误、创意重点错误、缓动生硬、转场通用、品牌契合差、叙事混乱,需 Claude 亲自检查视频。

使用方式上,强制视觉通读包括:带音频正常速度完整看一遍,静音再看一遍,密集检查第一秒,检查每个重要转场,按时间戳检查每条机器警告,检查 CTA 与结尾保持,以手机尺度查看接触表,并与已批准的运动论题和交付契约对比;不能从干净的机器报告推断成片干净。确认缺陷需用 review_round.py add 记录时间戳、严重度、可观察缺陷、责任层、修复方式和已审证据,避免“做得更好”这类模糊备注;随后用 attest 声明实际检查项(带音频观看、静音观看、首秒检查、转场检查、结尾检查、严格信号检查、参考对比、机器发现检查),再用 status 检查轮次,在强制视觉通读尚未声明且无机器或视觉 hard 发现阻断前,该命令以非零状态退出。

复审循环为:第一轮发现问题、修复源文件、重新渲染、第二轮验证;不能仅因源码改动就标记已修复,新视频才是证明。后续渲染证明视觉问题已修复时,用 resolve 记录解决方式、后续产物和证据,源码变更不算解决证据。首次有意义审核后,除非仍有 hard 缺陷,最多允许两轮确认。

GPU 政策读取 motion-director 捆绑的策略,重型解码与证据提取默认需受支持 GPU 路径,可能选择 CUDA、VideoToolbox、VAAPI、D3D11VA、QSV,具体后端取决于运行时能力;不能仅因机器有 GPU 就声称加速,所选媒体路径须通过运行时验证。部分分析用 FFmpeg 滤镜仍为 CPU 滤镜,在输入解码硬件辅助且分析有界时允许。客观检查可证明技术流元数据、尺寸、帧率契约、音频存在、时长契约、音视频时长漂移、黑屏区间、冻结区间、静音区间、峰值削波风险、结尾保持证据;不得对品味、叙事、排版质量、文化正确性、品牌契合、视觉原创性编造确定性。结尾保持可传 --expect-end-hold 指定最短时长,工具检查实际结尾附近的尾部冻结证据;静态结尾可能正确,转场中冻结帧则不同,需结合语境解读。失败行为方面,缺少 FFprobe 或 FFmpeg 时停止,GPU 必需但无可用路径时停止,分析滤镜失败应记录为证据而非静默丢弃,视频无法解码则轮次失败。面向广泛影视工作时,应向 motion-director 返回轮次路径、技术结果、hard 发现、警告、带时间码视觉发现、未解决风险和通过与否建议,最终决定与下一步制作动作由 motion-director 负责。