diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml index 7e65c4d7a..0e791acef 100644 --- a/.github/workflows/release.yml +++ b/.github/workflows/release.yml @@ -53,7 +53,11 @@ jobs: wget \ file \ patchelf \ - libssl-dev + libssl-dev \ + rpm \ + flatpak \ + flatpak-builder \ + elfutils # GTK/GLib stack for gdk-3.0, glib-2.0, gio-2.0 sudo apt-get install -y --no-install-recommends \ libgtk-3-dev \ @@ -153,7 +157,7 @@ jobs: - name: Build Tauri App (Linux) if: runner.os == 'Linux' - run: pnpm tauri build + run: pnpm tauri build --bundles appimage,deb,rpm - name: Prepare macOS Assets if: runner.os == 'macOS' @@ -271,6 +275,15 @@ jobs: else echo "No .deb found (optional)" fi + # 额外上传 .rpm（用于 Fedora/RHEL/openSUSE 等，不参与 Updater） + RPM=$(find src-tauri/target/release/bundle -name "*.rpm" | head -1 || true) + if [ -n "$RPM" ]; then + NEW_RPM="CC-Switch-${VERSION}-Linux.rpm" + cp "$RPM" "release-assets/$NEW_RPM" + echo "RPM package copied: $NEW_RPM" + else + echo "No .rpm found (optional)" + fi - name: List prepared assets shell: bash @@ -299,7 +312,7 @@ jobs: - **macOS**: `CC-Switch-${{ github.ref_name }}-macOS.zip`（解压即用）或 `CC-Switch-${{ github.ref_name }}-macOS.tar.gz`（Homebrew） - **Windows**: `CC-Switch-${{ github.ref_name }}-Windows.msi`（安装版）或 `CC-Switch-${{ github.ref_name }}-Windows-Portable.zip`（绿色版） - - **Linux**: `CC-Switch-${{ github.ref_name }}-Linux.AppImage`（AppImage）或 `CC-Switch-${{ github.ref_name }}-Linux.deb`（Debian/Ubuntu） + - **Linux**: `CC-Switch-${{ github.ref_name }}-Linux.AppImage`（AppImage）或 `CC-Switch-${{ github.ref_name }}-Linux.deb`（Debian/Ubuntu）或 `CC-Switch-${{ github.ref_name }}-Linux.rpm`（Fedora/RHEL/openSUSE） --- 提示：macOS 如遇"已损坏"提示，可在终端执行：`xattr -cr "/Applications/CC Switch.app"` diff --git a/.gitignore b/.gitignore index 6ed52a498..49a8be783 100644 --- a/.gitignore +++ b/.gitignore @@ -18,3 +18,8 @@ GEMINI.md /.vscode vitest-report.json nul + +# Flatpak build artifacts +flatpak/cc-switch.deb +flatpak-build/ +flatpak-repo/ diff --git a/.node-version b/.node-version index adb070518..d135defb2 100644 --- a/.node-version +++ b/.node-version @@ -1 +1 @@ -v22.4.1 +22.12.0 \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 843f64e67..af37f440b 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -5,6 +5,177 @@ All notable changes to CC Switch will be documented in this file. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). +## [Unreleased] + +--- + +## [3.9.1] - 2026-01-09 + +### Bug Fix Release + +This release focuses on stability improvements and crash prevention. + +### Added + +- **Crash Logging** - Panic hook captures crash info to `~/.cc-switch/crash.log` with full stack traces (#562) +- **Release Logging** - Enable logging for release builds with automatic rotation (keeps 2 most recent files) +- **AIGoCode Icon** - Added colored icon for AIGoCode provider preset + +### Fixed + +- **Proxy Panic Prevention** - Graceful degradation when HTTP client initialization fails due to invalid proxy settings; falls back to no_proxy mode (#560) +- **UTF-8 Safety** - Fix potential panic when masking API keys or truncating logs containing multi-byte characters (Chinese, emoji, etc.) (#560) +- **Default Proxy Port** - Change default port from 5000 to 15721 to avoid conflict with macOS AirPlay Receiver (#560) +- **Windows Title** - Display "CC Switch" instead of default "Tauri app" in window title +- **Windows/Linux Spacing** - Remove extra 28px blank space below native titlebar introduced in v3.9.0 +- **Flatpak Tray Icon** - Bundle libayatana-appindicator for tray icon support on Flatpak (#556) +- **Provider Preset** - Correct casing from "AiGoCode" to "AIGoCode" to match official branding + +--- + +## [3.9.0] - 2026-01-07 + +### Stable Release + +This stable release includes all changes from `3.9.0-1`, `3.9.0-2`, and `3.9.0-3`. + +### Added + +- **Local API Proxy** - High-performance local HTTP proxy for Claude Code, Codex, and Gemini CLI (Axum-based) +- **Per-App Takeover** - Independently route each app through the proxy with automatic live-config backup/redirect +- **Auto Failover** - Circuit breaker + smart failover with independent queues and health tracking per app +- **Universal Provider** - Shared provider configurations that can sync to Claude/Codex/Gemini (ideal for API gateways like NewAPI) +- **Provider Search Filter** - Quick filter to find providers by name (#435) +- **Keyboard Shortcut** - Open settings with Command+comma / Ctrl+comma (#436) +- **Deeplink Usage Config** - Import usage query config via deeplink (#400) +- **Provider Icon Colors** - Customize provider icon colors (#385) +- **Skills Multi-App Support** - Skills now support both Claude Code and Codex (#365) +- **Closable Toasts** - Close button for switch toast and all success toasts (#350) +- **Skip First-Run Confirmation** - Option to skip Claude Code first-run confirmation dialog +- **MCP Import** - Import MCP servers from installed apps +- **Common Config Snippet Extraction** - Extract reusable common config snippets from the current provider or editor content (Claude/Codex/Gemini) +- **Usage Enhancements** - Model extraction, request logging improvements, cache hit/creation metrics, and auto-refresh (#455, #508) +- **Error Request Logging** - Detailed logging for proxy requests (#401) +- **Linux Packaging** - Added RPM and Flatpak packaging targets +- **Provider Presets & Icons** - Added/updated partner presets and icons (e.g., MiMo, DMXAPI, Cubence) + +### Changed + +- **Usage Terminology** - Rename "Cache Read/Write" to "Cache Hit/Creation" across all languages (#508) +- **Model Pricing Data** - Refresh built-in model pricing table (Claude full version IDs, GPT-5 series, Gemini ID formats, and Chinese models) (#508) +- **Proxy Header Forwarding** - Switch to a blacklist approach and improve header passthrough compatibility (#508) +- **Failover Behavior** - Bypass timeout/retry configs when failover is disabled; update default failover timeout and circuit breaker values (#508, #521) +- **Provider Presets** - Update default model versions and change the default Qwen base URL (#517) +- **Skills Management** - Unify Skills management architecture with SSOT + React Query; improve caching for discoverable skills +- **Settings UX** - Reorder items in the Advanced tab for better discoverability +- **Proxy Active Theme** - Apply emerald theme when proxy takeover is active + +### Fixed + +- **Security** - Security fixes for JavaScript executor and usage script (#151) +- **Usage Timezone & Parsing** - Fix datetime picker timezone handling; improve token parsing/billing for Gemini and Codex formats (#508) +- **Windows Compatibility** - Improve MCP export and version check behavior to avoid terminal popups +- **Windows Startup** - Use system titlebar to prevent black screen on startup +- **WebView Compatibility** - Add fallback for crypto.randomUUID() on older WebViews +- **macOS Autostart** - Use `.app` bundle path to prevent terminal window popups +- **Database** - Add missing schema migrations; show an error dialog on initialization failure with a retry option +- **Import/Export** - Restrict SQL import to CC Switch exported backups only; refresh providers immediately after import +- **Prompts** - Allow saving prompts with empty content +- **MCP Sync** - Skip sync when the target CLI app is not installed +- **Common Config (Codex)** - Preserve MCP server `base_url` during extraction and remove provider-specific `model_providers` blocks +- **Proxy** - Improve takeover detection and stability; clean up model override env vars when switching providers in takeover mode (#508) +- **Skills** - Skip hidden directories during discovery; fix wrong skill repo branch +- **Settings Navigation** - Navigate to About tab when clicking update badge +- **UI** - Fix dialogs not opening on first click and improve window dragging area in `FullScreenPanel` + +--- + +## [3.9.0-3] - 2025-12-29 + +### Beta Release + +Third beta release with important bug fixes for Windows compatibility, UI improvements, and new features. + +### Added + +- **Universal Provider** - Support for universal provider configurations (#348) +- **Provider Search Filter** - Quick filter to find providers by name (#435) +- **Keyboard Shortcut** - Open settings with Command+comma / Ctrl+comma (#436) +- **Xiaomi MiMo Icon** - Added MiMo icon and Claude provider configuration (#470) +- **Usage Model Extraction** - Extract model info from usage statistics (#455) +- **Skip First-Run Confirmation** - Option to skip Claude Code first-run confirmation dialog +- **Exit Animations** - Added exit animation to FullScreenPanel dialogs +- **Fade Transitions** - Smooth fade transitions for app/view/panel switching + +### Fixed + +#### Windows +- Wrap npx/npm commands with `cmd /c` for MCP export +- Prevent terminal windows from appearing during version check + +#### macOS +- Use .app bundle path for autostart to prevent terminal window popup + +#### UI +- Resolve Dialog/Modal not opening on first click (#492) +- Improve dark mode text contrast for form labels +- Reduce header spacing and fix layout shift on view switch +- Prevent header layout shift when switching views + +#### Database & Schema +- Add missing base columns migration for proxy_config +- Add backward compatibility check for proxy_config seed insert + +#### Other +- Use local timezone and robust DST handling in usage stats (#500) +- Remove deprecated `sync_enabled_to_codex` call +- Gracefully handle invalid Codex config.toml during MCP sync +- Add missing translations for reasoning model and OpenRouter compat mode + +### Improved + +- **macOS Tray** - Use macOS tray template icon +- **Header Alignment** - Remove macOS titlebar tint, align custom header +- **Shadow Removal** - Cleaner UI by removing shadow styles +- **Code Inspector** - Added code-inspector-plugin for development +- **i18n** - Complete internationalization for usage panel and settings +- **Sponsor Logos** - Made sponsor logos clickable + +### Stats + +- 35 commits since v3.9.0-2 +- 5 files changed in test/lint fixes + +--- + +## [3.9.0-2] - 2025-12-20 + +### Beta Release + +Second beta release focusing on proxy stability, import safety, and provider preset polish. + +### Added + +- **DMXAPI Partner** - Added DMXAPI as an official partner provider preset +- **Provider Icons** - Added provider icons for OpenRouter, LongCat, ModelScope, and AiHubMix + +### Changed + +- **Proxy (OpenRouter)** - Switched OpenRouter to passthrough mode for native Claude API + +### Fixed + +- **Import/Export** - Restrict SQL import to CC Switch exported backups only; refresh providers immediately after import +- **Proxy** - Respect existing Claude token when syncing; add fallback recovery for orphaned takeover state; remove global auto-start flag +- **Windows** - Add minimum window size to Windows platform config +- **UI** - Improve About section UI (#419) and unify header toolbar styling + +### Stats + +- 13 commits since v3.9.0-1 + +--- + ## [3.9.0-1] - 2025-12-18 ### Beta Release @@ -497,8 +668,8 @@ v3.7.0 represents a major evolution from "Provider Switcher" to **"All-in-One AI ### ⚠ Breaking Changes -- Tauri 命令仅接受参数 `app`（取值：`claude`/`codex`）；移除对 `app_type`/`appType` 的兼容。 -- 前端类型命名统一为 `AppId`（移除 `AppType` 导出），变量命名统一为 `appId`。 +- Tauri commands only accept the `app` parameter (`claude`/`codex`); removed `app_type`/`appType` compatibility. +- Frontend types are standardized to `AppId` (removed `AppType` export); variable naming is standardized to `appId`. ### ✨ New Features @@ -741,40 +912,3 @@ For users upgrading from v2.x (Electron version): - Basic provider management - Claude Code integration - Configuration file handling - -## [Unreleased] - -### ⚠️ Breaking Changes - -- **Runtime auto-migration from v1 to v2 config format has been removed** - - `MultiAppConfig::load()` no longer automatically migrates v1 configs - - When a v1 config is detected, the app now returns a clear error with migration instructions - - **Migration path**: Install v3.2.x to perform one-time auto-migration, OR manually edit `~/.cc-switch/config.json` to v2 format - - **Rationale**: Separates concerns (load() should be read-only), fail-fast principle, simplifies maintenance - - Related: `app_config.rs` (v1 detection improved with structural analysis), `app_config_load.rs` (comprehensive test coverage added) - -- **Legacy v1 copy file migration logic has been removed** - - Removed entire `migration.rs` module (435 lines) that handled one-time migration from v3.1.0 to v3.2.0 - - No longer scans/merges legacy copy files (`settings-*.json`, `auth-*.json`, `config-*.toml`) - - No longer archives copy files or performs automatic deduplication - - **Migration path**: Users upgrading from v3.1.0 must first upgrade to v3.2.x to automatically migrate their configurations - - **Benefits**: Improved startup performance (no file scanning), reduced code complexity, cleaner codebase - -- **Tauri commands now only accept `app` parameter** - - Removed legacy `app_type`/`appType` compatibility paths - - Explicit error with available values when unknown `app` is provided - -### 🔧 Improvements - -- Unified `AppType` parsing: centralized to `FromStr` implementation, command layer no longer implements separate `parse_app()`, reducing code duplication and drift -- Localized and user-friendly error messages: returns bilingual (Chinese/English) hints for unsupported `app` values with a list of available options -- Simplified startup logic: Only ensures config structure exists, no migration overhead - -### 🧪 Tests - -- Added unit tests covering `AppType::from_str`: case sensitivity, whitespace trimming, unknown value error messages -- Added comprehensive config loading tests: - - `load_v1_config_returns_error_and_does_not_write` - - `load_v1_with_extra_version_still_treated_as_v1` - - `load_invalid_json_returns_parse_error_and_does_not_write` - - `load_valid_v2_config_succeeds` diff --git a/README.md b/README.md index 6bc7a1b08..28fa4dffb 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ # All-in-One Assistant for Claude Code, Codex & Gemini CLI -[![Version](https://img.shields.io/badge/version-3.8.2-blue.svg)](https://github.com/farion1231/cc-switch/releases) +[![Version](https://img.shields.io/badge/version-3.9.1-blue.svg)](https://github.com/farion1231/cc-switch/releases) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases) [![Built with Tauri](https://img.shields.io/badge/built%20with-Tauri%202-orange.svg)](https://tauri.app/) [![Downloads](https://img.shields.io/endpoint?url=https://api.pinstudios.net/api/badges/downloads/farion1231/cc-switch/total)](https://github.com/farion1231/cc-switch/releases/latest) @@ -15,7 +15,7 @@ English | [中文](README_ZH.md) | [日本語](README_JA.md) | [Changelog](CHANG ## ❤️Sponsor -![Zhipu GLM](assets/partners/banners/glm-en.jpg) +[![Zhipu GLM](assets/partners/banners/glm-en.jpg)](https://z.ai/subscribe?ic=8JVLJQFSKB) This project is sponsored by Z.ai, supporting us with their GLM CODING PLAN.GLM CODING PLAN is a subscription service designed for AI coding, starting at just $3/month. It provides access to their flagship GLM-4.6 model across 10+ popular AI coding tools (Claude Code, Cline, Roo Code, etc.), offering developers top-tier, fast, and stable coding experiences.Get 10% OFF the GLM CODING PLAN with [this link](https://z.ai/subscribe?ic=8JVLJQFSKB)! @@ -23,19 +23,23 @@ This project is sponsored by Z.ai, supporting us with their GLM CODING PLAN.GLM - + - - + + - - + + + + + + +
PackyCodePackyCode Thanks to PackyCode for sponsoring this project! PackyCode is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more. PackyCode provides special discounts for our software users: register using this link and enter the "cc-switch" promo code during recharge to get 10% off.
ShanDianShuoThanks to ShanDianShuo for sponsoring this project! ShanDianShuo is a local-first AI voice input: Millisecond latency, data stays on device, 4x faster than typing, AI-powered correction, Privacy-first, completely free. Doubles your coding efficiency with Claude Code! Free download for Mac/WinAIGoCodeThanks to AIGoCode for sponsoring this project! AIGoCode is an all-in-one platform that integrates Claude Code, Codex, and the latest Gemini models, providing you with stable, efficient, and highly cost-effective AI coding services. The platform offers flexible subscription plans, zero risk of account suspension, direct access with no VPN required, and lightning-fast responses. AIGoCode has prepared a special benefit for CC Switch users: if you register via this link, you'll receive an extra 10% bonus credit on your first top-up!
AIGoCodeThanks to AIGoCode for sponsoring this project! AIGoCode is an all-in-one platform that integrates Claude Code, Codex, and the latest Gemini models, providing you with stable, efficient, and highly cost-effective AI coding services. The platform offers flexible subscription plans, zero risk of account suspension, direct access with no VPN required, and lightning-fast responses.AIGoCode has prepared a special benefit for CC Switch users: if you register via this link, you’ll receive an extra 10% bonus credit on your first top-up! -DMXAPIThanks to DMXAPI for sponsoring this project! DMXAPI provides global large model API services to 200+ enterprise users. One API key for all global models. Features include: instant invoicing, unlimited concurrency, starting from $0.15, 24/7 technical support. GPT/Claude/Gemini all at 32% off, domestic models 20-50% off, Claude Code exclusive models at 66% off! Register here
CubenceThanks to Cubence for sponsoring this project! Cubence is a reliable and efficient API relay service provider, offering relay services for Claude Code, Codex, Gemini, and more with flexible billing options including pay-as-you-go and monthly plans. Cubence provides special discounts for CC Switch users: register using this link and enter the "CCSWITCH" promo code during recharge to get 10% off every top-up!
@@ -48,7 +52,7 @@ This project is sponsored by Z.ai, supporting us with their GLM CODING PLAN.GLM ## Features -### Current Version: v3.8.2 | [Full Changelog](CHANGELOG.md) | [Release Notes](docs/release-note-v3.8.0-en.md) +### Current Version: v3.9.1 | [Full Changelog](CHANGELOG.md) | [Release Notes](docs/release-note-v3.9.0-en.md) **v3.8.0 Major Update (2025-11-28)** @@ -187,7 +191,19 @@ paru -S cc-switch-bin ### Linux Users -Download the latest `CC-Switch-v{version}-Linux.deb` package or `CC-Switch-v{version}-Linux.AppImage` from the [Releases](../../releases) page. +Download the latest Linux build from the [Releases](../../releases) page: + +- `CC-Switch-v{version}-Linux.deb` (Debian/Ubuntu) +- `CC-Switch-v{version}-Linux.rpm` (Fedora/RHEL/openSUSE) +- `CC-Switch-v{version}-Linux.AppImage` (Universal) +- `CC-Switch-v{version}-Linux.flatpak` (Flatpak) + +Flatpak install & run: + +```bash +flatpak install --user ./CC-Switch-v{version}-Linux.flatpak +flatpak run com.ccswitch.desktop +``` ## Quick Start diff --git a/README_JA.md b/README_JA.md index 12853b309..063559cf6 100644 --- a/README_JA.md +++ b/README_JA.md @@ -2,20 +2,20 @@ # Claude Code / Codex / Gemini CLI オールインワン・アシスタント -[![Version](https://img.shields.io/badge/version-3.8.2-blue.svg)](https://github.com/farion1231/cc-switch/releases) +[![Version](https://img.shields.io/badge/version-3.9.1-blue.svg)](https://github.com/farion1231/cc-switch/releases) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases) [![Built with Tauri](https://img.shields.io/badge/built%20with-Tauri%202-orange.svg)](https://tauri.app/) [![Downloads](https://img.shields.io/endpoint?url=https://api.pinstudios.net/api/badges/downloads/farion1231/cc-switch/total)](https://github.com/farion1231/cc-switch/releases/latest) farion1231%2Fcc-switch | Trendshift -[English](README.md) | [中文](README_ZH.md) | 日本語 | [Changelog](CHANGELOG.md) | [v3.8.0 リリースノート](docs/release-note-v3.8.0-en.md) +[English](README.md) | [中文](README_ZH.md) | 日本語 | [Changelog](CHANGELOG.md) | [v3.9.0 リリースノート](docs/release-note-v3.9.0-ja.md) ## ❤️スポンサー -![Zhipu GLM](assets/partners/banners/glm-en.jpg) +[![Zhipu GLM](assets/partners/banners/glm-en.jpg)](https://z.ai/subscribe?ic=8JVLJQFSKB) 本プロジェクトは Z.ai の GLM CODING PLAN による支援を受けています。GLM CODING PLAN は AI コーディング向けのサブスクリプションで、月額わずか 3 ドルから。Claude Code、Cline、Roo Code など 10 以上の人気 AI コーディングツールでフラッグシップモデル GLM-4.6 を利用でき、速く安定した開発体験を提供します。[このリンク](https://z.ai/subscribe?ic=8JVLJQFSKB) から申し込むと 10% オフになります！ @@ -23,20 +23,23 @@ - + - - + + - - + + - + + +
PackyCodePackyCode PackyCode のご支援に感謝します！PackyCode は Claude Code、Codex、Gemini などのリレーサービスを提供する信頼性の高い API 中継プラットフォームです。本ソフト利用者向けに特別割引があります：このリンクで登録し、チャージ時に「cc-switch」クーポンを入力すると 10% オフになります。
ShanDianShuoShanDianShuo のご支援に感謝します！ShanDianShuo はローカルファーストの音声入力ツールで、ミリ秒遅延・データは端末から外に出ず・キーボード入力の 4 倍の速度・AI 自動補正・プライバシー優先で完全無料。Claude Code と組み合わせればコーディング効率が倍増します。Mac/Win 版を無料ダウンロードAIGoCode本プロジェクトは AIGoCode のスポンサー提供でお届けしています。AIGoCode は、Claude Code・Codex・最新の Gemini モデルを統合したオールインワンのAIコーディングプラットフォームで、安定性・高速性・コストパフォーマンスに優れた開発サービスを提供します。柔軟なサブスクリプションプランを備え、レスポンスも非常に高速です。さらに、CC Switch ユーザー向けの特典として、このリンクから登録すると、初回チャージ時に10％分のボーナスクレジットが付与されます！
AIGoCode本プロジェクトは AIGoCode のスポンサー提供でお届けしています。AIGoCode は、Claude Code・Codex・最新の Gemini モデルを統合したオールインワンのAIコーディングプラットフォームで、安定性・高速性・コストパフォーマンスに優れた開発サービスを提供します。柔軟なサブスクリプションプランを備え、レスポンスも非常に高速です。さらに、CC Switch ユーザー向けの特典として、このリンクから登録すると、初回チャージ時に10％分のボーナスクレジットが付与されます！ +DMXAPIDMXAPI のご支援に感謝します！DMXAPI は 200 社以上の企業ユーザーにグローバル大規模モデル API サービスを提供しています。1 つの API キーで全世界のモデルにアクセス可能。即時請求書発行、同時接続数無制限、最低 $0.15 から、24 時間年中無休のテクニカルサポート。GPT/Claude/Gemini が全て 32% オフ、国内モデルは 20〜50% オフ、Claude Code 専用モデルは 66% オフ実施中！登録はこちら
CubenceCubence のご支援に感謝します！Cubence は Claude Code、Codex、Gemini などのリレーサービスを提供する信頼性の高い API 中継プラットフォームで、従量課金や月額プランなど柔軟な料金体系を提供しています。CC Switch ユーザー向けの特別割引：このリンクで登録し、チャージ時に「CCSWITCH」クーポンを入力すると、毎回 10% オフになります！
@@ -49,7 +52,7 @@ ## 特長 -### 現在のバージョン：v3.8.2 | [完全な更新履歴](CHANGELOG.md) | [リリースノート](docs/release-note-v3.8.0-en.md) +### 現在のバージョン：v3.9.1 | [完全な更新履歴](CHANGELOG.md) | [リリースノート](docs/release-note-v3.9.0-ja.md) **v3.8.0 メジャーアップデート (2025-11-28)** @@ -188,7 +191,19 @@ paru -S cc-switch-bin ### Linux ユーザー -[Releases](../../releases) から最新版の `CC-Switch-v{version}-Linux.deb` または `CC-Switch-v{version}-Linux.AppImage` をダウンロード。 +[Releases](../../releases) から最新版の Linux ビルドをダウンロード： + +- `CC-Switch-v{version}-Linux.deb`（Debian/Ubuntu） +- `CC-Switch-v{version}-Linux.rpm`（Fedora/RHEL/openSUSE） +- `CC-Switch-v{version}-Linux.AppImage`（汎用） +- `CC-Switch-v{version}-Linux.flatpak`（Flatpak） + +Flatpak のインストールと起動： + +```bash +flatpak install --user ./CC-Switch-v{version}-Linux.flatpak +flatpak run com.ccswitch.desktop +``` ## クイックスタート diff --git a/README_ZH.md b/README_ZH.md index 167257c7d..a25b86af7 100644 --- a/README_ZH.md +++ b/README_ZH.md @@ -2,20 +2,20 @@ # Claude Code / Codex / Gemini CLI 全方位辅助工具 -[![Version](https://img.shields.io/badge/version-3.8.2-blue.svg)](https://github.com/farion1231/cc-switch/releases) +[![Version](https://img.shields.io/badge/version-3.9.1-blue.svg)](https://github.com/farion1231/cc-switch/releases) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)](https://github.com/farion1231/cc-switch/releases) [![Built with Tauri](https://img.shields.io/badge/built%20with-Tauri%202-orange.svg)](https://tauri.app/) [![Downloads](https://img.shields.io/endpoint?url=https://api.pinstudios.net/api/badges/downloads/farion1231/cc-switch/total)](https://github.com/farion1231/cc-switch/releases/latest) farion1231%2Fcc-switch | Trendshift -[English](README.md) | 中文 | [日本語](README_JA.md) | [更新日志](CHANGELOG.md) | [v3.8.0 发布说明](docs/release-note-v3.8.0-zh.md) +[English](README.md) | 中文 | [日本語](README_JA.md) | [更新日志](CHANGELOG.md) | [v3.9.0 发布说明](docs/release-note-v3.9.0-zh.md) ## ❤️赞助商 -![智谱 GLM](assets/partners/banners/glm-zh.jpg) +[![智谱 GLM](assets/partners/banners/glm-zh.jpg)](https://www.bigmodel.cn/claude-code?ic=RRVJPB5SII) 感谢智谱AI的 GLM CODING PLAN 赞助了本项目！GLM CODING PLAN 是专为AI编码打造的订阅套餐,每月最低仅需20元，即可在十余款主流AI编码工具如 Claude Code、Cline 中畅享智谱旗舰模型 GLM-4.6，为开发者提供顶尖、高速、稳定的编码体验。CC Switch 已经预设了智谱GLM，只需要填写 key 即可一键导入编程工具。智谱AI为本软件的用户提供了特别优惠，使用[此链接](https://www.bigmodel.cn/claude-code?ic=RRVJPB5SII)购买可以享受九折优惠。 @@ -23,19 +23,24 @@ - - + + - - - - - - + + + + + + + + + +
PackyCode感谢 PackyCode 赞助了本项目！PackyCode 是一家稳定、高效的API中转服务商，提供 Claude Code、Codex、Gemini 等多种中转服务。PackyCode 为本软件的用户提供了特别优惠，使用此链接注册并在充值时填写"cc-switch"优惠码，可以享受9折优惠。PackyCode感谢 PackyCode 赞助了本项目！PackyCode 是一家稳定、高效的API中转服务商，提供 Claude Code、Codex、Gemini 等多种中转服务。PackyCode 为本软件的用户提供了特别优惠，使用此链接注册并在充值时填写"cc-switch"优惠码，可以享受9折优惠！
ShanDianShuo感谢闪电说赞助了本项目！闪电说是本地优先的 AI 语音输入法：毫秒级响应，数据不离设备；打字速度提升 4 倍，AI 智能纠错；绝对隐私安全，完全免费，配合 Claude Code 写代码效率翻倍！支持 Mac/Win 双平台，免费下载
AIGoCodeAIGoCode 感谢 AIGoCode 赞助了本项目！AIGoCode 是一个集成了 Claude Code、Codex 以及 Gemini 最新模型的一站式平台，为你提供稳定、高效且高性价比的AI编程服务。本站提供灵活的订阅计划，零封号风险，国内直连，无需魔法，极速响应。AIGoCode 为 CC Switch 的用户提供了特别福利，通过此链接注册的用户首次充值可以获得额外10%奖励额度！
DMXAPI感谢 DMXAPI（大模型API）赞助了本项目！ DMXAPI，一个Key用全球大模型。 +为200多家企业用户提供全球大模型API服务。· 充值即开票 ·当天开票 ·并发不限制 ·1元起充 · 7x24 在线技术辅导，GPT/Claude/Gemini全部6.8折，国内模型5~8折，Claude Code 专属模型3.4折进行中！点击这里注册
Cubence感谢 Cubence 赞助本项目！Cubence 是一家可靠高效的 API 中继服务提供商，提供对 Claude Code、Codex、Gemini 等模型的中继服务，并提供按量、包月等灵活的计费方式。Cubence 为 CC Switch 的用户提供了特别优惠：使用 此链接 注册，并在充值时输入 "CCSWITCH" 优惠码，每次充值均可享受九折优惠！
@@ -47,7 +52,7 @@ ## 功能特性 -### 当前版本：v3.8.2 | [完整更新日志](CHANGELOG.md) +### 当前版本：v3.9.1 | [完整更新日志](CHANGELOG.md) | [发布说明](docs/release-note-v3.9.0-zh.md) **v3.8.0 重大更新（2025-11-28）** @@ -186,7 +191,19 @@ paru -S cc-switch-bin ### Linux 用户 -从 [Releases](../../releases) 页面下载最新版本的 `CC-Switch-v{版本号}-Linux.deb` 包或者 `CC-Switch-v{版本号}-Linux.AppImage` 安装包。 +从 [Releases](../../releases) 页面下载最新版本的 Linux 安装包： + +- `CC-Switch-v{版本号}-Linux.deb`（Debian/Ubuntu） +- `CC-Switch-v{版本号}-Linux.rpm`（Fedora/RHEL/openSUSE） +- `CC-Switch-v{版本号}-Linux.AppImage`（通用） +- `CC-Switch-v{版本号}-Linux.flatpak`（Flatpak） + +Flatpak 安装与运行： + +```bash +flatpak install --user ./CC-Switch-v{版本号}-Linux.flatpak +flatpak run com.ccswitch.desktop +``` ## 快速开始 diff --git a/assets/partners/banners/glm-en.jpg b/assets/partners/banners/glm-en.jpg index 479b3e8a8..bc580bcd3 100644 Binary files a/assets/partners/banners/glm-en.jpg and b/assets/partners/banners/glm-en.jpg differ diff --git a/assets/partners/banners/glm-zh.jpg b/assets/partners/banners/glm-zh.jpg index db318bf26..be1dab61c 100644 Binary files a/assets/partners/banners/glm-zh.jpg and b/assets/partners/banners/glm-zh.jpg differ diff --git a/assets/partners/logos/cubence.png b/assets/partners/logos/cubence.png new file mode 100644 index 000000000..c61f12f61 Binary files /dev/null and b/assets/partners/logos/cubence.png differ diff --git a/assets/partners/logos/dmx-en.jpg b/assets/partners/logos/dmx-en.jpg new file mode 100644 index 000000000..1587fc26e Binary files /dev/null and b/assets/partners/logos/dmx-en.jpg differ diff --git a/assets/partners/logos/dmx-zh.jpeg b/assets/partners/logos/dmx-zh.jpeg new file mode 100644 index 000000000..7b4f5b741 Binary files /dev/null and b/assets/partners/logos/dmx-zh.jpeg differ diff --git a/components.json b/components.json index 6977d86c2..6a4cdb69b 100644 --- a/components.json +++ b/components.json @@ -4,7 +4,7 @@ "rsc": false, "tsx": true, "tailwind": { - "config": "tailwind.config.js", + "config": "tailwind.config.cjs", "css": "src/index.css", "baseColor": "neutral", "cssVariables": true, diff --git a/deplink.html b/deplink.html index eab057c34..a02d8d66c 100644 --- a/deplink.html +++ b/deplink.html @@ -328,361 +328,6 @@
- -
-

