CC Switch v4.0.16-6

CC Switch v4.0.16-6

纯 fork 小版本，无上游同步。本版将 v4.0.16-3 / v4.0.16-5 两个测试版的功能正式发布，并修复一处测试版发现的卡死问题。

改进

• 悬浮球面板改用托盘面板内容：悬浮球弹窗与右下角托盘快捷面板内容统一——顶部可切换「供应商配置 / 用量统计」两个页签，含问题提示区与轻量模式开关；底部保留今日用量统计和「打开主界面」按钮。原分组列表与拖拽排序退役。设置页新增「显示悬浮球」开关（Linux 不支持）。
• 供应商子面板侧边弹出：悬浮球面板里悬停应用行时，供应商子面板从面板侧面弹出，屏幕空间不足时自动换到另一侧，不再压缩面板内部空间（非 Windows 平台保持窗口内覆盖层）。

修复

• 轻量模式下点「打开主界面」整个应用卡死：轻量模式会关闭主窗口以省资源，此前从悬浮球面板点「打开主界面」重建主窗口时在 Windows 上触发死锁，整个应用（含托盘、悬浮球）无响应，只能强制退出。已修复，现在点击后会自动退出轻量模式并正常打开主界面。

升级说明

• 数据库结构无变化，设置无新增字段。
• 从 v4.0.16-2（或更早正式版）直接更新即可；两个测试版（v4.0.16-3 / v4.0.16-5）的功能已包含在本版中。

CC Switch v4.0.16-2

CC Switch v4.0.16-2

纯 fork 小版本，无上游同步。

改进

• 悬浮球与托盘的应用清单跟随「侧栏显示」：应用管理页里开了「侧栏显示」的应用，现在同样出现在悬浮球面板和右下角托盘（快捷面板与菜单）里，可从这两处快速切换供应商；关掉「侧栏显示」也会同步从悬浮球和托盘移除。此前这两处跟随的是「参与管理」开关，与侧栏不一致。zcode / DSH / WorkBuddy 的供应商由应用内自管，仍然不进入悬浮球和托盘。

升级说明

• 数据库结构无变化，设置无新增字段。

CC Switch v4.0.16-5

CC Switch v4.0.16-5（测试版）

⚠️ 测试版（beta）：预发布通道，不占用正式版更新源；正式用户不会收到该版本推送，确认稳定后发正式版。

改进

• 悬浮球面板：供应商子面板改为侧边弹出：hover 应用行时，供应商列表不再盖在应用列表上方，而是从面板旁边弹出一张独立卡片（宽 300、与面板等高，搜索+列表空间更充裕）。弹出方向自适应屏幕空间：面板在球右侧时向右弹出，空间不足自动换到左侧。面板旁边的空白预留区对鼠标完全穿透，不影响点击下方内容。

升级说明

• 本版为 v4.0.16-3 面板改版的延续优化；数据库结构无变化。

Full Changelog: v4.0.16-3...v4.0.16-5

CC Switch v4.0.16-3

CC Switch v4.0.16-3（测试版）

⚠️ 测试版（beta）：预发布通道，不占用正式版更新源；正式用户不会收到该版本推送，确认稳定后发正式版。

新增

• 悬浮球面板改用官方托盘面板内容：点开悬浮球，面板与右下角托盘的快捷面板同款——各应用当前供应商、模式、额度，hover 应用行即可搜索/切换供应商，并有「配置 / 用量」两个页签（用量页含趋势图与汇总）。面板底部保留原「今日统计（总Token / 输出速度）+ 打开主界面」区；「弹窗尺寸」设置仍生效，实际窗口在设置高度之上另加约 130px 底部保留区。原分组列表的供应商拖拽排序随本次改版移除（主界面仍可拖拽排序）。

改进

• 设置页新增「显示悬浮球」开关：位于 设置 → 窗口和终端 → 「托盘样式」上方，与托盘菜单里的开关双向同步，不用再到处找入口。
• 本地路由设置页顺序调整：「聚合模式设置」上移到「正在使用路由的应用」之后，配置聚合时不用再翻到页面最底部。

升级说明

