每月 CLI 额度（Monthly CLI Allowance）
Free、Cadet、Voyager 和 Enterprise 都会为每个工作区（Workspace）提供每月的 Rive CLI 发布与推送额度。会计入额度的操作有三项：rive push、--publish 和 --publish=web。
在本机构建和预览，以及从 Rive 编辑器导出，均不限次数，也永不计入额度。
按套餐的额度（Allowance by plan）
| 套餐 | 每个工作区每月的额度 |
|---|---|
| Free | 50 次发布与推送，合计 |
| Cadet | 500 次发布与推送，合计 |
| Voyager | 每席位 5,000 次发布与推送，合计并在工作区内共享。额外用量由充值额度（top-up credits）覆盖。 |
| Enterprise | 以协议约定为准 |
学生计划和旧版付费计划没有每月额度。各套餐还包含什么，见定价。
一次操作会计入拥有该 Rive 文件的工作区额度，该文件是你的项目所绑定的目标（rive.yaml 中的 push.fileId）。如果项目尚未绑定文件，则计入你的个人工作区（personal Workspace）。个人工作区使用它自己套餐的额度，与你在哪些工作区担任编辑无关。要使用另一个工作区的额度，请把项目绑定到该工作区中的文件。从 CLI 发布已绑定的项目，需要对该文件有编辑权限。
什么会计入（What counts）
每项操作计一次：
| 操作 | 计入时机 |
|---|---|
rive push | 推送完成时 |
--publish 或 --publish=local（把 .riv 写到磁盘） | 发布开始时 |
--publish=web（发布托管页面） | 发布开始时 |
为了在本机测试而发布的 .riv，与其他发布一样计入额度。
一次 Web 发布只计为一次发布。上传与托管页面不会分开再计。
发布从开始那一刻就算入，即使后续步骤（例如签名）失败。推送只在完成时计入，因此失败的推送不计。
什么永不计入（What never counts）
- 从 Rive 编辑器导出，任何套餐均不计。
rive pull，任何套餐均不计。rive build（把项目打包成 Android 或 iOS 应用），任何套餐均不计。- 留在本机的工作：随编辑重建的预览窗口、
--serve、--verify、--test、--screenshot和rive inspect。它们不会向 Rive 发起调用。 --rev。它需要rive login，但不计入额度。- 失败的推送，以及发现文件已经是最新的推送。
- CLI 在一次操作期间自行发起的重试和状态检查。再次运行该命令则是一次新操作。
每月重置（Monthly reset）
额度在每月 1 日 00:00 UTC 重置。当月未用完的次数不会结转到下个月。
接近上限时的警告（Warning before the limit）
当剩余额度不超过 20% 时，CLI 每次运行会打印一次警告。警告会显示还剩多少次操作，以及额度何时重置：
CLI allowance: 8 of 50 publishes and pushes left this month (resets Dec 1). Upgrade: https://rive.app/pricing
使用 --publish --format=json 时，警告出现在 warnings 中。
Voyager 超额之后（Past the allowance on Voyager）
Voyager 工作区用完每月额度后，CLI 发布与推送会继续消耗该工作区的充值额度（top-up credits），与 Rive Agent 使用的是同一笔额度。每次操作消耗 $0.01 额度。CLI 会告诉你和你的代理：这次操作是用额度支付的，以及还剩多少。额度用尽后，CLI 会停止，并给出充值链接。
额度用尽时（When the allowance is used up）
CLI 会在推送开始前检查额度。未通过该检查的推送不会发送任何内容。
CLI 会停止该操作且不会重试。它会打印重置日期和升级链接，并以退出码 9 退出：
Monthly CLI allowance used up in your personal workspace: 50 of 50 publishes and pushes. Resets Dec 1, 2026 (UTC). Upgrade: https://rive.app/pricing
消息会点名这次操作计入的工作区。如果它点名的是你的个人工作区，而你本想使用另一个工作区的额度，请用 push.fileId 把项目绑定到该工作区中的文件。
使用 --publish --format=json 时，消息出现在 errors 中。同样的结果也在 allowance 字段中，包含 code、message、scope、limit、used、resetsAt 和 upgradeUrl。除非额度阻止了本次运行，该字段为 null。
已经推送或发布的文件继续可用。你仍然可以 pull、预览、用 --verify 检查构建、构建应用，以及从 Rive 编辑器导出。若要在重置前再次从 CLI 发布或推送，请升级该工作区，或在 Voyager 上使用充值额度。
每月额度与发布的短期速率限制是分开的；短期限流在每个套餐上都适用。参见发布 CLI 项目。