Claude Code 供应商

- -
-

- Claude - 基础配置（无模型） -

-

- 最简单的 Claude 配置，仅包含必需参数（API Key、端点等），不指定任何模型，使用 Claude Code 默认值。 -

-
- 必需 resource=provider, app=claude, name, homepage, endpoint, - apiKey
- 可选 notes -
-
- - 📥 导入基础配置 - - -
-
- -
-

- Claude - 带默认模型 -

-

- 设置通用默认模型（ANTHROPIC_MODEL），适用于只需要一个固定模型的场景。 -

-
- 必需 resource=provider, app=claude, name, homepage, endpoint, - apiKey
- 可选 model=claude-haiku-4.1, notes -
-
- - 📥 导入带默认模型 - - -
-
- -
-

- Claude - 完整配置（四种模型） -

-

- 设置所有四种模型字段：默认模型、Haiku 模型、Sonnet 模型、Opus 模型。适用于需要精细控制不同模型系列的场景。 -

-
- 必需 resource=provider, app=claude, name, homepage, endpoint, - apiKey
- 可选 model=claude-sonnet-4.5, - haikuModel=claude-haiku-4.1, sonnetModel=claude-sonnet-4.5, - opusModel=claude-opus-4, notes -
-
- - 📥 导入完整配置 - - -
-
- -
-

