Communitygithub.com

hyperframe — HeyGen HyperFrames 路由器

用于 HeyGen HyperFrames 的精简路由器——基于 HTML 的动态图形引擎(编写 HTML,通过无头 Chrome + FFmpeg 在本地渲染确定性 MP4)。当用户提到“hyperframe”、“hyperframes”、“animated overlay”、“motion graphics”、“html to video”、“animated caption”、“animated hook text”、“kinetic captions”、“kinetic titles”、“end card”、“lower third”,或希望创作/渲染 HTML 合成到 MP4 或浏览 HyperFrames 模块目录时使用。不用于生成式视频(由 /vidgen 处理),也不用于 StayFrame 静态文本叠加(由 /jstack-sf-caption 处理)。

hyperframe — HeyGen HyperFrames 路由器 是什么?

此技能是 HeyGen HyperFrames 的精简路由器,将 HTML/CSS/JS 组合确定性渲染为 MP4 视频。渲染器在无头 Chrome 中逐帧捕获,并通过 FFmpeg 编码。它不会重复上游文档,而是将请求路由到克隆仓库中的相应工作流技能(如 `/motion-graphics`、`/embedded-captions`、`/hyperframes-core`、`/hyperframes-cli`、`/media-use` 等),这些技能包含 70 多个预设模块(下三分之一、徽标结尾、数据图表等)。支持的平台包括 Claude Code、Cursor、Codex 以及任何支持 SKILL.md 的 Agent。通过 `npx hyperframes doctor` 检查环境健康,通过 `npx hyperframes init my-video` 脚手架项目,还可以通过 `npx hyperframes preview`、`npx hyperframes lint`、`npx hyperframes validate`、`npx hyperframes render` 等命令进行预览、校验、渲染。注意:不适用于生成式视频 (i2v/t2v) 或 StayFrame 的静态文本叠加,这些应分别路由到 `/vidgen` 和 `/jstack-sf-caption`。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jonosin/jstack/tree/HEAD/skills/hyperframe

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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-captionStayFrame 短片需要纯静态文本叠加——该通道保留在无头 Chrome + ffmpeg,而非 HyperFrames。
/jstack-sf-trim-stitch渲染的 HyperFrames 叠加/结尾卡片需要组装到 StayFrame 短片中。

相关技能