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

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 下载对应版本。

系统要求

系统	最低版本	架构
Windows	Windows 10 及以上	x64
macOS	macOS 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）

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