fix(release): switch Windows ARM64 bundles to NSIS

BigStrongSun · BigStrongSun · commit 0e8b25cdd0cb · 2026-07-03T01:49:55.000+08:00
The v3.16.4-8 release run proved the earlier sidecar and x64 runner fixes, but Windows ARM64 still failed after successfully cross-compiling cc-switch.exe and codex-history-repairer.exe. The remaining failure was in WiX v3 light.exe while producing the ARM64 MSI on windows-2022.

Root fix: stop treating Windows ARM64 MSI as a required release artifact. Build aarch64-pc-windows-msvc on the x64 Windows runner with NSIS, collect the ARM64 Setup.exe and signature first, and leave MSI as an optional compatibility artifact only. Update the GitHub release copy, bump the version to 3.16.4-9, add release notes, and record the workflow invariant in memory.md.

Validation: pnpm exec prettier --check package.json src-tauri/tauri.conf.json docs/release-notes/v3.16.4-9-zh.md .github/workflows/release.yml memory.md; pnpm typecheck; cargo metadata --manifest-path src-tauri/Cargo.toml --no-deps --format-version 1; git diff --check. actionlint is not installed locally, so the tag run will be the workflow syntax verification.
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
@@ -20,8 +20,9 @@ jobs:
       matrix:
         include:
           - os: windows-2022
-          # GitHub 的 Windows ARM64 runner 能编译主程序，但 WiX v3 light.exe 在该
-          # 环境中无法可靠启动；ARM64 安装包改由 x64 Windows runner 交叉打包。
+          # GitHub 的 Windows ARM64 runner 能编译主程序，但 WiX v3 light.exe 在
+          # ARM64 runner 和 x64 cross-build 两条路径上都不稳定；ARM64 改由 x64
+          # Windows runner 交叉编译主程序，并使用 NSIS 生成安装包。
           - os: windows-2022
             arch: arm64
           - os: ubuntu-22.04
@@ -320,7 +321,7 @@ jobs:
         run: |
           $ErrorActionPreference = 'Stop'
           if ($env:WINDOWS_RELEASE_ARCH -eq 'arm64') {
-            pnpm tauri build --target aarch64-pc-windows-msvc --bundles msi
+            pnpm tauri build --target aarch64-pc-windows-msvc --bundles nsis
           } else {
             pnpm tauri build --bundles nsis
           }
@@ -530,7 +531,28 @@ jobs:
           $targetRoot = if ($isArm64) { 'src-tauri/target/aarch64-pc-windows-msvc/release' } else { 'src-tauri/target/release' }
           $assetSuffix = if ($isArm64) { '-arm64' } else { '' }
 
-          # 仅 ARM64 继续使用 MSI；x64 使用 NSIS，避免 GitHub Windows runner 上 WiX light.exe 间歇失败。
+          $nsis = Get-ChildItem -Path (Join-Path $targetRoot 'bundle/nsis') -Recurse -Include *.exe -ErrorAction SilentlyContinue | Select-Object -First 1
+          if ($null -ne $nsis) {
+            $dest = "CC-Switch-$VERSION-Windows$assetSuffix-Setup.exe"
+            Copy-Item $nsis.FullName (Join-Path release-assets $dest)
+            Write-Host "NSIS installer copied: $dest"
+            $sigPath = "$($nsis.FullName).sig"
+            if (Test-Path $sigPath) {
+              Copy-Item $sigPath (Join-Path release-assets ("$dest.sig"))
+              Write-Host "Signature copied: $dest.sig"
+            } elseif (-not $isArm64) {
+              Write-Warning "Signature not found for $($nsis.Name)"
+            } else {
+              throw "Signature not found for $($nsis.Name)"
+            }
+          } elseif (-not $isArm64) {
+            throw 'No Windows x64 NSIS installer found'
+          } else {
+            throw 'No Windows ARM64 NSIS installer found'
+          }
+
+          # MSI 是兼容旧发布的可选资产。Windows ARM64 不再强制产 MSI，因为 WiX v3
+          # light.exe 在 GitHub hosted runner 上对 ARM64 MSI 仍会失败。
           $msi = Get-ChildItem -Path (Join-Path $targetRoot 'bundle/msi') -Recurse -Include *.msi -ErrorAction SilentlyContinue | Select-Object -First 1
           if ($null -eq $msi) {
             # 兜底：全局搜索 .msi
@@ -549,26 +571,8 @@ jobs:
             } else {
               Write-Warning "Signature not found for $($msi.Name)"
             }
