CPA Manager Plus v1.12.7
64 commits · 81 files changed · +7899 / -429
Overview
v1.12.7 聚焦配额生命周期证据的稳定性、API Key 管理的即时持久化、Claude 请求指纹配置，以及 Usage Analytics、Request Monitoring 和 Dashboard 的操作清晰度。配额在过期边界、凭证重新启用和待确认周期下不再错误沿用旧状态；面板会更明确地展示时间范围、零值数据、排名上下文和保存结果；SQLite 启动错误也提供了可执行的环境修复提示。
Highlights
Features
- Request Monitoring 新增“昨天”快捷范围，按本地完整日计算上一日的监控数据。
- Claude provider 编辑器新增 Request Fingerprint 配置，可选择 claude-code-cli 并核验 CPA 实际保存结果。
Fixes
- API Key 在弹窗确认后立即通过 CPA 管理接口创建、替换或删除，其他 Visual 配置草稿保持不变。
- API Key 变更遇到不确定结果、异常主机能力或格式错误的规范列表时会安全停止后续操作，并要求重新建立最新状态。
- Manager-hosted 模式下的 API Key Replace/Delete 会等待面板主机与 Manager Alias 能力确认；CPA panel 模式仍可直接使用 CPA 管理接口。
- Dashboard 的 Manager 与 Core 更新提示现在链接到版本检查检测到的具体 Release；无效或不可用的版本仍显示为纯文本。
- OpenAI-compatible provider 的 API Key 编辑抽屉横向滚动时保持表头和每行的 Test/Delete 操作可见。
- Accounts 新增与顶部“待确认”指标一致的 credential 状态筛选。
- Usage Analytics 主时间线补齐无请求的小时或日期为零值，并保留无请求桶的延迟和百分位指标为空。
- Usage Analytics 的 API Key 排名上下文现在显示当前筛选总数、Top 8 限制和按成本排序；既有排序和其他行操作保持不变。
- Codex 5 小时配额在当前生命周期边界待确认时保留上一周期已确认用量，并暂停当前周期范围与预测。
- 凭证重新启用后会创建新的配额冷却周期，避免沿用旧恢复时间或 xAI 周期证据；同一禁用周期内的延长行为保持不变。
- 固定和日历配额窗口在过期边界收到新的已确认证据时会就地修正 reset 时间，避免回退到过期边界或错误拆分生命周期。
- Codex 配额请求使用当前 codex-tui 客户端标识。
- Manager Server 在 SQLite 临时目录或数据库文件不可写时提供针对性的启动诊断，并在部署文档中说明只读根文件系统的可写要求。
Docs
- SQLite Docker 部署要求、/tmp 临时目录和数据库 WAL/SHM 文件要求已集中到中英文文档站页面。
- Release process 文档现在要求从精确的 previous-main 到 frozen-dev 范围映射所有 promotion PR，并记录完整的 Related 清单。
Upgrade Notes
- 本版本不新增 SQLite schema、迁移或回填；现有配额周期记录会在下一次正常配额观察或手动刷新时按新的证据就地修正，usage_events 不会被改写。
- 使用只读根文件系统部署 Manager Server 时，请为操作系统临时目录提供可写挂载（例如 Kubernetes 在 /tmp 使用 emptyDir），并确保 SQLite 数据库文件及 WAL/SHM 伴随文件可写；普通 Docker/Compose 部署无需额外配置。
- Claude 的 Request Fingerprint 是可选配置；旧的 experimental-cch-signing 不会自动迁移，较旧 CPA 如果未应用 fingerprint-profile，面板会报告“已保存但未生效”。
- API Key 在弹窗确认后立即写入 CPA；未保存的 Source YAML 会阻止相关 API Key 操作和切换 CPA 目标，结果不确定时请按提示刷新，Visual 草稿仍需单独保存。
- 当前配额边界尚未确认时，面板会保留上一周期可靠用量，但不会显示当前周期范围或预测；已过期边界在下一次观察或手动刷新时修正，不会在升级启动时扫描历史数据。
Acknowledgements
- @nekopara-ai - 补充凭证重新启用后的配额冷却周期处理，避免新一轮事件沿用旧周期。
Full Changelog: v1.12.6...v1.12.7