项目简介
编写 HTML,渲染视频。为智能体而生。
Hyperframes 是一个开源视频渲染框架,让你能够创建、预览和渲染基于 HTML 的视频合成内容 —— 对 AI 智能体提供一流支持。
快速开始
选项 1:使用 AI 编码智能体(推荐)
安装 Hyperframes 技能,然后描述你想要的视频:
npx skills add heygen-com/hyperframes这会教你的智能体(Claude Code、Cursor、Gemini CLI、Codex 等)如何正确编写合成内容和 GSAP 动画。在 Claude Code 中,技能会注册为斜杠命令 —— 使用 /hyperframes 来创作合成内容,/hyperframes-cli 执行 CLI 命令,/gsap 获取动画帮助。
试试这些示例提示
复制以下任意一条给你的智能体即可开始。使用 /hyperframes 前缀可以显式加载技能上下文,确保第一次就能得到正确输出。
冷启动 —— 直接描述需求:
Using
/hyperframes,创建一个 10 秒的产品介绍视频,包含淡入标题、背景视频和背景音乐。
热启动 —— 将现有内容转为视频:
查看这个 GitHub 仓库 https://github.com/heygen-com/hyperframes,并使用
/hyperframes向我解释它的用途和架构。
使用
/hyperframes将附加的 PDF 总结成一个 45 秒的推介视频。
使用
/hyperframes将这个 CSV 转为动画柱状图竞速视频。
特定格式:
使用
/hyperframes制作一个 9:16 的 TikTok 风格钩子视频,主题是 [topic],带弹跳字幕并与 TTS 旁白同步。
迭代修改(像和视频剪辑师对话一样):
把标题放大 2 倍,切换到深色模式,并在结尾添加淡出效果。
在 0:03 秒处添加一个下三分之一栏,显示我的姓名和职位。
智能体会负责脚手架搭建、动画制作和渲染。更多提示模式请参考提示词指南。
选项 2:手动创建项目
npx hyperframes init my-videocd my-videonpx hyperframes preview # 在浏览器中实时预览(热重载)npx hyperframes render # 渲染为 MP4hyperframes init 会自动安装技能,你随时可以交给 AI 智能体继续开发。
环境要求: Node.js >= 22,FFmpeg
为什么选择 Hyperframes?
HTML 原生 —— 合成内容就是带 data-属性的普通 HTML 文件,无需 React,也无需专有 DSL。AI 优先 —— 智能体本来就懂 HTML。CLI 默认非交互式,专为智能体驱动的工作流设计。 确定性渲染 —— 输入相同,输出完全一致。适合自动化流水线。 Frame Adapter 模式 —— 可以自由选择动画运行时(GSAP、Lottie、CSS、Three.js 等)。
工作原理
用带 data- 属性的 HTML 定义你的视频:
<divid="stage"data-composition-id="my-video"data-start="0"data-width="1920"data-height="1080"><videoid="clip-1"data-start="0"data-duration="5"data-track-index="0"src="intro.mp4"mutedplaysinline ></video><imgid="overlay"class="clip"data-start="2"data-duration="3"data-track-index="1"src="logo.png" /><audioid="bg-music"data-start="0"data-duration="9"data-track-index="2"data-volume="0.5"src="music.wav" ></audio></div>在浏览器中即时预览,支持本地或 Docker 中渲染为 MP4。
组件目录
提供 50+ 现成可用的区块和组件 —— 社交覆盖层、着色器转场、数据可视化、电影级特效等:
npx hyperframes add flash-through-white # 着色器转场npx hyperframes add instagram-follow # 社交覆盖层npx hyperframes add data-chart # 动画图表完整目录请访问:hyperframes.heygen.com/catalog
文档
完整文档地址:hyperframes.heygen.com/introduction(包含快速开始、指南、API 参考、组件目录)
主要包(Packages)
<hyperframes-player> Web Component | |
技能(Skills)
Hyperframes 内置了专门教 AI 智能体的技能(通用文档覆盖不到的框架特定模式):
npx skills add heygen-com/hyperframeshyperframes add 安装区块和组件 | |
项目地址
https://github.com/heygen-com/hyperframes
扫码加入技术交流群,备注「开发语言-城市-昵称」
合作请注明

如果你觉得这篇文章不错,别忘了点赞、在看、转发给更多需要的小伙伴哦!我们下期再见!
夜雨聆风