feat: v2.1 — 修复自动更新功能并增强更新体验

- 修复 Updater 参数传递因路径末尾反斜杠导致引号转义错误（改用 ArgumentList）
- 修复 GitHub API 限速（403）和网络错误被误判为"已是最新版本"
- 修复 Process 对象未释放的句柄泄漏（UpdateService 和 Updater）
- 新增侧边栏设置项更新提示小红点
- 新增 Windows 系统通知推送更新提醒
- 前端 pollForRestart 新增版本校验，防止回滚后误判更新成功
- 将程序版本提升至 2.1

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

Author: HanFengRuYue

.github/workflows/build.yml

@@ -57,7 +57,7 @@ jobs:
         shell: pwsh
         run: |
           $v = '${{ inputs.build_version }}'
-          if (-not $v) { $v = "2.0.$(Get-Date -Format 'yyyyMMddHHmm')" }
+          if (-not $v) { $v = "2.1.$(Get-Date -Format 'yyyyMMddHHmm')" }
           $prefix = $v.Split('.')[0..1] -join '.'
           "build_version=$v" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
           "version_prefix=$prefix" | Out-File -FilePath $env:GITHUB_OUTPUT -Append
@@ -580,7 +580,7 @@ jobs:
           $installerProject = "Installer/Installer.wixproj"
 
           # Generate MSI version from build version
-          # Build version format: 2.0.YYYYMMDDHHmm
+          # Build version format: 2.1.YYYYMMDDHHmm
           # MSI constraints: major < 256, minor < 256, build < 65536
           $parts = "${{ steps.ver.outputs.build_version }}".Split('.')
           $timestamp = $parts[2]  # YYYYMMDDHHmm

CLAUDE.md

@@ -142,7 +142,7 @@ cd XUnityToolkit-Vue && npx vue-tsc --noEmit
 
 - `dotnet build` auto-runs frontend; skip with `-p:SkipFrontendBuild=true`
 - `build.ps1`: downloads bundled assets → extracts XUnity reference DLLs → updates classdata.tpk (requires `gh` CLI) → frontend → TranslatorEndpoint → publish to `Release/win-x64/`; `-SkipDownload` skips all download/extraction steps; cleanup: remove `web.config`, `*.pdb`, `*.staticwebassets.endpoints.json`
-- **Versioning:** `build.ps1` auto-generates `2.0.{YYYYMMDDHHmm}` (CI uses `2.0.` prefix) via `-p:InformationalVersion`; **must use `InformationalVersion` not `Version`** — `Version` sets `AssemblyVersion` (UInt16 max 65535) which overflows with timestamp
+- **Versioning:** `build.ps1` auto-generates `2.1.{YYYYMMDDHHmm}` (CI uses `2.1.` prefix) via `-p:InformationalVersion`; **must use `InformationalVersion` not `Version`** — `Version` sets `AssemblyVersion` (UInt16 max 65535) which overflows with timestamp
 - **Multi-file publishing:** `PublishSingleFile` removed; `ExcludeFromSingleFile` target removed; LibCpp2IL.dll works naturally in multi-file mode
 - **Satellite assemblies:** `SatelliteResourceLanguages=en` strips all language folders (cs/de/fr/ja/ko/etc.) from publish output; WinForms satellite resources are unused (UI is Vue, native dialogs use OS localization)
 - **Updater:** `Updater/Updater.csproj` (net10.0, PublishAot); win-x64 only; `--data-dir` CLI arg directs log/backup paths to `paths.Root`

Updater/Program.cs

