Communitygithub.com

MoreiraTv/vibe-video

基于 Manim 社区的数学和技术动画制作管线,用于创建 3Blue1Brown 风格的解释视频、算法可视化、公式推导、架构图和数据故事。适用于用户请求:动画解释、数学动画、概念可视化、算法演练、技术讲解、3Blue1Brown 风格视频或任何包含几何/数学内容的程序化动画。注意:如果用户正在启动新视频,请询问是否要使用说话者跟踪功能 (track_speaker.py) 来居中人物,以及是针对 PTZ 摄像机(舞台)还是无剪裁切换(播客)。

vibe-video 是什么?

MoreiraTv/vibe-video 是一个专为使用 Manim 社区版制作高质量教育动画而设计的专业管线。它采用严格的创意标准,强调“几何先于代数”、分层不透明度以及统一的视觉语言,确保每一帧都具有教育意义。该工具支持多种模式,包括概念解释、公式推导、算法可视化、数据故事、架构图、论文讲解和 3D 可视化。工作流程遵循 PLAN→CODE→RENDER→STITCH→AUDIO→REVIEW 的步骤,并且所有场景都使用单个 Python 脚本编写。它集成了 LaTeX 用于公式渲染、ffmpeg 用于视频拼接,并可选配 ElevenLabs 或 Qwen3-TTS 用于配音。该技能提供了详细的颜色调色板(包括经典的 3B1B 风格)、动画速度指南、排版建议和场景级变化规则,以确保输出视觉效果专业且美学统一。它还包含用于创意实验的 SCAMPER 和假设反转策略,当用户请求非常规或探索性内容时使用。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MoreiraTv/vibe-video/tree/HEAD/skills/manim-video

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Manim 视频制作管线

创意标准

这是教育电影。每一帧都传授知识。每一个动画都揭示结构。

在编写任何一行代码之前,先阐明叙事弧线。这个视频要纠正什么误解?什么是“顿悟时刻”?什么视觉故事能带领观众从困惑走向理解?用户的提示是起点——用教育抱负去诠释它。

几何先于代数。 先展示形状,再展示方程。视觉记忆的编码速度比符号记忆更快。当观众在看到公式之前先看到几何模式时,方程就显得理所当然了。

首版渲染品质不容妥协。 输出必须在视觉上清晰且美学上一致,无需修改轮次。如果某些内容看起来杂乱、节奏不佳或者像是“AI 生成的幻灯片”,那它就是错的。

不透明度分层引导注意力。 永远不要将所有内容都以全亮度显示。主要元素为 1.0,上下文元素为 0.4,结构元素(坐标轴、网格)为 0.15。大脑按层次处理视觉显著性。

留白时间。 每个动画之后都需要 self.wait()。观众需要时间来吸收刚出现的内容。切勿仓促地从一动画跳到下一个。在关键揭示之后停顿 2 秒绝不浪费。

协调的视觉语言。 所有场景共享统一的色彩调色板、一致的排版字号和匹配的动画速度。一个技术上正确但每个场景都使用随机不同颜色的视频是美学上的失败。

前提条件

运行 scripts/setup.sh 以验证所有依赖项。需要:Python 3.10+、Manim 社区版 v0.20+ (pip install manim)、LaTeX(Linux 上为 texlive-full,macOS 上为 mactex)以及 ffmpeg。参考文档针对 Manim CE v0.20.1 测试通过。

模式

模式输入输出参考文档
概念讲解主题/概念带有几何直观的动画解释references/scene-planning.md
公式推导数学表达式逐步动画证明references/equations.md
算法可视化算法描述带有数据结构的逐步执行references/graphs-and-data.md
数据故事数据/指标动画图表、比较、计数器references/graphs-and-data.md
架构图系统描述组件逐步构建并连接起来references/mobjects.md
论文讲解研究论文关键发现与方法动画化references/scene-planning.md
3D 可视化3D 概念旋转曲面、参数曲线、空间几何references/camera-and-3d.md

技术栈

每个项目一个 Python 脚本。无需浏览器、Node.js 或 GPU。

