HyperFrames — 从这里开始
HyperFrames 通过 HTML 渲染视频 —— 一个合成结构就是一个 HTML 文件,其 DOM 使用 data-* 属性声明时间线,其动画运行时是可寻址的,并且其媒体播放由框架管理。完整的创作约定位于 /hyperframes-core 中;在编写合成 HTML 之前,请先阅读它。
下面提供的是:能力地图(按需加载的领域技能)和意图路由器(为任何“为我制作一个...”的请求选择工作流——通常是视频,但也可能是可导航的幻灯片或合成移植)。这种划分是基于所有权,而非输出类型:工作流拥有端到端的可交付成果(自己的项目目录、分步骤关卡、子代理、最终产物);而领域技能是一个能力层,工作流在运行过程中可以调用它,但永远不会拥有任务的拥有权。
能力地图 —— 领域技能
按需加载的原子能力 按需加载 —— 这不是完整的工作流;它们从不拥有端到端的任务。对于“为我制作一个...”的意图,请使用下面的意图路由器。
| 你想要…… | 技能 |
|---|---|
创作/编辑一个 HTML 合成结构 —— data-* 约定、剪辑片段、轨道、子合成结构、变量 | /hyperframes-core |
| 制作动画 —— 原子运动、场景蓝图、过渡效果、运行时适配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
创作可安全寻址的关键帧 —— GSAP 时间线、CSS 关键帧、Anime.js、WAAPI、FLIP、路径、遮罩、SVG 变形/绘制、3D 深度,以及 hyperframes keyframes 诊断工具 | /hyperframes-keyframes |
创意指导 —— frame.md / design.md、调色板、排版、旁白、节拍规划、音频响应 | /hyperframes-creative |
| 媒体 —— 解析/生成背景音乐、音效、图片、图标、品牌标志、语音、色彩分级、LUT;TTS 配音、转录、背景移除、字幕;跨项目复用 | /media-use |
| CLI 开发循环 —— 初始化、检查、验证、检查、预览、渲染、发布、诊断 | /hyperframes-cli |
安装注册表块/组件(hyperframes add) | /hyperframes-registry |
| 导入 Figma 内容 —— 资源、设计令牌、组件、故事板→重建的运动(REST/CLI);Motion(MCP),着色器(MCP 源 / 原生导出) | /figma |
意图路由 —— 选择工作流
此部分仅了解顶层工作流;它不会加载它们的内部引用或上述领域技能。
路由前 —— 确认输入,而非规格
路由需要知道视频的内容是什么 —— 即其输入和主题。如果输入未指定(“制作一个关于我们产品的视频”但没有提供 URL、产品、主题或资源),请在进入任何工作流之前提问 —— 承诺使用某个工作流本身就是路由决策。最多问两个问题:
- 输入 —— 一个产品(URL / 简介)、一个通用网站、一个 GitHub PR、一个待解释的主题,或者一个现有的讲解视频?
- Figma 源 —— 如果输入是 figma.com URL,无论下面为视频的形态选择了哪个工作流,
/figma都会首先提取资源/令牌/(组件/故事板);然后该工作流会基于/figma的输出进行构建 —— 绝不通过原始 MCP 工具直接驱动 Figma(这会绕过 SVG 净化、来源追踪和品牌令牌绑定)。
模式 —— 如果请求包含持续的自主信号(“给我个惊喜”、“你来决定”、“直接构建”),请记录下来并传递给工作流:整个运行过程将变为自主模式,后续步骤不再询问。如果没有信号,工作流会在其第一个简要问题中询问模式。默认为协作模式。(/motion-graphics 设计为自主模式。)语义说明:hyperframes-core → references/brief-contract.md。
规格默认值 —— 直接声明,无需询问(它们不会改变路由):画面比例 取决于目标平台 —— 社交媒体推送(X / LinkedIn / Instagram)→ 正方形 1:1,TikTok / Reels / Shorts → 9:16,YouTube / 嵌入式平台 / 未知 → 16:9;旁白/字幕的语言 = 用户的当前语言。所选的工作流会在其第一步重新确认自身的具体规格(字段语义说明:hyperframes-core → references/brief-contract.md)。
工作流速查表
| 工作流 | 用途 |
|---|---|
/product-launch-video | 销售产品(SaaS、应用、公司/产品网站)—— 从一个 URL、简介或脚本开始 → 一个宣传片。这是任何商业 URL 的默认选项,即使只提到了网站名称。 |
/website-to-video | 展示网站本身 —— 基于网站自身截图构建的导览/展示。适用于非商业网站(作品集、博客、文档、个人网站、活动),或者当用户想要的是导览而非宣传片时。 |
/faceless-explainer | 解释一个话题/概念 —— 基于文本,没有产品或 URL;所有的视觉元素都由 LLM 生成 |
/pr-to-video | 一个 GitHub PR / 代码变更 → 变更日志 / 功能展示 / 修复 / 重构说明视频 |
/embedded-captions | 为现有的讲解视频添加字幕(原始视频画面不变) |
/talking-head-recut | 为现有的讲解视频包装设计好的图形叠加层 —— 下三分之一标题、数据标注、动态标题、引用高亮 |
/motion-graphics | 一段短的(约10秒以内)、无旁白的片段,其中运动本身即为信息 —— 动态文字、数据/图表冲击效果、Logo 动画、动画地图、动画推文/标题、独立的下三分之一标题/叠加层(MP4 或透明通道 alpha) |
/music-to-video | 一首音乐曲目 → 一个与节拍同步的视频 —— 歌词视频、幻灯片或动态宣传片;音乐驱动节奏(可选用户提供的图片/视频按节拍网格剪辑) |
/slideshow | 一个演示文稿/投资宣传册/交互式幻灯片 —— 独立的幻灯片、片段、分支、热区;输出是一个可导航的幻灯片集合,而非渲染的视频 |
/general-video | 任何其他情况 —— 较长或多场景的片段、静态循环/海报、自定义合成结构 |
/remotion-to-hyperframes | 将现有的 Remotion(React)合成结构移植 到 HyperFrames(迁移,非新建) |
歧义消除(仅在可能混淆时):
- 运动优先且无旁白(约10秒以内,运动即是信息) →
/motion-graphics,无论输入是什么。 - 一个 URL 或脚本 —— 问一件事:该网站是否在销售产品? 是(SaaS / 应用 / 产品 / 公司网站) →
/product-launch-video—— 一个宣传片,并且这是任何商业 URL 的默认选项,即使只提到了网站名称。否,或者用户只想按原样展示网站(作品集 / 博客 / 文档 / 个人 / 活动) →/website-to-video—— 一个导览。一个 GitHub PR 链接 →/pr-to-video;一个没有产品或网站的概念 →/faceless-explainer。 - 现有素材 —— 纯口语化字幕 →
/embedded-captions;设计好的叠加卡片 →/talking-head-recut。两者都不会编辑素材本身(重新计时 / 重新着色 / 重新取景 / 重新排序 / 音频属于 NLE 编辑 —— 超出范围)。 - 一个音乐曲目是输入(一个音频文件,或一个需要从中提取音频的视频)并且没有旁白 →
/music-to-video—— 音乐的节拍/能量驱动节奏。(有旁白的片段则保留在上面根据输入匹配的工作流中;/motion-graphics适用于短的无旁白运动,且不是由音乐驱动的。) - 一个演示文稿/投资宣传册/交互式幻灯片(独立的幻灯片、导航、演示者模式) →
/slideshow—— 输出是一个可导航的幻灯片集合,而不是渲染的视频。明确的“幻灯片”请求会直接进入;相邻的触发词(“幻灯片 / 演示 / 展示 / 转换这个页面”)会让/slideshow在创作前确认这是一个幻灯片,如果不是,则切换到适当的非幻灯片工作流。 - 时长是指导,而非限制 —— 意图决定工作流;只有当片段明显超过约 3 分钟,或者是静态/循环/自定义格式时,才使用
/general-video。
选定后 —— 确保工作流已安装
一旦你选定了一个工作流,在阅读其技能文档之前先运行以下更新步骤 —— 工作流技能是按需安装的,因此你匹配的技能可能尚未安装在此机器上(其触发短语位于此路由器中,正是为了让你能够路由到尚未安装的技能):
npx hyperframes skills update <工作流名称>
使用裸名称,不要带前导的 / —— 例如 npx hyperframes skills update pr-to-video。指定一个技能名称可确保该技能以及每个工作流所依赖的核心领域技能都已安装且为最新状态:如果一切已安装,则快速无操作;如果存在缺失/过时的技能,则仅针对性地安装缺失/过时的技能 —— 绝不会安装全部技能。然后读取该工作流的技能文档并继续。相同的命令也适用于按需安装能力地图中的领域技能(例如 npx hyperframes skills update figma)。
如果命令失败,请向用户显示其错误信息,而不是凭记忆临时凑合工作流。手动回退(无 HyperFrames CLI 可用时):npx skills add heygen-com/hyperframes --skill <工作流名称>;一次性全部安装:npx skills add heygen-com/hyperframes --all。
保持技能为最新状态
HyperFrames 技能是版本化的,并且惰性安装:核心集是立即安装的,工作流则在首次使用时安装。
- 核心集 —— 本路由器、
hyperframes-*领域技能以及media-use。npx hyperframes init(每个创建型工作流在搭建项目结构时都会运行)会检查 GitHub 并刷新核心集以及任何其他已安装的技能。它绝不会扩大安装范围 —— 你未使用过的工作流技能不会被拉取。在已经是新状态的机器上重新运行 init 是无操作的;离线(或被限速)时,它会优雅降级,绝不会硬性失败。--skip-skills标志当前被禁用(这是一个临时措施,等候 skills.sh 注册表赶上进度);CI/测试通过HYPERFRAMES_SKIP_SKILLS=1环境变量选择退出。 - 工作流技能 —— 在触发时由上面的更新步骤(
skills update <工作流名称>)安装和刷新。
如果任务行为异常,或者在长时间构建之前,请确认已安装的技能是否为最新状态:
- 检查:
npx hyperframes skills check(添加--json以获取机器可读的结果;当任何已安装的技能过期或核心集不完整时,退出码为非零 —— 尚未安装的工作流技能会报告为_按需可用_,而非失败)。 - 更新:
npx hyperframes skills update—— 将核心集以及所有已安装的技能刷新到最新版本,并移除不再发布的技能。如果不指定名称,它绝不会安装你未使用过的工作流;指定技能名称(skills update <名称…>)则还会安装这些技能。 - 显式安装全部技能:
npx hyperframes skills(或npx skills add heygen-com/hyperframes --all)。
当 render / lint / validate 运行检测到过时的技能时,CLI 还会显示一行提示。
工作流详情
/product-launch-video
- 输入: 一个正在营销的产品 —— (a) 一个产品 URL(使用无头 Chrome 抓取资源和品牌令牌),(b) 一个即使没有链接也能命名产品网站的脚本/简介(PLV 会解析并抓取该网站,除非用户选择退出),或 (c) 一个无法推导出网站/“不要抓取”的脚本(无抓取模式 —— 选择一个提供调色板和设计系统的样式预设)。提供的脚本可以是逐字的配音稿,也可以是按场景重新组织的 —— PLV 会询问。
- 输出: 一个以 HyperFrames 合成结构形式呈现的产品发布 / SaaS 宣传片 → MP4(最佳时长 30–90 秒)—— 主题是产品的价值,而不是网站的导览。如果只是要网站的导览,请使用
/website-to-video。 - 触发词: “为 X 制作发布视频”、“我们网站的宣发片”、“用一分钟解释我的 SaaS”、“把我的脚本做成 60 秒宣传片”
...