Communitygithub.com

HyperFrames CLI 开发工具

HyperFrames CLI 开发循环 — 提供初始化、语法检查、预览、渲染和诊断命令,用于本地视频开发。

HyperFrames CLI 开发工具 是什么?

HyperFrames CLI 是一款面向本地视频开发的命令行工具,支持完整的开发循环:初始化项目、语法检查、实时预览、视频渲染及系统诊断。它适用于需要基于 HTML 构建动画或视频内容的开发者,支持多种模板(空白、产品介绍、解说、幻灯片),并可通过配置文件灵活控制画布尺寸、帧率、渲染质量和 TTS 语音。工具内置了 lint 检查(验证 data-hf-* 属性、时间格式、片段重叠、资源可达性等)、预览服务器(带场景选择器和热重载)以及渲染功能(导出为 MP4、WebM 或 GIF)。还提供了 doctor 命令用于诊断环境依赖(Node ≥ 18、API 密钥、网络连接等)。该工具可在任何支持 Node.js 的平台上使用,兼容 HyperFrames 框架的完整开发流程。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/christiansalazar-wk/ai-lore/tree/HEAD/skills/hyperframes-cli

在你喜欢的 AI 中提问

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

文档

HyperFrames CLI

npm install -g hyperframes   # 或使用 npx

命令

init

npx hyperframes init <名称> [--template blank|product|explainer|slideshow] [--fps 30] [--width 1920] [--height 1080]

lint

npx hyperframes lint [文件] [--fix] [--strict] [--json]

检查内容:有效的 data-hf-* 属性、时间格式、重叠片段、缺失时长、不可达资源、TTS 长度限制。

preview

npx hyperframes preview [文件] [--port 3000] [--open] [--scene <场景名>] [--time <时间>]

实时开发服务器,支持进度条拖拽、场景选择器和热重载。

render

export HEYGEN_API_KEY=您的密钥
npx hyperframes render [文件] [--out 输出.mp4] [--format mp4|webm|gif] [--quality 85] [--scene <场景名>]

doctor

npx hyperframes doctor

检查 Node ≥ 18、API 密钥、网络连接、资源路径、配置语法。

hyperframes.config.json

{
  "version": 1,
  "entry": "index.html",
  "output": "./output.mp4",
  "canvas": { "width": 1920, "height": 1080, "fps": 30 },
  "render": { "quality": 85, "format": "mp4" },
  "tts": { "defaultVoice": "en-US-neural-f1", "speed": 1.0 },
  "assets": { "baseUrl": "./assets" }
}

环境变量

变量描述
HEYGEN_API_KEY渲染必需
HEYGEN_REGIONus(默认)或 eu
HF_LOG_LEVELdebug、info、warn、error

开发循环

npx hyperframes init my-video --template product
cd my-video
# 编辑 index.html
npx hyperframes lint
npx hyperframes preview --open
npx hyperframes render --out output.mp4

Individual skills in this repo

This repo contains 6 individual skills — each has its own dedicated page.

相关技能