用途
HyperFrames CLI 是 HyperFrames 视频项目的开发命令行工具，围绕“搭建—编写—校验—预览—渲染”的循环工作，面向用代码（HTML 合成）制作动效视频的场景。它既可作为插件内技能使用，也支持独立安装。
环境与安装
CLI 需要 Node.js 22 或更高版本以及 FFmpeg。命令一般以 npx hyperframes ... 形式运行；若项目说明提供了包装脚本，则以包装脚本为准。插件安装时需先遵循插件执行规则；独立安装沿用更新说明（资料未展开具体更新步骤）。
主要能力
- 脚手架：
npx hyperframes init <project>创建居中空白项目；--example=<name>可指定从示例开始。 - 组件检索与安装：
npx hyperframes catalog --query "..."在本地目录中搜索现成动效原语，npx hyperframes add <name>安装。搜索完全本地，无托管层、无账号，查询文本不会发送到任何地方；默认按词面匹配，加--on-device可按语义排序（需一次性约 33 MB 下载，需用户同意）。 - 时间线查看：
npx hyperframes timeline --json输出轨道、剪辑、起止时间及子合成的绝对时间信息，适合以较少 token 获取项目结构。 - 反馈与校验：编辑过程中用
npx hyperframes lint；最终门禁用npx hyperframes check（会先跑 lint），检查运行时错误、失败请求、布局、*.motion.json断言与 WCAG 对比度，持久性问题会影响退出码，--strict可让警告也参与门禁。 - 快照与对比：
npx hyperframes snapshot支持按时间点、区间或帧数取样，用于检查子合成挂载是否正常；另有 compare、grade-compare 等命令用于对比评估。 - 预览：
npx hyperframes preview --background打开 Studio 预览并取得项目 URL；preview --context --json可查询当前选中元素信息。 - 渲染：质量分档包括
--quality draft（迭代）、--quality looks（首次真实编码，默认）、--quality delivery（最终交付）；另支持--docker可复现容器渲染、--batch变量驱动批量渲染，以及cloud render、lambda render、cloudrun render等云端方式。 - 项目历史：
history begin/history --since mine/history undo/history end用于按“轮次”记录与撤销写入，避免覆盖他人编辑。 - 诊断：
doctor --json输出环境状态，其退出码恒为零，需检查.ok字段。 - 清理：
npx hyperframes clean（--dry-run先列出）清理失效渲染与空闲缓存，不删输出、源文件或正在使用的资源。
使用方式要点
推荐在代理与 CI 场景使用 --json 输出。同一验证循环内使用统一的 HYPERFRAMES_RUN_ID。长时间渲染可用 HYPERFRAMES_RENDER_DETACHED=1 以独立进程组启动，避免终端关闭导致渲染中断。涉及关键帧、剪辑、音频等编辑时，资料要求先阅读对应的 keyframes/core/audio 参考文档。
适用场景与限制
适用于以代码制作动效视频、需要快速迭代与可复现渲染的团队，以及需要本地组件检索、批量或云端渲染的流程。限制包括：依赖 Node.js 22+ 与 FFmpeg；云渲染需相应账号或基础设施；语义搜索需用户同意下载模型；渲染必须在检查通过并完成最终预览审批后进行，不能仅因检查通过就直接渲染。资料未提供收费、价格与具体平台支持范围的更多信息。