# CC Switch v3.11.0

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

**[English →](v3.11.0-en.md) | [日本語版 →](v3.11.0-ja.md)**

---

## 概览

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](https://github.com/farion1231/cc-switch/releases/latest) 下载对应版本。

### 系统要求

| 系统    | 最低版本                      | 架构                                |
| ------- | ----------------------------- | ----------------------------------- |
| Windows | Windows 10 及以上             | x64                                 |
| macOS   | macOS 10.15 (Catalina) 及以上 | Intel (x64) / Apple Silicon (arm64) |
| Linux   | 见下表                        | x64                                 |

### Windows

| 文件                                     | 说明                                |
| ---------------------------------------- | ----------------------------------- |
| `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 Binary |
| `CC-Switch-v3.11.0-macOS.tar.gz` | 用于 Homebrew 安装和自动更新                              |

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

### Homebrew（macOS）

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

更新：

```bash
brew upgrade --cask cc-switch
```

### Linux

| 发行版                                  | 推荐格式    | 安装方式                                                               |
| --------------------------------------- | ----------- | ---------------------------------------------------------------------- |
| Ubuntu / Debian / Linux Mint / Pop!\_OS | `.deb`      | `sudo dpkg -i CC-Switch-*.deb` 或 `sudo apt install ./CC-Switch-*.deb` |
| Fedora / RHEL / CentOS / Rocky Linux    | `.rpm`      | `sudo rpm -i CC-Switch-*.rpm` 或 `sudo dnf install ./CC-Switch-*.rpm`  |
| openSUSE                                | `.rpm`      | `sudo zypper install ./CC-Switch-*.rpm`                                |
| Arch Linux / Manjaro                    | `.AppImage` | 添加执行权限后直接运行，或使用 AUR                                     |
| 其他发行版 / 不确定                     | `.AppImage` | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`              |