• 数据库结构无变化；土耳其语补齐了悬浮球设置相关文案。

Full Changelog: v4.0.16-2...v4.0.16-3

v4.0.16-1

CC Switch v4.0.16-1

同步上游 v4.0.16。本版本把托盘改为快捷面板，并修复了一批 Codex 与路由问题。

新增

• 托盘改为快捷面板：点托盘图标弹出面板，可查看各应用当前供应商、模式、额度和用量趋势，也可搜索、切换供应商。想用原来的菜单，到「设置 → 通用 → 托盘样式」换回，立即生效。
• OpenCode 卡片可以设为默认模型：已添加的 OpenCode 卡片上点「设为默认」选一个模型即可，只改 opencode.json 顶层的 model，注释和 small_model 原样保留。
• 预设：新增 AllTokens SI；MiniMax 官方预设默认改用 MiniMax-M3.1-Flash；新增 qwen3.7-flash、qwen3.6-27b、qwen3.8-omni-flash 价格。

修复

• Codex 聚合模式下会话卡死：会话在默认供应商和聚合成员之间切换后，不再卡在上一家反复压缩失败（farion1231#8485）。
• Codex 走路由时重启丢 ChatGPT 登录：退出 CC Switch 一律保留登录，重新进入路由时自动找回（farion1231#8431）。
• Codex 经路由连 Chat 上游时并行工具结果报 400：中途插入的提示（如 image_resize_notice）不再拆开工具结果，DeepSeek 等严格校验的上游不再拒收（farion1231#7190）。
• 自填的 GPT 上下文窗口对官方同名模型生效；4.0.13 的 272K 封顶改为只限制借用原厂数据的窗口，真有 1.05M 窗口的平台不再被封。
• Claude 5.5 模型：路由与接管写出的目录 id 改用 claude-opus-5-5 等 5.5 id，Claude Code / Claude Desktop 显示正确模型名、输出上限 128K。
• 额度显示：智谱按量付费账号显示账户余额；火山套餐填好 AccessKey 前不再误报「额度没查到」；MiniMax Code 部分用量记录的模型名找回。
• 其他：Windows 上 fnm 管理的 Node 工具识别；空闲供应商卡片删不掉；编辑时「获取 API Key」链接恢复；macOS/Linux 继承的环境变量不再误报冲突；中文/日文用量图纵轴刻度缩写。

升级说明

• 数据库结构无变化。
• 升级后点托盘图标弹出快捷面板；想换回原菜单请到「设置 → 通用 → 托盘样式」。Windows 上左键点托盘以前是打开主界面，现在也弹面板，主界面从面板底部进入。
• 已保存的 GPT 模型窗口不做迁移；4.0.13 前自动填成 1.05M 的条目现在会生效，如实际只有 272K 请手动改小。

完整更新内容见上游 v4.0.16 发布说明。

CC Switch v4.0.15-2

CC Switch v4.0.15-2 发布说明

修复 v4.0.15-1 的升级通道故障，其余内容与 v4.0.15-1 完全一致（同步上游 v4.0.15 全量变更）。

⚠️ 如果你装了 v4.0.15-1

不要用应用内的「检查更新」——v4.0.15-1 内置的更新源被误配成了上游仓库，点更新会装成上游版（丢失本 fork 全部定制：聚合路由、悬浮球、t/s 统计、DSH/Zcode/WorkBuddy 接入等）。

请到本页 Assets 手动下载 v4.0.15-2 安装包覆盖安装（Windows x64 用 CC-Switch-v4.0.15-2-Windows.exe / .msi，arm64 用对应 arm64 包）。安装后升级通道即恢复正常。

如果你还在 v4.0.14-x 或更早

应用内「检查更新」正常，可直接升到 v4.0.15-2。

问题说明

v4.0.15-1 合并上游代码时，tauri.conf.json 的更新器配置（验签公钥与更新源地址）被上游版本覆盖：更新源指向了 dl.ccswitch.io / 上游 GitHub Release，验签公钥也换成了上游的。由于本 fork 版本号带 -N 后缀（semver 预发布），恒小于上游正式版号，v4.0.15-1 的应用内更新检查会永远提示「有新版本」，且下载的是上游包。