- Claude - 部分模型配置 -

-

- 仅设置特定的模型字段（例如只设置 Haiku 和 Sonnet），其他模型使用默认值。演示参数灵活性。 -

-
- 必需 resource=provider, app=claude, name, homepage, endpoint, - apiKey
- 可选 haikuModel=claude-haiku-4.1, - sonnetModel=claude-sonnet-4.5, notes -
-
- - 📥 导入部分模型配置 - - -
-
- -
-

- Claude - 第三方供应商示例 -

-

- 使用第三方供应商的 API 端点和自定义模型名称，演示兼容性。 -

-
- 必需 resource=provider, app=claude, name, homepage, endpoint, - apiKey
- 可选 model=custom-claude-v1, notes -
-
- - 📥 导入第三方供应商 - - -
-
-
- - -
-

Codex 供应商

- -
-

- Codex - 基础配置 -

-

- OpenAI 官方 API 基础配置，仅包含必需参数。 -

-
- 必需 resource=provider, app=codex, name, homepage, endpoint, - apiKey
- 可选 notes -
-
- - 📥 导入基础配置 - - -
-
- -
-

- Codex - 带默认模型 -

-

- OpenAI API 配置，指定默认模型为 gpt-5.1。 -

-
- 必需 resource=provider, app=codex, name, homepage, endpoint, - apiKey
- 可选 model=gpt-5.1, notes -
-
- - 📥 导入 OpenAI Official - - -
-
- -
-

