Codex Router 更新日志 — 版本历史

本页追踪 Codex Router 的每个版本，并依据仓库的 CHANGELOG.md 更新。当前发布线为 0.6.0；“Unreleased”内容来自主分支，尚不等同于稳定版承诺。

更新方式

Codex Router 通过托管检出更新：运行 ./bin/model-router codex update（Windows 为 ./codex-router.ps1 codex update）。更新要求干净的 main 检出与可识别的 GitHub 源，把上一版本保留为本地回滚引用，并从新版本重新安装。任何更新后运行 ./bin/model-router codex doctor --fix，让生成的配置与服务与源码版本一致，然后完全退出并重新打开 Codex 以重载合并模型目录。

完整、逐条的中文翻译量过大，下面给出各版本的中文要点；逐条细节请阅读英文完整更新日志。

Unreleased（未发布）

• 2026-10-31 Free Auto：新增免 API Key 的 free/auto，先尝试 Kilo 匿名免费池，再尝试符合条件的 OpenCode Zen 免费路线；在开始输出前遇到限流、额度耗尽或故障时回退并冷却。全部耗尽会返回 HTTP 429 free_pool_exhausted。可用 ./bin/providers enable free 启用，./bin/control free-pool status|refresh|reset 管理；Control Center 用量页显示实际后端与回退。目前 Zen 路线没有可用成员，实际使用 Kilo。免费层按 IP 共享限额，上游可能记录提示词或用于训练。

• 2026-10-31 修复与安全：自定义模型的显式端点不会因与预设共用模型 ID 而改指向公共云；已完成的回答不再被启发式停止钩子误处理。更新或修复不会把已修复的证书包降级，网关的 aiohttp、mcp 依赖也提高了安全版本下限。这些条目仍在上游 changelog.d，尚未并入 CHANGELOG.md。

• 2026-10-29 文档与安装说明：上游 README 改为安装和常用操作入口，新增简体中文、日文 README 及对应指南；安装文档明确区分源码引导设置的退出码 2（保留新版本）和其他设置失败（尝试恢复旧版本）。这些内容记录在上游 changelog.d 与文档中，尚未并入 CHANGELOG.md。

• 2026-10-28 OpenCode Go 模型与免费层：Go 家族内置 beam-free、longcat-2.5-preview-free、minimax-m3.1-flash-free，使用 Go 密钥但不计入套餐用量；Gemini 4 Argon Contributor 可从账户目录本地定制，走原生 Gemini 端点。匿名 Zen 免费目录目前没有可服务本路由器的模型，定制流程会逐条阻止。

• 2026-10-28 Grok 直连与编辑：可选 Fast 档位扩展到 OAuth 4.5/4.6/4.7 与 xAI API 4.5/4.7；Grok OAuth 4.6/4.7 默认采用结构化补丁，CODEX_ROUTER_GROK_STRUCTURED_PATCH=0 可保留旧补丁文本。已完成的简短回答不会仅因推理 token 较多而重试；上下文估算与实际累计计费用量分开，避免误触发压缩。

• 2026-10-28 登录与请求安全：共用工作区的不同 ChatGPT 用户在资料切换与目录发布时保持身份隔离。需要输入的工具不再接收空参数调用；API Key、路由与视觉生成请求的重定向会被拒绝，提示配置最终端点。这些变化仍记录在上游 changelog.d，尚未并入 CHANGELOG.md。

• 2026-10-26 按路线启动服务：路由器只启动并探测当前所选路线需要的转发器和网关；即使兼容层开启，纯原生或 Responses 原生组合也不再启动未用到的 LiteLLM。

• 2026-10-26 工具结果保留与搜索：指令文件、技能和明确读取的运行时文档不会被工具结果老化省略；可凭有效句柄在同一对话和权限范围内搜索归档原文，支持分页并明确报告未完成搜索。路由模型可自愿设置 8–32 KiB 的老化阈值和本地读取提示，默认仍为 32 KiB、提示关闭，原生 OpenAI 老化默认关闭。这些条目仍在上游 changelog.d，未并入 CHANGELOG.md。

• 2026-10-25 Responses 原生直达：外部 Responses 原生模型现在直接通过持有凭据的 API 转发器，即使其他模型仍启用 LiteLLM；普通回合和远端压缩保留请求准备、工具身份、流校验与凭据隔离。需要协议翻译的模型继续通过网关。

