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,说明编码代理应如何选择正确的文档。

工作原理(高层级)

  1. 选择风格 – 从 35 个配方卡中选择一个。每个卡片定义画笔设置、调色板、标志性过渡和短片“模板”。
  2. 编写规范 – 对于解说视频语法,你提供一个 JSON,列出旁白行、时间和可选资产(例如角色图像)。引擎将规范转换为帧精确的时间轴。
  3. 渲染 – 使用提供的 Python 入口点(scripts/engine/render.py)运行所选场景或语法。脚本使用 uv 管理依赖、ffmpeg 进行视频编码,以及 Playwright Chromium 进行无头画布渲染。
  4. QA – 渲染后,qa.py 评估稳定性、每帧成本、动作平滑度和文本覆盖一致性。它可以由另一个代理运行以验证输出。
  5. 合成 – 生成的 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 驱动内容管道的交汇处。

相关

  • 项目
  • 项目
  • 项目
  • 项目