Quota strategies

Define model-opaque quota units, reset intervals, integer multipliers, and safe output bounds for a plan.

Outcome

你可以配置和解释 QuotaStrategy，验证整数公式，并知道为什么同一 Strategy 对 Provider 定义的不同模型使用相同套餐倍率。

Strategy fields

Field	Meaning
`resetInterval`	`MONTH` 或 `YEAR` 的额度周期。
`quotaUnits`	每个新 QuotaPeriod 的 Granted Units。
`inputMultiplierPpm`	非缓存 Input Token 的整数 PPM 倍率。
`cachedInputMultiplierPpm`	Cached Input Token 的整数 PPM 倍率。
`outputMultiplierPpm`	Output Token 的整数 PPM 倍率。
`maxOutputTokens`	Reserve 时使用的安全输出上限。

1,000,000 ppm 等于 1.0x。倍率不使用 Float，所有中间计算使用至少 64 位整数。

Unit formula

uncached_input_tokens = max(input_tokens - cached_input_tokens, 0)

weighted_token_ppm =
    uncached_input_tokens × input_multiplier_ppm
  + cached_input_tokens   × cached_input_multiplier_ppm
  + output_tokens         × output_multiplier_ppm

quota_units = ceil(weighted_token_ppm / 1,000,000)

舍入只发生在一次 Invocation 的最终合计处。

Model names stay opaque

QuotaStrategy 不按 model 查找规则。客户端传入的原始模型名由所选 ProviderConnection 接受或拒绝；相同 Token Usage 和相同倍率快照始终得到相同 Units。

Quota Unit 表达非货币的 AI 使用权。它不是法币、可提现 Credit、Provider Cost 或支付余额。Workspace 如需限制高成本模型，应使用受限的上游 Provider Secret，等待后续独立策略，或拆分 Workspace。

Publish before binding

草稿 Strategy 可以校验和编辑；发布后配置不可变。Plan 通过带生效区间的 Binding 使用已发布版本，QuotaPeriod 在创建时复制策略快照。