fix(ci): 修复 Windows 桌面端打包失败

- 默认 ONNX 推理，移除 torch 依赖，避免 PyInstaller 引入 tensorboard。

- PyInstaller 排除 torch/tensorboard 等无关模块，降低打包失败概率。

- Windows CI 增加 MSBuild + app-builder 校验与调试日志，并同步更新 README/脚本入口。

Author: hhh2210

.github/workflows/desktop-build.yml

@@ -72,13 +72,68 @@ jobs:
         with:
           python-version: '3.10'
 
+      # Windows: 安装 Visual Studio Build Tools（用于编译 native 模块）
+      - name: Setup MSVC Build Tools (Windows only)
+        if: matrix.platform == 'win'
+        uses: microsoft/setup-msbuild@v2
+
       - name: Install dependencies
         run: pnpm install --frozen-lockfile
 
+      # Windows: 确保 app-builder.exe 存在且可执行
+      - name: Verify and fix app-builder (Windows only)
+        if: matrix.platform == 'win'
+        shell: pwsh
+        run: |
+          # 查找 app-builder.exe
+          $appBuilder = Get-ChildItem -Path "node_modules" -Recurse -Filter "app-builder.exe" -ErrorAction SilentlyContinue | Select-Object -First 1
+          
+          if ($appBuilder) {
+            Write-Host "Found app-builder.exe at: $($appBuilder.FullName)"
+            Write-Host "File size: $($appBuilder.Length) bytes"
+            
+            # 验证文件是否为有效的 PE 文件
+            $bytes = [System.IO.File]::ReadAllBytes($appBuilder.FullName)
+            if ($bytes[0] -eq 0x4D -and $bytes[1] -eq 0x5A) {
+              Write-Host "✓ Valid PE executable"
+            } else {
+              Write-Warning "File may be corrupted, reinstalling..."
+              Remove-Item -Recurse -Force "node_modules/app-builder-bin" -ErrorAction SilentlyContinue
+              Remove-Item -Recurse -Force "node_modules/.pnpm/app-builder-bin*" -ErrorAction SilentlyContinue
+              pnpm install --frozen-lockfile
+            }
+          } else {
+            Write-Warning "app-builder.exe not found, attempting reinstall..."
+            pnpm install --frozen-lockfile
+          }
+          
+          # 再次验证
+          $appBuilder = Get-ChildItem -Path "node_modules" -Recurse -Filter "app-builder.exe" -ErrorAction SilentlyContinue | Select-Object -First 1
+          if (-not $appBuilder) {
+            Write-Error "app-builder.exe still not found after reinstall!"
+            exit 1
+          }
+
       - name: Prepare Python env for ASR backend
         working-directory: desktop
         run: pnpm run prepare:python
 
+      # 验证 Python 环境和 PyInstaller
+      - name: Verify Python environment
+        shell: bash
+        run: |
+          if [ "${{ matrix.platform }}" = "win" ]; then
+            PYTHON_PATH="${{ github.workspace }}/desktop/python-env/Scripts/python.exe"
+          else
+            PYTHON_PATH="${{ github.workspace }}/desktop/python-env/bin/python3"
+          fi
+          echo "Python path: $PYTHON_PATH"
+          "$PYTHON_PATH" --version
+          "$PYTHON_PATH" -m pip list | head -30
+          "$PYTHON_PATH" -c "import PyInstaller; print('PyInstaller OK')" || echo "PyInstaller import check failed"
+          echo "Checking for PyInstaller module..."
+          "$PYTHON_PATH" -m PyInstaller --version || true
+
       - name: Print app version
         id: meta
         run: |
@@ -90,13 +145,32 @@ jobs:
           PYTHON: ${{ matrix.python }}
           ASR_IMPL: ${{ matrix.asr }}
           ASR_PYTHON_PATH: ${{ matrix.platform == 'win' && format('{0}/desktop/python-env/Scripts/python.exe', github.workspace) || format('{0}/desktop/python-env/bin/python3', github.workspace) }}
