v1.12.0-beta3

CPA Manager Plus v1.12.0-beta3

16 commits · 36 files changed · +2099 / -459

English ->

Overview

这是 v1.12.0 的第三个 beta 版本，聚焦 Accounts 额度周期一致性、兼容用量导出的 SQLite 读取韧性，以及监控、日志和系统信息的可发现性。额度周期在提前或计划重置、深链加载和详情抽屉重开场景下保持正确；慢速兼容用量下载不再长期占用 SQLite 读取器；前端统一费用精度并整理日志、插件和系统入口。

Highlights

Features

• Monitoring、Dashboard、Usage Analytics 与 Accounts 的 USD 费用统一显示三位小数；存储值和计算逻辑不变（web/usage）。
• 日志入口默认可见，请求日志开关移入可视化配置，并移除 Dashboard 的隐藏解锁手势；直接日志访问继续可用（web/logs、web/config）。
• 插件被配置为明确禁用时隐藏插件管理导航，同时对缺失插件能力字段的旧环境保持兼容（web/plugins）。
• System 信息将服务端版本和主程序仓库改为内核术语，并将教程入口指向 CPAMP 在线文档（web/system）。

Fixes

• Manager Server 仅使用可靠的精确或推导边界确认计划或提前额度重置，并避免临时零用量或未知边界错误拆分当前周期（manager-server/quota）。
• Accounts 在额度周期激活、计划滚动和提前重置后保留规范化的当前与上一周期用量；周期标签使用计划边界，而聚合仍使用实际观察区间（web/accounts、manager-server/quota）。
• Accounts 在手动额度刷新、同一凭证详情抽屉重开及深链凭证异步解析后重新加载额度用量，避免空白或陈旧详情（web/accounts）。

Performance

• 兼容用量接口在释放 SQLite 读取器后分批加载详情，慢速客户端不再阻塞 WAL checkpoint；返回结构、排序和 JSONL 导出路径保持不变（manager-server/usage）。
• 为额度周期证据查询增加非破坏性 SQLite 索引，使历史快照增长时的生命周期归一化保持有界（manager-server/sqlite）。

Chore

• GitHub Linguist 不再把 apps/web 计入主要语言统计，使仓库元数据以 Go 应用为主；构建和运行时不受影响（repo）。

Upgrade Notes

• 这是预发布版本。稳定 Docker 标签和 latest 不会更新，请显式使用 v1.12.0-beta3 对应的镜像或发布资产。
• 当 GET /v0/management/usage 的配置上限超过 50,000 条时，将返回最新 50,000 条；/v0/management/usage/export 仍遵循原配置上限。
• Manager Server 会自动添加非破坏性的额度周期查询索引，无需手工迁移或重写数据。
• 额度周期持久化修复适用于使用 Manager Server 存储的部署；CPA Panel 直接模式的既有能力边界不变。

---

Full Changelog: v1.12.0-beta2...v1.12.0-beta3

v1.12.0-beta2

CPA Manager Plus v1.12.0-beta2

7 commits · 12 files changed · +505 / -130

English ->

Overview

这是 v1.12.0 的第二个 beta 版本，聚焦被动额度证据的新鲜度和实时监控的可读性。Accounts 与 Monitoring 现在会共享并刷新 usage-response Header 额度证据，同时保持 Provider 额度刷新为显式手动操作；实时监控改进 TPS 与推理 Token 的展示。

Highlights

Fixes

• 从当前 Manager 连接范围内的 usage-response Header 证据更新 Accounts 与 Monitoring 的 Codex 额度状态，并避免隐式请求 Provider 额度端点（web/accounts、web/monitoring）。
• Accounts 工作区在打开、保持可见及执行工作区刷新时更新被动 Header 证据，并仅在选中凭证的证据版本变化时重新查询其用量；Provider 额度刷新仍为手动操作（web/accounts、web/quota）。
• 实时监控的 TPS 列与总调用数使用一致的字号，并在用量提示中显示精确的推理 Token 数量（web/monitoring）。

Upgrade Notes

