解释器视频技能(地狱男爵) 是做什么的?
你将一个技术主题转化为一个完成的2–3分钟1080×1920 MP4视频,让非技术人员一看就懂。视觉风格、节奏和脚本结构都源自一个参考频道(在 docs/01-style-bible.md 中分析)。两样东西是我们有意为之的:角色(地狱男爵) 和配音。
你只需编写文本文件(一个脚本和一个 storyboard.json)。engine/ 中的引擎负责配音、字幕、动画、角色、音乐和渲染。
当用户只给出一个主题时
直接完成全部工作,无需追问:
- 根据主题创建一个slug(如
how-dns-works),然后运行python engine/make_video.py new videos/<slug>。 - 编写
videos/<slug>/script.md(参考 docs/02)和videos/<slug>/storyboard.json(参考 docs/03 + docs/04)。复制examples/upi-explained/中的模式。 - 运行
python engine/validate_storyboard.py videos/<slug>。修复每个 ERROR,重复直到打印出0 error(s)。 - 运行
python engine/make_video.py preview videos/<slug>。如果你能看到图片,对照 docs/06 第B节检查build/preview.png并修复。 - 运行
python engine/make_video.py render videos/<slug>。回复路径output/<slug>.mp4、时长和两行摘要。
不可妥协事项
- 地狱男爵永不重绘。 他只来自
character/hellboy/hellboy.js。你可以设置show、arm(down/point/explain)和expression,其他不能动。读一遍character/hellboy/CHARACTER_BIBLE.md。 - 配音是固定的,在
engine/config.json中。不要针对每个视频更改。 - 长度:360–470个旁白词,2:00–2:50。 句子≤20个词。
- 每句话都改变屏幕上的内容。 项目在对应的关键词(
"at")处出现。 - 正确优于复杂。 通过省略内容来简化,绝不说假话。
- 验证器必须通过(
0 errors) 才能渲染。
工作流程(按顺序执行)
| # | 步骤 | 阅读 | 输出 |
|---|---|---|---|
| 1 | 搭建框架 | – | python engine/make_video.py new videos/<slug> |
| 2 | 规划并编写脚本 | docs/02-script-writing.md | videos/<slug>/script.md(360–470词,7个节拍) |
| 3 | 规划视觉 | docs/03-visual-planning.md | 场景列表:旁白 → 类型、标题、角色 |
| 4 | 编写故事板 | docs/04-storyboard-reference.md | videos/<slug>/storyboard.json(或 meta.json + scenes.jsonl → assemble) |
| 5 | 验证 | – | python engine/validate_storyboard.py videos/<slug> → 修复直到0错误 |
| 6 | 预览 + QA | docs/06-qa-checklist.md | make_video.py preview videos/<slug> → 检查 build/preview.png,修复 |
| 7 | 渲染 | docs/05-production.md | make_video.py render videos/<slug> → output/<slug>.mp4 |
| 8 | 最终QA | docs/06-qa-checklist.md | 分数≥85,所有MUST项通过 |
小型/本地模型? 按照 docs/07-small-model-playbook.md 替代步骤2–5。它把工作分解为一次一个场景的提示。
7节拍脚本(记住)
钩子(≤22词:“X解释。” / “X实际上如何工作?” / 惊人声称 / relatable动作)→ 张力(谜团)→ 路线图(“让我们跟着……”)→ 主体(3–6章:概念 → 通俗含义 → 日常例子 → 结果;一个带有人名的运行例子)→ 转折(“但有趣的部分是……”)→ 回顾(“所以这样记住它。”每章一句)→ 妙语(呼应钩子的片段:“一次扫描。四个参与者。两秒钟。”)。
场景配方(记住)
- 1个场景 = 1–3句话(8–28词,3–8秒);每个视频20–32个场景。
- 从
docs/03-visual-planning.md的决策表中选取visual.type。每个视频使用7–12种不同类型的场景。 - 在40–70%的场景中显示地狱男爵(始终:第一个场景、转折点、回顾、最后一个场景)。对于
sequence、hub、diagram、compare类型隐藏他。 - 通过2–4个场景构建大图,使用
"continue": true+"shown": true项和相同的标题。 - 标题2–6个词,带一个
*重音*词。屏幕上标签1–4个词。
命令(从仓库根目录执行)
# 首先激活: source .venv/bin/activate | Windows: .\.venv\Scripts\Activate.ps1
python engine/make_video.py new videos/<slug> # 模板
python engine/make_video.py assemble videos/<slug> # meta.json + scenes.jsonl -> storyboard.json
python engine/validate_storyboard.py videos/<slug> # 必须0错误
python engine/make_video.py preview videos/<slug> # build/preview.png(每个场景一帧)
python engine/make_video.py render videos/<slug> [--fast]
第一次在某台机器上运行:./setup.sh(Linux/macOS)或 setup.ps1(Windows)。完成的视频放在 output/<slug>.mp4。
参考资料
examples/upi-explained/(暖纸风格)和examples/load-balancer-explained/(蓝图风格)——完整的示例作品。复制他们的模式。templates/——script.template.md、storyboard.template.json。docs/01-style-bible.md——参考频道的做法及度量(规则存在的原因)。engine/icon_names.txt——所有2,359个允许的图标名称(Lucide)。