Willxup/cpa-usage-keeper

CPA Usage Keeper – 功能简介

目的 – CPA Usage Keeper 是一个监控仪表板，用于CLIProxyAPI (CPA)，一个与AI模型（OpenAI、Anthropic等）通信的命令行代理。它记录CPA转发的每个请求，将数据存储在本地SQLite数据库中，并在Web UI中呈现信息，以便您查看花费金额、模型响应速度以及API密钥配额是否耗尽。

主要功能

• 历史持久化 – CPA请求日志写入SQLite并自动备份。
• 成本分析 – 按模型、提供商和API密钥分解使用情况；查看估算的货币成本和缓存命中率。
• 请求诊断 – 查看单个请求的详细信息，导出它们，并检查成功率、首令牌时间(TTFT)和总延迟等指标。
• 配额跟踪 – 监控每个凭据的剩余配额，刷新配额信息，并查看历史配额变更（例如，Codex配额）。
• 只读共享 – 生成一个限定了范围的只读视图，可以与团队成员共享。
• 可选的社区排名 – 拉取社区生成的模型/凭据排名。

打包方式

• Docker镜像（GHCR），附带官方Docker-Compose模板，用于完整的CPA + Keeper堆栈或Keeper独立堆栈。
• 适用于macOS的Homebrew公式。
• 预构建的Linux和Windows二进制文件（附带Linux的systemd服务模板）。
• 所有部署都包含登录密码（默认启用身份验证）。

典型工作流程

1. 在CPA配置中启用使用统计（observability.usage.usage-statistics-enabled: true）。
2. 部署Keeper（推荐使用Docker-Compose）。通过.env提供CPA基础URL、CPA管理密钥和Keeper登录密码。
3. 打开http://<host>:8080并登录。
4. 仪表板显示概述（总请求数、成本）、实时诊断（实时请求速率）、使用分析（每个模型/API密钥的成本）、请求事件（单个调用的列表）和配额历史。

技术概述

• 后端：Go 1.26+；使用标准库构建的HTTP API，使用SQLite进行持久化，后台轮询器同步CPA使用量和配额数据。
• 前端：React + TypeScript，由Go服务器提供服务。
• 可通过环境变量（APP_HOST、APP_PORT、APP_BASE_PATH、TRUSTED_PROXY_CIDRS等）进行扩展。
• 可选Redis队列支持，适用于高吞吐量场景。

适用人群

• 运行自托管CPA实例并需要了解模型支出和配额健康状况的团队。
• 希望在没有自定义日志记录的情况下快速审核AI API使用情况的开发人员。
• 偏好Docker或Homebrew部署并希望获得轻量级、受密码保护的仪表板的运维团队。

开始使用 – 请参阅README中的“快速入门”部分，了解Docker-Compose命令、Homebrew安装或二进制下载。该项目还提供了一个make verify目标，用于运行单元测试和代码检查。

---

所有细节均直接取自存储库的README；未推断任何额外功能。