-          } elseif ($isArm64) {
-            throw 'No Windows ARM64 MSI installer found'
           } else {
-            Write-Warning 'No Windows MSI installer found'
-          }
-
-          $nsis = Get-ChildItem -Path (Join-Path $targetRoot 'bundle/nsis') -Recurse -Include *.exe -ErrorAction SilentlyContinue | Select-Object -First 1
-          if ($null -ne $nsis) {
-            $dest = "CC-Switch-$VERSION-Windows$assetSuffix-Setup.exe"
-            Copy-Item $nsis.FullName (Join-Path release-assets $dest)
-            Write-Host "NSIS installer copied: $dest"
-            $sigPath = "$($nsis.FullName).sig"
-            if (Test-Path $sigPath) {
-              Copy-Item $sigPath (Join-Path release-assets ("$dest.sig"))
-              Write-Host "Signature copied: $dest.sig"
-            } elseif (-not $isArm64) {
-              Write-Warning "Signature not found for $($nsis.Name)"
-            }
-          } elseif (-not $isArm64) {
-            throw 'No Windows x64 NSIS installer found'
+            Write-Warning 'No Windows MSI installer found; NSIS installer was already collected'
           }
 
           # 绿色版（portable）：仅可执行文件打 zip（不参与 Updater）
@@ -718,7 +722,7 @@ jobs:
 
             - **macOS**: `CC-Switch-${{ github.ref_name }}-macOS.dmg`（推荐）或 `CC-Switch-${{ github.ref_name }}-macOS.zip`（解压即用）
             - **Windows (x86_64)**: `CC-Switch-${{ github.ref_name }}-Windows-Setup.exe`（安装版）或 `CC-Switch-${{ github.ref_name }}-Windows-Portable.zip`（绿色版）
-            - **Windows (ARM64)**: `CC-Switch-${{ github.ref_name }}-Windows-arm64.msi`（安装版）或 `CC-Switch-${{ github.ref_name }}-Windows-arm64-Portable.zip`（绿色版）
+            - **Windows (ARM64)**: `CC-Switch-${{ github.ref_name }}-Windows-arm64-Setup.exe`（安装版）或 `CC-Switch-${{ github.ref_name }}-Windows-arm64-Portable.zip`（绿色版）
             - **Linux (x86_64)**: `CC-Switch-${{ github.ref_name }}-Linux-x86_64.AppImage` / `.deb` / `.rpm`
             - **Linux (ARM64)**: `CC-Switch-${{ github.ref_name }}-Linux-arm64.AppImage` / `.deb` / `.rpm`
 
diff --git a/docs/release-notes/v3.16.4-9-zh.md b/docs/release-notes/v3.16.4-9-zh.md
@@ -0,0 +1,15 @@
+# CCSwitchMulti v3.16.4-9 发布说明
+
+本版本继续修复 `v3.16.4-8` 标签发布时暴露的 GitHub Release workflow 问题。
+
+## 修复
+
+- Windows ARM64 Release 不再强制产出 MSI。`v3.16.4-8` 已证明 x64 runner 可以交叉编译 ARM64 主程序和 history repair sidecar，但 WiX v3 `light.exe` 在 ARM64 MSI 打包阶段仍会失败。
+- Windows ARM64 改为使用 NSIS 安装包：`CC-Switch-v3.16.4-9-Windows-arm64-Setup.exe`，并继续产出绿色版 `CC-Switch-v3.16.4-9-Windows-arm64-Portable.zip`。
+- Release 资产收集逻辑同步改为优先收集 Windows ARM64 NSIS 安装包；MSI 只作为可选兼容资产，不再阻塞发布。
+- GitHub Release 下载说明和 `latest.json` 生成规则保留对 `Windows-arm64-Setup.exe` 的识别，确保 Windows ARM64 updater 元数据可以从 NSIS 签名生成。
+
+## 验证
+
+- `v3.16.4-8` Release run 已验证 Windows x64、Linux x64、Linux ARM64 构建成功；Windows ARM64 失败点收敛到 WiX `light.exe`。
+- 本版本用于验证 Windows ARM64 改走 NSIS 后的完整 tag release 链路。
diff --git a/memory.md b/memory.md
@@ -1,5 +1,12 @@
 # CC Switch Repository Memory
 
