muyang-flat-animation · AI 工具图鉴

📌 核心价值：把中文口播压成"纸上钢笔线稿 + 彩铅填色"知识动画 B-roll，一句话搞定。

三闸门协议 + Gemini Omni Flash 引擎，专治知识视频找素材难、画师工期长、风格不统一的痛点。

封面图

🚀 什么是 muyang-flat-animation？

yokel1121/muyang-flat-animation 是一个开源的 Codex Skill，把一句 5–10 秒的中文口播、抽象概念或单张静态插画，自动生成 6 秒、24fps、9:16 / 16:9 的"沐阳扁平动画"——画面是暖色纸面 + 自然钢笔线稿 + 选择性彩铅填色 + 编辑式图解留白，配轻量知识型音效（无笔纸摩擦声、不抢口播）。

项目的视觉风格直接来自传统编辑插画：固定机位、纸质纹理、墨线钢笔、彩铅颗粒，少量圆圈/虚线/箭头做图解。区别于 Runway、Pika 这类通用文生视频，muyang-flat-animation 是"知识讲解专用 B-roll 生成器"——内置"直观优先"语义规则，禁止石头变水晶、种子长树、灯泡发光这类与主题脱节的通用隐喻。

核心定位：为知识区视频博主设计的"一句话动画 B-roll 工厂"，三闸门确认机制让零基础也能稳定出片。

✨ 核心功能一览

muyang-flat-animation 核心功能一览

🛠️ 快速上手：5 分钟跑通示例

安装环境

需要 Python 3.10+、FFmpeg、FFprobe、可用的 Gemini API Key：

git clone https://github.com/yokel1121/muyang-flat-animation.git
cd muyang-flat-animation
pip install -r muyang-flat-animation/requirements.txt

把 Skill 目录复制到 Codex Skills 目录：

# Windows PowerShell
Copy-Item -Recurse .\muyang-flat-animation "$env:USERPROFILE\.codex\skills\muyang-flat-animation"
[Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "你的_API_Key", "User")

# macOS / Linux
cp -R ./muyang-flat-animation ~/.codex/skills/muyang-flat-animation
export GEMINI_API_KEY="your_api_key"

# 检查环境
python ~/.codex/skills/muyang-flat-animation/scripts/check_setup.py

一句话出片示例

在 Codex 会话中输入 $muyang-flat-animation 加需求描述：

$muyang-flat-animation 16:9，制作：学会用 AI 放大自己的能力

$muyang-flat-animation 无人物，9:16，制作：信息不是越多越好，而是越清楚越好

$muyang-flat-animation 3:4，鼠尾草绿，无声，制作：把复杂流程整理清楚

Skill 会先停在 Gate 1（动画方案确认）——你看到"核心意思、视觉命题、构图配色、5–8 秒时间轴"后才回复"通过"；然后才进入 Gate 2（静帧确认）和 Gate 3（Gemini 视频生成 + 逐帧 QA）。

注意：每条视频都需用户明确确认，禁止"全自动一口气出片"——这是知识讲解场景的稳定性保险。

直接运行视频生成器（高级用户）

跳过三闸门对话，写 jobs.json 批量生成：

[
  {
    "prompt": "Your complete motion prompt",
    "image": ["final-still.png"],
    "output": "final.mp4",
    "aspect_ratio": "16:9",
    "duration": 6
  }
]

python muyang-flat-animation/scripts/generate_video.py --batch jobs.json --concurrency 1

默认模型是 gemini-omni-flash-preview。遇到 429 RESOURCE_EXHAUSTED 时切换 API Key。

📊 与竞品对比

muyang-flat-animation vs 传统 vs 通用视频生成

💡 适用场景

场景 1：无人物内容可视化（content-only 模式）

信息漏斗筛选示意图

功能说明：用漏斗、卡片、连接线表达"筛选 / 分类 / 因果"等抽象过程，不出现任何人脸或手部。

输入要求：在 $muyang-flat-animation 后加 无人物，描述要可视化的过程（如"信息筛选"、"分类整理"）。

输出效果：一张干净纸面上，杂乱卡片经过漏斗，最终留下 3 张层级清晰的卡片，配温和滑动音效。

