CC Switch v3.11.0 深度解析：OpenClaw 支持、会话管理器、备份管理与部分键值合并架构升级

CC Switch v3.11.0 深度解析OpenClaw 支持、会话管理器、备份管理与部分键值合并架构升级【免费下载链接】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-switchCC Switch v3.11.0 是一次跨平台 All-in-One AI CLI 管理工具的大版本更新它把第五个受管应用 OpenClaw 纳入统一管理带来全新的会话管理器与备份管理功能并将供应商切换策略从“全量覆写”升级为“部分键值合并”。读完本文你将掌握 v3.11.0 的全部新增功能、唯一的破坏性变更及其迁移方式并能结合仓库源码理解会话扫描、数据库备份、OMO 变体参数化等关键实现。发布日期2026-02-26更新规模147 commits | 274 files changed | 32,179 / -5,467 lines概览CC Switch v3.11.0 的核心变化可以归纳为一句话从“能切供应商”走向“管好全家桶”。本次更新新增OpenClaw的完整管理支持成为继 Claude Code、Codex、Gemini CLI、OpenCode 之后的第五个应用引入会话管理器Session Manager和备份管理Backup Management同时完成Oh My OpenCodeOMO集成、供应商切换的部分键值合并架构升级和设置页面重构。重点内容一览OpenClaw 支持第五个受管理应用含 13 个供应商预设、Env/Tools/AgentsDefaults 配置编辑器、Workspace 文件管理会话管理器浏览五个应用的历史会话支持目录导航和会话内搜索备份管理独立备份面板可配置策略、定时备份、迁移前自动备份Oh My OpenCode 集成完整 OMO 配置管理支持 OMO Slim 轻量模式部分键值合并破坏性变更供应商切换改为仅替换供应商相关字段保留其余设置“通用配置片段”功能因此移除设置页面重构5 标签页布局代码量减少约 40%6 组新供应商预设AWS Bedrock、SSAI Code、CrazyRouter、AICoding 等Thinking Budget Rectifier更精细的 thinking budget 控制主题切换动画圆形揭示过渡动画WebDAV 自动同步支持自动同步与大文件防护OpenClaw 支持第五个受管应用CC Switch 新增对 OpenClaw 的完整管理支持涵盖供应商管理新增、编辑、切换、删除 OpenClaw 供应商含 13 个内置预设配置编辑器Env环境变量、Tools工具、AgentsDefaults代理默认值三个专属配置面板Workspace 面板支持 HEARTBEAT/BOOTSTRAP/BOOT 文件管理及每日记忆Additive 叠加模式支持配置叠加而非覆盖默认模型按钮一键填充推荐模型添加供应商时自动将建议模型注册到 allowlist品牌与交互专属品牌图标、应用切换淡入淡出过渡动画深链接支持通过 URL 导入 OpenClaw 供应商配置完整国际化中/英/日三语全面支持注意OpenClaw 是本版本新支持的应用需要先安装 OpenClaw CLI 才能使用相关功能。从源码结构看这部分能力落在多个模块中后端有专门的 openclaw_config.rs 负责 OpenClaw 配置目录解析会话扫描在 session_manager/providers/openclaw.rs 中实现会话根目录取自openclaw 配置目录/agents前端则配有 EnvPanel.tsx、ToolsPanel.tsx、AgentsDefaultsPanel.tsx 三个专属面板与 WorkspaceFilesPanel.tsx、DailyMemoryPanel.tsx 等 Workspace 组件。供应商预设定义在 openclawProviderPresets.ts。会话管理器跨应用浏览历史会话全新的会话管理器帮助你浏览和检索历史会话记录支持浏览 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个应用的历史会话#867感谢 TinsFox目录导航TOC和会话内搜索进入会话页面时默认过滤为当前应用快速定位并行目录扫描 头尾 JSONL 读取优化加载性能后端实现位于 session_manager/mod.rs其scan_sessions()使用std::thread::scope同时向各应用codex、claude、opencode、openclaw、gemini 等的扫描函数派发线程合并结果后按last_active_at缺失时回退created_at降序排序。每条会话元数据由统一的SessionMeta结构承载包含provider_id、session_id、title、project_dir、source_path、resume_command等字段前端 SessionManagerPage.tsx 据此渲染列表、目录导航与消息视图。删除会话有严格的路径安全校验delete_session_with_roots()会先对会话源文件与各应用根目录做canonicalize确认源路径位于合法根目录内才执行删除防止误删目录外文件。这一行为有对应的单元测试覆盖如rejects_source_path_outside_provider_root、accepts_source_path_under_any_allowed_provider_root见 session_manager/mod.rs 的tests模块。此外OpenCode 与部分应用的会话存储在 SQLite 中load_messages/delete_session对sqlite:前缀的source_path走专门的数据库读取/删除路径与 JSONL 文件路径解耦。备份管理数据安全独立面板独立的备份管理面板让数据安全更有保障可配置备份策略最大备份数量、自动清理规则运行时每小时定期自动备份数据库迁移前自动备份带回填警告提示支持备份重命名和删除含确认对话框备份文件名使用本地时间更直观备份功能默认开启可在备份面板调整策略。前端面板为 BackupListSection.tsx配合 useBackupManager.ts 管理列表加载与操作。后端实现集中在 database/backup.rs。从源码看其实现有两点值得注意文件操作全局串行化备份目录的所有观察/修改操作由BACKUP_FILE_OPERATION_LOCK互斥锁保护且要求先持锁再访问数据库连接避免快照导出与备份清理之间的竞态。SQL 导入的安全边界import_authorizer在 prepare 阶段按 SQLite 解析结果回调拒绝一切能“离开临时数据库文件”的动作ATTACH/DETACH、vtable 建/删、未知动作码以及白名单之外的PRAGMA。注释中解释了为什么用 authorizer 而非关键字扫描——字符串扫描可被/*x*/ATTACH、大小写、换行绕过。备份/导入路径因此具备纵深防御能力。SQL 导出按批写入INSERT语句受INSERT_BATCH_MAX_ROWS200 行与INSERT_BATCH_MAX_BYTES1 MiB双重约束兼顾解析摊销与超大行的处理。Oh My OpenCodeOMO集成v3.11.0 提供完整的 Oh My OpenCode 配置文件管理Agent 模型选择、Category 配置、推荐模型填充#972感谢 yovinchen改进 Agent 模型选择 UX修复 lowercase key 问题#1004感谢 yovinchenOMO Slim 轻量模式支持OMO 与 OMO Slim 互斥数据库层级强制保证一致性同一时间只能启用其中一个切换时另一个会自动禁用架构上本次通过OmoVariant参数化消除了 OMO 模块约 250 行重复代码。在 services/omo.rs 中OmoVariant结构体以描述符形式定义每个变体的静态属性——首选文件名、候选配置文件列表、分类标识、供应商前缀、插件名与插件前缀、是否支持 categories 等。两个常量实例STANDARD分类omo、前缀omo-、候选文件含oh-my-openagent.jsonc/oh-my-opencode.jsonc等 4 种has_categories: trueSLIM分类omo-slim、前缀omo-slim-、候选文件oh-my-opencode-slim.jsonc/.jsonhas_categories: false前端表单逻辑也随本版拆分ProviderForm 提取出useOmoModelSource、useOmoDraftState等独立模块见下文 ProviderForm 拆分一节。此外本版还删除了 OMO 二层合并Common Config系统减少约 1,733 行代码简化架构。部分键值合并v3.11.0 唯一的破坏性变更这一节是升级前必读的内容。供应商切换从全量配置覆写改为部分键值合并策略#1098。变更前切换供应商时整个settings_config会覆写到 live 配置文件。用户在 live 文件中手动添加的非供应商设置插件配置、MCP 配置、权限设置等会在每次切换时丢失。为此旧版本提供了“通用配置片段”功能让用户定义每次切换时都会合并的公共配置。变更后切换供应商时仅替换供应商相关的键值API Key、端点、模型等用户的其余设置完整保留。因此“通用配置片段”功能不再需要已被移除。影响与迁移如果你之前没有使用通用配置片段此变更对你完全透明——切换体验只会更好如果你之前使用了通用配置片段来保留自定义设置MCP 配置、权限等升级后这些设置会在切换时自动保留无需额外操作如果你利用通用配置片段做其他用途如在切换时注入额外配置请在升级后手动将这些配置写入 live 配置文件。此次重构删除了 6 个前端文件3 个组件 3 个 hooks、约 150 行后端死代码。从 provider/live.rs 的现有实现看live 配置写入路径只针对 provider 自身字段做规范化与环境变量注入与“只动供应商字段”的策略一致。另一项相关行为变更手动导入替代自动导入——启动时不再自动导入外部配置需手动点击“导入当前配置”避免意外覆盖用户数据同时移除了useProvidersQuery中自动导入的副作用。其他主要功能工作空间 Workspace每日记忆文件全文搜索按日期排序目录路径可点击跳转快速打开文件位置对应组件见 DailyMemoryPanel.tsx 与 WorkspaceFilesPanel.tsx。工具栏 ToolbarAppSwitcher 根据窗口宽度自动折叠为紧凑模式紧凑模式切换平滑过渡动画设置 Settings代理和用量功能新增首次使用确认对话框避免误操作新增enableLocalProxy开关控制主页代理 UI 显示更精细的本地环境检查CLI 工具版本检测#870感谢 kv-chiu、Volta 路径检测#969感谢 myjustify供应商预设 PresetAWS Bedrock支持 AKSK 和 API Key 两种认证方式#1047感谢 keithyt06SSAI Code合作伙伴预设覆盖五端CrazyRouter合作伙伴预设及专属图标AICoding合作伙伴预设及推广文案更新国内模型供应商预设至最新版本Qwen Coder 重命名为百炼Bailian#965感谢 zhu-jl18其他新功能Thinking Budget Rectifier更精细地控制 thinking budget 分配#1005感谢 yovinchenWebDAV 自动同步支持自动同步配置并增加大文件防护#923感谢 clx20000410#1043感谢 SaladDay实现见 webdav_auto_sync.rs主题切换动画圆形揭示过渡动画视觉体验更流畅#905感谢 funnytime75Claude 配置编辑器快速开关快速切换常用配置项#1012感谢 JIA-ss动态端点提示根据 API 格式选择动态显示端点提示文本#860感谢 zhu-jl18用量仪表盘增强自动刷新、更强健的数据格式化#942感谢 yovinchen新增定价数据claude-opus-4-6 和 gpt-5.3-codex#943感谢 yovinchen静默启动优化静默启动选项仅在开机启动开启时显示架构改进除部分键值合并外本版还有一批提升可维护性的内部重构重构项效果OmoVariant 参数化消除 OMO 模块约 250 行重复代码OMO 公共配置移除删除二层合并系统减少约 1,733 行ProviderForm 拆分从 2,227 行减至 1,526 行提取 opencodeFormUtils、useOmoModelSource、useOpencodeFormState、useOmoDraftState、useOpenclawFormState 共 5 个模块MCP/Skills 共享组件提取 AppCountBar.tsx、AppToggleGroup.tsx、ListItemRow.tsx减少 MCP 和 Skills 面板重复代码#897感谢 PeanutSplash设置页面重构5 标签页布局通用 | 代理 | 高级 | 用量 | 关于SettingsPage 从约 716 行减至约 426 行约 40%见 SettingsPage.tsx其他改进终端选择统一到全局设置并新增 WezTerm 支持Claude 模型引用从 4.5 更新到 4.6。Bug 修复严重修复Windows 主目录回归恢复默认主目录解析防止 Git/MSYS 环境下HOME环境变量与真实用户配置目录不一致导致数据库路径变更、供应商/设置“消失”Linux 白屏禁用 AMD GPUCezanne/Radeon Vega的 WebKitGTK 硬件加速解决部分 Linux 系统启动白屏#986感谢 ThendCNOpenAI Beta 参数不再为/v1/chat/completions端点追加?betatrue修复 Nvidia 等apiFormatopenai_chat供应商的请求失败#1052感谢 jnorthrup健康检查认证健康检查尊重供应商auth_mode设置避免仅支持 Bearer 认证的代理服务健康检查失败#824感谢 Jassy930供应商预设修复修复 OpenClaw/v1前缀导致的双重路径问题/v1/v1/messagesOpus 定价修正$15/$75 → $5/$25并升级到 4.6AIGoCode URL 统一为https://api.aigocode.comZhipu GLM 移除过时合作伙伴状态新建 Claude 供应商时恢复 API Key 输入框可见性非活跃供应商隐藏快速开关显示上下文感知的 JSON 编辑器提示OMO 修复omo-slim 分类检查在 add/form/mutation 路径上补齐OMO Slim 供应商变更后正确失效查询缓存OMO agent/category 推荐模型与上游源同步“填充推荐”按钮失败时增加 toast 反馈移除 OMO/OMO Slim 最后一个供应商的删除限制OpenCode 未配置模型时拒绝保存#932感谢 yovinchenOpenClaw 修复修复 25 个缺失 i18n key、替换key{index}为稳定 ID、深链接 additive 合并等代码审查问题EnvPanel 健壮性增强NaN 守卫、使用条目键名而非数组索引i18n 重复键合并恢复供应商表单翻译平台与 UI 修复Windows 静默启动时窗口闪烁#901感谢 funnytime75标题栏暗黑模式跟随主题#903感谢 funnytime75Windows Skills 路径分隔符匹配#868感谢 stmoonarWSL 辅助函数条件编译工具栏高度裁切导致 AppSwitcher 被遮挡有新版本时显示更新徽章而非绿色对勾仅 Claude/Codex 应用显示会话管理器按钮SQL 导入/导出卡片暗黑模式样式统一#1067感谢 SaladDay其他修复会话管理器硬编码中文字符串替换为 i18n keySkill 文档 URL 分支和路径修正#977感谢 yovinchenOpenCode install.sh 安装路径检测补齐#988感谢 zhu-jl18Skill ZIP 符号链接解析修复#1040感谢 yovinchenMCP 表单补齐 OpenCode 复选框#1026感谢 yovinchenuseProvidersQuery中自动导入副作用移除性能优化会话面板并行目录扫描 头尾 JSONL 读取大幅提升会话列表加载速度对应 session_manager/mod.rs 中的多线程扫描实现移除 Tauri 本地 IPC 调用不必要的 TanStack Query 缓存开销减少内存占用升级注意事项OpenClaw 是新应用需先安装 OpenClaw CLI 才能使用相关功能。⚠️ 通用配置片段功能已移除供应商切换改为部分键值合并后其余设置自动保留该功能不再需要。若曾用它注入额外配置请升级后手动写入 live 配置文件详见上文迁移说明。自动导入已改为手动启动时不再自动导入外部配置请在需要时手动点击“导入当前配置”。OMO 与 OMO Slim 互斥同一时间只能启用其中一个切换时另一个自动禁用。备份默认开启运行时每小时自动备份可在备份面板调整策略。下载与安装到 CC Switch 官方 Releases 页面下载对应平台版本。系统要求如下系统最低版本架构WindowsWindows 10 及以上x64macOSmacOS 10.15 (Catalina) 及以上Intel (x64) / Apple Silicon (arm64)Linux见下表x64Windows文件说明CC-Switch-v3.11.0-Windows.msi推荐- MSI 安装包支持自动更新CC-Switch-v3.11.0-Windows-Portable.zip便携版解压即用不写入注册表macOS文件说明CC-Switch-v3.11.0-macOS.zip推荐- 解压后拖入 Applications 即可Universal BinaryCC-Switch-v3.11.0-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仓库内还附带 flatpak 打包定义供 Flatpak 用户参考。相关文档用户手册docs/user-manual/README.md#979感谢 yovinchen本版新增中文/日文版本说明v3.11.0-zh.md、v3.11.0-ja.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），仅供参考