Release Notes
中文
新增
- 新增可配置的 Reasoning Guard，用于拦截 Codex 中转偶发的异常短推理路径。核心配置在
[retry.reasoning_guard]：
enabled、reasoning_equals、action、stream_mode、max_guard_retries、paths、log_matches。默认异常桶为 [516, 1034, 1552]，配置支持运行时热加载，新请求会自动使用最新设置。
- 新增 Codex 客户端压缩策略配置
[codex.client_patch].compaction = "auto" | "local" | "remote-v1" | "remote-v2"，并支持 codex-helper switch on --compaction ...。这让 official relay / imagegen 预设可以按中转能力选择本地压缩、remote compact v1 或 remote compact v2。
- OpenAI Images 兼容入口增强：支持 JSON
POST /v1/images/edits / /images/edits 参考图生成，并对 hosted image_generation_call 结果做语义校验，避免上游返回 HTTP 200 但没有图片结果时被误判为成功。
- TUI Settings 页现在会显示当前 reasoning guard 规则；Relay 能力诊断也会按实际 compaction 策略计算 expected / mismatch。
修复
- 修复 Image API 模型被直接放进
/v1/responses 顶层 model 后导致路由池误判的问题；现在会映射到可配置的 Responses wrapper model，并强制调用 hosted image_generation。
- 图像入口的路由失败现在会返回更明确的
failure_hint、request_id 和 suggested_action，ch-imagegen 也会把失败归因到 provider / 路由池，而不是误导为分辨率问题。
- Codex
remote_compaction_v2 请求会在中转不支持 v2 时自动降级到 /responses/compact 并合成 Codex 期望的 v2 compact SSE；可用 [codex.compaction].remote_v2_downgrade = false 关闭。
- 修复 TUI 依赖组合在新版 Rust 上可能触发的
ratatui-widgets / time 编译冲突。
English summary
Added
- Added configurable Reasoning Guard protection for anomalous Codex relay short-reasoning paths. The new
[retry.reasoning_guard] options are enabled, reasoning_equals, action, stream_mode, max_guard_retries, paths, and log_matches. The default anomaly buckets are [516, 1034, 1552], and runtime config reload applies to new requests.
- Added
[codex.client_patch].compaction = "auto" | "local" | "remote-v1" | "remote-v2" plus codex-helper switch on --compaction ..., so official relay / imagegen presets can match the relay's real local/remote compaction support.
- Improved OpenAI Images-compatible endpoints with JSON image edits support and hosted
image_generation_call result validation, preventing HTTP 200 responses without image results from being recorded as successful generations.
- The TUI Settings page now shows the active reasoning guard rule, and relay diagnostics evaluate expected capability / mismatch output with the selected compaction strategy.
Fixed
- Fixed Image API model intents being routed as top-level
/v1/responses models. They are now mapped to a configurable Responses wrapper model and forced through hosted image_generation.
- Image route failures now include clearer
failure_hint, request_id, and suggested_action fields; ch-imagegen reports provider / route-pool problems instead of mislabeling them as resolution failures.
- Codex
remote_compaction_v2 requests now downgrade to /responses/compact when the relay cannot produce valid v2 compact output. Set [codex.compaction].remote_v2_downgrade = false to disable this fallback.
- Fixed a TUI dependency combination that could fail to compile on newer Rust due to
ratatui-widgets / time coherence conflicts.
Install codex-helper 0.19.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Latias94/codex-helper/releases/download/v0.19.0/codex-helper-installer.sh | sh
Install prebuilt binaries via powershell script
powershell -ExecutionPolicy Bypass -c "irm https://github.com/Latias94/codex-helper/releases/download/v0.19.0/codex-helper-installer.ps1 | iex"
Download codex-helper 0.19.0
