SuperAPI AI 工具集

hyperframes-cli

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

HyperFrames CLI 通过 npx hyperframes 运行,需 Node.js >= 22 与 FFmpeg;若项目指定本地 wrapper 则需严格遵循。

主要用途是支撑 HTML 视频合成的开发循环:初始化 npx hyperframes init my-video(也可从 URL capture);编写 HTML 合成;用 npx hyperframes lint、validate、inspect 做检查;用 preview 打开 Studio 时间线编辑器;最后 render 渲染,可选择 draft 迭代质量、high 交付质量、--docker --strict 用于 CI 复现,或用 lambda render 做云端大规模渲染。

lint 检查缺失的 data-composition-id、轨道重叠、未注册时间线;validate 在无头 Chrome 中加载合成,报告运行时报错与 WCAG 对比度问题;inspect 沿时间线定位,报告文本溢出容器或在画布外,若有 *.motion.json 还会验证运动意图。

约定方面,除 render、preview、play 外所有命令支持 --json;doctor --json 始终退出 0,需以 ok 字段判断;非 TTY 自动切换非交互模式,此时 init 需要 --example;CI 可用 --strict、--strict-all、--strict-variables 做门禁;--json 中路径会被脱敏。渲染需用户确认,检查通过后不可自动渲染。渲染后应确认输出文件存在且大小合理。

包含子合成时还需做可视化冒烟测试,用 npx hyperframes snapshot --at <t1>,<t2>,... 或 --frames 9,输出到 snapshots/frame-NN-at-Xs.png。Lambda 端到端为 lambda deploy、lambda render、lambda destroy 三条命令。其他细节如升级、基准、遥测、素材预处理等详见对应参考文档,本文未全部列出。