• 这是预发布版本。稳定 Docker 标签和 latest 不会更新，请显式使用 v1.12.0-beta2 对应的镜像或发布资产。
• 本次无 SQLite schema、API 或配置迁移；Header 证据仅保存在当前浏览器会话，并按当前 Manager 连接范围隔离。
• Provider 额度端点仍只由用户主动刷新调用；打开 Accounts、Monitoring 或刷新工作区只读取被动 Header 证据。
• 依赖 Manager 连接的额度证据继续遵循现有 CPA Panel 与 Full Docker 能力边界。

---

Full Changelog: v1.12.0-beta1...v1.12.0-beta2

v1.12.0-beta1

CPA Manager Plus v1.12.0-beta1

138 commits · 278 files changed · +72747 / -2933

English ->

Overview

这是 v1.12.0 的首个 beta 版本，重点交付统一凭证管理工作区、Provider 额度证据与账号级诊断。前端将凭证、额度、配置、模型、健康状态和请求活动集中到 /accounts，Manager Server 增加额度窗口生命周期持久化与身份隔离的监控读取，并在 CPA Panel 与 Full Docker 模式之间保持明确的能力边界。

Highlights

Features

• /accounts 成为统一凭证管理入口，旧 /auth-files 与 /quota 路径通过兼容跳转保留，并提供桌面、移动端、列表和卡片视图（web/accounts）。
• 凭证详情整合概览、额度、配置、模型、活动与诊断，可查看健康状态、最近请求、重新授权和恢复建议（web/accounts）。
• Provider 额度卡片支持完整周期、历史周期、模型范围、重置记录、精确观察时间、用量预测和周期对比（web/quota）。
• Provider 额度刷新改为显式手动操作，并与历史刷新分离；重复刷新按 Provider 串行执行，失败时保留已有额度（web/quota）。
• Manager Server 持久化额度观察、窗口、激活、周期和 allowlist snapshot，不保存 Provider 原始响应正文（manager-server/quota）。
• 账号历史和窗口用量按凭证身份、Provider 与精确时间范围查询，支持最近请求状态和凭证级钻取（manager-server/monitoring）。
• OAuth 排除模型和模型别名可在统一工作区预览和管理，多 Provider 别名变更支持失败回滚（web/auth-files）。
• 凭证配置工作区支持状态、代理、排除模型和 OAuth 规则的账号级呈现（web/accounts）。

Fixes

• 使用文件名、auth_index、Provider 和来源组成的身份范围，避免同名凭证、无 Provider 记录和缓存之间发生错误归属（web/identity、manager-server/identity）。
• CPA 连接或 Manager 作用域变化时，在布局提交前清除旧额度、巡检结果和 OAuth 状态，并忽略旧请求返回的数据（web/connection-scope）。
• 多步骤凭证写入固定使用操作开始时捕获的 CPA 连接，旧连接的 401 或响应元数据不会影响当前会话（web/api）。
• Full Docker 与 CPA Panel 模式分别判断 Manager 存储、请求监控和服务端巡检能力，不再复用过期能力状态（web/panel-mode）。
• 统一 Provider 重置时间、周期边界和额度可用性语义，刷新失败或空窗口时不再误清除已有结果（web/quota）。
• 凭证编辑器和确认信息继续使用脱敏预览，避免展示原始认证内容（web/auth-files）。

Performance

• 账号窗口用量优先使用覆盖完整的派生监控读取，并在边缘或尾部数据缺失时回退原始 usage_events（manager-server/monitoring）。
• 新增凭证窗口和最近请求索引，减少账号历史、窗口用量和最近状态查询的扫描范围（manager-server/sqlite）。

Refactor

• 账号工作区复用详情抽屉、健康徽章、额度窗口卡片、相对时间和统一数据颜色，减少页面间展示差异（web/ui）。

Docs

• 中英文额度手册统一使用凭证与账号身份术语，并说明按 auth_index 区分同名凭证（docs/quota）。

Chore

• 为新的账号详情、额度生命周期、诊断和 OAuth 操作补充多语言文案（web/i18n）。

Build

