cpa-plugin/AGENTS.md

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 了解计划