mirror of
https://github.com/farion1231/cc-switch.git
synced 2026-04-18 01:14:14 +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
207 lines
8.4 KiB
Markdown
207 lines
8.4 KiB
Markdown
# CC Switch v3.10.0
|
|
|
|
> OpenCode Support, Global Proxy, Claude Rectifier & Multi-App Experience Enhancements
|
|
|
|
**[中文版 →](v3.10.0-zh.md) | [日本語版 →](v3.10.0-ja.md)**
|
|
|
|
---
|
|
|
|
## Overview
|
|
|
|
CC Switch v3.10.0 introduces OpenCode support, becoming the fourth managed CLI application.
|
|
This release also brings global proxy settings, Claude Rectifier (thinking signature fixer), enhanced health checks, per-provider configuration, and many other important features, along with comprehensive improvements to multi-app workflows and terminal experience.
|
|
|
|
**Release Date**: 2026-01-21
|
|
|
|
---
|
|
|
|
## Highlights
|
|
|
|
- OpenCode Support: Full management of providers, MCP servers, and Skills with auto-import on first launch
|
|
- Global Proxy: Configure a unified proxy for all outbound network requests
|
|
- Claude Rectifier: Thinking signature fixer for better compatibility with third-party APIs
|
|
- Enhanced Health Checks: Configurable prompts and CLI-compatible request format
|
|
- Per-Provider Config: Persistent provider-specific configuration support
|
|
- App Visibility Control: Freely show/hide apps with synchronized tray menu updates
|
|
- Terminal Improvements: Provider-specific terminal buttons, fnm path support, cross-platform safe launch
|
|
- WSL Tool Detection: Detect tool versions in WSL environment with security hardening
|
|
|
|
---
|
|
|
|
## Main Features
|
|
|
|
### OpenCode Support (New Fourth App)
|
|
|
|
- Complete OpenCode provider management: add, edit, switch, delete
|
|
- MCP server management: unified architecture with Claude/Codex/Gemini
|
|
- Skills support: OpenCode can also use Skills functionality
|
|
- Auto-import on first launch: automatically imports existing OpenCode configuration when detected
|
|
- Full internationalization: Chinese/English/Japanese support (#695)
|
|
|
|
### Global Proxy
|
|
|
|
- Configure a unified proxy for all outbound network requests (#596, thanks @yovinchen)
|
|
- Supports HTTP/HTTPS proxy protocols
|
|
- Suitable for network environments requiring proxy access to external APIs
|
|
|
|
### Claude Rectifier (Thinking Signature Fixer)
|
|
|
|
- Automatically fixes Claude API thinking signatures (#595, thanks @yovinchen)
|
|
- Resolves incompatible thinking block formats returned by some third-party API gateways
|
|
- Can be enabled/disabled in Advanced Settings
|
|
|
|
### Enhanced Health Checks
|
|
|
|
- Configurable custom prompts for streaming health checks (#623, thanks @yovinchen)
|
|
- Supports CLI-compatible request format for better simulation of real usage scenarios
|
|
- Improves fault detection accuracy
|
|
|
|
### Per-Provider Config
|
|
|
|
- Support for saving configuration separately for each provider (#663, thanks @yovinchen)
|
|
- Persistent configuration: provider-specific settings retained after restart
|
|
- Suitable for scenarios where different providers require different configurations
|
|
|
|
### App Visibility Control
|
|
|
|
- Freely show/hide any app (Gemini hidden by default)
|
|
- Tray menu automatically syncs visibility settings
|
|
- Hidden apps won't appear in the main interface or tray menu
|
|
|
|
### Takeover Compact Mode
|
|
|
|
- Automatically uses compact layout when 3 or more visible apps are displayed
|
|
- Optimizes space utilization in multi-app scenarios
|
|
|
|
### Terminal Improvements
|
|
|
|
- Provider-specific terminal button: one-click to use current provider in terminal (#564, thanks @kkkman22)
|
|
- `fnm` path support: automatically recognizes Node.js paths managed by fnm
|
|
- Cross-platform safe launch: improved terminal launch logic for Windows/macOS/Linux
|
|
|
|
### WSL Tool Detection
|
|
|
|
- Detect tool versions in WSL environment (#627, thanks @yovinchen)
|
|
- Added security hardening to prevent command injection risks
|
|
|
|
### Skills Preset Enhancements
|
|
|
|
- Added `baoyu-skills` preset repository
|
|
- Automatically supplements missing default repositories for out-of-the-box experience
|
|
|
|
---
|
|
|
|
## Experience Improvements
|
|
|
|
- Keyboard shortcuts: Press `ESC` to quickly return/close panels (#670, thanks @xxk8)
|
|
- Simplified proxy logs: cleaner and more readable output (#585, thanks @yovinchen)
|
|
- Pricing editor UX: unified `FullScreenPanel` style
|
|
- Advanced settings layout: Rectifier section moved below Failover for better logical flow
|
|
- OpenRouter compatibility mode: disabled by default, UI toggle hidden (reduces clutter)
|
|
|
|
---
|
|
|
|
## Bug Fixes
|
|
|
|
### Proxy & Failover
|
|
|
|
- Immediately switch to P1 when auto-failover is enabled (instead of waiting for next request)
|
|
|
|
### Provider Management
|
|
|
|
- Fixed stale data when reopening provider edit dialog after save (#654, thanks @YangYongAn)
|
|
- Fixed baseUrl and apiKey state not resetting when switching presets
|
|
- Fixed endpoint auto-selection state not persisting (#611, thanks @yovinchen)
|
|
- Automatically apply default color when icon color is not set
|
|
|
|
### Deep Links
|
|
|
|
- Support multi-endpoint import (#597, thanks @yovinchen)
|
|
- Prefer `GOOGLE_GEMINI_BASE_URL` over `GEMINI_BASE_URL`
|
|
|
|
### MCP
|
|
|
|
- Skip `cmd /c` wrapper for WSL target paths (#592, thanks @cxyfer)
|
|
|
|
### Usage Templates
|
|
|
|
- Added variable hints, fixed validation issues (#628, thanks @YangYongAn)
|
|
- Prevent configuration leakage between providers
|
|
- Usage block offset automatically adapts to action button width (#613, thanks @yovinchen)
|
|
|
|
### Gemini
|
|
|
|
- Convert timeout parameters to Gemini CLI format (#580, thanks @cxyfer)
|
|
|
|
### UI
|
|
|
|
- Fixed Select dropdown rendering issues in `FullScreenPanel`
|
|
|
|
---
|
|
|
|
## Notes & Considerations
|
|
|
|
- **OpenCode is a newly supported app**: OpenCode CLI must be installed first to use related features.
|
|
- **Global proxy affects all outbound requests**: including usage queries, health checks, and other network operations.
|
|
- **Rectifier is experimental**: can be disabled in Advanced Settings if issues occur.
|
|
|
|
---
|
|
|
|
## Special Thanks
|
|
|
|
Thanks to @yovinchen @YangYongAn @cxyfer @xxk8 @kkkman22 @Shuimo03 for their contributions to this release!
|
|
Thanks to @libukai for designing the elegant failover-related UI!
|
|
|
|
---
|
|
|
|
## 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.10.0-Windows.msi` | **Recommended** - MSI installer with auto-update |
|
|
| `CC-Switch-v3.10.0-Windows-Portable.zip` | Portable version, extract and run, no registry write |
|
|
|
|
### macOS
|
|
|
|
| File | Description |
|
|
| -------------------------------- | ------------------------------------------------------------------ |
|
|
| `CC-Switch-v3.10.0-macOS.zip` | **Recommended** - Extract and drag to Applications, Universal Binary |
|
|
| `CC-Switch-v3.10.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` |
|