v2.7.0

v2.7.0 - 2026-10-08

本版本新增 CPA v8 凭证额度周期统计。存储快照升级为 v3，旧版插件无法读取，升级前请备份数据目录。普通用量统计在 CPA v7 与 v8 上均可使用；额度周期需要 CPA v8。

升级须知

• 升级前停用插件，备份整个 storage_path 目录与模型价格文件。升级后核对总请求数、token、成本，以及 /health 中的存储错误。
• 首次以本版本关闭或定时快照后，快照版本变为 3。回退到 v2.6.6 时必须同时恢复升级前的数据目录；旧插件不能直接读取 v3 快照。实验性 SQLite 迁移工具会拒绝 v3 快照，避免丢弃额度数据。
• macOS 构建会将插件动态库保留到 CPA 进程退出；更新或覆盖插件文件后请重启 CPA，以释放旧映像。
• 无需新增配置。

凭证额度周期（新增，需要 CPA v8）

• 上游接口详情新增可折叠的「额度周期」面板，位于来源分布与错误统计之间，默认收起，刷新时保留展开状态。仅显示上游实际提供的窗口：Claude 5h/7d、Codex 主/次及附加窗口、Devin 日/周，以及 Antigravity 独立额度组的 5h/周。
• 本期与上期分别展示请求、总 token（M）、实际花费、上游已用比例、实时重置倒计时和模型分布。达到 100% 时显示按已记录花费计算的「真实总额度」；未用满时显示「推算总额度 = 本周期实际花费 ÷ 已用比例」及预计剩余。检测到已用比例下降时按重置处理，从新观测重新累计。
• 模型表显示请求、成功、失败、花费、费用占比、缓存命中率，以及「仅用此模型预计总 token = 推算总额度 × 该模型总 token ÷ 该模型实际花费」。金额或价格未知时显示 —，显式零价保持为 0。
• Claude/Codex 优先读取原生 usage 响应头；看板复用管理鉴权读取 v8 凭证列表并提交观测。Antigravity 通过管理鉴权的上游查询读取，只在展开当前接口时自动查询，间隔至少 5 分钟，支持手动刷新。上游未提供模型归属时，只显示比例、重置时间和周期历史，不分摊请求或推算金额。
• 额度按凭证统计所有客户端的请求，不受页面时间范围和客户端筛选截断。空闲任意时长后仍保留最近一次已完成的上期。
• 周期事实和观测纳入 JSONL、v3 存储快照、完整备份与导入；事件明细上限和普通保留期不会删除仍被本期/上期使用的记录。导入删除标记同时回退主账与额度统计，乱序观测与备份合并保留最近的完整上期。
• 新增管理接口 POST /dashboard-quota-observations：校验宿主凭证身份后保存观测，返回接受、跳过、拒绝数量及被拒绝条目的下标 rejected_indexes，不增加请求计数。/dashboard-api-detail 增加可选的 credential_quota_cycles 与 quota_credentials。详见额度周期说明。

修复

• 超长模型名或记录 ID 不再写入额度事实和删除标记，修复重启加载快照失败后关闭持久化的问题。
• Codex 相对重置时间提前几分钟时保留并对齐上期；周期切换后迟到的漂移观测归入已结束的上期，不再清空其样本。
• 重启后重新提交的相同观测不再重复保存；看板只对被拒绝的观测等待 5 分钟后重试，不再每次轮询重发整批。
• Antigravity 查询中途折叠面板或切换接口时，保留之前的「额度读取失败」提示。
• Antigravity 额度解析不再把布尔值、数组等异常输入当作 0%/100%；跳过空条目与无效额度池，保留同一响应中的有效额度池。
• 重置卡改变到期时间后，合并重置前后的备份不再丢失重置边界或将重置前花费计入当前统计。
• 升级后 Antigravity 历史请求没有额度事实时，从所选接口保留的请求记录发现凭证，允许首次查询。
• 先到达的窗口撤销标记在周期历史过期后仍保留，防止迟到观测重新显示已撤销额度；未满额的比例不会四舍五入显示为 100%。
• 插件重新启用后不再复用旧条件缓存，ETag 包含实例标识；浏览器会重新提交内存模式下的额度观测。
• 修复 macOS 动态库卸载时 Go 运行时仍存活导致的退出卡住；重新启用时重建已关闭的统计与导出服务。
• 修复移动端额度模型表被压缩成逐字竖排的问题。

验证

• 完整 go test -race、go vet 与 201 项前端测试通过。
• 未修改的 stock CPA v7.2.152 镜像上完整 HTTP 验收通过，覆盖管理鉴权、匿名资源别名拒绝、导入去重、改价、冻结导出、完整备份、优雅重启与 SIGKILL 恢复。
• 从正式发布的 v2.6.6 升级：明细被截断的数据目录升级后累计值不重复，升级后新增请求正常入账，再次重启保持稳定。
• CPA v8.0.8 源码夹具上额度周期 HTTP 验收通过，包括两次重启后的恢复。
• 在 CPA v8.0.8 上使用一份 6652 条请求的真实数据副本，从旧插件升级并连续重启 3 次，请求、成功/失败、token 与花费均保持一致，快照为 v3，无插件错误日志。

已知边界

• 金额推算以本插件记录的花费为基础；中途开始记录、缺失记录、凭证在其他地方使用或上游观测延迟，都会使推算偏差。上游比例可能存在取整或非美元计费规则，推算仅供参考。
• 读取 v8 凭证列表失败后，看板等待 5 分钟再重试，以免在 CPA v7 上持续请求不存在的接口。
• 浏览器关闭期间，原生 usage 继续入账；仅存在于宿主凭证列表中的新观测要等看板再次打开后才能保存。
• 内存和磁盘开销随额度周期保留的真实请求数增长。

Full Changelog: v2.6.6...v2.7.0