CPA Manager Plus v1.12.0

196 commits · 552 files changed · +119770 / -24846

v1.12.0-rc.3 → v1.12.0: 0 product commits · 0 product files changed

English ->

Overview

v1.12.0 是经过完整 RC 验证的 1.x 稳定版。产品源码与 v1.12.0-rc.3 完全一致，本次仅增加正式版发布材料并以 VERSION=v1.12.0 重新构建，因此不会引入 RC.3 之后的运行行为变化。此版本将统一的 Accounts 凭证工作区、额度生命周期与诊断、模型身份与代理修复，以及启动安全、可恢复的派生数据迁移带入稳定渠道。

Highlights

Features

• /accounts 成为统一凭证管理入口，集中提供额度、配置、模型、活动、巡检与重新登录工作流，并适配桌面和移动端。
• 凭证详情支持当前与历史额度周期、模型范围、重置记录、最近请求、用量预测和账号级诊断。
• Provider 额度刷新保持显式手动操作，Manager Server 可持久化额度观察、窗口、生命周期和账号用量证据。
• 支持 weighted round-robin 凭证路由，并在兼容 Provider 的凭证详情中展示有效权重与默认权重。
• Monitoring 完整显示模式可展示规范化且限制长度的客户端 IP、未验证 X-Forwarded-For 和 User-Agent 请求元数据。
• 禁用凭证无需恢复请求路由，也可刷新额度、编辑可写配置并从列表直接打开配置。
• Dashboard 中有效的 Manager 与 CLIProxyAPI 版本可直接打开对应的 GitHub Release。
• Manager Server 新增 cleanup-derived 离线维护命令；GET /status 的 dataMigration 会报告迁移阶段、进度、失败与完成状态。

Fixes

• 凭证状态按文件名、auth_index、Provider、连接和会话隔离，过期请求、HTTP 499 与客户端取消不再覆盖当前证据。
• Accounts 会同步被动 Header、服务端巡检、手动额度刷新和 Codex OAuth 重新登录结果，减少陈旧限额或重新登录状态。
• Accounts 会正确处理计划与提前额度重置、深链凭证解析和详情抽屉重开后的当前与上一周期用量。
• CPA 支持的推理后缀会归入规范分析模型，同时保留请求、上游、计费、定价与未知别名身份。
• Provider 模型发现和健康检查会转发已配置的请求级代理，避免 OpenAI-compatible 请求意外直连受限网络。
• xAI 与 SuperGrok 优先采用统一计费证据，并仅用旧响应补齐缺失字段，避免错误的零美元月额度。
• Manager Server 启动阶段只执行有界 schema 与 metadata 工作，大表索引、派生清理和重建会延后到 HTTP 监听后或显式离线维护。
• cache accounting、legacy quota snapshot backfill 和派生清理按有界事务与已提交 checkpoint 推进，中断或重启后可继续当前阶段。
• Monitoring、Usage Analytics 和 Dashboard 在 rollup 未完整时使用完整 revision 或回退到 raw usage_events，保持读取正确性。
• Manager Server、admin reset 和离线维护通过跨平台 SQLite 进程锁串行访问同一数据库。

Performance

• 账号窗口用量优先使用覆盖完整的派生读取，并通过身份与时间索引减少账号历史、额度窗口和最近状态查询扫描。
• 兼容用量接口在释放 SQLite 读取器后分批加载详情，慢速下载不再长期阻塞 WAL checkpoint。

Docs

• 中英文文档、导航和部署说明统一指向 Accounts 凭证管理流程，并更新额度、迁移与离线维护指导。

CI / Build

• 发布流程会先验证完整 Draft Release，再显式发布，并为受控恢复校验 tag、来源 SHA、产物、资产和多架构镜像状态。
• Docker 构建上下文排除所有层级的 node_modules，避免工作区依赖污染镜像构建。

Upgrade Notes

• v1.12.0 会更新稳定发布资产、Docker 1.12 与 latest；产品源码与 v1.12.0-rc.3 完全一致。
• 凭证管理、额度、巡检和重新登录请使用 Accounts；旧 Auth Files 与独立 Quota 页面和路由已移除，内部兼容 API 继续供 Accounts 使用。
• 升级前请同时备份 SQLite 数据库、WAL、SHM 与 data.key。后台迁移会在 HTTP 服务可用后继续执行。
• 如果日志出现 deferred index preparation、cleanup requires offline finalization 或 offline cleanup required，请停止所有使用该数据库的 Manager Server，再用同版本二进制运行 cpa-manager-plus cleanup-derived --db-path /data/usage.sqlite；默认原生路径可省略 --db-path。
• cleanup-derived 会在数据库锁仍被持有时拒绝执行；锁文件无需手工删除。不要启动第二个 Manager Server 连接同一 SQLite 或 CPA queue，usage_events 不会被派生重建修改或删除。
• Provider 请求级代理需要 CPA v7.2.130+；weighted round robin 需要支持对应路由策略和凭证权重字段的 CPA 运行时。
• Provider 额度仍只在用户主动刷新时请求；持久化额度历史、账号窗口用量和服务端巡检依赖 Manager Server，纯 CPA Panel 模式会隐藏不可用功能。
• 请求元数据可能包含敏感客户端信息，仅在完整显示模式提供，并且不会进入兼容用量导出或 JSONL 导出。
• 当 /v0/management/usage 的配置上限超过 50,000 条时，将返回最新 50,000 条；/v0/management/usage/export 仍遵循原配置上限。

Full Changelog: v1.11.12...v1.12.0