HyperFrames 入口点
HyperFrames 通过 HTML 渲染视频 —— 一个合成就是一个 HTML 文件,其 DOM 使用 data-* 属性声明时序,动画运行时是可搜索的,媒体播放由框架拥有。完整的创作约定位于 /hyperframes-core 中;在编写合成 HTML 之前请先阅读该文件。简报、故事板、审阅、生产、调度和帧工作器约定位于此技能的 references/ 中。
1. 从项目状态开始
应用第一个匹配的行;不要评估较低的状态行:
| 状态 | 操作 |
|---|---|
| 将现有 Remotion 源码显式移植到 HyperFrames | 读取 references/routes/remotion-to-hyperframes.md,然后直接路由到该工作流。跳过意图层。 |
| 对现有 HyperFrames 项目执行特定操作:检查、诊断、验证、预览、渲染、发布或批量渲染 | 仅执行该操作。跳过意图和工作流路由;加载 /hyperframes-cli 和任何必需的领域技能。 |
| 对现有项目进行特定编辑 | 执行编辑。不要运行意图层。要了解项目时间线(轨道、剪辑、开始、结束、播放的内容),请运行 npx hyperframes timeline [--json] 而不是读取 index.html 和每个子合成文件。 |
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@<版本> 以保持渲染可重现;固定版本不会自动更新,并且运行较旧 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 源码 | /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 | 从 URL 或特定站点简报营销或展示网站、产品站点、应用或公司 | /product-launch-video |
| 9 | 使用虚构视觉元素解释主题、文章或笔记,无需产品或站点捕获 | /faceless-explainer |
| 10 | 任何其他自定义视频或合成 | /general-video |
在最终确定路由之前,读取 references/routes/<workflow>.md —— 每个路由一个小文件:规范的输入/输出/触发器约定(在延迟安装工作流技能之前可用)加上该路由的面谈条目。如果候选路由不满足其约定,则继续路由而不是强制匹配。仅读取匹配路由的文件。
解决常见歧义
- 短的动画标题、标志片头、统计数据命中、图表命中、地图命中或独立的下三分之一是
/motion-graphics,如果它是无旁白的且动画是信息本身。静态标题卡、有旁白的序列、更长的蒙太奇或自定义循环是/general-video。 - 明确的短时动态图形可能使用 URL、推文、文章或屏幕截图作为源材料。通用的“从该网站制作视频”请求是
/product-launch-video。 - 带字幕的现有素材路由到
/embedded-captions;带设计信息卡的素材路由到/talking-head-recut。重新定时、重新排序、重新调色、重新构图或混音素材是自定义编辑,并回退到/general-video。 - 音乐文件仅当其节拍网格驱动作品时才选择
/music-to-video。用作背景音乐不会覆盖主题匹配的路由。 - “我想要一个故事板”会更改审阅过程,而不是工作流。如果没有其他路由信号,使用
/general-video。确认的草图storyboard.html本身可能是请求的交付物;审阅循环定义了该停止点。 - 专门的叙事工作流支持最多约 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 |
| 初始化、检查、快照、比较、批量渲染、Studio、渲染、发布或诊断 | /hyperframes-cli |
| 注册表块和组件 | /hyperframes-registry |
| 命名的外观、效果、处理或过渡 —— CRT 扫描线、故障、胶片颗粒、闪光扫过、五彩纸屑爆发 —— 在手动构建之前 | /hyperframes-registry |
| Figma 资产、令牌、组件或作为重构动画的故事板帧 | /figma |
创作者编辑短语是跨领域请求。加载匹配行中命名的所有技能:
| 创作者请求 | 必需领域 |
|---|---|
| “剪辑此素材”、硬切、修剪、拼接、重新排序或使用源范围 | /general-video + /hyperframes-core;核心拥有 data-start、data-duration、data-media-start 和轨道布局。 |
| 在此处放大、推近/拉远、平滑多状态缩放或重新构图、肯·伯恩斯或摄像机运动 | /general-video + /hyperframes-core + /hyperframes-keyframes;动画内部视觉/裁剪包装器,而不是定时剪辑。 |
| 匹配剪辑或甩镜头摄像机转场 | /general-video + /hyperframes-animation + /hyperframes-keyframes + /hyperframes-registry;在手动创作之前搜索/安装转场基元。 |
| 淡入、淡出、轨道增益/音量、自动化、闪避/雕刻、音频效果,或跨多个轨道的效果 | /general-video + /hyperframes-core + /hyperframes-audio;核心放置剪辑,音频混音放置轨道 —— 包括跨越一组轨道的子混音总线。 |
| 将画面和声音编辑与摄像机运动或混音相结合的编辑 |