• Docker 构建上下文排除所有层级的 node_modules，避免工作区依赖污染镜像构建（docker）。

Upgrade Notes

• 这是 prerelease。Docker 的稳定版本标签和 latest 不会更新，请显式使用 v1.12.0-beta1 对应镜像或资产。
• /auth-files 与 /quota 会跳转到 /accounts；已有浏览器链接仍可使用，但外部导航、文档和自动化建议迁移到新入口。
• Manager Server 会自动执行增量 SQLite 迁移，新增额度观察、窗口、生命周期、snapshot 和身份索引。升级前请同时备份数据库、WAL、SHM 与 data.key。
• usage_events 仍是原始事实来源，派生监控数据可恢复；不要手动删除运行中的 SQLite WAL。
• 持久化额度历史、账号窗口用量和服务端巡检依赖 Manager Server。纯 CPA Panel 模式会隐藏不可用功能。
• Provider 额度只在用户主动刷新时请求；打开详情、刷新历史或处理冷却状态不会自动轮询上游。
• OAuth 排除模型与模型别名能力取决于 CPA 端点支持；不支持时界面会保持只读或显示不可用状态。
• 此版本包含大范围账号工作区和存储变更，建议先在非生产环境验证现有凭证、额度与监控数据。

---

Full Changelog: v1.11.12...v1.12.0-beta1

v1.11.12

CPA Manager Plus v1.11.12

16 commits · 71 files changed · +9754 / -872

English ->

Overview

本版本聚焦大规模用量监控的查询性能、SQLite/WAL 状态可观测性和受保护的发布流程。Manager Server 为长窗口监控增加可恢复的派生数据与后台补齐机制，SQLite 存储状态现集中在系统信息页并适配桌面、平板和移动端；发布流程要求完成 dev 集成、main 晋级和来源校验后才创建标签。

Highlights

Features

• 系统信息页提供 SQLite 存储状态模块，展示数据库、WAL、SHM、总占用和检查点状态，并采用桌面、平板和移动端响应式布局（web/system-info）。
• Dashboard 移除 SQLite 存储卡片并恢复原有四列数据布局（web/dashboard）。

Performance

• 7 天和 30 天监控分析会在派生数据覆盖后使用可恢复的 SQLite 读取路径，减少对大型 usage_events 原始表的扫描（manager-server/monitoring）。
• 模型、账户、API Key 统计、筛选器、事件搜索与分页、Header 快照等监控读取会在覆盖可用时使用派生数据，并保留原始边缘数据和尾部数据回退（manager-server/monitoring）。
• Header 快照加载会合并并发请求，监控接口同时减少不必要的响应负载（manager-server/monitoring）。
• SQLite WAL 维护使用非阻塞的有界检查点、256 MiB 日志大小目标，并仅在检查点完全追平后尝试截断，同时提供数据库/WAL/检查点状态（manager-server/sqlite）。

Fixes

• Manager Server 启动时会检测不完整的监控派生状态，只重建受损的派生数据，不重写原始用量事件（manager-server/monitoring）。

CI

• PR 流程新增稳定的 Required checks 汇总，并对缺失、跳过或失败的必需工作流采取 fail-closed 处理（ci/pr-check）。
• 发布校验现在验证标签格式、三份版本化发布文件、双语互链、dev 到 main 的来源拓扑，以及发布提交不能包含额外变更（ci/release）。
• Windows 原生控制解析器测试使用更充足的超时预算，减少慢速运行器上的误报（tests/nativeControlScripts）。

Docs

• README、README_CN、贡献指南和发布文档补充 dev 集成流程、备份要求、发布前置条件和恢复边界（docs/release、contributing）。

Chore

• 移除旧版中文 Issue 表单，并将社区与维护类变更纳入 dev 分支集成治理（github、contributing）。

Upgrade Notes

