CC Switch v3.7.1 版本深度解析Gemini 配置目录、Skills 子目录安装修复与对话框误触防护【免费下载链接】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.7.1 英文更新说明发布于 2025-11-22涉及 17 个文件、524 / -81 行改动展开逐项解析该版本的 Bug 修复、新特性与改进点并结合仓库源码验证每项改动的实际实现位置同时完整梳理其承载的 v3.7.0 大版本Gemini CLI 集成、MCP 统一架构、Skills/Prompts 管理系统的能力全貌。读完后你将了解本次稳定版具体解决了哪些配置持久化与交互问题以及这些能力在代码层是如何落地的。1. 版本概览v3.7.1 是一个以稳定性增强与用户体验改进为主题的补丁版本官方定位即“Stability Enhancements and User Experience Improvements”。其规模不大17 个文件524 / -81 行但每一项改动都针对真实用户反馈类别内容关联 IssueBug 修复第三方 Skills 仓库安装失败自定义子目录#268Bug 修复Gemini 配置切换供应商后丢失-Bug 修复点击遮罩层导致对话框意外关闭11 个对话框组件-新特性设置中支持自定义 Gemini 配置目录#255新特性ArchLinux 通过 AUR 安装#259改进Skills 错误信息 i18n28 条中英双语-改进下载超时从 15s 延长到 60s-改进统一的 Rust / TypeScript 代码格式化标准-该版本紧随 v3.7.02025-11-19 发布85 个 commit、152 个文件、18,104 / -3,732 行之后可以视为对 v3.7.0 大版本Gemini 集成、MCP 重构、Skills 与 Prompts 系统的快速护航。对应的 CHANGELOG.md 中[3.7.1] - 2025-11-22条目与本文描述一致可作为交叉验证依据。中文版更新说明见 v3.7.1-zh.md。2. Bug 修复2.1 修复第三方 Skills 仓库安装失败#268v3.7.1 修复了带有自定义子目录的 Skills 仓库例如ComposioHQ/awesome-claude-skills安装失败的问题。这类仓库的特点是不把SKILL.md放在仓库根目录而是分散在若干子目录中。从源码结构看该修复对应的核心逻辑位于 SkillService 的 install 流程。安装时服务会把整个仓库归档下载到临时目录随后调用resolve_skill_source_dir解析真实源目录。当前仓库中该函数采用三级回退策略skill.rs直接相对路径命中root/directory存在且包含SKILL.md时直接采用且必须校验SKILL.md避免把同名空壳目录误判为源目录按名字递归查找在仓库内递归搜索同名的、含SKILL.md的目录兜底仓库根仓库根本身存在SKILL.md时视为单技能仓库。这一解析逻辑有完整的单元测试覆盖包括根级技能、嵌套目录、按安装名回退、拒绝同名包装目录、两级目录目录型技能、无SKILL.md时返回 None 等场景测试代码印证了 v3.7.1 对子目录场景的系统性修复。2.2 修复 Gemini 配置持久化问题v3.7.1 解决了在 Gemini 表单中编辑settings.json后切换供应商时编辑内容丢失的问题。结合 v3.7.0 的 Gemini 双文件.envsettings.json架构该修复保证了表单中两个文件的编辑结果在切换供应商时被完整回写而不是只写入当前激活的那一份配置。Gemini 配置读取路径的入口在 gemini_config.rsget_gemini_dir()返回配置目录get_gemini_env_path()在其下定位.env文件settings.json则在同目录下读写二者共同构成 Gemini 的双文件配置面。2.3 防止点击遮罩层关闭对话框v3.7.1 为全部11 个对话框组件增加了遮罩层overlay/backdrop点击保护避免用户误点背景区域导致表单数据丢失。从源码结构看该保护统一落在基础对话框组件 dialog.tsx 的DialogContent上——通过onInteractOutside回调调用e.preventDefault()直接阻止“点击外部关闭”行为。由于各业务对话框Provider 编辑、MCP 表单、导入导出等都复用这一基础组件单点修改即可覆盖全部 11 个对话框这也是该版本改动行数控制得较紧凑的原因。3. 新特性3.1 Gemini 配置目录支持#255v3.7.1 在设置中新增Gemini 配置目录选项允许用户自定义~/.gemini/的位置。这在多账号、容器化环境或将 CLI 配置目录迁移到非默认路径例如~/.config/gemini类 XDG 布局的场景下非常实用。实现链路可以在源码中完整追踪持久化字段设备级设置结构体中新增了gemini_config_dir字段settings.rs与claude_config_dir、codex_config_dir等并列属于“设备级目录覆盖”一族未设置时为None序列化时自动跳过覆盖目录解析get_gemini_override_dir() 读取该字段并经resolve_override_path归一化为绝对路径全局生效get_gemini_dir() 优先返回覆盖目录否则回退到~/.gemini后续所有.env、settings.json、GEMINI.md、MCP 配置的读写均基于该目录派生。可以推断由于该覆盖属于设备级存于本机settings.json而非云端共享的供应商数据同一账号在不同机器上可以指向各自的 Gemini 目录不会互相污染——这与 CC Switch 对 Claude/Codex 目录覆盖的处理策略保持一致。3.2 ArchLinux 安装支持#259v3.7.1 为 ArchLinux 用户提供了AUR 安装方式paru -S cc-switch-bin即通过 paru/yay 等 AUR 助手安装cc-switch-bin包。此前 ArchLinux 用户只能手动下载 AppImage/debAUR 渠道使其获得了与其他发行版一致的一键安装与升级体验。4. 改进4.1 Skills 错误信息 i18n 增强新增28 条详细错误消息英文与中文每条都带有针对性的解决建议resolution suggestion并配合错误分类码与操作提示如“检查网络”“检查仓库地址”“检查压缩包内容”。从源码结构看skill.rs 引入统一的format_skill_error错误格式化函数安装/卸载流程中的各类失败DOWNLOAD_TIMEOUT、SKILL_DIR_NOT_FOUND、INVALID_SKILL_DIRECTORY、SKILL_DIRECTORY_CONFLICT等都通过它生成带错误码、上下文变量和建议动作的结构化消息再交由 i18n 层渲染成用户语言——这正是 v3.7.1 中“带具体解决建议”错误体验的代码来源。4.2 下载超时从 15s 延长到 60s仓库归档下载的网络超时由 15 秒延长至 60 秒用于降低弱网环境下误报DOWNLOAD_TIMEOUT的概率。源码中的证据是 install 流程中的 60 秒超时包裹let (temp_guard, used_branch) timeout( std::time::Duration::from_secs(60), self.download_repo(repo), ) .await .map_err(|_| { anyhow!(format_skill_error( DOWNLOAD_TIMEOUT, [(owner, repo.owner), (name, repo.name), (timeout, 60)], Some(checkNetwork), )) })??;超时触发后会生成带timeout: 60与checkNetwork建议的 i18n 错误与 4.1 节的错误体系闭环。4.3 代码格式化对 Rustcargo fmt与 TypeScriptprettier应用了统一的格式化标准属于纯代码卫生改动不改变运行行为。5. v3.7.0 完整能力回顾v3.7.1 的能力基线v3.7.1 的修复全部落在 v3.7.0 建立的能力面上因此有必要完整梳理 v3.7.0 的发布内容85 个 commit152 个文件18,104 / -3,732 行。5.1 Gemini CLI 集成v3.7.0 使 CC Switch 支持的第三个应用从 Claude Code、Codex 扩展到Google Gemini CLI核心能力包括双文件配置同时支持.env与settings.json两种格式自动检测自动识别GOOGLE_GEMINI_BASE_URL、GEMINI_MODEL等环境变量完整 MCP 支持为 Gemini 提供完整的 MCP server 管理深链集成通过ccswitch://协议一键导入配置系统托盘从托盘菜单快速切换供应商。内置供应商预设包括Google 官方支持 OAuth 认证、PackyCode合作伙伴集成与Custom完全自定义。技术实现上v3.7.0 新增了后端模块 gemini_config.rs当时约 20KB与 gemini_mcp.rs当前仓库中 MCP 侧已演进为 mcp/gemini.rs并实现了表单与环境编辑器之间的同步、双文件原子写入。.env解析本身也有宽松/严格两档parse_env_file宽松解析并跳过无效行parse_env_file_strict则返回带行号的详细错误gemini_config.rs。5.2 MCP v3.7.0 统一架构MCP 管理系统被完整重构以实现跨应用统一统一面板Claude/Codex/Gemini 的 MCP server 在单一界面管理前端为 UnifiedMcpPanel.tsxSSE 传输新增 Server-Sent Events 支持智能解析器容错 JSON 解析格式纠正自动修复 Codex[mcp_servers]表格式扩展字段保留自定义 TOML 字段不被丢弃导入/导出三个应用的统一导入、双向同步、状态保留。后端实现按应用拆分为 mcp/claude.rs、mcp/codex.rs、mcp/gemini.rs并配有 mcp/validation.rs 做统一校验与文档中“统一初始化结构、保持向后兼容”的描述相符。5.3 Claude Skills 管理系统约 2,000 行的完整技能生态平台v3.7.1 所修复的正是这一系统GitHub 集成自动扫描仓库中的技能预置仓库包括anthropics/skills官方、ComposioHQ/awesome-claude-skills精选集、cexll/myclaude社区也支持添加自定义仓库与skillsPath子目录扫描——源码中 SkillStore 的默认仓库列表 与文档一致当前版本还新增了JimLiu/baoyu-skills生命周期管理发现自动检测SKILL.md→ 安装一键落到应用 skills 目录→ 卸载带跟踪的安全删除→ 更新检测当时基础设施就绪技术架构后端SkillService当时 526 行负责 GitHub API 集成前端为 SkillsPage、SkillCard、RepoManager对应 SkillsPage.tsx、SkillCard.tsx、RepoManagerPanel.tsx状态持久化于config.jsoni18n 提供 47 翻译键。5.4 Prompts 管理系统约 1,300 行的系统提示词管理多预设管理可创建无限量预设、快速切换、同一时刻仅一个激活、激活预设受删除保护跨应用文件映射Claude 写~/.claude/CLAUDE.md、Codex 写~/.codex/AGENTS.md、Gemini 写~/.gemini/GEMINI.mdMarkdown 编辑器CodeMirror 6 完整集成、语法高亮、One Dark 暗色主题、实时预览对应 MarkdownEditor.tsx智能同步自动写入生效文件、切换前回填保护、首次启动从生效文件自动导入、手动修改保护。后端为 services/prompt.rs。5.5 深链协议与环境变量冲突检测ccswitch://协议全平台注册协议、从分享链接导入、生命周期集成与安全校验前端入口见 DeepLinkImportDialog.tsx环境变量冲突检测覆盖 Claude/Codex 跨应用冲突、Gemini 自动发现、MCP server 配置冲突三类检测范围提供可视化冲突指示、解决建议、覆盖警告与变更前备份。5.6 v3.7.0 其他改进与修复供应商管理新增 DouBaoSeed字节跳动、Kimi For Coding月之暗面、BaiLing 预设移除易混淆的 AnyRouterCodex 与 Gemini 支持模型名配置新增供应商备注字段配置管理通用配置从 localStorage 迁移到config.json、跨应用统一持久化、首次启动自动导入UI/UXmacOS 原生风格配色、窗口默认居中、密码输入回显按钮修复、URL 溢出修复、托盘拖拽实时同步关键 Bug 修复用量脚本边界检查、Gemini 校验放宽、TOML 中日韩引号处理、MCP 自定义字段保留、FormLabel 白屏崩溃修复、托盘安全模式匹配去除unwrap()等依赖Tauri 2.8.x、Rust 侧anyhow/zip/serde_yaml/tempfile、前端 CodeMirror 6、winreg 0.52Windows。5.7 战略定位从工具到平台维度v3.6v3.7.0定位供应商切换器AI CLI 管理平台范围配置管理生态管理应用Claude CodexClaude Codex Gemini能力切换配置扩展能力Skills定制手动编辑可视化管理Prompts集成应用相互隔离统一管理MCP官方将其概括为 AI CLI 管理六大支柱配置管理、能力扩展Skills、行为定制Prompts、生态集成深链、多 AI 支持Claude/Codex/Gemini、智能检测冲突预防。6. 下载与安装系统要求WindowsWindows 10macOSmacOS 10.15 (Catalina)LinuxUbuntu 22.04 / Debian 11 / Fedora 34 / ArchLinux各平台安装包从项目 Releases 页下载WindowsCC-Switch-Windows.msi或-Portable.zipmacOSCC-Switch-macOS.tar.gz或.zipLinuxCC-Switch-Linux.AppImage或.debArchLinuxparu -S cc-switch-binv3.7.1 新增HomebrewmacOSbrew tap farion1231/ccswitch brew install --cask cc-switch更新brew upgrade --cask cc-switch7. 迁移说明从 v3.6.x 升级自动迁移无需任何操作配置完全兼容从 v3.1.x 或更早版本升级需要两步——先升级到 v3.2.x 完成一次性迁移再升级到 v3.7.x新功能Skills 无需迁移、直接开始Prompts 首次启动自动从生效文件导入Gemini 需要自行安装 Gemini CLIMCP v3.7.0 向后兼容旧配置。8. 小结与延伸阅读v3.7.1 是一个典型的“护航补丁”以 17 个文件的改动精准修补了 v3.7.0 大版本暴露的三类问题——多子目录 Skills 仓库的安装健壮性resolve_skill_source_dir三级回退 单元测试、Gemini 双文件配置的持久化正确性覆盖目录机制 ~/.gemini默认回退以及表单误触丢失基础对话框组件单点拦截onInteractOutside。同时新增的 Gemini 自定义配置目录与 AUR 安装渠道进一步补齐了多环境与多发行版下的可用性。若需继续深入建议按以下路径阅读当前仓库版本记录CHANGELOG.md[3.7.1]条目、docs/release-notes/v3.7.1-zh.mdSkills 安装与子目录解析src-tauri/src/services/skill.rsGemini 目录覆盖与双文件配置src-tauri/src/settings.rs、src-tauri/src/gemini_config.rs对话框遮罩层保护src/components/ui/dialog.tsxMCP 统一架构src-tauri/src/mcp/、src/components/mcp/UnifiedMcpPanel.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.7.1 版本深度解析：Gemini 配置目录、Skills 子目录安装修复与对话框误触防护
CC Switch v3.7.1 版本深度解析Gemini 配置目录、Skills 子目录安装修复与对话框误触防护【免费下载链接】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.7.1 英文更新说明发布于 2025-11-22涉及 17 个文件、524 / -81 行改动展开逐项解析该版本的 Bug 修复、新特性与改进点并结合仓库源码验证每项改动的实际实现位置同时完整梳理其承载的 v3.7.0 大版本Gemini CLI 集成、MCP 统一架构、Skills/Prompts 管理系统的能力全貌。读完后你将了解本次稳定版具体解决了哪些配置持久化与交互问题以及这些能力在代码层是如何落地的。1. 版本概览v3.7.1 是一个以稳定性增强与用户体验改进为主题的补丁版本官方定位即“Stability Enhancements and User Experience Improvements”。其规模不大17 个文件524 / -81 行但每一项改动都针对真实用户反馈类别内容关联 IssueBug 修复第三方 Skills 仓库安装失败自定义子目录#268Bug 修复Gemini 配置切换供应商后丢失-Bug 修复点击遮罩层导致对话框意外关闭11 个对话框组件-新特性设置中支持自定义 Gemini 配置目录#255新特性ArchLinux 通过 AUR 安装#259改进Skills 错误信息 i18n28 条中英双语-改进下载超时从 15s 延长到 60s-改进统一的 Rust / TypeScript 代码格式化标准-该版本紧随 v3.7.02025-11-19 发布85 个 commit、152 个文件、18,104 / -3,732 行之后可以视为对 v3.7.0 大版本Gemini 集成、MCP 重构、Skills 与 Prompts 系统的快速护航。对应的 CHANGELOG.md 中[3.7.1] - 2025-11-22条目与本文描述一致可作为交叉验证依据。中文版更新说明见 v3.7.1-zh.md。2. Bug 修复2.1 修复第三方 Skills 仓库安装失败#268v3.7.1 修复了带有自定义子目录的 Skills 仓库例如ComposioHQ/awesome-claude-skills安装失败的问题。这类仓库的特点是不把SKILL.md放在仓库根目录而是分散在若干子目录中。从源码结构看该修复对应的核心逻辑位于 SkillService 的 install 流程。安装时服务会把整个仓库归档下载到临时目录随后调用resolve_skill_source_dir解析真实源目录。当前仓库中该函数采用三级回退策略skill.rs直接相对路径命中root/directory存在且包含SKILL.md时直接采用且必须校验SKILL.md避免把同名空壳目录误判为源目录按名字递归查找在仓库内递归搜索同名的、含SKILL.md的目录兜底仓库根仓库根本身存在SKILL.md时视为单技能仓库。这一解析逻辑有完整的单元测试覆盖包括根级技能、嵌套目录、按安装名回退、拒绝同名包装目录、两级目录目录型技能、无SKILL.md时返回 None 等场景测试代码印证了 v3.7.1 对子目录场景的系统性修复。2.2 修复 Gemini 配置持久化问题v3.7.1 解决了在 Gemini 表单中编辑settings.json后切换供应商时编辑内容丢失的问题。结合 v3.7.0 的 Gemini 双文件.envsettings.json架构该修复保证了表单中两个文件的编辑结果在切换供应商时被完整回写而不是只写入当前激活的那一份配置。Gemini 配置读取路径的入口在 gemini_config.rsget_gemini_dir()返回配置目录get_gemini_env_path()在其下定位.env文件settings.json则在同目录下读写二者共同构成 Gemini 的双文件配置面。2.3 防止点击遮罩层关闭对话框v3.7.1 为全部11 个对话框组件增加了遮罩层overlay/backdrop点击保护避免用户误点背景区域导致表单数据丢失。从源码结构看该保护统一落在基础对话框组件 dialog.tsx 的DialogContent上——通过onInteractOutside回调调用e.preventDefault()直接阻止“点击外部关闭”行为。由于各业务对话框Provider 编辑、MCP 表单、导入导出等都复用这一基础组件单点修改即可覆盖全部 11 个对话框这也是该版本改动行数控制得较紧凑的原因。3. 新特性3.1 Gemini 配置目录支持#255v3.7.1 在设置中新增Gemini 配置目录选项允许用户自定义~/.gemini/的位置。这在多账号、容器化环境或将 CLI 配置目录迁移到非默认路径例如~/.config/gemini类 XDG 布局的场景下非常实用。实现链路可以在源码中完整追踪持久化字段设备级设置结构体中新增了gemini_config_dir字段settings.rs与claude_config_dir、codex_config_dir等并列属于“设备级目录覆盖”一族未设置时为None序列化时自动跳过覆盖目录解析get_gemini_override_dir() 读取该字段并经resolve_override_path归一化为绝对路径全局生效get_gemini_dir() 优先返回覆盖目录否则回退到~/.gemini后续所有.env、settings.json、GEMINI.md、MCP 配置的读写均基于该目录派生。可以推断由于该覆盖属于设备级存于本机settings.json而非云端共享的供应商数据同一账号在不同机器上可以指向各自的 Gemini 目录不会互相污染——这与 CC Switch 对 Claude/Codex 目录覆盖的处理策略保持一致。3.2 ArchLinux 安装支持#259v3.7.1 为 ArchLinux 用户提供了AUR 安装方式paru -S cc-switch-bin即通过 paru/yay 等 AUR 助手安装cc-switch-bin包。此前 ArchLinux 用户只能手动下载 AppImage/debAUR 渠道使其获得了与其他发行版一致的一键安装与升级体验。4. 改进4.1 Skills 错误信息 i18n 增强新增28 条详细错误消息英文与中文每条都带有针对性的解决建议resolution suggestion并配合错误分类码与操作提示如“检查网络”“检查仓库地址”“检查压缩包内容”。从源码结构看skill.rs 引入统一的format_skill_error错误格式化函数安装/卸载流程中的各类失败DOWNLOAD_TIMEOUT、SKILL_DIR_NOT_FOUND、INVALID_SKILL_DIRECTORY、SKILL_DIRECTORY_CONFLICT等都通过它生成带错误码、上下文变量和建议动作的结构化消息再交由 i18n 层渲染成用户语言——这正是 v3.7.1 中“带具体解决建议”错误体验的代码来源。4.2 下载超时从 15s 延长到 60s仓库归档下载的网络超时由 15 秒延长至 60 秒用于降低弱网环境下误报DOWNLOAD_TIMEOUT的概率。源码中的证据是 install 流程中的 60 秒超时包裹let (temp_guard, used_branch) timeout( std::time::Duration::from_secs(60), self.download_repo(repo), ) .await .map_err(|_| { anyhow!(format_skill_error( DOWNLOAD_TIMEOUT, [(owner, repo.owner), (name, repo.name), (timeout, 60)], Some(checkNetwork), )) })??;超时触发后会生成带timeout: 60与checkNetwork建议的 i18n 错误与 4.1 节的错误体系闭环。4.3 代码格式化对 Rustcargo fmt与 TypeScriptprettier应用了统一的格式化标准属于纯代码卫生改动不改变运行行为。5. v3.7.0 完整能力回顾v3.7.1 的能力基线v3.7.1 的修复全部落在 v3.7.0 建立的能力面上因此有必要完整梳理 v3.7.0 的发布内容85 个 commit152 个文件18,104 / -3,732 行。5.1 Gemini CLI 集成v3.7.0 使 CC Switch 支持的第三个应用从 Claude Code、Codex 扩展到Google Gemini CLI核心能力包括双文件配置同时支持.env与settings.json两种格式自动检测自动识别GOOGLE_GEMINI_BASE_URL、GEMINI_MODEL等环境变量完整 MCP 支持为 Gemini 提供完整的 MCP server 管理深链集成通过ccswitch://协议一键导入配置系统托盘从托盘菜单快速切换供应商。内置供应商预设包括Google 官方支持 OAuth 认证、PackyCode合作伙伴集成与Custom完全自定义。技术实现上v3.7.0 新增了后端模块 gemini_config.rs当时约 20KB与 gemini_mcp.rs当前仓库中 MCP 侧已演进为 mcp/gemini.rs并实现了表单与环境编辑器之间的同步、双文件原子写入。.env解析本身也有宽松/严格两档parse_env_file宽松解析并跳过无效行parse_env_file_strict则返回带行号的详细错误gemini_config.rs。5.2 MCP v3.7.0 统一架构MCP 管理系统被完整重构以实现跨应用统一统一面板Claude/Codex/Gemini 的 MCP server 在单一界面管理前端为 UnifiedMcpPanel.tsxSSE 传输新增 Server-Sent Events 支持智能解析器容错 JSON 解析格式纠正自动修复 Codex[mcp_servers]表格式扩展字段保留自定义 TOML 字段不被丢弃导入/导出三个应用的统一导入、双向同步、状态保留。后端实现按应用拆分为 mcp/claude.rs、mcp/codex.rs、mcp/gemini.rs并配有 mcp/validation.rs 做统一校验与文档中“统一初始化结构、保持向后兼容”的描述相符。5.3 Claude Skills 管理系统约 2,000 行的完整技能生态平台v3.7.1 所修复的正是这一系统GitHub 集成自动扫描仓库中的技能预置仓库包括anthropics/skills官方、ComposioHQ/awesome-claude-skills精选集、cexll/myclaude社区也支持添加自定义仓库与skillsPath子目录扫描——源码中 SkillStore 的默认仓库列表 与文档一致当前版本还新增了JimLiu/baoyu-skills生命周期管理发现自动检测SKILL.md→ 安装一键落到应用 skills 目录→ 卸载带跟踪的安全删除→ 更新检测当时基础设施就绪技术架构后端SkillService当时 526 行负责 GitHub API 集成前端为 SkillsPage、SkillCard、RepoManager对应 SkillsPage.tsx、SkillCard.tsx、RepoManagerPanel.tsx状态持久化于config.jsoni18n 提供 47 翻译键。5.4 Prompts 管理系统约 1,300 行的系统提示词管理多预设管理可创建无限量预设、快速切换、同一时刻仅一个激活、激活预设受删除保护跨应用文件映射Claude 写~/.claude/CLAUDE.md、Codex 写~/.codex/AGENTS.md、Gemini 写~/.gemini/GEMINI.mdMarkdown 编辑器CodeMirror 6 完整集成、语法高亮、One Dark 暗色主题、实时预览对应 MarkdownEditor.tsx智能同步自动写入生效文件、切换前回填保护、首次启动从生效文件自动导入、手动修改保护。后端为 services/prompt.rs。5.5 深链协议与环境变量冲突检测ccswitch://协议全平台注册协议、从分享链接导入、生命周期集成与安全校验前端入口见 DeepLinkImportDialog.tsx环境变量冲突检测覆盖 Claude/Codex 跨应用冲突、Gemini 自动发现、MCP server 配置冲突三类检测范围提供可视化冲突指示、解决建议、覆盖警告与变更前备份。5.6 v3.7.0 其他改进与修复供应商管理新增 DouBaoSeed字节跳动、Kimi For Coding月之暗面、BaiLing 预设移除易混淆的 AnyRouterCodex 与 Gemini 支持模型名配置新增供应商备注字段配置管理通用配置从 localStorage 迁移到config.json、跨应用统一持久化、首次启动自动导入UI/UXmacOS 原生风格配色、窗口默认居中、密码输入回显按钮修复、URL 溢出修复、托盘拖拽实时同步关键 Bug 修复用量脚本边界检查、Gemini 校验放宽、TOML 中日韩引号处理、MCP 自定义字段保留、FormLabel 白屏崩溃修复、托盘安全模式匹配去除unwrap()等依赖Tauri 2.8.x、Rust 侧anyhow/zip/serde_yaml/tempfile、前端 CodeMirror 6、winreg 0.52Windows。5.7 战略定位从工具到平台维度v3.6v3.7.0定位供应商切换器AI CLI 管理平台范围配置管理生态管理应用Claude CodexClaude Codex Gemini能力切换配置扩展能力Skills定制手动编辑可视化管理Prompts集成应用相互隔离统一管理MCP官方将其概括为 AI CLI 管理六大支柱配置管理、能力扩展Skills、行为定制Prompts、生态集成深链、多 AI 支持Claude/Codex/Gemini、智能检测冲突预防。6. 下载与安装系统要求WindowsWindows 10macOSmacOS 10.15 (Catalina)LinuxUbuntu 22.04 / Debian 11 / Fedora 34 / ArchLinux各平台安装包从项目 Releases 页下载WindowsCC-Switch-Windows.msi或-Portable.zipmacOSCC-Switch-macOS.tar.gz或.zipLinuxCC-Switch-Linux.AppImage或.debArchLinuxparu -S cc-switch-binv3.7.1 新增HomebrewmacOSbrew tap farion1231/ccswitch brew install --cask cc-switch更新brew upgrade --cask cc-switch7. 迁移说明从 v3.6.x 升级自动迁移无需任何操作配置完全兼容从 v3.1.x 或更早版本升级需要两步——先升级到 v3.2.x 完成一次性迁移再升级到 v3.7.x新功能Skills 无需迁移、直接开始Prompts 首次启动自动从生效文件导入Gemini 需要自行安装 Gemini CLIMCP v3.7.0 向后兼容旧配置。8. 小结与延伸阅读v3.7.1 是一个典型的“护航补丁”以 17 个文件的改动精准修补了 v3.7.0 大版本暴露的三类问题——多子目录 Skills 仓库的安装健壮性resolve_skill_source_dir三级回退 单元测试、Gemini 双文件配置的持久化正确性覆盖目录机制 ~/.gemini默认回退以及表单误触丢失基础对话框组件单点拦截onInteractOutside。同时新增的 Gemini 自定义配置目录与 AUR 安装渠道进一步补齐了多环境与多发行版下的可用性。若需继续深入建议按以下路径阅读当前仓库版本记录CHANGELOG.md[3.7.1]条目、docs/release-notes/v3.7.1-zh.mdSkills 安装与子目录解析src-tauri/src/services/skill.rsGemini 目录覆盖与双文件配置src-tauri/src/settings.rs、src-tauri/src/gemini_config.rs对话框遮罩层保护src/components/ui/dialog.tsxMCP 统一架构src-tauri/src/mcp/、src/components/mcp/UnifiedMcpPanel.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），仅供参考