+          # Windows: 增加调试日志级别
+          DEBUG: ${{ matrix.platform == 'win' && 'electron-builder' || '' }}
         run: |
+          echo "=== Build Environment ==="
+          echo "Platform: ${{ matrix.platform }}"
+          echo "Arch: ${{ matrix.arch }}"
+          echo "ASR_PYTHON_PATH: $ASR_PYTHON_PATH"
+          echo "========================="
+          
           if [ "${{ matrix.platform }}" = "mac" ]; then
             pnpm run build:mac -- --${{ matrix.arch }}
           else
             pnpm run build:win -- --${{ matrix.arch }}
           fi
 
+      # Windows: 列出构建产物帮助调试
+      - name: List build artifacts
+        if: always()
+        shell: bash
+        run: |
+          echo "=== Release directory contents ==="
+          ls -la release/ || echo "release/ not found"
+          echo "=== Backend dist contents ==="
+          ls -la backend/dist/ || echo "backend/dist/ not found"
+          ls -la backend/dist/asr-backend/ 2>/dev/null | head -20 || echo "asr-backend dir not found"
+
       - name: Upload artifacts
         uses: actions/upload-artifact@v4
         with:

desktop/README.md

@@ -78,9 +78,11 @@ pnpm install
 ### 配置语音识别
 
 ```bash
-# 安装 FunASR（推荐，中文识别效果最好，macOS 默认）
-npm run setup-funasr
+# 准备内置 Python 运行环境（会创建 desktop/python-env 并安装依赖）
+pnpm run prepare:python
 ```
+
+- 本项目桌面端的本地 ASR **默认使用 FunASR ONNX（`funasr-onnx + onnxruntime`）**，因此 **不需要安装 `torch`**。
 - Windows 也使用 FunASR ONNX，无需额外安装 faster-whisper。
 
 ### 启动

desktop/package.json

@@ -12,7 +12,6 @@
     "dev:vite": "vite",
     "download-models": "node scripts/download-models.js",
     "update-asr-model": "node scripts/update-asr-model.js",
-    "setup-funasr": "bash scripts/setup-funasr.sh",
     "build:native": "node-gyp rebuild --directory=src/native/system-audio-capture",
     "rebuild:better-sqlite3": "electron-rebuild -f -w better-sqlite3",
     "rebuild:native": "electron-rebuild -f -w system_audio_capture",

desktop/requirements.txt

@@ -13,6 +13,10 @@ onnxruntime==1.21.1
 
 # FunASR ONNX 运行时依赖（funasr_onnx 内部会 import）
 jieba>=0.42.1
-torch
 modelscope
 
+# 说明：
+# - 本项目桌面端默认使用 funasr-onnx + onnxruntime 做推理，不需要 PyTorch。
+# - 之前的 torch 主要会在 PyInstaller 分析阶段引入 torch.utils.tensorboard，导致 Windows CI 因缺少 tensorboard 失败。
+# - 如需完整 FunASR（非 ONNX）或训练/导出能力，请在单独环境中安装 torch（而不是默认打包依赖）。
+

desktop/scripts/build-backend.js

@@ -90,6 +90,14 @@ function main() {
     '--collect-all numpy',
     '--hidden-import funasr_onnx',
     '--hidden-import jieba',
+    // 排除不需要的 torch 子模块，避免 tensorboard 缺失导致构建失败
+    '--exclude-module torch.utils.tensorboard',
+    '--exclude-module tensorboard',
+    '--exclude-module torch.utils.bottleneck',
+    // 排除其他不需要的大型依赖，减小包体积
+    '--exclude-module matplotlib',
+    '--exclude-module PIL',
+    '--exclude-module cv2',
   ];
 
   // 统一使用 onedir，避免 onefile 的压缩/解压开销