关键字 · 宣传片
一句话让编程 AI 做产品宣传片:开源技能 huashu-motion 用代码写片、自己作曲,哪一帧不满意就点哪一帧改
开源技能 huashu-motion:一句话让 Claude Code 读你的产品、出三个方向、用代码写片配乐,再在浏览器里点帧修改。安装步骤和它做不到的地方。
如果你做过产品发布视频,就知道最累的是什么:一帧一帧地调动画、找配乐、卡节奏,改一处要重新导出一遍。视频里介绍的 huashu-motion,是独立开发者花叔开源的一个技能(skill),装进 Claude Code、Codex 这类编程 AI 以后,你用一句话描述需求,它就读你的产品、给你看三个方向的关键帧、用代码把片子写出来、自己作曲配乐,再在浏览器里打开一个编辑器等你提意见。
README 的口号是「一键直出商业级产品宣传片。」这是项目自己的宣传语,不要理解成「说一句话就能拿到成片」。README 自己也写得很清楚:示范片要么是第一条消息就把需求讲完整,要么是有人一轮一轮给意见;作者自己的宣传片花了一个半小时、改了十个版本。
它采用 MIT 许可,当前版本是 0.3.1,作者花叔也是「小猫补光灯」的作者。项目没有单独的官网,完整的示范片(带声音的 MP4)放在 GitHub 的 Releases 页面。这篇指南会讲清楚它是什么、适合谁、要准备什么、怎么一步步装好用起来,以及它做不到的地方。
01它是什么,适合谁
简单说,huashu-motion 让你的编程 AI 变成一个会做动效的导演。它遵循 Agent Skills 协议,README 列出能跑的产品包括 Claude Code、Codex、WorkBuddy、Grok Bot、Muse、Dots 等,支持 skill 的 agent 都能装。
- 做产品发布片:给它官网地址,它读产品、出三个方向,再写片配乐;
- 做数据解说:比如把一份 CSV 做成 30 秒的解说,数字会变成可以直接改的输入框;
- 给口播视频加包装:名字条、数字卡、关键词花字、章节卡,导出带透明通道的叠层,直接拖进剪映或 Premiere;
- 用你自己的录音配旁白:逐字对齐,画面落在说到的那个词上,自动出字幕,配乐在说话时让位;
- 改成竖屏:复制一份 1080×1920 的版本,方便发短视频平台。
它适合会用命令行、已经在用编程 AI 的独立开发者、产品团队和内容创作者。如果你完全不碰终端,也可以直接跟 agent 说帮你装,但电脑上终究要能跑 Node、Chrome 和 FFmpeg。
02它是怎么做出一条片子的
每一支片子其实就是一个网页文件 index.html。画面用 GSAP、Canvas、Three.js、SVG 这些浏览器能画的东西写出来,不调用视频模型,每一帧只由代码和时间决定。所以片子可以反复修改、随时重新渲染,也没有私有格式。
- 导演规则,不是模板:作者量了 21 支真实发布片的剪辑、节拍、响度和能量曲线,又分析了 142 支高互动的发布片和动效片,整理成 20 种动效语言。每支片子先写一张节奏单:3 秒内有钩子,中段有爆发,最大的一下之前留一拍安静;
- 先写谱,再出画面:agent 用 ABC 记谱法写配乐,标记落在每个场景上;跑过一次 om samples build(约 55MB 的免费采样)以后用三角钢琴、弦乐和鼓组演奏,没跑就用合成音色。每个落点配一个音效,全部在本机生成,不用付费 API;
- 自己的渲染引擎:同时开多个 Chrome 实例,画面和声音并行编码。作者说在他 14 核的 Mac 上,30 秒的片子大约 12 到 15 秒渲染完,加动态模糊大约 1 到 1.5 分钟;
- 交付前自检:om check 检查脚本、文件、动效规则和被裁切遮挡的文字,om qa 检查单帧跳变、空镜和运动曲线。
内容方面,它带了 20 种动效语言、12 个起步模板(发布会、财经图表、动态文字、白板、拼贴风、3D 空间里的界面等)、23 个音效、12 类产品 × 3 种备用配乐方向,还有 27 款字体。
03最有意思的功能:点哪一帧,改哪一帧
片子写好以后,它会在浏览器里打开编辑器。你按一下 C,点中你不满意的那一帧,打字写要改什么。这条评论会带上时间点、场景、你点中的元素以及它在源码里的位置。agent 先看那一帧和那个位置的特写,只改那一处,用一句话回复你,预览会停在你刚才看的地方重新加载。
每个版本都会保留,⌘Z 可以撤回。标题、数字、颜色、停留时长这些,还会变成你可以自己直接改的输入框。
需要说明一点:README 里演示这个功能的动图,编辑器和终端是按真实界面重建的,代码细节是示意,只有那条评论是真实的。所以它不是原始录屏,实际界面可能略有不同。
04你需要准备什么
- 一个编程 AI:Claude Code、Codex 等,用你自己的订阅或 API。片子是 agent 写的,所以模型的费用由你自己的账号承担;
- Node 22 以上;
- Chrome、Chromium 或 Edge:截帧、检查、导出都用你电脑上已经装好的浏览器,不额外下载渲染器;
- FFmpeg:导出视频、合成配乐要用;
- 可选:真乐器音色,让 agent 跑一次 om samples build,下载约 55MB 的 CC0 和 CC-BY 采样;
- 可选:口播,macOS 的系统音色不用装;想用 Kokoro 念稿,要 uv 和 Python 3.12,模型约 325MB;逐字对齐要装 whisper-cli;
- 系统:目前只在 macOS 上实测过。
费用方面:技能本身是 MIT 开源,免费使用;配乐、音效和渲染都在本机完成,不用付费 API;真正花钱的是你用的模型。README 举过一个例子:用 Claude Code 跑 DeepSeek V4.1 Flash 做了一支 22 秒的片子,给了三轮意见,连配乐和音效不到半小时,当时花了 1.95 元(缓存命中率 99.4%)。这是作者自己的一次记录,你的花费会随模型和修改轮数变化。
05上手步骤
下面按 README 的安装方式和用法整理,几步就能跑起来。
- 第 1 步:安装技能:最简单的是直接跟你的 agent 说:帮我安装huashu-motion这个skill(github.com/alchaincyf/huashu-motion),装好后跑一遍demo。也可以在终端运行一行命令 npx skills add alchaincyf/huashu-motion,它会认出你在用的 agent,把技能放进对应目录;要指定的话加 -a claude-code 或 -a codex。第三种方式是克隆整个仓库,再把 skills/huashu-motion 链接进 agent 的技能文件夹。
- 第 2 步:检查环境:运行 om doctor,它会告诉你还缺什么,这些都可以直接让 agent 帮你装。如果你用的是 Codex,它的沙箱会拦住本地预览和浏览器,遇到时手动批准一下。
- 第 3 步:用一句话开工:直接跟 agent 说,例如:用huashu-motion给我的产品做一支30秒的发布片,官网是xxx.com。它会先读产品,出三个方向的关键帧给你挑,再写节奏单、写片、作曲配乐,最后打开编辑器。
- 第 4 步:在编辑器里点帧修改:看预览,哪里不对就按 C、点那一帧、写意见。想要更好的结果,第一条消息尽量把需求讲完整:片子给谁看、要传达哪几件事、多长、什么比例。之后再一轮一轮地给具体意见。
- 第 5 步:导出和分享:可以导出 MP4、MOV(透明底)、WebM、GIF,或者一个带播放器和源码的分享页;说一句「改成竖屏」就出 1080×1920 的版本。导出后 om share 会生成一个分享包:一张 10MB 以内的 GIF 和一份写好的发帖文案。4 秒以上的片子最后 1.2 秒会出现一行小字「Made with huashu-motion」,不想要的话跟 agent 说一声就能关掉。
06它做不到什么,用之前要知道的事
- 它听不见:agent 靠谱面、能量曲线和频谱图检查配乐,最后一耳朵还得是你的;
- 不会凭空生成真人和实拍:画面全是代码画的;要真人、实拍,用你自己的素材,它负责合成和包装;
- 效果跟模型有关:作者主要在 Claude Code 里用 Opus 5.5,DeepSeek V4.1 Flash 也能做得不错,但不同模型的品味有差别;
- 要能跑命令的环境:预览和导出都在本机跑,需要 Node、Chrome 和 FFmpeg,目前只在 macOS 上实测过;
- 示范片里的品牌:Grok Bot 和 Claude Duet 两支是粉丝自制,非官方;DeepSeek 那支用了 DeepSeek 的鲸鱼标志。这些都不代表 xAI、Anthropic 或 DeepSeek 认可或合作;
- 卡通形象不是 MIT:「豆豆花叔」这个角色是花叔的卡通形象,只用于演示这个项目,不在 MIT 授权范围内,别拿去做别的用途;
- 背景故事:README 提到作者是看到 Claude Motion 之后开始做的,这是作者自己的讲述。
07常见问题
问:要钱吗?
答:技能免费,MIT 开源。配乐、音效、渲染都在本机,不用付费 API;你要付的是自己 agent 所用模型的费用。
问:Windows 能用吗?
答:README 写的是目前只在 macOS 上实测过。只要能跑 Node 22、Chrome 和 FFmpeg,你可以试,但作者没有承诺。
问:能让它做真人出镜的片子吗?
答:它不会生成真人和实拍画面。你可以给它自己的素材,比如一条口播视频,它来做名字条、数字卡、花字这些包装,导出透明叠层。
问:片尾那行小字能去掉吗?
答:可以,跟 agent 说一声就关掉。
08相关链接
资料来源
下一个好用的工具是什么?
每条视频都有一篇完整详情。关注 @serrini666,第一时间看到新分享。