fix(packaging): add CPU and GPU installer variants

- Matrix build in packaging.yml for CPU (gui only) and GPU (gpu,gui) extras
- PyInstaller hook conditionally collects CUDA packages only if installed
- Export CUDA_PACKAGES constant from utils/gpu.py for hook reuse
- Installer filename now includes variant suffix (-CPU/-GPU)
- Update READMEs to document both download options

Author: NewComer00

.github/workflows/packaging.yml

@@ -12,6 +12,14 @@ jobs:
   build:
     runs-on: windows-latest
 
+    strategy:
+      matrix:
+        include:
+          - variant: CPU
+            extras: "gui"
+          - variant: GPU
+            extras: "gpu,gui"
+
     defaults:
       run:
         shell: bash
@@ -29,7 +37,8 @@ jobs:
         run: |
           VERSION="${GITHUB_REF#refs/tags/v}"
           echo "VERSION=$VERSION" >> "$GITHUB_ENV"
-          echo "Detected version: $VERSION"
+          echo "VARIANT=${{ matrix.variant }}" >> "$GITHUB_ENV"
+          echo "Detected version: $VERSION, variant: ${{ matrix.variant }}"
 
       - name: Set up Python
         uses: actions/setup-python@a26af69be951a213d495a4c3e4e4022e16d87065 # v5
@@ -41,7 +50,7 @@ jobs:
       - name: Install dependencies
         run: |
           python -m pip install --upgrade pip
-          pip install -e ".[gpu,gui]"
+          pip install -e ".[${{ matrix.extras }}]"
           pip install pyinstaller
 
       - name: Build executable with PyInstaller
@@ -69,13 +78,13 @@ jobs:
 
       - name: Generate SHA256 checksum
         run: |
-          INSTALLER="dist/Expressive-GUI-$VERSION-Windows-x64.exe"
+          INSTALLER="dist/Expressive-GUI-$VERSION-Windows-x64-${{ matrix.variant }}.exe"
           sha256sum "$INSTALLER" > "$INSTALLER.sha256"
           cat "$INSTALLER.sha256"
 
       - name: Upload to GitHub Release
         uses: softprops/action-gh-release@a06a81a03ee405af7f2048a818ed3f03bbf83c7b # v2
         with:
           files: |
-            dist/Expressive-GUI-${{ env.VERSION }}-Windows-x64.exe
-            dist/Expressive-GUI-${{ env.VERSION }}-Windows-x64.exe.sha256
+            dist/Expressive-GUI-${{ env.VERSION }}-Windows-x64-${{ matrix.variant }}.exe
+            dist/Expressive-GUI-${{ env.VERSION }}-Windows-x64-${{ matrix.variant }}.exe.sha256

README.en.md

@@ -73,7 +73,8 @@ If your system has an NVIDIA GPU driver that supports [CUDA 11.x](https://docs.n
 
 You can download pre-compiled executable files directly from the [Releases](https://github.com/NewComer00/expressive/releases) page:
 
-- `Expressive-GUI-<version>-Windows-x64.exe`: GUI installer for Windows x64 architecture (includes GPU acceleration support)
+- `Expressive-GUI-<version>-Windows-x64-CPU.exe`: GUI installer for Windows x64, CPU-only (no CUDA dependencies)
+- `Expressive-GUI-<version>-Windows-x64-GPU.exe`: GUI installer for Windows x64 with NVIDIA GPU acceleration (requires driver >= 450, CUDA 11.x)
 
 ## 👨‍💻 Install from Source
 

README.md

@@ -74,7 +74,8 @@
 
 您可以直接在 [Releases](https://github.com/NewComer00/expressive/releases) 页面下载预编译的可执行文件:
 
-- `Expressive-GUI-<version>-Windows-x64.exe`: 适用于 x64 架构 Windows 的图形用户界面版本的安装包（包含GPU加速支持）
+- `Expressive-GUI-<version>-Windows-x64-CPU.exe`: 适用于 x64 架构 Windows 的图形用户界面安装包（仅 CPU，无 CUDA 依赖）
+- `Expressive-GUI-<version>-Windows-x64-GPU.exe`: 适用于 x64 架构 Windows 的图形用户界面安装包（含 NVIDIA GPU 加速，需驱动版本 >= 450，支持 CUDA 11.x）
 
 ## 👨‍💻 源码安装
 

build/hooks/hook-utils.gpu.py

@@ -0,0 +1,5 @@
+import importlib.util
+
+from utils.gpu import CUDA_PACKAGES
+
+hiddenimports = [pkg for pkg in CUDA_PACKAGES if importlib.util.find_spec(pkg) is not None]

build/installer.iss

@@ -1,4 +1,5 @@
 #define AppVersion GetEnv("VERSION")
+#define Variant GetEnv("VARIANT")
 
 [Setup]
 AppName=Expressive-GUI
@@ -8,7 +9,7 @@ ArchitecturesInstallIn64BitMode=x64compatible
 DefaultDirName={autopf}\Expressive-GUI
 DefaultGroupName=Expressive-GUI
 OutputDir=..\dist
-OutputBaseFilename=Expressive-GUI-{#AppVersion}-Windows-x64
+OutputBaseFilename=Expressive-GUI-{#AppVersion}-Windows-x64-{#Variant}
 Compression=lzma
 SolidCompression=yes
 LZMAUseSeparateProcess=yes

utils/gpu.py

@@ -6,12 +6,15 @@
 logger = logging.getLogger(__name__)
 
 
+CUDA_PACKAGES = [
+    "nvidia.cuda_nvcc", "nvidia.cuda_runtime", "nvidia.cudnn", "nvidia.cublas",
+    "nvidia.cusolver", "nvidia.cusparse", "nvidia.cufft", "nvidia.curand",
+]
+
+
 def add_cuda_to_path(skip_missing: bool = False):
     """Add CUDA to library searching path."""
-    packages = [
-        "nvidia.cuda_nvcc", "nvidia.cuda_runtime", "nvidia.cudnn", "nvidia.cublas",
-        "nvidia.cusolver", "nvidia.cusparse", "nvidia.cufft", "nvidia.curand",
-    ]
+    packages = CUDA_PACKAGES
 
     missing = []
     for package_name in packages: