SuperAPI AI 工具集

rn-replica-qc

测试与质量

查看项目

更新于 10-15 21:40

技能介绍

用途:把参考视频复刻变成红/绿证据闭环,并在合适时将已对齐的运动捕获为可复用的 HyperFrames 或 Remotion 组件。命名或承诺保真度前须读 replica-levels.md,区分源流复制、无损渲染帧、编码帧对齐 MP4、视觉重建与风格参考等不同声明。

运行模式:仅分析(检查报告,不改实现代码)、复刻循环(修复候选直至通过声明的证据门)、组件捕获(注册已验证的运动模式及其输入与限制)。

工作流:1)声明合约,记录参考、精确片段、渲染器、保真度标签、交付物、组件库去向与批准所需证据;2)锁定时间基,探测 FPS、时长、起始时间、像素格式、帧数与音频,精确工作需把时间戳映射到源帧号并按帧索引提取,包含式片段帧数为 (end_frame - start_frame) + 1,拼接相邻包含式片段时保留较早的边界帧并跳过下一片段首帧;3)选择架构,精确回放、参数化运动或混合;4)分析并修复,从 0.5s 缩略图开始,在快速运动处加 0.1s 窗口,一次修复一个可见原因;5)通过三项证据门:资产门(提取计数精确、无损中间产物零误差往返)、运行时门(真实注册时间线逐帧推进,检查任意跳转与动态资产边界)、交付门(渲染、解码 MP4、逐帧对比、检查时间候选与最差/边界帧、探测媒体元数据、用 SHA-256 校验存档副本);6)扩展与拼接,重跑上一片段、独立渲染新片段、跳过重复边界帧、检查每个连接处前后帧;7)捕获组件,分别为精确回放和参数化运动登记类型、来源与时间范围、内容模式、输入与时间契约、实现栈与资产、证据文件与验收级别、已知限制;8)决定,只批准当前证据证明的保真度标签,门为红则说明未对齐并指出首个失败帧或时间戳。

常用命令:python3 scripts/extract_halfsec_frames.py reference.mp4 --out analysis/sample --contact;python3 scripts/extract_frame_range.py reference.mp4 --start-frame 720 --end-frame 1020 --out analysis/reference-fullfps;python3 scripts/build_frame_sprite_rows.py analysis/reference-fullfps assets/textures --prefix replica-row --frames-per-row 7;python3 scripts/verify_frame_sprite_rows.py analysis/reference-fullfps assets/textures --prefix replica-row --frames-per-row 7;node scripts/verify_timeline_playback.cjs --html ./index.html --timeline-id composition_id --start 24 --frames 301 --fps 30 --out analysis/runtime;python3 scripts/verify_frame_sequence.py analysis/reference-fullfps analysis/runtime --output analysis/runtime-metrics.json --boundary-every 7;python3 scripts/compare_videos.py reference.mp4 candidate.mp4 --out analysis/delivery --reference-start-frame 720 --candidate-start-frame 0 --frame-count 301 --boundary-every 7。

依赖与限制:帧与精灵验证需带 Pillow 的 Python 运行时;时间线捕获需 Node 运行时中的 Playwright。HyperFrames 需在渲染前通过 npx hyperframes check .,渲染日志成功不等于交付证据;Remotion 用项目等效的运行时与解码帧检查。采样只能定位问题,不能批准像素或帧对齐交付;不得把精确回放纹理层当作参数化 AI 组件。官方未提供收费与价格信息。