alchaincyf/huashu-motion

选用指南

AI 根据 README 整理 · 2026/10/18 22:46:31

使用方式

通过 Agent Skills 协议安装，支持 Claude Code、Codex 等代理，也可通过命令行工具 om 使用。

查看 README 依据

<img src="docs/media/deepseek-flash.gif" alt="DeepSeek V4.1 Flash做的动效片：鲸鱼logo、MOTION、MASK、GLITCH，一个圆点贯穿全片" width="100%" /> 这支22秒的动效片，是把Claude Code背后的模型换成DeepSeek V4.1 Flash（1017版）做的。中间我给了三轮意见（比如加上DeepSeek的鲸鱼logo、删掉几个镜头），带配乐和音效，前后不到半小时，按当时的价格花了1块9毛5（缓存命中率99.4%）。统一的配色、贯穿全片的那颗圆点、卡在124BPM上的配乐，是skill带出来的，我一句都没提过。方法写进了skill，便宜的模型也能拍出像样的片子。 --- ## 安装 ### 方式一：跟你的agent说（推荐） ``` 帮我安装huashu-motion这个skill（github.com/alchaincyf/huashu-motion），装好后跑一遍demo ``` ### 方式二：一行命令 ```sh npx skills add alchaincyf/huashu-motion ```

[skills](https://github.com/vercel-labs/skills)会认出你在用的agent，把skill放进对应目录；要指定的话加`-a claude-code`、`-a codex`等参数。 Claude Code、Codex、WorkBuddy、Grok Bot、Muse、Dots等产品都能跑；它遵循[Agent Skills](https://agentskills.io)协议，支持skill的agent都能装。 ### 方式三：克隆整个仓库 <details> <summary>展开查看</summary> ```sh git clone https://github.com/alchaincyf/huashu-motion.git ln -s "$PWD/huashu-motion/skills/huashu-motion" ~/.claude/skills/huashu-motion # Codex换成~/.codex/skills/ ``` skill里的`bin/om`会直接调用仓库里的命令行工具，改仓库就是改skill，本机只有一份。 </details> ### 需要什么 - Node 22以上。 - Chrome（或Chromium、Edge）：截帧、检查、导出都用你电脑上已经装好的浏览器，不额外下载渲染器。

部署要求

需要 Node 22 以上、Chrome（或 Chromium、Edge）和 FFmpeg；可选真乐器采样（约55MB）和 Kokoro 口播（需 uv 和 Python 3.12）。

查看 README 依据

[skills](https://github.com/vercel-labs/skills)会认出你在用的agent，把skill放进对应目录；要指定的话加`-a claude-code`、`-a codex`等参数。 Claude Code、Codex、WorkBuddy、Grok Bot、Muse、Dots等产品都能跑；它遵循[Agent Skills](https://agentskills.io)协议，支持skill的agent都能装。 ### 方式三：克隆整个仓库 <details> <summary>展开查看</summary> ```sh git clone https://github.com/alchaincyf/huashu-motion.git ln -s "$PWD/huashu-motion/skills/huashu-motion" ~/.claude/skills/huashu-motion # Codex换成~/.codex/skills/ ``` skill里的`bin/om`会直接调用仓库里的命令行工具，改仓库就是改skill，本机只有一份。 </details> ### 需要什么 - Node 22以上。 - Chrome（或Chromium、Edge）：截帧、检查、导出都用你电脑上已经装好的浏览器，不额外下载渲染器。

- FFmpeg：导出视频、合成配乐要用。 - 真乐器音色（可选）：想要三角钢琴、弦乐、鼓组，让agent跑一次`om samples build`，下载约55MB的免费采样（CC0和CC-BY授权）；不跑就用合成音色。 - 口播（可选）：macOS的系统音色不用装；想用Kokoro念中文稿，第一次用时会给出一行安装命令（要uv和Python 3.12，模型约325MB）；逐字对齐要装whisper-cli（`brew install whisper-cpp`）。 缺什么跑`om doctor`就知道，这些都可以直接让agent帮你装。目前只在macOS上实测过。Codex的沙箱会拦本地预览和浏览器，遇到时手动批准一下。 --- ## 能做什么 装好以后，直接跟agent说： | 你说 | 它做 | |---|---| | 「用huashu-motion给我的产品做一支30秒的发布片，官网是xxx.com」 | 先读产品，出三个方向的关键帧给你挑，写节奏单，再写片、作曲配乐，打开编辑器等你 | | 「把data/funnel.csv做成30秒解说，讲清楚为什么注册率翻倍了」 | 按数据讲故事：先轴、后数据、只标一件事，数字变成可以直接改的输入框 |

已知限制

它听不见，无法检查配乐效果；不会生成真人和实拍，画面全由代码绘制；效果与所用模型有关，不同模型品味有差异。

查看 README 依据

| 方法文档（导演、节奏、颜色、声音、口播、产品演示、验收……） | `skills/huashu-motion/references/` | ``` huashu-motion/ ├── skills/huashu-motion/ # skill本体：SKILL.md、方法文档、运动语言库、示范谱、经验 ├── cli/ # om命令行：新建、编辑器、收件箱、配乐、口播、检查、渲染、导出 ├── runtime/ # 片子里用的OM.*小工具，和逐帧渲染的引擎 ├── studio/ # 浏览器里的编辑器 ├── templates/ # 10个起步模板 ├── fonts/ # 随附的开源字体 ├── examples/ # 样片（om demo打开的那支） └── test/ # 测试 ``` --- ## 诚实边界 - 它听不见。agent靠谱面、能量曲线和频谱图检查配乐，最后一耳朵还得是你的。 - 它不会凭空生成真人和实拍。画面全是代码画的；要真人、实拍，用你自己的素材，它负责合成和包装。

- 效果跟模型有关。我主要在Claude Code里用Opus 5.5；DeepSeek V4.1 Flash也能做得不错，但不同模型的品味差别是真实存在的。 - 要能跑命令的环境。预览和导出在本机跑，需要Node、Chrome和FFmpeg。 --- ## 背后的故事 2026年10月8号，Anthropic发布了Claude Motion，让Claude用代码把报告、图表、产品讲解做成短动画，可以指着画面改，发布时只在Team和Enterprise上beta。 今年4月Claude Design出来的时候，我把它的核心能力逆向成了skill，就是后来的[huashu-design](https://github.com/alchaincyf/huashu-design)。Motion发布以后，我让Claude Code开工，要求就一句： > 我们的skill需要能够完整复刻claude motion的能力，并且要强很多！ 第一天做出来的东西，我看着都很无聊：编辑器、版本管理、一百多项测试都有了，一个19秒的3D城市样片，运镜很平稳，也就代表着很平庸。让Claude自己把项目审一遍，它的结论是：做出了一个很会证明自己没撒谎的工程，却还没有一个让人想转发的作品。当天推倒重来。