CC Switch v3.14.1 版本解析托盘用量可视化、Codex OAuth 稳定性修复与 FAST 模式详解【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本文基于 CC Switch v3.14.1 官方发布说明docs/release-notes/v3.14.1-en.md撰写并结合仓库源码对每项变更的实现细节进行佐证。读完后你将了解系统托盘如何展示当前 Claude / Codex / Gemini 供应商的缓存用量、Kimi / Zhipu / MiniMax 等编码套餐的双窗口用量布局 h12% w80%如何生成、Codex OAuth 反向代理在本版本修复的四类稳定性问题缓存路由、Responses SSE 聚合、Stream Check 一致性、模型字段提取以及 Hermes 配置健康扫描器为何被移除。版本概览CC Switch v3.14.1 是紧随 v3.14.0 之后的补丁版本发布日期2026-04-23更新规模为13 commits | 48 个文件变更 | 1,883 / -808 行。版本聚焦五个方向Codex OAuth 反向代理稳定性修复缓存身份抖动、SSE 聚合与 Stream Check 探测不一致托盘用量可视化首次把缓存用量直接渲染进系统托盘子菜单Skills 导入 / 安装可靠性去重、防重复点击、根级SKILL.md仓库支持Gemini 会话恢复路径读取.project_root元数据还原原始项目目录Hermes 配置健康处理简化移除内置健康扫描器。托盘用量可视化Tray Usage Visibility本版本最显著的新增能力是Claude / Codex / Gemini 的系统托盘子菜单现在会直接展示当前供应商的缓存用量issue #2184包括两类摘要订阅配额摘要subscription quota summary——如 ChatGPT / 官方订阅的用量百分比用量脚本摘要usage-script summary——基于meta.usage_script配置拉取并计算的用量带颜色编码的利用率标记。行为上有三点约束源码层面可以印证刷新被限流throttled避免托盘高频触发上游 API 调用**仅限当前可见应用visible apps**刷新其他应用不受托盘刷新影响刷新结果会同步回 React Query主窗口与托盘共享同一份用量缓存。托盘侧的摘要拼装逻辑位于 src-tauri/src/tray.rs其中包含了窗口摘要的格式化与单元测试例如断言摘要字符串中包含h12%、w80%、w95%等窗口片段。编码套餐双窗口展示Kimi / Zhipu / MiniMax针对 Kimi / Zhipu / MiniMax 等中国编码套餐供应商托盘渲染**5 小时窗口 周窗口**双档用量采用与官方订阅徽章完全一致的 h12% w80%布局取两个窗口中利用率最差的一档来决定 emoji 颜色语义与主界面的订阅徽章相同。h为 5 小时窗口利用率w为周窗口利用率火山方舟等月窗口套餐还会额外携带m月窗口从 src-tauri/src/tray.rs 顶部注释与测试用例script_summary_token_plan_weekly_only等可以确认该布局规则。更关键的自动化行为是自动注入用量脚本创建 Claude 供应商时如果ANTHROPIC_BASE_URL匹配已知编码套餐主机如api.kimi.com/coding、api.minimaxi.com等CC Switch 会自动注入meta.usage_script托盘无需打开 Usage Script 弹窗即可直接点亮。已知主机的正则匹配定义在前端 src/config/codingPlanProviders.ts 中例如 Kimi 的匹配模式为api\.kimi\.com\/codingMiniMax 为api\.minimaxi?\.com|api\.minimax\.io并通过detectCodingPlanProvider做首匹配路由Zhipu 个人版排在zhipu_team前面保留用户自定义更新供应商时已存在的usage_script值会被保留绝不会被自动注入覆盖用户自定义脚本不受影响。用量脚本的执行链路在 src-tauri/src/services/provider/usage.rs脚本需enabled为真才会执行timeout未设置时默认10 秒template_type、api_key、base_url、access_token、user_id等字段都会透传给脚本运行时校验逻辑如interval_too_large报错由validate_usage_script负责。弹窗界面见 src/components/UsageScriptModal.tsx。Codex OAuth FAST 模式新增开关本版本为Codex OAuth 支撑的 Claude 供应商新增了显式的FAST 模式开关issue #2210开启后经过格式转换发往 ChatGPT Codex 上游的 Responses 请求会携带service_tierpriority用更低的延迟换取更高的 ChatGPT 配额消耗默认关闭避免用户无感知地增加配额消耗。源码层面该开关的实现非常直接src-tauri/src/provider.rs 中ProviderMeta新增字段codex_fast_mode: Optionbool其语义注释明确写着注入service_tier priority用于 ChatGPT Codex 请求访问器codex_fast_mode_enabled()使用unwrap_or(false)从源码结构看即缺省视为关闭转换入口在 src-tauri/src/proxy/providers/claude.rs构造请求转换上下文时读取provider.codex_fast_mode_enabled()并传入实际注入点在 src-tauri/src/proxy/providers/transform_responses.rs仅当codex_fast_mode为真时才写入result[service_tier] priority。对应的单元测试覆盖了开/关两种状态——开启时断言service_tier priority约 L4907关闭或默认时断言该字段不存在约 L4926、L4972保证默认不注入这一默认值契约。Codex OAuth 稳定性修复本版本集中修复了反向代理的四类问题逐一说明1. 缓存路由Cache Routing#2218问题代理之前会为请求生成新的 UUID导致 Codex 上游的缓存身份cache identity不断抖动——同一个逻辑会话在上游被当成无数个不同会话缓存命中率被摧毁。修复现在客户端提供的 session ID 同时用作prompt_cache_key与 Codex 会话头保留显式缓存键不再生成临时 UUID。prompt_cache_key的读取与传递贯穿 src-tauri/src/proxy/providers/transform_responses.rs、src-tauri/src/proxy/providers/codex.rs 与 src-tauri/src/proxy/session.rs 等模块。2. Responses SSE 聚合#2235问题ChatGPT Codex 上游会强制以 OpenAI Responses SSE流式事件流返回即使客户端请求的是非流式响应。此前非流式的 Anthropic 客户端例如期望一次性 JSON 的 Claude Code 客户端在这种场景下拿不到合法的 JSON。修复CC Switch 现在会先聚合上游的完整 SSE 事件流再对聚合结果执行非流式格式转换最终向 Anthropic 客户端返回正确的 JSON。这属于典型的协议适配逻辑上游协议形态不可控时代理承担聚合-转换职责。3. Stream Check 与生产请求对齐#2210问题Stream Check流连通性检测此前构造的 Codex OAuth 探测请求与生产代理流量不一致导致检测失败但实际能用check fails but it actually works的误报。修复Stream Check 现在以与生产代理流量完全相同的参数构造探测请求store: false不持久化对话加密推理内容包含encrypted reasoning include供应商的FAST 模式设置同样参与探测即 FAST 开关开启时探测也会带service_tierpriority。前端探测入口见 src/hooks/useStreamCheck.ts。4. 模型字段提取改用 TOML 解析#2227读取 Codex 配置中的model字段从首行正则匹配改为标准 TOML 解析多行 TOML 结构如跨行的model ...或嵌套表现在可以被正确解析。解析主体位于 src-tauri/src/codex_config.rs。Skills 导入 / 安装可靠性导入对话框防重复Skills 导入对话框在导入进行中会禁用操作按钮#2211防止连击缓存按 ID 去重已安装 Skills 缓存对导入结果按 ID 去重#2139双击不会追加重复的安装条目根级SKILL.md仓库Skill 安装与更新流程现在稳定地解析三种来源形态——直接嵌套路径、按 install-name 的递归搜索、以及仓库根目录的SKILL.md来源#2231。相关交互逻辑分布在 src/components/skills/RepoManagerPanel.tsx 与 src/hooks/useSkills.ts。模型快捷设置Model Quick-Set修复模型一键配置现在基于最新的供应商表单状态应用#2249修复了旧表单状态stale form state导致一键配置失败的问题。Gemini 会话恢复路径#2240Gemini 会话扫描现在会读取会话条目中的.project_root元数据文件恢复流程在可用时把原始项目目录传回给恢复操作解决会话恢复到错误工作目录的问题。实现位于 src-tauri/src/session_manager/providers/gemini.rs直接以entry.path().join(.project_root)读取元数据。其他小修复还包括供应商悬停名称#2237供应商图标在 inline SVG、图片 URL 与兜底首字母三种渲染路径下悬停时都会暴露供应商名称见 src/components/ProviderIcon.tsx布局打磨#2201滚动区视口增加宽度约束修复水平溢出收紧应用底部与设置页脚间距长会话 / 长设置页面显示更整洁。移除Hermes 配置健康扫描器v3.14.1移除了内置的 Hermes 配置健康扫描器及其警告横幅同时移除scan_hermes_config_health命令HermesHealthWarning类型HermesWriteOutcome.warnings载荷。在仓库中搜索scan_hermes_config_health目前只能命中 CHANGELOG.md 与三语发布说明说明该命令确实已从代码中删除。移除后CC Switch 的 Hermes 面板聚焦其核心职责当前供应商展示、默认供应商切换、Memory 编辑、启动 Hermes Web UI。深度 YAML 配置健康问题交给 Hermes 自身的 Web UI 面板处理。迁移建议官方 Notes如果你之前依赖 CC Switch 暴露 Hermes 深度配置问题请改用工具栏的 Launch Hermes Web UI 按钮在 Hermes 自己的面板中排查日常供应商管理、切换、Memory 编辑与 MCP / Skills 同步仍由 CC Switch 负责。注意事项Notes CaveatsFAST 模式默认关闭只有在接受以更高 ChatGPT 配额消耗换更低延迟时才开启托盘缓存用量刷新被限流且仅限当前可见应用避免不必要的上游 API 调用数值同步进 React Query保证主窗口与托盘一致。下载与安装到项目 Releases 页面ccswitch.io 官网亦提供入口下载对应版本。系统要求系统最低版本架构WindowsWindows 10 及以上x64macOSmacOS 12 (Monterey) 及以上Intel (x64) / Apple Silicon (arm64)Linux见下表x64Windows文件说明CC-Switch-v3.14.1-Windows.msi推荐- MSI 安装包支持自动更新CC-Switch-v3.14.1-Windows-Portable.zip绿色版解压即用不写注册表macOS文件说明CC-Switch-v3.14.1-macOS.dmg推荐- DMG 安装包拖入 ApplicationsCC-Switch-v3.14.1-macOS.zip解压拖入 Applications通用二进制CC-Switch-v3.14.1-macOS.tar.gz用于 Homebrew 安装与自动更新macOS 构建已经 Apple 代码签名与公证notarized可直接安装。Homebrew 方式brew tap farion1231/ccswitch brew install --cask cc-switch升级brew upgrade --cask cc-switchLinux发行版推荐格式安装方式Ubuntu / Debian / Linux Mint / Pop!_OS.debsudo dpkg -i CC-Switch-*.deb或sudo apt install ./CC-Switch-*.debFedora / RHEL / CentOS / Rocky Linux.rpmsudo rpm -i CC-Switch-*.rpm或sudo dnf install ./CC-Switch-*.rpmopenSUSE.rpmsudo zypper install ./CC-Switch-*.rpmArch Linux / Manjaro.AppImage添加执行权限后运行或使用 AUR其他发行版 / 不确定.AppImagechmod x CC-Switch-*.AppImage ./CC-Switch-*.AppImage小结v3.14.1 是一次以代理正确性和用量可见性为主题的补丁版本Codex OAuth 反向代理的缓存身份、SSE 聚合与探测一致性修复直接决定了 ChatGPT 配额场景下的稳定性与成本托盘用量与h/w双窗口布局让用量管理无需进入主界面FAST 模式则以一个显式开关把延迟—配额的权衡交还给用户。若你在使用 Codex OAuth 支撑的 Claude 供应商本版本的缓存路由修复值得优先升级。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 CC Switch v3.14.1 版本解析：托盘用量可视化、Codex OAuth 稳定性修复与 FAST 模式详解
CC Switch v3.14.1 版本解析托盘用量可视化、Codex OAuth 稳定性修复与 FAST 模式详解【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch本文基于 CC Switch v3.14.1 官方发布说明docs/release-notes/v3.14.1-en.md撰写并结合仓库源码对每项变更的实现细节进行佐证。读完后你将了解系统托盘如何展示当前 Claude / Codex / Gemini 供应商的缓存用量、Kimi / Zhipu / MiniMax 等编码套餐的双窗口用量布局 h12% w80%如何生成、Codex OAuth 反向代理在本版本修复的四类稳定性问题缓存路由、Responses SSE 聚合、Stream Check 一致性、模型字段提取以及 Hermes 配置健康扫描器为何被移除。版本概览CC Switch v3.14.1 是紧随 v3.14.0 之后的补丁版本发布日期2026-04-23更新规模为13 commits | 48 个文件变更 | 1,883 / -808 行。版本聚焦五个方向Codex OAuth 反向代理稳定性修复缓存身份抖动、SSE 聚合与 Stream Check 探测不一致托盘用量可视化首次把缓存用量直接渲染进系统托盘子菜单Skills 导入 / 安装可靠性去重、防重复点击、根级SKILL.md仓库支持Gemini 会话恢复路径读取.project_root元数据还原原始项目目录Hermes 配置健康处理简化移除内置健康扫描器。托盘用量可视化Tray Usage Visibility本版本最显著的新增能力是Claude / Codex / Gemini 的系统托盘子菜单现在会直接展示当前供应商的缓存用量issue #2184包括两类摘要订阅配额摘要subscription quota summary——如 ChatGPT / 官方订阅的用量百分比用量脚本摘要usage-script summary——基于meta.usage_script配置拉取并计算的用量带颜色编码的利用率标记。行为上有三点约束源码层面可以印证刷新被限流throttled避免托盘高频触发上游 API 调用**仅限当前可见应用visible apps**刷新其他应用不受托盘刷新影响刷新结果会同步回 React Query主窗口与托盘共享同一份用量缓存。托盘侧的摘要拼装逻辑位于 src-tauri/src/tray.rs其中包含了窗口摘要的格式化与单元测试例如断言摘要字符串中包含h12%、w80%、w95%等窗口片段。编码套餐双窗口展示Kimi / Zhipu / MiniMax针对 Kimi / Zhipu / MiniMax 等中国编码套餐供应商托盘渲染**5 小时窗口 周窗口**双档用量采用与官方订阅徽章完全一致的 h12% w80%布局取两个窗口中利用率最差的一档来决定 emoji 颜色语义与主界面的订阅徽章相同。h为 5 小时窗口利用率w为周窗口利用率火山方舟等月窗口套餐还会额外携带m月窗口从 src-tauri/src/tray.rs 顶部注释与测试用例script_summary_token_plan_weekly_only等可以确认该布局规则。更关键的自动化行为是自动注入用量脚本创建 Claude 供应商时如果ANTHROPIC_BASE_URL匹配已知编码套餐主机如api.kimi.com/coding、api.minimaxi.com等CC Switch 会自动注入meta.usage_script托盘无需打开 Usage Script 弹窗即可直接点亮。已知主机的正则匹配定义在前端 src/config/codingPlanProviders.ts 中例如 Kimi 的匹配模式为api\.kimi\.com\/codingMiniMax 为api\.minimaxi?\.com|api\.minimax\.io并通过detectCodingPlanProvider做首匹配路由Zhipu 个人版排在zhipu_team前面保留用户自定义更新供应商时已存在的usage_script值会被保留绝不会被自动注入覆盖用户自定义脚本不受影响。用量脚本的执行链路在 src-tauri/src/services/provider/usage.rs脚本需enabled为真才会执行timeout未设置时默认10 秒template_type、api_key、base_url、access_token、user_id等字段都会透传给脚本运行时校验逻辑如interval_too_large报错由validate_usage_script负责。弹窗界面见 src/components/UsageScriptModal.tsx。Codex OAuth FAST 模式新增开关本版本为Codex OAuth 支撑的 Claude 供应商新增了显式的FAST 模式开关issue #2210开启后经过格式转换发往 ChatGPT Codex 上游的 Responses 请求会携带service_tierpriority用更低的延迟换取更高的 ChatGPT 配额消耗默认关闭避免用户无感知地增加配额消耗。源码层面该开关的实现非常直接src-tauri/src/provider.rs 中ProviderMeta新增字段codex_fast_mode: Optionbool其语义注释明确写着注入service_tier priority用于 ChatGPT Codex 请求访问器codex_fast_mode_enabled()使用unwrap_or(false)从源码结构看即缺省视为关闭转换入口在 src-tauri/src/proxy/providers/claude.rs构造请求转换上下文时读取provider.codex_fast_mode_enabled()并传入实际注入点在 src-tauri/src/proxy/providers/transform_responses.rs仅当codex_fast_mode为真时才写入result[service_tier] priority。对应的单元测试覆盖了开/关两种状态——开启时断言service_tier priority约 L4907关闭或默认时断言该字段不存在约 L4926、L4972保证默认不注入这一默认值契约。Codex OAuth 稳定性修复本版本集中修复了反向代理的四类问题逐一说明1. 缓存路由Cache Routing#2218问题代理之前会为请求生成新的 UUID导致 Codex 上游的缓存身份cache identity不断抖动——同一个逻辑会话在上游被当成无数个不同会话缓存命中率被摧毁。修复现在客户端提供的 session ID 同时用作prompt_cache_key与 Codex 会话头保留显式缓存键不再生成临时 UUID。prompt_cache_key的读取与传递贯穿 src-tauri/src/proxy/providers/transform_responses.rs、src-tauri/src/proxy/providers/codex.rs 与 src-tauri/src/proxy/session.rs 等模块。2. Responses SSE 聚合#2235问题ChatGPT Codex 上游会强制以 OpenAI Responses SSE流式事件流返回即使客户端请求的是非流式响应。此前非流式的 Anthropic 客户端例如期望一次性 JSON 的 Claude Code 客户端在这种场景下拿不到合法的 JSON。修复CC Switch 现在会先聚合上游的完整 SSE 事件流再对聚合结果执行非流式格式转换最终向 Anthropic 客户端返回正确的 JSON。这属于典型的协议适配逻辑上游协议形态不可控时代理承担聚合-转换职责。3. Stream Check 与生产请求对齐#2210问题Stream Check流连通性检测此前构造的 Codex OAuth 探测请求与生产代理流量不一致导致检测失败但实际能用check fails but it actually works的误报。修复Stream Check 现在以与生产代理流量完全相同的参数构造探测请求store: false不持久化对话加密推理内容包含encrypted reasoning include供应商的FAST 模式设置同样参与探测即 FAST 开关开启时探测也会带service_tierpriority。前端探测入口见 src/hooks/useStreamCheck.ts。4. 模型字段提取改用 TOML 解析#2227读取 Codex 配置中的model字段从首行正则匹配改为标准 TOML 解析多行 TOML 结构如跨行的model ...或嵌套表现在可以被正确解析。解析主体位于 src-tauri/src/codex_config.rs。Skills 导入 / 安装可靠性导入对话框防重复Skills 导入对话框在导入进行中会禁用操作按钮#2211防止连击缓存按 ID 去重已安装 Skills 缓存对导入结果按 ID 去重#2139双击不会追加重复的安装条目根级SKILL.md仓库Skill 安装与更新流程现在稳定地解析三种来源形态——直接嵌套路径、按 install-name 的递归搜索、以及仓库根目录的SKILL.md来源#2231。相关交互逻辑分布在 src/components/skills/RepoManagerPanel.tsx 与 src/hooks/useSkills.ts。模型快捷设置Model Quick-Set修复模型一键配置现在基于最新的供应商表单状态应用#2249修复了旧表单状态stale form state导致一键配置失败的问题。Gemini 会话恢复路径#2240Gemini 会话扫描现在会读取会话条目中的.project_root元数据文件恢复流程在可用时把原始项目目录传回给恢复操作解决会话恢复到错误工作目录的问题。实现位于 src-tauri/src/session_manager/providers/gemini.rs直接以entry.path().join(.project_root)读取元数据。其他小修复还包括供应商悬停名称#2237供应商图标在 inline SVG、图片 URL 与兜底首字母三种渲染路径下悬停时都会暴露供应商名称见 src/components/ProviderIcon.tsx布局打磨#2201滚动区视口增加宽度约束修复水平溢出收紧应用底部与设置页脚间距长会话 / 长设置页面显示更整洁。移除Hermes 配置健康扫描器v3.14.1移除了内置的 Hermes 配置健康扫描器及其警告横幅同时移除scan_hermes_config_health命令HermesHealthWarning类型HermesWriteOutcome.warnings载荷。在仓库中搜索scan_hermes_config_health目前只能命中 CHANGELOG.md 与三语发布说明说明该命令确实已从代码中删除。移除后CC Switch 的 Hermes 面板聚焦其核心职责当前供应商展示、默认供应商切换、Memory 编辑、启动 Hermes Web UI。深度 YAML 配置健康问题交给 Hermes 自身的 Web UI 面板处理。迁移建议官方 Notes如果你之前依赖 CC Switch 暴露 Hermes 深度配置问题请改用工具栏的 Launch Hermes Web UI 按钮在 Hermes 自己的面板中排查日常供应商管理、切换、Memory 编辑与 MCP / Skills 同步仍由 CC Switch 负责。注意事项Notes CaveatsFAST 模式默认关闭只有在接受以更高 ChatGPT 配额消耗换更低延迟时才开启托盘缓存用量刷新被限流且仅限当前可见应用避免不必要的上游 API 调用数值同步进 React Query保证主窗口与托盘一致。下载与安装到项目 Releases 页面ccswitch.io 官网亦提供入口下载对应版本。系统要求系统最低版本架构WindowsWindows 10 及以上x64macOSmacOS 12 (Monterey) 及以上Intel (x64) / Apple Silicon (arm64)Linux见下表x64Windows文件说明CC-Switch-v3.14.1-Windows.msi推荐- MSI 安装包支持自动更新CC-Switch-v3.14.1-Windows-Portable.zip绿色版解压即用不写注册表macOS文件说明CC-Switch-v3.14.1-macOS.dmg推荐- DMG 安装包拖入 ApplicationsCC-Switch-v3.14.1-macOS.zip解压拖入 Applications通用二进制CC-Switch-v3.14.1-macOS.tar.gz用于 Homebrew 安装与自动更新macOS 构建已经 Apple 代码签名与公证notarized可直接安装。Homebrew 方式brew tap farion1231/ccswitch brew install --cask cc-switch升级brew upgrade --cask cc-switchLinux发行版推荐格式安装方式Ubuntu / Debian / Linux Mint / Pop!_OS.debsudo dpkg -i CC-Switch-*.deb或sudo apt install ./CC-Switch-*.debFedora / RHEL / CentOS / Rocky Linux.rpmsudo rpm -i CC-Switch-*.rpm或sudo dnf install ./CC-Switch-*.rpmopenSUSE.rpmsudo zypper install ./CC-Switch-*.rpmArch Linux / Manjaro.AppImage添加执行权限后运行或使用 AUR其他发行版 / 不确定.AppImagechmod x CC-Switch-*.AppImage ./CC-Switch-*.AppImage小结v3.14.1 是一次以代理正确性和用量可见性为主题的补丁版本Codex OAuth 反向代理的缓存身份、SSE 聚合与探测一致性修复直接决定了 ChatGPT 配额场景下的稳定性与成本托盘用量与h/w双窗口布局让用量管理无需进入主界面FAST 模式则以一个显式开关把延迟—配额的权衡交还给用户。若你在使用 Codex OAuth 支撑的 Claude 供应商本版本的缓存路由修复值得优先升级。【免费下载链接】cc-switchA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build Hermes Agent. Only official website: ccswitch.io项目地址: https://gitcode.com/GitHub_Trending/cc/cc-switch创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考