视频引擎 (Hyperframes v0.8.77 & Brag)
HyperFrames 从 HTML 渲染视频 —— 一个合成就是一个 HTML 文档,其 DOM 通过 data-* 属性(data-start, data-duration)声明时间线,动画运行时是可搜索的,媒体播放由框架管理。
1. 项目状态检测
在采取行动之前,按顺序评估项目状态:
| 状态 | 操作 |
|---|---|
| 将 Remotion 移植到 HyperFrames | 读取 workflows/remotion-to-hyperframes/SKILL.md 并直接执行。跳过意图层。 |
| 检查、诊断、预览或渲染 | 运行相应的 CLI 命令(npx hyperframes check、preview、render)。不要重新运行吸收。 |
| 编辑现有项目 | 运行 npx hyperframes timeline [--json] 检查轨道、片段和时间线;执行针对性编辑。 |
BRIEF.md 存在 | 从 brief 中读取 workflow 和 flow;立即执行该工作流。 |
hyperframes.json 或 STORYBOARD.md 存在 | 从现有项目文件和记录的首选项恢复。 |
| 新的创建请求 | 运行意图吸收并使用下面的路由矩阵进行路由。 |
CLI 版本管理
当恢复一个在 package.json 中固定了依赖的现有项目时:
npx hyperframes@latest upgrade --project . --check
如果有可用的更新且已验证,则使用 npx hyperframes@latest upgrade --project . 应用,并运行 npx hyperframes check。
2. 意图路由矩阵
将新的创建请求路由到第一个匹配的工作流:
| 优先级 | 请求类型 | 目标工作流 |
|---|---|---|
| 1 | 显式移植 Remotion 代码 | workflows/remotion-to-hyperframes |
| 2 | 演示、提案或交互式幻灯片 | workflows/slideshow |
| 3 | 简单的文字时间字幕或视频字幕 | workflows/embedded-captions |
| 4 | 在人物访谈或播客上叠加图形 | workflows/talking-head-recut |
| 5 | 由音乐轨道驱动的节拍同步动画(无语音) | workflows/music-to-video |
| 6 | 短的、运动优先的动态视觉效果(<10秒) | workflows/motion-graphics |
| 7 | GitHub Pull Request 或代码变更解说 | workflows/pr-to-video |
| 8 | 产品发布、网站展示、SaaS 推广、/brag | workflows/product-launch-video(或模式 1) |
| 9 | 概念主题或文档解说 | workflows/faceless-explainer |
| 10 | 任何其他自定义视频或多轨道合成 | workflows/general-video |
3. 操作模式
模式 1:产品发布与展示(/brag 和 product-launch-video)
用于网站发布、产品展示、SaaS 推广和 /brag。
- 吸收与检查:
- 解析选项:
--tone(默认、精致、yc-恶搞、混乱、电影感、面无表情、应用商店,见references/brag/tones.md)、--format(16:9、9:16、1:1)、--duration(15–25秒)。 - 若提供 URL,则捕获实时网站资源:
npx hyperframes capture "<URL>" -o ./capture --json
- 解析选项:
- 设计系统与预设:
- 从
references/creative/frame-presets/中选择设计预设(胶囊、钴网格、雏菊等),并重新混合品牌令牌:node workflows/product-launch-video/scripts/build-frame.mjs --preset <预设名称> --hyperframes .
- 从
- 故事板与音频混音:
- 编写
STORYBOARD.md和SCRIPT.md。 - 音频:从
assets/music/中选择背景音乐,或使用/media-use解析音轨和 TTS 画外音(references/audio/)。 - 运行节拍提示分析:
python3 scripts/analyze_music_cues.py --audio <路径> --output audio_cues.json。
- 编写
- 验证与输出:
- 验证布局和时间线:
npx hyperframes check。 - 编译最终视频:
npx hyperframes render --output brag.mp4。 - 将海报帧 0 保存到
brag.jpg,并将发布副本保存到share-copy.txt。
- 验证布局和时间线:
模式 2:叙事与技术解说(faceless-explainer、pr-to-video)
用于将代码差异、工程文档或复杂主题转化为清晰的视频叙事。
- 故事脊梁:遵循
references/creative/references/story-spine.md(钩子、问题陈述、架构/解决方案、影响)。 - 镜头形状:从
references/animation/blueprints-index.md中选择蓝图(代码编辑器、对比拆分、统计数据标注、流程图)。 - 帧工作包:使用
workflows/faceless-explainer/scripts/frame-packets.mjs生成有边界的子代理包。每个帧在隔离环境中构建(compositions/frames/NN-*.html)。 - 组装与音频:将帧链接到根
index.html,混合画外音轨道并应用闪避包络,然后渲染。
模式 3:动态图形与运行时(motion-graphics、music-to-video)
用于独立的动态图形、动画 UI 组件、节拍网格和循环。
- 运行时适配器(
references/animation/adapters/):- GSAP:精确的多属性补间和可搜索安全时间线。
- Three.js:3D 空间视口、粒子系统和模型(
references/animation/adapters/three.md)。 - Lottie:矢量动画播放器(
references/animation/adapters/lottie.md)。 - Anime.js / WAAPI:紧凑的 DOM 变形和关键帧。
- CSS 关键帧:硬件加速变换。
- 相机过渡与变形(
references/keyframes/):- Ken Burns 平移、推近变焦、SVG 路径变形和深度效果。
- 注册表块与着色器(
references/registry/):- 搜索并安装预构建的效果块(CRT 扫描线、故障、胶片颗粒、闪光扫掠、五彩纸屑)。
模式 4:自定义合成与多轨道编辑(general-video、slideshow)
用于交互式提案、多轨道时间线编辑和自定义 HTML 视频。
- 演播室约定(
references/studio/studio-conventions.md):- 每个场景都是一个子合成(
data-composition-src)。 - 一个字幕轨道(
data-track-kind="captions")。 - 每个轨道一种元素类型(视频、图形、字幕、音频)。
- 安全区域合规(Premiere 标题/动作安全框)。
- 每个场景都是一个子合成(
- 跨域创作者配方:
- 裁剪与切割:更新
data-start、data-duration和data-media-start(references/core/tracks-and-clips.md)。 - 平滑变焦:在保持片段时间线稳定的同时,使用 CSS/GSAP 对内裁剪包装器进行动画(
references/keyframes/)。 - 音频增益与闪避:应用音量包络和总线压缩(
references/audio/)。
- 裁剪与切割:更新
4. 验证与 CLI 工具链
在交付前务必运行验证门控:
# 初始化一个新的 Hyperframes 项目,附带工作流脚手架
npx hyperframes init "videos/<project>" --skill=<工作流名称>
# 捕获实时 Web 资源、截图和品牌令牌
npx hyperframes capture "<URL>" -o ./capture --json
# 检查合成时间线、轨道和片段
npx hyperframes timeline [--json]
# 验证时间属性、安全区域和缺失的资源
npx hyperframes check
# 启动交互式本地播放器
npx hyperframes preview
# 渲染最终的 MP4 输出
npx hyperframes render --output output.mp4
5. 目录映射
| 路径 | 用途 |
|---|---|
workflows/ | 所有 11 个上游工作流(product-launch-video、faceless-explainer、pr-to-video、motion-graphics 等) |
engine/ | 规范的 Hyperframes v0.8.77 上游包套件 |
references/core/ | 时间属性、确定性规则、轨道模型、子合成 |
references/animation/ | GSAP、Three.js、Lottie、Anime.js、CSS 适配器、蓝图、运动模糊 |
references/keyframes/ | 2D/3D 相机过渡、变焦、SVG 变形、深度效果 |
references/audio/ | EQ、闪避、压缩、子混音总线自动化包络 |
references/creative/ | 设计规范、排版、调色板、帧预设、故事脊梁 |
references/registry/ | 可视化块、着色器组件、安装和接线 |
references/studio/ | 演播室时间线布局、字幕轨道、安全区域 |
references/brag/ | 精选的 /brag 逐步指南、语气和音乐提示 |
assets/music/ | 精选的背景音乐,涵盖电影感、热血、独立、宁静等风格 |
scripts/ | analyze_music_cues.py、帧包核心和音频提取工具 |