CGswitch

用档案管理 Codex / ChatGPT 的模型与供应商配置，随时切换，安全应用。

CGswitch 是什么？

CGswitch 是一个面向 Codex / ChatGPT 桌面应用的配置管理工具。

它把不同模型、API 供应商和 ChatGPT 订阅账号保存为独立的“配置档案”。需要切换时，选择档案并点击应用即可；应用会更新 ~/.codex 下的相关文件，并可按设置自动重启 Codex。

你可以把它理解为：

当前配置 / 内置模板 / 自定义配置
              ↓
       保存为多个配置档案
              ↓
      编辑、测试、切换、恢复

功能

配置档案

• 捕获当前 ~/.codex/config.toml，保存为可随时恢复的档案
• 内置 DeepSeek、MiniMax、智谱、ChatGPT、OpenCode、OpenRouter、小米 MiMo 模板
• 支持自定义供应商和自定义 config.toml
• 新建自定义供应商时 config.toml / models.json / auth.json 三个槽位选填，填了才保存
• 重命名、复制、排序、删除档案
• 为档案设置供应商图标、管理后台地址和显示名称

编辑与应用

• 在应用内编辑 config.toml、models.json 和 auth.json
• CodeMirror 编辑器提供 TOML / JSON 语法高亮
• 保存前校验 TOML / JSON 格式
• 从供应商的 /models 端点获取可用模型列表，直接在下拉中选择
• 应用配置时只更新相关字段，尽量保留 MCP、插件、注释等其他内容
• 支持绑定 ChatGPT 订阅账号到指定档案

连接与用量

• 测试第三方供应商的 API 连通性、状态码和延迟
• 测试 ChatGPT 订阅认证是否有效
• 查看 DeepSeek 余额
• 查看 MiniMax 余额或 Token Plan 用量与重置时间
• 查看智谱 GLM 用量（5 小时 / 7 天窗口），用量类供应商统一展示「用量」
• 余额和用量支持按供应商开启，成功结果会在本地缓存

ChatGPT 账号

• 使用 OAuth 设备码登录 ChatGPT
• 管理多个 ChatGPT 订阅账号
• 设置默认账号，或将账号绑定到具体配置档案
• 支持移除账号并同步更新本地认证文件

桌面体验

• 自动检测 Codex / ChatGPT 桌面应用运行状态
• 应用配置后按需自动重启 Codex
• 支持浅色、深色和跟随系统主题
• 支持开机自启、静默启动和关闭时最小化到托盘
• Windows 与 macOS 桌面应用支持

备份与恢复

• 修改配置文件前自动创建备份
• 支持数据库导入 / 导出
• 支持查看、重命名、恢复和删除数据库备份
• 数据库、配置文件和关联的 Codex 文件分别保存备份

安全与数据位置

CGSwitch 的档案、设置、账号信息和本地备份都保存在用户目录，不写入项目仓库：

~/.cgswitch/
├── settings.json
├── cgswitch.db
├── balance-cache.json
└── backups/
    ├── config/
    ├── database/
    └── codex-files/

Codex 原始配置仍位于：

~/.codex/config.toml
~/.codex/models.json
~/.codex/auth.json

API Key、OAuth 凭据和其他敏感内容只保存在本机。请不要将 .cgswitch/、数据库、备份或认证文件提交到 Git，也不要把它们分享给他人。

支持的使用方式

1. 使用内置模板

在首页添加供应商，选择内置模板，填写 API Key 或绑定 ChatGPT 账号，然后保存。

2. 捕获当前配置

先手动调整 ~/.codex/config.toml，回到 CGSwitch 点击“捕获当前配置”，即可把当前状态保存为档案。

3. 应用配置

选择目标档案，点击“应用”。CGswitch 会在写入前备份相关文件，完成后按设置决定是否重启 Codex。

开发

环境要求

• Node.js
• pnpm
• Rust 工具链
• Tauri 2 的系统开发依赖

启动开发环境

pnpm install
pnpm dev:tauri

pnpm dev:tauri 会启动 Vite 和 Tauri 调试应用。React / CSS 修改会通过 Vite Fast Refresh 更新，Rust 修改会由 Tauri dev 自动重新编译。

调试构建

pnpm build:debug

调试产物位于 src-tauri/target/debug/bundle/。

构建发布包

pnpm tauri build

发布产物位于 src-tauri/target/release/bundle/，包括 Windows NSIS / MSI 和 macOS DMG。当前安装包未签名，macOS 首次打开时可能需要在系统设置中手动允许。

技术栈

• React 19 + TypeScript
• Vite + Tailwind CSS
• Tauri 2 + Rust
• SQLite
• CodeMirror 6
• Radix UI + 原生 HTML 控件

许可证

本项目采用 MIT License。供应商图标来自 thesvg.org，各 SVG 文件头保留了对应的来源声明。

欢迎通过 Issues 反馈问题和建议。