Repository navigation
Releases: panando/CodexBridger
Release list
CodexBridger 1.3.0
1.3.0 - Auto-review model\n\n- Adds the Auto-review model section to the provider page: a one-click check that probes each configured model against the strict JSON schema Codex's reviewer sub-agent requires, then lets the user pick (or type) the slug that goes into every catalog entry as .\n- Probe follows the order of a real Codex harness call (completed response / fence strip / wrong keys / bad decision value). Strict schema is sent on the /responses wire; chat/completions is the fallback when the provider has no Responses endpoint at all.\n- Per-model strict override (glm-5.3-flash=false) ships in the defaults because the harness sends strict=false for that model and the upstream rejects true.\n- Results cache in codexbridger/config.json, never carry a credential; stale results are flagged when the model list changes.
CodexBridger 1.2.1
把第三方模型提供商接进 ChatGPT / Codex 的 macOS 配置管理工具。
在界面里填好提供商地址、API Key 和模型列表,点「启用」就会写入 ChatGPT 实际读取的三个文件,不需要手动编辑配置,也不用自己记着备份。
这一版修的是删除
1. 删之前会问你
1.2.0 里点一下「删除」提供商就没了——没有确认,也不能撤销。这一版补上:
- 弹窗写清删掉的是哪个提供商、带着几个模型;
- 写清哪些文件不会被改:删除只动 CodexBridger 自己的设置,
config.toml和auth.json不受影响; - 如果删的正是 ChatGPT 现在在用的那个,额外说明「使用中的标记会消失,配置文件要等你激活别的提供商时才会改写」;
- 按钮是删除 / 取消;按 Esc 或点到别处等于取消,不会误删。
移除模型同样会先问,并说明那还只是未保存的改动,取消就能恢复。
2. 以后不会再出现「有的入口问、有的不问」
这一版的修复不只是把两个入口接上:未经确认的删除在代码里已经不可达。删除函数改成私有的,界面层根本调不到它,谁要是把某个按钮接回「直接删除」,代码编译不过。
之前两次都是「某个入口忘了走确认」,靠人检查源码总会有下一次;现在由编译器保证。
3. 顺带修掉:删除正在编辑的提供商后,右边还显示它
删掉一个正在编辑的提供商后,界面可能还留着它的表单——窗口层本来遮住了这个情况,但它不成立在模型层。现在删除会同时清掉/切走编辑草稿。
下载
- CodexBridger-1.2.1.dmg — 推荐。打开后把 CodexBridger 拖进「应用程序」。
- CodexBridger-1.2.1.zip — 压缩包版本。
两个都同时支持 Apple 芯片和 Intel(arm64 + x86_64)。
从 1.2.0 升级
直接覆盖安装即可,没有迁移步骤:配置不会被自动改写。唯一的手感变化是删除会先问一次。
⚠️ 首次打开会被系统拦下
本版本使用临时签名,没有 Apple 开发者证书,也没有公证。macOS 可能提示:
"CodexBridger"已损坏,无法打开。你应该将它移到废纸篓。
"CodexBridger"无法打开,因为无法验证开发者。
这不是软件损坏。在「系统设置 → 隐私与安全性」里允许它打开,或右键点应用选「打开」。详见 README 的《首次打开会被系统拦下》。
CodexBridger 1.2.0
把第三方模型提供商接进 ChatGPT / Codex 的 macOS 配置管理工具。
在界面里填好提供商地址、API Key 和模型列表,点「启用」就会写入 ChatGPT 实际读取的三个文件,不需要手动编辑配置,也不用自己记着备份。
这一版新增
1. 全局配置页
以前只能管提供商,config.toml 里那些和提供商无关的顶层设置得自己动手改。这一版把它们搬进了界面:
- 审批与沙箱 —
approval_policy、approvals_reviewer、sandbox_mode、allow_login_shell; - 推理可见性 —
hide_agent_reasoning、show_raw_agent_reasoning; - 每项参数旁边都有一个 ⓘ,点开就是这一项的说明:它管什么、每个选项分别是什么意思、官方默认是哪个;
- 写入前一样先备份;如果这些键被别的程序改过,软件会停下来问你,不会直接覆盖;
- 只写这几个键,
mcp_servers、plugins、desktop等设置不会显示,也不会被改动。
2. 「保存」和「启用」彻底分开
1.1.0 让「保存」顺带改写 ChatGPT 的模型参数文件,想的是少点一下。结果是两件事混在一起:「保存」到底有没有把改动送进 ChatGPT,界面上看不出来。
这一版把职责拆开:
- 「保存」只写本软件自己的设置,不碰 ChatGPT 的文件,也不产生备份;
- 「启用」= 把这份方案交给 ChatGPT,写模型参数文件、
config.toml和auth.json,并且每次都先备份; - 按钮统一叫**「启用」:正在使用、且文件和设置完全一致的提供商,按钮置灰;一旦保存了新改动,它会重新亮起**,点一下就把改动写进去(再备份一次)。
也就是说,「改完保存却不生效」那个老问题不会回来——路径还在,只是不再表现为一个永远亮着、按了却没用的按钮。
界面
- 每行下面那行灰色说明整类去掉了,说明只保留在 ⓘ 里,一页的重复文字少了一半;
- ⓘ 的说明精简到一两行(原先是一整段),仍然写清每个选项的含义和官方默认值;
- 点 ⓘ 弹出的框现在按内容自适应:短说明用窄框,长说明换行后框会跟着变高,不会再出现文字压到上下两行的情况;
- 标签与开关上下居中对齐(原来开关偏高约 3.5pt)。
修复
- 成功提示不再被画成红色、也不会一直挂着:现在绿色、几秒后自动消失,只有真正的问题才常驻;
- 英文界面下侧栏的提供商数量不再显示成中文量词(现在是
1 provider/3 providers); - 「删除」按钮的悬停提示原本写的是「会先备份再改文件」,而删除其实只动本软件自己的设置——提示已改成事实描述。
下载
- CodexBridger-1.2.0.dmg — 推荐。打开后把 CodexBridger 拖进「应用程序」。
- CodexBridger-1.2.0.zip — 压缩包版本。
两个都同时支持 Apple 芯片和 Intel(arm64 + x86_64)。
从 1.1.0 升级
直接覆盖安装即可,没有迁移步骤:配置不会被自动改写,只有你点「启用」时才会写文件。
⚠️ 首次打开会被系统拦下
本版本使用临时签名,没有 Apple 开发者证书,也没有公证。macOS 可能提示:
"CodexBridger"已损坏,无法打开。你应该将它移到废纸篓。
"CodexBridger"无法打开,因为无法验证开发者。
这不是软件损坏。在「系统设置 → 隐私与安全性」里允许它打开,或右键点应用选「打开」。详见 README 的《首次打开会被系统拦下》。
CodexBridger 1.1.0
把第三方模型提供商接进 ChatGPT / Codex 的 macOS 配置管理工具。
在界面里填好提供商地址、API Key 和模型列表,点「启用」就会写入 ChatGPT 实际读取的三个文件,不需要手动编辑配置,也不用自己记着备份。
这一版新增
1. 改完模型参数,保存就会生效
以前会遇到这样一件事:在界面里改完一个提供商(正是 ChatGPT 当前在用的那个)的模型参数、点了「保存」,但 ChatGPT 实际读取的模型参数文件没有被更新。
原因不是「保存漏了一步」,而是唯一会写那个文件的动作是「启用」,而「启用」按钮对当前正在使用的提供商是灰的 —— 于是那条路被关死了。
这一版:
- 点「保存」时,如果这个提供商正是 ChatGPT 在用的,模型参数文件会一起重写;
- 「启用」按钮对当前在用的提供商不再变灰,文案改为**「更新配置」**,可以随时手动重写一次(改了地址或密钥时用它);
- 参数文件写失败不会让你的编辑丢失,但会明确提示「模型参数文件没更新」,而且这条提示不会自动消失。
2. 可以直接从模型参数文件导入模型
不用再一个一个手敲:
- 「模型配置」区块标题行新增**「从文件导入」;「新建提供商」里也新增一项「从模型参数文件导入」**;
- 来源两种:系统文件选择器,或直接列出本机
~/.codex/model-catalogs/里已有的文件(带模型数量和体积); - 导入前给一份勾选清单,默认一个都不勾;
- 同名的模型会被文件里的参数覆盖,并标出「已存在 · 会覆盖」。
说明:模型参数文件里只有模型清单,没有地址和密钥。所以「从文件新建提供商」只帮你把模型列表填好,地址与密钥仍需自己填。
下载
- CodexBridger-1.1.0.dmg — 推荐。打开后把 CodexBridger 拖进「应用程序」。
- CodexBridger-1.1.0.zip — 压缩包版本。
两个都同时支持 Apple 芯片和 Intel(arm64 + x86_64)。
⚠️ 首次打开会被系统拦下
本版本使用临时签名,没有 Apple 开发者证书,也没有公证。macOS 可能提示:
"CodexBridger"已损坏,无法打开。你应该将它移到废纸篓。
这不代表软件真的损坏了,是 macOS 给「从网上下载、又没经过公证」的 App 打上了隔离标记。
方法一(推荐,不用命令行):先双击一次 → 打开系统设置 → 隐私与安全性 → 在「安全性」里点仍要打开。
方法二:把 App 拖进「应用程序」文件夹,然后在「终端」执行:
sudo xattr -dr com.apple.quarantine /Applications/CodexBridger.app输入密码时终端不显示字符是正常的。
它做什么
写入 ChatGPT 实际读取的三个文件:
| 文件 | 位置 |
|---|---|
config.toml |
~/.codex/config.toml |
auth.json |
~/.codex/auth.json |
<提供商>-model-catalog.json |
~/.codex/model-catalogs/ |
- 支持多个提供商共存、随时切换;每个提供商可配多个模型,逐模型设置上下文窗口、推理强度等。
- 内置 DeepSeek、Moonshot 月之暗面、MiniMax、智谱 GLM、OpenRouter 预设,也可完全自定义。
- 三种认证方式(Bearer Token / 环境变量 / 登录命令)按官方文档互斥,选了哪个就只写哪个。
不会弄坏你的配置
- 先备份再写入(切换本软件自己生成的配置时跳过,界面会说明原因)。
- 原子写入:先写临时文件再整体替换,中途断电不会留下半份配置。
- 只动自己的键:不重新序列化整个
config.toml,插件、MCP、hooks、skills 配置原样保留。 - 顶掉正在使用的提供商会先确认。
从 1.0.0 升级
直接覆盖安装即可。配置格式没有变化(schema 仍是 1),原有提供商、模型和认证信息不受影响。
系统要求
macOS 14 或更高版本。
本版验证
自动化测试 352 项,全部通过(1.0.0 时为 276 项)。其中包含:参数文件写入路径重构前后生成的配置逐字节比对一致,以及用本机 4 份真实模型参数文件(共 28 个模型)导入后全部通过表单校验。
CodexBridger 1.0.0
把第三方模型提供商接进 ChatGPT / Codex 的 macOS 配置管理工具。
在界面里填好提供商地址、API Key 和模型列表,点「启用」就会写入 ChatGPT 实际读取的三个文件,不需要手动编辑配置,也不用自己记着备份。
下载
- CodexBridger-1.0.0.dmg — 推荐。打开后把 CodexBridger 拖进「应用程序」。
- CodexBridger-1.0.0.zip — 压缩包版本。
两个都同时支持 Apple 芯片和 Intel(arm64 + x86_64)。
⚠️ 首次打开会被系统拦下
本版本使用临时签名,没有 Apple 开发者证书,也没有公证。macOS 可能提示:
"CodexBridger"已损坏,无法打开。你应该将它移到废纸篓。
这不代表软件真的损坏了,是 macOS 给「从网上下载、又没经过公证」的 App 打上了隔离标记。
方法一(推荐,不用命令行):先双击一次 → 打开系统设置 → 隐私与安全性 → 在「安全性」里点仍要打开。
方法二:把 App 拖进「应用程序」文件夹,然后在「终端」执行:
sudo xattr -dr com.apple.quarantine /Applications/CodexBridger.app输入密码时终端不显示字符是正常的。
它做什么
写入 ChatGPT 实际读取的三个文件:
| 文件 | 位置 |
|---|---|
config.toml |
~/.codex/config.toml |
auth.json |
~/.codex/auth.json |
<提供商>-model-catalog.json |
~/.codex/model-catalogs/ |
- 支持多个提供商共存、随时切换;每个提供商可配多个模型,逐模型设置上下文窗口、推理强度等。
- 内置 DeepSeek、Moonshot 月之暗面、MiniMax、智谱 GLM、OpenRouter 预设,也可完全自定义。
- 三种认证方式(Bearer Token / 环境变量 / 登录命令)按官方文档互斥,选了哪个就只写哪个。
不会弄坏你的配置
- 先备份再写入(切换本软件自己生成的配置时跳过,界面会说明原因)。
- 原子写入:先写临时文件再整体替换,中途断电不会留下半份配置。
- 只动自己的键:不重新序列化整个
config.toml,插件、MCP、hooks、skills 配置原样保留。 - 顶掉正在使用的提供商会先确认。
系统要求
macOS 14 或更高版本。