mcpField
H
hyperframes

hyperframes

github.com/podo创意与媒体29164 次安装3 天前更新
代码仓库

关于 hyperframes

hyperframes 是面向 AI 编码 Agent 的技能套件,用于从 HTML 组合内容创建并渲染视频。它涵盖动画、音频、字幕、创意指导和命令行流程,专门的视频制作工作流可按需加载。

主要功能

  1. 01编写带时间信息的 HTML 组合
  2. 02使用多种运行时制作动画
  3. 03制作音频和字幕
  4. 04通过命令行初始化、检查、渲染和发布
  5. 05按需加载视频工作流
  6. 06使用可复用的媒体注册库

适用场景

  1. 01从 HTML 组合内容渲染视频
  2. 02制作动态图形和动画
  3. 03为视频项目添加音频和字幕
  4. 04执行项目初始化、检查和渲染

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/podo/design-agent-skills --skill hyperframes

安装后在 Claude Code 中输入/hyperframes确认已加载。

附带文件stub.yaml

详细介绍

hyperframes

目录条目 — 完整软件包:heygen-com/hyperframes

决策树

  1. 是否已安装完整技能? 此软件包会安装 4 个技能(hyperframes、hyperframes-cli、hyperframes-registry、media-use);此处检查第一个。

    • 全局:f=~/.agents/skills/hyperframes/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
    • 项目:f=.agents/skills/hyperframes/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"
    • installed → 技能已作为 hyperframes 安装,调用该技能并继续
    • pointer → 转到步骤 2
  2. 安装(skills CLI 无法安装此技能):

    此仓库约有 500 MB(包含展示媒体和测试基准),因此 skills CLI 完整克隆可能会超过 300 s 的限制。仅稀疏克隆技能文件夹,然后从本地克隆安装入口技能和核心技能集;入口技能会按需安装其他工作流技能。

    如果之前的尝试留下了 /tmp/hyperframes-skills,请先删除它(rm -rf /tmp/hyperframes-skills):git clone 不会覆盖非空目录。

    [ -e ~/.agents/skills/hyperframes ] && echo "global" || echo "project"
    

    全局:

    git clone --depth=1 --filter=blob:none --sparse https://github.com/heygen-com/hyperframes.git /tmp/hyperframes-skills
    git -C /tmp/hyperframes-skills sparse-checkout set skills
    npx skills add /tmp/hyperframes-skills --skill hyperframes hyperframes-cli hyperframes-registry media-use -g -y
    rm -rf /tmp/hyperframes-skills
    

    项目:

    git clone --depth=1 --filter=blob:none --sparse https://github.com/heygen-com/hyperframes.git /tmp/hyperframes-skills
    git -C /tmp/hyperframes-skills sparse-checkout set skills
    npx skills add /tmp/hyperframes-skills --skill hyperframes hyperframes-cli hyperframes-registry media-use -y
    rm -rf /tmp/hyperframes-skills
    

Claude Code 插件方式:

claude plugin marketplace add heygen-com/hyperframes
claude plugin install hyperframes@hyperframes

注意事项

  • 要求: Node.js 22+ 和 FFmpeg(上游要求);使用时需要网络访问。入口技能会通过 npx hyperframes skills update <workflow> 按需安装它所路由到的工作流技能(幻灯片、通用视频、产品发布视频等);只有背景音乐、TTS 配音和虚拟形象视频需要 HeyGen CLI 登录(免费 OAuth 额度)。音效和动画制作无需账户
  • 许可证: Apache-2.0

安装后调用

  • 技能名称:hyperframes — 入口;任何制作、编辑、动画制作或渲染视频或动态图形的请求,都应先阅读此技能。它会恢复项目状态、路由到合适的工作流,并按需安装该工作流。
  • 按需加载的领域技能:hyperframes-core(合成结构和时间安排)、hyperframes-animation、hyperframes-keyframes、hyperframes-creative、hyperframes-audio、hyperframes-cli(初始化、检查、渲染、发布)、hyperframes-studio、hyperframes-registry、media-use(图像、图标、音频、字幕、调色)
  • 触发短语:“hyperframes”、“HTML to video”、“render video from HTML”、“Anime.js”

功能

“编写 HTML,渲染视频。”——这是一套面向需要从 HTML 合成内容制作视频的 AI 编码 Agent 的技能。合成内容是一个 HTML 文件,其 DOM 使用 data-* 属性声明时间安排,动画运行时支持定位,因此框架可以逐帧渲染。核心技能集涵盖合成内容制作、运动规则和运行时适配器(GSAP、Anime.js、CSS、Lottie、Three.js、WAAPI)、创意指导、音频和字幕、由 CLI 驱动的初始化/检查/渲染工作流,以及可复用的媒体注册表。

此指针会安装核心技能集,也就是上游会立即安装的内容。制作工作流(幻灯片或演示文稿、产品发布视频、PR 转视频、对话人物叠加、音乐转视频、动态图形、无真人出镜的解说视频、通用视频、Remotion 移植)由 hyperframes 技能按需获取,因此不会在此处安装。如需一次性获取全部内容,请使用上面的 Claude Code 插件方式。

不适用场景

  • 不输出视频的静态动画 → 使用 gsap-skills、framer-motion-skills 或 animate-css-skill
  • 以编程方式制作 React 视频 → 使用 remotion
  • 未登录 HeyGen CLI 时,背景音乐、TTS 或虚拟形象功能无法使用;动画制作和音效无需账户

评论

支持 Markdown