Rive CLI：在终端里用 RML 写动画，再交给 AI Agent 打磨
阅读时间: 大约 10 分钟
Rive CLI：在终端里用 RML 写动画，再交给 AI Agent 打磨
Rive 是一个面向 App 与游戏的交互式动画工具，长期以来它的创作环境是一个图形化的 Editor：设计师在画布上拖拽、做状态机、导出 .riv 给运行时。2026 年，Rive 官方推出了 Rive CLI——把整套创作链路搬进终端：不打开 Editor，在命令行里创建、预览、检查、发布 Rive 图形。它最值得注意的一点是：这个 CLI 从第一天起就是为”人描述需求、AI Agent 写场景”而设计的。本文基于 Rive 官方文档做一次拆解。
一、出发点：动画文件也想进版本控制
.riv 本质是二进制资源，设计师在 Editor 里做的动画，程序员很难像改代码那样 review、diff、回滚。当团队想把动画纳入工程化流程时，痛点很集中：图形资产和代码割裂、无法在 CI 里校验、也无法让 AI 工具直接参与修改。
Rive CLI 的思路是把项目变成一个纯文本文件夹：场景用一种叫 **RML（Rive Markup Language，Rive 标记语言）**的文本格式描述，脚本、着色器、图片、字体按扩展名散落其中，CLI 负责把它编译成 .riv。这样动画就能和代码一起进 Git、一起 review，也能被 AI Agent 直接读写。
二、它能做什么
官方把 CLI 的能力归纳为几点：
- 用 RML 构建完整场景：CLI 解析 RML，编译出本地预览，并能从中构建
.riv资源； - 检查产物：确认场景能编译、查看它实际包含什么、查询 Rive 对象模型里的任意类型；
- 与编码 Agent 配对：新项目自带一份 Agent 说明文档，Agent 据此学会查资料、自查对错；
- 无窗口渲染与测试：把帧捕获成图片、用模拟输入和数据驱动场景、跑脚本测试；
- 进版本控制：项目是文本和资源的文件夹，能和代码一起 diff、review；
- 对接 Rive 账户文件：从账户下载、
rive push回传、rive pull拉取 Editor 端改动。
最基础的两条命令：
rive create myproject # 脚手架一个项目
rive myproject # 打开预览窗口，编辑时自动重建第二条命令会打开一个本地预览窗口并监听目录，保存任意文件即重建重载，产物写到 myproject/build/myproject.riv——这正是运行时可以加载的文件。
三、项目结构：一个文件夹就是一个工程
rive create myproject 会生成：
rive.yaml：项目配置，默认开启构建日志，其余字段可选；AGENTS.md：写给编码 Agent 的说明，告诉它怎么查 Rive 对象模型、怎么自检；.gitignore；scene.rml：场景文件，初始内容等价于 Editor 新建文件时的那一帧——一个画板（artboard）、一条时间线（timeline）、一个加载即播放的状态机（state machine）。你加一个形状、打个关键帧，就能直接动起来，无需额外配置。
文件夹里其余文件按扩展名自动被拾取：.luau 脚本、.wgsl 着色器、图片、字体。这意味着动画工程的组成部分和一个普通前端项目几乎没区别。
四、从已有 Editor 文件迁移
如果动画已经在 Rive Editor 里做了一半，不必从零开始：在 Editor 里导出一个 .rev 文件，然后：
rive create myproject --from-rev=myfile.revCLI 会把 .rev 拆解成 scene.rml，每个脚本、着色器、资源各自成文件，目录结构对齐 Editor 资产面板。之后它就是一个普通 CLI 项目了。
五、安装与登录：本地可离线，发布才需账号
CLI 运行在 Apple Silicon macOS、Linux x86_64 和 Windows 上。安装方式包括官方安装脚本、Windows PowerShell 一行命令、以及 Homebrew Cask。装完跑 rive doctor 自检。
关键的权限模型很清晰：
- 本地创建、预览、构建不需要登录，登出、断网都能用；
- 需要登录（
rive login）的是--publish（通过 Rive API 签名文件）和--rev（导出可在 Editor 打开的文件）； - 含脚本、面向 Web 的文件必须用
--publish构建，未签名脚本会被 CDN 和 Web 运行时拒绝；不含脚本的文件不受影响； - 在项目绑定到 Rive 账户里的文件之前，
--publish产物会带水印；绑定靠rive push，而官方标注该能力”coming soon”。在此之前，--once可写出不带水印的本地构建。
也就是说，今天免费能白嫖到的是”本地开发+预览+构建”这一段；无水印发布到 Web 还需要等 rive push 落地。
六、为什么说它是”Agent 优先”
Rive CLI 最反直觉的设计，是新项目默认就带一份 AGENTS.md。官方的原话工作流是：你描述想要的图形，编码 Agent 用 RML 写出场景，你在本地预览窗口里看着结果成形并随时纠偏。RML 是文本、对象模型可被查询、--verify 能无副作用地校验编译、帧能被捕获成图——这些原语组合起来，正好让 Agent 可以”写一段、编一段、看一段”地自查，而不是盲写一个二进制动画。
这和当前”AI 写代码”的主流趋势一脉相承：凡是能被文本描述、能被编译器/运行时验证的东西，都在被改造成 Agent 可操作的接口。Rive 选择把动画这种过去高度依赖图形工具的资产也文本化，本质上是在给 Agent 开一扇操作设计资产的门。
七、客观分析：优势与边界
优势：
- 把二进制动画变成文本工程：场景可 diff、可 review、可进 CI，对工程团队友好；
- Agent 原生：
AGENTS.md+ RML +--verify+ 帧捕获，构成了 Agent 闭环所需的全部反馈原语； - 离线可用：本地开发不强制登录、不强制联网；
- 与 Editor 双向打通：
.rev导入、push/pull同步，不抛弃已有设计资产。
边界与存疑：
- 版本仍早期：
rive push标注 coming soon，无水印 Web 发布目前仍带水印； - RML 生态尚新：作为一门新标记语言，第三方资料、踩坑经验还很少，学习曲线要靠官方文档和 Agent 兜底；
- 图形化编辑仍不可替代：复杂的视觉设计、贝塞尔调形、交互微调，CLI/RML 未必比 Editor 高效，它更适合”程序化生成、Agent 协作、批量修改”而非精修逐帧美术；
- 数据多为官方口径：性能与工作流优势目前来自 Rive 自述，缺少独立第三方评测；
- 平台覆盖面：官方列了 macOS Apple Silicon、Linux x86_64、Windows，对 Intel Mac 等旧架构未明确承诺。
八、谁该关注
- 已经在用 Rive 做 App/游戏动画、想把动画纳入 Git 与 CI 的前端/客户端团队；
- 日常让 AI 编码助手干活、希望它能直接生成和修改 Rive 动画的开发者；
- 想程序化批量产出动画状态机、而非手点 Editor 的工具链开发者。
如果你的动画主要由设计师在 Editor 里精雕细琢、且几乎不需要程序化改动，CLI 短期内未必比 Editor 顺手；但在”动画要进工程流、要和 Agent 协作”这条线上，Rive CLI 是一个方向明确的早期信号。