层工具用途
核心Manim 社区版场景渲染、动画引擎
数学LaTeX (texlive/MiKTeX)通过 MathTex 渲染公式
视频 I/Offmpeg场景拼接、格式转换、音频混流
文本转语音 (TTS)ElevenLabs / Qwen3-TTS (可选)旁白配音

管线

规划 --> 编码 --> 渲染 --> 拼接 --> 音频 (可选) --> 审阅
  1. 规划 — 编写 plan.md,包含叙事弧线、场景列表、视觉元素、色彩调色板、旁白脚本
  2. 编码 — 编写 script.py,每个场景一个类,每个类可独立渲染
  3. 渲染 — 草稿用 manim -ql script.py Scene1 Scene2 ...,正式版用 -qh
  4. 拼接 — 使用 ffmpeg 将场景片段拼接成 final.mp4
  5. 音频 (可选) — 通过 ffmpeg 添加旁白和/或背景音乐。参见 references/rendering.md
  6. 审阅 — 渲染预览静态图,对照计划进行核对,调整

项目结构

project-name/
  plan.md                # 叙事弧线、场景分解
  script.py              # 所有场景在一个文件中
  concat.txt             # ffmpeg 场景列表
  final.mp4              # 拼接后的输出
  media/                 # 由 Manim 自动生成
    videos/script/480p15/

创意方向

色彩调色板

调色板背景主色辅助色强调色用途
经典 3B1B#1C1C1C#58C4DD (蓝色)#83C167 (绿色)#FFFF00 (黄色)通用数学/计算机科学
温暖学术#2D2B55#FF6B6B#FFD93D#6BCB77亲和力
霓虹科技#0A0A0A#00F5FF#FF00FF#39FF14系统、架构
单色#1A1A2E#EAEAEA#888888#FFFFFF极简

动画速度

上下文run_time其后 self.wait() 时间
标题/介绍出现1.5 秒1.0 秒
关键公式揭示2.0 秒2.0 秒
变换/变形1.5 秒1.5 秒
辅助标签0.8 秒0.5 秒
FadeOut 清理0.5 秒0.3 秒
“顿悟时刻”揭示2.5 秒3.0 秒

排版比例

角色字号用途
标题48场景标题、开场文字
标题36场景内的段落标题
正文30解释性文字
标签24注释、坐标轴标签
说明文字20字幕、小字

字体

所有文本使用等宽字体。 Manim 的 Pango 渲染器在使用比例字体时会在所有字号下产生破损的字距。完整建议请参见 references/visual-design.md。

MONO = "Menlo"  # 在文件顶部定义一次

Text("Fourier Series", font_size=48, font=MONO, weight=BOLD)  # 标题
Text("n=1: sin(x)", font_size=20, font=MONO)                  # 标签
MathTex(r"\nabla L")                                            # 数学公式(使用 LaTeX)

为保证可读性,最小 font_size=18。

逐场景变化

切勿对所有场景使用相同的配置。每个场景:

  • 从调色板中选择不同的主色
  • 采用不同的布局——不要始终将所有内容居中
  • 使用不同的动画进入方式——在 Write、FadeIn、GrowFromCenter、Create 之间交替
  • 赋予不同的视觉权重——有些场景信息密集,其他场景则稀疏

工作流程

步骤 1:规划 (plan.md)

在任何代码之前,编写 plan.md。有关完整模板,请参阅 references/scene-planning.md。

步骤 2:编码 (script.py)

每个场景一个类。每个场景都可独立渲染。

from manim import *

BG = "#1C1C1C"
PRIMARY = "#58C4DD"
SECONDARY = "#83C167"
ACCENT = "#FFFF00"
MONO = "Menlo"