本版恢复 fork 自签更新源（lzm04521/cc-switch Release），问题修复。这是该配置第 8 次在合并中被冲掉，已在维护流程中加入合并后强制复查步骤。

v4.0.15-1 带来的上游更新（同本版）

• Windows 更新后设置被重置的问题根治（settings.json 宽松解析 + 损坏自动备份）
• 经路由的请求重新识别 Claude Code 会话（修复 Codex OAuth 缓存键不稳定、Desktop 连 Gemini 签名报错）
• Codex→Chat 上游：坏工具调用历史不再每轮报错、DeepSeek 400 修复
• 用量趋势图柱形/面积切换、Hermes 按模型声明图片输入、AllTokens/EveryAPI 预设
• WebDAV/S3 慢传输不再 300 秒截断；更新 Codex 不再误卸载；WSL Hermes 会话可读
• 数据库结构无变化（schema 24）

CC Switch v4.0.15-1

⚠️ 此版本的升级通道有故障（已由 v4.0.15-2 修复）：本版（v4.0.15-1）内置的更新检查指向了上游仓库，应用内「检查更新」会提示升级到上游 4.0.15 并安装上游包（丢失本 fork 全部定制）。请勿安装本版，请直接下载 v4.0.15-2。以下为原始发布说明。

CC Switch v4.0.15-1 发布说明

同步上游 v4.0.15 全量变更，接续 v4.0.14-2。

新增

• 用量趋势图可选柱形图或曲线面积图：用量页「设置 → 显示」区新增「趋势图样式」，两种样式的指标、坐标轴、悬停提示和币种换算一致；「显示」区设置重排为对齐的两列。
• Hermes 按模型声明图片输入：模型详情新增「支持图片输入」开关（写/删 supports_vision），选到已知支持图片的模型时自动打开。
• Claude Desktop 托管登录供应商可获取模型列表：GitHub Copilot、Codex OAuth、xAI OAuth 等在 Desktop 表单中新增「获取模型列表」，按登录账号拉取。
• 新增预设：EveryAPI、AllTokens。

改进

• 路由下切换供应商的提示写明实际动作（记住供应商 / 改路由目标 / 切换路由 / 改聚合默认），只有客户端配置文件确实改了才提示重启，不再无条件弹重启提示。
• 侧栏「今日」徽章只显示数值（完整说明在悬停提示）。
• Claude Code 用量导入提速：同一导入事务内模型定价缓存复用。
• 补齐土耳其语卸载/套餐额度文案。

修复（精选）

• Windows 更新后设置被重置：settings.json 改为先写临时文件再替换；读取容错（BOM、残留尾巴、坏字段只丢弃该字段）；没完整读出的文件先备份为 settings.json.broken-<时间>.bak 再允许保存。
• 经路由的请求重新认出 Claude Code 会话：新版 Claude Code 把会话 ID 写成 JSON 放在 metadata.user_id，此前同对话每个请求都被当新会话（Codex OAuth 缓存键不稳定、Desktop 连 Gemini 签名报错的根因）；现在两种格式都识别，Claude Desktop 也读会话头。
• Codex→Chat 上游：历史里有参数坏掉的工具调用不再每轮被拒（改写为文字保留上下文）；DeepSeek 不再拒收回放的工具历史（空消息/进度/思考并回工具调用消息，仅对 DeepSeek 生效）。
• Codex 聚合模式保留 x-codex-beta-features 请求头（部分原生 Responses 网关需要）。
• Claude Desktop 原生供应商配模型映射不再死循环（保存映射要求先开路由、开路由要求已有映射的循环已解开）。
• WebDAV/S3 慢传输不再 300 秒硬截断：总超时随文件大小放宽，下载另设 120 秒无数据超时。
• 其他：更新 Codex 时 --version 响应慢不再误卸载；Windows「打开终端」带上完整用户/系统 PATH；WSL 里的 Hermes 会话改为发行版内只读读取（需 python3 ≥3.7）；故障转移后「路由中」标记跟随；Pi 子代理用量从子会话文件导入；拖动排序卡片拉伸遮挡；Skills 下载错误不再被分支回退 404 盖掉；DeepSeek 空钱包不再误报「余额已用完」；矮窗口 Codex 思考等级弹窗不再截断；macOS 26 图标不再进灰底板。

