CPA Manager Plus v1.11.12
16 commits · 71 files changed · +9754 / -872
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