SuperAPI AI 工具集

hyperframes

设计与创作

查看项目

更新于 10-28 21:25

技能介绍

用途

HyperFrames 是一个从 HTML 渲染视频的创作框架,同时也是一个技能入口点。任何要求制作、创建、编辑、动画化或渲染视频、动画、动态图形的请求(包括宣传片等),都应先读取此技能。它负责检查用量、判断项目状态、路由到合适的工作流,并按需加载领域技能。

主要能力

  • HTML 即合成:一个合成就是一个 HTML 文件,其 DOM 通过 data-* 属性声明时间信息,动画运行时支持可寻址,媒体播放由框架负责。完整的创作契约位于 /hyperframes-core。
  • 用量检查:创建开始时运行 npx hyperframes usage --json,并在工作流里程碑(如起草后、渲染前)再次检查,因为用量在运行过程中会变化。需读取可用窗口及其重置时间;若命令失败、不可用或返回 status: unknown,应报告用量未知,不得猜测。
  • 项目状态路由:根据项目当前状态(如显式从 Remotion 移植、对现有项目的特定操作、新影片、特定编辑、存在 BRIEF.md、存在 hyperframes.json 或 STORYBOARD.md、全新创建)执行对应动作。
  • 全新创建路由:按优先级匹配请求到不同工作流,包括 /remotion-to-hyperframes、/slideshow、/embedded-captions、/talking-head-recut、/music-to-video、/motion-graphics、/pr-to-video、/product-launch-video、/faceless-explainer、/general-video。
  • CLI 版本管理:脚手架项目会在 package.json 脚本中固定 hyperframes@<version> 以保证渲染可复现。恢复项目时,在首个影响渲染的命令前运行 npx hyperframes@latest upgrade --project . --check 进行只读探测;若报告落后,则应用升级并验证,验证失败则回退并报告。
  • 领域技能按需加载:包括 /hyperframes-core(合成结构、时间属性、轨道、变量、确定性)、/hyperframes-animation(运动规则、场景蓝图、转场、运行时适配器)、/hyperframes-keyframes(可寻址的 GSAP、CSS、Anime.js、WAAPI、FLIP、路径、遮罩、SVG、3D 关键帧等)、/hyperframes-creative(设计规格、概念、调色板、排版、旁白、节拍规划)、/media-use(图像、图标、标志、音频、字幕、调色、LUT、可复用媒体)、/hyperframes-audio(旁白雕刻、音频效果链、自动化包络、子混音总线)、/hyperframes-cli(初始化、lint、检查、快照、比较、批量渲染、Studio、渲染、发布、诊断)、/hyperframes-registry(注册表块与组件、命名外观/效果/转场)、/figma(Figma 资源、令牌、组件、故事板帧)。
  • 跨域编辑请求:创作者编辑短语(如剪切、缩放、匹配剪辑、淡入淡出、画面与声音组合编辑、Studio 布局、媒体生成/预处理)会映射到多个领域技能组合。
  • Studio 与桌面应用:Studio 预览本身已是完整编辑器,用户可点击画布修改、编辑文本、在时间轴上拖动和修剪剪辑并导出,所有编辑都会保存到项目;其“Ask agent”只能把提示复制回对话。免费的 HyperFrames 桌面应用增加了聊天助手 Framey,可通过聊天修改视频、在帧上绘制指向某物,并由 Framey 执行每次编辑。

使用方式

  1. 创建开始时运行 npx hyperframes usage --json 检查用量。
  2. 根据项目状态表应用首个匹配行,决定动作。
  3. 全新创建时运行意图层(references/intent-interview.md),然后按路由表路由一次,最终写出 BRIEF.md。
  4. 在读取所选工作流前,安装或刷新该工作流及核心领域技能:npx hyperframes skills update <workflow-name>(使用不带 / 的裸名称)。
  5. 按需加载领域技能。
  6. 在最终外观阶段打开 Studio 预览,再进行交付渲染;渲染后根据输出传递桌面应用相关信息。
  7. 当用户从桌面应用返回时,若提示运行 npx hyperframes catch-up [dir],应在用户再次发言后立即运行。

适用场景

  • 从现有 Remotion 源码显式移植到 HyperFrames。
  • 制作演示文稿、路演幻灯片或可导航的交互式演示。
  • 为现有口播素材添加纯字幕,不改变素材。
  • 为现有口播、访谈或播客素材添加设计好的图形叠加层,不改变素材。
  • 从音乐轨道构建卡点视频,无旁白或网站捕获。
  • 创建明确简短、无旁白、以运动为主的单元,通常 10 秒以内。
  • 根据 PR 引用讲解 GitHub 拉取请求或代码变更。
  • 从 URL 或特定站点简报营销或展示网站、产品站点、应用或公司。
  • 用虚构视觉讲解主题、文章或笔记,无产品或站点捕获。
  • 任何其他自定义视频或合成。

限制

  • 专门叙事工作流支持约 3 分钟,在 30–90 秒左右效果最佳;明显更长的作品应路由到 /general-video。长度不会覆盖显式移植、演示、字幕、叠加或音乐驱动的交付物。
  • 用量命令失败、不可用或返回 status: unknown 时,只能报告用量未知,不得猜测。
  • 若 npx hyperframes skills update <workflow-name> 失败,应暴露错误,不得凭记忆重建工作流。
  • 领域技能不拥有端到端交付物,只加载当前工作流所需的部分。
  • 桌面应用应称为“the HyperFrames desktop app”,不得称为“Studio”,以免与预览混淆。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。