Rive 新推出的 CLI 让编程代理能够以项目文件的形式处理交互式图形。代理可以编写 Rive 标记语言（RML）、Luau 脚本和着色器，然后调用 CLI 编译、检查、测试并渲染结果。用户可以观看本地预览并修改设计。Rive 员工将 CLI 介绍为一项9 月 11 日发布的技术预览；Rive 下载页面（9 月 27 日查看）将其列在早期体验栏目下。
本清单依据Rive 文档编写。BIG CHANGE 仅审阅了文档；我们没有安装 CLI、构建文件或测试代理生成的图形。Rive 的视频演示展示了预期的人机协作流程。
主要变化
- 发生了什么变化：Rive 场景现在有一条面向编程代理的文本工作路径。代理可以在项目文件夹中编辑 RML，再由 CLI 编译为
.riv，供运行时使用；或生成.rev，供在编辑器中继续处理。 - 为何重要：设计师以及前端或游戏开发者可以像审阅其他项目文件一样检查源代码改动，并在迭代过程中使用 CLI 检查。把素材用于产品前，他们仍需要判断渲染出的设计和交互是否符合预期。
- 接下来关注什么：将本地原型部署到网络是一项单独的决定。包含脚本的文件需要经过签名的
--publish构建；一个干净的.riv也需要绑定到账户文件，并使用 Cadet 或更高级别的工作区。部署前应核实这些条件和最终图形。
文档列出的操作清单
- 检查访问权限并安装。Rive 列出的支持平台包括 Apple 芯片的 macOS、Linux x86_64 和 Windows。其入门指南为 Windows 和 macOS/Linux 分别提供安装说明；Windows 用户应遵循该页面当前的 Windows 指引。安装后运行
rive doctor。命令参考还列出rive --version；由于这是预览软件，请记录实际安装的版本。Rive 在 9 月 11 日的公告中称，CLI 在预览期间免费且没有使用限制。这项有日期的声明并不能证明 CLI 永远免费。当前方案表涉及 Rive 账户和内置编辑器代理，因此发布前应核对当前条款。 - 创建文本项目并打开预览。
rive create myproject会创建scene.rml，rive.yaml以及代理指引文件位于AGENTS.md和CLAUDE.md，同时包含一个.gitignore.在同一终端中运行rive myproject。Rive 表示，该命令会监视文件夹，在保存时重新构建，并写入myproject/build/myproject.riv。起始场景包含画板、时间轴和状态机，但尚未绘制任何内容。初始预览只是一个深色矩形。 - 把项目文件夹和具体设计任务交给编程代理。Rive 的AI 代理指南列举了 Claude Code、Cursor 等代理，以及其他能够读写文件并运行 shell 命令的工具。生成的指引会告诉代理如何使用
rive docs和rive schema来查找受支持的对象和属性。RML 是 XML：元素代表 Rive 类型，属性代表其属性，嵌套关系用于关联对象。代理还可以编辑.luau脚本、.wgsl着色器和项目素材。应要求代理分阶段工作，以便在预览更新时调整布局和行为。 - 检查构建结果及其内容。让代理运行
rive myproject --verify；该命令会编译项目，但不会写入.riv，并运行rive inspect myproject --summary，以报告问题和对象数量。要查看完整解析后的场景，rive inspect myproject --json文档还提供了相应命令。如果项目需要生成可分发的本地文件而不打开预览，rive myproject --once会写入未经签名的.riv。这些检查可以发现编译错误以及场景中缺少或意外出现的对象。Rive 的 RML 指南提醒，构建成功并不能证明图形的外观或行为符合预期。 - 捕捉关键状态。
rive myproject --screenshot=out.png可以在不打开窗口的情况下渲染 PNG。Rive 的示例使用--advance=1s指定动画开始后的帧，--viewport=390x844指定布局尺寸，--data=battery/level=100提供绑定数据，并--pointer=click@120,60 --advance=20模拟点击。参数值和坐标应根据自己的场景设定。比较不同状态和视口尺寸下的截图，然后亲自检查。未提供--advance时捕获的是创作时的静止姿势，不一定是动画的开场帧。 - 如果项目包含脚本测试，就运行这些测试。
rive myproject --test会运行项目的 LuauTests测试脚本。Rive 文档介绍了--verify --format=json和--test --format=json，用于自动化检查；构建或测试失败时会返回非零退出码。代理可以根据这些报告修改源文件。测试只能覆盖实际编写的断言，因此还要检查测试未覆盖的交互。 - 本地原型准备就绪后，再选择账户工作流程。一个
.riv是运行时素材；一个.rev可在 Rive 编辑器中打开以供编辑。Rive 表示，本地创建、预览、验证、测试和截图功能无需登录，也可离线使用。rive login以下操作需要登录：--publish、--rev、rive push、rive pull以及导入远程账户文件。若要从编辑器导出的备份开始，rive create myproject --from-rev=myfile.rev无需登录。若要从账户文件开始，请在登录后使用rive create myproject --from-remote-file。后者会将项目与该文件绑定：rive push myproject会上传一个修订版本；rive pull myproject会从编辑器下载改动，并覆盖本地场景、脚本和素材。拉取前请检查本地改动。 - 发布前检查签名和导出限制。
rive myproject --publish会写入经过签名的.riv，并要求登录。Rive 表示，Web 运行时及其 CDN 会拒绝未签名的脚本，因此用于 Web 的含脚本文件必须走这一路径。--publish可能会添加水印。Rive 的命令参考指出，无水印的.riv要求项目通过rive push与账户文件绑定，并且该文件须位于 Cadet 或更高级别的工作区中。即使场景不含脚本，也可能触发水印条件。--rev=<path>还需要登录，可与--once或--publish组合使用；它生成的是编辑器文件，不能代替运行时文件。部署前请核对当前账户方案和实际导出结果。
Rive 还在编辑器中内置了 AI 代理。可从编辑器侧边栏打开该功能；它受编辑器方案和 AI 点数条款约束。本指南介绍的是将编程代理与 CLI 配合使用的文件夹和终端工作流程；两种代理使用途径的界面和计费条件不同。
