Codex++ — Codex 桌面应用的管理层

Codex++（项目名称：BigPizzaV3/CodexPlusPlus）是官方 OpenAI Codex / ChatGPT 桌面应用的一款配套管理工具。它在原有应用之上增加了一个“++”层：统一控制 AI 提供商和模型、优化聊天会话，以及自定义工作区。

功能介绍

打开 Codex++ 配置窗口，完成设置后，点击 启动 即可按你的配置启动官方 Codex 应用。Codex++ 通过 Chrome DevTools 协议（CDP）和内置运行时服务工作。它不会修改官方应用的 app.asar 文件，也不会在安装目录中写入补丁文件。

核心功能

提供商与模型管理

• 四种使用模式：官方登录、官方登录 + API（请求始终通过你配置的 API 发送）、纯 API（无需官方账号）以及聚合提供商。
• 聚合提供商有两种类型：故障转移（失败时在提供商间切换，支持轮询/加权）和模型聚合（将每个模型路由到特定的成员提供商）。成员可以是 API 提供商或已登录的官方账号。
• 按模型设置：为每个模型设置自定义上下文窗口和自动压缩阈值（例如 deepseek-v4-pro[1M]）。
• 模型选择器按提供商分组，支持折叠/展开，显示提供商名称和模型数量。
• 原生快速解锁：允许纯 API 密钥用户在受支持的模型上使用 Codex 原生 Standard / ⚡ Fast 控件（默认关闭；实际速度和计费取决于提供商）。

会话管理

• 扫描、删除（可撤销）和批量管理本地会话。
• 将会话导出为 Markdown，查看 token 历史，移动项目，以及查看线程 ID。

请求可靠性

• 请求缓冲：当上游提供商返回过载错误（server_overloaded、at capacity 等）时自动重试，避免短暂拥堵中断会话。两种模式：流式（保持实时输出，首 token 后将过载错误交给 Codex 原生重试）和全缓冲（缓冲完整响应，重试任何过载——但会丢失流式输出）。
• 请求状态行显示当前阶段、模型、已用时间、重试次数和最后失败原因。

工作区增强

• 输入框下方的使用状态栏：实时生成速度、缓存命中率和上下文使用情况（数据来自本地 Codex 会话记录）。
• 输入与阅读舒适性：语音输入、粘贴修复、会话宽度、滚动位置恢复、下一步建议、答案大纲和光标打字效果（彩虹粒子、烟花、星光）。
• 扩展：浏览和安装社区用户脚本（与 Codex 官方插件商店分开的市场），以及 MCP、Skill 和 Codex 插件管理。
• 使用小组件和桌面宠物（开发预览）：token 统计、任务状态、可拖拽/调整大小，支持可替换的角色图片和皮肤。

多实例与协作

• Codex 多启动：按提供商身份启动隔离的 Codex 实例，每个实例拥有自己的配置、会话和用户数据目录。正在运行的实例集中列出，可单独重启或停止。
• 子代理协作：在 Codex 对话中，用自然语言将任务委托给 Codex CLI、DeepSeek Harness（dsh）或 Claude Code；结果返回当前对话。你可以设置默认代理、模型路由，并复用 DSH 的已保存登录。
• 微信连接：扫码关联本地 Codex，每个联系人映射到独立会话（可配置访问权限）。

平台与技术

• 支持平台：Windows（x64）和 macOS（Apple Silicon / Intel，通用 DMG）。
• 构建技术：Rust + Tauri。
• 许可证：AGPL-3.0-only。

快速开始

1. 从 GitHub Releases 下载对应平台的安装程序。
2. 确保官方 Codex / ChatGPT 桌面应用已安装。
3. 打开 Codex++，确认官方应用路径，选择提供商模式，根据需要启用增强功能，然后保存。
4. 在 Codex++ 界面中点击 启动，以你的配置启动官方应用。

所有 UI 增强功能均可单独关闭，或通过总开关关闭；即使关闭增强，提供商和启动管理功能仍可正常工作。

数据存储位置

数据	位置
Codex 配置和登录信息	~/.codex/config.toml、~/.codex/auth.json
本地数据库	~/.codex/sqlite/*.db（旧版回退：~/.codex/state_5.sqlite）
Codex++ 状态和日志	~/.codex-session-delete/
提供商同步备份	~/.codex/backups_state/provider-sync

（如果设置了 CODEX_HOME，则优先于 ~/.codex。）

开发布局

• 前端：apps/codex-plus-manager
• 核心 Rust 库：crates/codex-plus-core
• 数据层：crates/codex-plus-data
• UI 注入脚本：assets/inject

注意事项与提醒

• 该项目由多家 API 中转/代理服务商赞助（JOJO Code、APIKEY.FUN、GrooRoute、RunAPI、FennoAI、百可为AI、七牛云、TokenMy、APINEBULA）。他们关于服务范围、定价和促销的声明属于他们自己，而非本项目。
• Codex++ 依赖官方应用的页面结构、CDP 和本地数据格式；官方应用更新后，某些功能可能需要适配。
• 鲸鱼小组件功能改编自上游项目 MeteorNOX/DeepSeek-Balance-Whale-Widget；其资源遵循各自的许可证。
• 使用小组件和桌面宠物处于开发预览阶段；截图来自开发构建。
• API 密钥存储在本地机器上；README 建议在提交反馈前隐藏密钥。