chore: bump version to v3.12.1 and add release notes

2026-04-28 13:42:51 +08:00 · 2026-03-12 00:15:05 +08:00
parent 51825dac20
commit 3dad255a2a
11 changed files with 1759 additions and 1089 deletions
--- a/docs/release-notes/v3.12.1-en.md
+++ b/docs/release-notes/v3.12.1-en.md
@@ -0,0 +1,146 @@
+# CC Switch v3.12.1
+
+> Stability Fixes, StepFun Presets, OpenClaw authHeader, and New Sponsor Partners
+
+**[中文版 →](v3.12.1-zh.md) | [日本語版 →](v3.12.1-ja.md)**
+
+---
+
+## Overview
+
+CC Switch v3.12.1 is a patch release focused on stability improvements and bug fixes. It resolves a Common Config modal infinite reopen loop, a WebDAV sync foreign key constraint failure, and several i18n interpolation issues. It also adds **StepFun** provider presets, **OpenClaw input type selection** and **authHeader** support, upgrades the default Gemini model to **3.1-pro**, and welcomes four new sponsor partners.
+
+**Release Date**: 2026-03-12
+
+**Update Scale**: 19 commits | 56 files changed | +1,429 / -396 lines
+
+---
+
+## Highlights
+
+- **Common Config modal fix**: Resolved an infinite reopen loop in the Common Config modal and added draft editing support
+- **WebDAV sync reliability**: Fixed a foreign key constraint failure when restoring `provider_health` during WebDAV sync
+- **StepFun presets**: Added StepFun (阶跃星辰) provider presets including the step-3.5-flash model
+- **OpenClaw enhancements**: Added input type selection for model Advanced Options and `authHeader` field for vendor-specific auth header support
+- **Gemini model upgrade**: Upgraded default Gemini model to 3.1-pro in provider presets
+- **New sponsors**: Welcomed Micu API, XCodeAPI, SiliconFlow, and CTok as sponsor partners
+
+---
+
+## New Features
+
+### StepFun Provider Presets
+
+Added provider presets for StepFun (阶跃星辰), a leading Chinese AI model provider.
+
+- New preset entries for StepFun across supported applications
+- Includes the step-3.5-flash model (#1369, thanks @hengm3467)
+
+### OpenClaw Enhancements
+
+Enhanced the OpenClaw configuration with more granular control and better vendor compatibility.
+
+- Added input type selection dropdown for model Advanced Options (#1368, thanks @liuxxxu)
+- Added optional `authHeader` boolean to `OpenClawProviderConfig` for vendor-specific auth header support (e.g. Longcat), and refactored form state to reuse the shared type
+
+### Sponsor Partners
+
+- **Micu API**: Added Micu API as sponsor partner with affiliate links
+- **XCodeAPI**: Added XCodeAPI as sponsor partner
+- **SiliconFlow**: Added SiliconFlow (硅基流动) as sponsor partner with affiliate links
+- **CTok**: Added CTok as sponsor partner
+
+---
+
+## Changes
+
+- **UCloud → Compshare**: Renamed UCloud provider to Compshare (优云智算) with full i18n support across all three locales (EN/ZH/JA)
+- **Compshare Links**: Updated Compshare sponsor registration links to coding-plan page
+- **Gemini Model Upgrade**: Upgraded default Gemini model from 2.5-pro to 3.1-pro in provider presets
+
+---
+
+## Bug Fixes
+
+### Common Config & UI
+
+- Fixed an infinite reopen loop in the Common Config modal and added draft editing support to prevent data loss during edits
+- Fixed toolbar compact mode not triggering on Windows due to left-side overflow (#1375, thanks @zuoliangyu)
+- Fixed session search index not syncing with query data, causing stale list display after session deletion
+
+### Sync & Data
+
+- Fixed foreign key constraint failure when restoring `provider_health` table during WebDAV sync
+
+### Provider & Preset
+
+- Added missing `authHeader: true` to Longcat provider preset (#1377, thanks @wavever)
+- Aligned OpenClaw tool permission profiles with upstream schema (#1355, thanks @bigsongeth)
+- Corrected X-Code API URL from `www.x-code.cn` to `x-code.cc`
+
+### i18n & Localization
+
+- Fixed stream check toast i18n interpolation keys not matching translation placeholders
+- Fixed proxy startup toast not interpolating address and port values (#1399, thanks @Mason-mengze)
+- Renamed OpenCode API format label from "OpenAI" to "OpenAI Responses" for accuracy
+
+---
+
+## Special Thanks
+
+Thanks to all contributors for their contributions to this release!
+
+@hengm3467 @liuxxxu @bigsongeth @zuoliangyu @wavever @Mason-mengze
+
+---
+
+## Download & Installation
+
+Visit [Releases](https://github.com/farion1231/cc-switch/releases/latest) to download the appropriate version.
+
+### System Requirements
+
+| System  | Minimum Version                 | Architecture                        |
+| ------- | ------------------------------- | ----------------------------------- |
+| Windows | Windows 10 or later             | x64                                 |
+| macOS   | macOS 10.15 (Catalina) or later | Intel (x64) / Apple Silicon (arm64) |
+| Linux   | See table below                 | x64                                 |
+
+### Windows
+
+| File                                       | Description                                          |
+| ------------------------------------------ | ---------------------------------------------------- |
+| `CC-Switch-v3.12.1-Windows.msi`            | **Recommended** - MSI installer with auto-update     |
+| `CC-Switch-v3.12.1-Windows-Portable.zip`   | Portable version, extract and run, no registry write |
+
+### macOS
+
+| File                               | Description                                                          |
+| ---------------------------------- | -------------------------------------------------------------------- |
+| `CC-Switch-v3.12.1-macOS.zip`      | **Recommended** - Extract and drag to Applications, Universal Binary |
+| `CC-Switch-v3.12.1-macOS.tar.gz`   | For Homebrew installation and auto-update                            |
+
+> **Note**: Since the author doesn't have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Please close it, then go to "System Settings" -> "Privacy & Security" -> click "Open Anyway", and it will open normally afterwards.
+
+### Homebrew (macOS)
+
+```bash
+brew tap farion1231/ccswitch
+brew install --cask cc-switch
+```
+
+Update:
+
+```bash
+brew upgrade --cask cc-switch
+```
+
+### Linux
+
+| Distribution                            | Recommended Format | Installation Method                                                    |
+| --------------------------------------- | ------------------ | ---------------------------------------------------------------------- |
+| Ubuntu / Debian / Linux Mint / Pop!\_OS | `.deb`             | `sudo dpkg -i CC-Switch-*.deb` or `sudo apt install ./CC-Switch-*.deb` |
+| Fedora / RHEL / CentOS / Rocky Linux    | `.rpm`             | `sudo rpm -i CC-Switch-*.rpm` or `sudo dnf install ./CC-Switch-*.rpm`  |
+| openSUSE                                | `.rpm`             | `sudo zypper install ./CC-Switch-*.rpm`                                |
+| Arch Linux / Manjaro                    | `.AppImage`        | Add execute permission and run directly, or use AUR                    |
+| Other distributions / Unsure            | `.AppImage`        | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage`              |
--- a/docs/release-notes/v3.12.1-ja.md
+++ b/docs/release-notes/v3.12.1-ja.md
@@ -0,0 +1,146 @@
+# CC Switch v3.12.1
+
+> 安定性修正、StepFun プリセット、OpenClaw authHeader 対応、新スポンサーパートナー
+
+**[中文版 →](v3.12.1-zh.md) | [English →](v3.12.1-en.md)**
+
+---
+
+## 概要
+
+CC Switch v3.12.1 は、安定性の改善とバグ修正に焦点を当てたパッチリリースです。共通設定モーダルの無限再オープンループ、WebDAV 同期時の外部キー制約エラー、複数の i18n 補間問題を修正しました。また、**StepFun（阶跃星辰）** プロバイダープリセットの追加、OpenClaw の**入力タイプ選択**と **authHeader** サポート、デフォルト Gemini モデルの **3.1-pro** へのアップグレード、4 つの新スポンサーパートナーの追加が含まれます。
+
+**リリース日**: 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 プロバイダープリセット
+
+中国の主要 AI モデルプロバイダーである StepFun（阶跃星辰）のプロバイダープリセットを追加しました。
+
+- サポート対象アプリケーション全体に 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（优云智算）にリネームし、3 言語（EN/ZH/JA）の完全な i18n サポートを追加
+- **Compshare リンク**: Compshare スポンサー登録リンクを coding-plan ページに更新
+- **Gemini モデルアップグレード**: プロバイダープリセットのデフォルト Gemini モデルを 2.5-pro から 3.1-pro にアップグレード
+
+---
+
+## バグ修正
+
+### 共通設定と UI
+
+- 共通設定モーダルの無限再オープンループを修正し、編集中のデータ損失を防ぐための下書き編集サポートを追加
+- Windows でツールバーコンパクトモードが左側のオーバーフローにより機能しない問題を修正（#1375、@zuoliangyu に感謝）
+- セッション削除後にクエリデータと検索インデックスが同期されず、リストが更新されない問題を修正
+
+### 同期とデータ
+
+- WebDAV 同期で `provider_health` テーブルを復元する際の外部キー制約エラーを修正
+
+### プロバイダーとプリセット
+
+- Longcat プロバイダープリセットに欠落していた `authHeader: true` を追加（#1377、@wavever に感謝）
+- OpenClaw のツール権限プロファイルをアップストリームスキーマに合わせて修正（#1355、@bigsongeth に感謝）
+- X-Code API の URL を `www.x-code.cn` から `x-code.cc` に修正
+
+### i18n とローカリゼーション
+
+- Stream Check トーストの i18n 補間キーが翻訳プレースホルダーと一致しない問題を修正
+- プロキシ起動トーストでアドレスとポート値が補間されない問題を修正（#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 インストールと自動更新用                                 |
+
+> **注意**: 作者が Apple Developer アカウントを持っていないため、初回起動時に「開発元を確認できません」という警告が表示される場合があります。一度閉じてから、「システム設定」→「プライバシーとセキュリティ」→「このまま開く」をクリックすると、その後は正常に開けます。
+
+### 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`              |
--- a/docs/release-notes/v3.12.1-zh.md
+++ b/docs/release-notes/v3.12.1-zh.md
@@ -0,0 +1,146 @@
+# 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`              |