github/cc-switch
1
0
Fork 0
mirror of https://github.com/farion1231/cc-switch.git synced 2026-04-03 14:36:44 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
83fe3402c217862a9e14ed52ba19ddafadb0cbc4
cc-switch/docs/release-note-v3.11.0-zh.md
Jason 3bd0a7c02c docs: highlight Common Config Snippet removal as breaking change in release notes 
Expand the partial key-field merging section with Before/After explanation
and migration guide. Mark it as a breaking change in Highlights and Notes
sections across all three languages (zh/en/ja) and CHANGELOG.md.
2026-02-27 00:03:22 +08:00

14 KiB
Raw Blame History

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

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

更新：

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
Reference in New Issue View Git Blame Copy Permalink