插件安装: 在执行 setup 或 freshness 命令之前,当此技能位于 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/<工作流>.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 <工作流名称>
使用不带 / 的裸名称。如果命令失败,显示错误;不要从记忆中重建工作流。有关安装的其他所有信息——核心与惰性拆分的区别、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 |
创作者编辑短语是跨域请求。加载匹配行中命名的每个技能:
| 创作者请求 | 所需领域 |
|---|---|
| …(已截断以进行翻译) |