• 2026-10-25 桌面读取与诊断：桌面工具结果 JSON 中的签名读取证明现在可被识别，但仍须通过签名、有效期、对话及权限校验；无效证明不会导致原文被省略。安装、服务控制和诊断命令的输出若把多字节字符拆在两个数据块中，也不会再出现 Unicode 乱码。这些条目仍在上游 changelog.d，未并入 CHANGELOG.md。

• 2026-10-24 新目录型供应商：新增 Atlas Cloud（atlascloud），使用 https://api.atlascloud.ai/v1；设置 ATLASCLOUD_API_KEY 后运行 ./bin/curate-models atlascloud，没有预选模型。可用 ATLASCLOUD_API_BASE_URL 覆盖端点。

• 2026-10-24 可选兼容层：默认启用的 LiteLLM 可持久关闭；仅使用原生 GPT 和 Responses 原生路线的源码安装可提前关闭并跳过 Python 设置。关闭后需要兼容层的路线暂不发布，直接请求会返回 compatibility_layer_disabled；凭据与选择保留，切换后需准备依赖、重启并刷新目录。

• 2026-10-24 选择器与工具结果修复：免登录原生别名遵循选择器可见模型；subagents explain 能识别已启用的通用供应商。旧工具结果只有在精确快照可通过同一对话和权限上下文读取时才省略，回执支持本地分页读取且不会要求重新运行工具；流式工具校验拒绝后不再自动重放。这些条目仍在上游 changelog.d，未并入 CHANGELOG.md。

• 2026-10-19 原生请求重试与压缩错误：原生生成 POST 默认只在确认尚未发送且未向客户端输出时重试；TLS 握手前断线可有限重试，结果不明的重置或边缘 5xx 不会自动重复可能计费的生成。可显式选择 availability 策略接受可能重复执行；生成请求重定向会被拒绝。远端压缩流断线时保留可识别的失败信息，即使缺少响应元数据或 SSE 类型。

• 2026-10-19 路线兼容与查询：未知路线默认保留字面的 <think> 等标签；reasoningTagPolicy 可逐模型选择处理方式，已验证的 Qwen Plan Flash 与 Hy4 Preview 继续使用各自兼容规则。新增只读的所选路线依赖查询，尚未改变实际服务启动。这些内容记录在上游 changelog.d，尚未并入完整 CHANGELOG.md。

• 2026-10-15 取消、文字与计费用量修复：取消 Claude Code 请求会中止上游 Responses 生成；非流式 Responses 会跨 HTTP 数据块连续解码 UTF-8，不再把拆开的字符显示为 �。重试时某次响应缺少计费 token 数，现会用该次报告的输入、输出数补足后累加，同时保留明确的计费零值。这些修复目前记录在上游 changelog.d，尚未并入完整 CHANGELOG.md。

• 2026-10-12 生成结果与用量：请求的 HTTP 状态与实际生成结果分开记录；即使流已返回 200，失败、未完成、取消和无法判定的回合也会在 Control Center 的 Dashboard / Status 中正确显示，用量与计费 token 保留。旧记录标注为未记录生成结果。

• 2026-10-12 WebSocket 与流式文本：Codex 可中断 Responses WebSocket 回合并在同一连接续接；已完成输出和已观察到的用量保留，未完成条目丢弃。推理标签流适配器会在结束前输出暂存的字面标签与空白，避免结尾内容丢失。

• 2026-10-10 新供应商与控制项：新增目录型 AI/ML API（aimlapi），需先设置 Key 再自行定制 Chat Completions 模型，没有预选路线。Claude CLI 代理提示支持 --model、--effort；逐模型的 repetitionGuard 可选择性阻止 GLM-5.3 重复正文。通用 Responses 供应商可选择上游 WebSocket 连接池；原生流量默认仍走 HTTP。

• 2026-10-10 兼容修复：Devin CLI 3000.x 的模型发现恢复，工具参数流得以完整转发，但其对部分 Codex 工具描述的拒绝仍属上游限制。OpenCode Go 的 GLM-5.3-Flash 声明延迟工具加载，尚待全新桌面转轮实测。macOS 签名发布包下载仍待项目固定 Developer ID，当前继续使用本地构建回退。

