hyperframe — HeyGen HyperFrames 路由器 是做什么的?
HyperFrames(Apache-2.0,github.com/heygen-com/hyperframes)将 HTML/CSS/JS 组合转换为确定性 MP4:渲染器在无头 Chrome 中逐帧捕获,并通过 FFmpeg 编码。此技能是一个精简路由器——所有真正的知识都位于上游克隆仓库及其 20 个 Agent 技能中;切勿在此处复制上游文档。
本地路径
解析顺序:HYPERFRAMES_HOME 环境变量 → ~/.jstack/config.env → 以下默认值。
| 内容 | 位置 |
|---|---|
| 克隆的仓库(规范本地副本) | ~/.jstack/vendor/hyperframes |
| 上游路由器技能(对于任何“制作视频”请求,请先阅读) | ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md |
其 20 个 Agent 技能(也由 hyperframes init 安装到 ~/.claude/skills/ + ~/.agents/skills/) | ~/.jstack/vendor/hyperframes/skills/ |
模块/组件注册表(70+ 个模块:下三分之一 lt-*、代码-*、徽标结尾、故障效果、数据图表…) | ~/.jstack/vendor/hyperframes/registry/{blocks,components} |
| 文档源(快速入门、概念、参考、目录) | ~/.jstack/vendor/hyperframes/docs/ |
| 在线:文档 + 模块目录 | hyperframes.heygen.com (快速入门/文档/目录),hyperframes.dev(游乐场 + 设计模板) |
安装 / 健康检查
要求:Node 22+ 和 FFmpeg 在 PATH 中(已验证在此机器上可用,CLI v0.7.48)。
npx --yes hyperframes doctor # 环境健康检查
npx --yes hyperframes init my-video # 脚手架项目(同时安装/刷新其 Agent 技能)
cd my-video && npm run render # → renders/*.mp4
init 会脚手架 index.html + hyperframes.json 并将 CLI 版本固定在 package.json 脚本中(dev/check/render/publish)。使用 git -C ~/.jstack/vendor/hyperframes pull 刷新克隆。
调度表
路由意图,然后打开/运行上游目标——不要自行设计工作流。
| 意图 | 前往 |
|---|---|
| 任何“为我制作视频/动画”的请求(入口点) | 阅读 /hyperframes 路由器技能:~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md——它会选择工作流 |
| 动画挂钩文本 / 动态标题 / 统计命中 / 徽标提示 / 结尾卡片 / 下三分之一(短小、无配音、设计导向) | /motion-graphics 工作流:克隆中的 skills/motion-graphics/;下三分之一模块 = 注册表 lt-*,结尾卡片 = logo-outro |
| 在现有说话人头部视频上的动态字幕 / 副标题 | /embedded-captions 工作流:skills/embedded-captions/(原素材不动,字幕覆盖渲染) |
创作或编辑 HTML→MP4 合成(data-* 时间控制、片段、轨道) | /hyperframes-core 然后 /hyperframes-animation:skills/hyperframes-core/,skills/hyperframes-animation/ |
| 浏览 / 安装模块和组件 | 注册表目录 registry/{blocks,components} 或 hyperframes.heygen.com/catalog;通过 /hyperframes-registry 和 npx hyperframes add [block] 安装并连接 |
| 渲染 / 预览 / 检查 / 验证合成 | /hyperframes-cli:npx hyperframes preview,npx hyperframes lint && npx hyperframes validate,npx hyperframes render,npx hyperframes doctor |
| 为合成添加背景音乐 / 音效 / 画外音 / 图标 / 背景去除 | /media-use:skills/media-use/ |
| 幻灯片 / 演示文稿、产品推广、PR 转视频、音乐同步、网站导览、Remotion 移植 | skills/ 中相应的工作流技能(参见 /hyperframes 路由器的速查表) |
何时不使用(StayFrame 红线)
StayFrame 的 feed 美学北极星(ADR 0002,编辑极简——“这会默默无闻地出现在 Aman/Soneva 网格中吗?”)使得强烈动态图形风格偏离品牌:Hormozi 式动态字幕、故障/VFX 模块、新闻滚动条、液晶玻璃小部件。对于 StayFrame 短片,仅将 HyperFrames 用于微妙的极简叠加,并且:
- 静态文本叠加保留在现有通道——通过
/jstack-sf-caption使用无头 Chrome + ffmpeg。不要将其迁移到 HyperFrames。 - 生成式视频 (i2v/t2v) 永远不是 HyperFrames——那是
/vidgen的职责。
注意事项
hyperframes init没有--yes标志(遇到未知标志会报错);它本身已是非交互式的。init副作用:将 HyperFrames 自身的核心技能安装/刷新到~/.claude/skills/和~/.agents/skills/——这是预期行为,保持上游路由器最新。- 单独安装技能:
npx skills add heygen-com/hyperframes --full-depth——务必使用--full-depth,否则会得到一个滞后的 skills.sh 注册表 blob,落后于main分支。 - 遥测默认开启;使用
hyperframes telemetry disable禁用。 - 渲染输出位于项目目录内的
renders/[project]_[timestamp].mp4。
下一技能
| 下一技能 | 何时使用 |
|---|---|
/vidgen | 合成需要生成式素材 (i2v/t2v 剪辑) 作为源媒体——视频生成始终路由到此,从不直接发往后端。 |
/jstack-sf-caption | StayFrame 短片需要纯静态文本叠加——该通道保留在无头 Chrome + ffmpeg,而非 HyperFrames。 |
/jstack-sf-trim-stitch | 渲染的 HyperFrames 叠加/结尾卡片需要组装到 StayFrame 短片中。 |