• Manager Server 升级时会自动创建新增的 SQLite 表和索引，并在现有后台派生数据 worker 中补齐历史监控状态；无需手动执行数据库或配置迁移。大型数据库首次升级后可能暂时增加 CPU、磁盘 I/O 和额外存储占用。
• usage_events 仍是原始事实来源，派生数据可重建。升级前请将 usage.sqlite、usage.sqlite-wal、usage.sqlite-shm 和 data.key 一起备份；不要手动删除正在使用的 WAL。
• 256 MiB 是检查点完成后的日志大小目标，不是长事务或长期读者存在时的硬上限；WAL 维护会避免等待活跃读写，并只在检查点完全追平后尝试截断。
• API 响应形状、CPA Panel 的认证与管理密钥归属、以及采集队列语义保持不变。纯 CPA Panel 直连且未运行 Manager Server 时不会显示该 Manager SQLite 状态模块。

---

Full Changelog: v1.11.11...v1.11.12

v1.11.11

CPA Manager Plus v1.11.11

2 commits · 2 files changed · +65 / -14

English ->

Overview

本安全补丁修复了 Manager Server 插件资源代理中的认证权限提升路径。未通过 CPAMP Admin Key 验证的插件资源请求不再隐式借用服务器已保存的 CPA Management Key；调用方自身的 Authorization 会保留转发，未提供认证时则由上游 CPA 或插件的公开资源策略决定。

Highlights

Fixes

