CC Switch v3.11.0

OpenClaw 支持、会话管理器、备份管理与 50+ 项改进

English → | 日本語版 →

概览

CC Switch v3.11.0 是一次大规模更新，新增第五个应用 OpenClaw 的完整管理支持，同时带来全新的会话管理器和备份管理功能。此外，Oh My OpenCode (OMO) 集成、供应商切换的部分键值合并架构升级、设置页面重构等多项改进使整体体验更加完善。

发布日期：2026-02-26

更新规模：147 commits | 274 files changed | +32,179 / -5,467 lines

重点内容

• 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 的完整管理支持，这是继 Claude Code、Codex、Gemini CLI、OpenCode 之后的第五个受管理应用。

• 供应商管理：新增、编辑、切换、删除 OpenClaw 供应商，含 13 个内置预设
• 配置编辑器：Env（环境变量）、Tools（工具）、AgentsDefaults（代理默认值）三个专属配置面板
• Workspace 面板：支持 HEARTBEAT/BOOTSTRAP/BOOT 文件管理及每日记忆
• Additive 叠加模式：支持配置叠加而非覆盖
• 默认模型按钮：一键填充推荐模型，添加供应商时自动将建议模型注册到 allowlist
• 品牌与交互：专属品牌图标、应用切换淡入淡出过渡动画
• 深链接支持：通过 URL 导入 OpenClaw 供应商配置
• 完整国际化：中/英/日三语全面支持

会话管理器 Sessions

全新的会话管理器，帮助你浏览和检索历史会话记录。

• 支持浏览 Claude Code、Codex、Gemini CLI、OpenCode、OpenClaw 五个应用的历史会话（#867，感谢 @TinsFox）
• 目录导航和会话内搜索
• 进入会话页面时默认过滤为当前应用，快速定位
• 并行目录扫描 + 头尾 JSONL 读取，优化加载性能

备份管理 Backup

独立的备份管理面板，让数据安全更有保障。

• 可配置备份策略：最大备份数量、自动清理规则
• 运行时每小时定期自动备份
• 数据库迁移前自动备份，带回填警告提示
• 支持备份重命名和删除（含确认对话框）
• 备份文件名使用本地时间，更直观

Oh My OpenCode (OMO) 集成

完整的 Oh My OpenCode 配置文件管理。

• Agent 模型选择、Category 配置、推荐模型填充（#972，感谢 @yovinchen）
• 改进 Agent 模型选择 UX，修复 lowercase key 问题（#1004，感谢 @yovinchen）
• OMO Slim 轻量模式支持
• OMO 与 OMO Slim 互斥切换（数据库层级强制保证一致性）

工作空间 Workspace

• 每日记忆文件全文搜索，按日期排序
• 目录路径可点击跳转，快速打开文件位置

工具栏 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）
• 主题切换动画：圆形揭示过渡动画，视觉体验更流畅（#905，感谢 @funnytime75）
• Claude 配置编辑器快速开关：快速切换常用配置项（#1012，感谢 @JIA-ss）
• 动态端点提示：根据 API 格式选择动态显示端点提示文本（#860，感谢 @zhu-jl18）
• 用量仪表盘增强：自动刷新、更强健的数据格式化（#942，感谢 @yovinchen）
• 新增定价数据：claude-opus-4-6 和 gpt-5.3-codex（#943，感谢 @yovinchen）
• 静默启动优化：静默启动选项仅在开机启动开启时显示

架构改进

部分键值合并（⚠️ 破坏性变更）

供应商切换从全量配置覆写改为部分键值合并策略（#1098）。

变更前：切换供应商时，整个 settings_config 会覆写到 live 配置文件。这意味着用户在 live 文件中手动添加的非供应商设置（插件配置、MCP 配置、权限设置等）会在每次切换时丢失。为了弥补这个问题，之前版本提供了"通用配置片段"功能，让用户定义每次切换时都会合并的公共配置。

变更后：切换供应商时，仅替换供应商相关的键值（API Key、端点、模型等），用户的其余设置完整保留。因此"通用配置片段"功能不再需要，已被移除。

影响与迁移：

