cc-switch v3.7.0 技术解析Gemini CLI 集成、MCP 统一管理与 Skills/Prompts 管理体系的完整落地【免费下载链接】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.0 中文发布说明docs/release-notes/v3.7.0-zh.md完整还原该版本的六大核心功能Gemini CLI 集成、MCP 统一架构、Claude Skills 管理、Prompts 管理、ccswitch://深度链接协议与环境变量冲突检测并结合当前仓库中的 Rust 后端源码与 React 前端组件说明每项功能背后的实现机制、关键文件路径与数据格式帮助读者理解 cc-switch 如何从一个供应商切换器演进为覆盖 Claude Code、Codex、Gemini 三个 AI CLI 的一体化管理平台。版本概览与战略定位发布日期2025-11-19提交数量从 v3.6.0 开始 85 个提交代码变更152 个文件18,104 / -3,732 行v3.7.0 代表了一个定位上的转变——从供应商切换器到AI CLI 管理平台方面v3.6v3.7.0身份供应商切换器AI CLI 管理平台范围配置管理生态系统管理应用Claude CodexClaude Codex Gemini能力切换配置扩展能力Skills定制手动编辑可视化管理Prompts集成孤立应用统一管理MCP围绕这一定位v3.7.0 确立了 AI CLI 管理的六大支柱配置管理—— 供应商切换和管理能力扩展—— Skills 安装和生命周期行为定制—— 系统提示词预设生态集成—— 深度链接和共享多 AI 支持—— Claude/Codex/Gemini智能检测—— 冲突预防以下章节逐一拆解这六大支柱的技术实现。Gemini CLI 集成第三个受支持应用的接入v3.7.0 新增了对 Google Gemini CLI 的完整支持使 cc-switch 成为同时管理三个 CLI 应用Claude Code、Codex、Gemini的工具。核心能力包括双文件配置同时支持~/.gemini/目录下的.env和settings.json两种格式自动检测自动检测GOOGLE_GEMINI_BASE_URL、GEMINI_MODEL等环境变量完整 MCP 支持为 Gemini 提供完整的 MCP 服务器管理深度链接集成通过ccswitch://协议导入配置系统托盘从托盘菜单快速切换供应商预设方面提供三类选项Google Official支持 OAuth 认证、PackyCode合作伙伴集成、自定义完全自定义。前端预设定义见 src/config/geminiProviderPresets.ts。双文件配置的实现.env解析Gemini CLI 使用双配置文件.env存放环境变量如GOOGLE_GEMINI_BASE_URL、GEMINI_MODELsettings.json存放结构化设置。后端模块 src-tauri/src/gemini_config.rs 负责这两个文件的读写。其中.env解析采用宽松模式跳过空行与注释、对非法行静默容错保证用户手工修改过的配置不会因为个别格式问题而整体不可读// src-tauri/src/gemini_config.rs pub fn parse_env_file(content: str) - HashMapString, String { let mut map HashMap::new(); for line in content.lines() { let line line.trim(); // 跳过空行和注释 if line.is_empty() || line.starts_with(#) { continue; } // 解析 KEYVALUE if let Some((key, value)) line.split_once() { // 验证 key 是否有效不为空只包含字母、数字和下划线 if !key.is_empty() key.chars().all(|c| c.is_alphanumeric() || c _) { map.insert(key, value); } } } map }该文件还提供了一个带行号错误信息的严格解析函数parse_env_file_strict参见 src-tauri/src/gemini_config.rs#L74-L120用于配置导入验证等场景为诊断.env格式错误提供了具体到行号的报错能力。同时配置目录支持用户自定义覆盖get_gemini_dir()优先读取 settings 中的覆盖目录否则回退到~/.gemini。Gemini 的 MCP 配置与传输类型推断Gemini CLI 的 MCP 服务器配置在~/.gemini/settings.json的mcpServers字段中。由于 Gemini 不显式声明传输类型cc-switch 在读写时做了双向格式转换将 Gemini 特有格式归一化为统一的 MCP 结构参见 src-tauri/src/gemini_mcp.rs#L32-L72httpUrl字段 → 转换为urltype: http仅有command字段 → 推断为type: stdio仅有url字段 → 推断为type: sse即本次新增的 SSE 传输类型支持写入时使用atomic_write先写临时文件再原子替换避免中途崩溃产生半写入的 JSON 文件且只覆盖mcpServers字段settings.json中的其他字段保持不变。这套机制正是双文件原子写入与表单-编辑器同步在 Gemini 场景下的落地。MCP v3.7.0 统一架构跨应用统一管理 MCP 服务器MCP 管理系统在 v3.7.0 中完成了整体重构从各应用独立维护升级为跨应用统一管理。架构改进统一管理面板单一界面管理 Claude/Codex/Gemini 的 MCP 服务器对应前端组件 src/components/mcp/UnifiedMcpPanel.tsx表单弹窗见 src/components/mcp/McpFormModal.tsxSSE 传输类型新增 Server-Sent Events 支持除 stdio、http 之外智能解析器容错性 JSON 解析对格式不完美的配置也能尽量恢复格式修正自动修复 Codex[mcp_servers]段落格式扩展字段保留自定义 TOML 字段不被归一化过程丢弃后端模块划分当前仓库中 MCP 逻辑按应用拆分为独立模块统一挂载在 src-tauri/src/mcp/ 目录下src-tauri/src/mcp/claude.rs —— Claude Code 的 MCP 读写src-tauri/src/mcp/codex.rs —— Codex 的 TOML[mcp_servers]格式处理src-tauri/src/mcp/gemini.rs —— Gemini 的settings.json处理src-tauri/src/mcp/validation.rs —— 统一校验逻辑各应用适配器共享同一套 MCP 服务器数据结构这使从三个应用统一导入、双向同步、状态保持成为可能导入时保留各应用的启用/禁用状态同步时逐应用写入各自的配置格式。用户体验改进表单中的默认应用选择JSON 格式化器用于内容验证改进的视觉层次与更好的错误消息技术架构要点按发布说明的统计MCP 重构约 3,000 行其中移除了约 1,000 行遗留代码统一了初始化结构并保持与之前版本的配置向后兼容。Claude Skills 管理系统技能生态的发现、安装与生命周期Skills 管理是 v3.7.0 中体量最大的新功能约 2,000 行代码21 个文件为 Claude Code 提供了完整的技能生态平台。GitHub 仓库集成系统从 GitHub 仓库自动扫描技能以SKILL.md文件作为技能的发现标识。按发布说明v3.7.0 预配置了三个仓库ComposioHQ/awesome-claude-skills—— 精选集合anthropics/skills—— Anthropic 官方技能cexll/myclaude—— 社区贡献从当前源码看默认仓库列表定义在 src-tauri/src/services/skill.rs#L159-L191 的SkillStore::default()中此后又扩展了JimLiu/baoyu-skills每个仓库条目包含owner、name、branch、enabled四个字段用户也可以添加自定义仓库并支持skillsPath子目录扫描。技能生命周期发现自动检测仓库中的SKILL.md文件并解析名称与描述DiscoverableSkill结构唯一标识格式为owner/name:directory安装一键安装到技能目录v3.7.0 阶段为~/.claude/skills/卸载安全移除并跟踪状态更新更新检查基础设施已就绪当前版本与远程哈希对比参见SkillUpdateInfo结构src-tauri/src/services/skill.rs#L210-L221从当前源码结构看技能存储位置后续演进为可选 SSOT 目录SkillStorageLocation枚举默认~/.cc-switch/skills/可选统一的~/.agents/skills/说明 v3.7.0 建立的发现—安装—状态跟踪框架为后续跨 Agent 的技能部署留下了扩展点。技术架构后端SkillService集成 GitHub API发布说明标注约 526 行当前 src-tauri/src/services/skill.rs 已扩展至近 6,000 行反映了后续功能叠加前端src/components/skills/SkillsPage.tsx页面容器、src/components/skills/SkillCard.tsx技能卡片、src/components/skills/RepoManagerPanel.tsx仓库管理面板UI 组件基于 shadcn/ui 的 Badge、Card、Table状态持久化存储在skills.json仓库配置 安装状态国际化47 个翻译键Prompts 管理系统系统提示词的多预设与跨应用同步Prompts 管理约 1,300 行代码20 个文件提供了完整的系统提示词管理能力。多预设管理规则可创建无限数量的提示词预设快速在预设间切换同一时间只能激活一个提示词活动提示词删除保护——防止误删正在生效的预设跨应用的文件映射每个应用使用不同的提示词文件约定映射关系由 src-tauri/src/prompt_files.rs#L12-L44 统一维护应用提示词文件Claude~/.claude/CLAUDE.mdCodex~/.codex/AGENTS.mdGemini~/.gemini/GEMINI.md该函数在 v3.7.0 阶段覆盖上述三个应用从当前源码结构看映射表已扩展到 Grok Build、OpenCode、OpenClawAGENTS.md、HermesSOUL.md等更多应用体现了同一套提示词框架的横向复用。数据模型与智能同步提示词的数据模型定义在 src-tauri/src/prompt.rs#L4-L16id、name、content、可选的description、enabled标志以及创建/更新时间戳。发布说明描述的四项同步机制在实现上对应如下自动写入激活预设时立即写入对应应用的 live 文件回填保护切换预设前先把 live 文件的当前内容回填保存避免用户在 CLI 里手动编辑的内容被覆盖自动导入首次启动时从 live 文件读取并导入为一个预设修改保护整体策略保留用户手动修改Markdown 编辑器与前端结构完整的 CodeMirror 6 集成语法高亮、One Dark 暗色主题、实时预览见 src/components/MarkdownEditor.tsx前端组件src/components/prompts/PromptPanel.tsx主面板、src/components/prompts/PromptFormPanel.tsx表单、src/components/prompts/PromptLibrary.tsx预设库Hookssrc/hooks/usePromptActions.ts 封装预设的增删改与激活动作国际化41 个翻译键深度链接协议ccswitch://一键导入供应商配置v3.7.0 引入了ccswitch://URL 协议实现通过共享链接一键导入配置覆盖所有平台Windows 注册表 / macOS URL Scheme / Linux 桌面条目并集成应用生命周期与安全验证。协议格式与解析协议格式与严格校验逻辑见 src-tauri/src/deeplink/parser.rs#L11-L68。标准结构为ccswitch://v1/import?resource{type}...解析器强制执行三层校验Scheme 校验必须为ccswitch版本校验host 必须是v1当前唯一受支持的协议版本路径校验必须是/import随后按resource参数分发到四类资源解析器provider / prompt / mcp / skill。以供应商导入为例参数包含app目标应用、name供应商名称以及homepage、endpoint、apiKey等字段app取值受白名单约束当前源码中为claude | codex | gemini | grokbuild | opencode | openclaw | hermesv3.7.0 发布时至少覆盖 claude/codex/gemini。协议各资源类型分别由 src-tauri/src/deeplink/provider.rs、src-tauri/src/deeplink/prompt.rs、src-tauri/src/deeplink/mcp.rs、src-tauri/src/deeplink/skill.rs 实现前端弹窗见 src/components/DeepLinkImportDialog.tsx导入前的风险提示逻辑见 src/utils/deeplinkRisk.ts。测试覆盖位于 src-tauri/src/deeplink/tests.rs。环境变量冲突检测智能检测和管理配置冲突由于 cc-switch 同时管理多个 CLI 应用的配置环境变量冲突如不同应用/供应商写入了同名变量是真实风险。v3.7.0 的智能检测覆盖Claude Codex跨应用冲突检测Gemini.env中的环境变量自动发现依赖上文parse_env_file的键值解析MCP服务器配置冲突同名服务器在不同应用中的定义差异配套的管理功能包括可视化冲突指示器、解决建议、覆盖前警告、更改前自动备份。供应商管理与其他改进优化供应商预设变更新增DouBaoSeed字节跳动的豆包、Kimi For Coding月之暗面、BaiLing百灵 AI移除AnyRouter避免误导增强Codex 和 Gemini 的模型名称配置、供应商备注字段用于组织、增强的预设元数据配置管理通用配置迁移从 localStorage 迁移到config.json统一持久化跨所有应用共享自动导入首次启动配置导入回填优先级正确处理 live 文件UI/UX 改进设计系统macOS 原生配色与系统对齐、窗口默认居中、改进的间距和视觉层次。交互优化密码输入框修复 Edge/IE 显示按钮问题、修复卡片中 URL 溢出、错误信息可复制到剪贴板、托盘菜单实时拖放同步。Bug 修复与技术改进关键修复用量脚本验证边界检查Gemini 验证放宽约束TOML 解析CJK 引号处理中文引号曾导致 TOML 解析失败MCP 字段自定义字段保留白屏FormLabel 崩溃修复稳定性托盘安全模式匹配替代unwrap()托盘失败不阻塞主操作错误隔离导入分类正确的类别分配UI 修复移除模型输入框的误导性占位符第三方供应商 Base URL 自动填充托盘菜单拖拽排序同步平台兼容性与依赖Windows winreg API 升级至 0.52 修复安全模式匹配无unwrap()、跨平台托盘处理核心依赖Tauri 2.8.xRust 侧anyhow、zip、serde_yaml、tempfile前端 CodeMirror 6 系列包技术统计总体变更 - 提交数85 - 文件数152 个文件变更 - 新增18,104 行 - 删除-3,732 行 新增模块 - Skills 管理2,034 行21 个文件 - Prompts 管理1,302 行20 个文件 - Gemini 集成约 1,000 行 - MCP 重构约 3,000 行重构 代码分布 - 后端Rust约 4,500 行新增 - 前端React约 3,000 行新增 - 配置约 1,500 行重构 - 测试约 500 行下载与安装系统要求WindowsWindows 10macOSmacOS 10.15CatalinaLinuxUbuntu 22.04 / Debian 11 / Fedora 34安装方式从项目 Releases 页面可下载对应平台的安装包WindowsCC-Switch-v3.7.0-Windows.msi或-Portable.zipmacOSCC-Switch-v3.7.0-macOS.tar.gz或.zipLinuxCC-Switch-v3.7.0-Linux.AppImage或.debmacOS 用户也可以使用 Homebrewbrew tap farion1231/ccswitch brew install --cask cc-switch更新brew upgrade --cask cc-switch迁移说明从 v3.6.x 升级自动迁移——无需任何操作配置完全兼容。从 v3.1.x 或更早版本升级需要两步迁移首先升级到 v3.2.x执行一次性迁移然后升级到 v3.7.0新功能迁移Skills无需迁移全新开始Prompts首次启动时从 live 文件自动导入Gemini需要单独安装 Gemini CLIMCP v3.7.0与之前的配置向后兼容小结v3.7.0 通过 Gemini 集成把管理范围从两个 CLI 扩展到三个通过 MCP 统一架构把配置散落各处收敛为单一管理面板再用 Skills 与 Prompts 两个新模块把管理对象从连接供应商延伸到扩展能力与行为定制最后以ccswitch://协议和冲突检测补全生态协作与安全网。对照仓库源码可以看到这一版本奠定了几条至今仍可追溯的主线按应用拆分的 MCP 适配层src-tauri/src/mcp/、SkillService驱动的技能生命周期src-tauri/src/services/skill.rs、统一的提示词文件映射src-tauri/src/prompt_files.rs以及严格校验的深度链接解析器src-tauri/src/deeplink/parser.rs。中文发布说明的英文版本见 docs/release-notes/v3.7.0-en.md完整历史见 CHANGELOG.md项目总览见 README_ZH.md。【免费下载链接】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），仅供参考