Release Notes
新增 / Added
codex-helper serve 新增 --host 参数：支持绑定到 0.0.0.0 等非 loopback 地址（默认仍为 127.0.0.1）。
Add --host to codex-helper serve: supports binding to non-loopback addresses like 0.0.0.0 (default remains 127.0.0.1).- 新增
codex-helper session recent：按会话文件最后更新时间（mtime）筛选最近会话，并支持 text/tsv/json 输出；可选 --open 通过 Windows Terminal（wt）或 WezTerm 打开并执行恢复命令，便于快速 codex resume（支持 --since/--limit/--raw-cwd/--format/--open/--terminal/--shell/--resume-cmd）。
Add codex-helper session recent: filter recent sessions by session file mtime with text/tsv/json output; optionally --open via Windows Terminal (wt) or WezTerm to run a resume command for fast codex resume workflows (supports --since/--limit/--raw-cwd/--format/--open/--terminal/--shell/--resume-cmd).
- GUI 新增
Stats 页面：展示 requests/tokens KPI、按天 rollup、Top configs/providers，并支持基于 CODEX_HELPER_PRICE_* 的成本估算（如配置）。
GUI adds a Stats page: requests/tokens KPIs, per-day rollup, top configs/providers, plus optional cost estimate via CODEX_HELPER_PRICE_*.
- 新增 attach 友好的 API v1
GET /__codex_helper/api/v1/snapshot：返回 GUI/TUI 所需的 dashboard 快照（含 usage rollup 与窗口统计），减少多次拉取。
Add attach-friendly API v1 GET /__codex_helper/api/v1/snapshot: returns a dashboard snapshot (including usage rollup and window stats) to reduce multi-call polling.
- GUI
History 新增“全部(按日期)”视图：按日期分组浏览全部 Codex 本地会话，并支持对话预览与复制（默认隐藏工具调用）。
GUI History adds an “All (by date)” view: browse all local Codex sessions grouped by day, with transcript preview and copy (tool calls hidden by default).
- GUI 新增托盘快速操作：支持一键显示/隐藏窗口、启动/停止/重载代理，并可通过托盘菜单快速切换 Active / Pinned / Routing Preset（best-effort 立即应用）。
GUI adds a tray quick-actions menu: show/hide, start/stop/reload proxy, plus quick switching Active / Pinned / Routing Preset (best-effort apply now).
改进 / Improved
- 上游连接更稳健：为代理的 HTTP client 增加
connect_timeout/tcp_keepalive/pool_idle_timeout，降低长时间运行后连接“半死不活”导致的请求挂起概率。
More robust upstream connections: add connect_timeout/tcp_keepalive/pool_idle_timeout to the proxy HTTP client to reduce hung requests caused by stale connections over long runs.
- 诊断信息更清晰：上游
transport_error 现在会记录更完整的错误链（caused-by/source）与关键标志（如 timeout/connect），便于区分 DNS/TLS/连接超时等问题。
Clearer diagnostics: upstream transport_error now logs a richer error chain (caused-by/source) plus key flags (timeout/connect) to help distinguish DNS/TLS/connect timeouts, etc.
- 启动监听失败时，提供更友好的提示（端口占用/权限不足等），并在 Windows/Linux/macOS 下尽力显示占用端口的进程 PID/名称，便于快速定位冲突进程。
Provide friendlier bind/listen failure messages (port in use / permission denied, etc.) and best-effort show the PID/process holding the port on Windows/Linux/macOS for faster troubleshooting.
codex-helper session list 默认完整展示 first prompt，并提供 --truncate 以按需截断输出。
codex-helper session list now prints the full first prompt by default and provides --truncate for an optional compact view.- GUI
History 页面新增“全局最近”范围：按 mtime（默认近 12 小时）列出最近 Codex 会话，并支持一键复制 root id 列表与在 Windows Terminal（wt）中直接执行 codex resume。
GUI History adds a “Global recent” scope: list recent Codex sessions by mtime (default last 12 hours), copy root id lists, and open codex resume directly in Windows Terminal (wt).
- GUI
History 会话恢复流程增强：按工作目录/项目分组、组内批量打开（默认每会话新窗口）、记住终端/shell/resume 命令/工作目录模式等偏好，并展示“可打开/总数”和跳过原因摘要。
GUI History resume workflow: group by workdir/project, batch open sessions (default new window per session), persist terminal/shell/resume/workdir preferences, and show openable/total counts with skip reasons.
- GUI 启动更安全：默认不自动附着到已有代理（避免 TUI 已运行的代理被误操作）；端口与服务选择以配置为准。
Safer GUI startup: do not auto-attach to an existing proxy by default (avoids interfering with a proxy started from TUI); service/port follow the config.
- GUI
History/Transcript 性能优化：对话加载改为后台任务（避免 UI 卡死），并将消息列表改为虚拟滚动渲染，长对话也更流畅。
GUI History/Transcript performance: load transcripts in background (non-blocking UI) and render the message list via virtual scrolling for smoother long sessions.
- GUI
History 内部重构：拆分组件并减少不必要的会话列表 clone，避免为绕过 borrow-checker 引入的额外内存开销。
GUI History internal refactor: componentized UI and removed unnecessary session list clones to avoid extra allocations used as a borrow-checker workaround.
- GUI
History 滚动体验更稳定：统一跨布局的 ScrollArea 标识，使窗口大小变化时更容易保留滚动/选择状态。
GUI History scrolling is more stable: unify ScrollArea IDs across layouts to better preserve scroll/selection state while resizing.
- 内部重构：将代码拆分为 workspace 的
codex-helper-core / codex-helper-tui / codex-helper-gui 三个 crate，降低耦合并提升可维护性（对外 CLI/GUI 使用方式不变）。
Internal refactor: split into a workspace with codex-helper-core / codex-helper-tui / codex-helper-gui crates to reduce coupling and improve maintainability (CLI/GUI usage unchanged).
修复 / Fixed
- 修复 GUI 在部分平台/工具链上因
fontdb Source 变更导致的编译失败，并移除无效的本地 cfg(feature = "fs"/"memmap") 条件分支。
Fix GUI build failures caused by fontdb Source changes and remove invalid local cfg(feature = "fs"/"memmap") guards.
- 修复 Linux release 构建中 GUI 依赖缺失导致的打包失败：通过
cargo-dist 声明 pango/gtk/appindicator/pkg-config 等原生依赖，确保 CI 自动安装所需包。
Fix Linux release packaging failures due to missing GUI native deps by declaring required pango/gtk/appindicator/pkg-config packages via cargo-dist so CI installs them automatically.
- 修复 Linux GUI 链接失败：补齐
libxdo 原生依赖，避免 -lxdo 找不到导致的构建失败。
Fix Linux GUI link failures by adding the missing libxdo system dependency (avoids -lxdo not found at link time).
- macOS 下
open_in_file_manager(..., select_file=true) 改为使用 open -R 以在 Finder 中定位文件。
On macOS, use open -R for open_in_file_manager(..., select_file=true) to reveal the file in Finder.
- 修复 “recent sessions” 边界条件：当
since=0 时应返回空结果，避免 mtime 精度导致的偶发误筛选。
Fix a recent-sessions edge case: since=0 now returns an empty result to avoid rare mis-filtering due to mtime precision.
Install codex-helper 0.12.0
Install prebuilt binaries via shell script
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/Latias94/codex-helper/releases/download/v0.12.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.12.0/codex-helper-installer.ps1 | iex"
Download codex-helper 0.12.0