• 如果你之前没有使用通用配置片段功能，此变更对你完全透明，切换体验只会更好
• 如果你之前使用了通用配置片段功能来保留自定义设置（如 MCP 配置、权限等），升级后这些设置会在切换时自动保留，无需额外操作
• 如果你利用通用配置片段做其他用途（如在切换时注入额外配置），请在升级后手动将这些配置写入 live 配置文件中

此次重构删除了 6 个前端文件（3 个组件 + 3 个 hooks）、约 150 行后端死代码。

手动导入替代自动导入

启动时不再自动导入外部配置，改为手动点击"导入当前配置"按钮，避免意外覆盖用户数据。

OMO Variant 参数化

通过 OmoVariant 结构体参数化消除 OMO 模块约 250 行重复代码。

OMO 公共配置移除

删除二层合并系统，减少约 1,733 行代码，简化架构。

ProviderForm 拆分

ProviderForm 组件从 2,227 行减至 1,526 行，提取 5 个独立模块（opencodeFormUtils、useOmoModelSource、useOpencodeFormState、useOmoDraftState、useOpenclawFormState），可维护性显著提升。

MCP/Skills 共享组件

提取 AppCountBar、AppToggleGroup、ListItemRow 等共享组件，减少 MCP 和 Skills 面板的重复代码（#897，感谢 @PeanutSplash）。

设置页面重构

设置页面重构为 5 标签页布局（通用 | 代理 | 高级 | 用量 | 关于），SettingsPage 代码从约 716 行减至约 426 行。

其他改进

• 终端统一：全局设置统一终端选择，新增 WezTerm 支持
• Claude 模型引用从 4.5 更新到 4.6

Bug 修复

严重修复

• Windows 主目录回归：恢复默认主目录解析，防止 Git/MSYS 环境下数据库路径变更导致数据"丢失"
• Linux 白屏：禁用 AMD GPU 的 WebKitGTK 硬件加速，解决部分 Linux 系统启动白屏问题（#986，感谢 @ThendCN）
• OpenAI Beta 参数：不再为 /v1/chat/completions 添加 ?beta=true，修复 Nvidia 等使用 OpenAI Chat 格式的供应商请求失败（#1052，感谢 @jnorthrup）
• 健康检查认证：尊重供应商 auth_mode 设置，避免仅支持 Bearer 认证的代理服务健康检查失败（#824，感谢 @Jassy930）

供应商预设修复

• 修复 OpenClaw /v1 前缀双重路径问题
• 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 重复键合并，恢复供应商表单翻译

平台修复

• Windows 静默启动时窗口闪烁（#901，感谢 @funnytime75）
• 标题栏暗黑模式跟随主题（#903，感谢 @funnytime75）
• Windows Skills 路径分隔符匹配（#868，感谢 @stmoonar）
• WSL 辅助函数条件编译

UI 修复

• 工具栏高度裁切导致 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 读取，大幅提升会话列表加载速度
• 移除 Tauri 本地 IPC 不必要的 query cache，减少内存占用

文档

• 赞助商更新：SSSAiCode、Crazyrouter、AICoding、Right Code、MiniMax
• 新增用户手册（#979，感谢 @yovinchen）

说明与注意事项

• OpenClaw 为新支持的应用：需要先安装 OpenClaw CLI 才能使用相关功能。
• ⚠️ 通用配置片段功能已移除：由于供应商切换改为部分键值合并（仅替换 API Key、端点、模型等字段），用户的其余设置会自动保留，"通用配置片段"功能不再需要。详见上方"架构改进"章节的迁移说明。
• 自动导入已改为手动：启动时不再自动导入外部配置，请在需要时手动点击"导入当前配置"。
• OMO 与 OMO Slim 互斥：同一时间只能启用其中一个，切换时另一个会自动禁用。
• 备份功能默认开启：运行时每小时自动备份，可在备份面板调整策略。

特别感谢

感谢以下贡献者为本版本做出的贡献！

@TinsFox @keithyt06 @kv-chiu @SaladDay @jnorthrup @JIA-ss @clx20000410 @ThendCN @yovinchen @zhu-jl18 @myjustify @funnytime75 @PeanutSplash @Jassy930 @stmoonar

下载与安装

访问 Releases 下载对应版本。

系统要求

Windows

macOS

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

Homebrew（macOS）

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

更新：

brew upgrade --cask cc-switch

Linux