HyperFrames

HyperFrames 是什么

HyperFrames 是 HTML 视频制作体系的强制入口 Skill。它先识别当前项目状态与用户要交付的成品，再把任务路由到产品宣传、无脸解说、音乐视频、字幕、访谈包装、幻灯片、动效或通用视频流程。组合本质是带时间属性的 DOM，动画必须可定位，媒体播放由框架统一管理。

适用场景与选择边界

适合从网站、GitHub PR、Figma、文章、脚本、现有素材或音乐制作可复现视频，也能检查、预览、渲染、发布既有项目。若用户明确选择 Remotion 等其他框架，或只要录制浏览器操作，就不应强制使用 HyperFrames。已有 BRIEF、storyboard 或项目配置时优先恢复，不重复访谈。

核心能力与工作机制

它区分新建、编辑、诊断、渲染和移植；新任务通过意图访谈写出 BRIEF.md，再按优先级选择唯一工作流。核心能力按需加载：时间线与确定性、动画规则、关键帧、创意设计、媒体、音频混合、CLI、组件注册表和 Figma。镜头剪辑、缩放、转场、音频处理分别由明确领域负责。

实际工作流与交付结果

先检查项目文件和固定的 CLI 版本；新建任务完成意图访谈和路由，安装所选工作流及核心 Skill，然后按 BRIEF 执行。渲染前检查 CLI 更新，升级后必须运行 check；失败则回退 package.json 的版本并继续使用旧版本。成品需经过关键帧、媒体、音频和完整播放检查。

依赖、账号与权限

需要 Node.js、HyperFrames CLI、浏览器渲染环境及项目文件读写权限。某些工作流还需要网站、Figma、GitHub、媒体目录或外部生成服务。项目脚本固定 CLI 版本以保证可复现，升级属于会改项目的操作，必须验证并报告旧、新版本。

限制、成本与安全风险

路由错会导致交付形式与用户需求不符；没有可定位的动画或由页面自行播放媒体，会造成离线渲染不确定。CDN、远程素材和模型服务会引入网络与许可风险。check 通过只说明结构兼容，不证明新旧版本逐帧一致；重要升级仍需视觉比较。

上手与验收建议

先说明成品类型、时长、画幅、受众、输入素材和是否需要旁白。已有项目直接提供目录并说清要检查、编辑还是渲染。新项目先审阅 BRIEF，再让流程进入制作；最终至少核对起止帧、转场帧、音画同步和导出文件。

来源、版本与许可

依据 heygen-com/hyperframes 固定提交的完整入口 Skill 与 skills.sh 详情整理，仓库声明 Apache-2.0。

常见问题

1. 它是视频模型还是制作框架？

它是基于 HTML 的视频制作与路由框架，不是单一生成模型。素材可以来自模型或真实媒体，但时间线、动画、媒体播放、预览和渲染都由 HyperFrames 工程管理。

2. 已有项目还会重新问一遍需求吗？

不会。若存在 BRIEF.md、hyperframes.json 或 STORYBOARD.md，会优先恢复记录状态；只有无法唯一判断所属流程时才问一个路由问题。

3. 新建视频如何选择工作流？

按最终交付物而非关键词依次匹配：Remotion 移植、交互式演示、字幕、访谈包装、音乐视频、短动效、PR 解说、网站宣传、无脸解说，最后才是通用视频。

4. 为什么动画必须可定位？

离线渲染会直接跳到任意帧；依赖真实时间、不可重放状态或浏览器自动播放的动画会错帧。所有状态应能由帧号和项目输入确定。

5. 项目为什么固定 CLI 版本？

固定版本让同一项目在以后仍可复现。升级检查只读，真正升级后要运行结构验证；失败时回退版本，成功也要说明变化并做视觉复核。

6. 能直接处理剪辑和音频混合吗？

可以，但入口只负责装配领域能力。硬切与时间段由 core 管理，缩放与运镜加载 keyframes，淡入淡出、ducking 和效果链加载 audio，避免职责混杂。

7. 什么时候不使用 HyperFrames？

用户明确指定另一输出框架时应遵从；只需要录制浏览器会话也不必建立 HTML 组合。普通静态图片或单个音频处理则使用对应媒体工具更简单。

8. 最终应如何验收？

除 CLI check 外，要查看关键帧、完整播放、文字安全区、素材清晰度、音画同步和最终文件。升级或复杂转场应与基准输出做视觉对比。