配额管理
本模块用于统一管理配额规则：可按 Token 数或消费金额、以每天/每周/每月窗口设定用量上限，并将规则绑定到账户或 API Key，实时查看各绑定的额度使用情况；同时支持规则的新增、编辑、删除及账户与 API Key 的绑定/解绑操作。
一、新增配额规则
点击页面右上角 “+ 新增配额规则” 按钮，弹出配置表单，填写以下信息后点击“创建”即可生效。
1. 规则名称（必填）
- 输入自定义规则名称，便于识别和管理。
- 示例：
每日费用限额或每日Token限额
2. 窗口类型（必填）
- 选择配额统计的时间周期：
- 每天
- 每周
- 每月
- 示例：
每天
3. 计数类型（必填）
- 选择配额计算单位：
- 按消费金额
- 按 Token 数
- 示例：
按消费金额或按 Token 数
4. 配额上限（必填）
- 设置该规则允许的最大使用量。
- 支持手动输入或通过 “−”、“+” 按钮调整数值。
- 示例：
- 费用限额：
20.00 - Token 限额：
5000000
- 费用限额：
5. 币种（必填，仅当计数类型为“按消费金额”时显示）
- 选择货币单位，如人民币 (CNY)、美元 (USD) 等。
- 示例：
人民币 (CNY)
6. 绑定账户（可选）
- 选择一个或多个账户应用此配额规则。
- 示例：
人民币账户 (CNY)
7. 绑定 API Key（可选）
- 选择一个或多个 API Key 应用此配额规则。
- 支持多选，已选项目会以标签形式展示并可单独移除。
- 示例：
OpenCode,Codex,Zed
8. 是否启用（默认开启）
- 开关控制规则是否立即生效。
- 绿色表示启用，灰色表示禁用。
✅ 示例配置一：每日费用限额
- 规则名称：每日费用限额
- 窗口类型：每天
- 计数类型：按消费金额
- 配额上限：20.00
- 币种：人民币 (CNY)
- 绑定账户：人民币账户 (CNY)
- 绑定 API Key：OpenCode, Codex, Zed
- 是否启用：✅ 启用
✅ 示例配置二：每日Token限额
- 规则名称：每日Token限额
- 窗口类型：每天
- 计数类型：按 Token 数
- 配额上限：5000000
- 绑定账户：人民币账户 (CNY)
- 绑定 API Key：OpenCode, Codex, Zed
- 是否启用：✅ 启用
二、规则列表管理
在“配额管理”主界面，所有已创建的规则将以表格形式列出，包含以下字段：
| 字段 | 说明 |
|---|---|
| 规则名称 | 自定义的规则标识名 |
| 窗口类型 | 统计周期（如每天、每周等） |
| 计数类型 | 计量单位（按Token数 or 按消费金额） |
| 配额上限 | 设定的最大用量 |
| 绑定账户 | 显示绑定的账户数量及详情（含使用进度） |
| 绑定 API Key | 显示绑定的API Key数量及详情（含使用进度） |
| 状态 | 当前规则是否启用（绿色“启用中”或灰色“已禁用”） |
| 创建时间 | 规则创建的具体日期和时间 |
| 操作 | 提供“编辑”和“删除”功能 |
三、查看配额使用情况
在“配额管理”列表中，每条规则下方会显示其绑定资源的使用进度条和具体数值。
1. 绑定账户使用情况
- 显示每个绑定账户的当前使用比例和实际用量。
- 格式：
使用百分比 | 已用 / 总额 - 示例：
人民币账户 (CNY) 100.1% 5,006,008 / 5,000,000
⚠️ 注意：超过100%表示已超额使用，可能触发限流或告警。
2. 绑定 API Key 使用情况
-
显示每个 API Key 的当前使用比例和实际用量。
-
格式同上。
-
示例：
OpenCode 0.0% 0 / 5,000,000Codex 0.0% 0 / 5,000,000Zed 100.1% 5,006,008 / 5,000,000
3. 绑定操作
- 点击 “绑定” 可以添加更多 API Key 进行绑定。
4. 解绑操作
- 每个绑定项右侧提供 “解绑” 链接，点击后可解除该账户或 API Key 与此规则的关联。
- 解绑后，该资源不再受此规则限制。
- 解绑会清除计数，重新绑定的话计数从0开始。
四、注意事项
- 超额使用提示
当使用量超过配额上限时，系统仍会记录超出部分（如 100.1%），但可能会自动拦截后续请求或发送告警通知，请密切关注。
- 多规则叠加效应
若同一账户或 API Key 被多个规则绑定，最终限制取最严格的那个规则（即最小值原则）。
- 币种匹配要求
若计数类型为“按消费金额”，则绑定账户的币种必须与规则设定的币种一致，否则无法成功绑定。
- API Key 独立性
不同 API Key 可独立设置配额，适合对不同客户端或服务进行精细化管控。
- 实时更新机制
使用数据为实时同步，点击刷新按钮即可获取最新数据。
五、常见问题 FAQ
Q：如何暂停某个规则而不删除？
A：在规则详情页或列表中，将“是否启用”开关关闭即可临时停用，无需删除。
Q：能否为一个 API Key 设置多个不同类型的配额？
A：可以。例如同时设置“每日Token限额”和“每月费用限额”，系统会分别监控并独立计数。
Q：为什么我的账户显示 100.1%？
A：说明你已在当前周期内超用了配额。建议检查是否有异常调用，或联系管理员提升上限。
Q：解绑后会影响历史数据吗？
A：不会。解绑仅影响未来对该资源的配额控制，历史使用记录仍保留在系统中供审计。
📌 温馨提示：定期审查配额使用情况，合理分配资源，避免服务中断或产生额外费用。