motion-anything 是一个本地优先、对话原生的 AI 动效引擎：用一句话描述感觉，你的 AI 就能交付带动效的网页和 launch 视频，还能在跑着的页面上逐组件精修动效。最好的地方是——它零 npm 依赖，不需要npm install，一条命令就能在本地跑起来。本文就是一份面向新手的本地快速开始教程，全程只需 3 分钟。

开始之前：你需要准备什么？

运行 motion-anything 本地版，只需要两样东西，门槛非常低：

引擎会自动扫描你系统PATH上的 CLI，装过哪个就能用哪个；一个都没有？稍后用 BYOK（自带 API Key）模式也行，详见下文。

第 1 步：克隆仓库到本地

打开终端，执行：

git clone https://gitcode.com/gh_mirrors/mo/motion-anything cd motion-anything

克隆完成后，整个项目就是几个纯文件目录，核心结构长这样：

• cli/bin/motion.js —— 服务端 + 命令行入口，一个文件搞定
• app/index.html —— 完整客户端（工作台、编辑器、动效库）
• recipes/ —— 403 个动效配方的库
• skills/ —— 可移植的 agent 技能

第 2 步：1 条命令启动，零 npm 依赖

node cli/bin/motion.js serve 4399 # 打开 http://localhost:4399

就是这一条命令，没有npm install，没有构建步骤，零 npm 依赖——项目刻意做到"跑起来很无聊"。启动成功后终端会打印访问地址并自动打开浏览器：

✨ motion-anything is running: http://127.0.0.1:4399/ Press Ctrl+C to stop.

💡 端口参数可省略，node cli/bin/motion.js serve会使用默认端口4321，对应访问http://localhost:4321。端口被占用时换个大数即可，比如serve 5000。

第 3 步：选择一个 AI 引擎（只需一次）

打开首页后，去设置 → 执行模式（Execution mode）选引擎即可，提示词全程跑在你自己的 agent 上，密钥不离开本机：

• 自动检测本地 CLI：系统上装了哪个受支持的 CLI 就用哪个，开箱即用；
• BYOK 模式：填入 Anthropic / OpenAI / Google 的 API Key 直连 API，适合还没装任何 CLI 的机器。

跑起来之后：生成你的第一个动效页面

首页就是创作台：输入一句话（比如"液态金属感的产品背景"），选一套设计系统（内置 59 套品牌包）和动效强度（Subtle → Cinematic），点击生成。生成的页面会自动保存到 app/projects/ 目录，磁盘就是真实数据源。

生成完还不是终点——进入工作台，你可以在正在运行的页面上点击任意组件，给它加触发器、预设或 6 轨关键帧动画，改完直接写回文件：

闲逛的时候不妨打开动效库——403 个策展配方全部带实时预览，可按意图搜索，每个配方都自带"何时不要用"的克制声明：

motion 命令行速查：4 个子命令

除了serve，CLI 还内置了几个实用命令（入口同样是 cli/bin/motion.js）：

快速开始常见问题

• node -v显示低于 18？升级 Node.js 即可，这是唯一的硬性版本要求。
• 提示端口被占用（Could not start server on port…）：换一个端口参数重启，例如serve 5210。
• 找不到任何引擎？安装一个受支持的 CLI 并让它进入PATH，或在 设置 → 执行模式 里配置 BYOK API Key。
• 怎么停止服务？在终端按Ctrl+C即可。

写在最后

回顾一下，motion-anything 的本地快速开始就三步：克隆 →node cli/bin/motion.js serve→ 浏览器打开。零 npm 依赖、无构建、本地运行、无水印、无按次收费，Apache-2.0 开源协议。接下来如果想了解配方的组织规范，可以看 MOTION-SPEC.md 和 AGENTS.md；完整中文说明以 README.zh-CN.md 为准。现在就可以打开终端，让万物动起来 🚀