+## 2026-07-03 GitHub Release Windows ARM64 NSIS Fallback
+
+- `v3.16.4-8` tag 验证了上一轮 CI/Release 修复的大部分链路：main push CI 成功；Release 的 Linux x64、Linux ARM64、Windows x64 均成功；Windows ARM64 已成功交叉编译主程序和 `codex-history-repairer.exe` sidecar。
+- 新失败点仍在 Windows ARM64 安装包阶段：x64 `windows-2022` runner 上执行 `pnpm tauri build --target aarch64-pc-windows-msvc --bundles msi` 时，主程序已构建到 `src-tauri/target/aarch64-pc-windows-msvc/release/cc-switch.exe`，但 WiX v3 `light.exe` 在 `Running light to produce ..._arm64_en-US.msi` 后失败，日志只有 `failed to run ...\WixTools314\light.exe`。这说明把 ARM64 从 `windows-11-arm` 挪到 x64 runner 只能解决 runner 环境启动问题，不能保证 WiX3 ARM64 MSI 打包可靠。
+- 修复边界：Windows ARM64 release 不再强制产 MSI，改成 x64 runner 交叉编译 `aarch64-pc-windows-msvc` 后用 NSIS 生成 `CC-Switch-v*-Windows-arm64-Setup.exe`，同时继续产出 `Windows-arm64-Portable.zip`。MSI 只作为兼容旧发布的可选资产，缺失不再阻塞 Release。
+- 相关 workflow 不变量：`assemble-latest-json` 已支持 `*-Windows-arm64-Setup.exe` 映射到 `windows-aarch64`；`Prepare Windows Assets` 必须先收集 NSIS 并要求签名，再把 MSI 作为可选附加资产；GitHub Release 下载文案必须写 ARM64 `Setup.exe` 而不是 `.msi`。
+
 ## 2026-07-03 GitHub Flow CI/Release Failure Root Fix
 
 - `v3.16.4-7` 推到 `BigStrongSun/ccswitchmulti` 后 GitHub Actions 有两类真实失败：CI 的 `Backend Checks` 卡在 Rust Clippy，Release 的 Windows 打包卡在 Windows 资产构建。不要把它归因为 GitHub 本身抽风，也不要只重跑 workflow。
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "cc-switch-multi",
-  "version": "3.16.4-8",
+  "version": "3.16.4-9",
   "description": "All-in-One Assistant for Claude Code, Codex & Gemini CLI",
   "type": "module",
   "scripts": {
diff --git a/src-tauri/Cargo.lock b/src-tauri/Cargo.lock
diff --git a/src-tauri/Cargo.toml b/src-tauri/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "cc-switch"
-version = "3.16.4-8"
+version = "3.16.4-9"
 description = "All-in-One Assistant for Claude Code, Codex & Gemini CLI"
 authors = ["Jason Young"]
 license = "MIT"
diff --git a/src-tauri/tauri.conf.json b/src-tauri/tauri.conf.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://schema.tauri.app/config/2",
   "productName": "CCSwitchMulti",
-  "version": "3.16.4-8",
+  "version": "3.16.4-9",
   "identifier": "com.ccswitchmulti.desktop",
   "build": {
     "frontendDist": "../dist",

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "cc-switch-multi",`
`3`		`- "version": "3.16.4-8",`
	`3`	`+ "version": "3.16.4-9",`
`4`	`4`	`"description": "All-in-One Assistant for Claude Code, Codex & Gemini CLI",`
`5`	`5`	`"type": "module",`
`6`	`6`	`"scripts": {`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"$schema": "https://schema.tauri.app/config/2",`
`3`	`3`	`"productName": "CCSwitchMulti",`
`4`		`- "version": "3.16.4-8",`
	`4`	`+ "version": "3.16.4-9",`
`5`	`5`	`"identifier": "com.ccswitchmulti.desktop",`
`6`	`6`	`"build": {`
`7`	`7`	`"frontendDist": "../dist",`