fix: 修复 CI release job 组件包上传路径错误

upload-artifact@v5 会去掉公共路径前缀 Release/，
导致 release job 在 components/Release/ 下找不到文件。
修正为 components/ 直接路径。同时更新 release notes 加入 MSI 说明。

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: HanFengRuYue

.github/workflows/build.yml

@@ -592,19 +592,22 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
+          # upload-artifact@v5 strips common path prefix (Release/)
+          # so files are at components/xxx, not components/Release/xxx
+          ls -la components/
           gh release upload "${{ inputs.release_tag }}" \
-            components/Release/manifest-win-x64.json \
-            components/Release/app-win-x64.zip \
-            components/Release/wwwroot.zip \
-            components/Release/bundled.zip \
+            components/manifest-win-x64.json \
+            components/app-win-x64.zip \
+            components/wwwroot.zip \
+            components/bundled.zip \
             --clobber \
             --repo "${{ github.repository }}"
 
       - name: Upload MSI to release
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          MSI_FILE="components/Release/XUnityToolkit-WebUI-win-x64.msi"
+          MSI_FILE="components/XUnityToolkit-WebUI-win-x64.msi"
           if [ -f "$MSI_FILE" ]; then
             gh release upload "${{ inputs.release_tag }}" "$MSI_FILE" --clobber --repo "${{ github.repository }}"
           fi

.github/workflows/release.yml

@@ -16,12 +16,14 @@ jobs:
         ## XUnityToolkit-WebUI ${{ github.ref_name }}
 
         ### Downloads
-        | File | Platform |
-        |------|----------|
-        | `XUnityToolkit-WebUI-win-x64.zip` | Windows x64 |
+        | File | Description |
+        |------|-------------|
+        | `XUnityToolkit-WebUI-win-x64.zip` | Portable (Windows x64) |
+        | `XUnityToolkit-WebUI-win-x64.msi` | MSI Installer (Windows x64) |
 
         ### Installation
-        Download the ZIP, extract, and run `XUnityToolkit-WebUI.exe`.
+        - **Portable:** Download the ZIP, extract, and run `XUnityToolkit-WebUI.exe`.
+        - **Installer:** Download the MSI and double-click to install.
       prerelease: false
     permissions:
       contents: write

CLAUDE.md

@@ -112,13 +112,13 @@ cd XUnityToolkit-Vue && npx vue-tsc --noEmit
 - **`RecordError` call sites:** `LlmTranslationService.RecordError` called from: internal (`TranslateAsync` early-exit), external (`TranslateEndpoints.cs` catch blocks) — signature changes must update both
 - **Font generation models:** Sync `CharacterSetConfig`/`FontGenerationReport`/`CharsetInfo` between `Models/FontGeneration.cs` ↔ `src/api/types.ts`; phase values between `TmpFontGeneratorService` ↔ `FontGeneratorView.vue` phaseLabels; charset IDs between `BuiltinCharsets` ↔ frontend checkbox values
 - **Font replacement models:** Sync `FontInfo`/`FontReplacementStatus` between `Models/FontReplacement.cs` ↔ `src/api/types.ts` ↔ `FontReplacementView.vue`
-- **TMP font models:** Sync `TmpFontStatus` between `Models/` ↔ `src/api/types.ts`; API methods in `src/api/games.ts`
+- **TMP font models:** Sync `TmpFontStatus` between `Endpoints/GameEndpoints.cs` ↔ `src/api/types.ts`; API methods in `src/api/games.ts`
 - Frontend state lifecycle: `GameDetailView.loadGame()` resets state when `isInstalled=false`
 - Install store `operationType` tracks install vs uninstall
 - **`[LLMTranslate]` INI config:** Written in 3 places — `POST /ai-endpoint`, `InstallOrchestrator`, DLL `Initialize`
 - **Update status model:** `Models/UpdateInfo.cs` → `src/api/types.ts` → `src/stores/update.ts` → `SettingsView.vue`
 - **AppSettings.ReceivePreReleaseUpdates:** Sync 4 places: `Models/AppSettings.cs`, `src/api/types.ts`, `SettingsView.vue` (settings default + NSwitch)
-- **MSI registry keys:** Written by MSI (`Components.wxs`), read by `Program.cs` (DataPath) and `Updater/Program.cs` (MsiProductCode); key path: `HKCU\Software\XUnityToolkit`
+- **MSI registry keys:** Written by MSI (`Components.wxs`), read by `Program.cs` (DataPath) and `Updater/Program.cs` (MsiProductCode, InstallDir); key path: `HKCU\Software\XUnityToolkit`
 
 ### Build & Deploy
 
@@ -137,7 +137,7 @@ cd XUnityToolkit-Vue && npx vue-tsc --noEmit
 - **CI shared PowerShell functions:** Extract to standalone `.ps1` files (e.g., `Installer/Generate-InstallerWxs.ps1`); both `build.ps1` and CI source via `. ./path/to/script.ps1`
 - **WiX gotcha — reserved properties:** `PublishDir` and `SourceDir` are reserved by MSBuild/WiX SDK and get silently overridden; use custom names (e.g., `AppPublishDir`) and pass via `-p:AppPublishDir=...`
 - **WiX gotcha — path resolution:** WiX resolves `Source` paths relative to `.wixproj` directory, NOT CWD; use `IsPathRooted` in `.wixproj` to handle both absolute and relative inputs; do NOT set `-p:OutputPath` on WiX builds (interferes with file resolution)
-- **WiX gotcha — per-user ICE errors:** Per-user installs (`Scope="perUser"`) trigger ICE38/ICE64/ICE91 false positives; suppress via `<SuppressIces>ICE38;ICE64;ICE91</SuppressIces>`
+- **WiX gotcha — per-user ICE errors:** Per-user installs (`Scope="perUser"`) trigger ICE false positives; suppress via `<SuppressIces>ICE38;ICE60;ICE61;ICE64;ICE91</SuppressIces>`
 - **WiX gotcha — MSI codepage:** MSI database codepage defaults to 1252 (Western); Chinese characters in MSI internal strings (e.g., `DowngradeErrorMessage`) cause WIX0311 error; use English for MSI-level strings
 - **WiX gotcha — v5 element syntax:** `<String>` uses `Value` attribute (not inner text); `<Publish>` uses `Condition` attribute (not inner text); inner text is obsolete in WiX v5
 - **WiX gotcha — DefaultLanguage output path:** Setting `<DefaultLanguage>zh-CN</DefaultLanguage>` causes MSI output to culture subfolder (e.g., `bin/x64/Release/zh-CN/`); `build.ps1` uses `-Recurse` to find MSI