manim-video-teacher

name	manim-video-teacher
description	专注于使用 Manim 生成动画教学视频的完整流程与专业建议。适用于用户用中文提示语让 Codex 生成脚本、分镜、Manim 代码、渲染命令或优化教学视频质量与节奏，并输出 MP4。

Manim 动画教学视频

快速目标

用用户的中文提示语，产出可执行的 Manim 方案：脚本/分镜/代码/渲染命令，并解释关键教学设计选择。

先收集的最少信息

• 主题与受众：讲什么、给谁看
• 时长与节奏：总时长、快慢、是否分章节
• 画面风格：黑板风、简洁线性、是否强调配色
• 数学/代码内容：公式、伪代码或示例数据

若用户未提供，先做合理默认并声明假设。

工作流程

1. 把用户提示语改写成教学脚本（结构化段落：引入-核心-总结）。
2. 为每段脚本给出分镜（画面目标、关键动画、旁白要点）。
3. 设计视觉语言（颜色/字号/对齐/高亮规则），保持一致。
4. 生成 Manim 代码（Scene 结构清晰、变量命名明确）。
5. 给出渲染命令与参数建议（分辨率、fps、质量）。
6. 用脚本生成旁白音频，并可同步产出字幕（SRT）。
7. 用脚本合成视频与音频，必要时把字幕嵌入输出。
8. 用脚本生成单独封面图（适合传播/分享平台）。
9. 简要解释关键教学设计选择（为何这样分镜/过渡/强调）。

教学脚本模板

用短句、可口播的节奏：

1. 引入：问题/现象/动机（1-2 句）
2. 定义：核心概念（1-3 句）
3. 机制：关键步骤或推导（分 2-5 步）
4. 示例：用 1 个具体例子验证
5. 总结：一句话回扣重点

分镜粒度建议

• 15-30 秒一个镜头块，避免信息密度过高
• 每一步推导或关键结论单独成镜头
• 每个镜头最多 1-2 个主视觉对象

Manim 代码约定

• 使用 Scene 或 MovingCameraScene，尽量保持单场景可复用。
• 把复杂动画拆成小函数（如 show_definition()）。
• 用 VGroup 组织元素，统一对齐与间距。
• 用 FadeIn/FadeOut/Transform/ReplacementTransform 传达逻辑过渡。
• 文本尽量用 Tex/MathTex 保持数学排版一致，纯中文说明用 Text。

默认技术参数

• 分辨率：1920x1080
• fps：30
• 渲染质量：-qh 作为默认
• 输出：MP4

视觉与节奏默认值

• 主色：蓝色或橙色二选一，保持一致
• 强调色：亮黄或红色，仅用于关键结论
• 留白：屏幕边缘留 10-15% 安全区
• 口播节奏：每分钟 120-150 字

脚本优先

优先使用 scripts/ 下的脚本完成语音生成、合成与封面，不要求用户手写命令。

可用脚本：

• scripts/tts_generate.py：把旁白文本转为音频（edge-tts），可用 --subs-output subs.srt 输出字幕
• scripts/concat_audio.py：合并多段旁白（ffmpeg concat）
• scripts/mux_av.py：合成视频与音频（ffmpeg），可用 --subs subs.srt 嵌入字幕
• scripts/make_cover.py：生成 16:9 封面图（Pillow）
• scripts/pipeline.py：一键执行语音、合成与封面生成
  • 可选参数：--dry-run 输出命令不执行，--verbose 显示执行命令，--log-file 记录命令列表（默认覆盖），--append-log 追加记录
  • 字幕参数：--subs-output subs.srt（TTS 生成字幕），--subs subs.srt（使用已有字幕）

若脚本报缺依赖，提示用户安装对应依赖即可（edge-tts、ffmpeg、Pillow）。

示例（推荐）：

python scripts/pipeline.py \\
  --video manim.mp4 \\
  --tts-file narration.txt \\
  --subs-output subs.srt \\
  --cover-title "二次函数顶点式" \\
  --cover-subtitle "60 秒掌握" \\
  --output output.mp4

封面图规格与建议

• 比例：16:9
• 尺寸：1920x1080（与正片一致）
• 文字层级：标题 1 行 + 副标题 1 行（可选）
• 信息结构：左大标题，右侧示意图或关键公式
• 颜色：主色 + 强调色，避免超过 3 种主色
• 导出：PNG，保证清晰度

用户可能的触发示例（中文）

• “用 Manim 做一个 60 秒讲解二次函数顶点式的视频。”
• “做一个教学动画解释矩阵乘法，画面简洁。”
• “把这个概念讲给高中生，生成 Manim 代码和渲染命令。”

输出格式建议

• 先给脚本与分镜
• 再给 Manim 代码（可直接运行）
• 提供 scripts/pipeline.py 的使用方式（优先）
• 如需分段合成或自定义流程，给出对应脚本用法（tts_generate.py/concat_audio.py/mux_av.py）
• 提供封面图设计建议与导出规格（对应 make_cover.py）
• 最后给渲染命令与参数说明（Manim）
• 如果用户要旁白，附带配音台词与字幕（SRT）

常见优化点

• 重要概念用颜色/加粗/放大突出
• 动画节奏宁可慢一点，留白便于理解
• 公式推导分步出现，避免一次性堆叠
• 使用 Wait() 给观众思考时间

质量检查清单

• 逻辑顺序明确，镜头之间过渡自然
• 文字不过密，屏幕无明显拥挤
• 关键步骤已用颜色或动画强调
• 渲染参数与目标平台匹配