HyperFrames CLI 是一个围绕 npx hyperframes 的 HTML 视频合成开发循环工具，所有操作均通过该命令执行。使用前需安装 Node.js 22 或更高版本以及 FFmpeg。
主要用途与能力：初始化（init）生成项目脚手架，支持交互式向导或指定示例模板，如 blank、warm-grain、play-mode、swiss-grid、vignelli、decision-tree、kinetic-type、product-promo、nyt-graph；可附带视频或音频文件，自动复制媒体、用 Whisper 转写音频并安装 AI 编码技能。校验（lint）检查 index.html 及 compositions/ 目录，报告缺少 data-composition-id、轨道重叠、未注册时间轴等问题。视觉检查（inspect）在无头 Chrome 中渲染并沿时间轴扫描，报告文本溢出气泡或容器、超出画布、被裁剪等问题，可用 --json、--samples、--at 控制输出。
使用方式：建议遵循 lint → inspect → preview → render 的顺序。预览用 npx hyperframes preview（默认端口 3002）支持热重载，交付项目时应提供 Studio URL 形式 http://localhost:<port>/#project/<project-name>。渲染用 npx hyperframes render，可指定 --output、--fps（24/30/60）、--quality（draft/standard/high）、--format（mp4/webm）、--docker、--gpu、--strict 等参数，质量建议迭代用 draft、评审用 standard、交付用 high。参数化渲染通过 data-composition-variables 声明变量，并在 CLI 用 --variables 传入 JSON 覆盖。
适用场景：HTML 转视频的合成开发、参数化批量渲染、需要透明 WebM 或可复现 Docker 输出的交付。
限制：需要 Chrome 与 FFmpeg；渲染失败可先运行 npx hyperframes doctor 排查环境。资料中未提供收费、价格或平台支持细节。