huashu-motion：让编码 Agent 写代码出片，还能指着画面改

让 Agent 做视频，常见做法是调视频生成模型：按次计费，画面不由你控制，改一个字就得重抽。huashu-motion 选了另一条：agent 用 GSAP、Canvas、Three.js 或 SVG 把整支片子写成一个 index.html，每一帧只由代码和时间决定，配乐在本机现场合成。仓库 2026-10-18 创建，MIT 许可，截至 2026-10-19 有 226 颗星。

核心功能

• 一句话到成片：对 Claude Code、Codex 等 agent 说「给我的产品做个 30 秒发布片」，它会先读你的产品，给出三个方向的关键帧让你挑，再写节奏单、写片、作曲，最后在浏览器里打开编辑器等你。
• 指着画面改：编辑器里按 C 点中画面元素并写下意见，评论会带上时间点、场景、点中的元素和它在源码里的位置；agent 放大看你点的那一小块，只改那一处，预览停在原位置刷新。每一版都留着，可随时撤回。
• 先写谱再拍片：作曲家模式下 agent 先写一份 ABC 记谱法的谱，谱里的场景标记对齐画面切点，再由钢琴、弦乐和鼓组采样演奏；画面元素落地的帧配一个音效。配乐全部本机生成，不调用收费接口。
• 导演规则来自实测：作者用 FFmpeg 量了 21 支真实发布片的切点、节拍、响度和能量曲线，又拆了 142 支高互动片子，整理出 20 种运动语言。规矩是硬的：3 秒内要有钩子，中段要有一次爆发，最响那一下之前先停一拍。
• 交付前自动挑错：om check 在渲染前查脚本、缺失文件、违规动画写法，并抽帧检查被裁切、被遮挡、对比度不足的文字；om qa 查成片里一闪而过的单帧、没有运动的空档和硬切。

典型使用场景

• 小团队做产品发布片：没有预算请动效团队，又需要一支 30 秒的片子放在官网首页或 Product Hunt 页面上。
• 数据解说视频：把 csv 交给它，按「先轴、后数据、只标一件事」的结构讲清楚指标变化，数字会变成可直接编辑的输入框。
• 已有口播录音的包装：逐字对齐，画面落在说到的那个词上，自动出字幕，配乐在说话时自动让位。
• 要能二次编辑的交付物：产出是网页不是渲染好的视频，能带进仓库、能 diff、能交给下一个 agent 继续改。

边界要提前知道：目前只在 macOS 上实测过，需要 Node 22+、Chrome 和 FFmpeg；真乐器采样是可选项，不下载就用合成音色；Codex 的沙箱会拦截本地预览和浏览器，需要手动批准。它不生成写实画面——镜头由代码画出来，需要实拍或摄影级画面时它替代不了视频模型。

快速上手

npx skills add alchaincyf/huashu-motion

装好后对 agent 说「用 huashu-motion 给我的产品做一支 30 秒的发布片，官网是 xxx.com」。运行时可以用 om doctor 检查环境缺什么，om studio 打开编辑器，om render 导出 MP4、MOV（透明）、WebM 或 GIF。

小结

huashu-motion 适合想把发布片纳入代码工作流的团队：片子是代码，改一处只改一行，配乐和音效也在本地生成，成本和可复现性都更可控。代价是它画不出实拍质感，而且依赖本机环境（Chrome、FFmpeg、Node 22+），首次使用还要下载浏览器采样包。项目和站内写过的 animate 同属「代码逐帧画视频」路线，区别是 huashu-motion 把编辑器和 agent 的回改闭环做成了核心功能。仓库为 MIT 许可，主要语言 JavaScript，stats checked 2026-10-19。