@@ -61,7 +61,7 @@ void Log(string message)
     {
         try
         {
-            var p = Process.GetProcessById(pid);
+            using var p = Process.GetProcessById(pid);
             if (p.HasExited)
             {
                 exited = true;

XUnityToolkit-Vue/CLAUDE.md

@@ -41,6 +41,7 @@ Vue 3 frontend for XUnityToolkit-WebUI. See root `CLAUDE.md` for project overvie
 - **ConfigPanel** auto-saves internally (2s), no `save` event
 - Naive UI: light theme pass `null`; `NDrawer` width numbers only; `NForm` label-placement via computed (not CSS); `NInput` `string?` use `:value` + `@update:value`; `NInput` blur+enter double-fire → flag guard; `NDialogOptions.onPositiveClick`: returning a `Promise` keeps dialog open until resolved — fire-and-forget long async work (e.g., `() => { doWork() }`) to close immediately
 - `NDataTable`: `virtual-scroll` and `pagination` mutually exclusive; empty state guard with `filteredEntries.length > 0`; `row-key` must be globally unique — if ID can collide across categories, use composite key like `` `${category}:${id}` ``; columns without explicit `width`/`minWidth` get squeezed to 0px when fixed-width columns sum exceeds container — always set `minWidth` on flexible columns
+- `NColorPicker`: `#trigger` slot replaces entire trigger element; `#label` only customizes text inside default rectangular trigger — use `#trigger` for custom trigger buttons; always set `:modes="['hex']"` when consuming hex values (default allows rgb/hsl/hsv switching, which breaks `hexToRgb()`); manage visibility manually via `:show`/`@update:show` — do NOT also call slot's provided `onClick` (it only opens, never toggles)
 - `v-show` + `loading="lazy"` deadlock: use `opacity: 0` + `position: absolute`
 - `onBeforeRouteLeave` with async: must `return new Promise<boolean>()` — NOT `next()` callback
 - **RouterView key:** `:key="route.path"` ensures transitions fire for same-component different-route navigations

XUnityToolkit-Vue/src/components/layout/AppShell.vue

@@ -1,5 +1,5 @@
 <script setup lang="ts">
-import { ref, watch, onMounted, onUnmounted } from 'vue'
+import { ref, computed, watch, onMounted, onUnmounted } from 'vue'
 import { RouterView, useRouter, useRoute } from 'vue-router'
 import { NIcon } from 'naive-ui'
 import { GamepadFilled, SettingsOutlined, SmartToyOutlined, ArticleOutlined, FontDownloadOutlined } from '@vicons/material'
@@ -13,6 +13,28 @@ const sidebarOpen = ref(false)
 const appVersion = ref('')
 const updateStore = useUpdateStore()
 
+const showUpdateBadge = computed(() =>
+  updateStore.isUpdateAvailable || updateStore.isReady || updateStore.isDownloading
+)
+
+// Watch for update availability — push Windows system notification
+let notifiedVersion: string | undefined
+watch(() => updateStore.availableInfo, (info) => {
+  if (!info || !updateStore.isUpdateAvailable) return
+  if (notifiedVersion === info.version) return
+  notifiedVersion = info.version
+
+  if ('Notification' in window && Notification.permission === 'granted') {
+    new Notification('XUnity Toolkit', {
+      body: `发现新版本 v${info.version}，点击前往设置更新`,
+      icon: '/logo.png',
+    }).onclick = () => {
+      window.focus()
+      router.push('/settings')
+    }
+  }
+})
+
 onMounted(async () => {
   try {
     const info = await settingsApi.getVersion()
@@ -21,6 +43,10 @@ onMounted(async () => {
   } catch {
     appVersion.value = '1.0.0'
   }
+  // Request notification permission early
+  if ('Notification' in window && Notification.permission === 'default') {
+    Notification.requestPermission()
+  }
   // Initialize update system early so we receive SignalR broadcasts from startup auto-check
   updateStore.init()
 })
@@ -116,6 +142,7 @@ watch(() => route.path, () => {
             <component :is="item.icon" />
           </NIcon>
           <span>{{ item.label }}</span>
+          <span v-if="item.key === '/settings' && showUpdateBadge" class="update-dot" />
         </a>
       </nav>
 
@@ -274,6 +301,21 @@ watch(() => route.path, () => {
   transition: filter 0.3s ease, color 0.3s ease;
 }
 
+.update-dot {
+  width: 8px;
+  height: 8px;
+  border-radius: 50%;
+  background: var(--accent);
+  box-shadow: 0 0 6px var(--accent-glow);
+  margin-left: auto;
+  animation: pulse-dot 2s ease-in-out infinite;
+}
+
+@keyframes pulse-dot {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.4; }
+}
+
 /* ===== Sidebar Footer ===== */
 .sidebar-spacer {
   flex: 1;

XUnityToolkit-Vue/src/stores/update.ts

@@ -164,6 +164,7 @@ export const useUpdateStore = defineStore('update', () => {
 
   function pollForRestart() {
     if (restartPollTimer) return
+    const expectedVersion = availableInfo.value?.version
     let elapsed = 0
     restartPollTimer = setInterval(async () => {
       elapsed += 2000
@@ -178,6 +179,17 @@ export const useUpdateStore = defineStore('update', () => {
       try {
         const resp = await fetch('/api/settings/version')
         if (resp.ok) {
+          // Verify the new version is actually running (not a rollback to old version)
+          const result = await resp.json()
+          const runningVersion = (result?.data?.version as string)?.split('+')[0]
+          if (expectedVersion && runningVersion && runningVersion !== expectedVersion) {
+            // Server restarted but with old version — update failed (rollback)
+            if (restartPollTimer) clearInterval(restartPollTimer)
+            restartPollTimer = null
+            state.value = 'Error'
+            error.value = '更新失败，已回滚到旧版本'
+            return
+          }
           if (restartPollTimer) clearInterval(restartPollTimer)
           restartPollTimer = null
           window.location.reload()

XUnityToolkit-WebUI/Endpoints/UpdateEndpoints.cs

@@ -11,8 +11,15 @@ public static void MapUpdateEndpoints(this WebApplication app)
 
         group.MapGet("/check", async (UpdateService updateService, CancellationToken ct) =>
         {
-            var result = await updateService.CheckForUpdateAsync(ct);
-            return Results.Ok(ApiResult<UpdateCheckResult>.Ok(result));
+            try
+            {
+                var result = await updateService.CheckForUpdateAsync(ct);
+                return Results.Ok(ApiResult<UpdateCheckResult>.Ok(result));
+            }
+            catch (InvalidOperationException ex)
+            {
+                return Results.Ok(ApiResult.Fail(ex.Message));
+            }
         });
 
         group.MapGet("/status", (UpdateService updateService) =>

XUnityToolkit-WebUI/Services/UpdateService.cs

@@ -159,9 +159,9 @@ public async Task<UpdateCheckResult> CheckForUpdateAsync(CancellationToken ct =
             if ((int)response.StatusCode == 403)
             {
                 logger.LogWarning("GitHub API 速率限制，跳过检查");
-                _status = new UpdateStatusInfo { State = UpdateState.None };
+                _status = new UpdateStatusInfo { State = UpdateState.Error, Error = "GitHub API 请求频率超限，请稍后再试" };
                 await BroadcastStatus();
-                return _lastCheckResult ?? new UpdateCheckResult();
+                throw new InvalidOperationException("GitHub API 请求频率超限，请稍后再试");
             }
 
             response.EnsureSuccessStatusCode();
@@ -320,12 +320,12 @@ await File.WriteAllTextAsync(cachePath,
 
             return _lastCheckResult;
         }
-        catch (Exception ex)
+        catch (Exception ex) when (ex is not InvalidOperationException)
         {
             logger.LogError(ex, "检查更新失败");
             _status = new UpdateStatusInfo { State = UpdateState.Error, Error = "检查更新失败，请检查网络连接" };
             await BroadcastStatus();
-            return _lastCheckResult ?? new UpdateCheckResult();
+            throw new InvalidOperationException("检查更新失败，请检查网络连接", ex);
         }
         finally
         {
@@ -538,26 +538,37 @@ public async Task<string> ApplyUpdateAsync(CancellationToken ct = default)
         var updaterDst = Path.Combine(tempDir, "Updater.exe");
         File.Copy(updaterSrc, updaterDst, overwrite: true);
 
-        // Build arguments
+        // Build arguments (use ArgumentList to avoid backslash-quote escaping issues —
+        // AppContext.BaseDirectory ends with '\', and "path\" is parsed as escaped quote by CommandLineToArgvW)
         var pid = Environment.ProcessId;
         var exeName = Path.GetFileName(Environment.ProcessPath ?? "XUnityToolkit-WebUI.exe");
         var deleteListPath = Path.Combine(stagingDir, "delete-list.txt");
-        var args = $"--pid {pid} --app-dir \"{appDir}\" --staging-dir \"{filesDir}\" --exe-name \"{exeName}\" --data-dir \"{paths.Root}\"";
-        if (File.Exists(deleteListPath))
-            args += $" --delete-list \"{deleteListPath}\"";
 
-        // Launch Updater
-        logger.LogInformation("启动 Updater.exe: {Args}", args);
-        var process = new System.Diagnostics.Process
+        var startInfo = new System.Diagnostics.ProcessStartInfo
         {
-            StartInfo = new System.Diagnostics.ProcessStartInfo
-            {
-                FileName = updaterDst,
-                Arguments = args,
-                UseShellExecute = false,
-                CreateNoWindow = true
-            }
+            FileName = updaterDst,
+            UseShellExecute = false,
+            CreateNoWindow = true
         };
+        startInfo.ArgumentList.Add("--pid");
+        startInfo.ArgumentList.Add(pid.ToString());
+        startInfo.ArgumentList.Add("--app-dir");
+        startInfo.ArgumentList.Add(appDir);
+        startInfo.ArgumentList.Add("--staging-dir");
+        startInfo.ArgumentList.Add(filesDir);
+        startInfo.ArgumentList.Add("--exe-name");
+        startInfo.ArgumentList.Add(exeName);
+        startInfo.ArgumentList.Add("--data-dir");
+        startInfo.ArgumentList.Add(paths.Root);
+        if (File.Exists(deleteListPath))
+        {
+            startInfo.ArgumentList.Add("--delete-list");
+            startInfo.ArgumentList.Add(deleteListPath);
+        }
+
+        // Launch Updater
+        logger.LogInformation("启动 Updater.exe: {Args}", string.Join(" ", startInfo.ArgumentList));
+        using var process = new System.Diagnostics.Process { StartInfo = startInfo };
         process.Start();
 
         _status = new UpdateStatusInfo { State = UpdateState.Applying, Message = "正在应用更新..." };

build.ps1

@@ -163,8 +163,8 @@ $EndpointProject = Join-Path $ProjectRoot 'TranslatorEndpoint\TranslatorEndpoint
 $rid = 'win-x64'
 $hasEndpoint = Test-Path $EndpointProject
 
-# Generate version: 2.0.{YYYYMMDDHHmm}
-$BuildVersion = "2.0.$(Get-Date -Format 'yyyyMMddHHmm')"
+# Generate version: 2.1.{YYYYMMDDHHmm}
+$BuildVersion = "2.1.$(Get-Date -Format 'yyyyMMddHHmm')"
 $VersionPrefix = ($BuildVersion -split '\.')[0..1] -join '.'
 
 # Generate MSI-compatible version: {(YYYY-2024)*12+MM}.{DD}.{HH*60+mm}