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-switch

CC 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 OpenCode（OMO）集成、供应商切换的部分键值合并架构升级和设置页面重构。

重点内容一览：

• 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。从源码看，其实现有两点值得注意：

1. 文件操作全局串行化：备份目录的所有观察/修改操作由BACKUP_FILE_OPERATION_LOCK互斥锁保护，且要求先持锁再访问数据库连接，避免快照导出与备份清理之间的竞态。
2. SQL 导入的安全边界：import_authorizer在 prepare 阶段按 SQLite 解析结果回调，拒绝一切能“离开临时数据库文件”的动作（ATTACH/DETACH、vtable 建/删、未知动作码，以及白名单之外的PRAGMA）。注释中解释了为什么用 authorizer 而非关键字扫描——字符串扫描可被/*x*/ATTACH、大小写、换行绕过。备份/导入路径因此具备纵深防御能力。

SQL 导出按批写入INSERT语句，受INSERT_BATCH_MAX_ROWS（200 行）与INSERT_BATCH_MAX_BYTES（1 MiB）双重约束，兼顾解析摊销与超大行的处理。

Oh My OpenCode（OMO）集成

v3.11.0 提供完整的 Oh My OpenCode 配置文件管理：

• Agent 模型选择、Category 配置、推荐模型填充（#972，感谢 @yovinchen）
• 改进 Agent 模型选择 UX，修复 lowercase key 问题（#1004，感谢 @yovinchen）
• OMO 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: true
• SLIM：分类omo-slim、前缀omo-slim-、候选文件oh-my-opencode-slim.jsonc/.json，has_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。

工具栏 Toolbar

• AppSwitcher 根据窗口宽度自动折叠为紧凑模式
• 紧凑模式切换平滑过渡动画

设置 Settings

• 代理和用量功能新增首次使用确认对话框，避免误操作
• 新增enableLocalProxy开关，控制主页代理 UI 显示
• 更精细的本地环境检查：CLI 工具版本检测（#870，感谢 @kv-chiu）、Volta 路径检测（#969，感谢 @myjustify）

供应商预设 Preset

• AWS Bedrock：支持 AKSK 和 API Key 两种认证方式（#1047，感谢 @keithyt06）
• SSAI Code：合作伙伴预设，覆盖五端
• CrazyRouter：合作伙伴预设及专属图标
• AICoding：合作伙伴预设及推广文案
• 更新国内模型供应商预设至最新版本
• Qwen Coder 重命名为百炼（Bailian）（#965，感谢 @zhu-jl18）

其他新功能

• Thinking Budget Rectifier：更精细地控制 thinking budget 分配（#1005，感谢 @yovinchen）
• WebDAV 自动同步：支持自动同步配置，并增加大文件防护（#923，感谢 @clx20000410；#1043，感谢 @SaladDay），实现见 webdav_auto_sync.rs
• 主题切换动画：圆形揭示过渡动画，视觉体验更流畅（#905，感谢 @funnytime75）
• Claude 配置编辑器快速开关：快速切换常用配置项（#1012，感谢 @JIA-ss）
• 动态端点提示：根据 API 格式选择动态显示端点提示文本（#860，感谢 @zhu-jl18）
• 用量仪表盘增强：自动刷新、更强健的数据格式化（#942，感谢 @yovinchen）
• 新增定价数据：claude-opus-4-6 和 gpt-5.3-codex（#943，感谢 @yovinchen）
• 静默启动优化：静默启动选项仅在开机启动开启时显示

架构改进

除部分键值合并外，本版还有一批提升可维护性的内部重构：

其他改进：终端选择统一到全局设置并新增 WezTerm 支持；Claude 模型引用从 4.5 更新到 4.6。

Bug 修复

严重修复

• Windows 主目录回归：恢复默认主目录解析，防止 Git/MSYS 环境下HOME环境变量与真实用户配置目录不一致导致数据库路径变更、供应商/设置“消失”
• Linux 白屏：禁用 AMD GPU（Cezanne/Radeon Vega）的 WebKitGTK 硬件加速，解决部分 Linux 系统启动白屏（#986，感谢 @ThendCN）
• OpenAI Beta 参数：不再为/v1/chat/completions端点追加?beta=true，修复 Nvidia 等apiFormat="openai_chat"供应商的请求失败（#1052，感谢 @jnorthrup）
• 健康检查认证：健康检查尊重供应商auth_mode设置，避免仅支持 Bearer 认证的代理服务健康检查失败（#824，感谢 @Jassy930）

