docs: enhance download section with detailed installation guide for v3.9.0

- Convert system requirements to table format with architecture info - Add Windows/macOS file descriptions with recommended options - Replace Linux section with comprehensive distro-based table - Include complete installation commands for deb/rpm/AppImage/flatpak - Add helpful tips for macOS Gatekeeper and AppImage usage
2026-05-16 17:59:32 +08:00 · 2026-01-08 15:37:07 +08:00
parent 75d512b36c
commit e9fc56525d
3 changed files with 99 additions and 24 deletions
@@ -133,19 +133,44 @@ It introduces a local API proxy with per-app takeover, automatic failover, unive

 ## Download & Installation

+Visit [Releases](https://github.com/farion1231/cc-switch/releases/latest) to download the appropriate version.
+
 ### System Requirements

- **Windows**: Windows 10 +
- **MacOS**: MacOS 10.15 (Catalina) +
- **Linux**: Ubuntu 22.04 + | Debian 11 + | Fedora 34 +
+| 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 |

-### Download Links
+### Windows

-Visit [Releases](https://github.com/farion1231/cc-switch/releases/latest) to download:
+| File | Description |
+|------|-------------|
+| `CC-Switch-v3.9.0-Windows.msi` | **Recommended** - MSI installer with auto-update support |
+| `CC-Switch-v3.9.0-Windows-Portable.zip` | Portable version, no installation required |

- **Windows**: `CC-Switch-v3.9.0-Windows.msi` or `-Portable.zip`
- **MacOS**: `CC-Switch-v3.9.0-macOS.tar.gz` or `.zip`
- **Linux**: `CC-Switch-v3.9.0-Linux.AppImage` or `.deb`
+### macOS
+
+| File | Description |
+|------|-------------|
+| `CC-Switch-v3.9.0-macOS.zip` | **Recommended** - Extract and drag to Applications, Universal Binary |
+| `CC-Switch-v3.9.0-macOS.tar.gz` | For Homebrew installation and auto-update |
+
+> **Tip**: If you see "app is damaged" on macOS, run in Terminal: `xattr -cr "/Applications/CC Switch.app"`
+
+### Linux
+
+| Distribution | Recommended Format | Installation |
+|--------------|-------------------|--------------|
+| 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` | Make executable and run directly, or use AUR |
+| Other distros / Unsure | `.AppImage` | `chmod +x CC-Switch-*.AppImage && ./CC-Switch-*.AppImage` |
+| Sandboxed installation | `.flatpak` | `flatpak install CC-Switch-*.flatpak` |
+
+> **Tip**: AppImage supports auto-update and works across all distributions. Recommended if you're unsure which format to choose.

 ### Homebrew (MacOS)

@@ -133,19 +133,44 @@ CC Switch v3.9.0 は v3.9 ベータ（`3.9.0-1`、`3.9.0-2`、`3.9.0-3`）の安

 ## ダウンロード & インストール

+[Releases](https://github.com/farion1231/cc-switch/releases/latest) から該当するバージョンをダウンロードしてください。
+
 ### システム要件

- **Windows**: Windows 10 +
- **MacOS**: MacOS 10.15 (Catalina) +
- **Linux**: Ubuntu 22.04 + | Debian 11 + | Fedora 34 +
+| システム | 最低バージョン | アーキテクチャ |
+|----------|----------------|----------------|
+| Windows | Windows 10 以降 | x64 |
+| macOS | macOS 10.15 (Catalina) 以降 | Intel (x64) / Apple Silicon (arm64) |
+| Linux | 下表参照 | x64 |

-### ダウンロード
+### Windows

-[Releases](https://github.com/farion1231/cc-switch/releases/latest) から入手:
+| ファイル | 説明 |
+|----------|------|
+| `CC-Switch-v3.9.0-Windows.msi` | **推奨** - MSI インストーラー、自動更新対応 |
+| `CC-Switch-v3.9.0-Windows-Portable.zip` | ポータブル版、インストール不要 |

- **Windows**: `CC-Switch-v3.9.0-Windows.msi` または `-Portable.zip`
- **MacOS**: `CC-Switch-v3.9.0-macOS.tar.gz` または `.zip`
- **Linux**: `CC-Switch-v3.9.0-Linux.AppImage` または `.deb`
+### macOS
+
+| ファイル | 説明 |
+|----------|------|
+| `CC-Switch-v3.9.0-macOS.zip` | **推奨** - 解凍して Applications へドラッグ、Universal Binary |
+| `CC-Switch-v3.9.0-macOS.tar.gz` | Homebrew インストールおよび自動更新用 |
+
+> **ヒント**: macOS で「このアプリは破損しています」と表示された場合は、ターミナルで `xattr -cr "/Applications/CC Switch.app"` を実行してください。
+
+### 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` |
+| サンドボックスで実行したい場合 | `.flatpak` | `flatpak install CC-Switch-*.flatpak` |
+
+> **ヒント**: AppImage は自動更新に対応し、どのディストリビューションでも動作します。迷ったときは AppImage がおすすめです。

 ### Homebrew (MacOS)

@@ -133,19 +133,44 @@ CC Switch v3.9.0 是 v3.9 测试版序列（`3.9.0-1`、`3.9.0-2`、`3.9.0-3`）

 ## 下载与安装

+访问 [Releases](https://github.com/farion1231/cc-switch/releases/latest) 下载对应版本。
+
 ### 系统要求

- **Windows**：Windows 10 +
- **MacOS**：MacOS 10.15 (Catalina) +
- **Linux**：Ubuntu 22.04 + | Debian 11 + | Fedora 34 +
+| 系统 | 最低版本 | 架构 |
+|------|----------|------|
+| Windows | Windows 10 及以上 | x64 |
+| macOS | macOS 10.15 (Catalina) 及以上 | Intel (x64) / Apple Silicon (arm64) |
+| Linux | 见下表 | x64 |

-### 下载链接
+### Windows

-访问 [Releases](https://github.com/farion1231/cc-switch/releases/latest) 下载：
+| 文件 | 说明 |
+|------|------|
+| `CC-Switch-v3.9.0-Windows.msi` | **推荐** - MSI 安装包，支持自动更新 |
+| `CC-Switch-v3.9.0-Windows-Portable.zip` | 便携版，解压即用，不写入注册表 |

- **Windows**：`CC-Switch-v3.9.0-Windows.msi` 或 `-Portable.zip`
- **MacOS**：`CC-Switch-v3.9.0-macOS.tar.gz` 或 `.zip`
- **Linux**：`CC-Switch-v3.9.0-Linux.AppImage` 或 `.deb`
+### macOS
+
+| 文件 | 说明 |
+|------|------|
+| `CC-Switch-v3.9.0-macOS.zip` | **推荐** - 解压后拖入 Applications 即可，Universal Binary |
+| `CC-Switch-v3.9.0-macOS.tar.gz` | 用于 Homebrew 安装和自动更新 |
+
+> **提示**：macOS 如遇"已损坏"提示，可在终端执行：`xattr -cr "/Applications/CC Switch.app"`
+
+### 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` |
+| 沙箱隔离需求 | `.flatpak` | `flatpak install CC-Switch-*.flatpak` |
+
+> **提示**：AppImage 支持自动更新，跨发行版通用，推荐不确定使用哪种格式时选择。

 ### Homebrew（MacOS）