diff --git a/docs/release-note-v3.10.0-en.md b/docs/release-note-v3.10.0-en.md new file mode 100644 index 00000000..e7a2117b --- /dev/null +++ b/docs/release-note-v3.10.0-en.md @@ -0,0 +1,206 @@ +# CC Switch v3.10.0 + +> OpenCode Support, Global Proxy, Claude Rectifier & Multi-App Experience Enhancements + +**[中文版 →](release-note-v3.10.0-zh.md) | [日本語版 →](release-note-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` | diff --git a/docs/release-note-v3.10.0-ja.md b/docs/release-note-v3.10.0-ja.md new file mode 100644 index 00000000..081e17c3 --- /dev/null +++ b/docs/release-note-v3.10.0-ja.md @@ -0,0 +1,206 @@ +# CC Switch v3.10.0 + +> OpenCode サポート、グローバルプロキシ、Claude Rectifier とマルチアプリ体験の強化 + +**[中文版 →](release-note-v3.10.0-zh.md) | [English →](release-note-v3.10.0-en.md)** + +--- + +## 概要 + +CC Switch v3.10.0 では OpenCode サポートが追加され、4番目の管理対象 CLI アプリケーションとなりました。 +また、グローバルプロキシ設定、Claude Rectifier（thinking 署名修正機能）、ヘルスチェックの強化、プロバイダー別設定など、多くの重要な機能が追加され、マルチアプリワークフローとターミナル体験が全面的に改善されました。 + +**リリース日**: 2026-01-21 + +--- + +## ハイライト + +- OpenCode サポート：プロバイダー、MCP サーバー、Skills の完全管理、初回起動時の自動インポート +- グローバルプロキシ：すべての送信ネットワークリクエストに統一プロキシを設定 +- Claude Rectifier：thinking 署名修正機能、サードパーティ API との互換性向上 +- ヘルスチェック強化：カスタムプロンプト設定、CLI 互換リクエスト形式 +- プロバイダー別設定：プロバイダー固有の設定の永続化をサポート +- アプリ表示制御：アプリの表示/非表示を自由に設定、トレイメニューと同期 +- ターミナル改善：プロバイダー専用ターミナルボタン、fnm パスサポート、クロスプラットフォーム安全起動 +- WSL ツール検出：WSL 環境でのツールバージョン検出とセキュリティ強化 + +--- + +## 主な機能 + +### OpenCode サポート（新しい4番目のアプリ） + +- 完全な OpenCode プロバイダー管理：追加、編集、切り替え、削除 +- MCP サーバー管理：Claude/Codex/Gemini と統一されたアーキテクチャ +- Skills サポート：OpenCode でも Skills 機能を使用可能 +- 初回起動時の自動インポート：既存の OpenCode 設定を検出すると自動的にインポート +- 完全な国際化：中国語/英語/日本語サポート (#695) + +### グローバルプロキシ + +- すべての送信ネットワークリクエストに統一プロキシを設定 (#596、@yovinchen に感謝) +- HTTP/HTTPS プロキシプロトコルをサポート +- 外部 API へのプロキシアクセスが必要なネットワーク環境に適用 + +### Claude Rectifier（Thinking 署名修正機能） + +- Claude API の thinking 署名を自動修正 (#595、@yovinchen に感謝) +- 一部のサードパーティ API ゲートウェイが返す互換性のない thinking ブロック形式を解決 +- 詳細設定で有効/無効を切り替え可能 + +### ヘルスチェック強化 + +- ストリーミングヘルスチェック用のカスタムプロンプトを設定可能 (#623、@yovinchen に感謝) +- CLI 互換リクエスト形式をサポートし、実際の使用シナリオをより良くシミュレート +- 障害検出の精度を向上 + +### プロバイダー別設定 + +- 各プロバイダーごとに設定を個別に保存可能 (#663、@yovinchen に感謝) +- 設定の永続化：再起動後もプロバイダー固有の設定を保持 +- 異なるプロバイダーに異なる設定が必要なシナリオに適用 + +### アプリ表示制御 + +- 任意のアプリを自由に表示/非表示（Gemini はデフォルトで非表示） +- トレイメニューは表示設定と自動的に同期 +- 非表示のアプリはメインインターフェースとトレイメニューに表示されない + +### Takeover コンパクトモード + +- 3つ以上の表示アプリがある場合、自動的にコンパクトレイアウトを使用 +- マルチアプリシナリオでのスペース利用を最適化 + +### ターミナル改善 + +- プロバイダー専用ターミナルボタン：ワンクリックでターミナルで現在のプロバイダーを使用 (#564、@kkkman22 に感謝) +- `fnm` パスサポート：fnm で管理された Node.js パスを自動認識 +- クロスプラットフォーム安全起動：Windows/macOS/Linux のターミナル起動ロジックを改善 + +### WSL ツール検出 + +- WSL 環境でツールバージョンを検出 (#627、@yovinchen に感謝) +- コマンドインジェクションリスクを防ぐためのセキュリティ強化を追加 + +### Skills プリセット強化 + +- `baoyu-skills` プリセットリポジトリを追加 +- 不足しているデフォルトリポジトリを自動補完し、すぐに使える状態を確保 + +--- + +## 体験の改善 + +- キーボードショートカット：`ESC` を押してパネルをすばやく戻る/閉じる (#670、@xxk8 に感謝) +- プロキシログの簡素化：より明確で読みやすい出力 (#585、@yovinchen に感謝) +- 価格エディター UX：統一された `FullScreenPanel` スタイル +- 詳細設定レイアウト：Rectifier セクションを Failover の下に移動し、論理的な流れを改善 +- OpenRouter 互換モード：デフォルトで無効、UI トグルを非表示（煩雑さを軽減） + +--- + +## バグ修正 + +### プロキシとフェイルオーバー + +- 自動フェイルオーバーが有効な場合、すぐに P1 に切り替え（次のリクエストを待たずに） + +### プロバイダー管理 + +- 保存後にプロバイダー編集ダイアログを再度開いたときにデータが古い問題を修正 (#654、@YangYongAn に感謝) +- プリセット切り替え時に baseUrl と apiKey の状態がリセットされない問題を修正 +- エンドポイント自動選択状態が永続化されない問題を修正 (#611、@yovinchen に感謝) +- アイコンカラーが設定されていない場合、デフォルトカラーを自動適用 + +### ディープリンク + +- マルチエンドポイントインポートをサポート (#597、@yovinchen に感謝) +- `GEMINI_BASE_URL` より `GOOGLE_GEMINI_BASE_URL` を優先 + +### MCP + +- WSL ターゲットパスの `cmd /c` ラッパーをスキップ (#592、@cxyfer に感謝) + +### 使用量テンプレート + +- 変数ヒントを追加、検証の問題を修正 (#628、@YangYongAn に感謝) +- プロバイダー間での設定漏洩を防止 +- 使用量ブロックのオフセットがアクションボタンの幅に自動適応 (#613、@yovinchen に感謝) + +### Gemini + +- タイムアウトパラメータを Gemini CLI 形式に変換 (#580、@cxyfer に感謝) + +### UI + +- `FullScreenPanel` での Select ドロップダウンのレンダリング問題を修正 + +--- + +## 注意事項 + +- **OpenCode は新しくサポートされたアプリです**：関連機能を使用するには、まず OpenCode CLI をインストールする必要があります。 +- **グローバルプロキシはすべての送信リクエストに影響します**：使用量クエリ、ヘルスチェックなどのネットワーク操作を含みます。 +- **Rectifier は実験的機能です**：問題が発生した場合は、詳細設定で無効にできます。 + +--- + +## 特別な感謝 + +@yovinchen @YangYongAn @cxyfer @xxk8 @kkkman22 @Shuimo03 の皆様、このリリースへの貢献に感謝します！ +@libukai 様、エレガントなフェイルオーバー関連 UI のデザインに感謝します！ + +--- + +## ダウンロードとインストール + +[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.10.0-Windows.msi` | **推奨** - MSI インストーラー、自動更新対応 | +| `CC-Switch-v3.10.0-Windows-Portable.zip` | ポータブル版、解凍して実行、レジストリ書き込みなし | + +### macOS + +| ファイル | 説明 | +| -------------------------------- | ----------------------------------------------------------------- | +| `CC-Switch-v3.10.0-macOS.zip` | **推奨** - 解凍して Applications にドラッグ、Universal Binary | +| `CC-Switch-v3.10.0-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` | diff --git a/docs/release-note-v3.10.0-zh.md b/docs/release-note-v3.10.0-zh.md new file mode 100644 index 00000000..4df403de --- /dev/null +++ b/docs/release-note-v3.10.0-zh.md @@ -0,0 +1,206 @@ +# CC Switch v3.10.0 + +> OpenCode 支持、全局代理、Claude Rectifier 与多应用体验增强 + +**[English →](release-note-v3.10.0-en.md) | [日本語版 →](release-note-v3.10.0-ja.md)** + +--- + +## 概览 + +CC Switch v3.10.0 新增 OpenCode 支持，成为第四个受管理的 CLI 应用。 +同时带来全局代理设置、Claude Rectifier（thinking 签名修正器）、健康检查增强、按供应商配置等多项重要功能，并对多应用工作流与终端体验做了全面改进。 + +**发布日期**：2026-01-21 + +--- + +## 重点内容 + +- OpenCode 支持：供应商、MCP 服务器、Skills 全面管理，首次启动自动导入 +- 全局代理：为出站网络请求统一配置代理 +- Claude Rectifier：thinking 签名修正器，兼容更多第三方 API +- 健康检查增强：可配置提示词、CLI 兼容请求 +- 按供应商配置：支持供应商特定配置的持久化 +- 应用可见性控制：自由显示/隐藏应用，托盘菜单同步更新 +- 终端改进：供应商专属终端按钮、fnm 路径支持、跨平台安全启动 +- WSL 工具检测：在 WSL 环境检测工具版本，并增加安全加固 + +--- + +## 主要功能 + +### OpenCode 支持（新增第四应用） + +- 完整的 OpenCode 供应商管理：新增、编辑、切换、删除 +- MCP 服务器管理：与 Claude/Codex/Gemini 统一架构 +- Skills 支持：OpenCode 也可使用 Skills 功能 +- 首次启动自动导入：检测到已有 OpenCode 配置时自动导入 +- 完整国际化：中/英/日三语支持（#695） + +### 全局代理（Global Proxy） + +- 为所有出站网络请求配置统一代理（#596，感谢 @yovinchen） +- 支持 HTTP/HTTPS 代理协议 +- 适用于需要代理访问外部 API 的网络环境 + +### Claude Rectifier（Thinking 签名修正器） + +- 自动修正 Claude API 的 thinking 签名（#595，感谢 @yovinchen） +- 解决部分第三方 API 网关返回的 thinking 块格式不兼容问题 +- 在高级设置中可开启/关闭 + +### 健康检查增强 + +- 可配置自定义提示词（prompt）用于流式健康检查（#623，感谢 @yovinchen） +- 支持 CLI 兼容请求格式，更好地模拟真实使用场景 +- 提升故障检测的准确性 + +### 按供应商配置（Per-Provider Config） + +- 支持为每个供应商单独保存配置（#663，感谢 @yovinchen） +- 配置持久化：重启后保留供应商专属设置 +- 适用于不同供应商需要不同配置的场景 + +### 应用可见性控制 + +- 自由显示/隐藏任意应用（Gemini 默认隐藏） +- 托盘菜单自动同步可见性设置 +- 隐藏的应用不会出现在主界面和托盘菜单中 + +### Takeover Compact Mode + +- 当显示 3 个及以上可见应用时，自动使用紧凑布局 +- 优化多应用场景下的空间利用 + +### 终端改进 + +- 供应商专属终端按钮：一键在终端中使用当前供应商（#564，感谢 @kkkman22） +- `fnm` 路径支持：自动识别 fnm 管理的 Node.js 路径 +- 跨平台安全启动：改进 Windows/macOS/Linux 的终端启动逻辑 + +### WSL 工具检测 + +- 在 WSL 环境中检测工具版本（#627，感谢 @yovinchen） +- 增加安全加固，防止命令注入风险 + +### Skills 预设增强 + +- 新增 `baoyu-skills` 预设仓库 +- 自动补充缺失的默认仓库，确保开箱即用 + +--- + +## 体验优化 + +- 键盘快捷键：按 `ESC` 快速返回/关闭面板（#670，感谢 @xxk8） +- 代理日志简化：输出更清晰易读（#585，感谢 @yovinchen） +- 定价编辑器 UX：统一使用 `FullScreenPanel` 风格 +- 高级设置布局：Rectifier 区块移至 Failover 下方，逻辑更顺畅 +- OpenRouter 兼容模式：默认禁用，UI 开关隐藏（减少干扰） + +--- + +## Bug 修复 + +### 代理与故障切换 + +- 启用自动故障切换时立即切换到 P1（而非等待下次请求） + +### 供应商管理 + +- 修复供应商编辑对话框保存后重新打开时数据过时的问题（#654，感谢 @YangYongAn） +- 修复切换预设时 baseUrl 和 apiKey 状态未重置的问题 +- 修复端点自动选择状态未持久化的问题（#611，感谢 @yovinchen） +- 未设置图标颜色时自动应用默认颜色 + +### 深链接 + +- 支持多端点导入（#597，感谢 @yovinchen） +- 优先使用 `GOOGLE_GEMINI_BASE_URL` 而非 `GEMINI_BASE_URL` + +### MCP + +- WSL 目标路径跳过 `cmd /c` 包裹（#592，感谢 @cxyfer） + +### 用量模板 + +- 新增变量提示，修复验证问题（#628，感谢 @YangYongAn） +- 防止配置在供应商之间泄漏 +- 用量区块偏移量根据操作按钮宽度自动适应（#613，感谢 @yovinchen） + +### Gemini + +- 超时参数转换为 Gemini CLI 格式（#580，感谢 @cxyfer） + +### UI + +- 修复 `FullScreenPanel` 中 Select 下拉框渲染问题 + +--- + +## 说明与注意事项 + +- **OpenCode 为新支持的应用**：需要先安装 OpenCode CLI 才能使用相关功能。 +- **全局代理会影响所有出站请求**：包括用量查询、健康检查等网络操作。 +- **Rectifier 功能为实验性**：如遇问题可在高级设置中关闭。 + +--- + +## 特别感谢 + +感谢 @yovinchen @YangYongAn @cxyfer @xxk8 @kkkman22 @Shuimo03 为本版本做出的贡献！ +感谢 @libukai 设计的故障转移相关 UI，非常优雅！ + +--- + +## 下载与安装 + +访问 [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.10.0-Windows.msi` | **推荐** - MSI 安装包，支持自动更新 | +| `CC-Switch-v3.10.0-Windows-Portable.zip` | 便携版，解压即用，不写入注册表 | + +### macOS + +| 文件 | 说明 | +| -------------------------------- | --------------------------------------------------------- | +| `CC-Switch-v3.10.0-macOS.zip` | **推荐** - 解压后拖入 Applications 即可，Universal Binary | +| `CC-Switch-v3.10.0-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` |