供应商预设修复

• 修复 OpenClaw/v1前缀导致的双重路径问题（/v1/v1/messages）
• Opus 定价修正（$15/$75 → $5/$25）并升级到 4.6
• AIGoCode URL 统一为https://api.aigocode.com
• Zhipu GLM 移除过时合作伙伴状态
• 新建 Claude 供应商时恢复 API Key 输入框可见性
• 非活跃供应商隐藏快速开关，显示上下文感知的 JSON 编辑器提示

OMO 修复

• omo-slim 分类检查在 add/form/mutation 路径上补齐
• OMO Slim 供应商变更后正确失效查询缓存
• OMO agent/category 推荐模型与上游源同步
• “填充推荐”按钮失败时增加 toast 反馈
• 移除 OMO/OMO Slim 最后一个供应商的删除限制
• OpenCode 未配置模型时拒绝保存（#932，感谢 @yovinchen）

OpenClaw 修复

• 修复 25 个缺失 i18n key、替换key={index}为稳定 ID、深链接 additive 合并等代码审查问题
• EnvPanel 健壮性增强（NaN 守卫、使用条目键名而非数组索引）
• i18n 重复键合并，恢复供应商表单翻译

平台与 UI 修复

• Windows 静默启动时窗口闪烁（#901，感谢 @funnytime75）
• 标题栏暗黑模式跟随主题（#903，感谢 @funnytime75）
• Windows Skills 路径分隔符匹配（#868，感谢 @stmoonar）
• WSL 辅助函数条件编译
• 工具栏高度裁切导致 AppSwitcher 被遮挡
• 有新版本时显示更新徽章而非绿色对勾
• 仅 Claude/Codex 应用显示会话管理器按钮
• SQL 导入/导出卡片暗黑模式样式统一（#1067，感谢 @SaladDay）

其他修复

• 会话管理器硬编码中文字符串替换为 i18n key
• Skill 文档 URL 分支和路径修正（#977，感谢 @yovinchen）
• OpenCode install.sh 安装路径检测补齐（#988，感谢 @zhu-jl18）
• Skill ZIP 符号链接解析修复（#1040，感谢 @yovinchen）
• MCP 表单补齐 OpenCode 复选框（#1026，感谢 @yovinchen）
• useProvidersQuery中自动导入副作用移除

性能优化

• 会话面板并行目录扫描 + 头尾 JSONL 读取，大幅提升会话列表加载速度（对应 session_manager/mod.rs 中的多线程扫描实现）
• 移除 Tauri 本地 IPC 调用不必要的 TanStack Query 缓存开销，减少内存占用

升级注意事项

1. OpenClaw 是新应用：需先安装 OpenClaw CLI 才能使用相关功能。
2. ⚠️ 通用配置片段功能已移除：供应商切换改为部分键值合并后，其余设置自动保留，该功能不再需要。若曾用它注入额外配置，请升级后手动写入 live 配置文件（详见上文迁移说明）。
3. 自动导入已改为手动：启动时不再自动导入外部配置，请在需要时手动点击“导入当前配置”。
4. OMO 与 OMO Slim 互斥：同一时间只能启用其中一个，切换时另一个自动禁用。
5. 备份默认开启：运行时每小时自动备份，可在备份面板调整策略。

下载与安装

到 CC Switch 官方 Releases 页面下载对应平台版本。系统要求如下：

Windows

macOS

注意：作者没有苹果开发者账号，首次打开可能出现“未知开发者”警告。请先关闭，然后前往“系统设置”→“隐私与安全性”→点击“仍要打开”，之后即可正常打开。

Homebrew（macOS）

brew tap farion1231/ccswitch brew install --cask cc-switch

更新：

brew upgrade --cask cc-switch

Linux

仓库内还附带 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