CC Switch v3.12.2 深度解析代理接管期间通用配置保护与 Codex TOML Section 感知编辑【免费下载链接】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.12.2 的官方发布说明v3.12.2-en.md展开围绕该版本的核心主题——代理Proxy接管模式下 Common Config 的保护机制、Snippet 生命周期稳定性、Codex TOML Section 感知编辑引擎——逐条拆解其设计动机与实现路径。读完本文你将理解 CC Switch 是如何通过恢复备份优先的接管恢复流程、cleared标志和按 server id 合并的 MCP 快照策略来保证配置回滚完整性的以及 Codexconfig.toml的base_url/model字段为何必须定位到正确的[model_providers.name]Section并能结合源码定位每个修复点的具体实现位置。版本概览CC Switch v3.12.2 是一个以可靠性为核心的补丁版本官方定位为Common Config Protection During Proxy Takeover, Snippet Lifecycle Stability, Section-Aware Codex TOML Editing。项目内容发布日期2026-03-12更新规模5 commits | 22 files changed | 1,716 / -288 lines核心主题修复代理接管期间通用配置Common Config丢失改进 Codex TOML 编辑准确性该版本的三项主线改动可以归纳为一条主线接管Takeover全生命周期中用户真实配置不能被任何中间态覆盖或丢失——热切换与供应商同步改为更新恢复备份而非直接覆盖 live 配置文件回滚时能还原完整用户配置启动流程重排序先从干净的 live 文件提取 Snippet再恢复接管状态Codexbase_url编辑重构为Section 感知模型不再把字段错误追加到文件末尾。此外还有两项配套改进供应商列表空状态引导优化、Codexmcp_servers恢复快照保护。核心问题一代理接管恢复流程重构Proxy Takeover Restore Flow问题背景CC Switch 的代理接管模式下应用会改写 Claude Code / Codex 等 CLI 的 live 配置文件如 Codex 的~/.codex/config.toml路径解析见 codex_config.rs 中的get_codex_config_path使流量经过本地代理。为了支持随时回滚接管前必须保存一份恢复快照restore snapshot。v3.12.2 之前接管期间的供应商同步provider sync与热切换会直接写入 live 配置文件导致三类配置丢失场景同步过程直接覆盖 live 文件丢失其中携带的通用配置Common Config热切换产生的恢复快照不完整回滚后拿不到真实用户配置供应商切换时配置变更被丢弃。v3.12.2 的解决方案根据发布说明的 Changes 一节本版本的接管恢复流程做了三点结构性调整接管活跃时供应商同步只更新恢复备份不直接写 live 配置文件。live 文件与恢复备份的职责被明确分离live 文件承载当前生效的接管配置恢复备份承载回滚目标。保存恢复快照前先应用 Common Config 重建有效供应商设置effective provider settings。这样恢复快照里保存的是已经合并了通用配置的真实用户配置而不是一个缺了 Common Config 片段的中间态。遗留供应商中推断使用了通用配置的条目自动标记commonConfigEnabledtrue。这保证了旧版本迁移上来的供应商不会因为缺少显式开关而被当成不使用通用配置处理。从源码结构看commonConfigEnabled与cleared相关逻辑分布在设置持久化层settings.rs、database/dao/settings.rs与命令层commands/config.rs、commands/provider.rs中说明该标志既随设置持久化也在供应商读写路径上参与判断。这一改动同时解释了 Bug Fixes 一节中Common Config Loss的三种场景为何能被一并覆盖只要恢复快照在写入前就包含了 Common Config同步覆盖、热切换、供应商切换三条路径都不可能再产生不完整快照。核心问题二Codex TOML Section 感知编辑引擎这是 v3.12.2 中工程含量最高的改动发布说明将其概括为Section-Aware Codex TOML Editingbase_url和model字段的读写现在定位到正确的[model_providers.name]Section。修复前的两个典型错误修复前Codexbase_url的提取与编辑存在两类误操作位置错误base_url被追加到文件末尾顶层而不是写在当前model_provider指向的[model_providers.name]表格内Codex 无法识别张冠李戴mcp_servers.*.base_urlMCP 服务器的连接地址会被误识别为模型供应商端点导致提取出错误的供应商 URL。Rust 端codex_config.rs共享编辑模块本版本在 src-tauri/src/codex_config.rs 中新增了 Section 感知的 TOML 辅助函数其中两个核心入口update_codex_toml_fieldcodex_config.rs#L3091-L3184——基于toml_edit::DocumentMut做保留语法/注释的字段更新路由规则为字段写入位置base_url、wire_api若顶层存在model_provider写入[model_providers.当前供应商].field否则回退到顶层字段model、model_catalog_json顶层字段空值表示删除字段而非写入空串。实现上有几个值得注意的防御细节均可见于源码注释使用as_table_like_mut而非as_table_mut用户把model_providers写成 inline tablemodel_providers { foo {...} }TOML 合法时as_table_mut会返回None从而掉进顶层 fallback把字段写到错误层级且毫无提示当model_providers键存在但不是表如model_providers 42时重置为空表并通过log::warn!留痕避免静默替换用户手写值Section 结构异常时降级为顶层写入同样伴随告警日志。remove_codex_toml_base_url_ifcodex_config.rs#L3186-L3232——用于代理清理场景仅当base_url值满足传入谓词predicate时才移除先处理当前model_providerSection 内的base_url再兜底清理顶层匹配项。这意味着清理本地代理地址时不会误删用户自行配置的供应商 URL且 TOML 解析失败时原样返回保证清理路径永不破坏原始文件。原先散落在 services/proxy.rs 中的 TOML 内联编辑逻辑本版本统一委托给该模块——发布说明中5 commits / 22 files changed / 1,716的更新规模主要就是这次去重重构。前端端providerConfigUtils.ts的 Section 感知工具与 Rust 端对称前端在 src/utils/providerConfigUtils.ts 中新增了 Section 感知的行级工具函数用于 UI 侧预览与编辑 live 配置文本getTomlSectionRangeproviderConfigUtils.ts#L487-L522按行扫描 TOML 表格头TOML_SECTION_HEADER_PATTERN返回目标 Section 的headerLineIndex/bodyStartIndex/bodyEndIndex即该 Section 的精确行区间getCodexProviderSectionNameproviderConfigUtils.ts#L598-L603解析顶层model_provider得到供应商名拼接出model_providers.name作为目标 Section 名解析失败时回退到行级正则扫描getCodexModelProviderName中实现了先 TOML 解析、失败再逐行匹配的容错路径保证用户在编辑器里敲到一半的非法 TOML 也能正确定位配套还有getTomlSectionInsertIndex跳过 Section 末尾空行计算插入点、findTomlAssignmentInRange限定行区间内查找赋值语句等确保所有赋值读写都发生在目标 Section 区间内从根上杜绝追加到文件尾部或跨 Section 误匹配的问题。此外该文件维护了一份与 Rust 端CODEX_RESERVED_MODEL_PROVIDER_IDS保持一致的保留供应商 ID 集合openai、amazon-bedrock、ollama、lmstudio、oss、ollama-chat用于区分自定义供应商 Section与 Codex 内置供应商避免对内置 ID 的 Section 做误判。一个直观的对照# 修复前错误base_url 被追加到文件末尾 [model_providers.custom] name My Provider [mcp_servers.filesystem] command npx args [-y, modelcontextprotocol/server-filesystem] base_url http://127.0.0.1:15721/v1 # 顶层Codex 读不到还会与 MCP 配置混淆 # 修复后Section 感知写入 [model_providers.custom] 内部 [model_providers.custom] name My Provider base_url http://127.0.0.1:15721/v1 # 正确落在供应商 Section 内核心问题三Snippet 生命周期稳定性Common Config 在 CC Switch 中会以 **Snippet片段**形式存储并在启动时尝试从 live 文件自动提取/迁移。这一机制在旧版启动顺序下有两个稳定性缺陷本版本一并修复启动顺序重排先提取后恢复接管旧流程中代理接管状态先于 Snippet 提取恢复导致提取时读到的是接管改写后的 live 文件提取结果混入了接管痕迹。v3.12.2 将启动序列重排为先从干净的 live 文件自动提取 Common Config Snippet此时接管状态尚未恢复live 文件保持用户原始形态再恢复代理接管状态。这一顺序调整与前述恢复快照先应用 Common Config是同一条设计原则的两端任何自动化动作都必须以用户真实配置为基准态。cleared标志防止已清除 Snippet 复活自动提取机制带来了另一个副作用用户主动清空某个 Snippet 后下次启动时提取逻辑会依据 live 文件中的对应内容把 Snippet 重新创建出来造成清不干净的体验。本版本引入 Snippetcleared标志显式追踪用户是否有意清空了该 Snippet自动提取在遇到cleared状态的 Snippet 时跳过重建。发布说明将此项列为 Bug Fixes 中的Cleared Snippet Resurrection修复。一次性遗留迁移标志旧版本供应商可能缺少commonConfigEnabled字段需要推断回填。本版本将迁移完成状态持久化为一次性标志避免每次启动都重复执行commonConfigEnabled回填扫描。Bug 修复Codex 恢复快照中的mcp_servers保护除主流程外发布说明在 Bug Fixes 中单独列出了一项修复Codex 接管恢复备份在供应商热切换时丢弃已有mcp_servers配置块。原策略是整表替换——热切换时恢复备份中的整个mcp_servers表格被供应商/通用配置的 MCP 定义整体覆盖用户自有的服务器定义随之丢失。v3.12.2 将其改为按 server id 合并per-server-id merge优先级规则为供应商 / Common Config 中定义的 MCP 服务器冲突时优先win on conflict恢复备份中独有的服务器完整保留不丢失。mcp_servers的处理逻辑集中在 services/proxy.rs 中与该文件的 MCP 相关代码共同构成接管期间的配置保护面。新功能供应商空状态引导Empty State Guidance本版本还改善了首次使用体验当供应商列表为空时空状态页面对应 ProviderEmptyState.tsx现在会展示分步的导入操作指引并且有条件地为 Claude/Codex/Gemini 应用显示 Common Config Snippet 功能提示——OpenCode/OpenClaw 不显示该提示因为 Snippet 机制与这三家的 live 配置文件结构直接相关。下载与安装v3.12.2 适用说明以下为发布说明中给出的 v3.12.2 安装信息。注意以上安装方式适用于 v3.12.2 及同系列版本当前仓库代码已演进到更高版本发布说明目录中可见 v3.12.x 至 v3.20.0 的完整系列见 docs/release-notes/若需最新特性请以仓库当前版本为准。系统要求系统最低版本架构WindowsWindows 10 及以上x64macOSmacOS 10.15 (Catalina) 及以上Intel (x64) / Apple Silicon (arm64)Linux见下表x64Windows文件说明CC-Switch-v3.12.2-Windows.msi推荐- MSI 安装包支持自动更新CC-Switch-v3.12.2-Windows-Portable.zip便携版解压即用不写入注册表macOS文件说明CC-Switch-v3.12.2-macOS.zip推荐- 解压后拖入 Applications 即可Universal BinaryCC-Switch-v3.12.2-macOS.tar.gz用于 Homebrew 安装和自动更新注意由于作者没有苹果开发者账号首次打开可能出现未知开发者警告请先关闭然后前往系统设置 → 隐私与安全性 → 点击仍要打开之后便可以正常打开。HomebrewmacOSbrew 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.12.2-zh.md、v3.12.2-en.md、v3.12.2-ja.mdRust 端 TOML Section 感知编辑codex_config.rsupdate_codex_toml_field、remove_codex_toml_base_url_if前端 Section 感知工具函数providerConfigUtils.tsgetTomlSectionRange、getCodexProviderSectionName代理接管与 MCP 快照保护services/proxy.rscommonConfigEnabled/cleared持久化settings.rs、database/dao/settings.rs空状态引导组件ProviderEmptyState.tsx【免费下载链接】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.12.2 深度解析代理接管期间通用配置保护与 Codex TOML Section 感知编辑【免费下载链接】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.12.2 的官方发布说明v3.12.2-en.md展开围绕该版本的核心主题——代理Proxy接管模式下 Common Config 的保护机制、Snippet 生命周期稳定性、Codex TOML Section 感知编辑引擎——逐条拆解其设计动机与实现路径。读完本文你将理解 CC Switch 是如何通过恢复备份优先的接管恢复流程、cleared标志和按 server id 合并的 MCP 快照策略来保证配置回滚完整性的以及 Codexconfig.toml的base_url/model字段为何必须定位到正确的[model_providers.name]Section并能结合源码定位每个修复点的具体实现位置。版本概览CC Switch v3.12.2 是一个以可靠性为核心的补丁版本官方定位为Common Config Protection During Proxy Takeover, Snippet Lifecycle Stability, Section-Aware Codex TOML Editing。项目内容发布日期2026-03-12更新规模5 commits | 22 files changed | 1,716 / -288 lines核心主题修复代理接管期间通用配置Common Config丢失改进 Codex TOML 编辑准确性该版本的三项主线改动可以归纳为一条主线接管Takeover全生命周期中用户真实配置不能被任何中间态覆盖或丢失——热切换与供应商同步改为更新恢复备份而非直接覆盖 live 配置文件回滚时能还原完整用户配置启动流程重排序先从干净的 live 文件提取 Snippet再恢复接管状态Codexbase_url编辑重构为Section 感知模型不再把字段错误追加到文件末尾。此外还有两项配套改进供应商列表空状态引导优化、Codexmcp_servers恢复快照保护。核心问题一代理接管恢复流程重构Proxy Takeover Restore Flow问题背景CC Switch 的代理接管模式下应用会改写 Claude Code / Codex 等 CLI 的 live 配置文件如 Codex 的~/.codex/config.toml路径解析见 codex_config.rs 中的get_codex_config_path使流量经过本地代理。为了支持随时回滚接管前必须保存一份恢复快照restore snapshot。v3.12.2 之前接管期间的供应商同步provider sync与热切换会直接写入 live 配置文件导致三类配置丢失场景同步过程直接覆盖 live 文件丢失其中携带的通用配置Common Config热切换产生的恢复快照不完整回滚后拿不到真实用户配置供应商切换时配置变更被丢弃。v3.12.2 的解决方案根据发布说明的 Changes 一节本版本的接管恢复流程做了三点结构性调整接管活跃时供应商同步只更新恢复备份不直接写 live 配置文件。live 文件与恢复备份的职责被明确分离live 文件承载当前生效的接管配置恢复备份承载回滚目标。保存恢复快照前先应用 Common Config 重建有效供应商设置effective provider settings。这样恢复快照里保存的是已经合并了通用配置的真实用户配置而不是一个缺了 Common Config 片段的中间态。遗留供应商中推断使用了通用配置的条目自动标记commonConfigEnabledtrue。这保证了旧版本迁移上来的供应商不会因为缺少显式开关而被当成不使用通用配置处理。从源码结构看commonConfigEnabled与cleared相关逻辑分布在设置持久化层settings.rs、database/dao/settings.rs与命令层commands/config.rs、commands/provider.rs中说明该标志既随设置持久化也在供应商读写路径上参与判断。这一改动同时解释了 Bug Fixes 一节中Common Config Loss的三种场景为何能被一并覆盖只要恢复快照在写入前就包含了 Common Config同步覆盖、热切换、供应商切换三条路径都不可能再产生不完整快照。核心问题二Codex TOML Section 感知编辑引擎这是 v3.12.2 中工程含量最高的改动发布说明将其概括为Section-Aware Codex TOML Editingbase_url和model字段的读写现在定位到正确的[model_providers.name]Section。修复前的两个典型错误修复前Codexbase_url的提取与编辑存在两类误操作位置错误base_url被追加到文件末尾顶层而不是写在当前model_provider指向的[model_providers.name]表格内Codex 无法识别张冠李戴mcp_servers.*.base_urlMCP 服务器的连接地址会被误识别为模型供应商端点导致提取出错误的供应商 URL。Rust 端codex_config.rs共享编辑模块本版本在 src-tauri/src/codex_config.rs 中新增了 Section 感知的 TOML 辅助函数其中两个核心入口update_codex_toml_fieldcodex_config.rs#L3091-L3184——基于toml_edit::DocumentMut做保留语法/注释的字段更新路由规则为字段写入位置base_url、wire_api若顶层存在model_provider写入[model_providers.当前供应商].field否则回退到顶层字段model、model_catalog_json顶层字段空值表示删除字段而非写入空串。实现上有几个值得注意的防御细节均可见于源码注释使用as_table_like_mut而非as_table_mut用户把model_providers写成 inline tablemodel_providers { foo {...} }TOML 合法时as_table_mut会返回None从而掉进顶层 fallback把字段写到错误层级且毫无提示当model_providers键存在但不是表如model_providers 42时重置为空表并通过log::warn!留痕避免静默替换用户手写值Section 结构异常时降级为顶层写入同样伴随告警日志。remove_codex_toml_base_url_ifcodex_config.rs#L3186-L3232——用于代理清理场景仅当base_url值满足传入谓词predicate时才移除先处理当前model_providerSection 内的base_url再兜底清理顶层匹配项。这意味着清理本地代理地址时不会误删用户自行配置的供应商 URL且 TOML 解析失败时原样返回保证清理路径永不破坏原始文件。原先散落在 services/proxy.rs 中的 TOML 内联编辑逻辑本版本统一委托给该模块——发布说明中5 commits / 22 files changed / 1,716的更新规模主要就是这次去重重构。前端端providerConfigUtils.ts的 Section 感知工具与 Rust 端对称前端在 src/utils/providerConfigUtils.ts 中新增了 Section 感知的行级工具函数用于 UI 侧预览与编辑 live 配置文本getTomlSectionRangeproviderConfigUtils.ts#L487-L522按行扫描 TOML 表格头TOML_SECTION_HEADER_PATTERN返回目标 Section 的headerLineIndex/bodyStartIndex/bodyEndIndex即该 Section 的精确行区间getCodexProviderSectionNameproviderConfigUtils.ts#L598-L603解析顶层model_provider得到供应商名拼接出model_providers.name作为目标 Section 名解析失败时回退到行级正则扫描getCodexModelProviderName中实现了先 TOML 解析、失败再逐行匹配的容错路径保证用户在编辑器里敲到一半的非法 TOML 也能正确定位配套还有getTomlSectionInsertIndex跳过 Section 末尾空行计算插入点、findTomlAssignmentInRange限定行区间内查找赋值语句等确保所有赋值读写都发生在目标 Section 区间内从根上杜绝追加到文件尾部或跨 Section 误匹配的问题。此外该文件维护了一份与 Rust 端CODEX_RESERVED_MODEL_PROVIDER_IDS保持一致的保留供应商 ID 集合openai、amazon-bedrock、ollama、lmstudio、oss、ollama-chat用于区分自定义供应商 Section与 Codex 内置供应商避免对内置 ID 的 Section 做误判。一个直观的对照# 修复前错误base_url 被追加到文件末尾 [model_providers.custom] name My Provider [mcp_servers.filesystem] command npx args [-y, modelcontextprotocol/server-filesystem] base_url http://127.0.0.1:15721/v1 # 顶层Codex 读不到还会与 MCP 配置混淆 # 修复后Section 感知写入 [model_providers.custom] 内部 [model_providers.custom] name My Provider base_url http://127.0.0.1:15721/v1 # 正确落在供应商 Section 内核心问题三Snippet 生命周期稳定性Common Config 在 CC Switch 中会以 **Snippet片段**形式存储并在启动时尝试从 live 文件自动提取/迁移。这一机制在旧版启动顺序下有两个稳定性缺陷本版本一并修复启动顺序重排先提取后恢复接管旧流程中代理接管状态先于 Snippet 提取恢复导致提取时读到的是接管改写后的 live 文件提取结果混入了接管痕迹。v3.12.2 将启动序列重排为先从干净的 live 文件自动提取 Common Config Snippet此时接管状态尚未恢复live 文件保持用户原始形态再恢复代理接管状态。这一顺序调整与前述恢复快照先应用 Common Config是同一条设计原则的两端任何自动化动作都必须以用户真实配置为基准态。cleared标志防止已清除 Snippet 复活自动提取机制带来了另一个副作用用户主动清空某个 Snippet 后下次启动时提取逻辑会依据 live 文件中的对应内容把 Snippet 重新创建出来造成清不干净的体验。本版本引入 Snippetcleared标志显式追踪用户是否有意清空了该 Snippet自动提取在遇到cleared状态的 Snippet 时跳过重建。发布说明将此项列为 Bug Fixes 中的Cleared Snippet Resurrection修复。一次性遗留迁移标志旧版本供应商可能缺少commonConfigEnabled字段需要推断回填。本版本将迁移完成状态持久化为一次性标志避免每次启动都重复执行commonConfigEnabled回填扫描。Bug 修复Codex 恢复快照中的mcp_servers保护除主流程外发布说明在 Bug Fixes 中单独列出了一项修复Codex 接管恢复备份在供应商热切换时丢弃已有mcp_servers配置块。原策略是整表替换——热切换时恢复备份中的整个mcp_servers表格被供应商/通用配置的 MCP 定义整体覆盖用户自有的服务器定义随之丢失。v3.12.2 将其改为按 server id 合并per-server-id merge优先级规则为供应商 / Common Config 中定义的 MCP 服务器冲突时优先win on conflict恢复备份中独有的服务器完整保留不丢失。mcp_servers的处理逻辑集中在 services/proxy.rs 中与该文件的 MCP 相关代码共同构成接管期间的配置保护面。新功能供应商空状态引导Empty State Guidance本版本还改善了首次使用体验当供应商列表为空时空状态页面对应 ProviderEmptyState.tsx现在会展示分步的导入操作指引并且有条件地为 Claude/Codex/Gemini 应用显示 Common Config Snippet 功能提示——OpenCode/OpenClaw 不显示该提示因为 Snippet 机制与这三家的 live 配置文件结构直接相关。下载与安装v3.12.2 适用说明以下为发布说明中给出的 v3.12.2 安装信息。注意以上安装方式适用于 v3.12.2 及同系列版本当前仓库代码已演进到更高版本发布说明目录中可见 v3.12.x 至 v3.20.0 的完整系列见 docs/release-notes/若需最新特性请以仓库当前版本为准。系统要求系统最低版本架构WindowsWindows 10 及以上x64macOSmacOS 10.15 (Catalina) 及以上Intel (x64) / Apple Silicon (arm64)Linux见下表x64Windows文件说明CC-Switch-v3.12.2-Windows.msi推荐- MSI 安装包支持自动更新CC-Switch-v3.12.2-Windows-Portable.zip便携版解压即用不写入注册表macOS文件说明CC-Switch-v3.12.2-macOS.zip推荐- 解压后拖入 Applications 即可Universal BinaryCC-Switch-v3.12.2-macOS.tar.gz用于 Homebrew 安装和自动更新注意由于作者没有苹果开发者账号首次打开可能出现未知开发者警告请先关闭然后前往系统设置 → 隐私与安全性 → 点击仍要打开之后便可以正常打开。HomebrewmacOSbrew 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.12.2-zh.md、v3.12.2-en.md、v3.12.2-ja.mdRust 端 TOML Section 感知编辑codex_config.rsupdate_codex_toml_field、remove_codex_toml_base_url_if前端 Section 感知工具函数providerConfigUtils.tsgetTomlSectionRange、getCodexProviderSectionName代理接管与 MCP 快照保护services/proxy.rscommonConfigEnabled/cleared持久化settings.rs、database/dao/settings.rs空状态引导组件ProviderEmptyState.tsx【免费下载链接】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），仅供参考
)
)
