v0.2.5

[0.2.5] - 2026-06-10

新增

• 中转站上游 Responses 透传：自定义中转站可切换「上游协议」为 Responses API，代理将 Codex /v1/responses 原样转发到上游 /responses（适用于仅支持 Responses 的模型，如 gpt-5.5-r）
• 设置页中转站新增「上游协议」选项；测试连接按协议分别请求 /chat/completions 或 /responses，并在模型不支持 chat 时提示切换透传

v0.2.4

[0.2.4] - 2026-06-06

修复

• macOS 启动崩溃：修复从终端或 .app 启动时 Cannot start a runtime from within a runtime panic，导致代理与菜单栏图标无法出现（tray.rs 嵌套 block_on）

变更

• 托盘「更多」改为二级子菜单，主菜单更简洁

v0.2.3

[0.2.3] - 2026-06-06

修复

• 千问 / 非 effort 厂商 catalog：始终写入 supported_reasoning_levels（含空数组），修复 Codex v26+ 切换千问后报 missing field supported_reasoning_levels
• Windows API Key 同步：setx 改为 reg add 写用户环境变量，避免 1024 字符截断与 %VAR% 展开；读取同样走 reg query
• 代理安全：仅允许绑定 127.0.0.1 / localhost / ::1，防止手改 config.json 暴露 /admin 与 API
• 固定端口策略：inject_proxy_config 与 clear_all_settings 对齐，代理固定 127.0.0.1:25543
• 托盘退出：优雅关闭 axum 后再退出进程，流式请求日志不再因 exit(0) 丢失
• spawn_server 绑定确认：端口绑定成功后才返回，失败立即报错
• Computer Use 修复竞态：结束 Codex 后轮询进程退出（10s 超时），替代固定 sleep 500ms
• 请求日志：DB 先写后缓存、load_recent 改用 DESC；记录 x-request-id 等客户端 trace；退出时 sync 直写 SQLite

变更

• 上游响应透传时剥除 Connection 头；端口占用提示改为「结束多余 codex-helper 实例」
• 单元测试增至 121 项；Clippy 警告清理

v0.2.2

[0.2.2] - 2026-06-06

新增

• 设置页 Base URL 可编辑：所有厂商均可修改 API 地址，保存后永久写入本地（可覆盖）；官方厂商留空则恢复默认
• 中转站自定义模型：设置页手动输入多个模型（每行一个），同步至托盘菜单与 Codex model_catalog

v0.2.1

v0.2.1 — Computer Use 修复更稳

小版本修复：让「修复 Computer Use」在更多安装方式下能找到 Codex Desktop 自带的 CLI。

亮点

• 更广的 CLI 发现：除 config 里的 node_repl 外，还会搜索 ~/.codex、系统 PATH、Windows 商店版 WindowsApps、macOS Codex.app
• 更清楚的报错：区分「没装 Desktop」「没打开过」「路径找不到」，不再提示错误的 codex-helper init
• doctor 增强：显示是否已定位到 Codex CLI

下载

文件	说明
CodexHelper-0.2.1-win64.zip	Windows 便携版 — 解压运行 codex-helper.exe
CodexHelper-0.2.1-Setup.exe	Windows 安装版 — 双击安装（推荐小白）

升级说明

• 若 v0.2.0 已能正常「修复 Computer Use」，可不升级
• 若曾遇到「找不到 Codex CLI」，请更新后：先打开一次 Codex Desktop → 托盘 → 修复 Computer Use
• 完整变更见 CHANGELOG.md

v0.2.0

v0.2.0 — 代理管线稳定性与长任务优化

本版本聚焦 稳 + 长任务 + 多轮 tool，在默认配置下不改变既有行为（tool 截断默认关闭）。

亮点

• 多轮 tool 稳定：合并连续 assistant tool_calls、补齐缺失 tool 回复、system 合并至首条，修复 insufficient tool messages
• 思考模型兼容：reasoning_content 真实回传 + 厂商感知参数映射（DeepSeek / MiniMax / 智谱 / Kimi / 千问 / MiMo / OpenRouter）
• 长任务不断连：流式读空闲 300s、非流式总超时 600s；429/502/503/504 最多重试 3 次
• 设置页推理档位：默认 medium，可写入 Codex config.toml
• 109 项测试全部通过
• Computer Use 一键修复：托盘「修复 Computer Use（桌面控制）」/repair-computer-use，解决 Codex Desktop 插件页安装失败

下载

文件	说明
CodexHelper-0.2.0-win64.zip	Windows 便携版 — 解压运行 codex-helper.exe
CodexHelper-0.2.0-Setup.exe	Windows 安装版 — 双击安装（推荐小白）

升级说明

• 代理端口仍为 25543，Codex Desktop 指向 http://127.0.0.1:25543/v1
• 可选：在 helper_config.json 设置 "tool_output_max_chars": 16384 开启超长 tool 输出截断（默认 0 关闭）
• 完整变更见 CHANGELOG.md

v0.1.0

Codex Helper v0.1.0

Windows 托盘代理，让 Codex CLI / Desktop 一键切换 DeepSeek、通义千问、智谱、Kimi、MiniMax、小米 MiMo 及自定义中转站。

下载

• CodexHelper-0.1.0-win64.zip — 便携版，解压即用
• CodexHelper-0.1.0-Setup.exe — 安装包（中文）

本版更新（2026-06-04）

新增

• 小米 MiMo 与中转站（自定义 Base URL + API Key）
• 托盘三级模型菜单：切换模型 → 供应商 → 具体型号（显示 · 1M / 256K 等上下文）
• 请求日志窗口：Provider、模型、Token、耗时、费用估算；SQLite 持久化，重启不丢
• 设置 UI：厂商 Chip 切换；官方 Base URL 只读，中转站可编辑
• 清除所有配置（设置页右上角），自定义确认弹窗
• 统一 brand-icon.svg 高清图标（设置页 / 托盘 / 窗口 / 安装包一致）

修复

• 内置厂商 Base URL / 模型 ID 与官网对齐，默认旗舰模型
• 中转站直连上游（不走 Clash/VPN 系统代理）
• 中转站 content 压平与请求头过滤，修复 Unsupported content type
• DeepSeek 思考模式回传 reasoning_content
• 多工具调用合并、custom_tool_call / MCP 支持，修复 insufficient tool messages
• 千问工具调用转发、rollout 会话修复等
• Windows exe / 托盘图标嵌入与高清渲染

要求

• Windows 10/11 64 位
• WebView2 运行时
• Codex CLI 或 Codex Desktop
• 至少一个模型厂商的 API Key

中转站 Base URL 提示

OpenAI 兼容网关请填写带 /v1 的地址，例如：http://your-host:8080/v1