SuperAPI AI 工具集

hyperframes

设计与创作

查看项目

更新于 10-14 22:38

技能介绍

HyperFrames 是一套围绕「用 HTML 渲染视频」构建的技能体系与工作流集合,来源为 calesthio/openmontage。它的基本模型是:一个合成(composition)就是一个 HTML 文件,文件 DOM 通过 data-* 属性声明时间信息,其动画运行时可以被逐帧定位(seekable),媒体播放由框架统一管理。完整的创作契约收录在 /hyperframes-core 中,编写合成 HTML 之前应当先阅读它。

【能力地图:领域技能】 这些是按需加载的原子能力,而不是完整的视频工作流。若要做「给我做一个视频」这类任务,应使用下方的意图路由。可用技能包括:

  • /hyperframes-core:编写/编辑 HTML 合成,涉及 data-* 契约、clips、tracks、子合成、变量。
  • /hyperframes-animation:动画相关,涵盖原子运动、场景蓝图、转场、运行时适配器(GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)。
  • /hyperframes-creative:创意方向,包括 frame.md / design.md、配色、排版、旁白、节拍规划、音频响应。
  • /hyperframes-media:媒体处理,涵盖 TTS 配音、背景音乐、转写、去背景、字幕。
  • /media-use:媒体解析,从 HeyGen 目录查找并固化 BGM、音效、图片、图标到 .media/,并做清单追踪。
  • /hyperframes-cli:CLI 开发循环,包括 init、lint、validate、inspect、preview、render、publish、doctor。
  • /hyperframes-registry:安装注册表区块/组件(hyperframes add)。

【意图路由:选择工作流】 路由只识别顶层工作流。进入任何工作流之前,先确认输入而非规格:需要知道视频是关于什么的。如果未指定(如「做一个关于我们产品的视频」但没有 URL、产品或主题),应先提问。最多问两个问题:输入是产品(URL/简报)、普通网站、GitHub PR、待讲解主题,还是已有的口播视频。规格默认值应直接声明而不询问,且不会改变路由:宽高比 16:9(仅当有明确的竖屏目的地如 TikTok / Reels / Shorts 时才用 9:16);旁白/字幕语言与用户语言一致。

工作流速查:

  • /product-launch-video:营销/发布/推广产品,可来自 URL、简报或脚本。输出为产品发布/SaaS 宣传片(最佳约 30–90 秒)。
  • /website-to-video:把普通网站转成视频,如站点导览、作品集/落地页展示、社交媒体短片。
  • /faceless-explainer:从文本讲解主题/概念,无产品、无 URL,所有视觉由 LLM 生成,自带 pin-and-paper 预设(最佳约 30–90 秒)。
  • /pr-to-video:GitHub PR / 代码变更转成更新日志/功能揭示/修复/重构讲解,通过 gh CLI 读取。
  • /embedded-captions:为已有口播视频添加字幕/说明文字,画面本身不改;转写用本地 Whisper(无需 API key),并用 RVM 抠像以便人物遮挡字幕。
  • /talking-head-recut:为已有口播视频包装设计好的图文叠加,如下三分之一、数据标注、动态标题、引用块等,与转写同步,画面完整播放且不被修改。
  • /motion-graphics:简短、无旁白、以设计驱动的动态图形,通常 10 秒以内,运动本身就是信息;输出 MP4 或透明叠加层(alpha WebM / MOV)。
  • /music-to-video:音乐轨转成节拍同步视频,音乐驱动节奏;可选用户提供的图片/视频按节拍网格剪辑。
  • /slideshow:制作演示/路演/交互式幻灯片,输出是可导航的 deck(含分片揭示、分支、热点导航、演示者模式、讲者备注),而非渲染好的 MP4。
  • /general-video:其他情况,如更长或多场景作品、静态循环/海报、自定义合成。
  • /remotion-to-hyperframes:把已有 Remotion(React)合成单向迁移到 HyperFrames,并用 Remotion 渲染做对比评分(SSIM 评估框架 + 分层测试语料)。

消歧规则:以运动为先且无旁白(约 10 秒以内)一律走 /motion-graphics;URL 或脚本且营销特定产品走 /product-launch-video,普通非产品网站走 /website-to-video,GitHub PR 链接走 /pr-to-video,无产品/网站的概念讲解走 /faceless-explainer;已有素材加普通口语字幕走 /embedded-captions,加设计过叠加卡走 /talking-head-recut。音乐作为输入且无旁白走 /music-to-video。演示/路演/交互式 deck 走 /slideshow。长度只是参考而非门槛,仅当明显超过约 3 分钟或为静态/循环/自定义格式时才走 /general-video。

【工作流未安装时】 选定工作流后应确认其是否可用。若未安装,不要猜测,而应提示用户先安装:安装单个工作流可运行 npx skills add heygen-com/hyperframes --skill <workflow-name>(例如 --skill pr-to-video,名称不带前导斜杠);一次安装全部工作流运行 npx skills add heygen-com/hyperframes --all(核心加全部工作流,跳过选择器)。用户运行后再重新阅读该工作流技能并继续。

【保持技能为最新】 HyperFrames 技能带版本。npx hyperframes init 会把已安装技能与 GitHub 上的最新版本比对,若有过期或缺失就安装/刷新整套。检查命令:npx hyperframes skills check(可加 --json 输出机器可读结果,过期或缺失时以非零码退出);更新命令:npx hyperframes skills update。当 render / lint / validate 检测到技能过期时,CLI 也会给出单行提醒。

【适用场景与限制】 适用于从产品、网站、PR、文本、已有口播视频、音乐或演示文稿等不同输入生成视频、动态图形或幻灯片,也适用于 Remotion 到 HyperFrames 的迁移。限制方面:已有口播视频的字幕与图文包装工作流不编辑素材本身,重新定时、调色、重构画面、重排、音频处理属于 NLE 剪辑,不在范围内;/slideshow 输出不是渲染视频;/remotion-to-hyperframes 是单向迁移而非从输入创作,仅在用户明确要求迁移时触发。关于收费、价格、平台支持范围、具体效果等信息,资料中暂未提供。