feat(dashboard): 学习启动仪式体验重塑 v0.26.0

呼吸容器架构、主题化生命体、引导音、光尘转场、火种、自适应编排+A/B、记忆回响、语音目标、AI回顾小问；修复 reduced-motion 冻结入场动画致内容不可见

Author: Aparencia

.github/workflows/release.yml

@@ -4,11 +4,23 @@ name: Release Electron App
 on:
   push:
     tags: ['v*']
+  # 兜底触发：semantic-release 若以内置 GITHUB_TOKEN 推 tag，
+  # GitHub 防递归机制不会派发 push 事件，导致本工作流从不运行、
+  # Release 资产为空（latest.yml 404）。Release 发布事件可正常触发补跑。
+  release:
+    types: [published]
+  # 手动兜底：在 UI 选择对应 tag 运行，用于补发历史版本资产
+  workflow_dispatch:
 
 # 上传构建产物到 GitHub Release 需要写权限
 permissions:
   contents: write
 
+# 同一 tag 的多个触发源（push/release）串行执行，避免重复上传竞争
+concurrency:
+  group: release-electron-${{ github.ref_name }}
+  cancel-in-progress: false
+
 jobs:
   lint-test:
     runs-on: ubuntu-latest
@@ -41,7 +53,14 @@ jobs:
       - uses: actions/upload-artifact@v4
         with:
           name: release-${{ matrix.os }}
-          path: client/release/*.{exe,dmg,AppImage}
+          # 注意：@actions/glob 不支持 {a,b} 花括号展开，必须逐行列出；
+          # latest*.yml 与 *.blockmap 是 electron-updater 自动更新的必需文件
+          path: |
+            client/release/*.exe
+            client/release/*.dmg
+            client/release/*.AppImage
+            client/release/*.blockmap
+            client/release/latest*.yml
 
   release:
     needs: build

client/electron/updater.ts

@@ -98,6 +98,23 @@ function checkForUpdatesWithTimeout(): Promise<unknown> {
   });
 }
 
+/**
+ * 将 electron-updater 的原始错误映射为用户可读的提示。
+ * 原始 message 可能包含整段 HTTP headers / 堆栈（如 latest.yml 404），
+ * 不应直接透传到 UI；完整信息仍会经 logger 落盘供排查。
+ */
+function toFriendlyUpdateError(err: unknown): string {
+  const raw = err instanceof Error ? err.message : String(err);
+  if (/latest.*\.yml/i.test(raw) || /404/.test(raw)) {
+    return '更新服务暂时不可用（新版本文件尚未发布完成），请稍后再试';
+  }
+  if (/ENOTFOUND|ECONNREFUSED|ECONNRESET|ETIMEDOUT|net::ERR/i.test(raw)) {
+    return '网络连接异常，请检查网络后重试';
+  }
+  // 兜底：截断超长原始信息，避免刷屏
+  return raw.length > 100 ? `${raw.slice(0, 100)}…` : raw;
+}
+
 export function initAutoUpdater(mainWindow: BrowserWindow | null): void {
   // 开发模式下禁用自动更新
   if (!app.isPackaged) {
@@ -183,7 +200,7 @@ export function initAutoUpdater(mainWindow: BrowserWindow | null): void {
 
     sendToRenderer(mainWindow, 'update-status', {
       status: 'error',
-      message: error.message,
+      message: toFriendlyUpdateError(error),
     });
   });
 
@@ -210,11 +227,14 @@ export function initAutoUpdater(mainWindow: BrowserWindow | null): void {
         .then(() => { saveLastCheckTimestamp(); })
         .catch((err: unknown) => {
           logger.error('[AutoUpdater] Initial check failed', err);
+          // 失败同样写入节流时间戳：错误已提示过一次，
+          // 避免服务端问题未修复期间每次启动都重复弹出同一错误
+          saveLastCheckTimestamp();
           // 断网导致的失败不通知前端
           if (!net.isOnline()) return;
           sendToRenderer(mainWindow, 'update-status', {
             status: 'error',
-            message: err instanceof Error ? err.message : String(err),
+            message: toFriendlyUpdateError(err),
           });
         });
     }, 10_000);
@@ -233,7 +253,7 @@ export function checkForUpdate(): void {
       sendToRenderer(
         BrowserWindow.getAllWindows().find((w) => !w.isDestroyed()) ?? null,
         'update-status',
-        { status: 'error', message: err instanceof Error ? err.message : String(err) },
+        { status: 'error', message: toFriendlyUpdateError(err) },
       );
     });
 }