hyperframes-cli

HyperFrames CLI 是一个命令行工具，所有操作均通过 npx hyperframes 执行，需要 Node.js >= 22 和 FFmpeg。它围绕“脚手架 → 编写 HTML 组合 → 检查 → 预览 → 渲染”的工作流组织，用于以代码方式制作视频。

主要能力：

1. 项目脚手架：npx hyperframes init 可创建项目结构、复制媒体文件、使用 Whisper 转写音频并安装 AI 编码技能。支持交互式向导、选择示例模板（blank、warm-grain、play-mode、swiss-grid、vignelli、decision-tree、kinetic-type、product-promo、nyt-graph）、附带视频或音频文件，以及非交互模式（适用于 CI/智能体）。

2. 代码检查：npx hyperframes lint 检查 index.html 和 compositions/ 下的所有文件，报告错误（必须修复）、警告（建议修复）和信息（需 --verbose），可输出 JSON 供机器读取。建议在预览前运行 lint，以发现缺失的 data-composition-id、重叠轨道、未注册时间线等问题。

3. 预览：npx hyperframes preview 在浏览器中启动工作室，支持热重载，默认端口 3002，可自定义端口。

4. 渲染：npx hyperframes render 输出 MP4（默认）或 WebM（支持透明度），可设置输出路径、帧率（24/30/60）、质量（draft/standard/high）、工人数、Docker 可复现模式、GPU 加速、严格模式（lint 错误或警告时失败）。官方建议迭代时用 draft、审核用 standard、最终交付用 high；60fps 会使渲染时间翻倍。

5. 转写：npx hyperframes transcribe 支持音频/视频文件（可指定模型和语言），也能导入已有 SRT、VTT 或 OpenAI 响应 JSON 字幕。

6. 文本转语音：npx hyperframes tts 可将文本或脚本文件合成为 WAV 音频，可指定语音（如 af_nova、bf_emma），使用 --list 查看所有语音。

7. 诊断与辅助：npx hyperframes doctor 检查 Chrome、FFmpeg、Node 和内存；browser 管理内置 Chrome；info 显示版本和环境；upgrade 检查更新；compositions 列出项目中的组合；docs 打开文档；benchmark 测试渲染性能。渲染失败时建议先运行 doctor，常见问题包括缺少 FFmpeg、缺少 Chrome 或内存不足。

适用场景：希望通过 HTML 组合和命令行流程制作视频的开发者，尤其适合需要自动化、CI/智能体环境、可复现渲染或批量视频生成的场景。

限制：依赖 Node.js >= 22 和 FFmpeg；渲染依赖 Chrome；部分功能（如 Docker、GPU）需相应环境支持；具体性能表现暂未提供。