• /v0/resource/plugins/* 仅在请求携带有效的 CPAMP Admin Key 后才使用保存的 CPA Management Key；无认证的 GET/HEAD 请求不会再以管理权限访问上游插件资源（manager-server/plugin-resource-proxy）。
• 所有已支持的插件资源 HTTP 方法现在遵循相同的权限边界：插件调用方携带的 Authorization 会原样转发，而无认证请求仍受上游 CPA 或插件的公开资源策略约束（manager-server/plugin-resource-proxy）。

Upgrade Notes

• v1.5.0 至 v1.11.10 受影响。若 Manager Server 曾可被不可信客户端访问，请尽快升级。
• 影响范围包括 Manager Server、Full Docker，以及配置了 CPA upstream 和保存 CPA Management Key 的原生 Manager Server 安装；CPA Panel 直接模式不受影响。
• 无需配置或数据库迁移。若实例曾暴露给不可信网络，请检查相关访问和插件日志；仅当已安装插件的资源接口可能返回敏感数据或凭据时，按排查结果轮换相应插件侧 Token 或 API Key。

Acknowledgements

• @Cec1c - 报告并贡献修复了该权限提升问题。

---

Full Changelog: v1.11.10...v1.11.11

v1.11.10

CPA Manager Plus v1.11.10

22 commits · 112 files changed · +30546 / -2253

English ->

Overview

本次发布聚焦本地成本估算精度、认证文件操作安全性和实时监控可读性。模型价格同步会优先使用 models.dev 的第一方官方元数据，并把上下文阶梯与 Fast/Priority service tier 应用于 Dashboard、监控和账户历史；认证文件变更会按规范凭据身份校验，实时请求表则统一采用总延迟 TPS。

Highlights

Features

• 模型价格同步优先读取 models.dev catalog 的规范模型元数据，并依次使用 LiteLLM、OpenRouter 回退；只有唯一强身份匹配会自动保存，全部来源失败时会保留最后有效价格（manager-server/model-pricing）。
• 解析、校验并持久化 models.dev 上下文价格阶梯与显式 Fast/Priority 费率，通过持久化定价汇总将其应用到 Dashboard、监控、账户历史和前端用量成本（manager-server/usage-pricing、web/usage）。
• 模型价格页可只读展示同步的上下文阶梯和 service tier 规则，并按来源保留歧义候选；保存手动基础价格前会提示其将清除同步的高级规则（web/model-prices）。

Fixes

• 认证文件的状态切换、删除、额度冷却恢复和巡检操作会按规范凭据身份校验，并在共享物理文件上串行协调变更；目标陈旧或身份歧义时会安全拒绝，避免作用到其他凭据（manager-server/auth-files、web/auth-files）。
• 实时请求表统一按总请求延迟计算单一 TPS，并改进紧凑列对齐、Token 明细、失败诊断和提示浮层可读性（web/monitoring）。

Docs

• 中英文模型价格文档补充价格源优先级、同步故障回退、上下文阶梯、Fast/Priority 语义和手动覆盖边界（docs/model-prices）。

Upgrade Notes

• Manager Server 启动时会自动迁移模型价格规则、定价汇总状态和凭据身份记录，无需手动执行数据库或配置迁移。
• 凭据身份所有权与冷却唯一键迁移后，旧版二进制不保证兼容；升级前请备份 SQLite 文件与 data.key，如需精确回退到 v1.11.9，请恢复升级前备份。
• Fast/Priority 与上下文阶梯估算依赖 CPA 用量事件中的 service tier、上下文和缓存字段；缺失时会使用兼容回退，Provider 账单仍是最终依据。
• 模型价格同步仍需用户手动触发；现有价格只会在同步、确认候选或手动编辑时改变，CPA 路由与上游计费行为不变。

---

Full Changelog: v1.11.9...v1.11.10

v1.11.9

CPA Manager Plus v1.11.9

3 commits · 17 files changed · +781 / -172

English ->

Overview

本次发布提升用量数据处理的可靠性，并加强高风险删除操作的保护。账户历史汇总可在并发写入期间稳定追上进度，大规模监控筛选不再触发 SQLite 条件上限，AI Provider 与认证文件的手动删除则增加目标明确的第二次确认。

Highlights

Fixes

• 账户历史汇总在用量事件并发写入时会等待 SQLite 写入槽位，避免 WAL 快照失效导致汇总进度长期滞后（manager-server/sqlite）。
• 监控筛选通过单个 JSON 参数处理大量认证索引、Provider 和账户，避免大规模已保存筛选返回 SQLite 变量上限错误（manager-server/monitoring）。
• AI Provider 与认证文件的手动删除需要针对掩码目标、删除范围或受影响文件数完成第二次确认，降低永久误删风险（web/providers-auth-files）。

Upgrade Notes

• 本版本不包含数据库结构、API 或配置变更，无需手动迁移。
• 面板中的 AI Provider 与认证文件手动删除现在需要两次确认；OAuth 映射清理和巡检触发的自动删除保持原流程。

---

Full Changelog: v1.11.8...v1.11.9

v1.11.8

CPA Manager Plus v1.11.8

3 commits · 27 files changed · +6402 / -272

English ->

Overview

本次发布强化 Manager Server 凭证健康巡检的执行生命周期：跨实例使用可恢复的 SQLite 租约避免重复巡检，运行中的任务可由用户取消，服务重启及短暂 SQLite 写锁不会遗留无终态运行记录。

Highlights

Fixes

• 凭证健康巡检通过数据库租约在多个 Manager Server 实例间保持单实例执行，避免同一批凭证被重复巡检或并发处理（manager-server/codexinspection）。
• 运行中的凭证健康巡检可在监控面板请求停止；页面会显示取消中、已取消和中断状态，并保留已完成的结果与日志（web/monitoring）。
• 服务启动会恢复过期的巡检租约，关闭过程会等待进行中的巡检写入终态；短暂 SQLite 写锁不再阻塞整个巡检生命周期（manager-server/codexinspection）。
• 巡检的轮询、启动和取消请求以最新操作为准，避免旧响应在取消后重新显示任务仍在运行（web/monitoring）。

Upgrade Notes

• Manager Server 启动时会自动创建巡检租约表及过期索引；现有 usage.sqlite 不需要手动迁移。
• 服务关闭时仍在执行的巡检会以中断状态结束；升级或重启后可从监控页面重新发起。
• 此版本没有新增巡检配置项。

---

Full Changelog: v1.11.7...v1.11.8

v1.11.7

CPA Manager Plus v1.11.7

18 commits · 82 files changed · +16432 / -1171

English ->

Overview

本次发布为用量数据引入可续传导入与持久化小时汇总，在保留原始事件和兼容回退路径的前提下，让大规模历史数据导入和监控分析更可靠。同时，凭证巡检会呈现更准确的执行结果与日志，已验证的付费 xAI OAuth 凭证将使用官方 API 完成真实推理检查，并修复编辑抽屉在拖选文本时意外关闭的问题。

Highlights

Features

• 用量历史支持基于会话的分块上传、续传、取消与进度展示，可处理超过旧版单请求限制的大文件（manager-server/usage、web/monitoring）。
• Dashboard 和用量分析可从持久化 UTC 小时汇总与最新原始数据共同读取；不支持的筛选条件和时区边界会安全回退到原始事件查询（manager-server/usageaggregate）。
• 监控中心按当前标签加载分析数据，并将账户和 API Key 选择器与指标请求分离，减少无关标签的查询工作（web/monitoring）。
• 凭证巡检保留自动操作的详细结果、执行日志和待人工处理的冲突，同时继续对浏览器持久化内容进行脱敏（web/monitoring、manager-server/codexinspection）。

Fixes

• 已验证官方身份的付费 xAI OAuth 凭证会通过官方 Responses API 执行真实推理检查；缺少该证据时仍保留既有 CLI 路由（web/quota、manager-server/codexinspection）。
• 用量时间线的费用与加权延迟统计不再依赖存储行顺序，历史重复导入的身份首次发现时间也保持稳定（manager-server/analytics）。
• 抽屉仅在同一指针于遮罩按下并释放时关闭，避免在编辑输入框中拖选文本时意外关闭；直接点击遮罩关闭的行为保持不变（web/components/ui）。

Upgrade Notes

• Manager Server 会自动创建导入会话和用量汇总所需的 SQLite 表；原始用量事件会保留，本阶段不会启用历史数据删除。
• 旧版 /import 单请求接口仍限制为 64 MiB。更大的历史文件应通过 Manager Server 面板中的新会话导入流程处理。
• 导入会话默认使用 4 MiB 分块、16 GiB 临时磁盘配额、最多 2 个并发会话和 24 小时保留期；管理员可按部署容量调整相关配置。恢复密钥可恢复对应会话，应仅由管理员保管。
• xAI 路由修复不需要额外配置；只有已验证官方身份的付费 OAuth 凭证会切换到官方 API。

---

Full Changelog: v1.11.6...v1.11.7

v1.11.6

CPA Manager Plus v1.11.6

11 commits · 61 files changed · +6692 / -1975

English ->

Overview

本次发布将凭证健康巡检扩展到 Codex 与 xAI，并统一轻量 CPA Panel 的浏览器本地巡检和 Manager Server 的服务端巡检体验。xAI 默认采用计费优先检查，用户可按需启用最小化真实推理；结果页会区分计费、配额、认证、模型和推理故障，并提供响应式配置、脱敏失败详情与更清晰的运维入口。

Highlights

Features

• 凭证健康巡检支持 Codex 与 xAI Provider，可在浏览器本地和 Manager Server 工作流中使用一致的配置、筛选、配额窗口与结果展示（web/monitoring、manager-server/codexinspection）。
• xAI 巡检默认执行计费状态检查，并可显式启用基于待检凭据的最小化非流式 Responses 推理；模型、提示词与失败分类均按 Provider 处理（web/monitoring、manager-server/codexinspection）。
• 巡检结果可区分计费、配额、认证、模型与推理故障，保留脱敏 HTTP 证据和可展开的完整失败详情，同时不在结果列表暴露 auth_index（web/monitoring）。
• 巡检配置抽屉、筛选器、状态面板与结果卡片已适配桌面和移动端，本地巡检与服务端定时巡检的设置及操作状态保持一致（web/monitoring）。

Docs

• 双语 README 重新组织监控问题、截图和面板选择说明，保留既有四张截图，并补充 Runtime Model、备份、管理员密钥恢复和旧版迁移入口（docs/readme）。

Upgrade Notes

• 现有 Codex-only 巡检配置继续兼容，无需数据库迁移，也无需调整 Compose、环境变量、路由或存储协议。
• xAI 真实推理默认关闭；启用后会通过待检凭据发送最小化的非流式 Responses 上游请求。
• 轻量 CPA Panel 支持浏览器本地巡检；定时巡检与历史记录仍需要 Manager Server。

---

Full Changelog: v1.11.5...v1.11.6