- Codex - Azure OpenAI -

-

- Azure 部署的 OpenAI 服务示例。适合企业用户使用 Azure 云服务。默认模型 gpt-5.1。 -

-
- 必需 resource=provider, app=codex, name, homepage, endpoint, - apiKey
- 可选 model=gpt-5.1, notes -
-
- - 📥 导入 Azure OpenAI - - -
-
- -
-

- Codex - 第三方兼容 API -

-

- 使用兼容 OpenAI API 格式的第三方服务（如 Together AI、Groq 等）。 -

-
- 必需 resource=provider, app=codex, name, homepage, endpoint, - apiKey
- 可选 model=mixtral-8x7b, notes -
-
- - 📥 导入第三方 API - - -
-
-
- - -
-

Gemini 供应商

- -
-

- Gemini - 基础配置 -

-

- Google Gemini 官方 API 基础配置，仅包含必需参数。 -

-
- 必需 resource=provider, app=gemini, name, homepage, endpoint, - apiKey
- 可选 notes -
-
- - 📥 导入基础配置 - - -
-
- -
-

- Gemini - Google Gemini Official -

-

- 导入 Google Gemini 官方 API 配置。默认模型 gemini-3-pro-preview。 -

-
- 必需 resource=provider, app=gemini, name, homepage, endpoint, - apiKey
- 可选 model=gemini-3-pro-preview, notes -
-
- - 📥 导入 Google Gemini - - -
-
- -
-

