插件安装: 在运行设置或更新命令之前,当此技能位于 HyperFrames 插件内部时,请遵循插件执行规则。独立安装则保留下面的更新说明。
HyperFrames 入口点
检查剩余用量
在创建开始时,运行 npx hyperframes usage --json。在工作流的关键节点(如起草后和渲染前)再次检查,因为用量会在运行过程中变化。阅读可用的窗口及其重置时间;先前的读取不会预留配额。如果命令失败、不可用或返回 status: unknown,则报告用量未知,不要猜测。与用户一起确定范围和工作流选择。
HyperFrames 从 HTML 渲染视频 — 一个合成是一个 HTML 文件,其 DOM 通过 data-* 属性声明时间,其动画运行时是可寻址的,其媒体播放由框架管理。完整的创作合约位于 /hyperframes-core 中;在编写合成 HTML 之前请阅读它。简报、故事板、审查、制作、调度和帧工作者合约位于此技能的 references/ 目录中。
1. 从项目状态开始
应用第一个匹配的行;不要评估较低的状态行:
| 状态 | 操作 |
|---|---|
| 将现有 Remotion 源码明确移植到 HyperFrames | 阅读 references/routes/remotion-to-hyperframes.md,然后直接路由到该工作流。跳过意图层。 |
| 对现有 HyperFrames 项目执行特定操作:检查、诊断、验证、预览、渲染、发布或批量渲染 | 仅执行该操作。跳过意图层和工作流路由;加载 /hyperframes-cli 和任何必需的领域技能。 |
| 在现有项目中提出一个问题、一个暂停、一个没有具体更改的想法,或一个对已制作影片的感性笔记 | 遵循 /hyperframes-studio § 0。 |
| 在现有项目内部请求一部新影片 | 遵循 /hyperframes-studio § 5。 |
| 对现有项目进行特定编辑 | 进行编辑。不要运行意图层。要了解项目时间线上有什么(轨道、片段、开始时间、结束时间、播放内容),请运行 npx hyperframes timeline [--json],而不是读取 index.html 和每个子合成文件。 |
BRIEF.md 存在 | 读取 workflow 和 flow。执行该工作流;flow: companion 始终在 /general-video 中执行。不询问任何简报问题。 |
没有简报,但存在 hyperframes.json 或 STORYBOARD.md | 从项目文件和记录的偏好中恢复。从现有的工件推断所属工作流。如果无法唯一确定,则只问一个路由问题;不要运行意图面谈。 |
| 全新创建 | 运行意图层 — references/intent-interview.md — 然后使用第 2 节的表格路由一次。 |
当你编辑现有项目时,请用项目历史(/hyperframes-cli,项目历史在你的回合中)包围你的编辑。
如果新请求未指明主题或输入,请在路由前询问视频内容。在询问任何问题之前检查偏好和配方(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 源码 | /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 |
| 初始化、lint、检查、快照、比较、批量渲染、Studio、渲染、发布或诊断 | /hyperframes-cli |
| 注册表块和组件 | /hyperframes-registry |
| 命名的外观、效果、处理或转场 — CRT 扫描线、故障、胶片颗粒、闪光扫描、五彩纸屑爆发 — 在手动构建之前 | /hyperframes-registry |
| Figma 资源、令牌、组件或故事板帧作为重构的运动 | /figma |
创建者的编辑短语是跨域请求。加载匹配行中命名的每个技能:
| 创作者请求 | 所需领域 |
|---|
…
[truncated for translation]