github farion1231/cc-switch v3.12.1
CC Switch v3.12.1

9 hours ago

CC Switch v3.12.1

Stability Fixes, StepFun Presets, OpenClaw authHeader, and New Sponsor Partners

中文版 → | 日本語版 →


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 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)

brew tap farion1231/ccswitch
brew install --cask cc-switch

Update:

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

Don't miss a new cc-switch release

NewReleases is sending notifications on new releases.