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