SuperAPI AI 工具集

remotion-to-hyperframes

设计与创作

查看项目

更新于 10-19 17:58

技能介绍

该技能用于将已有 Remotion(基于 React)视频合成源码迁移为 HyperFrames(HTML + GSAP)合成。仅在用户明确要求迁移、转换或翻译 Remotion 源码时使用;不用于新建 HyperFrames 合成、顺带提及 Remotion、把 Remotion 代码当参考,或要求“做出同样的视频”但未请求迁移源码的情况。

主要能力包括:通过 lint 脚本检测无法干净翻译的模式,如 useState、useReducer、带非空依赖的 useEffect/useLayoutEffect、异步 calculateMetadata、第三方 React UI 库等 blocker;对 @remotion/lambda 配置、delayRender、useCallback、useMemo、自定义 hook 等给出警告并丢弃后翻译;对 staticFile、interpolateColors 等标记为信息级提示。技能附带 API 映射参考(参数、序列、时间、媒体、转场、Lottie、字体等),可针对源码用到的模块按需加载。对于无直接对应 API 的视觉效果,可搜索 HyperFrames 目录(约 400 个块和组件)寻找现成组件,或手写 GSAP 并在笔记中记录替代方案。

使用方式:先运行 lint 脚本检查源码,然后按 API 映射规划翻译;生成根 index.html 与每个场景的 compositions/<scene>.html,包含 data-* 属性、暂停的 GSAP 时间轴和 window.__timelines 注册。随后运行 eval 对比 Remotion 基线与 HF 翻译的 SSIM,阈值约为源复杂度层级 p05 以下 0.02;渲染时需使用匹配的像素格式(如 PNG、bt709)以避免编码差异影响。最后在输出旁写 TRANSLATION_NOTES.md 记录未干净翻译的部分。技能还提供分层测试语料(T1–T4)及通过阈值:T1 0.974/0.95、T2 0.985/0.95、T3 0.953/0.90、T4 8/8 通过。

适用场景:显式请求将 Remotion 项目迁移到 HyperFrames,或翻译具体 Remotion 合成源码。限制:不支持反向导出、非 Remotion 来源(如 After Effects、Framer Motion、纯 React/CSS)的重建;不翻译 React 状态机驱动的动画,建议改用运行时互操作模式;不并行运行 Remotion 渲染管道。