Release Notes
破坏性变更 / Breaking
version = 4 成为新的公共配置格式，路由改为可组合的 route graph。旧配置会自动迁移，常见用户不需要手动重写。
version = 4 is now the public config format, with routing represented as a composable route graph. Existing configs migrate automatically for normal use.- 月包池、付费兜底等复杂路由统一用嵌套 route nodes 表达；旧的 v3 routing 写法仍可作为迁移输入读取。
Monthly pools, paid fallback, and other complex routing are now expressed with nested route nodes; legacy v3 routing remains readable as migration input.
新增 / Added
- TUI 和 GUI 新增 route graph 可视化，可以更直观看到入口、嵌套节点、provider 顺序、缺失引用和不可达节点。
TUI and GUI now visualize route graphs, making entries, nested nodes, provider order, missing references, and unreachable nodes easier to inspect.
- GUI 新增 route node 编辑器，可创建、重命名、删除和保存常见路由节点，不必切到原始配置文件完成日常调整。
GUI now includes a route node editor for common routing changes without switching to the raw config file.
- 同一会话会尽量粘住已选 provider；只有失败重试或路由规则变化时，才按当前路由继续切换。
Sessions now prefer staying on their selected provider, and only move on after retry failure or routing changes.
- TUI 和 GUI 请求视图新增缓存命中率，成本估算也更贴近不同服务的实际 usage 口径。
TUI and GUI request views now show cache hit rate, with cost estimates aligned more closely with each service's usage accounting.
- GUI 余额/配额视图新增手动刷新入口，支持全量刷新和当前站点刷新，并显示刷新状态。
GUI balance/quota views now have manual refresh actions for all providers or the selected station, with visible refresh status.
改进 / Improved
- History / Recent 加载更轻快，打开页面和刷新列表时更少卡顿。
History / Recent loading is faster and causes less UI blocking when opening or refreshing lists.
- 路由编辑、provider 管理和配置写回会保留嵌套路由结构，避免把复杂配置意外压平成简单顺序。
Routing edits, provider management, and config writes preserve nested route structure instead of flattening complex configs.
- 余额刷新会避免重复请求，多个界面同时触发刷新时不会反复打外部余额接口。
Balance refresh avoids duplicate requests when multiple UI paths trigger refresh at the same time.
- 路由预览和候选状态更清晰地区分余额未知、余额过期、已耗尽和运行时冷却。
Routing previews and candidate status now distinguish unknown, stale, exhausted, and cooldown states more clearly.
文档 / Documentation
- 补充 v4 route graph 配置示例，覆盖月包优先、月包池、付费兜底和余额未知时的行为说明。
Added v4 route graph examples for monthly-first routing, monthly pools, paid fallback, and unknown-balance behavior.
修复 / Fixed
- TUI 的 dashboard、Requests、Sessions 和 History 不再过早截断 session id，详情区域优先显示完整会话标识。
TUI dashboard, Requests, Sessions, and History no longer truncate session ids too aggressively; detail areas prefer the full id.
- TUI History / Recent 刷新改为后台加载，失败时保留已有列表并显示错误。
TUI History / Recent refresh runs in the background; failures keep the existing list visible and show the error.
- Sub2API 订阅窗口的懒刷新零额度不再被误显示成确定耗尽。
Lazy Sub2API subscription-window zero balances are no longer shown as hard exhaustion.
- GUI routing 编辑保存时不再意外丢失嵌套节点。
GUI routing edits no longer accidentally drop nested route nodes.
- 缓存命中率和成本估算修正了不同服务的 cache token 口径差异。
Cache hit-rate and cost estimates now handle service-specific cache token accounting correctly.
Install codex-helper 0.14.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Latias94/codex-helper/releases/download/v0.14.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.14.0/codex-helper-installer.ps1 | iex"
Download codex-helper 0.14.0