升级说明

• 数据库结构无变化（fork schema 仍为 24）。
• Windows 上已带尾巴的 settings.json 首次启动时自动恢复，原文件保留 .broken-<时间>.bak；此前更新时已被重置的设置无法找回。
• Pi 子代理用量从升级后第一次导入开始统计，之前的记录保持原样。
• Windows 上读 WSL 里的 Hermes 会话需发行版装有 python3（≥3.7）。

Fork 维护说明

• fork 定制全量核对无损：聚合模型 id fork 形态（<前缀><分组>.<模型>[1M]）、★设为默认模型、统计页 t/s 指标与输出速度第 5 卡、应用 chips 过滤、悬浮球、DSH/Zcode/WorkBuddy 接入、API 报文记录、自建更新源（updater 指向本 fork Release）。
• 已知基线：本机无 Windows 开发者模式时 2 个 symlink 特权测试（cargo）恒失败，与代码无关。

CC Switch v4.0.14-2

CC Switch v4.0.14-2 发布说明

接续 v4.0.14-1（上游 v4.0.13+v4.0.14 同步版）。

修复

• 聚合模型 id 恢复 fork 形态：v4.0.14-1 合并上游时误将聚合条目 id 采纳了上游新结构（Claude 加 claude- 段 + -- 分隔、Codex 改 / 分隔），冲掉了本 fork 自 v4.0.8-2 起的 id 格式定制。本版恢复：
  • Claude Code：<前缀><分组>.<模型>[1M]，如 G.ZhiPuMax.glm-5.3[1M]（无 claude- 段，key 保留大小写）
  • Codex：<前缀><分组>.<模型>，如 G.ZhiPuMax.glm-5.3（. 分隔，与 Claude 同构）
  • 短形式（G.ZhiPuMax）与解绑保留字（G.default）不变
  • Claude Desktop 聚合条目保持上游的数字代号形态（claude-fable-ccs-<6位>）——这是 v4.0.14-1 新增的链路，为绕过 Desktop 选择器的厂商名黑名单设计，无 fork 存量。

升级说明

• 从 v4.0.12-x 直接升到本版的用户：聚合条目 id 与你之前用的完全一致（G.<分组>.<模型>），旧会话里选过的聚合模型无需重选。
• 已经升到 v4.0.14-1 的用户：v4.0.14-1 期间在会话里选过的聚合模型 id（G.claude-<分组>--<模型> / G.<分组>/<模型> 形态）会失效，需在模型列表里重选一次；升级到本版后 id 形态即恢复稳定。
• 数据库结构无变化（schema 仍为 24）。

CC Switch v4.0.14-1

CC Switch v4.0.14-1 发布说明

同步上游 v4.0.13 + v4.0.14 全量变更（一次合并两版），接续 v4.0.12-6。

新增（v4.0.13）

• Claude Desktop 支持聚合模式：Desktop 与 Claude Code、Codex 共用同一套直连/路由/聚合模式面板。聚合模式下多家供应商的模型以「供应商 / 模型」名同时出现在 Desktop 模型列表，选哪个发哪家（最多 200 个）；路由模式模型列表跟随路由那家。Desktop 路由无故障转移；换模式/换路由/增减成员后需重启 Desktop 生效。
• Codex 自动审批模型可选：开「Approve for me」后审批模型可从卡片模型列表（直连/路由）或聚合设置（聚合）里选，第三方中转不再因请求官方 codex-auto-review 报 404。
• Codex 聚合子代理模型/强度可配：聚合模式下子代理不再只能跟随主模型，可选单独的模型与推理强度，新开对话即生效。
• Claude Code Haiku 档可声明 1M：模型映射每一行都能勾「声明支持 1M」。
• 新增预设：TokenFactory、Modelflare。
• Windows 便携版更新按钮直接下载对应架构压缩包（不再打开发布页自己找）。

