# CC Switch v3.12.1 > 稳定性修复、StepFun 预设、OpenClaw authHeader 支持，以及新赞助商伙伴 **[English →](v3.12.1-en.md) | [日本語版 →](v3.12.1-ja.md)** --- ## 概览 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](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.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 | `.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` |