HyperFrames 是 HeyGen 开源的 HTML 转视频工具:一段 HTML、CSS 与媒体,加上可寻址的动画,渲染成确定性的 MP4——同一个输入永远出同一帧。Apache 2.0 许可证,GitHub 实时 86,546 星(本站核对:2026-11-19),本周 GitHub Trending 在列,最新版 v0.9.69(2026-11-18 发布)。本文安装与渲染步骤以官方 README 与文档为准;本站验证:npm 包 hyperframes 0.9.69 已核对(注册表版本与 GitHub Release 一致),npx hyperframes@0.9.69 --help 已实跑、命令表完整;完整渲染未实机跑通(需要 Node 22+ 与 FFmpeg),渲染步骤以官方文档为准,下文如实标注。

能干什么

  • 写 HTML 就能出视频:一个 index.html 就是一条视频——用 data-start、data-duration 定时间与轨道,GSAP、CSS 动画、Lottie、Three.js、Anime.js 都能接进来做可寻址动画;没有构建步骤,文件在浏览器里直接能预览。
  • 让编程智能体替你做视频:9 个 agent 技能(核心 6 个:总控、CLI、组件库、媒体、反推任意视频、风格采样;按需 3 个:Figma、幻灯片、Remotion 迁移),一句话就能让 Claude Code、Codex、Cursor 按“计划→写 HTML→接动画→加媒体→检查→预览→渲染”的生产循环出片。
  • 约 450 个现成组件直接拿:转场、叠加层、标题、动效字幕、图表、地图、3D、运镜,npx hyperframes add data-chart 一条命令装进项目,用之前先查组件库、别手写。
  • 确定性渲染,适合批量与回归:渲染器用无头 Chrome 逐帧抓取、FFmpeg 编码,同一份输入出同一份视频;改一处文案重渲染,结果可预期、可进 CI、可做回归对比。
  • 品牌设计能直接转视频规范:frame.md 把品牌的设计规范“翻转”为镜头语言——同样的 token 与规则,改写成智能体能直接拿来组片的版本,存在 DESIGN.md 里全工具链共用。
  • 桌面应用与云端渲染都在:HyperFrames Studio 桌面应用(macOS / Windows / Linux)免费可用;AWS Lambda 分布式渲染路径已备好,批量出片可以上云跑。

优缺点

优点:HTML 人与智能体都能写,交接成本低;没有构建步骤,index.html 直接预览;确定性输出让批量生产与回归测试成为可能;Apache 2.0 许可证,没有按次渲染费、没有商用门槛;官方给了与 Remotion 的对照表,选型不用猜。

缺点与边界:要 Node 22+ 与 FFmpeg 两个前置,缺一个都渲染不了;reverse-any-video(把任意视频反推成可编辑工程)与 style-sampling(五种验证过的成片风格)是 Pro 功能,开源版没有;渲染靠无头 Chrome,复杂动画吃机器;分享与发布要登录(npx hyperframes auth login),免费工作区 5 个项目;头像、配音、生成视频这类能力走 HeyGen 模型,完整能力在 Pro 计划里。