- Gemini - Gemini 测试环境 -

-

- 公司内部 Gemini 测试环境配置示例。用于验证 Gemini 相关深链接导入流程。默认模型 gemini-3-pro-preview。 -

-
- 必需 resource=provider, app=gemini, name, homepage, endpoint, - apiKey
- 可选 model=gemini-3-pro-preview, notes -
-
- - 📥 导入 Gemini 测试环境 - - -
-
- -
-

- Gemini - 第三方兼容服务 -

-

- 使用第三方提供的 Gemini API 兼容服务，支持自定义模型名称。 -

-
- 必需 resource=provider, app=gemini, name, homepage, endpoint, - apiKey
- 可选 model=gemini-custom-v2, notes -
-
- - 📥 导入第三方服务 - - -
-
-
@@ -848,303 +493,12 @@
- -
-

- Claude - 自动填充示例 -

-

- 仅提供配置文件和名称,其他信息(API Key、端点、官网)自动从配置文件中提取。 -

-
- 必需 name, config
- 自动填充 apiKey, endpoint, homepage (从配置文件提取) -
-
- - 📥 测试自动填充 - - -
-
-
// 解码后的配置内容:
- {
-   "env": {
-     "ANTHROPIC_AUTH_TOKEN": "sk-ant-auto-filled-key",
-     "ANTHROPIC_BASE_URL": "https://api.anthropic.com/v1"
-   }
- }
-
✓ API Key: 从配置文件提取
-
✓ Endpoint: 从配置文件提取
-
✓ Homepage: 自动推断为 https://anthropic.com
-
-
- 自动填充规则:
- • API Key: 从配置文件中提取
- • Endpoint: 从配置文件中提取
- • Homepage: 根据 Endpoint 自动推断 -
-
- - -
-