• 模型增减：Anthropic API 新增 Claude Opus 5.5、Sonnet 5.5、Fable 5.1、Haiku 5.5；Command Code 新增 Muse Spark 1.3 Contributor，Meta 可能用其输入和输出训练。DeepSeek 直连 V4 Pro 新增 low 推理档。OpenRouter 与 Command Code 的 Space Bunny Alpha、OpenCode Free 的 Muse Spark 1.3 Contributor Free 均因不可用而下架。OpenCode Go 的 step-5-preview-free 可经实时探测后在本地定制，并非内置路线。

• 自定义模型与连接器：每个模型的 endpoint.protocol 可选择 openai、anthropic 或 openai-responses；可用 CODEX_ROUTER_APP_CONNECTORS 选择向路由聊天模型预先提供哪些应用连接器工具。可选的 goalContinuationGuard 会在连续重复且无进展的短回复后停止自动目标续跑，默认关闭。

• 目录与本地运行：路由器运行时每五分钟检查原生模型目录，可用 CODEX_ROUTER_NATIVE_CATALOG_POLL_INTERVAL_MS 延长间隔；本地 Ollama 可配置 MODEL_ROUTER_LOCAL_NUM_CTX 和 MODEL_ROUTER_LOCAL_TIMEOUT。Control Center 的 Settings… 快捷键现在打开真正的设置页。

• 稳定性修复：ClinePass 的成功与失败响应正确解包或报错；Z.ai Coding Plan 推理流有独立空闲时限；自动启动连续失败时逐步退避；Windows 前台启动与服务停止验证得到修复。长对话图片历史、MiniMax 多图保存、网页搜索历史和 Responses WebSocket 断开清理也得到修复。

• 聊天模型与工具 API 边界：OpenRouter 的隐藏 openrouter-decisions/jev-latest 需要单独配置调用 /v1/decisions 的客户端；在模型选择器里添加 typesafe/jev-router 不会开启工具输出裁剪。

• Azure 路线修复：Azure Sol 可通过明文交接把任务委派给已配置的 Luna 子代理；Azure KMAMC Responses 路线会过滤无法使用的图片生成工具声明，图片生成功能仍不可用。

• Gemini 工具兼容：Command Code 的 Gemini 3.8 Flash 会将可为 null 的工具参数转换为明确的类型联合，修复图像生成工具及工具搜索历史中的 any_of 错误；其它路线的 schema 不变。

• 压缩与本地服务修复：通用 OpenAI-Responses 网关的自动压缩改用流式响应；Ollama 离线时 Control Center 不再等待 CLI；路由器子进程使用安装时记录的 Node 路径或当前解释器；Windows 服务首次身份探测可等待 45 秒并在超时后重试一次。

• 此前新增模型与供应商：StepFun 国际版和中国版各新增三条路线；Grok 4.7 覆盖六家供应商，MiMo V2.6 覆盖小米及列出的转售商，OpenRouter 新增 DeepSeek V4 Pro。OpenCode Go 与 OpenRouter 的 Union Alpha，以及 OpenRouter 的 Space Bunny Alpha，现已下架。

• 新增控制项：Control Center 可添加、测试、编辑、定制和删除自有 OpenAI 兼容端点。user-models.json 的 "failoverCandidate": false 可阻止某条手选路线被自动故障转移选中。

• 稳定性与目录修复：ClinePass 条目恢复可解析；桌面端的前 100 个目录条目优先展示可见模型；发送给供应商前会缩减超大图片；短暂健康检查超时不再重启仍正常工作的网关。

• 供应商细节：Kimi Code OAuth 会跟随官方 CLI 的中国/国际区域；修正 OpenCode Go MiMo 的图片输入与上下文；不再提供拒绝第三方客户端的 OpenCode Free ID。

• 原生 GPT 重放保留路由模型的可见推理：当任务从路由模型切回原生模型时，无法由原生后端解密的路由 reasoning 会转换成带标记的助手文本，让后续模型真正读到对话依赖的上下文；原生 reasoning item 保持原样。

• 子代理使用已配置的推理档位：生成的路由 agent 定义现在写入每个模型配置的 model_reasoning_effort，避免低推理父代理把所有子代理也意外限制在低档位。

• Union Alpha 此前的隐身预览：OpenCode Go 的 Messages 通道曾提供 opencode-go-messages/union-alpha，OpenRouter 曾以 stealth/union-alpha 发布同款；当时有 262,144 上下文、32,768 补全上限、180,000 压缩阈值并限时免费，现已下架。多条修复让被提前关闭的推理前缀不再被存成 final_answer，超大 ImageGen 图片会以占位串替代。

