中文 | English

Codex Chat Bridge

Codex Chat Bridge 是一个面向 Windows 的 Codex 聊天迁移与 provider 管理工具。v2 在原有聊天桥接能力之外，加入了 provider 预存、URL 与 API Key 管理、快速切换，以及切换前自动备份配置的能力。

适用场景

• 你需要在多个 Codex provider 之间切换，但不想手动改 config.toml 和 auth.json
• 你希望把 provider 的 URL 和 API Key 预存起来，后面点一下就能切换
• 你在 openai、自定义 provider、服务商线路之间来回切换，希望聊天线程还能按需要迁移或回迁
• 你最在意稳定性，希望每次关键写入前都有备份，不要把现有配置搞坏

功能

• 聊天桥接：把某个 provider 线下的线程迁到另一个 provider，并记录可回退的 session
• 聊天回迁：按 session 把线程迁回原 provider，也可以把桥接期间新建的聊天一起带回
• Provider 管理：显示当前所有 provider、对应 URL、是否在配置中、是否为当前 provider、以及线程数量
• 预存切换：本地保存 provider 的 URL 和 API Key，后续快速切换
• 安全写入：切换 provider 前自动备份 config.toml、auth.json 和本地 provider 存储
• 删除保护：删除预存 provider 时只删本地保存项，不会直接删聊天线程，也不会主动删 config.toml 里的 provider 块

界面结构

• Chat Bridge 负责聊天迁移、回迁、直接迁移和桥接 session 管理
• Providers 负责 provider 列表展示、URL 和 Key 管理、预存、快速切换

安全原则

• 只有在你点击“切换 provider”时，工具才会去改 Codex 的 config.toml 和 auth.json
• 平时保存 provider 预设时，只写工具自己的 provider_store.json
• 所有关键写入都先做备份
• 如果检测到 Codex 还在运行，迁移和切换都会先拦住，避免 SQLite 或配置文件被占用时硬写

运行

直接运行源码

py -3 .\codex_chat_bridge_launcher.py

打包便携版

powershell -ExecutionPolicy Bypass -File .\build_codex_chat_bridge.ps1

输出目录：

dist-release\CodexChatBridge

发布压缩包：

release\CodexChatBridge-windows-portable.zip

文档

• 中文使用说明
• English usage guide
• 中文构建说明
• English build guide
• 中文原理说明
• English technical notes

许可

MIT