适用场景：知识区"信息整理"、"工作流拆解"、"概念分类"类视频。

场景 2：人物叙事模式（character 模式）

三套语义配色

功能说明：保留人物身份（脸型、服装、桌面布局稳定），动作限定为眨眼、呼吸、手部操作等"生命微动作"，配合图标错峰接力表达观点。

输入要求：默认 character 模式，描述人物在做什么（如"用 AI 完成日常任务"）。

输出效果：纸面上一个穿浅色毛衣的人物坐在木桌前，桌上摆着书本、咖啡杯、卡片，AI 光线逐个点亮任务卡，配克制物件音。

适用场景：知识区"AI 工具实操"、"学习方法"、"工作习惯"类视频。

场景 3：三闸门审核流程

三闸门协议

功能说明：动画方案确认 → 静帧确认 → Gemini 视频生成 + 逐帧 QA，每一步都有用户签字，避免最终成片偏题。

输入要求：无门槛，默认开启。

输出效果：用户在每一步都有明确的"通过 / 修改"机会，对失败条目单独重生，不浪费已通过的资产。

适用场景：所有需要"高确定性"知识视频内容的创作者。

场景 4：生长动画与连接线

生长动画示例

功能说明：线条沿路径绘出、图形从轮廓到填色、网络从主节点到分支——按对象自身结构逐步展开，不允许"完成物整体缩放或淡入"冒充生长。

输入要求：描述"从 A 生长出 B"或"A 连接到 B"等过程。

输出效果：钢笔尖在纸面绘出路径，每个节点按时间轴接力出现，配柔和纸张滑动音。

适用场景：知识区"技术演进"、"原理拆解"、"流程可视化"类视频。

场景 5：参考图风格继承

钢笔线稿特写

功能说明：把 style-reference-*.png 放进 assets/references/ 目录后，Skill 会用其约束媒介与画法（纸面、墨线、彩铅颗粒、留白），但不照搬人物、构图或配色。

输入要求：2–5 张有使用授权的图片放指定目录。

输出效果：保持你自定义的视觉语法（如编辑式单场景、真实桌面物件、留白节奏），同时获得稳定的视频生成管线。

适用场景：有品牌视觉规范的博主、工作室、MCN。

用户群体总结

✅ 知识区视频博主：5–10 秒口播直接出 B-roll，省去 AE / PR 工期
✅ 自媒体团队：批量生产，统一画风，三闸门保证质量
✅ 教学课件制作者：可生成 16:9 横版，适配课堂演示
✅ AI 工具教程作者：可视化"AI 处理任务"这类抽象过程
❌ 不适合：需要切镜 / 摇移 / 推拉的电影感叙事；需要写实人像 / 3D 场景的题材

💰 定价方案

muyang-flat-animation Skill 本身：完全免费，MIT 协议
Gemini API 调用费用：约 $0.02–$0.05 / 6 秒视频（按 Omni Flash 公开定价）
本地依赖：Python 3.10+、FFmpeg、FFprobe（全部免费开源）

开源协议： MIT

💡 核心成本节省：相比雇画师手绘 6 秒知识动画的 200–500 元人力成本，Gemini 调用一次约 0.3 元，量级差 1000×。

🎯 总结

muyang-flat-animation 把"中文口播 → 纸上钢笔动画 B-roll"做成了一条流水线：固定视觉风格（暖纸 + 钢笔 + 彩铅）+ 三闸门协议（方案 / 静帧 / 视频）+ Gemini Omni Flash 引擎。每个动作都有明确的"主动作 + 接力响应 + 生命微动作"分层逻辑，禁止抽象隐喻冒充主题，对知识区视频博主极度友好。

推荐指数： ⭐⭐⭐⭐（满分 5 星，扣 1 星因依赖 Gemini API Key）

适合人群： 知识区视频创作者 / 自媒体团队 / AI 工具教程作者

立即体验： yokel1121/muyang-flat-animation

GitHub 仓库： yokel1121/muyang-flat-animation

数据截至 2026-07-25，最新信息请以官网为准。

配套媒体