• 新增 Google Cloud Vertex AI 供应商：使用 gcloud auth application-default login 的 Application Default Credentials（非 API Key），纯目录型、默认不启用，支持 --static 离线定制与 --no-discovery。

• 新增 ainetcafe 供应商：ainetcafe/kimi-k3 指向其 OpenAI 兼容端点，复用 kimi-k3 请求画像，默认 256K 上下文与文本＋图片输入。

• 新增选择器顺序控制：./bin/model-router codex picker-order 可在 native-first（默认）与 routed-first 之间切换，把路由模型发布到原生 GPT 条目之前。

• OpenCode Zen 拆分协议变体：定制的 Claude 落在 opencode-zen-messages，GPT、Grok、Muse 落在 opencode-zen-responses，Gemini 被拒绝。

• GLM-5.3-Flash 与图片/档位修复：Command Code 的 Flash 路线补齐 ox-alpha 收敛并在 400K 压缩，DeepSeek V4.1 Flash 补充图片输入；原生 GPT 重放不再被当作提示词收费，图片 token 估算有 4096 上限兜底。

• 配置与安装健壮性修复：YAML 中撇号不再吞掉后面的配置、config.toml 多行字符串不再被误改、Gemini .env 的 CRLF/LF 混用可原样保留、失败安装后 POSIX 重试会回到 main、Windows 缺少计划任务时 start/restart 会明确报错。

• ChatGPT 额度耗尽时自动审批可回退到路由模型：Approve for me 使用 Codex 自身隐藏的原生模型，与会话额度是两套。现在可用 ./bin/control auto-review-fallback set <provider/model> 指定接管这些审查的模型；仅在原生审查者因额度拒绝后生效，且限定在该次拒绝声明的窗口内，拒绝、策略驳回与其它错误仍留在原生审查者，deny 绝不转交重试。

• 新增 subagents explain <model>：直接说明某条路线为何无法作为子代理委派，给出第一个阻塞点与修复命令，并区分拼写错误、未定制模型与原生 slug；同时说明 v2 声明来自注册表、本机五项检查还是你自己的选择。只读且不消耗额度。

• 修复子代理 effort 导致的假漂移：syncRoutedCodexAgents 写入 model_reasoning_effort，而状态检查计算期望内容时未包含它，导致设置了子代理 effort 的模型永远被报告为 stale，--fix 也只是原样重发。现已对齐。

• 新增 OpenRouter Decisions 原生路线：/v1/decisions 支持 OpenRouter 的 Decisions 协议，openrouter-decisions/jev-latest 复用同一份存储密钥并指向 https://openrouter.ai/api/alpha。该路线刻意不在选择器中列出，供 jev-pruner 这类本地集成使用，不能替代 Codex 原生压缩。

• doctor 警告被下架的路由：当某条已列出路线从其供应商目录中消失时，doctor 只警告而不自动删除，由你决定是否移除；一次失败或过期的抓取绝不会隐藏仍可用的路线，模型回归后下次刷新即清除警告。

0.6.0