下载与安装(官方文档口径)

  1. 先对前置:Node.js 22+(本站实测环境为 v24.22.1),另需 FFmpeg——macOS 用 brew install ffmpeg,Ubuntu / Debian 用 sudo apt install ffmpeg,Windows 用 winget install ffmpeg。先 node -v 与 ffmpeg -version 各跑一次再往下走。
  2. 只用 CLI,不接智能体:npx hyperframes init my-video 脚手架建项目,cd my-video 后 npx hyperframes preview 浏览器实时预览、npx hyperframes render 出 MP4。
  3. Claude Code 插件方式:claude plugin marketplace add heygen-com/hyperframes,再 claude plugin install hyperframes@hyperframes;要自动更新在 Claude Code 里进 /plugin → Marketplaces → hyperframes → 开启自动更新,之后用 /hyperframes:hyperframes 调用。
  4. 独立技能方式(OpenCode 等):npx skills add heygen-com/hyperframes 会打开交互选择器——默认什么都没选,先选 Core Skills 一组;不交互的脚本或 CI 环境用 npx hyperframes skills update,它只装核心集;要 9 个全装用 npx skills add heygen-com/hyperframes --all。
  5. 桌面应用:去官网下载页按系统拿安装包(macOS / Windows / Linux .deb),免费使用;与 CLI 共用同一套分享系统。
  6. 国内网络:npx 下载慢可换 npm 国内镜像(npm config set registry https://registry.npmmirror.com);FFmpeg 走系统包管理器装,不走 npm;本地渲染不依赖海外服务,装好就能离线跑。

调用与使用

  1. 先跑最小闭环:npx hyperframes init my-video → cd my-video → npx hyperframes preview 看一眼 → npx hyperframes render 出第一条 MP4。先把这条路跑通,再谈花活。
  2. 让智能体做视频:装好技能后直接说一句话,例如“用 /hyperframes 做一条 10 秒产品介绍,标题淡入、背景视频、轻微背景音乐”——技能会按生产循环走:先计划、再写 HTML、接动画、加媒体、检查、预览、渲染。
  3. 渲染前先过闸:npx hyperframes lint 查常见错误,npx hyperframes check 把检查、运行时验证与版式检查一次跑完,npx hyperframes snapshot 抓关键帧当 PNG 先看一眼——别直接全量渲染再返工。
  4. 要组件先查库:npx hyperframes add flash-through-white(转场)、npx hyperframes add data-chart(动态图表)、npx hyperframes add instagram-follow(社交叠加层)——约 450 个现成块,先查再手写。
  5. 要给人审片:npx hyperframes auth login 登录后 npx hyperframes share 生成审阅链接,改完用 share --update 出新版。

调教成自己的

  • 先立 frame.md:把品牌的设计规范(颜色、字体、间距、语气)写成 frame.md,智能体按它组片——颜色与字号不再每次现猜,成片风格先统一再谈创意。
  • 把常用片头做成模板:片头、字幕条、结尾卡各存一个 composition,以后新视频只换文案与素材,结构不动;模板攒得越多,出片越快。
  • 组件库当素材库用:做片之前先翻 catalog,看到现成的转场、图表、地图直接 hyperframes add,只在没有现成块时才手写。
  • 关键帧先验再渲染:snapshot 与 keyframes 看洋葱图与布局,确认版式没跑偏再全量渲染;compare 可以把几个配色或版式变体拼在一张对照图里一次定稿。

玩法:电商卖家批量出产品短视频

模拟一位卖家居小电器的电商卖家:10 个 SKU 都要一条 10 秒上架短视频,手工剪一周都剪不完。他的打法:

  1. 先做一个 HTML 模板:标题位、产品图位、卖点三行、价格位、结尾卡全部留空槽,动画与转场一次调好。
  2. 把 10 个 SKU 的图、价、卖点写成一张表,循环填进模板——改的是数据,不是视频工程。
  3. 逐个 render,确定性输出保证 10 条风格一致;有问题的先 snapshot 看关键帧,改完重渲。
  4. 出片后按平台裁尺寸:竖屏版改宽高重渲一份,横竖两版同一套模板出。
  5. 模板留下来:下次上新只换表里的数据,半天出齐一波新品视频。

玩法:自媒体科普视频流水线

再模拟一位做财经科普的自媒体创作者:每周一条数据解读视频,图表与字幕最花时间。他的打法:稿子写好后,让智能体按稿子生成带 data-chart 的动态图表与动效字幕 HTML,旁白音轨按时间轴对齐,check 过闸后渲染;固定栏目用同一套 frame.md 与片头模板,观众一眼认出是你的栏目;数据每周更新只换图表数据,结构与风格不动。

避坑指南

  • Node 版本先对上:要求 22+,版本不够先升级 Node,不要反复重装包;本站实测 v24.22.1 可用。
  • FFmpeg 必须装:渲染最后靠它编码,缺了它 init 与 preview 都能走、render 会失败;先 ffmpeg -version 确认。
  • 技能选择器默认全空:npx skills add heygen-com/hyperframes 的交互选择器打开时什么都没预选,先勾 Core Skills 一组;脚本或 CI 里不用它,用 npx hyperframes skills update 直接装核心集。
  • 要最新版别走 skills.sh 注册表:注册表缓存可能比 main 慢几小时;要与当前 CLI 版本一致的技能,用 npx hyperframes skills update。
  • 反推视频与风格采样是 Pro 功能:reverse-any-video 与 style-sampling 在开源版里没有,照着文档找这两个技能之前先确认自己的计划;开源版的核心渲染与组件库不受影响。
  • 只开发才需要 Git LFS:全仓克隆做开发要先装 Git LFS(回归测试基线约 240 MB 的 mp4);只装来用,跳过这一步。
  • 别把“模板化”等同于“生成式”:HyperFrames 是模板化、可逐帧编辑的视频工程,画面内容来自你给的 HTML 与素材;想要“给一段参考视频、换个人换个产品”的生成式复刻,那是另一条线——本站的AI 带货视频复刻技能,两条线不打架。

档案

  • 仓库:github.com/heygen-com/hyperframes;许可证 Apache 2.0(干净可商用,可二开、可改、可分发,无按次渲染费、无商用门槛);Node.js 22+、FFmpeg;npm 包 hyperframes。
  • 星数 86,546(2026-11-19 实时核对);本周 GitHub Trending 在列;最新版 v0.9.69(2026-11-18 发布)。
  • 本站验证:npm 包 hyperframes 0.9.69 已核对(注册表版本与 GitHub Release 一致);npx hyperframes@0.9.69 --help 已实跑,init / add / preview / render / lint / check / snapshot 等命令表完整;init 脚手架、preview 预览与 render 全量渲染未在本机跑通,步骤以官方 README 与文档为准。

常见问题

它和 Remotion 有什么区别?两者都用无头 Chrome 加 FFmpeg 渲染视频;区别在创作模型——Remotion 下注 React 组件,HyperFrames 下注人人能写的纯 HTML;HyperFrames 没有构建步骤,index.html 直接能预览;许可证是 Apache 2.0,Remotion 是源码可见的 Remotion License。官方文档有完整对照表。

和剪映、必剪比呢?那是手工精剪工具;HyperFrames 是代码化模板渲染,强在批量、自动化与确定性——10 条同结构视频一次出,不适合逐帧手工抠细节。

不会写 HTML 能用吗?能。装好技能让编程智能体写,你只管说需求、审成片;Studio 桌面应用也可以可视化预览与编辑。

渲染收费吗?开源本地渲染免费,没有按次费用;Pro 计划加的是 HeyGen 的顶级视频、图像、语音与音乐模型,以及反推视频与风格采样两个高级技能。

国内能用吗?本地渲染不依赖海外服务;npx 下载慢换 npm 国内镜像,FFmpeg 走系统包管理器。分享与发布功能要登录 HeyGen 账号。

搞不定配置怎么办?先跑 npx hyperframes check 看它报什么——检查、运行时验证与版式检查一次给全;实在跑不通,可以看本站的部署与配置跑通服务,把跑通这一步交出去。

站内往下读:AI视频栏目、ffmpeg-skill:给编程智能体装一个本地剪辑师、AI带货视频复刻怎么做:备素材、装技能、开单、出成片。