class Scene1_Introduction(Scene):
    def construct(self):
        self.camera.background_color = BG
        title = Text("Why Does This Work?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
        self.add_subcaption("Why does this work?", duration=2)
        self.play(Write(title), run_time=1.5)
        self.wait(1.0)
        self.play(FadeOut(title), run_time=0.5)

关键模式:

  • 每个动画都带有字幕:self.add_subcaption("text", duration=N) 或在 self.play() 上使用 subcaption="text"
  • 在文件顶部共享颜色常量,以实现跨场景一致性
  • 每个场景都设置 self.camera.background_color
  • 干净的退出——场景结束时 FadeOut 所有 mobject:self.play(FadeOut(Group(*self.mobjects)))

步骤 3:渲染

manim -ql script.py Scene1_Introduction Scene2_CoreConcept  # 草稿
manim -qh script.py Scene1_Introduction Scene2_CoreConcept  # 正式版

步骤 4:拼接

cat > concat.txt << 'EOF'
file 'media/videos/script/480p15/Scene1_Introduction.mp4'
file 'media/videos/script/480p15/Scene2_CoreConcept.mp4'
EOF
ffmpeg -y -f concat -safe 0 -i concat.txt -c copy final.mp4

步骤 5:审阅

manim -ql --format=png -s script.py Scene2_CoreConcept  # 预览静态图

关键实现说明

LaTeX 的原始字符串

# 错误: MathTex("\frac{1}{2}")
# 正确:
MathTex(r"\frac{1}{2}")

边缘文本的 buff >= 0.5

label.to_edge(DOWN, buff=0.5)  # 永远不要 < 0.5

替换文本前先 FadeOut

self.play(ReplacementTransform(note1, note2))  # 不要直接在顶部 Write(note2)

永远不要对未添加的 Mobject 进行动画

self.play(Create(circle))  # 必须先添加
self.play(circle.animate.set_color(RED))  # 然后才能动画

性能目标

质量分辨率帧率速度
-ql (草稿)854×480155-15 秒/场景
-qm (中等)1280×7203015-60 秒/场景
-qh (正式版)1920×10806030-120 秒/场景

始终使用 -ql 进行迭代。仅在最终输出时渲染 -qh。

参考文档

文件内容
references/animations.md核心动画、速率函数、组合、.animate 语法、时序模式
references/mobjects.md文字、形状、VGroup/Group、定位、样式、自定义 mobject
references/visual-design.md12 个设计原则、不透明度分层、布局模板、色彩调色板
references/equations.mdLaTeX 在 Manim 中的使用、TransformMatchingTex、推导模式
references/graphs-and-data.md坐标轴、绘图、BarChart、数据动画、算法可视化
references/camera-and-3d.mdMovingCameraScene、ThreeDScene、3D 曲面、摄像机控制
references/scene-planning.md叙事弧线、布局模板、场景过渡、规划模板
references/rendering.mdCLI 参考、质量预设、ffmpeg、配音工作流程、GIF 导出
references/troubleshooting.mdLaTeX 错误、动画错误、常见错误、调试
references/animation-design-thinking.md何时使用动画 vs 静态展示、分解、节奏、旁白同步
references/updaters-and-trackers.mdValueTracker、add_updater、always_redraw、基于时间的更新器、模式
references/paper-explainer.md将研究论文转化为动画——工作流程、模板、领域模式
references/decorations.mdSurroundingRectangle、Brace、箭头、DashedLine、Angle、注释生命周期
references/production-quality.md编码前、渲染前、渲染后检查清单、空间布局、颜色、节奏

创意发散(仅当用户要求实验性/创意性/独特输出时使用)

如果用户要求创造性、实验性或非传统的解释方法,请在开始设计动画之前选择一种策略并对其进行推理。

  • SCAMPER —— 当用户希望对标准解释进行全新演绎时
  • 假设反转 —— 当用户希望挑战某个主题通常的教授方式时

SCAMPER 转换

对一个标准的数学/技术可视化进行转换:

  • 替代 (Substitute):替换标准的视觉隐喻(数轴 → 蜿蜒路径,矩阵 → 城市网格)
  • 结合 (Combine):合并两种解释方法(同时使用代数 + 几何)
  • 反转 (Reverse):反向推导——从结果开始,逆向分解到公理
  • 修改 (Modify):夸大某个参数以展示其重要性(10 倍学习率,1000 倍样本量)
  • 消除 (Eliminate):移除所有符号——纯粹通过动画和空间关系来解释

假设反转

  1. 列出该主题可视化的“标准”做法(从左到右、二维、离散步骤、正式符号)
  2. 选择最基础的假设
  3. 将其反转(从右到左推导、将二维概念嵌入三维空间、连续变形而非步骤、零符号)
  4. 探索这种反转揭示了哪些标准方法所隐藏的内容

相关技能