用途：HyperFrames CLI 提供视频合成的完整开发循环，从脚手架、动效检索、编写、校验到预览与渲染。命令以 npx hyperframes ... 运行，除非项目提供了包装脚本，此时应遵循包装脚本。运行需 Node.js 22 或更高版本以及 FFmpeg。
主要能力：init 初始化项目或捕获站点（非 TTY 模式需 --non-interactive --example=<name>）；catalog --query 在本地检索已有动效原语，add <name> 安装；lint 在首次 HTML 编写后及结构变更后快速反馈；check 为最终门禁，会先跑 lint，再用一次浏览器会话审计运行时错误、失败请求、布局、*.motion.json 断言与 WCAG 对比度，持久性问题影响退出码，--strict 可让警告也门禁；snapshot 捕获中点快照检查子合成挂载；preview --background 打开最终 Studio 预览；render 支持 draft/high 质量、--docker、--batch、cloud、lambda、cloudrun 等路径。
使用方式：先 catalog 搜索，再 add 安装，之后用 hyperframes-core 编写合成；编辑中反复 lint，最终跑 check，通过后 preview 并等待用户批准再渲染；渲染后确认文件存在、非空且时长合理。涉及关键帧、剪辑、音频、媒体处理时需先阅读对应参考文档。
限制：catalog 搜索完全本地，无托管层、无账号，查询文本不外发；查询需用英文，否则无可检索词。离线语义检索需一次性约 33 MB 下载，须用户同意后加 --on-device。agent 与 CI 调用建议用 --json。doctor --json 始终退出 0，需检查其 .ok 字段。非 TTY 模式自动启用。检查通过不等于可渲染，必须等待最终批准。events 不应手动调用，validate、inspect、layout 为已弃用别名。