From 48db113b3789a3201f81c400a025dd9627bd7651 Mon Sep 17 00:00:00 2001 From: Jason Date: Thu, 8 Jan 2026 16:36:45 +0800 Subject: [PATCH] docs: update v3.9.0 release notes with acknowledgments and improved macOS instructions - Add special thanks section for contributors @xunyu @deijing @su-fen - Update macOS tip: replace xattr command with System Settings GUI guidance - Reformat markdown tables with aligned columns - Move Linux section after Homebrew section --- docs/release-note-v3.9.0-en.md | 56 ++++++++++++++++++---------------- docs/release-note-v3.9.0-ja.md | 56 ++++++++++++++++++---------------- docs/release-note-v3.9.0-zh.md | 56 +++++++++++++++++----------------- 3 files changed, 86 insertions(+), 82 deletions(-) diff --git a/docs/release-note-v3.9.0-en.md b/docs/release-note-v3.9.0-en.md index b9b79ac2..1614f7b6 100644 --- a/docs/release-note-v3.9.0-en.md +++ b/docs/release-note-v3.9.0-en.md @@ -131,46 +131,37 @@ It introduces a local API proxy with per-app takeover, automatic failover, unive - SQL import is restricted to CC Switch exported backups to reduce the risk of importing unsafe or incompatible SQL dumps. - Proxy takeover modifies CLI live configs; CC Switch will back up the live config before redirecting it to the local proxy. If you want to revert, disable takeover/stop the proxy and restore from the backup when needed. +## Special Thanks + +Special thanks to @xunyu @deijing @su-fen for their support and contributions. This release wouldn't be possible without you! + ## 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 | +| 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.9.0-Windows.msi` | **Recommended** - MSI installer with auto-update support | -| `CC-Switch-v3.9.0-Windows-Portable.zip` | Portable version, no installation required | +| 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 | ### 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 | +| 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. +> **Note**: Since the author does not have an Apple Developer account, you may see an "unidentified developer" warning on first launch. Close the app, then go to "System Settings" → "Privacy & Security" → click "Open Anyway", and it will open normally afterwards. ### Homebrew (MacOS) @@ -184,3 +175,14 @@ Update: ```bash brew upgrade --cask cc-switch ``` + +### 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` | diff --git a/docs/release-note-v3.9.0-ja.md b/docs/release-note-v3.9.0-ja.md index e7ce995a..7fa1b9cf 100644 --- a/docs/release-note-v3.9.0-ja.md +++ b/docs/release-note-v3.9.0-ja.md @@ -131,46 +131,37 @@ CC Switch v3.9.0 は v3.9 ベータ（`3.9.0-1`、`3.9.0-2`、`3.9.0-3`）の安 - SQL インポートは CC Switch がエクスポートしたバックアップのみに制限されます（安全性のため）。 - プロキシのテイクオーバーは CLI の live 設定を変更します。CC Switch はリダイレクト前に live 設定をバックアップします。元に戻す場合はテイクオーバー無効化/プロキシ停止を行い、必要に応じてバックアップから復元してください。 +## 特別な謝辞 + +@xunyu @deijing @su-fen の皆様のサポートと貢献に特別な感謝を申し上げます。皆様なしではこのリリースは実現しませんでした！ + ## ダウンロード & インストール [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 | Windows 10 以降 | x64 | +| macOS | macOS 10.15 (Catalina) 以降 | Intel (x64) / Apple Silicon (arm64) | +| Linux | 下表参照 | x64 | ### Windows -| ファイル | 説明 | -|----------|------| -| `CC-Switch-v3.9.0-Windows.msi` | **推奨** - MSI インストーラー、自動更新対応 | -| `CC-Switch-v3.9.0-Windows-Portable.zip` | ポータブル版、インストール不要 | +| ファイル | 説明 | +| --------------------------------------- | -------------------------------------------- | +| `CC-Switch-v3.9.0-Windows.msi` | **推奨** - MSI インストーラー、自動更新対応 | +| `CC-Switch-v3.9.0-Windows-Portable.zip` | ポータブル版、インストール不要 | ### macOS -| ファイル | 説明 | -|----------|------| -| `CC-Switch-v3.9.0-macOS.zip` | **推奨** - 解凍して Applications へドラッグ、Universal Binary | -| `CC-Switch-v3.9.0-macOS.tar.gz` | Homebrew インストールおよび自動更新用 | +| ファイル | 説明 | +| ------------------------------- | ----------------------------------------------------------------- | +| `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 がおすすめです。 +> **注意**: 作者が Apple Developer アカウントを持っていないため、初回起動時に「開発元が未確認」という警告が表示される場合があります。アプリを閉じてから、「システム設定」→「プライバシーとセキュリティ」→「このまま開く」をクリックすると、正常に開けるようになります。 ### Homebrew (MacOS) @@ -184,3 +175,14 @@ 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` | +| サンドボックスで実行したい場合 | `.flatpak` | `flatpak install CC-Switch-*.flatpak` | diff --git a/docs/release-note-v3.9.0-zh.md b/docs/release-note-v3.9.0-zh.md index 5ac312a5..9d13fa05 100644 --- a/docs/release-note-v3.9.0-zh.md +++ b/docs/release-note-v3.9.0-zh.md @@ -131,46 +131,37 @@ CC Switch v3.9.0 是 v3.9 测试版序列（`3.9.0-1`、`3.9.0-2`、`3.9.0-3`） - 为降低导入风险，SQL 导入被限制为仅允许导入 CC Switch 自己导出的备份。 - Proxy 接管会修改 CLI 的 live 配置；CC Switch 会在重定向前自动备份 live 配置。如需回退，可关闭接管/停止代理，并在必要时从备份恢复。 +## 特别感谢 + +特别感谢 @xunyu @deijing @su-fen 做出的支持和贡献，没有你们就没有这个版本！ + ## 下载与安装 访问 [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 | Windows 10 及以上 | x64 | +| macOS | macOS 10.15 (Catalina) 及以上 | Intel (x64) / Apple Silicon (arm64) | +| Linux | 见下表 | x64 | ### Windows -| 文件 | 说明 | -|------|------| -| `CC-Switch-v3.9.0-Windows.msi` | **推荐** - MSI 安装包，支持自动更新 | -| `CC-Switch-v3.9.0-Windows-Portable.zip` | 便携版，解压即用，不写入注册表 | +| 文件 | 说明 | +| --------------------------------------- | ----------------------------------- | +| `CC-Switch-v3.9.0-Windows.msi` | **推荐** - MSI 安装包，支持自动更新 | +| `CC-Switch-v3.9.0-Windows-Portable.zip` | 便携版，解压即用，不写入注册表 | ### macOS -| 文件 | 说明 | -|------|------| -| `CC-Switch-v3.9.0-macOS.zip` | **推荐** - 解压后拖入 Applications 即可，Universal Binary | -| `CC-Switch-v3.9.0-macOS.tar.gz` | 用于 Homebrew 安装和自动更新 | +| 文件 | 说明 | +| ------------------------------- | --------------------------------------------------------- | +| `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） @@ -185,4 +176,13 @@ brew install --cask cc-switch 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` | +| 沙箱隔离需求 | `.flatpak` | `flatpak install CC-Switch-*.flatpak` |