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 |
| 媒体 — 解析/生成 BGM、SFX、图像、图标、品牌标志、声音、调色、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— 输出是可导航的演示文稿，而非渲染的视频。明确的“幻灯片”请求直接执行；相邻触发词（“deck / slides / presentation / convert this page”）使/slideshow在创作前确认是否为幻灯片，如果不是则切换到合适的非幻灯片工作流。 - 时长是指引而非限制 — 意图选取工作流；只有当片段明显长于约 3 分钟，或是静态 / 循环 / 自定义格式时，才使用
/general-video。
选定后 — 确保工作流已安装
选定工作流后，在 阅读其技能之前 运行更新步骤 — 工作流技能按需安装，因此您匹配的那个可能还不在本机上（其触发词存在于本路由器中，正是为了让您能路由到尚未安装的技能）：
npx hyperframes skills update <workflow-name>
使用纯名称，不带前导 / — 例如 npx hyperframes skills update pr-to-video。命名一个技能保证它 以及每个工作流依赖的核心领域技能 都已安装且是最新的：如果一切就绪，这是一个快速的空操作；如果不是，则只针对缺失/过时的技能进行定向安装 — 从不安装全套。然后阅读工作流的技能并继续。同样的命令也可用于能力地图中的按需领域技能（例如 npx hyperframes skills update figma）。
如果命令失败，向用户显示错误，而不是凭记忆即兴创建工作流。手动回退（没有 HyperFrames CLI 可用）：npx skills add heygen-com/hyperframes --skill <workflow-name>；一次性安装所有：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 <workflow-name>）安装和刷新。
如果任务行为异常，或在长时间构建之前，确认已安装的技能是最新的：
- 检查：
npx hyperframes skills check（添加--json获得机器可读的输出；如果任何已安装内容过时或核心技能集不完整，则返回非零退出码 — 尚未安装的工作流技能报告为 可按需获取，而非失败）。 - 更新：
npx hyperframes skills update— 将核心技能集以及所有已安装内容刷新到最新版本，并移除不再发布的技能。没有名称时，它从不安装您未使用过的工作流技能；命名技能（skills update <name…>）会额外安装这些技能。 - 显式安装全套：
npx hyperframes skills（或npx skills add heygen-com/hyperframes --all）。
当 render / lint / validate 运行检测到过时技能时，CLI 也会显示一行提醒。
工作流详情
/product-launch-video
- 输入： 正在营销的产品 — (a) 产品 URL（使用 headless Chrome 抓取资源 + 品牌令牌），(b) 一个命名产品网站（即使没有链接）的脚本/简报（除非用户选择退出，否则 PLV 会解析并抓取该网站），或 (c) 一个没有可推导网站 /“不要抓取”的脚本（无捕获模式 — 选取一个提供调色板 + 设计系统的样式预设）。提供的脚本可以是 逐字 旁白或 按场景重构 — PLV 会询问。
- 输出： 一个产品发布 / SaaS 推广片，作为 HyperFrames 合成内容 → MP4（最佳长度 30–90 秒）— 主题是产品的价值，而非网站的导览。对于简单的网站导览，请使用
/website-to-video。 - 触发词： “为 X 做发布视频”、“为我们的网站做推广”、“在一分钟内解释我的 SaaS”、“把我的脚本变成 60 秒的推广片”、“文本
…
[为翻译而截断]