✨ 配置文件导入新特性 (v3.8+)

- -
- - - -
-

🏢 供应商导入 v3.8+

- -
-

OpenAI 供应商导入 - 导入并立即切换

-

- 导入 OpenAI 供应商配置，并立即设为当前供应商。 -

-
- 必需 resource=provider, app, name, endpoint, homepage, apiKey
- 可选 model, notes, enabled -
-
- 📥 导入 OpenAI (立即切换) - -
- - -
-
🏢 将导入以下供应商配置:
-
• 供应商名称: OpenAI -
-
• 目标应用: Claude
-
• API Endpoint: - https://api.openai.com/v1/chat/completions
-
• 主页: https://openai.com -
-
• 默认模型: gpt-4
-
• enabled=true: - 导入后立即设为当前供应商
-
- 💡 说明: 导入后会自动切换到此供应商，并同步到 Claude live 配置。
- 🔄 效果: Claude 将立即使用新导入的供应商进行对话。
- ⚠️ 注意: 请将 sk-your-key-here 替换为您的真实 API Key。 -
-
-
- -
-

备用供应商导入 - 仅添加不切换

-

- 导入备用供应商配置，但不立即切换，保留当前供应商。 -

-
- 必需 resource=provider, app, name, endpoint, homepage, apiKey
- 可选 model, notes, enabled -
-
- 📥 导入备用供应商 (不切换) - -
- - -
-
🏢 将导入以下供应商配置:
-
• 供应商名称: Backup Provider -
-
• 目标应用: Claude
-
• API Endpoint: - https://api.backup.com/v1/chat/completions
-
• 备注: 备用账号
-
• enabled=false: - 仅添加到列表，不切换
-
- 💡 说明: 供应商会添加到列表中，但不会影响当前正在使用的供应商。
- 🔄 效果: Claude 继续使用原有供应商，新供应商可在需要时手动切换。
- 📋 用途: 适合添加备用供应商、测试新配置等场景。 -
-
-
- -
-

