mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-17 00:35:13 +08:00
c772874dcb
- Delete 9 completed planning/roadmap documents - Move 23 release notes into docs/release-notes/ with simplified filenames - Update all cross-references in READMEs, CHANGELOG, and release notes - Remove dangling doc reference in deeplink/mod.rs
303 lines
16 KiB
Markdown
303 lines
16 KiB
Markdown
# CC Switch v3.11.0
|
|
|
|
> OpenClaw Support, Session Manager, Backup Management & 50+ Improvements
|
|
|
|
**[中文版 →](v3.11.0-zh.md) | [日本語版 →](v3.11.0-ja.md)**
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
CC Switch v3.11.0 is a major update that adds full management support for **OpenClaw** as the fifth application, introduces a new **Session Manager** and **Backup Management** feature. Additionally, **Oh My OpenCode (OMO) integration**, the **partial key-field merging** architecture upgrade for provider switching, **settings page refactoring**, and many other improvements make the overall experience more polished.
|
|
|
|
**Release Date**: 2026-02-26
|
|
|
|
**Update Scale**: 147 commits | 274 files changed | +32,179 / -5,467 lines
|
|
|
|
---
|
|
|
|
## Highlights
|
|
|
|
- **OpenClaw Support**: Fifth managed application with 13 provider presets, Env/Tools/AgentsDefaults config editors, and Workspace file management
|
|
- **Session Manager**: Browse conversation history across all five apps with table-of-contents navigation and in-session search
|
|
- **Backup Management**: Independent backup panel with configurable policies, periodic backups, and pre-migration auto-backup
|
|
- **Oh My OpenCode Integration**: Full OMO config management with OMO Slim lightweight mode support
|
|
- **Partial Key-Field Merging (⚠️ Breaking Change)**: Provider switching now only replaces provider-related fields, preserving all other settings; the "Common Config Snippet" feature has been removed
|
|
- **Settings Page Refactoring**: 5-tab layout with ~40% code reduction
|
|
- **6 New Provider Presets**: AWS Bedrock, SSAI Code, CrazyRouter, AICoding, and more
|
|
- **Thinking Budget Rectifier**: Fine-grained thinking budget control
|
|
- **Theme Switch Animation**: Circular reveal transition animation
|
|
- **WebDAV Auto Sync**: Automatic sync with large file protection
|
|
|
|
---
|
|
|
|
## Main Features
|
|
|
|
### OpenClaw Support (New Fifth App)
|
|
|
|
Full management support for OpenClaw, the fifth managed application following Claude Code, Codex, Gemini CLI, and OpenCode.
|
|
|
|
- **Provider Management**: Add, edit, switch, and delete OpenClaw providers with 13 built-in presets
|
|
- **Config Editors**: Three dedicated panels for Env (environment variables), Tools, and AgentsDefaults
|
|
- **Workspace Panel**: HEARTBEAT/BOOTSTRAP/BOOT file management and daily memory
|
|
- **Additive Overlay Mode**: Support config overlay instead of overwrite
|
|
- **Default Model Button**: One-click to fill recommended models; auto-register suggested models to allowlist when adding providers
|
|
- **Brand & Interaction**: Dedicated brand icon, fade-in/fade-out transition animation when switching apps
|
|
- **Deep Link Support**: Import OpenClaw provider configurations via URL
|
|
- **Full Internationalization**: Complete Chinese/English/Japanese support
|
|
|
|
### Session Manager
|
|
|
|
A brand-new session manager to browse and search conversation history.
|
|
|
|
- Browse conversation history across Claude Code, Codex, Gemini CLI, OpenCode, and OpenClaw (#867, thanks @TinsFox)
|
|
- Table-of-contents navigation and in-session search
|
|
- Auto-filter by current app when entering the session page
|
|
- Parallel directory scanning + head-tail JSONL reading for optimized loading performance
|
|
|
|
### Backup Management
|
|
|
|
An independent backup management panel for better data safety.
|
|
|
|
- Configurable backup policy: maximum backup count and auto-cleanup rules
|
|
- Hourly automatic backup timer during runtime
|
|
- Auto-backup before database schema migrations with backfill warning
|
|
- Support backup rename and deletion (with confirmation dialog)
|
|
- Backup filenames use local time for better clarity
|
|
|
|
### Oh My OpenCode (OMO) Integration
|
|
|
|
Full Oh My OpenCode config file management.
|
|
|
|
- Agent model selection, category configuration, and recommended model fill (#972, thanks @yovinchen)
|
|
- Improved agent model selection UX with lowercase key fix (#1004, thanks @yovinchen)
|
|
- OMO Slim lightweight mode support
|
|
- OMO ↔ OMO Slim mutual exclusion (enforced at database level)
|
|
|
|
### Workspace
|
|
|
|
- Full-text search across daily memory files, sorted by date
|
|
- Clickable directory paths for quick file location access
|
|
|
|
### Toolbar
|
|
|
|
- AppSwitcher auto-collapses to compact mode based on available width
|
|
- Smooth transition animation for compact mode toggle
|
|
|
|
### Settings
|
|
|
|
- First-use confirmation dialogs for proxy and usage features to prevent accidental operations
|
|
- New `enableLocalProxy` switch to control proxy UI visibility on home page
|
|
- More granular local environment checks: CLI tool version detection (#870, thanks @kv-chiu), Volta path detection (#969, thanks @myjustify)
|
|
|
|
### Provider Presets
|
|
|
|
- **AWS Bedrock**: Support for AKSK and API Key authentication modes (#1047, thanks @keithyt06)
|
|
- **SSAI Code**: Partner preset across all five apps
|
|
- **CrazyRouter**: Partner preset with dedicated icon
|
|
- **AICoding**: Partner preset with i18n promotion text
|
|
- Updated domestic model provider presets to latest versions
|
|
- Renamed Qwen Coder to Bailian (#965, thanks @zhu-jl18)
|
|
|
|
### Other New Features
|
|
|
|
- **Thinking Budget Rectifier**: Fine-grained thinking budget allocation control (#1005, thanks @yovinchen)
|
|
- **WebDAV Auto Sync**: Automatic sync with large file protection (#923, thanks @clx20000410; #1043, thanks @SaladDay)
|
|
- **Theme Switch Animation**: Circular reveal transition for a smoother visual experience (#905, thanks @funnytime75)
|
|
- **Claude Config Editor Quick Toggles**: Quick toggle switches for common settings (#1012, thanks @JIA-ss)
|
|
- **Dynamic Endpoint Hint**: Context-aware hint text based on API format selection (#860, thanks @zhu-jl18)
|
|
- **Usage Dashboard Enhancement**: Auto-refresh control and robust formatting (#942, thanks @yovinchen)
|
|
- **New Pricing Data**: claude-opus-4-6 and gpt-5.3-codex (#943, thanks @yovinchen)
|
|
- **Silent Startup Optimization**: Silent startup option only shown when launch-on-startup is enabled
|
|
|
|
---
|
|
|
|
## Architecture Improvements
|
|
|
|
### Partial Key-Field Merging (⚠️ Breaking Change)
|
|
|
|
Provider switching now uses partial key-field merging instead of full config overwrite (#1098).
|
|
|
|
**Before**: Switching providers overwrote the entire `settings_config` to the live config file. This meant that any non-provider settings the user manually added to the live file (plugins, MCP config, permissions, etc.) would be lost on every switch. To work around this, previous versions offered a "Common Config Snippet" feature that let users define shared config to be merged on every switch.
|
|
|
|
**After**: Switching providers now only replaces provider-related key-values (API keys, endpoints, models, etc.), leaving all other settings intact. The "Common Config Snippet" feature is therefore no longer needed and has been removed.
|
|
|
|
**Impact & Migration**:
|
|
- If you **didn't use** Common Config Snippets, this change is fully transparent — switching just works better now
|
|
- If you **used** Common Config Snippets to preserve custom settings (MCP config, permissions, etc.), those settings are now automatically preserved during switches — no action needed
|
|
- If you used Common Config Snippets for other purposes (e.g., injecting extra config on every switch), please manually add those settings to your live config file after upgrading
|
|
|
|
This refactoring removed 6 frontend files (3 components + 3 hooks) and ~150 lines of backend dead code.
|
|
|
|
### Manual Import Replaces Auto-Import
|
|
|
|
Startup no longer auto-imports external configurations. Users now click "Import Current Config" manually, preventing accidental data overwrites.
|
|
|
|
### OmoVariant Parameterization
|
|
|
|
Eliminated ~250 lines of duplicated code in the OMO module via `OmoVariant` struct parameterization.
|
|
|
|
### OMO Common Config Removal
|
|
|
|
Removed the two-layer merge system, reducing ~1,733 lines of code and simplifying the architecture.
|
|
|
|
### ProviderForm Decomposition
|
|
|
|
Reduced ProviderForm component from 2,227 lines to 1,526 lines by extracting 5 independent modules (opencodeFormUtils, useOmoModelSource, useOpencodeFormState, useOmoDraftState, useOpenclawFormState), significantly improving maintainability.
|
|
|
|
### Shared MCP/Skills Components
|
|
|
|
Extracted AppCountBar, AppToggleGroup, and ListItemRow shared components to reduce duplication across MCP and Skills panels (#897, thanks @PeanutSplash).
|
|
|
|
### Settings Page Refactoring
|
|
|
|
Refactored settings page to a 5-tab layout (General | Proxy | Advanced | Usage | About), reducing SettingsPage code from ~716 to ~426 lines.
|
|
|
|
### Other Improvements
|
|
|
|
- Unified terminal selection via global settings with WezTerm support added
|
|
- Updated Claude model references from 4.5 to 4.6
|
|
|
|
---
|
|
|
|
## Bug Fixes
|
|
|
|
### Critical Fixes
|
|
|
|
- **Windows Home Dir Regression**: Restored default home directory resolution to prevent providers/settings "disappearing" when `HOME` env var differs from the real user profile directory in Git/MSYS environments
|
|
- **Linux White Screen**: Disabled WebKitGTK hardware acceleration on AMD GPUs (Cezanne/Radeon Vega) to prevent blank screen on startup (#986, thanks @ThendCN)
|
|
- **OpenAI Beta Parameter**: Stopped appending `?beta=true` to `/v1/chat/completions` endpoints, fixing request failures for Nvidia and other `apiFormat="openai_chat"` providers (#1052, thanks @jnorthrup)
|
|
- **Health Check Auth**: Health check now respects provider's `auth_mode` setting, preventing failures for proxy services that only support Bearer authentication (#824, thanks @Jassy930)
|
|
|
|
### Provider Preset Fixes
|
|
|
|
- Fixed OpenClaw `/v1` prefix causing double path (/v1/v1/messages)
|
|
- Corrected Opus pricing ($15/$75 → $5/$25) and upgraded to 4.6
|
|
- Unified AIGoCode URL to `https://api.aigocode.com` across all apps
|
|
- Removed outdated partner status from Zhipu GLM presets
|
|
- Restored API Key input visibility when creating new Claude providers
|
|
- Hide quick toggles for non-active providers, show context-aware JSON editor hints
|
|
|
|
### OMO Fixes
|
|
|
|
- Added missing omo-slim category checks across add/form/mutation paths
|
|
- Fixed OMO Slim query cache invalidation after provider mutations
|
|
- Synced OMO agent/category recommended models with upstream sources
|
|
- Added toast feedback for "Fill Recommended" button silent failures
|
|
- Removed last-provider deletion restriction for OMO/OMO Slim
|
|
- Reject saving OpenCode providers without configured models (#932, thanks @yovinchen)
|
|
|
|
### OpenClaw Fixes
|
|
|
|
- Fixed 25 missing i18n keys, replaced key={index} with stable IDs, added deep link additive merge, and other code review issues
|
|
- Enhanced EnvPanel robustness (NaN guards, entry key names instead of array indices)
|
|
- Merged duplicate i18n keys to restore provider form translations
|
|
|
|
### Platform Fixes
|
|
|
|
- Windows silent startup window flicker (#901, thanks @funnytime75)
|
|
- Title bar dark mode theme following (#903, thanks @funnytime75)
|
|
- Windows Skills path separator matching (#868, thanks @stmoonar)
|
|
- WSL helper functions conditional compilation
|
|
|
|
### UI Fixes
|
|
|
|
- Toolbar height clipping causing AppSwitcher to be obscured
|
|
- Show update badge instead of green checkmark when newer version available
|
|
- Session Manager button only visible for Claude/Codex apps
|
|
- Unified SQL import/export card dark mode styling (#1067, thanks @SaladDay)
|
|
|
|
### Other Fixes
|
|
|
|
- Replaced hardcoded Chinese strings in Session Manager with i18n keys
|
|
- Fixed Skill documentation URL branch and path resolution (#977, thanks @yovinchen)
|
|
- Added missing OpenCode install.sh installation path detection (#988, thanks @zhu-jl18)
|
|
- Fixed Skill ZIP symlink resolution (#1040, thanks @yovinchen)
|
|
- Added missing OpenCode checkbox in MCP add/edit form (#1026, thanks @yovinchen)
|
|
- Removed auto-import side effect from useProvidersQuery queryFn
|
|
|
|
---
|
|
|
|
## Performance
|
|
|
|
- Parallel directory scanning + head-tail JSONL reading for session panel, significantly improving session list loading speed
|
|
- Removed unnecessary TanStack Query cache overhead for Tauri local IPC calls
|
|
|
|
---
|
|
|
|
## Documentation
|
|
|
|
- Sponsor updates: SSSAiCode, Crazyrouter, AICoding, Right Code, MiniMax
|
|
- Added user manual documentation (#979, thanks @yovinchen)
|
|
|
|
---
|
|
|
|
## Notes & Considerations
|
|
|
|
- **OpenClaw is a newly supported app**: OpenClaw CLI must be installed first to use related features.
|
|
- **⚠️ Common Config Snippet feature has been removed**: Since provider switching now uses partial key-field merging (only replacing API keys, endpoints, models, etc.), user's other settings are automatically preserved, making Common Config Snippets unnecessary. See the "Architecture Improvements" section above for migration details.
|
|
- **Auto-import changed to manual**: External configurations are no longer auto-imported on startup. Click "Import Current Config" manually when needed.
|
|
- **OMO and OMO Slim are mutually exclusive**: Only one can be active at a time. Switching to one automatically disables the other.
|
|
- **Backup is enabled by default**: Automatic hourly backup during runtime. Adjust the policy in the Backup panel.
|
|
|
|
---
|
|
|
|
## Special Thanks
|
|
|
|
Thanks to all contributors for their contributions to this release!
|
|
|
|
@TinsFox @keithyt06 @kv-chiu @SaladDay @jnorthrup @JIA-ss @clx20000410 @ThendCN @yovinchen @zhu-jl18 @myjustify @funnytime75 @PeanutSplash @Jassy930 @stmoonar
|
|
|
|
---
|
|
|
|
## 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.11.0-Windows.msi` | **Recommended** - MSI installer with auto-update |
|
|
| `CC-Switch-v3.11.0-Windows-Portable.zip` | Portable version, extract and run, no registry write |
|
|
|
|
### macOS
|
|
|
|
| File | Description |
|
|
| -------------------------------- | -------------------------------------------------------------------- |
|
|
| `CC-Switch-v3.11.0-macOS.zip` | **Recommended** - Extract and drag to Applications, Universal Binary |
|
|
| `CC-Switch-v3.11.0-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` |
|