Markdown 版本

AI-translated from English; not yet reviewed by a fluent editor.

# Rive CLI 与编程代理实用指南

> 本指南介绍如何配合编程代理使用 Rive CLI 和 RML，以构建、检查和测试交互式图形，并说明账户、签名和导出方面的限制。

By BIG CHANGE Editorial

Published: 2026-09-27T00:12:27.556Z
Updated: 2026-09-27T00:17:31.324Z
Canonical: https://bigchange.ai/blog/rive-cli-rml-coding-agents-guide

![A designer holds a controller while viewing an orange jointed animation shape on a wall-mounted display, with a smaller screen of indented lines nearby.](https://bigchange.ai/api/media/file/rive-cli-animation-hero-v2.png)
AI-generated conceptual illustration by BIG CHANGE.

Rive 新推出的 CLI 让编程代理能够以项目文件的形式处理交互式图形。代理可以编写 Rive 标记语言（RML）、Luau 脚本和着色器，然后调用 CLI 编译、检查、测试并渲染结果。用户可以观看本地预览并修改设计。Rive 员工将 CLI 介绍为一项**9 月 11 日发布的技术预览**；[Rive 下载页面](https://rive.app/downloads)（9 月 27 日查看）将其列在**早期体验**栏目下。

本清单依据[Rive 文档](https://rive.app/docs/cli/overview)编写。BIG CHANGE 仅审阅了文档；我们没有安装 CLI、构建文件或测试代理生成的图形。Rive 的[视频演示](https://youtu.be/Y3E33otHeLE)展示了预期的人机协作流程。

## 主要变化

- **发生了什么变化：**Rive 场景现在有一条面向编程代理的文本工作路径。代理可以在项目文件夹中编辑 RML，再由 CLI 编译为`.riv`，供运行时使用；或生成`.rev`，供在编辑器中继续处理。
- **为何重要：**设计师以及前端或游戏开发者可以像审阅其他项目文件一样检查源代码改动，并在迭代过程中使用 CLI 检查。把素材用于产品前，他们仍需要判断渲染出的设计和交互是否符合预期。
- **接下来关注什么：**将本地原型部署到网络是一项单独的决定。包含脚本的文件需要经过签名的`--publish`构建；一个干净的`.riv`也需要绑定到账户文件，并使用 Cadet 或更高级别的工作区。部署前应核实这些条件和最终图形。

## 文档列出的操作清单

1. **检查访问权限并安装。**Rive 列出的支持平台包括 Apple 芯片的 macOS、Linux x86\_64 和 Windows。其[入门指南](https://rive.app/docs/cli/getting-started)为 Windows 和 macOS/Linux 分别提供安装说明；Windows 用户应遵循该页面当前的 Windows 指引。安装后运行`rive doctor`。命令参考还列出`rive --version`；由于这是预览软件，请记录实际安装的版本。Rive 在 9 月 11 日的公告中称，CLI 在*预览期间免费且没有使用限制*。这项有日期的声明并不能证明 CLI 永远免费。[当前方案表](https://rive.app/pricing)涉及 Rive 账户和内置编辑器代理，因此发布前应核对当前条款。
2. **创建文本项目并打开预览。** `rive create myproject`会创建`scene.rml`，`rive.yaml`以及代理指引文件位于`AGENTS.md`和`CLAUDE.md`，同时包含一个`.gitignore`.在同一终端中运行`rive myproject`。Rive 表示，该命令会监视文件夹，在保存时重新构建，并写入`myproject/build/myproject.riv`。起始场景包含画板、时间轴和状态机，但尚未绘制任何内容。初始预览只是一个深色矩形。
3. **把项目文件夹和具体设计任务交给编程代理。**Rive 的[AI 代理指南](https://rive.app/docs/cli/agents)列举了 Claude Code、Cursor 等代理，以及其他能够读写文件并运行 shell 命令的工具。生成的指引会告诉代理如何使用`rive docs`和`rive schema`来查找受支持的对象和属性。RML 是 XML：元素代表 Rive 类型，属性代表其属性，嵌套关系用于关联对象。代理还可以编辑`.luau`脚本、`.wgsl`着色器和项目素材。应要求代理分阶段工作，以便在预览更新时调整布局和行为。
4. **检查构建结果及其内容。**让代理运行`rive myproject --verify`；该命令会编译项目，但不会写入`.riv`，并运行`rive inspect myproject --summary`，以报告问题和对象数量。要查看完整解析后的场景，`rive inspect myproject --json`文档还提供了相应命令。如果项目需要生成可分发的本地文件而不打开预览，`rive myproject --once`会写入未经签名的`.riv`。这些检查可以发现编译错误以及场景中缺少或意外出现的对象。[Rive 的 RML 指南](https://rive.app/docs/runtimes/advanced-topic/rml)提醒，构建成功并不能证明图形的外观或行为符合预期。
5. **捕捉关键状态。** `rive myproject --screenshot=out.png`可以在不打开窗口的情况下渲染 PNG。Rive 的[示例](https://rive.app/docs/cli/examples)使用`--advance=1s`指定动画开始后的帧，`--viewport=390x844`指定布局尺寸，`--data=battery/level=100`提供绑定数据，并`--pointer=click@120,60 --advance=20`模拟点击。参数值和坐标应根据自己的场景设定。比较不同状态和视口尺寸下的截图，然后亲自检查。未提供`--advance`时捕获的是创作时的静止姿势，不一定是动画的开场帧。
6. **如果项目包含脚本测试，就运行这些测试。** `rive myproject --test`会运行项目的 Luau`Tests`测试脚本。Rive 文档介绍了`--verify --format=json`和`--test --format=json`，用于自动化检查；构建或测试失败时会返回非零退出码。代理可以根据这些报告修改源文件。测试只能覆盖实际编写的断言，因此还要检查测试未覆盖的交互。
7. **本地原型准备就绪后，再选择账户工作流程。**一个`.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`会从编辑器下载改动，并**覆盖本地场景、脚本和素材**。拉取前请检查本地改动。
8. **发布前检查签名和导出限制。** `rive myproject --publish`会写入经过签名的`.riv`，并要求登录。Rive 表示，Web 运行时及其 CDN 会拒绝未签名的脚本，因此用于 Web 的含脚本文件必须走这一路径。`--publish`可能会添加水印。Rive 的[命令参考](https://rive.app/docs/cli/reference/commands)指出，无水印的`.riv`要求项目通过`rive push`与账户文件绑定，并且该文件须位于 Cadet 或更高级别的工作区中。即使场景不含脚本，也可能触发水印条件。`--rev=<path>`还需要登录，可与`--once`或`--publish`组合使用；它生成的是编辑器文件，不能代替运行时文件。部署前请核对当前账户方案和实际导出结果。

Rive 还在[编辑器中内置了 AI 代理](https://rive.app/docs/editor/ai-agent)。可从编辑器侧边栏打开该功能；它受编辑器方案和 AI 点数条款约束。本指南介绍的是将编程代理与 CLI 配合使用的文件夹和终端工作流程；两种代理使用途径的界面和计费条件不同。

## 来源与延伸阅读

- [Rive CLI 概览](https://rive.app/docs/cli/overview)介绍终端工作流程、输出格式、预览和账户文件交换。
- [入门指南](https://rive.app/docs/cli/getting-started)列出受支持的平台、安装方式、脚手架内容、本地构建和登录条件。
- [使用 AI 代理](https://rive.app/docs/cli/agents)介绍编程代理如何使用生成的项目指引和 CLI 反馈。[内置编辑器代理指南](https://rive.app/docs/editor/ai-agent)则介绍了另一种编辑器内的操作界面。
- [RML 指南](https://rive.app/docs/runtimes/advanced-topic/rml)、[命令参考](https://rive.app/docs/cli/reference/commands)和[示例](https://rive.app/docs/cli/examples)说明了文件模型、具体命令、测试、截图行为和发布限制。
- [9 月 11 日员工公告](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml)注明技术预览的发布日期，并说明预览期间 CLI 暂时免费。[下载页面](https://rive.app/downloads)目前将 CLI 标记为“早期体验”；[定价页面](https://rive.app/pricing)列出了账户方案。请查看[Rive 视频演示](https://youtu.be/Y3E33otHeLE)了解人机协作流程。

## Sources

- [Rive CLI 概览](https://rive.app/docs/cli/overview) — 说明 CLI 的用途、本地 .riv 文件和编辑器 .rev 文件两种输出、实时预览，以及检查、测试、截图和远程文件交换功能。
- [Rive CLI 入门指南](https://rive.app/docs/cli/getting-started) — 介绍支持的平台、安装、项目脚手架、预览输出、.rev 文件和远程导入，以及登录、脚本签名和水印的要求。
- [使用 AI 代理](https://rive.app/docs/cli/agents) — 介绍如何配合外部编程代理使用 CLI、生成的代理指引、参考资料查询、验证、检查和分阶段的人为调整。
- [Rive 标记语言](https://rive.app/docs/runtimes/advanced-topic/rml) — 定义 RML 结构和文本项目编译，并分别说明编译、检查与视觉检查；同时明确指出，构建成功不能证明外观或行为符合预期。
- [Rive CLI 命令参考](https://rive.app/docs/cli/reference/commands) — 关于具体命令、参数、退出行为、远程推送与拉取、账户认证、签名、.rev 导出和无水印 .riv 条件的主要参考资料。
- [Rive CLI 示例](https://rive.app/docs/cli/examples) — 展示无头截图、时间推进、视口、数据和指针输入、Luau 测试及 JSON 报告；BIG CHANGE 未实际运行这些示例。
- [Rive AI 代理](https://rive.app/docs/editor/ai-agent) — 介绍 Rive 另外提供的、内置于编辑器中的代理，以及相关方案和 AI 点数条件。
- [Rive 下载页面](https://rive.app/downloads) — 当前页面将 Rive CLI 列在“早期体验”栏目下。
- [Rive 定价](https://rive.app/pricing) — 列出当前账户和编辑器代理方案条款；本文将其与有日期的 CLI 预览价格说明分开处理。
- [介绍 Rive CLI 和 RML](https://community.rive.app/c/announcements/introducing-the-rive-cli-and-rml) — Rive 员工公告称 CLI 处于技术预览阶段，并表示预览期间免费且没有使用限制；同时说明 .riv、.rev 和 RML 的作用，并链接到演示视频。
- [Rive CLI 演示视频](https://youtu.be/Y3E33otHeLE) — 由内容所有者提供的视频链接，已列入正文和来源；本文未据此提出关于具体视频场景或结果的主张。