feat: v0.22.0 — 音效系统重构、UI 组件增强与 AI 余额查询

音效系统重构：
- audioConfig / SoundPlayer 全面重构
- 新增 20+ 音效文件（UI 交互、反馈、同步等）
- SoundSettings 音效设置优化
- generate-sounds 脚本

UI 组件增强：
- Modal / Toast / CommandPalette / ConsentModal 优化
- BottomNav / Sidebar 布局组件更新
- FunctionalOverlay 功能覆盖层改进

功能模块优化：
- Flashcards 卡片模块多页面增强
- Notes 笔记模块编辑与搜索优化
- Feynman 费曼页面改进
- Settings 设置页面全面更新（AI/Data/Sound/Flashcard）

AI 与后端：
- 新增 balance.py AI 余额查询路由
- useAIBalance hook
- AIProviderSettings 优化

3D 与同步：
- SpatialNav / MobileNavGrid 导航优化
- crdtEngine 协同引擎更新
- SyncStatusBar 同步状态优化

Electron：
- mcpManager / windowManager 更新

其他：
- AGENTS.md 项目智能体文档
- .gitignore 更新
- onboarding HelpCenter 优化
- website 版本号同步至 v0.22.0

Author: Aparencia

.gitignore

@@ -48,3 +48,7 @@ logs/
 # Coverage
 coverage/
 .nyc_output/
+
+# Scripts temp
+scripts/.mp3tmp/
+scripts/sounds_backup_original/

AGENTS.md

@@ -287,11 +287,11 @@ class McpManager {
 
     if (this.bridge) {
       try {
-        // 给 bridge 3 秒时间优雅关闭
+        // 给 bridge 1 秒时间优雅关闭（避免阻塞退出）
         await Promise.race([
           this.sendRequest('shutdown', {}),
           new Promise<void>((_, reject) =>
-            setTimeout(() => reject(new Error('Shutdown timeout')), 3000),
+            setTimeout(() => reject(new Error('Shutdown timeout')), 1000),
           ),
         ]);
       } catch {

client/electron/mcpManager.ts

@@ -5,7 +5,7 @@
  * 及关闭行为偏好持久化。
  */
 
-import { BrowserWindow, app } from 'electron';
+import { BrowserWindow, app, shell } from 'electron';
 import * as path from 'path';
 import { access, readFile, writeFile } from 'fs/promises';
 import { logger } from './logger.js';
@@ -34,7 +34,7 @@ let syncBeforeQuitCompleted = false;
 let syncTimeoutTimer: ReturnType<typeof setTimeout> | null = null;
 
 /** 同步超时时间（毫秒）：渲染进程未响应则强制继续退出 */
-const SYNC_BEFORE_QUIT_TIMEOUT_MS = 3000;
+const SYNC_BEFORE_QUIT_TIMEOUT_MS = 1500;
 
 /** 读取保存的关闭选择 */
 export async function getCloseChoice(): Promise<string | null> {
@@ -102,6 +102,14 @@ export function createMainWindow(
     logger.info('[Window] Window shown (ready-to-show)');
   });
 
+  // 拦截外部链接：target="_blank" 或 window.open() 统一用系统默认浏览器打开
+  win.webContents.setWindowOpenHandler(({ url }) => {
+    if (url.startsWith('https://') || url.startsWith('http://')) {
+      shell.openExternal(url);
+    }
+    return { action: 'deny' };
+  });
+
   // 窗口最大化状态变化时通知前端
   win.on('maximize', () => {
     win.webContents.send('window:maximized-changed', true);
@@ -180,7 +188,7 @@ export function createMainWindow(
 
 /**
  * 退出前同步流程入口
- * 不立即设置退出标志，而是先触发渲染进程同步
+ * 立即隐藏窗口（感知零延迟），后台执行同步再真正关闭
  * 附带超时保护：若渲染进程在 SYNC_BEFORE_QUIT_TIMEOUT_MS 内未响应，强制继续退出
  */
 function syncAndQuit(
@@ -198,9 +206,13 @@ function syncAndQuit(
     onQuit();
     return;
   }
-  // 首次触发：发送同步请求给渲染进程
+
+  // ✨ 立即隐藏窗口，用户感知零延迟退出
+  win.hide();
+
+  // 后台触发同步
   syncBeforeQuitRequested = true;
-  logger.info('[Window] Sync before quit: requesting renderer sync');
+  logger.info('[Window] Sync before quit: window hidden, requesting renderer sync');
   win.webContents.send('sync:before-quit');
 
   // 超时保护：渲染进程未响应时强制完成同步流程
@@ -228,8 +240,6 @@ export function completeSyncBeforeQuit(): void {
   }
 
   logger.info('[Window] Sync before quit: completed, proceeding with quit');
-  const win = BrowserWindow.getAllWindows()[0];
-  if (win) {
-    win.close();
-  }
+  // 直接调用 app.quit()，避免再次触发 win.close() 的 close 事件循环
+  app.quit();
 }