enabled 参数对比

-

- enabled 参数控制导入后是否立即切换到新供应商。 -

- -
-
-

enabled=true ✅

-
    -
  • 立即设为当前供应商
    • -
  • 同步到 live 配置
    • -
  • 同步 MCP 服务器
    • -
  • Claude 立即使用新供应商
    • -
-
- 适用场景：
- • 首次安装主要供应商
- • 从旧设备迁移配置
- • 快速切换到新供应商 -
-
- -
-

enabled=false 或省略 ⏸️

-
    -
  • 仅添加到供应商列表
    • -
  • 不改变当前供应商
    • -
  • 不影响 live 配置
    • -
  • 可随时手动切换
    • -
-
- 适用场景：
- • 添加备用供应商
- • 批量导入多个配置
- • 测试新供应商设置 -
-
-
-

🔌 MCP Servers 导入 v3.8+

-
-

批量导入 - Sequential Thinking MCP Server

-

- 导入 Sequential Thinking MCP 服务器，支持结构化思维推理。 -

-
- 必需 resource=mcp, apps, config (Base64)
- 可选 enabled -
-
- 📥 导入到 Claude & Codex - -
- - -
-
📦 将导入以下 MCP 服务器配置:
-
• 服务器名称: sequential-thinking -
-
• 命令: npx -y - @modelcontextprotocol/server-sequential-thinking
-
• 类型: stdio (标准输入输出)
-
• 目标应用: Claude, Codex
-
- 💡 功能说明: 该 MCP 服务器提供结构化的思维链推理能力，帮助 AI 进行逐步分析和推理。
- 🔄 智能合并: 如果该 MCP 服务器已存在，导入时将只启用对应应用的开关，不会修改服务器的其他配置。 -
-
-
- -
-

