From e9fc56525d387d73763ac9e7b031f1049e9e05d7 Mon Sep 17 00:00:00 2001 From: Jason Date: Thu, 8 Jan 2026 15:37:07 +0800 Subject: [PATCH] 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 --- docs/release-note-v3.9.0-en.md | 41 +++++++++++++++++++++++++++------- docs/release-note-v3.9.0-ja.md | 41 +++++++++++++++++++++++++++------- docs/release-note-v3.9.0-zh.md | 41 +++++++++++++++++++++++++++------- 3 files changed, 99 insertions(+), 24 deletions(-) diff --git a/docs/release-note-v3.9.0-en.md b/docs/release-note-v3.9.0-en.md index e068ad0ef..b9b79ac24 100644 --- a/docs/release-note-v3.9.0-en.md +++ b/docs/release-note-v3.9.0-en.md @@ -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) diff --git a/docs/release-note-v3.9.0-ja.md b/docs/release-note-v3.9.0-ja.md index 34231c1c7..e7ce995a3 100644 --- a/docs/release-note-v3.9.0-ja.md +++ b/docs/release-note-v3.9.0-ja.md @@ -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) diff --git a/docs/release-note-v3.9.0-zh.md b/docs/release-note-v3.9.0-zh.md index a16f74f9c..5ac312a52 100644 --- a/docs/release-note-v3.9.0-zh.md +++ b/docs/release-note-v3.9.0-zh.md @@ -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）