科普动画工坊 itwanger/vibe-science

VibeScience · 让知识动起来

把一个知识点，做成一段看得懂的动画。

给 Claude Code、Codex、DeepSeek Harness 的中文科普视频技能。

面向小学、初中、高中的数学、物理、化学、生物，也适用于 AI 概念。

看效果 · 五分钟开始 · 智能体用法 · 制作环境 · 提示词

勾股定理：实际效果

同一条 勾股定理，两种画风。从直角三角形、面积搬运，到四个全等三角形的拼接证明，约 80 秒。下面是实际工程的画面；两版都可以在本地播放完整动画与字幕。

孟菲斯版 · 已确认预览

首帧给出完整四色拼图，再抽出直角三角形进入讲解。主体采用浅薄荷色面＋统一靛色轮廓，粉彩标签和公式纸片区分知识对象；纹理随拼片运动，底边标记按整框避让。

孟菲斯打磨记录 · 风格规范 · 运行两版动画

暖米几何版

暖纸底、语义色与连续几何运动，保留原版的教学编排。

阅读文字稿 · 暖米版打磨记录

仓库提供两版 80 秒无声动画与字幕工程，可在 Remotion Studio 播放。私人配音、音色 ID、声音样本和服务凭据不随包分发，新视频使用自己的授权音色。当前未提供正式有声 MP4 下载。

它解决什么

一条片只讲清一个知识点。解释交给旁白，因果交给运动：面积怎样转移、三角形怎样拼接、物体怎样受力、粒子怎样反应。目标是让观众看见过程，而不只是看见一张张文字卡。

- 完整流程：文字稿 → 配音试听 → 分镜 → 动画和字幕预览 → MP4 导出。说一次「下一步」只推进一个阶段。
- 首帧构图与材质：开头即呈现主题对象，色面、轮廓与运动贯穿正文；孟菲斯案例展示如何从拼图进入原理讲解。
- 手机阅读：1920×1080 基准下，对象标签 48px、数学符号 60px、核心公式 84px、字幕 48px；长字幕按语义分组。
- 保留原稿：不为卡到一分钟而漏读、截断或加速，超时如实报告。
- 读音可返修：C 按英文 /siː/ 处理；先听上下文短样本，确认后替换完整意群，再同步动画。
- 智能体可接力：文字、时间轴、分镜和进度保存在文件中，按标准 SKILL.md 加载。

这些规则来自真实样片的迭代。生成质量仍取决于模型能力、题材和审片，不承诺一次提示就达到样片效果。

五分钟开始

预览样例需要 Node.js 22+、Python 3.10+；首次启动 Remotion 需要可用浏览器或下载其浏览器运行时。完整制作的额外依赖见环境配置。

git clone https://github.com/itwanger/vibe-science.git
cd vibe-science
npm ci --prefix video
npm --prefix video run demo

打开终端给出的 Studio 地址（默认 http://localhost:3210），选择 PythagoreanMemphisDemo（孟菲斯）或 PythagoreanDemo（暖米）并播放。无需 TTS 凭据，也不会调用付费语音接口。首次安装耗时取决于网络；端口占用时见样例说明。

把技能装入你的工作项目，三选一：

python3 scripts/install_skill.py --agent claude --project /path/to/your/projectbash
python3 scripts/install_skill.py --agent codex --project /path/to/your/project
python3 scripts/install_skill.py --agent dsh --project /path/to/your/project

也可以用 --agent all；个人全局安装改用 --global。默认创建符号链接，保留这份克隆。已有同名技能时拒绝覆盖，需自行决定是否迁移。详细安装与官方依据。

在 Agent 中开始：

| Agent | 调用示例 |
| Claude Code | /one-minute-remotion 为初中生讲浮力，先只完成文字稿。 |
| Codex | $one-minute-remotion 为初中生讲浮力，先只完成文字稿。 |
| DeepSeek Harness | 使用 one-minute-remotion Skill，为初中生讲浮力，先只完成文字稿。 |

先核对文稿，再说「下一步」。配音阶段使用你自己的 TTS 账号与可用音色，详见配置步骤。三种 Agent 的加载目录和调用形式已按官方文档核对；本仓库的自动检查验证运行时、安装器及样例，不代表已在三个 Agent 中分别完成整条生成测试。

两种画风

| 画风 | 特点 | 当前状态 |
| 暖米几何 | 暖纸底、清楚的色彩身份、几何连续运动 | 勾股定理样片已完成，含可运行工程 |
| 孟菲斯 | 完整首帧、浅色主体与靛色轮廓、局部点线纹理 | 已确认样例与规范，含可运行的无声工程 |

新片默认暖米几何。指定「使用孟菲斯风格」即可让 Agent 按风格卡设计；画风选择不改变字幕字号和制作阶段。孟菲斯灵感参考见原帖，仓库不转载参考视频。

仓库里有什么 text skills/one-minute-remotion/ Skill、写稿规范、动画方法、风格卡、字体与上游库 one-minute/ 文字稿 video/shared/ TTS、对齐、时间轴、Remotion 和导出工具 video/pythagorean-demo/ 暖米与孟菲斯两版可运行无声案例 scripts/ 安装、环境定位与公开包检查 docs/ Agent 用法、制作环境、提示词

这是一套供 Agent 阅读、编排和实现的制作方法及运行时，不是输入标题就自动产出所有学科动画的一键应用。支持的默认画幅是横版 1920×1080，已针对手机缩图调整字号；竖版需要重新设计布局。

一起打磨

由沉默王二维护。欢迎通过 Issue 反馈具体知识点、画面问题和使用环境，通过 PR 提交改进。推广时可以直接分享本仓库和样片，建议附上使用的 Agent、模型、修改轮次与实际耗时，让效果有据可查。

作者自有代码、文稿和截图使用 MIT。内置花叔动画库保留其 MIT 许可及版本来源，字体遵循各自许可；详见第三方说明。Remotion 和其他安装依赖遵循各自许可，使用前请查看对应项目的当前条款。