alchaincyf/huashu-art-motion
艺术动画skill:35种艺术风格、9种解说语法,用代码让画动起来。
huashu‑art‑motion – 代码驱动的艺术动画
它是什么 – 一个代码、数据和工具的集合,让 编码代理 能够生成各种艺术风格的短帧精确动画剪辑。此仓库包含:
| 组件 | 你得到的内容 |
|---|---|
| 35 种风格“配方卡” | 参数集、动作母题和过渡定义,涵盖从洞穴壁画到梵高、包豪斯、8‑bit、蒸汽波等风格。 |
| 引擎与库 | 一个自包含的动画引擎(scripts/engine/),包含画笔、渲染器、后处理、相机辅助、音频合成模板等。 |
| 场景脚本 | 每种风格一个可立即运行的场景(scripts/engine/scenes/)。 |
| 解说视频语法 | 9 个 JSON 驱动的“语法”模板(Kurzgesagt、Vox、白板、故事时间、动态文字、3Blue1Brown、演示 UI、金融图表、主持人),将旁白规范映射到计时剪辑。 |
| 长滚动演示 | 一个骨架,角色走过连续的画作,包含三个示例世界(埃及壁画 → 莫奈 → 8‑bit)。 |
| 工具脚本 | breakdown.py(将参考视频转换为剪辑网格 + 动作热图)、qa.py(自动质量指标)、音频生成辅助、字体子集化等。 |
| 文档 | 12 个方法指南 markdown 文件、风格卡 markdown、语法规范,以及一个 SKILL.md,说明编码代理应如何选择正确的文档。 |
工作原理(高层级)
- 选择风格 – 从 35 个配方卡中选择一个。每个卡片定义画笔设置、调色板、标志性过渡和短片“模板”。
- 编写规范 – 对于解说视频语法,你提供一个 JSON,列出旁白行、时间和可选资产(例如角色图像)。引擎将规范转换为帧精确的时间轴。
- 渲染 – 使用提供的 Python 入口点(
scripts/engine/render.py)运行所选场景或语法。脚本使用 uv 管理依赖、ffmpeg 进行视频编码,以及 Playwright Chromium 进行无头画布渲染。 - QA – 渲染后,
qa.py评估稳定性、每帧成本、动作平滑度和文本覆盖一致性。它可以由另一个代理运行以验证输出。 - 合成 – 生成的 MP4(或带 alpha 的 PNG 序列)可以拼接在一起、添加到配音管道,或用作更大制作中的视觉元素。
快速开始(快速步骤)
# 1. 克隆并安装依赖
git clone https://github.com/alchaincyf/huashu-art-motion.git
cd huashu-art-motion
uv sync # 安装 uv、ffmpeg、playwright 等
uv run --with playwright playwright install chromium
# 2. 渲染梵高风格的单帧
uv run --with playwright python scripts/engine/render.py \
--solo 09_postimp --stills 0.3 --out demo_van_gogh.png
# 3. 渲染完整的解说剪辑(金融图表语法)
uv run --with playwright python scripts/engine/render.py \
--spec scripts/engine/examples/t3_finance_chart.json \
--out finance_chart.mp4
--solo 标志选择场景;--spec 指向语法 JSON。
谁可能使用这个?
- 内容创作者,想要程序化、风格一致的动画用于 YouTube 解说视频。
- AI 代理(例如 Claude、GPT‑4o),可以被赋予任务,例如 “为猫走过画布制作一个 5 秒的梵高过渡”,然后调用适当的配方和渲染脚本。
- 研究人员,探索程序化艺术生成、风格转换管道或自动化视频 QA。
- 教育工作者,展示代码如何驱动跨艺术史时期的视觉叙事。
限制与范围
- 仓库仅提供代码和数据;你必须提供任何配音音频或自定义角色资产。
- 渲染依赖无头 Chromium 画布;性能取决于你的硬件。
- 第九个“主持人”语法是参考实现,期望你提供自己的角色帧。
许可证
- 核心代码和文档:MIT(可自由修改和重新分发)。
- 字体:各种 SIL OFL 许可证。
- 笔画数据:Arphic Public License。
- 作者的卡通头像和演示视频图像仅供演示,不包含在 MIT 许可中。
TL;DR
huashu-art-motion 是一个技能包,将编码代理的高层级描述转换为 35 种艺术风格的动画剪辑,包含现成的场景脚本、风格配方和解说视频语法。它是一个真正的、以代码为中心的项目,位于生成艺术、程序化动画和 AI 驱动内容管道的交汇处。
相关
- 项目
- 项目
- 项目
- 项目