mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-23 01:14:51 +08:00
c772874dcb
- Delete 9 completed planning/roadmap documents - Move 23 release notes into docs/release-notes/ with simplified filenames - Update all cross-references in READMEs, CHANGELOG, and release notes - Remove dangling doc reference in deeplink/mod.rs
303 lines
14 KiB
Markdown
303 lines
14 KiB
Markdown
# 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` |
|