插件安装: 在运行设置或刷新命令之前,如果此技能位于 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@<版本>,以保证渲染的可复现性;固定版本永远不会自行更新,较旧 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 —— 每个路由一个小文件:包含规范的输入/输出/触发契约(在惰性安装工作流技能之前可用)以及该路由的访谈条目。如果候选路由不满足其契约,则继续路由而不是强行匹配。只读取匹配路由的文件。
解决常见歧义
- 一个短的动画标题、Logo 开场、统计命中、图表命中、地图命中或独立的下三分之一属于
/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 |
| 图片、图标、Logo、音频、字幕、调色、LUT、可复用媒体 | /media-use |
| 旁白剪辑、音频效果链、自动化包络或跨多个轨道的单链/推子(子混音总线) | /hyperframes-audio |
| 初始化、lint、检查、快照、比较、批量渲染、Studio、渲染、发布或诊断 | /hyperframes-cli |
| 注册表块和组件 | /hyperframes-registry |
| 一个命名的外观、效果、处理或过渡——CRT 扫描线、毛刺、胶片颗粒、闪光扫描、五彩纸屑爆发——在手动手动构建之前 | /hyperframes-registry |
| Figma 资产、令牌、组件或故事板帧,作为重构的运动 | /figma |
创作者编辑短语是跨领域的请求。加载匹配行中命名的每个技能:
| 创作者请求 | 所需领域 |
…
[为翻译而截断]