配额管理
为用户和分组设置日/周/月/总量四个维度的 API 使用限额,实现企业级成本控制,避免单个用户过度消耗资源。
配额层级
Cherry Studio 采用两级配额体系:
- 分组级配额:在分组设置中配置,作为该组所有成员的默认限额。
- 用户级配额:针对单个用户的个性化配额,优先级高于分组配额。留空则继承分组默认值。
为用户设置配额
- 前往 用户管理 页面。
- 在目标用户的操作列中,点击 限额 按钮。
支持通过顶部的 金额限额 / Token 限额 标签页切换,分别设置金额维度和 Token 维度的配额。
- 在弹窗中设置各维度的限额值:
| 维度 | 说明 |
|---|---|
| 日限额 | 过去 24 小时内允许的最大使用量。每日自动重置。 |
| 周限额 | 过去 7 天内允许的最大使用量。每周自动重置。 |
| 月限额 | 过去 30 天内允许的最大使用量。每月自动重置。 |
| 总限额 | 累计总使用量上限。不自动重置,需手动重置。 |
提示: 留空表示继承分组默认配置。如果分组也未设置,则表示不限制。点击弹窗左下角的 恢复默认 按钮可一键清空该用户的所有自定义限额,回到继承分组默认值的状态。
查看用量与重置
点击每个限额维度旁的展开按钮,可以查看当期用量详情:
- 当期用量:以
已用量 / 限额格式显示当前周期的使用情况。 - 过去 24 小时:最近 24 小时内的消耗金额。
- 下次重置:该维度配额自动重置的时间。
- 重置用量按钮:手动将当期用量清零。
- 配置完成后点击 保存。
注意: 当用户使用量达到限额时,后续的 API 调用将被拒绝,直到配额重置或管理员手动调整。
临时额度调整
本次追加的额度在该周期重置后自动失效,不修改原始限额配置。
当某位用户因紧急需求需要突破现有配额(例如月限额已满但仍需再跑一批任务)时,您可以使用 临时加额 为该用户的当期周期注入额外额度,无需修改其常规配额设置。
临时加额
- 进入 用户管理,在目标用户操作列点击 限额 打开用户限额弹窗。
- 切到 金额限额 或 Token 限额 标签页。
- 在 日限额 / 周限额 / 月限额 字段右侧(图表按钮旁),点击 + 按钮。
- 在弹出的 「日/周/月 临时加额」 Popover 中输入要追加的数值(正整数,单位随所在 Tab — Token 数或货币金额),点击 应用 提交。
临时追加的额度仅作用于当前周期,周期自动重置时会随当期用量一起清零;不会修改用户的常规限额值。总限额 字段不支持临时加额。
查看调额历史
在 用户管理 页面,点击目标用户右侧的 ⋯ 操作菜单 → 选择 调额记录。
调额记录弹窗按时间倒序展示该用户跨所有周期的全部历史调整:
| 列 | 说明 |
|---|---|
| 时间 | 调整发生的时间戳 |
| 周期 | 该次调整作用的周期(日/周/月) |
| 单位 | 调整的额度单位(金额 / Token) |
| 增量 | 本次追加的数值 |
| 操作人 | 执行调整的管理员账号 |
