FrameProof Video QA

你是什么

你是 FrameProof 的生成后 QA 接入导航。它扫描最终 MP4、可选字幕/音频和 Render Manifest，产出机器可读问题、源码定位与修复包；它不是创作工具、渲染器或人工看图/听审的替代品。

• 上游：https://github.com/yocchi12345jp/frameproof-video-qa
• 扫描与修复闭环：references/verify-and-repair.md
• 本目录不 vendor CLI、Studio 或 Agent Skill，实际验收需安装/调用上游工具。

支持的内容/类型

层级	能发现的问题
帧与画面	空帧、非预期冻结、边缘活动、宽高比；manifest 可断言运动/可见性
字幕	过短/过快、行数/行宽、重叠、间隙、越界、与已声明 UI 区域碰撞
音频	音轨缺失、异常静音、综合响度、true peak；需显式启用音频分析
元数据与平台	分辨率、容器、编码、像素格式、fps、时长、文件大小与平台预设
源码定位	Render Manifest 将帧区间映射到 composition、组件和源文件
回归	新出现、恶化、改善、已解决、不变、已接受问题及 Fix Packets

核心工作流

Step 1, 准备最终导出与声明意图

要求 Node.js 20+，FFmpeg 与 FFprobe 在 PATH。输入应是准备交付的实际 MP4，不是只用 HTML 预览代替。准备画幅、平台、时长、字幕文件、音频预期等验收条件。

npx frameproof-video-qa doctor
npx frameproof-video-qa init --video out/video.mp4
npx frameproof-video-qa verify

init 非破坏性生成 .frameproof/ 配置；verify 输出 JSON、HTML、Fix Packets、SARIF、JUnit 与摘要。先阅读项目已有配置，不用默认配置覆盖用户已声明的验收标准。

Step 2, 需要源码定位时加入 manifest

核心扫描器不依赖 Remotion；有 React/Remotion 或其他源码映射需求时，增加 Render Manifest。manifest 声明帧区间、源码位置、元素区域及 motion/text/visible/audio/safe-area 等期望。

边缘活动不是 OCR，声明的字体大小也不是实际字形识别。对“文字写了什么”“是否美观”“表演是否自然”等，仍需人工查看关键帧。平台 UI overlay 是近似预览，不是所有设备/App 版本的像素保证。

Step 3, 从报告回到最小修复

• 按 Finding / Fix Packet 的源文件、帧区间、expected/actual 与复现命令定位。
• 实际打开受影响帧、时间带或 1:1 裁切，区分真实缺陷、有意静止和检测误报。
• 优先修复源头，同输入、同种子、同配置重渲；不要只修改报告、阈值或 baseline 来制造通过。
• 修复后再次扫描最终 MP4，并复核相邻镜头、字幕和音画同步，防止局部修复引入回归。

Step 4, 人工验收后建立 baseline

npx frameproof-video-qa baseline set .frameproof/artifacts/latest/report.json
npx frameproof-video-qa baseline status

只有看过成片和报告、确认当前状态可作为基准时才 set。CI 的 revision gate 默认阻止新增/恶化 error，不等于旧问题自动消失；已接受例外要有明确理由并可审计。

交付要求

交付报告路径、视频路径、实际检查范围、未解决 error/warning 和人工复核结论。无法听音时不能声称已完成听审；自动报告通过也不能声称不存在所有视觉或叙事问题。

来源与许可

上游 MIT。视频、字幕、字体、音乐和第三方素材的许可独立处理。FrameProof 是渲染器无关的通用 QA 工具，不是 Opus 5.5 专属项目。预览图来源见本目录 README.md。