新增（v4.0.14）

• 用量金额币种换算：用量页新增「设置」页签，金额可按人民币、欧元、日元等显示（汇率可改）；费用仍按美元记录，仅显示时换算。
• 侧栏「今日」可选内容：金额、Token、请求数、缓存命中率，最多选两项。
• 请求日志可选列：新增缓存写入、命中率、总耗时、状态码四列（默认不显示），可自行勾选。
• 用量页记住上次视图：页签、预设时间范围、图表指标。
• 「打开终端」先说明再选目录：解释目录用途并记住最近用过。
• 定价：内置 Gemini 4 Argon（介绍价，2026-11-30 前）。

改进

• 切回直连前弹确认框，写明会连到哪家、改哪个文件。
• 「聚合模式下子 agent 用经典工具」默认打开（设置挪进「聚合设置」）。
• GPT 系列模型上下文窗口统一封顶 272K（models.dev 的 105 万窗口对 ChatGPT 订阅中转不成立）。
• 1M 窗口模型的预设默认勾上「声明支持 1M」；Claude Desktop 的 1M 模型只显示一行。
• Codex 会话日志分页续页解析（fork 分支线程用量）；OpenCode 深链接导入 Unicode 名可编辑。

修复

• Codex 经路由连 Gemini 第二轮工具调用报 400（Gemini thought signature 回环）；路由模式下 Codex 重试/流超时设置失效。
• 超过 128 MiB 的 Skills 仓库装不上（改为落盘解压）。
• 含大写字母的自定义模型定价查不到（查价大小写不敏感）。
• 故障转移队列调整顺序没反应；Windows 项目组仅路径大小写不同被拆成多组。
• Windows 11 窗口卡死（原生 CSS 拖拽区）；装了很多 fnm 版本时切换模式卡几分钟。
• Hermes 开发版一直提示有新版本；OpenCode 会话时延改用流式时间。

Fork 适配

• 聚合条目 id 格式跟随上游重构：Claude ccs-claude-<key>--<model>、Codex ccs-<key>/<model>、Claude Desktop 数字代号 claude-fable-ccs-<6位>。fork 的可配置前缀（G. 等）与成员短形式 id、会话粘性跟随、解绑条目全部保留并适配新结构；短形式仍为 <前缀><key>。
• settings 字段并集合并：fork 路由前缀/发布形态/粘性跟随/全量用量刷新 + 上游币种显示；codex_stack_classic_subagents 随上游改名为 codex_stack_classic_tools（默认开，旧 off 值仍生效）。
• haiku 档 [1M] 标记口径跟随上游（不带标记会被 Claude Code 按 200K 算）。
• 合并核对：updater 自签源（pubkey 2E61E551 + lzm04521 endpoint）、用量 summary / 模型统计 t/s 聚合（rollup SUM）、MCP / Skills 的 zcode / dsh / workbuddy 列、聚合表单 ★「设为默认模型」、sidebarApps 双开关、悬浮球、windows-sys feature 集均完好。

升级说明

• 数据库结构无变化（schema 仍为 fork 24；上游 20 未撞号）。
• 聚合条目 id 格式变化：升级前在会话里选过的聚合模型 id（旧 ccs-a.model 形态）不再被识别，需在 /model 或模型列表里重选一次（上游同口径，无迁移）。
• 自定义分组 key 恰好以 claude- 开头时，其完整条目 id 会被短形式解析抢先命中，建议避免此类命名（短形式不受影响）。
• Windows 便携版更新仍需手动解压覆盖（CC Switch 不自替换程序文件）。

CC Switch v4.0.12-6

修复

• 聚合模式默认分组的「模型映射」区块在从未配置过映射时不显示（首配死锁）：现在门控满足（聚合格打开 + 默认分组 + 列表 ≥2 模型）时总是显示，未配置的档位默认「跟随默认」。该问题由 v4.0.12-5（beta）首发修复并经真机验证。

其他

• 发布流程新增测试版通道：whats-new 摘要标记 channel: beta 后，Release 发为预发布、不占用正式更新通道（首个测试版 v4.0.12-5）。