视频类型 - ZLHad/OpenVideoHarness GitHub Wiki
English · 中文
每个需求都会先被归到 9 类视频中的一类，agent 再去读那一类的工作流。第 09 类是实验性的。类型文档写的是：什么时候用这一类、用什么引擎、分几步、什么算好看、什么不许做、一段会被 bin/vh new 贴进 BRIEF 的 prompt 块（这一类的默认做法，立意定了再取舍）、自查重点，以及可以参考的案例。"禁止"也分两种：管事实、许可、可读和隐私的是底线；管长相的（配色、质感、缓动、图表样式）是默认口味，立意需要时可以改。路由表在 CLAUDE.md 里。
| # | 类型（bin/vh new 用的名字） |
做什么 | 首选引擎 | 先看 | 文档 |
|---|---|---|---|---|---|
| 01 | 数学、科学原理讲解（math） |
讲清一个原理、定理、算法或物理过程，3Blue1Brown 式；一般 1–10 分钟，16:9 | Manim CE | showcase 03（傅里叶级数）、Code2Video 案例 | 01 |
| 02 | 知识科普短视频，竖屏或横屏（short） |
30–90 秒的科普、冷知识、how-to，投抖音、B站、小红书、视频号、Shorts、TikTok，不需要真人出镜 | HyperFrames | showcase 02（低轨卫星多普勒）、黑洞科普案例 | 02 |
| 03 | 产品宣传、发布片（promo） |
10–90 秒的发布片、App 或 SaaS 宣传片、功能揭示、项目介绍片 | HyperFrames | showcase 00、showcase 04、HeyGen 发布片合集 | 03 |
| 04 | 歌词视频、MV（mv） |
给一首自己做的或有授权的歌配画面：歌词不上屏的绘画式 MV，或者动态排版的歌词视频 | ClaudeAnimationBase（p5.brush）或 HyperFrames | P(doom) 案例、Functional Emotions 案例 | 04 |
| 05 | 数据叙事（data） |
用数据讲一个结论：趋势、对比、排名变化、分布 | HyperFrames + SVG | 还没有 showcase；可以看风格预设 editorial-data、bubble-chart-story、isotype |
05 |
| 06 | 论文讲解、会议视频（paper） |
论文讲解、约 30 秒的会议 teaser、3–5 分钟的讲解、报告录像、投稿附带的补充视频 | Manim（讲机制）+ HyperFrames（讲结构、结果） | Paper2Video 案例、Code2Video 案例 | 06 |
| 07 | 手绘、水彩、白板、剪纸（handdrawn） |
角色小短片、手绘风的叙事科普；汉字可以按笔顺写出来 | ClaudeAnimationBase（p5.brush，仓库自带） | showcase 01（Clawd 和落叶）、P(doom) 案例 | 07 |
| 08 | 野兽派、网络梗、快剪（meme） |
15–40 秒的梗视频、观点快剪、科技圈社交媒体上的视觉 hook | HyperFrames | Claude Pop 案例、风格预设 brutalist-meme |
08 |
| 09 | 真人素材剪辑、口播（edit），实验性 |
剪你自己录的口播、访谈、Vlog：删口水词和重录、在静音缺口处下刀、加字幕和图解、出竖屏版 | HyperFrames | 还没有 showcase；社区提示词（一种口播图解的做法） | 09，细节在 engines/editing.md |
关于第 09 类。 它是根据同类项目的调研写出来的，还没剪过一支真正的片子：阈值只在合成材料上标定过（合成语音加噪声），也没有在任何剪辑软件里导入过导出的文件。文档里提到的工具（缺口测量、逐接缝指标、剪辑清单编译器）还没写出来，眼下最快的路线是 HyperFrames 的 transcript-cut.mjs。这一类已经定下来的是：切点按测量到的静音缺口定，不按语音识别的词时间；剪辑清单用整数帧记，你批准了它的哈希才开始渲染；素材是你的脸和你的声音，所以转写默认在本地做，要用云端服务，agent 会先问你。
怎么判断类型
- 只给一句话是常态。agent 先想立意，再按类型文档的默认值补全 BRIEF，最多问 3 个真正影响结果的问题。
- 一支视频可以横跨两类，比如把论文讲解做成竖屏短视频。这时两份文档都读，冲突的地方以主类型为准。
- 哪一类都不贴切时，agent 按 playbook/00 的引擎选型表自己判断，并在
DECISIONS.md里写明理由。
还不算一类的需求
| 你想要 | 去哪里看 |
|---|---|
| 写实人物、真实物理、实拍感 | playbook/05：生成式视频加一层代码，现在按任务来写（拿到片段入库、和代码画面对齐、抠像、同一角色跨镜头、检查伪影、成本）。带日期的规格和价格在 genvideo-market，许可和披露在 genvideo-ledger。要花钱，结果也不确定，所以动手前会先在 BRIEF 里和你确认预算。实验性：还没有调用过任何视频模型。你自己录的素材不用生成，走第 09 类 |
| 特效、转场、粒子、着色器、声画联动 | playbook/08 |
| 这一镜该怎么动、整片的节奏怎么排 | recipes/：24 个镜头配方（接缝、节奏、文字、界面、运镜）和八条全片骨架：三条按能量弧排（15 秒发布片、30 秒讲解、60 秒产品片），五条从立意出发（时间放大镜、机器视角的肖像、用做法讲做法、吉祥物穿越风格、工作流即故事）。bin/vh recipes list 按这一镜要说什么、多响来筛。见风格库 |
| 有起伏的故事，或 3 分钟以上的长片 | playbook/09：骨架、可填的节拍表、好奇缺口和能量曲线、换挡 |
| 要发短视频平台：钩子、标题、封面 | playbook/10；bin/vh cover-preview 能按各平台信息流的实际大小看封面 |
| 配乐要有篇章、有能哼出来的主题、有起伏 | playbook/11；见声音与配音 |
| 3D 或着色器短片（Three.js） | 还没有专门的类型文档：按发布片类型的运动规则，加上 playbook/08（一镜到底的镜头路径、特效预设栈、子帧运动模糊）；showcase 04 是现成的例子。要路径追踪的光影（玻璃、皮肤、体积光）、物理模拟或真实景深时，有一份 Blender 指南，部分已实测：风格样片 tabletop-miniature 和介绍片的开场（numpy 逐帧驱动的一个星系）都是用 Blender 5.2.2 渲的，指南里还有几条命令没跑过。3D 类型文档已列进路线图 |
| "这支视频是怎么做的" | playbook/07：拉片拆解参考视频，产出一份新的 cases/ 案例 |
按类型建项目
bin/vh types # 9 类视频和对应文档
bin/vh new short leo-doppler # projects/<日期>-leo-doppler，装好竖屏 HyperFrames 脚手架
bin/vh new math fourier --style dark-math # 同时挂上一个风格预设当参考
bin/vh new promo launch --effort studio # 同时指定努力程度
bin/vh new short explainer --aspect 16:9 # 短视频、发布片、数据、梗：指定画幅
bin/vh new promo launch --watch feed --res 4k # 在哪看（决定字号下限）和输出分辨率
bin/vh new edit my-interview # 第 09 类；然后 bin/vh hf-init projects/<…> portrait
一般不用自己敲这些命令，agent 判断完类型会自己建。接下来是挑画风：风格库。