farion1231/cc-switch v3.20.3

# CC Switch v3.20.3 > 如今主流开源模型的官方 API 大多已原生支持 OpenAI Responses 格式。本版把 Codex 里 Kimi 的两条预设也从 Chat Completions 转换改为**原生 Responses 直连**——至此 DeepSeek、智谱 GLM、千问、MiniMax、小米 MiMo、LongCat、Kimi 这些主流开源模型的官方 Codex 预设全部直连厂商端点，连同火山豆包与腾讯混元，不再需要开本地路由做格式转换。如果你的 Codex 卡片还是早先添加的 Chat 格式，重新添加一次预设，或在编辑页把「上游格式」改成 Responses，就能直连。其余是一波由贡献者主导的正确性修复：空 `reasoning_content` 占位符不再让 Claude Code 被空 Thought 块刷屏、Codex 长任务不再在一句进度汇报后戛然而止、Claude Desktop 的模型探针不再在 Responses 上游下误报「不可用」、每次退出都把 Claude 的代理重试与超时抄给 Codex/Gemini/Grok Build 的串写关闭、统一供应商同步不再清空子卡设置；Codex 侧补上省略 `model_provider` 时的代理路由、Windows 上正在增长的会话用量、托盘里托管账号的额度。预设与定价做了一轮维护：聚合平台目录刷新、千问AI平台改名并升到 Qwen 3.8、MiniMax 默认 M3、DeepSeek V4 家族按 V4.1 Flash 档调价。**本版不含数据库迁移。** **[English →](https://github.com/farion1231/cc-switch/blob/v3.20.3/docs/release-notes/v3.20.3-en.md) | [日本語版 →](https://github.com/farion1231/cc-switch/blob/v3.20.3/docs/release-notes/v3.20.3-ja.md)** --- ## 重点内容：你现在可以 - **在 Codex 里直连 Kimi，走原生 Responses**：Kimi 开放平台与 Kimi For Coding 两条预设从 òpenai_chat` 改为 òpenai_responses`，Codex 直接连厂商的 `/v1/responses`，不再需要开本地路由做 Responses→Chat 转换。至此 DeepSeek、智谱 GLM、千问、MiniMax、小米 MiMo、LongCat、Kimi 这些主流开源模型的官方 Codex 预设全部直连；仍只提供 Chat Completions 的端点（百度千帆、腾讯 Token Plan、QwenCloud For Coding、StepFun、百灵、ModelScope 与各聚合平台）继续经本地路由转换。如果你现有的卡片还是早先添加的 Chat 格式（Kimi，以及前几版已切换的 DeepSeek、GLM 等），重新添加一次预设，或在编辑页把「上游格式」改成 Responses，即可直连；详见升级提醒。 - **Claude Code 不再被空 Thought 块刷屏**（[#7227](https://github.com/farion1231/cc-switch/pull/7227)，修复 [#5028](https://github.com/farion1231/cc-switch/issues/5028)、[#4404](https://github.com/farion1231/cc-switch/issues/4404)）：GLM、Qwen、DeepSeek 一类在每个 chunk 里带空 `reasoning_content` 占位的上游，不再让每个 token 变成一行外加一个空思考块。 - **Codex 长任务不再在一句进度汇报后戛然而止**（[#7280](https://github.com/farion1231/cc-switch/pull/7280)，修复 [#6529](https://github.com/farion1231/cc-switch/issues/6529)）：经 Chat 上游时，commentary 与紧随的工具调用合并进同一条 assistant 消息，上游不再提前 `stop`。 - **Claude Desktop 在 Responses 上游下不再报「模型不可用」**（[#7287](https://github.com/farion1231/cc-switch/pull/7287)，修复 [#7103](https://github.com/farion1231/cc-switch/issues/7103)）：探针的 `max_tokens=1` 在转换时夹到 Responses API 允许的最小值 16。 - **退出后 Codex、Gemini、Grok Build 的代理重试与超时设置不再被 Claude 的覆盖**（[#7210](https://github.com/farion1231/cc-switch/pull/7210)，修复 [#7204](https://github.com/farion1231/cc-switch/issues/7204)）。 - **同步统一供应商不再清空子卡的用量脚本、通用配置退出与排序**（[#7212](https://github.com/farion1231/cc-switch/pull/7212)，修复 [#7134](https://github.com/farion1231/cc-switch/issues/7134)）。 - **没写 `model_provider` 的 Codex 卡接管时也走本地代理**（[#7263](https://github.com/farion1231/cc-switch/pull/7263)，修复 [#6256](https://github.com/farion1231/cc-switch/issues/6256)），不再悄悄直连 àpi.openai.com`。 - **Windows 上正在增长的 Codex 会话用量不再漏采**（[#7219](https://github.com/farion1231/cc-switch/pull/7219)，修复 [#6060](https://github.com/farion1231/cc-switch/issues/6060)）：mtime 不动时也按文件大小判定。 - **托盘显示托管 Codex 卡所绑 ChatGPT 账号的额度**（修复 [#7267](https://github.com/farion1231/cc-switch/issues/7267)）：绑定多个账号时不再只剩名字。 - **看到 Claude Fable 的周限额**：供应商卡片与托盘都解析用量 API 新的 `limits[]` 数组。 - **一键禁用 Claude Code 的 Artifact 工具**：DeepSeek 等严格校验工具 schema 的网关不再对每个请求返回 400。 - **DeepSeek 官方 Codex 预设能读图**（[#7286](https://github.com/farion1231/cc-switch/pull/7286)，修复 [#7283](https://github.com/farion1231/cc-switch/issues/7283)）；`deepseek-flash` 与 V4 家族按 V4.1 Flash 档记账，不再按 $0 或旧高峰价。 - **一键添加千问AI平台 Token Plan**（[#7183](https://github.com/farion1231/cc-switch/pull/7183)）；千问AI平台升到 Qwen 3.8、MiniMax 默认 M3（[#7255](https://github.com/farion1231/cc-switch/pull/7255)）、聚合平台 Codex 目录刷新。 --- ## 使用攻略 - **[添加供应商](https://github.com/farion1231/cc-switch/blob/v3.20.3/docs/user-manual/zh/2-providers/2.1-add.md)**：Codex 的原生 Responses 直连与 Chat 路由转换的区别、Claude 快捷开关表（含新增的「禁用 Artifact 工具」），以及「预设改动只影响新建供应商」的含义。 - **[请求路由](https://github.com/farion1231/cc-switch/blob/v3.20.3/docs/user-manual/zh/4-proxy/4.2-routing.md)**：接管模式下的配置改写与恢复——本版 Codex 缺 `model_provider` 时的路由修复落在这条路径。 - **[用量统计](https://github.com/farion1231/cc-switch/blob/v3.20.3/docs/user-manual/zh/4-proxy/4.4-usage.md)**：Codex 会话解析与定价配置，本版的字节游标与定价回填口径。 --- > [!WARNING] > > ## 唯一官方渠道声明（请务必阅读） > > CC Switch 是**完全免费、开源**的桌面应用，**不会向用户收取任何费用**。请仅通过下列官方渠道获取本软件： > > | 类别 | 唯一官方 | > | -------- | ------------------------------------------------------------------------------ | > | 官网 | **[ccswitch.io](https://ccswitch.io)** | > | 源码 | **[github.com/farion1231/cc-switch](https://github.com/farion1231/cc-switch)** | > | 下载 | **[GitHub Releases](https://github.com/farion1231/cc-switch/releases)** | > | 作者 | **[@farion1231](https://github.com/farion1231)** | > | 举报山寨 | **[GitHub Issues](https://github.com/farion1231/cc-switch/issues)** | > > **任何向你收费、要求充值、或索取登录凭据的"CC Switch"网站或客户端均为假冒**。如果你被诱导支付了费用，请立即停止操作并通过 GitHub Issues 反馈。 --- ## 概览主流开源模型的官方 API 如今大多已原生提供 OpenAI Responses 端点，Codex 也早已以 Responses 为唯一原生协议。此前 CC Switch 对这些模型的 Codex 预设分两种形态：厂商端点原生支持 Responses 的直连，只提供 Chat Completions 的则由本地代理把 Codex 的 Responses 请求转换成 Chat、再把流式响应转换回来。转换路径能用，但多一层翻译就多一处出错的地方——本版修的 [#7280](https://github.com/farion1231/cc-switch/pull/7280) 正是这类转换缺陷。Kimi 开放平台与 Kimi For Coding 的端点现在都原生提供 `/v1/responses`，官方 Codex 接入指南也要求 `wire_api = "responses"`，于是这两条预设改为原生 Responses 直连。至此 DeepSeek、智谱 GLM、千问（千问AI平台 / QwenCloud）、MiniMax、小米 MiMo、LongCat、Kimi 这些主流开源模型的官方 Codex 预设全部直连厂商端点，连同火山豆包与腾讯混元；仍只提供 Chat Completions 的端点（百度千帆、腾讯 Token Plan、QwenCloud For Coding、StepFun、百灵、ModelScope 与各聚合平台）继续经本地路由转换，手册的「仅 Chat」示例也改为点名这些供应商。其余是一波由贡献者主导的正确性修复，关闭了几个挂了数月的 issue。代理侧：在每个 chunk 里保留空 `reasoning_content` 占位的 OpenAI 兼容上游不再让 Claude Code 被空 Thought 块刷屏、逐 token 换行；Codex Responses→Chat 转换器不再把 commentary 消息与紧随的工具调用拆成两条 assistant 消息——这曾让长任务在一句进度汇报后就结束；Claude Desktop 的一 token 模型探针夹到 Responses API 的最小值，映射模型不再被报为「不可用」；Codex 路由下的图片生成补上贴完整端点、大小写后缀与流式用量三处。两个数据完整性问题关闭：每次正常退出都把 Claude 的重试与超时设置抄到 Codex、Gemini、Grok Build 的代理行；同步统一供应商会清空子卡的用量脚本、通用配置退出与端点自动选择，并把卡片挤到列表底部。Codex 侧：卡片省略 `model_provider` 时接管现在尊重代理地址；用量导入经持久化的字节游标在 Windows NTFS 上识别正在增长的 rollout；托盘为托管 Codex 卡显示所绑 ChatGPT 账号的额度；Claude Fable 的周限额出现在卡片与托盘。Claude 供应商编辑器新增「禁用 Artifact 工具」快捷开关，给拒收 Claude Code Artifact 工具 schema 的网关用。预设侧：聚合平台 Codex 预设刷新到当前目录，DashScope/百炼改名千问AI平台并升到 Qwen 3.8（[#7183](https://github.com/farion1231/cc-switch/pull/7183)），MiniMax 默认改到 M3（[#7255](https://github.com/farion1231/cc-switch/pull/7255)），内置 DeepSeek Codex 目录镜像支持视觉的 `deepseek-flash`（[#7286](https://github.com/farion1231/cc-switch/pull/7286)），DeepSeek V4 家族按 V4.1 Flash 档调价。本版不改数据库 schema。 **发布日期**：2026-09-11 **更新规模**：22 commits | 62 files changed | +3,458 / -802 lines --- ## 新功能 ### Claude 供应商编辑器新增「禁用 Artifact 工具」快捷开关部分第三方 Anthropic 兼容网关（DeepSeek 在列）用严格的正则校验器检查工具 JSON Schema，拒收 Claude Code 的 Artifact 工具在其 `str_replace` 数据库能力铺开后发出的 Unicode 属性转义（`\p{Cc}`、`\p{Cf}` 等）——此后每个请求都 400 Ìnvalid schema for function 'Artifact'`，与所选模型无关。Claude 快捷开关旁新增第六个复选框，在供应商上设置 ènv.CLAUDE_CODE_DISABLE_ARTIFACT="1"`，把 Artifact 工具整个排除出 tools 数组；取消勾选时像其他开关一样删掉该键。四语文案与手册（zh/en/ja）的开关表已同步。 ### Claude Fable 的周限额出现在供应商卡片与托盘 Claude OAuth 用量 API 现在把按模型的周限额放在顶层 `limits[]` 数组里（`kind: "weekly_scoped"`，带 `scope.model.display_name` 与 `percent`），不再是独立的顶层窗口；解析器只读旧窗口，Fable 的限额从未显示过。`limits[]` 现在解析进 `seven_day_fable`、`seven_day_opus` 与 `seven_day_sonnet`——scoped 行覆盖同名旧窗口，重复与畸形行跳过，旧窗口、额外用量与未知窗口都保留。托盘给 Fable 单独一组标签，不再并进周 max 值；四语补「Fable」标签。 ### 新增预设千问AI平台 Token Plan（[#7183](https://github.com/farion1231/cc-switch/pull/7183)）加入 Claude Code、Claude Desktop、Codex、Hermes、OpenClaw、OpenCode 与 Pi 七个应用的预设库，与下文的改名同批。存量供应商不受影响。 ### `deepseek-flash` 与 `deepseek-v4-flash-vision-exp` 的定价行 `deepseek-flash` 是 DeepSeek 目前唯一推荐的 id，`deepseek-v4-flash-vision-exp` 是官方安装脚本 1.2.0 之前写入的旧视觉名；两者都由 V4.1 Flash 服务，按其 $0.30/$1.20 每百万、缓存读 $0.006 计费。此前两者都没有行，而 `LIKE '{id}-%'` 的前缀回退只匹配更长的 id，这两个 id 下的请求一律按 $0 入账。 --- ## 变更 ### Kimi 的 Codex 预设改为原生 Responses 直连 Kimi 开放平台（àpi.moonshot.cn/v1`）与 Kimi For Coding（àpi.kimi.com/coding/v1`）现在都原生提供 `/v1/responses`，官方 Codex 接入指南要求 `wire_api = "responses"`，于是两条预设从 òpenai_chat`（本地代理做 Responses→Chat 转换、必须开路由接管）改为 òpenai_responses`（Codex 直连）。两个端点都用真实密钥按 Codex 0.153.4 的完整请求形态实测（`reasoning.encrypted_content`、`reasoning.summary`、托管 web_search、回放的 reasoning 项），并用 `codex exec` 跑通端到端工具循环。`kimi-k3` 成为开放平台的默认模型与目录首行，`kimi-k2.7-code` 保留为第二行；只对 Chat 转换有意义的 `codexChatReasoning` 从两条预设移除，Kimi For Coding 的 `promptCacheRouting` 也去掉——原生路径上 Codex 自己发 `prompt_cache_key`；每个 Kimi 行声明 `supportsParallelToolCalls`，与官方 Kimi Code `models.json` 一致；不声明 reasoning 默认值，因为 `config.toml` 的 `model_reasoning_effort` 优先于目录默认值，后者只标记 `/model` 选择器。手册（zh/en/ja）的「仅 Chat」示例改为点名仍走 Chat 路由的供应商，「Kimi Code 拒收 `codex-cli` user agent」的过时说明已纠正。无后端改动。 ### 聚合平台的 Codex 预设刷新到当前目录 SiliconFlow（.cn）默认改为 `deepseek-ai/DeepSeek-V4-Flash`（1M 窗口，high/max 档，显式的 ènable_thinking`/`reasoning_effort` 约定），因为国内站的 MiniMax M2.5 已下线；Atlas Cloud 改为 `zai-org/glm-5.2`，其 Coding Plan 包含的最新 GLM（1M 窗口）；Novita 改为 `zai-org/glm-5.3`（1M，纯文本）；NVIDIA NIM 改为 `moonshotai/kimi-k3`（1M，文本+图片；NIM 接受 `reasoning_effort` 的 low/high/max、字段缺省时按 max，预设显式钉 high 与其 `config.toml` 一致）；OpenCode Go 的 GLM/Kimi 条目更新——`glm-5.3`（新默认）、`glm-5.3-flash` 与 `kimi-k3` 替换 `glm-5.2`、`glm-5.1` 与 `kimi-k2.7-code`，窗口、模态与档位按 models.dev 镜像，DeepSeek V4 Pro/Flash 与 MiMo V2.5 Pro 行保留。平台未文档化新模型思考/档位约定的（Atlas Cloud、Novita），预设带一条显式的空覆盖，后端不再按模型名注入厂商原生思考字段。 ### DashScope/百炼预设改名千问AI平台并升到 Qwen 3.8（[#7183](https://github.com/farion1231/cc-switch/pull/7183)）国内百炼预设改名千问AI平台，配专属图标，控制台与 API Key 链接改到 `platform.qianwenai.com`；Qwen 系列在 Claude Code、Claude Desktop、Codex、Hermes、OpenClaw、OpenCode 与 Pi 七处升到 3.8 代——Opus/Sonnet/Haiku 角色对应 `qwen3.8-max` / `qwen3.7-plus` / `qwen3.8-flash`，统一使用官方的 983,616 token 窗口；国内 `Bailian For Coding` 预设（Claude Code、Claude Desktop、Hermes）改名 `千问AI平台 Coding Plan`，端点不变；OpenClaw/OpenCode/Pi 的模型元数据对齐官方客户端文档。国际 QwenCloud 预设保留名称、换专属图标；按量付费预设升到 Qwen 3.8，Token Plan 预设与之对齐（Codex 与 Hermes 本已带 3.8 行），QwenCloud For Coding 保留 `qwen3.7-plus`、`qwen3-coder-plus` 与 `coding-intl` 端点。端点只有一处例外：Pi 的 QwenCloud Token Plan 从 `/apps/anthropic`（Anthropic Messages）切到 `/compatible-mode/v1`（OpenAI Chat Completions），Hermes 与 OpenClaw 的 Token Plan 仍在 Anthropic 地址。 ### MiniMax 预设默认 M3、清掉过期优惠（[#7255](https://github.com/farion1231/cc-switch/pull/7255)，修复 [#7254](https://github.com/farion1231/cc-switch/issues/7254)）官方 MiniMax 与 MiniMax (en) 预设在七套预设文件里都默认 `MiniMax-M3`——Claude Code 声明 1M 上下文（`MiniMax-M3[1M]` 配官方的 `CLAUDE_CODE_AUTO_COMPACT_WINDOW=1000000`），Claude Desktop 启用 1M 支持，OpenClaw/OpenCode/Pi 元数据带 1,000,000 token 上下文、131,072 token 输出预算、图片输入与推理支持。过期的 Coding Plan 促销从所有预设与四语文案移除。存量配置与第三方默认值不变。 ### DouBaoSeed 预设改名火山豆包七个应用预设文件里的显示名本地化：zh/zh-TW 为「火山豆包AI」，en/ja 为「Volcengine Doubao」，沿用七牛/Compshare 的惯例——顶层名保留拉丁字母回退，中英文都能搜到。OpenCode 与 Pi 写进客户端配置文件的 `settingsConfig.name` 同步改名但保持 ASCII 形式（`Volcengine Doubao`）。Live 配置里的标识符刻意不动：Codex TOML 的 provider 名、Hermes 节点键 `doubao_seed`、Pi 的 provider 键、OpenClaw 的模型引用前缀、推广键与图标。 ### DeepSeek V4 家族按 V4.1 Flash 档调价 DeepSeek 已下线 V4 Flash，并宣布 2026-09-14 12:00（北京时间）起 V4 Pro 请求路由到 V4.1 Flash、按 Flash 价计费；本版提前执行这次回调。`deepseek-v4-flash`、`deepseek-v4-flash-0731` 与 `deepseek-v4-pro` 改为 $0.30/$1.20、缓存读 $0.006，修复条目只纠正仍是上一档高峰值的行，并链在 2026-08-16 的峰谷行之后，旧数据库会逐档跳到位。`deepseek-chat` 与 `deepseek-reasoner` 没有权威来源，保持不动。`deepseek-v4-pro` 同时退出纯文本确认表——它现在落在支持视觉的模型上，图片清洗对它 fail-open。 ### Claude「应用到所有角色」按表单顺序取值把一个模型名一键抄到 Claude 模型映射所有角色的按钮，此前先取 ÀNTHROPIC_MODEL`；现在按面板从上到下（Sonnet、Opus、Fable、Haiku、子智能体）读取，默认模型只作最后回退。 ### Atlas Cloud 不再是赞助商赞助商身份从 README 四语赞助表、横幅、ìsPartner`/`partnerPromotionKey` 标记与推广文案中移除；七个应用的预设本身保留，从赞助组移到非赞助组，端点、模型与图标不变。 --- ## 修复 ### 空 `reasoning_content` 占位符不再让 Claude Code 被空 Thought 块刷屏部分 OpenAI 兼容上游（GLM、Qwen、经 ModelScope/DashScope 的 DeepSeek-V4-Pro、百炼、京东云……）在每个内容 chunk 里保留 `reasoning_content: ""` 占位，而不是省略字段。OpenAI Chat→Anthropic SSE 转换器的 reasoning 分支只判断字段是否存在，又与内容分支共享「当前打开块」的状态，于是每个内容 chunk 都先关掉打开的文本块、开一个空 thinking 块、再重开文本块——N 个内容 chunk 变成 2N 个内容块，一半是空 thinking 块，Claude Code 渲染成每个 token 一行、外加几十个空 Thought 块，会话 JSONL 也随之膨胀。空 reasoning 现在在进入分支前就被过滤，与内容分支和非流式转换器已有的守卫一致；两条回归测试钉住占位形态与真实推理两种情况下的块索引、类型与顺序。（[#7227](https://github.com/farion1231/cc-switch/pull/7227)，修复 [#5028](https://github.com/farion1231/cc-switch/issues/5028)、[#4404](https://github.com/farion1231/cc-switch/issues/4404)；取代 [#4869](https://github.com/farion1231/cc-switch/pull/4869)、[#6421](https://github.com/farion1231/cc-switch/pull/6421)、[#6576](https://github.com/farion1231/cc-switch/pull/6576)） ### Codex 长任务不再在一句进度汇报后停在 Chat 上游 Codex Responses→Chat Completions 转换器在同一模型回合里遇到 commentary 消息紧跟 `function_call` 项时，输出两条连续的 assistant 消息；Chat 上游把只有文本的那条当作完整回合，在预期的工具调用之前就返回 `finish_reason=stop`。待处理的工具调用现在合并进紧邻的、尚无 `tool_calls` 的 assistant 消息，待处理的 reasoning 按段附加以免并行调用重复，其他边界形态（user/tool 边界、上一批工具调用、媒体刷出）仍走新消息路径；合并后没有 reasoning 的调用仍做占位回填。（[#7280](https://github.com/farion1231/cc-switch/pull/7280)，修复 [#6529](https://github.com/farion1231/cc-switch/issues/6529)；取代 [#6530](https://github.com/farion1231/cc-switch/pull/6530)、[#5895](https://github.com/farion1231/cc-switch/pull/5895)；[#5860](https://github.com/farion1231/cc-switch/issues/5860) 同报） ### Claude Desktop 的模型探针在 Responses 上游下不再失败 Responses API 拒收小于 16 的 `max_output_tokens`，而 Anthropic 客户端会合法地发很小的探针预算——Claude Desktop 的模型可用性探针用 `max_tokens=1`——Anthropic→Responses 转换原样复制这个值，严格的上游返回 400，Claude Desktop 在本地路由下把映射模型报为不可用。1 到 15 在转换时夹到 16；16 及以上、0 与非整数保持透传语义，正常会话请求逐字节不变，Codex OAuth 路径仍在之后剥掉 `max_output_tokens`。（[#7287](https://github.com/farion1231/cc-switch/pull/7287)，修复 [#7103](https://github.com/farion1231/cc-switch/issues/7103)） ### Codex 路由下的图片生成：贴完整端点、大小写后缀、流式用量 `/images/edits` 路由与 Images/Responses/Compact/Chat 共用的后缀表已随 v3.20.2 发货，本轮补上围绕它们的三处缺口。Base URL 被贴成完整的 `/chat/completions` 或 `/responses` 端点且「完整 URL」开关关闭时，Images 与 Alpha Search 的兄弟端点现在按 Chat 路径已有的容错同样推导，不再把独立请求发到 `…/chat/completions/images/generations`。后缀识别与兄弟改写大小写不敏感（`/v1/Images/Edits/`、`/v1/Responses/Compact/`），并保留原 URL 前缀、百分号编码与查询串。流式 Images 用量从 ìmage_generation.completed` 事件的顶层 ùsage` 解析（跳过不带 usage 的 `partial_image` 事件），再回落到 Chat Completions 流解析器，流式生图不再记 0 token。（[#7177](https://github.com/farion1231/cc-switch/pull/7177)，接续 [#7036](https://github.com/farion1231/cc-switch/pull/7036)） ### 退出与端口分配不再覆盖每应用的代理设置正常退出时，代理的恢复路径调用了旧的全局代理配置写入器去清早已退役的 `live_takeover_active` 标志；该写入器读 Claude 行、跑一条没有 WHERE 的 UPDATE，于是每次关机都把 Claude 的 `max_retries` 与三个超时字段抄到 Codex、Gemini、Grok Build 的行上——而这条 UPDATE 根本不带那个标志，这一步除了串写没有任何效果。临时监听端口的路径在每次代理启动时也做同样的事。死掉的写回已删除（live 配置恢复、备份清理与健康重置不变），解析出的临时端口改经只碰共享监听/日志列的全局配置接口持久化；两条回归测试给四个应用各自不同的设置，并断言两条路径都保住它们。（[#7210](https://github.com/farion1231/cc-switch/pull/7210)，修复 [#7204](https://github.com/farion1231/cc-switch/issues/7204)） ### 统一供应商同步保留子卡的设置与位置同步统一供应商会重新生成它的 Claude/Codex/Gemini 子供应商。子卡的 `settings_config` 与现有行合并，但 `meta`、`created_at` 与 `sort_index` 取自生成的对象，而统一供应商从 UI 过来时从不带这些——UPDATE 把子卡的用量脚本、通用配置退出、端点自动选择等每应用设置抹成 `{}`、排序索引置 NULL，卡片像被删除重建一样掉到列表底部。存量子卡现在保留这三个字段；名称、Base URL、密钥、模型、网站与备注仍由统一供应商驱动，首次创建仍继承父级的元数据。（[#7212](https://github.com/farion1231/cc-switch/pull/7212)，修复 [#7134](https://github.com/farion1231/cc-switch/issues/7134)） ### 省略 `model_provider` 的 Codex 卡接管时尊重代理地址 Codex 卡的 TOML 没有 `model_provider` 时，Codex 回落到内置的 òpenai` 供应商，而接管把代理地址写成 Codex 根本不读的顶层 `base_url`，请求绕过本地代理直连 àpi.openai.com`。缺失的选择器现在视为内置 òpenai` 供应商，代理地址写到 òpenai_base_url`，既有的 legacy-reroute 迁移再把它变成带 `PROXY_MANAGED` bearer 的 `cc-switch` 自定义供应商表——与其他所有第三方接管同一形状。显式的供应商选择不变。（[#7263](https://github.com/farion1231/cc-switch/pull/7263)，修复 [#6256](https://github.com/farion1231/cc-switch/issues/6256)，关联 [#7217](https://github.com/farion1231/cc-switch/issues/7217)） ### Codex 用量导入在 Windows 上识别正在增长的 rollout Codex 在整个会话期间保持 rollout 的追加句柄打开，Windows NTFS 上文件增长时 mtime 不动，纯 mtime 的门永远跳过正在增长的 rollout。观察到的字节长度现在存进已有的 `session_log_sync.last_byte_offset` 列（Codex 行），只有 mtime 与大小都不变时才跳过；解析器手动按换行拆记录，不完整的尾记录下一轮再试、不推进行游标。后续修复把不完整尾巴的字节也算作已观察：此前只把完整消费的记录计入持久化长度，末尾停在半条记录或空白的 rollout（崩溃且未 resume 的会话）永远显得比文件短、每次同步全量重解析——行游标仍停在不完整记录之前，文件一增长就重试，未变的文件按 mtime+size 门跳过。（[#7219](https://github.com/farion1231/cc-switch/pull/7219)，修复 [#6060](https://github.com/farion1231/cc-switch/issues/6060)；另有一条后续提交） ### 托盘显示托管 Codex 卡所绑 ChatGPT 账号的额度自 [#6537](https://github.com/farion1231/cc-switch/pull/6537) 起，托盘刻意去掉了绑定托管 ChatGPT 账号的 Codex 官方卡的用量后缀，因为它只有一个由 Codex CLI 当前登录（先 macOS Keychain、后 àuth.json`）喂的全应用订阅缓存，绑定多个账号后无法安全地表示按账号的额度；供应商卡片查的是绑定账号，但结果到不了托盘，有多个 ChatGPT 登录的用户只看到 `Codex · <名称>` 而没有额度。用量缓存新增按账号键的 Codex OAuth 快照表，额度查询写穿——传输错误保留上一份好快照，鉴权/HTTP 失败则替换它，托盘隐藏失效的额度而不是显示过期的——每次写入排定一次托盘刷新。刷新与显示共用一个 `TrayUsageSource` 判定：托管 Codex 卡只读绑定账号的快照（绝不回落到供应商级或 CLI 快照），未保存用量开关时默认开启（与供应商卡片一致），带绑定的固定官方卡也走托管路径。重绑立即切到新账号的快照，旧账号的迟到响应不会覆盖标签。（修复 [#7267](https://github.com/farion1231/cc-switch/issues/7267)） ### DeepSeek 的 Codex 目录镜像支持视觉的 `deepseek-flash` 内置的 DeepSeek 官方 Codex 目录刷新为厂商当前的 `models.json`（slug `deepseek-flash`、图片输入模态、`supports_image_detail_original`），`deepseek-v4-flash` 退出纯文本确认表：DeepSeek 仍接受这个旧 id 并把它路由到支持视觉的 V4.1 Flash，代理的媒体清洗与生成的 Codex 目录现在对它 fail-open，不再把图片替换成 `[Unsupported Image]`、也不再对 Codex 隐藏图片输入。（[#7286](https://github.com/farion1231/cc-switch/pull/7286)，修复 [#7283](https://github.com/farion1231/cc-switch/issues/7283)） ### 第三方 Token Plan 的 DeepSeek V4 行显式声明纯文本官方端点把 `deepseek-v4-flash` 路由到视觉模型后，这个 id 到处 fail-open，但百度千帆与腾讯 Token Plan 仍托管纯文本的 V4 部署——千帆 Coding Plan 文档写明图片输入返回 400，腾讯 2026-09-10 的计划名单只列 V4。它们的 Codex 预设行（flash 与 pro 两族，含 `-0731`/`-0813`/`-202605`/`-202606`）现在显式声明 ìnputModalities: ["text"]`，不再依赖注册表；预设测试同时锁定官方 DeepSeek 预设保持不声明（fail-open）。（接续 [#7283](https://github.com/farion1231/cc-switch/issues/7283)） --- ## 升级提醒 ### 本版不含数据库迁移 schema 版本保持 18。Codex 的字节游标复用已有的 `session_log_sync.last_byte_offset` 列。 ### 升级后 Codex rollout 会重新解析一次 Codex 行还没有存储的字节长度，第一轮同步会在所有平台重读每个 rollout（只耗 CPU；已导入的事件按行偏移跳过，不会重复计数）。之后的轮次跳过未变文件。 ### 已被覆盖的每应用代理设置不会自动恢复 [#7210](https://github.com/farion1231/cc-switch/pull/7210) 止住了串写，但无法找回此前关机从 Claude 抄到 Codex、Gemini、Grok Build 的重试/超时值——到代理设置里检查一次，把与你配置不符的改回来。 ### 统一同步从此保留子卡设置此前同步已经抹掉的设置（用量脚本、通用配置退出、端点自动选择、排序位置）需要重填一次。 ### 没写 `model_provider` 的 Codex 卡接管时改走本地代理 [#7263](https://github.com/farion1231/cc-switch/pull/7263) 之后这类卡不再悄悄直连 àpi.openai.com`，与其他第三方接管一致。 ### 预设改动只影响新建的供应商存量卡片保存的是创建时的快照。本版涉及：Kimi 的两条 Codex 预设——存量 Kimi 卡仍是 òpenai_chat`，经路由继续可用；要直连就把卡片的上游格式改为 Responses，或重新导入预设（注意 Kimi 开放平台 Tier 0 密钥限 3 次/分钟，跑不完一个多请求的工具循环）；聚合平台的 Codex 目录；千问AI平台改名与 Qwen 3.8（含 Pi 的 QwenCloud Token Plan 协议切换）；MiniMax M3 默认值；火山豆包的显示名；以及千帆/腾讯 Token Plan 上 DeepSeek 行的纯文本声明（这些预设上的存量卡仍靠遇错剥图重试，或重新导入预设）。 ### Codex catalog 类修复在下一次切换供应商时生效 catalog 文件在切换时重新生成：本版是 DeepSeek 官方目录的 `deepseek-flash` 视觉条目（[#7286](https://github.com/farion1231/cc-switch/pull/7286)）。在 DeepSeek 卡上切走再切回一次即可。 ### 定价 `deepseek-flash` 与 `deepseek-v4-flash-vision-exp` 是新 seed 行，启动时的回填会把这些 id 此前按 $0 记录的历史请求补上价格。`deepseek-v4-flash` / `-0731` / `-pro` 的修复只纠正仍是 seed 高峰档值（0.44/1.32/0.014 与 1.32/3.96/0.044）的行；自定义过的行不动，历史费用_不会_重算。V4 Pro 的调整先于 DeepSeek 2026-09-14 的切换落地，在此之前的 V4 Pro 请求按 Flash 价计费。`deepseek-chat` 与 `deepseek-reasoner` 保持原值。 ### Anthropic 客户端向 Responses 上游探测时 `max_tokens` 1–15 现在发 16 无需配置。 ### Chat 上游的 Codex 卡升级后会有一次前缀缓存未命中 [#7280](https://github.com/farion1231/cc-switch/pull/7280) 合并后的 commentary+工具调用消息让请求字节变了一次；之后形状逐轮稳定。 ### 托管 Codex 卡默认在托盘显示额度未保存过用量开关时默认显示，与供应商卡片一致；关掉卡片的用量开关即可隐藏。 --- ## 风险提示 ### 沿用的提示 **xAI Grok OAuth 登录**：复用官方 Grok CLI 的公开 OAuth 客户端身份，使用可能导致账号被限制或封禁——详见 [v3.18.0 release notes](https://github.com/farion1231/cc-switch/blob/v3.20.3/docs/release-notes/v3.18.0-zh.md#风险提示)。 **Codex OAuth 反向代理**：使用 ChatGPT 订阅的 Codex OAuth 反代可能违反 OpenAI 服务条款，详情见 [v3.13.0 release notes](https://github.com/farion1231/cc-switch/blob/v3.20.3/docs/release-notes/v3.13.0-zh.md#️-风险提示)。 **SuperGrok 配额查询**：供应商卡片的配额展示依赖 grok.com 的非公开计费端点，xAI 调整接口后可能失效——详见 [v3.19.0 release notes](https://github.com/farion1231/cc-switch/blob/v3.20.3/docs/release-notes/v3.19.0-zh.md#风险提示)。 **第三方供应商路由**：通过 CC Switch 本地代理把 Codex、Claude Desktop 或 Grok Build 的请求转换并转发到第三方供应商时，各供应商对计费、合规与数据留存的约束不同，请在使用前阅读目标供应商的服务条款。用户启用上述功能即表示自行承担相关风险。CC Switch 不对因使用这些功能而导致的任何账号限制、警告或服务暂停承担责任。 --- ## 致谢本版 22 个提交里有 11 个来自 8 位外部贡献者。 ### 代码贡献 - 感谢 @gongzhenhu：空 `reasoning_content` 占位符的过滤（[#7227](https://github.com/farion1231/cc-switch/pull/7227)，修复 [#5028](https://github.com/farion1231/cc-switch/issues/5028)、[#4404](https://github.com/farion1231/cc-switch/issues/4404)），首次投稿；同一问题 @AdJIa（[#4869](https://github.com/farion1231/cc-switch/pull/4869)）、@U1traTC（[#6421](https://github.com/farion1231/cc-switch/pull/6421)）与 @Hypocrite000（[#6576](https://github.com/farion1231/cc-switch/pull/6576)）更早各自提出过修法。 - 感谢 @fszcd：Codex commentary 与工具调用的合并（[#7280](https://github.com/farion1231/cc-switch/pull/7280)，修复 [#6529](https://github.com/farion1231/cc-switch/issues/6529)），首次投稿；@BigStrongSun 自报该问题并在 [#6530](https://github.com/farion1231/cc-switch/pull/6530) 提交过修法，@xu-xiang 在 [#5895](https://github.com/farion1231/cc-switch/pull/5895) 也尝试过。 - 感谢 @SailingLoong：Claude Desktop 探针的 `max_tokens` 夹到 16（[#7287](https://github.com/farion1231/cc-switch/pull/7287)，修复 [#7103](https://github.com/farion1231/cc-switch/issues/7103)）与 DeepSeek 视觉目录镜像（[#7286](https://github.com/farion1231/cc-switch/pull/7286)，修复 [#7283](https://github.com/farion1231/cc-switch/issues/7283)）；探针夹值这一问题 @John1Tang 更早在 [#7126](https://github.com/farion1231/cc-switch/pull/7126) 也提出过修法。 - 感谢 @Komikawayi：三条修复——退出串写每应用代理设置（[#7210](https://github.com/farion1231/cc-switch/pull/7210)，修复 [#7204](https://github.com/farion1231/cc-switch/issues/7204)）、统一供应商同步保留子卡元数据（[#7212](https://github.com/farion1231/cc-switch/pull/7212)，修复 [#7134](https://github.com/farion1231/cc-switch/issues/7134)）、Codex 缺 `model_provider` 时尊重代理地址（[#7263](https://github.com/farion1231/cc-switch/pull/7263)，修复 [#6256](https://github.com/farion1231/cc-switch/issues/6256)）。 - 感谢 @woniuxiaoshu：Codex 用量的持久化字节游标（[#7219](https://github.com/farion1231/cc-switch/pull/7219)，修复 [#6060](https://github.com/farion1231/cc-switch/issues/6060)），首次投稿；同一问题 @LimiChan-2026（[#6080](https://github.com/farion1231/cc-switch/pull/6080)，同时是 #6060 的报告者）、@woshimaxfive（[#6027](https://github.com/farion1231/cc-switch/pull/6027)，同时在 [#6023](https://github.com/farion1231/cc-switch/issues/6023) 报告了 Windows 下的同一现象）与 @puppnn（[#6246](https://github.com/farion1231/cc-switch/pull/6246)）更早各自提出过修法。 - 感谢 @thisTom：Codex 图片生成的三处 follow-up（[#7177](https://github.com/farion1231/cc-switch/pull/7177)），接续他自己的 [#7036](https://github.com/farion1231/cc-switch/pull/7036)。 - 感谢 @shigzz：千问AI平台改名与 Qwen 3.8 刷新（[#7183](https://github.com/farion1231/cc-switch/pull/7183)），首次投稿。 - 感谢 @jellyjelly814：MiniMax M3 默认值与过期优惠清理（[#7255](https://github.com/farion1231/cc-switch/pull/7255)），自报自修 [#7254](https://github.com/farion1231/cc-switch/issues/7254)，首次投稿；M3 默认值的升级 @octo-patch 更早在 [#3567](https://github.com/farion1231/cc-switch/pull/3567) 提出过，M3 定价与模态在 [#6396](https://github.com/farion1231/cc-switch/pull/6396)。 ### 问题反馈 - 感谢 @Sunshine-SACA 与 @snowing0427 报告空 thinking 块刷屏与内容块碎片化（[#5028](https://github.com/farion1231/cc-switch/issues/5028)、[#4404](https://github.com/farion1231/cc-switch/issues/4404)），以及在 #4404 补充 v3.20.0 上 ModelScope Qwen3-Coder 复现的 @csj-ccc。 - 感谢 @BigStrongSun 与 @aducker2016 报告 Responses→Chat 转换拆分 assistant 回合（[#6529](https://github.com/farion1231/cc-switch/issues/6529)、[#5860](https://github.com/farion1231/cc-switch/issues/5860)）——后者定位到了 DeepSeek 无限复读的同一根因。 - 感谢 @haoyubai212 报告 Claude Desktop 探针在 Responses 上游下 400（[#7103](https://github.com/farion1231/cc-switch/issues/7103)）。 - 感谢 @HEYUESAMA 报告 DeepSeek 图片被替换为 `[Unsupported Image]`、目录声明纯文本（[#7283](https://github.com/farion1231/cc-switch/issues/7283)）。 - 感谢 @Jason-purse 报告重启后 Codex 的 failover 设置被 Claude 的覆盖（[#7204](https://github.com/farion1231/cc-switch/issues/7204)）。 - 感谢 @auqhjjqdo 报告统一供应商同步让用量查询等配置失效（[#7134](https://github.com/farion1231/cc-switch/issues/7134)）。 - 感谢 @pemagic 报告 Codex 直连 àpi.openai.com` 绕过本地路由（[#6256](https://github.com/farion1231/cc-switch/issues/6256)），以及 @Tiacoo 在 [#7217](https://github.com/farion1231/cc-switch/issues/7217) 记录同一现象在 Codex 0.153.x 上的表现。 - 感谢 @LimiChan-2026 与 @MoEternal 报告 Windows 上 Codex 用量漏采（[#6060](https://github.com/farion1231/cc-switch/issues/6060)、[#7264](https://github.com/farion1231/cc-switch/issues/7264)）。 - 感谢 @ringzxw 报告绑定多个 ChatGPT 账号时托盘不显示额度（[#7267](https://github.com/farion1231/cc-switch/issues/7267)）。 --- ## 下载与安装访问 [Releases](https://github.com/farion1231/cc-switch/releases/latest) 下载对应版本，或从官网 [ccswitch.io](https://ccswitch.io) 获取（下载经 Cloudflare 边缘节点分发，不依赖 GitHub 可达）。 ### 系统要求 | 系统 | 最低版本 | 架构 | | ------- | -------------------------- | ----------------------------------- | | Windows | Windows 10 及以上 | x64 / ARM64 | | macOS | macOS 12 (Monterey) 及以上 | Intel (x64) / Apple Silicon (arm64) | | Linux | 见下表 | x64 / ARM64 | ### Windows | 文件 | 说明 | | ---------------------------------------- | ----------------------------------- | | `CC-Switch-v3.20.3-Windows.msi` | **推荐** - MSI 安装包，支持自动更新 | | `CC-Switch-v3.20.3-Windows-Portable.zip` | 便携版，解压即用，不写入注册表 | Windows ARM64 设备请选择文件名中带 àrm64` 标识的对应制品。 ### macOS | 文件 | 说明 | | -------------------------------- | --------------------------------------------- | | `CC-Switch-v3.20.3-macOS.dmg` | **推荐** - DMG 安装包，拖入 Applications 即可 | | `CC-Switch-v3.20.3-macOS.zip` | 解压后拖入 Applications，Universal Binary | | `CC-Switch-v3.20.3-macOS.tar.gz` | 用于 Homebrew 安装和自动更新 | Homebrew 安装： ```bash brew install --cask cc-switch ``` 更新： ```bash brew upgrade --cask cc-switch ``` ### Linux Linux 资产同时提供 **x86_64** 和 **ARM64**（àarch64`）两种架构。资产文件名中包含架构标识，请按你机器的 ùname -m` 输出选择对应版本： - `CC-Switch-v3.20.3-Linux-x86_64.AppImage` / `.deb` / `.rpm` - `CC-Switch-v3.20.3-Linux-arm64.AppImage` / `.deb` / `.rpm` | 发行版 | 推荐格式 | 安装方式 | | --------------------------------------- | ----------- | ---------------------------------------------------------------------- | | Ubuntu / Debian / Linux Mint / Pop!\_OS | `.deb` | `sudo dpkg -i CC-Switch-*.deb` 或 `sudo apt install ./CC-Switch-*.deb` | | Fedora / RHEL / CentOS / Rocky Linux | `.rpm` | `sudo rpm -i CC-Switch-*.rpm` 或 `sudo dnf install ./CC-Switch-*.rpm` | | openSUSE | `.rpm` | `sudo zypper install ./CC-Switch-*.rpm` | | Arch Linux / Manjaro | `.AppImage` | 添加执行权限后直接运行，或使用 AUR | | 其他发行版 / 不确定 | `.AppImage` | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage` |

farion1231/cc-switch v3.20.3

farion1231/cc-switch v3.20.3

新增能力

修复问题

预设与定价维护

Breaking change 与升级提醒

版本规模