CodexManager

本地桌面端 + 服务进程的 Codex 账号管理器+网关转发

English| GitHub 主仓库| 官网| 赞助商

本地桌面端 + 服务进程的 Codex 账号池管理器

统一管理账号、用量与平台 Key，并提供本地网关能力。

## 源码说明： ## 免责声明 - 本项目仅用于学习与开发目的。 - 使用者必须遵守相关平台的服务条款（例如 OpenAI、Anthropic）。 - 作者不提供或分发任何账号、API Key 或代理服务，也不对本软件的具体使用方式负责。 - 请勿使用本项目绕过速率限制或服务限制。 ## 首页导览 | 你要做什么 | 直接进入 | | --- | --- | | 首次启动、部署、Docker、macOS 放行 | [运行与部署指南](docs/report/运行与部署指南.md) | | 配置端口、代理、数据库、Web 密码、环境变量 | [环境变量与运行配置](docs/report/环境变量与运行配置说明.md) | | 排查账号不命中、导入失败、挑战拦截、请求异常 | [FAQ 与账号命中规则](docs/report/FAQ与账号命中规则.md) | | 排查后台任务账号跳过、禁用与停用原因 | [后台任务账号跳过说明](docs/report/后台任务账号跳过说明.md) | | 插件中心最小接入、快速对接 | [插件中心最小接入说明](docs/report/插件中心最小接入说明.md) | | 对接插件中心、查看接口清单、市场模式与 Rhai 接口 | [插件中心对接与接口清单](docs/report/插件中心对接与接口清单.md) | | 系统全部可对接内部接口 | [系统内部接口总表](docs/report/系统内部接口总表.md) | | 本地构建、打包、发版、脚本调用 | [构建发布与脚本说明](docs/release/构建发布与脚本说明.md) | ## 最近变更 - 当前最新版本：`v0.1.14`（2026-03-30） - 这一版主要围绕“更稳的服务”和“更好接入”两条线收口：入口层新增短队列等待 + 超载快速退化，设置页新增“系统推导”和“单账号并发上限”，在任何机器上都能先排队、再退化，不会轻易把进程拖死。 - 插件中心和接入文档继续补全：README 增加了插件中心预览图，插件中心最小接入说明、完整接口清单、系统内部接口总表都已补齐，外部对接更容易。 - 长期保留文档统一去掉了日期前缀，README 和 docs 的链接也一起切到了稳定文件名，后续维护更容易。 - 定时脚本入口已经挂到账号页，默认每分钟执行一次，用户仍然可以自行调整；同时补了系统内部接口总表，方便宿主和插件对接。 - 这轮版本收口也已完成：workspace、前端包、Tauri 桌面端、校验脚本和 README 的版本说明已统一到 `0.1.14`。 ### 近期提交摘要 - `8c9299f`：发布版本提升到 `0.1.14`，workspace、前端包、Tauri 桌面端与发布校验脚本统一对齐。 - `85022b9`：完善高并发保护与文档。入口层改为短队列等待 + 超载快速退化，设置页新增系统推导和单账号并发上限。 - `a6a96d6`：README 增加插件中心预览图。中英文 README 的截图预览区都补上了 `plugin.png`。 - `ec03f2c`：去除长期文档日期前缀。长期保留的文档已统一去掉时间戳文件名，并同步修正多个 README 引用。 - `927142a`：调整定时脚本默认间隔。定时脚本默认改为每分钟执行，用户仍可手动自定义。 - `028c8c8`：增加定时脚本入口和内部接口总表。账号页新增定时脚本入口，文档补齐系统内部接口清单。 - `885edd0`：完善插件中心文档与接入说明。插件中心最小接入说明与完整接口清单已补齐。 ## 功能概览 - 账号池管理：分组、标签、排序、备注、封禁识别与封禁筛选 - 批量导入 / 导出：支持多文件导入、桌面端文件夹递归导入 JSON、按账号导出单文件 - 用量展示：兼容 5 小时 + 7 日双窗口，以及仅返回 7 日单窗口的账号，并展示对应窗口的重置时间 - 授权登录：浏览器授权 + 手动回调解析 - 平台 Key：生成、禁用、删除、模型绑定、推理等级、服务等级（跟随请求 / Fast / Flex） - 聚合 API：管理第三方最小转发上游，支持创建、编辑、测试连通性、供应商名称、顺序优先级，以及按 Codex / Claude 分类展示 - 插件中心：路由为 `/plugins/`，支持内置精选、企业私有、自定义源三种市场模式，并提供插件清单、任务、日志与 Rhai 对接接口 - 设置页：支持“系统推导”按钮、单账号并发上限，以及更保守的高并发退化策略 - 系统内部接口总表：列出当前桌面端与服务端所有可对接命令、RPC 方法、以及插件内建函数 - 本地服务：自动拉起、可自定义端口与监听地址 - 本地网关：为 CLI 和第三方工具提供统一 OpenAI 兼容入口 ## 截图        ## 快速开始 1. 启动桌面端，点击“启动服务”。 2. 进入“账号管理”，添加账号并完成授权。 3. 如回调失败，粘贴回调链接手动完成解析。 4. 刷新用量并确认账号状态。 ## 默认数据目录 - 桌面端默认会把 SQLite 数据库写到应用数据目录下，文件名固定为 `codexmanager.db`。 - Windows：`%APPDATA%\\com.codexmanager.desktop\\codexmanager.db` - macOS：`~/Library/Application Support/com.codexmanager.desktop/codexmanager.db` - Linux：`~/.local/share/com.codexmanager.desktop/codexmanager.db` - 如需调整数据库、代理、监听地址等运行配置，可继续查看 [环境变量与运行配置](docs/report/环境变量与运行配置说明.md)。 ## 页面展示 ### 桌面端 - 账号管理：集中导入、导出、刷新账号与用量，支持低配额 / 封禁筛选与重置时间展示 - 平台 Key：按模型、推理等级、服务等级绑定平台 Key，并查看调用日志 - 插件中心：`/plugins/` 路由，内置精选 / 企业私有 / 自定义源市场切换，插件安装、启停、任务、日志、Rhai 对接 - 设置页：统一管理端口、监听地址、代理、主题、自动更新、后台行为 ### Service 版 - `codexmanager-service`：提供本地 OpenAI 兼容网关 - `codexmanager-web`：提供浏览器管理页面 - `codexmanager-start`：一键拉起 service + web ## 常用文档 - 版本历史：[CHANGELOG.md](CHANGELOG.md) - 协作约定：[CONTRIBUTING.md](CONTRIBUTING.md) - 架构说明：[ARCHITECTURE.md](ARCHITECTURE.md) - 测试基线：[TESTING.md](TESTING.md) - 安全说明：[SECURITY.md](SECURITY.md) - 文档索引：[docs/README.md](docs/README.md) ## 专题页面 | 页面 | 内容 | | --- | --- | | [运行与部署指南](docs/report/运行与部署指南.md) | 首次启动、Docker、Service 版、macOS 放行 | | [环境变量与运行配置](docs/report/环境变量与运行配置说明.md) | 应用配置、代理、监听地址、数据库、Web 安全 | | [FAQ 与账号命中规则](docs/report/FAQ与账号命中规则.md) | 账号命中、挑战拦截、导入导出、常见异常 | | [后台任务账号跳过说明](docs/report/后台任务账号跳过说明.md) | 后台任务过滤、禁用账号、workspace 停用原因 | | [最小排障手册](docs/report/最小排障手册.md) | 快速定位服务启动、请求转发、模型刷新异常 | | [插件中心对接与接口清单](docs/report/插件中心对接与接口清单.md) | 插件中心路由、市场模式、Tauri/RPC 接口、清单字段、Rhai 内建函数 | | [构建发布与脚本说明](docs/release/构建发布与脚本说明.md) | 本地构建、Tauri 打包、Release workflow、脚本参数 | | [发布与产物说明](docs/release/发布与产物说明.md) | 各平台发版产物、命名、是否 pre-release | | [脚本与发布职责对照](docs/report/脚本与发布职责对照.md) | 各脚本负责什么、什么场景该用哪个 | | [协议兼容回归清单](docs/report/协议兼容回归清单.md) | `/v1/chat/completions`、`/v1/responses`、tools 回归项 | | [当前网关与 Codex 请求头和参数差异表](docs/report/当前网关与Codex请求头和参数差异表.md) | 当前网关参数传递、请求头和请求参数与 Codex 的对照说明 | | [系统内部接口总表](docs/report/系统内部接口总表.md) | 桌面端、服务端、插件中心全部可对接内部接口 | | [CHANGELOG.md](CHANGELOG.md) | 最新发版内容、未发版更新与完整版本历史 | ## 目录结构 . ├─ apps/ # 前端与 Tauri 桌面端 │ ├─ src/ │ ├─ src-tauri/ │ └─ dist/ ├─ crates/ # Rust core/service │ ├─ core │ ├─ service │ ├─ start # Service 版本一键启动器（拉起 service + web） │ └─ web # Service 版本 Web UI（可内嵌静态资源 + /api/rpc 代理） ├─ docs/ # 正式文档目录 ├─ scripts/ # 构建与发布脚本 └─ README.md ## 鸣谢与参考项目 - Codex（OpenAI）：本项目在请求链路、登录语义与上游兼容行为上参考了该项目的实现与源码结构 ## 联系方式 - 公众号：七线牛马 - 微信： ProsperGao - 交流群：答案是项目名：CodexManager - Telegram 群聊：[CodexManager TG 群](https://t.me/+OdpFa9GvjxhjMDhl)

标签：AI 开发工具, Anthropic, API Key 管理, API 代理, CIS基准, Codex CLI, Docker, OpenAI, 内存规避, 反向代理, 可视化界面, 多账号切换, 安全防御评估, 开源, 服务进程, 本地网关, 桌面端, 网关转发, 网络调试, 自动化, 请求拦截, 负载均衡, 账号池, 账号管理, 通知系统, 额度用量管理