深入CodexManager架构Tauri Next.js Rust Service三端分工与协作解锁Codex CLI账号管理与本地网关【免费下载链接】Codex-Manager一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。项目地址: https://gitcode.com/gh_mirrors/co/Codex-ManagerCodexManager 是一个Codex CLI 账号管理与切换工具它为 Codex CLI 提供本地网关转发能力帮你统一管理多个 OpenAI 账号、查看用量、配置模型路由。这篇文章带你用最短的路线看懂它的整体架构Next.js 前端 Tauri 桌面壳 Rust Service 三端如何分工、又如何协作。一句话看懂三端分工CodexManager 采用经典的前端负责展示、壳层负责系统能力、服务层负责核心逻辑三层架构仓库中对应三大目录端技术栈目录一句话职责前端 UINext.js TypeScriptapps/src/页面渲染、用户交互、状态管理桌面壳Tauri (Rust)apps/src-tauri/窗口、托盘、单实例、自动更新、命令桥接核心服务Rust (Axum Tokio)crates/service/账号管理、本地网关、协议适配、请求日志官方架构文档对三者的职责划分写得很清楚建议作为入门索引阅读docs/zh-CN/ARCHITECTURE.md。Next.js 前端管理与展示的统一入口前端基于Next.js App Router开发路由即页面核心页面一目了然仪表板apps/src/app/page.tsx网关状态、账号池余量、用量趋势图表账号池管理apps/src/app/accounts/page.tsx账号增删、排序、重置额度模型与路由apps/src/app/models/page.tsx模型目录、价格、路由规则请求日志、系统设置、插件中心等页面同样按路由组织关键设计统一传输层 transport.ts前端最巧妙的地方在于 apps/src/lib/api/transport.ts。它把调用后端抽象成了同一个invoke()接口桌面模式走 Tauri 的invoke命令直达 Tauri 壳再由壳转发给本地 serviceWeb / Docker 模式自动降级为 HTTP JSON-RPC请求走 service 的网络接口。这意味着同一份前端代码在桌面端和浏览器端都能跑业务代码几乎不需要感知运行环境差异。Tauri 桌面壳把 Web 应用变成像系统软件一样的桌面应用apps/src-tauri/ 是典型的薄壳设计Rust 代码只做四件事桌面行为窗口管理、系统托盘、开机自启、单实例控制service_runtime.rs 负责内嵌 service 进程的生命周期命令注册commands/registry.rs 统一注册前端可调用的命令按账号、API Key、用量、设置等领域拆分子模块RPC 转发通过 rpc_client/ 与本地 service 通信桌面壳本身不实现业务逻辑自动更新桌面端专属的应用内更新能力。这种壳薄、服务厚的分工让桌面端几乎不会成为逻辑变更的瓶颈。Rust Service本地网关与账号管理的心脏crates/service/ 是整个项目最重的部分也是本地网关能力的真正实现地。其内部按领域清晰分目录gateway/本地网关核心——请求校验、账号选路routing/、上游鉴权auth/、协议适配protocol_adapter/、流式/非流式响应转换与可观测性。目录职责详见 crates/service/src/gateway/README.mdaccount/、apikey/账号与平台 Key 的领域逻辑requestlog/、usage/请求日志与用量统计是仪表盘图表的数据来源http/、rpc_dispatch/对外暴露的两套入口——HTTP网关转发用与 RPC管理界面用。一次网关请求的完整链路Codex CLI 把 API 地址指向 CodexManager 后一次请求会经过请求进入 service 的HTTP 网关层Axum Router负责限流背压、trace、请求 IDgateway/request/ 规范化请求gateway/routing/ 按策略有序ordered/ 均衡balanced选出账号gateway/upstream/ 补全上游鉴权、发送请求支持超时、重试、代理gateway/protocol_adapter/ 完成/v1/chat/completions、/v1/responses、SSE 流式等协议的出入站转换结果回写请求日志与 Token 统计再返回给 Codex CLI。数据存储上crates/core/migrations/ 中的 136 个 SQL 迁移文件演进出了账号、API Key、请求日志、用量快照等全套表结构Service 模式还可通过 crates/storage-seaorm/ 切换到 MySQL / PostgreSQL。两种运行模式一套代码得益于三端解耦CodexManager 支持两种部署形态桌面模式Tauri 壳 内嵌 service开箱即用适合个人使用scripts/rebuild.ps1、scripts/rebuild-macos.sh 等脚本可构建各平台桌面包Service 模式codexmanager-servicecodexmanager-web 一键启动器 crates/start/适合服务器或 Docker 部署配套 docker/docker-compose.yml。小结这套架构值得借鉴的三点传输层抽象一份 Next.js 前端同时适配 Tauri IPC 与 HTTP RPC跨端零成本壳薄服务厚Tauri 只承担系统级能力业务全部收敛在 Rust service改逻辑不用碰桌面壳领域分目录service 内部按 account / apikey / gateway / usage / requestlog 划分网关还进一步拆成 routing、auth、upstream 等子模块新增协议兼容有明确落点。如果你想继续深入推荐阅读 docs/zh-CN/ARCHITECTURE.md 中的请求链路概览与 docs/zh-CN/report/运行与部署指南.md从桌面模式跑通后再看 Service 模式基本就能完整掌握 CodexManager 的架构全貌。【免费下载链接】Codex-Manager一个Codex cli 账号管理与切换工具。为 Codex cli提供本地网关转发。项目地址: https://gitcode.com/gh_mirrors/co/Codex-Manager创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考