# 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`              |
