Communitygithub.com

运动图形预飞QA

为运动图形、AI编码视频(HyperFrames、Remotion、HTML/GSAP)以及短格式社交媒体广告(Instagram Reels、TikTok、YouTube Shorts、LinkedIn)提供自动化的预渲染和后期渲染质量保证。审核编解码器、像素格式(yuv420p)、快速启动流标志、EBU R128响度(-14 LUFS / -1 dBTP)、死黑片段,生成6帧平台安全区域QA联系表,并输出可交付的成品MP4。

运动图形预飞QA 是什么?

Motion Preflight QA 是一款确定性质量门控工具,专为代码渲染的运动图形和短格式视频广告设计,用于在交付前进行自动化的技术审核和修复。它支持多个社交平台(Reels、TikTok、Shorts、YouTube、LinkedIn、Square),通过8项技术检查(容器编解码器、像素格式、快速启动、宽高比、帧率、黑帧、音频响度、文件大小)验证视频是否符合广播标准和平台要求。该工具还能生成带有UI危险区域和标题安全区域的联系表,便于视觉检查。如果审核未通过,它可以自动修复像素格式、注入快速启动标志、应用EBU R128响度标准化,并优化比特率,最终输出高质量的交付文件。所有脚本均基于Python 3.9+标准库,无需第三方包。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Shk2005/motion-preflight-qa/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

运动图形预飞QA 是做什么的?

用于代码渲染的运动图形和短格式视频广告的确定性广播和社交平台质量门控。旨在消除盲目的重新渲染、裁剪的字幕、静音/压碎的音频以及 iOS/QuickTime 播放错误。

先决条件

  • Python 3.9+(仅标准库——无需第三方 Python 包)
  • PATH 中可用的 FFmpeg 和 FFprobe

标准 QA 工作流程(每次交付前运行)

步骤 1:审核渲染的视频

针对目标平台(reels、tiktok、shorts、youtube、linkedin、square 或 auto)运行 8 门技术审核:

python3 scripts/audit_video.py path/to/video.mp4 --platform reels

当需要链接到自动化流水线时,使用 --json 获取机器可读的输出。

它验证的内容:

  1. 容器和编解码器: H.264(libx264)或 HEVC MP4 兼容性。
  2. 像素格式(yuv420p): 捕获在 QuickTime、Safari 和 Instagram iOS 中显示为黑屏的 yuv444p/10 位导出。
  3. Web 快速启动(moov 在 mdat 之前): 验证即时渐进式移动播放,无缓冲延迟。
  4. 宽高比和分辨率: 检查是否匹配目标平台尺寸(例如,9:16 竖屏为 1080x1920)。
  5. 帧率一致性: 验证干净的标准 FPS(24、30、60 或 120),并标记非标准可变帧率。
  6. 片段完整性(黑帧扫描): 标记任何死黑开头(开头 > 0.25 秒)或视频中间意外出现的黑帧间隙。
  7. 音频响度(EBU R128): 根据社交平台标准 -14 LUFS / -1.0 dBTP 测量综合响度(I,以 LUFS 为单位)和真峰值(TP,以 dBTP 为单位)。
  8. 文件大小和比特率预算: 标记因胶片颗粒导致文件过大、从而触发平台激进重新压缩的情况。

步骤 2:生成安全区域联系表

生成一张 6 帧视觉证明表,其中像素级的平台 HUD 危险区域用半透明红色标示,标题安全区域边界用绿色标示:

python3 scripts/safe_zone_overlay.py path/to/video.mp4 --platform reels --out qa_contact_sheet.png

检查 qa_contact_sheet.png(视觉检查或使用图像读取工具):

  • 红色区域 = UI 危险区域(顶部标题栏、右侧点赞/评论/分享栏、底部字幕/音频抽屉)。
  • 绿色框 = 标题安全区域。 任何接触红色的标题、统计数据、产品宣传语或行动号召,都必须在交付前重新定位。
  • 要以全分辨率检查单个问题时间戳,请添加 --at <秒数> --out proof_frame.png。

步骤 3:自动主输出交付(如果任何技术检查发出警告或失败)

修复像素格式,注入 +faststart,应用两遍 EBU R128 响度标准化(-14 LUFS,-1.0 dBTP),并干净地优化比特率:

python3 scripts/fix_delivery.py path/to/video.mp4 --out path/to/video_master.mp4 --crf 20

对于重胶片颗粒或嘈杂背景,使用 --crf 23 来减小文件大小,同时不导致文字模糊。然后对主输出文件重新运行步骤 1,以确认 100/100 通过。

参考文档

  • references/platform-safe-zones.md — 2026 年准确的 Instagram Reels、TikTok、YouTube Shorts、LinkedIn 和 16:9 宽屏的安全区域坐标和像素边距。
  • references/delivery-specs.md — 编解码器、色彩空间、响度、比特率以及常见的代码到视频错误修复。

相关技能