ContextQMD
Back to Cc Switch

CC Switch v3.12.1

docs/release-notes/v3.12.1-zh.md

3.14.16.4 KB
Original Source

CC Switch v3.12.1

稳定性修复、StepFun 预设、OpenClaw authHeader 支持，以及新赞助商伙伴

English → | 日本語版 →

概览

CC Switch v3.12.1 是一个以稳定性改进和 Bug 修复为主的补丁版本。修复了通用配置弹窗无限重复打开的循环问题、WebDAV 同步时的外键约束失败以及多个 i18n 插值问题。同时新增了 StepFun（阶跃星辰） 供应商预设、OpenClaw 输入类型选择 和 authHeader 支持，将默认 Gemini 模型升级到 3.1-pro，并欢迎四位新赞助商伙伴加入。

发布日期：2026-03-12

更新规模：19 commits | 56 files changed | +1,429 / -396 lines

重点内容

  • 通用配置弹窗修复：解决了通用配置弹窗无限重复打开的循环问题，并新增草稿编辑支持
  • WebDAV 同步可靠性：修复了 WebDAV 同步恢复 provider_health 时的外键约束失败
  • StepFun 预设：新增 StepFun（阶跃星辰）供应商预设，包含 step-3.5-flash 模型
  • OpenClaw 增强：新增模型高级选项的输入类型选择和 authHeader 字段，支持供应商特定的认证头
  • Gemini 模型升级：供应商预设中的默认 Gemini 模型升级到 3.1-pro
  • 新赞助商：欢迎 Micu API、XCodeAPI、SiliconFlow、CTok 加入赞助伙伴

新功能

StepFun 供应商预设

新增 StepFun（阶跃星辰）供应商预设，阶跃星辰是领先的中国 AI 模型提供商。

  • 在各支持应用中新增 StepFun 预设条目
  • 包含 step-3.5-flash 模型（#1369，感谢 @hengm3467）

OpenClaw 增强

增强 OpenClaw 配置能力，提供更细粒度的控制和更好的供应商兼容性。

  • 新增模型高级选项的输入类型（input type）选择下拉框（#1368，感谢 @liuxxxu）
  • 在 OpenClawProviderConfig 中新增可选的 authHeader 布尔字段，支持供应商特定的认证头（如 Longcat），并重构表单状态以复用共享类型

赞助商伙伴

  • Micu API：新增 Micu API 赞助商及推广链接
  • XCodeAPI：新增 XCodeAPI 赞助商
  • SiliconFlow：新增 SiliconFlow（硅基流动）赞助商及推广链接
  • CTok：新增 CTok 赞助商

变更

  • UCloud → Compshare：将 UCloud 供应商更名为 Compshare（优云智算），支持三种语言（中/英/日）的完整国际化
  • Compshare 链接：更新 Compshare 赞助商注册链接指向 coding-plan 页面
  • Gemini 模型升级：供应商预设中的默认 Gemini 模型从 2.5-pro 升级到 3.1-pro

Bug 修复

通用配置与 UI

  • 修复通用配置弹窗无限重复打开的循环问题，并新增草稿编辑支持以防止编辑过程中数据丢失
  • 修复 Windows 下因左侧溢出导致工具栏紧凑模式不触发的问题（#1375，感谢 @zuoliangyu）
  • 修复会话删除后搜索索引未与查询数据同步，导致列表显示过期的问题

同步与数据

  • 修复 WebDAV 同步恢复 provider_health 表时的外键约束失败

供应商与预设

  • 为 Longcat 供应商预设补充缺失的 authHeader: true（#1377，感谢 @wavever）
  • 对齐 OpenClaw 工具权限配置与上游 schema（#1355，感谢 @bigsongeth）
  • 修正 X-Code API URL，从 www.x-code.cn 改为 x-code.cc

i18n 与本地化

  • 修复 Stream Check Toast 的 i18n 插值 key 与翻译占位符不匹配
  • 修复代理启动 Toast 未正确插值地址和端口的问题（#1399，感谢 @Mason-mengze）
  • 将 OpenCode API 格式标签从 "OpenAI" 改为 "OpenAI Responses"，更准确地反映实际格式

特别感谢

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

@hengm3467 @liuxxxu @bigsongeth @zuoliangyu @wavever @Mason-mengze

下载与安装

访问 Releases 下载对应版本。

系统要求

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

Windows

文件说明
CC-Switch-v3.12.1-Windows.msi推荐 - MSI 安装包，支持自动更新
CC-Switch-v3.12.1-Windows-Portable.zip便携版，解压即用，不写入注册表

macOS

文件说明
CC-Switch-v3.12.1-macOS.zip推荐 - 解压后拖入 Applications 即可，Universal Binary
CC-Switch-v3.12.1-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.debsudo dpkg -i CC-Switch-*.deb 或 sudo apt install ./CC-Switch-*.deb
Fedora / RHEL / CentOS / Rocky Linux.rpmsudo rpm -i CC-Switch-*.rpm 或 sudo dnf install ./CC-Switch-*.rpm
openSUSE.rpmsudo zypper install ./CC-Switch-*.rpm
Arch Linux / Manjaro.AppImage添加执行权限后直接运行，或使用 AUR
其他发行版 / 不确定.AppImagechmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage