1. 项目定位与用途
MeowCLI 是一个高性能 API 转发服务，定位为智能调度与高可用的代理层。其核心用途是作为统一接入点，将客户端请求转发至上游 API（如 Codex），并自动管理多个凭据的负载均衡与故障转移。它通过综合评分机制选择最优凭据，避免额度不足或速率限制导致的失败，从而提升整体请求成功率与响应速度。服务提供完整的 Web 管理面板，便于配置模型映射、密钥分发和监控状态。
项目档案命令行工具
nekohy/MeowCLI CLI 工具：安装、命令与使用场景
nekohy/MeowCLI：MeowCLI 是一个专注于高性能与智能调度的 API 转发服务，通过综合评分机制自动选择最优上游凭据，并提供熔断与缓存优化，适用于多凭据聚合场本页整理它解决什么问题、适用场景、安装方式和使用方法。
AI 总结
MeowCLI 是一个专注于高性能与智能调度的 API 转发服务，通过综合评分机制自动选择最优上游凭据，并提供熔断与缓存优化，适用于多凭据聚合场景。
中文项目介绍
MeowCLI 是一个注重高性能与更优调度的 API 转发服务，旨在为多凭据、多套餐类型的 API 调用提供统一接入点与智能路由。
项目解决的主要问题包括：如何动态评估凭据的剩余额度与重置时间以做出最优选择；如何在凭据失败时自动熔断并重试；如何通过缓存降低数据库延迟；以及如何提供友好的管理界面进行配置与监控。
适用场景涵盖需要聚合多个 API 凭据（如不同套餐）的代理服务；对转发性能与调度策略有较高要求的应用；以及需要 Web 管理界面进行模型映射、密钥分发和基础监控的场景。
技术特征上，MeowCLI 支持 SQLite 与 PostgreSQL 双数据库，使用 sqlc 生成优化查询代码；采用 otter 缓存库与 atomic 操作提升性能；前端基于 Nuxt SSG 构建；核心调度器实现综合评分与指数退避熔断；并提供完整的 admin 管理 API。日志默认保存在内存中，服务重启后清空。
详细信息与使用说明
2. 解决的问题
MeowCLI 解决了多凭据环境下的智能调度问题：通过结合 5 小时和 7 天窗口的剩余额度与重置时间进行综合评分，优先选择最优凭据；在凭据失败后，基于 Retry-After 或指数退避实现临时熔断，避免连续失败；后台定时拉取上游 Quota 以保持凭据状态新鲜；使用 atomic 和 otter 缓存规避 SQL 操作延迟，并自动刷新 access_token。此外，它还提供了统一的管理界面，简化了模型映射、密钥管理和日志查看等运维操作。
3. 适用场景
适用场景包括：需要聚合多个 API 凭据（如不同套餐类型）并提供统一接入点的代理服务；对转发性能与调度策略有较高要求，需自动规避额度不足或速率限制凭据的应用；需要 Web 管理界面进行模型映射、密钥分发和基础监控的场景；以及希望使用 SQLite 或 PostgreSQL 作为后端存储，并借助 sqlc 优化查询的项目。当前主要支持 Codex 上游，后续计划扩展 GeminiCLI 等。
4. 安装方式
安装需确保环境：Go 1.25+、Node.js 22+、sqlc 工具。配置数据库：设置 DATABASE_URL 环境变量（默认使用 SQLite 文件 meowcli.db），可选 DB_TYPE 为 sqlite 或 postgres。构建方式：运行 make
思维导图
当前仓库信息不足，或结构不够稳定，暂时没有生成可靠的思维导图。
常见问题
nekohy/MeowCLI 是做什么的？
MeowCLI 是一个专注于高性能与智能调度的 API 转发服务，通过综合评分机制自动选择最优上游凭据，并提供熔断与缓存优化，适用于多凭据聚合场景。
nekohy/MeowCLI 适合用在什么场景？
MeowCLI 是一个高性能 API 转发服务，定位为智能调度与高可用的代理层。其核心用途是作为统一接入点，将客户端请求转发至上游 API（如 Codex），并自动管理多个凭据的负载均衡与故障转移。它通过综合评分机制选择最优凭据，避免额度不足或速率限制导致的失败，从而提升整体请求成功率与响应速度。服务提供完整的 Web 管理面板，便于配置模型映射、密钥分发和监控状态。
nekohy/MeowCLI 如何安装？
安装需确保环境：Go 1.25+、Node.js 22+、sqlc 工具。配置数据库：设置 DATABASE_URL 环境变量（默认使用 SQLite 文件 meowcli.db），可选 DB_TYPE 为 sqlite 或 postgres。构建方式：运行 make
nekohy/MeowCLI 如何开始使用？
仓库中未明确给出完整使用步骤，建议结合 README、示例代码或文档章节开始上手。