HyperFrames 入口
HyperFrames 从 HTML 渲染视频 — 一个组件就是一个 HTML 文件，其 DOM 通过 data-* 属性声明时序，动画运行时是可寻的，媒体播放由框架拥有。完整的创作合约在 /hyperframes-core 中；在编写组件 HTML 前请先阅读它。
1. 从项目状态开始
应用第一个匹配的行；不评估较低的状态行：
| 状态 | 操作 |
|---|---|
| 显式地将现有 Remotion 源移植到 HyperFrames | 读取 references/routes/remotion-to-hyperframes.md，然后直接路由到该工作流程。跳过意图层。 |
| 对现有 HyperFrames 项目执行特定操作：检查、诊断、验证、预览、渲染、发布或批渲染 | 仅执行该操作。跳过意图和工作流程路由；加载 /hyperframes-cli 和任何所需的领域技能。 |
| 对现有项目进行特定编辑 | 进行编辑。不要运行意图层。 |
BRIEF.md 存在 | 读取 workflow 和 flow。执行该工作流程；flow: companion 始终在 /general-video 中执行。不要询问任何简短问题。 |
无简短说明，但存在 hyperframes.json 或 STORYBOARD.md | 从项目文件和记录的首选项恢复。从现有构件推断所属工作流程。如果无法唯一确定，询问一个仅用于路由的问题；不要运行意图面试。 |
| 从头创建 | 运行意图层 — references/intent-interview.md — 然后使用第 2 节的表格路由一次。 |
如果新请求未标识主题或输入，请在路由前询问视频内容。在询问任何内容之前检查首选项和配方（references/intent-interview.md，步骤 1）。figma.com 输入或命名配方会改变接收方式，而不是路由 — 面试的“调整正交输入”部分处理两者。
保持项目的 CLI 最新
脚手架项目在其 package.json 脚本中固定 hyperframes@<version>，以确保渲染可重现；该固定永远不会自行前进，固定运行的旧版 CLI 不会打印任何警告。当恢复其脚本带有固定的项目时，在第一个影响渲染的命令之前探测一次：
npx hyperframes@latest upgrade --project . --check
该探测是只读的，并报告固定版本与最新版本；保留显式的 . — 在旧版 CLI 上，裸的 --project 后跟另一个标志会将那个标志消耗为其目录值。当它报告项目落后时 — 或任何 CLI 输出已经显示（stderr 通知 This project pins hyperframes@… (latest …)，或来自固定脚本的 --json 结果中的 _meta.updateAvailable: true）— 应用 npx hyperframes@latest upgrade --project .，然后使用 npx hyperframes check 验证。通过的检查确认项目的组件在新版本上仍然有效 — 而不是渲染输出与旧固定版本帧一致 — 因此成功的升级永远不会沉默：在运行的摘要中命名旧版本和新版本。尚未有组件图的项目无需验证。如果检查失败，撤消 package.json 中的更改，继续使用固定版本，并报告项目停留在哪个版本以及原因。对信号采取行动，而不是将其转达给用户；切勿让未经验证的固定版本处于未检查状态。
2. 路由从头创建
使用第一个匹配的行。匹配请求的交付物，而不是随口提到的单词或文件类型。
| 优先级 | 请求 | 工作流程 |
|---|---|---|
| 1 | 显式地将现有 Remotion 源移植到 HyperFrames | /remotion-to-hyperframes |
| 2 | 创建演示文稿、推销套牌或可导航的交互式套牌 | /slideshow |
| 3 | 向现有对谈镜头添加纯字幕或副标题，不更改镜头 | /embedded-captions |
| 4 | 向现有对谈、采访或播客镜头添加设计的图形叠加，不更改镜头 | /talking-head-recut |
| 5 | 从音乐轨道构建节拍同步视频，无旁白或网站捕获 | /music-to-video |
| 6 | 创建显式简短、无旁白、以动作为主的单元，通常低于 10 秒 | /motion-graphics |
| 7 | 从 PR 引用解释 GitHub 拉取请求或代码更改 | /pr-to-video |
| 8 | 从网址或站点特定简报营销或展示网站、产品站点、应用程序或公司 | /product-launch-video |
| 9 | 用虚构的视觉效果解释主题、文章或笔记，不捕获产品或站点 | /faceless-explainer |
| 10 | 任何其他自定义视频或组件 | /general-video |
在最终确定路由之前，读取 references/routes/<workflow>.md — 每个路由一个小的文件：规范输入/输出/触发合约（在延迟安装的工作流程技能可用之前可用）加上该路由的面试条目。如果候选者不满足其合约，则继续路由，而不是强制匹配。仅读取匹配的路由文件。
解决常见歧义
- 短动画标题、徽标 sting、统计命中、图表命中、地图命中或独立 lower-third 是
/motion-graphics，当它无旁白且动作为信息时。静态标题卡、有旁白序列、较长的蒙太奇或自定义循环是/general-video。 - 一个显式短的动态图形可能使用网址、推文、文章或截图作为源材料。一个通用的“从这个网站制作视频”请求是
/product-launch-video。 - 带有字幕的现有镜头路由到
/embedded-captions；带有设计的信息卡的镜头路由到/talking-head-recut。重新定速、重新排序、重新着色、重新构图或重新混合镜头是自定义编辑，会落入/general-video。 - 只有当其节拍驱动乐曲时，音乐文件才会选择
/music-to-video。用作背景的音乐不会覆盖主题匹配的路由。 - “我想要一个故事板”会更改审查过程，而不是工作流程。没有其他路由信号时，使用
/general-video。确认的草图板本身可能就是请求的交付物；审查循环定义了那个停止点。 - 专门的叙事工作流程支持最多约 3 分钟，并且在 30-90 秒左右最强。将明显更长的片段路由到
/general-video。长度永远不会覆盖显式移植、套牌、字幕、叠加或音乐驱动的交付物。
3. 路由一次，然后离开
对于从头创建，意图层（references/intent-interview.md）运行完整的对话 — 记忆、分诊、推介轮次、必须要素、运行形状、交接 — 并以写入 BRIEF.md 结束。该简要是工作流程读取的唯一路由构件；此后不会重新打开此技能或面试。从 BRIEF.md 回答每个后来的“路由要求什么？”。
4. 安装并进入工作流程
在读取选定的工作流程之前，安装或刷新它以及核心领域技能：
npx hyperframes skills update <workflow-name>
使用不带 / 的裸名称。如果命令失败，显示错误；不要从记忆中重建工作流程。关于安装的所有其他内容 — 核心与延迟的拆分、init 刷新什么、诊断、CI 退出以及无 CLI 后备 — 位于 references/skill-lifecycle.md 中。
5. 按需加载领域技能
| 需要 | 技能 |
|---|---|
| 组件结构、时序属性、轨道、变量、确定性 | /hyperframes-core |
| 运动规则、场景蓝图、过渡、运行时适配器 | /hyperframes-animation |
可寻的 GSAP、CSS、Anime.js、WAAPI、FLIP、路径、蒙版、SVG、3D 关键帧或 hyperframes keyframes 诊断 | /hyperframes-keyframes |
| 设计规格、概念、调色板、排印、旁白、节拍规划 | /hyperframes-creative |
| 图像、图标、徽标、音频、字幕、等级、LUT、可复用媒体 | /media-use |
| 画外音雕刻、音频效果链、自动化包络或跨多个轨道的一个链/推杆（子混音总线） | /hyperframes-audio |
| 初始化、lint、检查、快照、比较、批渲染、Studio、渲染、发布或诊断 | /hyperframes-cli |
| 注册表块和组件 | /hyperframes-registry |
| Figma 资源、令牌、组件或故事板帧作为重构的运动 | /figma |
创建者编辑短语是跨域请求。加载匹配行中命名的每个技能：
| 创建者请求 | 所需领域 |
|---|---|
| “剪切这段素材”、硬切、修剪、拼接、重新排序或使用源范围 | /general-video + /hyperframes-core；核心拥有 data-start、data-duration、data-media-start 和轨道布局。 |
| 在此处放大、推入/推出、平滑多状态缩放或重新构图、Ken Burns 或镜头移动 | /general-video + /hyperframes-core + /hyperframes-keyframes；对内部视觉/裁剪包装器进行动画，而不是定时剪辑。 |
| 匹配剪切或甩镜相机过渡 | /general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry；在手动编写之前搜索/安装过渡原语。 |
| 淡入、淡出、交叉淡入、轨道增益/音量、自动化、闪避/雕刻、音频效果或一个效果跨多个轨道 | /general-video + /hyperframes-core + /hyperframes-audio；核心放置剪辑，音频混合放置的轨道 — 包括覆盖一组轨道的子混音总线。 |
| 结合了剪辑与镜头运动或混音的图像和声音编辑 | 当有视觉运动时 /general-video + /hyperframes-core + /hyperframes-keyframes + 当声音被淡入、混合、闪避、自动化或处理时 /hyperframes-audio。 |
| 源或生成媒体，或预处理不支持的变速坡/中间源冻结 | /media-use；仅限源/生成/预处理，从不进行放置轨道的混音。 |
常量 data-playback-rate 对于图片和音高保留的声音是渲染安全的。它不会使源速度坡变为可关键帧；预处理坡。对于可复制的编辑合约，加载 /hyperframes-core → references/creator-editing-recipes.md。
关于摄影媒体如何…