# billing

当前项目的本质是对 `CLIProxyAPI` 的核心扩展，功能边界会非常收敛

- 更好的统计、展示
- 初期优先保证codex的正常使用
- 能最简单的管理多用户key

## 参考

- `CLIProxyAPI` 原始项目
- `cpa-plugin-key-billing` CLIProxyAPI 下游 API Key 计费与订阅额度插件
- `cpa-usage-keeper` 用量持久化与分析面板

## 参考仓库边界

`.externals/CLIProxyAPI/`、`.externals/cpa-plugin-key-billing/`、`.externals/cpa-usage-keeper/` 都不是本项目的实际开发仓库，只用于测试、契约核对和实现对比。

- 默认不检查这些目录的 Git 状态、提交历史、分支、远端或工作区改动。
- 不为这些仓库修复问题，不修改或提交其中的代码，也不处理其 Git 状态。
- 上述限制不影响运行时测试：可直接加载已经构建好的参考插件；测试 CPA 插件组合时，按需启用 `cpa-key-billing` 作为对照插件，但不得因此进入其仓库做源码或 Git 操作。
- 只有在 billing 的兼容性验证、测试或实现判断确有必要时，才按最小范围只读查看相关文件。
- 需要修改、构建、提交或维护任一参考仓库时，必须由用户明确提出。
- 项目的实现、提交和工作区清洁度只以 billing 根仓库为准。

## DO

- 阅读 `docs/dev.md` 了解开发前置知识
- 阅读 `TODOS.md` 了解计划