概述
此技能使用 HyperFrames 基于 HTML 的渲染,将发布日志转化为精心制作的视频合成。当产品更新值得一个视觉化公告——包括主角帧、关键要点标注和背景图案——时使用。它会根据您输入的日志条目生成 MP4 视频。
HyperFrames — 发布日志视频
输入:一个发布日志 .md(主题 + 条目)。输出:一个代码整洁、通过 seam-gate-green 检查的 HyperFrames 项目。仅在用户要求时进行渲染。
使用时机
- 用户提供了 更新日志/摘要 markdown 并希望生成每周视频
- 用户说 “发布日志视频” 或 “每周摘要视频”
- 用户想要一个带有动画模拟 UI 和语音旁白的 品牌化视频
禁止使用时机
- 用户想要产品发布视频(请使用
hyperframes-product-launch-video) - 用户想要动态图形(请使用
hyperframes-motion-graphics) - 用户想要主播出镜视频(请使用
hyperframes-embedded-captions)
核心原则:可视化,而非罗列
每个主题都通过一个 实际 UI 的动画模拟或其忠实模拟 来展示体验变化,而不是用文字要点。在编写脚本之前,务必将每个主题/条目先通过可视化注册表处理。
工作流程
0 · 从技能资产引导(不可协商)
mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
-vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
-an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html
然后完整阅读 references/build-spec.md —— 它定义了品牌令牌。
1 · 解析 + 编辑裁切
- 提取:周范围、标题统计、主题、条目
- 时间预算:总共 45-60 秒。 标题 ≤2 秒,片尾 ≤3.5 秒,4 个主题各约 9-12 秒
- 每个主题保留一个核心可视化 + 最多 3 个口述条目
- 按故事顺序排列主题:旗舰功能 → 产品界面 → 性能 → 可靠性
2 · 可视化路由
对于每个主题,从可视化注册表中选择界面并写一行:主题 → 界面 → 模拟执行的 2-4 个有序动作,每个动作对应一个脚本短语。
3 · 双层脚本(口述 vs 显示)
将脚本写成令牌行:使用对话式语域,每个技术术语在 spoken 中携带音标形式,而 display 保持标准拼写。字幕显示 display;旁白朗读 spoken。
4 · 旁白 + 单词时间戳
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json
单词时间戳是硬性门控。 在继续之前,请确认 vo-words.json 非空且包含一个带有每个单词 start/end 的 words: [...] 数组。
5 · 构建
严格遵循 references/build-spec.md:品牌令牌 + 字体 + 动画背景编码 + 场景骨架 + chrome 效果 + 字幕轨道。然后按照原则顺序:向量账本 → seam 印章 → 基于旁白单词的内部节拍 → seam 门控验证。
字幕不可省略。 在继续之前,从 captions.json 填充 LINES 数组。
6 · 门控(全部通过后方可呈现)
hyperframes check— 0 个错误seam-gate.mjs verify— 0 个失败- 重启预览服务器,抽查 3-4 个节拍
- 除非用户要求,否则不要渲染
- 字幕存在性门控 — 抽样 3-4 帧,确认字幕轨道可见
反合理化表
| 合理化 | 现实 |
|---|---|
| “使用要点列表幻灯片展示 UI 变更” | 通过模拟界面来展示变更过程 |
| “无法展示的条目用假 UI 代替” | 使用诚实的清单场景 |
| “TTS 文本中直接写‘JSON’” | 词汇表中为口语形式;显示保持标准 |
| “猜测发音” | 询问,然后扩充词汇表 |
| “朗读每一条日志” | 每个主题 ≤3 条;摘要链接承载其余内容 |
| “到处都是绿色强调” | 每个场景只出现一次绿色时刻 |
| “从以前视频的 index.html 开始” | 始终复制 master-skeleton.html |
| “空的 LINES 数组没问题” | 空的 LINES = 不带字幕的出品 = 重新运行 |
验证清单
-
hyperframes check通过,0 个错误 -
seam-gate.mjs verify通过,0 个失败 - 在 3 个以上抽样帧中字幕轨道可见
- 单词时间戳与音频对齐
- 品牌令牌与 build-spec.md 一致
- 仅在用户明确要求时才渲染