cth9191/animate

Animate – Claude Code 的程序化视频创作

简介 – 这是一项 Claude Code 技能，让您能完全通过代码生成短篇、风格化的动画视频。您通过类似聊天的方式输入提示词，回答几个问题，系统就会建立确定性的逐格动画，并通过无头浏览器进行渲染，最后输出 MP4 文件。

运作方式 – 工作流程分为五个步骤：

1. 输入 (Intake) – 您告诉系统主题、期望格式、语音、风格（内置风格之一或您提供的自定义参考）。
2. 故事检查 (Story check) – 系统会产生节拍表，供您核准或编辑。
3. 视觉检查 (Look check) – 所选风格会产生几张全尺寸关键帧供您确认。
4. 分镜脚本 (Storyboard) – 每个节拍都会变成带有声音与转场的关键帧；您可以核准每个画面。
5. 构建与交付 (Build & delivery) – 核准后的画面会进行动画制作、渲染为 MP4，并呈现一系列质量检查指标（节拍剪辑、响度、主体锚定等）供最终调整。

内置风格 – 仓库随附八个插件风格文件夹，每个都提供一套绘图工具：

• cut paper、crosshatch、riso、sketchbook、math (类似 Manim)、pixel、isometric 以及一个用于存放从参考媒体衍生的 custom look 的插槽。

自定义风格创作 – 提供视频、静态图片或网页；工具会分析调色盘、线条粗细、纹理与节奏，产生 1-2 张匹配的帧供核准，然后将新风格保存于 styles/<name>/ 以供重复使用。

核心组件

• 故事语法 (grammar/)：八个短篇模板（历史、任务等），用于规范结构、色彩语义与节奏。
• 工具包 (kit/)：种子随机性、摄像机辅助工具、通过风格钩子绘图的渲染器、分镜引擎、合成器以及针对手机播放的响度处理。
• 工具 (tools/)：
  • build.mjs – 从作品、工具包与风格组装成一个独立的 index.html。
  • export.mjs – 将帧转为 WAV + 分轨，再通过 ffmpeg 转为 MP4。
  • voice.mjs – 生成脚本、录音（ElevenLabs 或本地麦克风），并使用 faster-whisper 将文字与时间戳对齐。
  • beats.mjs、compare.mjs、measure/refs.mjs 等，用于音频节拍对应、参考比较与质量检查。
• 制作规则 (craft.md) – 在构建系统过程中收集的实用技巧。
• 配音与音乐 – 自动脚本撰写、选用的 ElevenLabs TTS、本地录音以及节拍同步配乐（或您可提供自己的音轨）。
• 产品整合 – 可将您的网站截图或 Logo 插入动画中。
• 多格式输出 – 自动产生 9:16、1:1、4:5 与 16:9 格式。
• 并行构建 – 大型作品会被拆分为场景文件，由不同代理程序处理后再拼接在一起。

未来工作 – 计划开发基于 WebGL 的动态设计风格，包含光线步进 (ray-marching)、子帧模糊与泛光效果；现有的导出管线已支持 GPU 渲染。

安装 – 需要 Claude Code、Node 18+、Playwright (含 Chromium) 以及 ffmpeg。请安装 Playwright (npm i -g playwright && npx playwright install chromium)，然后通过 Claude 的插件管理器新增技能，或将文件夹复制到 ~/.claude/skills/animate/。

典型用法 – 在 Claude 聊天中，您可以输入如下指令：

/animate a 45-second history of the bicycle, cut paper
/animate how a hash map works, in the math style
/animate a short about our API in the style of these screenshots: ./refs/

产生的作品会出现在 pieces/<name>/ 下；您也可以手动执行底层工具。

授权 – MIT。

---

Animate 是一个真正的开源项目，结合了生成式 AI（脚本撰写、语音合成、节拍检测）与程序化图形，提供了一种从代码制作风格化解说视频的统包方案。