导入到单个应用

-

仅导入到指定的单个应用。

-
- 📥 Claude Only - 📥 Codex Only - 📥 Gemini Only -
-
- -
-

📦 JSON 配置示例 - 单个 MCP Server

-

- 使用 JSON 配置导入单个 MCP 服务器 (Context7)。 -

-
- 必需 resource=mcp, apps, config (Base64)
- 可选 enabled -
-
- 📥 导入 Context7 - -
- - -
-
📦 MCP 配置 JSON:
- 
{
-  "mcpServers": {
-    "context7": {
-      "command": "bunx",
-      "args": [
-        "-y",
-        "@upstash/context7-mcp",
-        "--api-key",
-        "ctx7sk-4ddd4f66-e752-4022-b1f6-c8cf6279b80d"
-      ],
-      "env": {}
-    }
-  }
-}
-
- 💡 说明: Context7 是一个 MCP 服务器，需要 API Key。
- 🔧 命令: 使用 bunx 运行 @upstash/context7-mcp
- 🎯 目标应用: Claude -
-
-
-

📦📦 JSON 配置示例 - 批量导入多个 MCP Servers

@@ -1230,60 +584,6 @@

- -
-

Codex 代码优化助手

-

为 Codex 导入代码优化提示词。

-
- 📥 导入 - -
- - -
-
📝 Prompt 内容:
-
# 代码优化助手 - - 你是一位代码优化专业的助手。
-
- • 应用: Codex
- • 描述: 提升代码性能
- • 状态: 导入后立即启用 -
-
-
- -
-

Gemini 架构设计师

-

为 Gemini 导入架构设计提示词。

-
- 📥 导入 - -
- - -
-
📝 Prompt 内容:
-
# 架构设计师 - - 你是专业架构设计专业的专家。
-
- • 应用: Gemini
- • 描述: 系统架构专家
- • 状态: 导入后立即启用 -
-
-
@@ -1336,77 +636,6 @@

填写参数信息，自动生成深链接并导入到 CC Switch

- - -
-

🏢 供应商导入生成器

- -
- - -
- -
- - -
- -
- - - 您的 API 密钥 -
- -
- - - 完整的 API 端点 URL -
- -
- - -
- -
- - - 可选，留空使用系统默认 -
- -
- - -
- -
- - -
- - - - -
-

🔌 MCP Servers 导入生成器

@@ -1702,6 +931,17 @@
+ + 主 API 端点地址 + +
+ +
+ + + + 多个备用端点用逗号分隔，导入后自动添加为自定义端点 +
@@ -1820,6 +1060,79 @@
+ +
+

+ 📊 用量查询配置（v3.9+，可选） +

+

+ 配置用量查询脚本，可自动查询 API 余额 +

+ +
+ + +
+ +
+ + + + 用量查询接口的基础地址，必须与脚本中的请求 URL 同源 + +
+ +
+ + +
+ +
+ + + + 支持模板变量：{{baseUrl}}、{{apiKey}}、{{accessToken}}、{{userId}} + +
+ +
+ + + + 0 表示禁用自动查询 + +
+ +
+ + +
+ +
+ + +
+
+