配额管理

配额管理页面回答的是“这个账号现在还能不能继续跑请求”。它不只看剩余额度，也会结合认证文件、巡检结果、请求失败摘要和冷却记录判断账号是否应该暂停或恢复。

它面向账号状态，不负责展示成本；成本拆解请看 用量分析。

进入页面前

配额页依赖认证文件和提供商返回的数据。使用前建议先确认：

1. 认证文件 中账号存在且 auth_index 稳定。
2. 请求确实经过 CPA，并且最近有相关请求。
3. 如果是 Codex 账号，必要时先跑一次 Codex 账号巡检。

数据来源

页面里的配额线索可能来自：

• CPA 提供商或认证文件中的账号信息。
• Codex 账号巡检结果。
• 请求失败摘要中的 usage_limit_reached 等信号。
• 最近响应 Header 中记录的额度和恢复时间。
• CPAMP 的配额冷却记录。

不同提供商能返回的信息不一样。未知状态只代表 CPAMP 没拿到足够信息，不代表账号一定无限可用。

页面操作

• 使用搜索框按文件名、账号、备注或索引快速定位账号。
• 使用排序查看计划、额度状态或名称顺序。
• 点击刷新认证文件和额度，重新读取账号列表和可查询额度。
• 如果账号卡片提示冷却、失效或需要重新授权，按提示跳转到认证文件、OAuth 或巡检页面。
• 对同一批账号做判断时，优先按 auth_index 和备注区分，不要只看文件名。

配额冷却

开启配额冷却后，账号触达用量上限时，CPAMP 可以临时禁用对应认证文件，并在重置时间后恢复。

注意：

• 需要 USAGE_QUOTA_COOLDOWN_ENABLED 或配置中心开关启用。
• 自动恢复依赖 CPAMP 持续运行。
• 手动禁用的账号不会被自动恢复覆盖。
• 如果 auth_index 不稳定，冷却记录可能无法准确绑定账号。

配额冷却适合处理明确的额度耗尽，不适合用来处理登录失效、上游封禁或配置错误。后几类问题应进入 账号处理队列 或 OAuth 登录 处理。

排障

账号看起来可用但请求失败时：

1. 查看请求监控中的失败摘要。
2. 查看 Codex 账号巡检是否提示配额、工作区或认证问题。
3. 查看认证文件页面是否处于手动禁用或冷却状态。
4. 查看账号处理队列是否有待处理候选项。
5. 如果页面没有配额数据，确认该提供商是否支持主动查询，或是否只能通过请求 Header 被动观察。