概述
此技能构建无脸解说视频——以配音为导向,无出镜主播——作为 HyperFrames 作品。适用于通过旁白和视觉效果传达信息的产品或概念解说。它将根据您提供的脚本渲染出最终的 MP4 文件。
HyperFrames — 无脸解说
将任意文本转换为解说视频:选择设计系统,规划教学叙事,然后逐帧构建。无脸意味着每个视觉效果都是全新创作的——没有捕获步骤,也没有真实的素材清单。
适用场景
- 用户希望从文章、笔记或简报中生成主题解说
- 用户希望进行概念解析(解释某事物如何工作)
- 用户希望制作操作指南或教程(无需屏幕录制)
- 用户希望制作列表式或动画列表
- 用户希望制作数据驱动解说(图表、统计、对比)
不适用场景
- 用户希望进行产品发布(使用
hyperframes-product-launch-video) - 用户希望制作主播出镜视频(使用
hyperframes-embedded-captions) - 用户希望制作动态图形(使用
hyperframes-motion-graphics) - 用户希望捕获一个网站(使用
hyperframes-product-launch-video)
工作流程
0 · 初始化
npx hyperframes init "videos/<project>" --non-interactive --example=blank --skill=faceless-explainer
初始化后立即编写 BRIEF.md(绝不能在初始化之前——init 命令会拒绝非空目录)。通过 node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . 记录偏好设置。
1 · 简报(无捕获)
将用户的完整输入原样保存:
capture/extracted/visible-text.txt— 完整的文章/笔记/主题/简报capture/extracted/tokens.json—{ "title": "", "description": "", "colors": [], "fonts": [] }
不要运行 npx hyperframes capture — 因为没有 URL。无脸视觉内容将在下游全新创作。
2 · 设计系统
选择一个与主题、语气和目标受众相符的画面预设:
node <SKILL_DIR>/scripts/build-frame.mjs --preset <name> --hyperframes .
此命令会将预设的 FRAME.md 复制为 frame.md 并混编品牌令牌。无脸解说通常没有品牌色/字体 → 脚本会保留预设自己的调色板。
3 · 故事板和脚本
将文本转换成逐帧的教学计划。视频的顺序来自叙事设计,而非输入文本的段落顺序——重新排序、合并、删减、压缩。
编写 STORYBOARD.md 以及(需要配音时)SCRIPT.md。每个帧需要包含:
focal/roles— 全新创作的视觉元素(主词、图表节点、数据可视化系列)blueprint— 镜头形状(来自hyperframes-animation/blueprints/)transition_in— 帧的进入方式
3.1 · 音频
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voice-id> &
默认配音:Marcia(女声)(HeyGen 平台)/ am_michael(Kokoro 平台)。背景音乐情绪来自故事板中的 music: 字段。
静音标记标准: STORYBOARD.md 顶部 YAML 块中包含 music: none 并且没有 SCRIPT.md = 完全静音项目。
4 · 帧视觉设计
对每个帧,编写一个带时间码的镜头序列:
- 选择帧的蓝图(或组合)
- 用本帧的全新创作内容实例化它
- 根据配音节奏安排每个场景的展现,使帧在其整个持续时间内逐步展开
每个场景内内联指定布局和运动。添加一个全局的 ## Video direction 块。
5 · 构建帧
等待步骤 3.1 音频完成。然后:
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/frame-packets.mjs --project "$PROJECT_DIR" --storyboard "$PROJECT_DIR/STORYBOARD.md"
为每个帧分派一个子代理。每个工作进程会获得:
_role.md(帧工作角色)- 该帧的数据包(精确的故事板块 + 蓝图主体 + 引用的规则配方,内联)
工作进程只编写 compositions/frames/NN-*.html。它们从不编辑 STORYBOARD.md。
全出血背景应放在 class="clip" 层上,绝不在 #root 上。 帧的背景是其自己的全持续时长背景剪辑。
后台构建字幕并组装索引:
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
6 · 最终处理
node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes check
npx hyperframes snapshot --at <frame-midpoints>
仅在用户批准后渲染:
npx hyperframes render --skill=faceless-explainer --quality high --output renders/video.mp4
反合理化表
| 合理化想法 | 实际情况 |
|---|---|
| “我会捕获文章的网站” | 无脸 = 无捕获。视觉内容是创作的,不是捕获的 |
| “我会按文本段落顺序来” | 叙事设计决定顺序,而不是原文顺序 |
| “我会跳过设计系统” | frame.md 是颜色/排版/布局的唯一真相来源 |
| “我会一次性加载所有内容然后冻结” | 根据配音节奏安排展现——帧在其持续时间内逐步展开 |
| “我会写一个蓝图并重复使用” | 每个帧根据内容选择自己的蓝图 |
| “我会跳过音频只使用文本” | 音频是时钟——所有节拍时间来自单词时间戳 |
| “我会在展现之间添加空闲动画” | 每个阶段都有目的——阶段性展现、有意图的镜头运动或序列化 UI |
| “我会居中在 42% 以留出字幕空间” | 字幕是叠加层——以真正中心为中心 (y = H/2) |
验证清单
-
hyperframes.json和BRIEF.md已存在 -
frame.md来自命名预设 -
STORYBOARD.md存在并包含必需的叙事字段 - 需要配音时
SCRIPT.md已存在 - 音频任务已启动或项目标记为静音
- 每个帧都有带时间码的镜头序列,节奏与配音匹配
- 每个帧指定了创作的
focal和/或roles -
index.html已存在 - 字幕已构建或明确跳过
-
lint和check在渲染前通过 - 用户在审查暂停时已批准