• 转售路线不再把历史推理重复显示为正文：不符合原生推理重放契约的 Chat Completions 路线现在会丢弃历史推理 carry，而不是转换成 output_text；修复 Command Code 等模型把自己的进度笔记重复 2、4、5、8、16 次的问题。符合厂商推理契约的路线与原生 Responses 路线不受影响。
• 首次冷启动超时不再卸载服务：全新安装时，即使 LiteLLM 因模型较多而超过 300 秒健康检查，安装器也会保留已经注册并运行的服务、启动器和客户端配置，并提示后续检查。只有确认崩溃循环或启动器损坏时才回滚。
• GLM-5.3-Flash 原生读取图片：zai-coding/glm-5.3-flash、zai-api/glm-5.3-flash 与 openrouter/glm-5.3-flash 已声明文本和图片输入，粘贴截图时不再调用第二个 Vision Bridge 模型并消耗额外额度。无后缀的完整 GLM-5.3 仍是纯文本路线；更新后需重建目录并完全退出、重新打开 Codex。
• Harness 页面新增 Route 开关：每个客户端都能单独打开或关闭路由。打开会在需要时完成设置并发布模型；关闭只撤下该客户端中由 Codex Router 管理的配置，不影响共享服务或其它客户端。
• 五个新客户端可从 Harness 页面发布：opencode、pi、omp（oh-my-pi）、Command Code 与 Hermes Agent 现在各写入一个 codex-router 供应商配置。Control Center 的 Harness 页面「Route」开关会在需要时安装 CLI 并把整份路由模型一次性发布；./bin/control client-setup <id> 与 client-disconnect <id> 是终端等价命令。Responses 客户端指向本地回环 /v1，Command Code 与 Hermes 使用与 Claude Code 相同的 Anthropic Messages 接口（codex_router/anthropic/<slug>）。YAML 按行区间拼接以保留注释与其它供应商，无法往返的 JSON 会被拒绝，且路由器只拥有自己发布的那个 provider key。
• 客户端可单独更新：./bin/control client-update <id> 与 client-update --all 运行各客户端自带更新器（opencode upgrade、pi update --self、command-code update、hermes update --yes），而非 npm install -g，因此 Homebrew 或 curl | sh 安装的 CLI 会原地升级；发布模型列表不会顺带升级客户端。pi 的安装包已迁移到 @earendil-works/pi-coding-agent。
• 新增 “Use Router with ChatGPT” 开关：在保持 ChatGPT 登录可用的同时让外部模型仍可选。显式切换会把内置 OpenAI provider 指向托管的 codex-router-signed 传输，使 Codex 在发送前先向路由器校验带前缀的模型 ID；关闭时恢复原 provider。常规更新与目录刷新不会自动替已有安装打开此开关。
• 推理可见性与泄漏工具调用恢复：LiteLLM 桥接的 Chat Completions 推理现在能在 Codex 中显示并写入线程；模型把工具调用当作文本写出（如 Hy4 的 <tool_calls:NONCE>）时会被解析回真正的 function_call，避免回合空转结束。Hy4 Preview 不再因自己的进度笔记自循环，厂商要求的推理重放也按上游模型族而非请求配置决定。大工具列表下（response.created 帧曾超过 256 KiB）空工具消息与直连 DeepSeek 推理修复不再失效，帧上限提升到 10 MiB。
• Kimi/Moonshot 工具 schema 修复：{"anyOf":[{"type":"string"},{"type":"null"}]} 这类叶子未声明 type 的联合不再被 Moonshot 以 missing type in anyOf properties 拒绝；仅在节点已暗示类型时补声明，内置 Kimi 与其它供应商负载不变。
• 流式与配额修复：流式答案开头的空白（如以换行开始的代码块）不再丢失，且流与 output_text.done/存储快照保持一致；opencode Zen 的配额响应头不再覆盖 Go 套餐的 rate-limits.json 条目（#575）。原生重放同时包含完整 reasoning item 与同 rs_ id 的 item_reference 时会去掉冗余引用，只保留完整 item。
• DeepSeek V4.1 Flash 上线：2026-09-10 发布的新模型已加入 DeepSeek API、OpenCode Go、Nous Research、Command Code、OpenRouter 与 Ollama Cloud 路线；厂商直连提供 1M 上下文、图片输入及 low/high/max 推理。旧 V4 路线继续保留，DeepSeek 的旧 V4 Flash 别名现由 V4.1 Flash 提供。
• Grok 4.6 OAuth 与 Fast 档位：Grok 4.6 现在可通过官方 Grok CLI OAuth 使用，支持 500K 上下文、图片、网页/X 搜索和可选 priority Fast；长推理停顿有心跳保活，失败修复不会释放不完整答案或触发静默重复计费。
• 移除高风险 ChatGPT Web 供应商：非官方 chatgpt.com 浏览器自动化可能导致 OpenAI 账户被暂停或永久封禁，因此上游已彻底删除；旧 chatgpt-web/* 定制条目会被安全跳过，用户应手动移除。
• 路由模型显示与工具调用更接近原生 Codex：进度消息与最终答案现在带正确 phase；apply_patch 参数不符合 LiteLLM 包装形式时不再让流中断；从外部模型切回 OpenAI 时会清理不兼容的上游 item ID。
• 目录漂移与未知路线保护：Codex 升级或同版本运行时被替换后会重新捕获原生模型目录；未知 provider/model 现在以本地 unrouted_model 失败，不会误把提示发送给 ChatGPT。doctor 会指出无有效路线的用户模型。
• Muse Spark 1.3 扩展：Meta Model API 新增 Muse Spark 1.3 与 Contributor，Command Code 新增 Muse Spark 1.3；Contributor 档位可能允许 Meta 使用输入和输出改进产品，应按数据政策选择。
• 9 月 8 日稳定性更新：OpenCode Go 的 Muse Spark 1.2/1.3 Contributor 现在可重放已完成的网页搜索历史；已标记为可重试的路由传输故障会安全重试一次，避免瞬时上游故障直接终止任务。
• 路由子代理会自动修复并保持供应商亲和性：启动时会核对托管 agent 定义与当前模型、可见性及子代理设置；缺失、过期或漂移的定义会重新发布，子代理也会留在父模型所属供应商上。
• Control Center 与托盘修复：24H 图表改为精确滚动 24 小时且包含两个边缘小时；macOS 托盘直接读取健康端点，不再每秒启动 Node 进程占满一个 CPU 核；生成期间隐藏不准确的 tok/s，并从速度计算中排除推理 token。
• Command Code 工具兼容增强：超过 64 字符的工具名会使用可逆别名，递归 JSON Schema 会被修复，避免 Codex MCP 工具在生成前收到 400；Grok OAuth 的工具后续流式修复也更可靠。
• 原生 GPT 目录可自动刷新：同版本 Codex 运行时被替换或目录出现未来模型（如 GPT-6 Astra、GPT-7、o5）时可直接重新捕获，不再要求卸载路由器。
• 桌面端要求与本地化：macOS 托盘/小组件构建明确要求完整 Xcode App，并尊重 DEVELOPER_DIR；Control Center 新增西班牙语界面。这是上游应用本地化，不代表本站已新增西班牙语内容页。
• 同一套模型可发布到更多客户端：主分支新增 DeepSeek Harness、Gemini CLI、Cursor Agent / Cursor App、Claude Code 与 OpenClaw 目标；它们复用同一份供应商凭据、模型可见性、故障转移与用量统计。Claude Code、Cursor Agent 和 Gemini CLI 的既有订阅会话还可通过实验性的 Agent Bridge 单独调用，路由器不会复制其 OAuth token。
• 原生 ChatGPT 多账号切换：Control Center 可保存彼此隔离的 ChatGPT 登录资料并安全切换；账户切换不再要求先禁用路由器。
• 2026-09-03 新模型固定：Gemini 3.8 Flash、Muse Spark 1.3 / Contributor、Claude Fable 5.1、Command Code Qwen3.8 Max 0902 与 GLM-5.3-Flash、OpenCode Go Qwen3.8 Flash 已加入对应供应商；当时发现的 OpenCode Free Muse Spark 1.3 Contributor Free 现已下架。
• Ollama Cloud 新增 GLM-5.3 与 GLM-5.3-Flash：两个条目已经进入内置模型矩阵，但上游仍将其标记为需要精确路线实测的 candidate，不应与已认证的 OpenCode Go / OpenRouter / Z.ai 路线混为一谈。
• 选择器与流式输出修复：路由模型按供应商品牌分组；Grok OAuth 可显示推理摘要并正确结束网关故障；严格上游不再收到空工具数组；Qwen 等模型的 <think> 标签不会泄漏进可见答案，文本与工具调用混合的回合不再重复渲染。
• Control Center 与安装体验：推荐安装现在默认包含 Electron Control Center、托盘/菜单栏应用和 macOS 桌面小组件；Windows 后台助手不再闪出 PowerShell 窗口，关闭 macOS Control Center 后应用仍留在 Dock / 菜单栏。

0.5.1

• 完整桌面安装成为默认推荐路径：macOS/Linux 使用 --guided --with-tray，Windows 使用 -Guided -WithTray，一次安装路由服务、Control Center 与托盘/菜单栏前端；Homebrew 仍是纯 CLI 路径。
• 模型与路由更新：固定 Qwen3.8 Flash、GLM-5.3 与 OpenRouter Grok 4.6，完成 Ox Alpha 到 GLM-5.3-Flash 的迁移，并加强 OpenCode Go Kimi K2.7 Code 的工具架构兼容。
• 凭据与传输强化：增加安全的供应商 API Key 池、通用 OpenAI 兼容供应商、能力门控 embeddings、带调用方认证的 Responses WebSocket，以及更严格的密钥隔离与轮换。
• 安装恢复更可靠：修复不同检出目录接管状态时的安装死锁、Windows ACL 与服务存活判断、更新和回滚中的状态所有权边界。

0.5.0

• Grok 4.6 上 opencode Go：opencode-go-responses/grok-4.6（500K 上下文、文本+图像、low/medium/high/xhigh 推理阶梯），opencode Go 端点按官方表格发布；Grok 4.5 保留在同一个 Responses 变体。
• Nous Research 新增约 27 个模型：含 Hermes 4（405B/70B）、6 个免费门户路线、以及 DeepSeek V4、Kimi K3、Qwen 3.8/3.7 Max、GLM-5.3、GPT-5.6 Terra、Gemini 3.7 Flash、Grok 4.6 等编码旗舰，共 28 个内置条目（非完整 372 模型目录）。
• Ox Alpha 从六路线毕业：最初在六条路线免费上线的隐身 1M 推理模型，在 0.5.0 中完成验证与调整——Command Code/Venice 未通过实测被撤回，OpenCode Free/OpenRouter/Nous 预设移除，保留路线迁移至 GLM-5.3-Flash。
• 新增 Venice 与 Nous Research（Hermes）API Key 供应商：Venice 免费账户无 API 权益（需 Pro 订阅/充值/质押 VVV），Nous 使用 Nous Portal Key；均带单条内置模型，覆盖 doctor 与托盘。
• ChatGPT 订阅访问改为显式一次性授权：非 Codex 客户端（DeepSeek Harness、Gemini CLI 等）不再自动使用发现的 Codex auth.json，登录后运行 model-router codex chatgpt-session enable 一次即可；禁用即全局撤回原生 GPT 发布。
• 子代理选择重新生效：proven/selected/all 三种模式此前被静默丢弃，现已修复；测试套件不再清空操作者的子代理定义。
• Control Center 模型页统一：提供方账号并入连接条、一个”添加模型”对话框搜索所有已连接目录；Windows 启动在计划任务失效时快速失败而非空等。
• Grok/DeepSeek 推理摘要 + Grok 图像多模态：思考过程可在 Codex 中显示并折叠；工具结果图片保持像素、view_image 正常完成。

0.4.0-beta.4

• 面板/桌面伴侣可用性大幅提升：bin/panel（Windows codex-router.ps1 panel）在默认浏览器打开面板；伴侣不再需要 Rust 工具链（回退到只需 Node 的 Electron shell），Windows/Linux 二进制直接随发布附带下载，Windows 托盘获得与 macOS 一致的 tray [install|status|start|stop|restart|uninstall] 管理命令。
• 凭据无关的安装模式：install.sh --no-provider --no-discovery（PowerShell -NoProvider -NoDiscovery）安装空闲路由器——不提示任何凭据，Codex 流量返回本地 503 router_idle_no_provider，doctor 以 warn 报告空闲状态并退出 0，配合新的 stop 子命令形成完整生命周期。
• 子代理自动研究：把一个模型开为子代理时会先进行分离的能力探测（两次真实请求验证流式与强制工具调用），通过后以 experimental 身份发布为 v2；首次真实子代理回合由路由器观察并记录机器本地证明，结构性拒绝会降回 v1 并保留原因。control subagents verify 可显式重跑。
• 推理模型不再沉默 30 秒：空补全守卫不再把推理 delta 视为空白——首个字节从约 30 秒降到约 0.5 秒；已到达客户端的空回合以 error 事件写入开放流，Codex 自己重试。
• 已完成的子代理自动关闭：托管 multi_agent_v2 块新增根使用提示，父回合结束前会注入缺失的 interrupt_agent 调用，孩子不再停留在 Working。
• GLM-5.3 上线 + Z.ai 计量平台：GLM-5.3（2026-08-14 发布）进入 Coding Plan（zai-coding/glm-5.3）、计量平台（zai-api/glm-5.3）与 opencode Go 三路；zai-api 是独立凭据的按量供应商（GLM-5.3/5.2/4.7，独立密钥文件与 ZAI_PLATFORM_API_KEY）；GLM 推理档位按模型自身注册表阶梯收敛。
• DeepSeek Harness 支持：托盘可一键安装 @deepseek-ai/dsh 并发布模型；原生 GPT 模型在已登录 Codex 会话可用时发布到 Harness，会话失效即撤回（CODEX_ROUTER_NATIVE_SESSION_FALLBACK=0 关闭）。
• 卸载最后一个客户端时移除后台服务：安装状态见证改为托管块，bin/disable 现在会同时退役服务。
• 修复 Windows 下所有单参数子命令不可达（PowerShell 数组塌缩）、bin/ 脚本 CRLF 换行、调用方密钥脱敏遗漏面板 URL 等。

0.4.0-beta.3

• 新增 GitHub Copilot catalog-only 供应商：使用具有 Copilot Requests 权限的 fine-grained PAT，校验账户权益与 GitHub 自有推理端点，只发现当前账户可用、支持流式输出与工具调用的模型。
• Vision Bridge（视觉桥）默认开启并更可靠：粘贴图片即可自动读取；最新图片跟随最新问题、支持识别信息、候选视觉引擎回退、限定重试、并发去重与工具结果图片，不完整读取明确标注。
• 新增自定义模型技能包：为任务、自动化、应用内浏览器和电脑操作提供四个受管理技能；不覆盖用户同名技能，doctor 校验版本与工具集一致性。
• 用量面板显示更多配额：xAI OAuth、MiniMax、Command Code、opencode Go 显示剩余计划额度（周/月窗口），凭据只发给供应商自己的主机。
• 上游中继更稳健：对尚未返回响应字节的部分网关错误短暂重试并保留 429 的 Retry-After；单 union 根工具模式不再导致 xAI OAuth 整轮失败；所有连接级失败记录完整原因链。
• 本地模型（Local LLMs）增强：“该下载哪个”的推荐分组、agent-check 实测工具调用、内存适配检查（fits/tight/too-large，install 拒绝 too-large）。
• 安全修复：litellm 升级到 1.96.0（cryptography 50.0.0，修复 GHSA-g6cj-pr64-35w5）；update check 真正只读；更新允许未跟踪文件。

0.4.0-beta.2

• 更新不再重装未变化的依赖：Node 与 Python 依赖步骤按指纹跳过，损坏时才由 doctor --fix 强制重建。
• update check 不再执行更新：只读的可用性检查现在真正只读。
• 推理档位与已装 Codex 版本匹配：不支持的 effort 值会映射到最近的受支持档位。
• 旧 opencode Go 模型提供原生升级提示：GLM-5.1、Kimi K2.6、MiniMax M2.7 带 upgradeTo 指向同订阅的继任者。
• 新模型会在 Codex 中自我公告：“Introducing” 卡片持续七天。
• 适配已装 Codex 构建的 [agents] 并发默认值，并随构建变化重新捕获原生目录。
• 每个供应商的推理档位阶梯按官方文档核对（Kimi K3、DeepSeek V4、Claude Opus 4.8、GLM-5.2 等）。
• 新增 Meta Model API 供应商（Muse Spark 1.1/1.2/1.2 Contributor）。
• opencode Go 成为统一的供应商族，并移除 Cursor 与 opencode 应用目标。
• 修复 Windows 下原生 OpenAI 模型消失、Grok OAuth 凭据、API Key 提示确认、引导式安装新增桌面伴侣、Ollama Cloud 与 Qwen plan 供应商、交互式模型定制（curate-models）等。

0.3.0

• 为 Kimi OAuth、Kimi API 与 DeepSeek API 增加引导式、供应商感知的安装。
• 对两个已识别的旧 Kimi 路由器布局做安全检测、快照、自动迁移与精确回滚。
• 增加 macOS launchd、Linux systemd-user 与 Windows 任务计划程序服务，以及原生 PowerShell 安装器与命令包装器。
• 增加供应商可见性与运行时强制，隐藏的外部模型不会被误认为原生模型。
• 增加 doctor --fix、隐私安全的 support bundle、更新回滚、受保护的供应商模型发现与计费兼容性测试。
• 增加跨平台 CI、依赖审计、带 SHA-256 校验和的标签源码归档与 GitHub 构建来源证明。

0.2.0

• 把最初仅支持 Kimi 的原型推广为经过验证的供应商/模型注册表。
• 增加独立的 Kimi OAuth、Kimi API 与 DeepSeek API 路由，同时保留原生 Codex 模型与 ChatGPT 认证。