feat: v0.10.0 — 苏格拉底式学习、仪表盘深海主题、SQLite 迁移与 AI 降级

苏格拉底式学习（费曼增强）：
- 新增 SocraticDialogue 苏格拉底对话组件
- 新增 BrainstormPanel 头脑风暴面板
- 新增 DeepeningZone 深化区
- 新增 SocraticSessionPage 苏格拉底会话页
- useSocraticFlow Hook 管理对话流程
- 后端新增 3 条苏格拉底链（brainstorm/deepening/evaluate）

仪表盘深海主题重构：
- 新增 HeatmapChart / RadarChart / TrendChart 可视化组件
- 新增 StartupRitual 启动仪式组件
- deep-sea 主题子目录与 hooks
- 仪表盘页面全面重构

笔记智能增强：
- 新增 AnchorPoint 锚点组件
- 新增 PredictionPanel 预测面板与 PredictionResult
- useEditActivityTracker 编辑活动追踪

番茄钟 AI 推荐：
- 新增 useAIRecommendation Hook
- 番茄钟 lib 子模块扩展

AI 系统增强：
- 新增 AI 降级管理器（aiFallbackManager / aiServiceFallback）
- 新增 useAIFallback / useAIService Hooks
- AIPluginLoader / ElectronAIPlugin / RemoteAIPlugin 优化
- 新增 AI hooks 子目录
- visionWorker 优化

存储层升级：
- 新增 IpcStorageAdapter（IPC 存储适配器）
- 新增 electron/db/ 数据库模块
- 新增 MigrationProgress 迁移进度组件
- storageFactory 优化

前端基础设施：
- 新增 AIThinkingIndicator AI 思考指示器
- 新增 RescuePanel 救援面板
- 新增 useAIGatewayHealth / useStuckTimer Hooks
- 新增 workers/ 工作线程目录
- UI 组件全面更新（Button/Card/Modal/Toast/ErrorBoundary 等）
- 自定义标题栏、侧边栏、页面过渡增强

后端与部署：
- 新增苏格拉底路由与测试
- AI 网关配置与推荐链优化
- docker-compose.prod.yml 更新
- Nginx 配置调整
- deploy.sh 更新

其他：
- 应用图标更新
- electron-builder 构建配置调整
- Tailwind 设计令牌更新
- PWA 安装提示优化
- 隐私政策与服务条款更新

Author: Aparencia

client/.env.example

@@ -12,14 +12,14 @@ VITE_SUPABASE_ANON_KEY=
 # ---- API 服务地址 ----
 # 同步服务（sync-service）基础地址
 # 开发环境: http://127.0.0.1:8080
-# 生产环境: 你的服务器地址
-VITE_API_BASE_URL=
+# 生产环境: https://entropydecrease.com
+VITE_API_BASE_URL=https://entropydecrease.com
 
 # 同步服务健康检查端点
-VITE_API_HEALTH_URL=
+VITE_API_HEALTH_URL=https://entropydecrease.com/health
 
 # ---- AI 网关 ----
 # AI Gateway 服务地址
 # 开发环境: http://127.0.0.1:8000
-# 生产环境: 你的服务器地址
-VITE_AI_GATEWAY_URL=
+# 生产环境: https://entropydecrease.com
+VITE_AI_GATEWAY_URL=https://entropydecrease.com

client/app-icon.png

@@ -1,13 +1,15 @@
-# Electron Builder 打包配置 - 课伴桌面端
-appId: com.keban.app
-productName: "KeBan"
-# publish 配置用于自动更新发布，待部署更新服务器后启用
-# publish:
-#   provider: generic
-#   url: ${env.PUBLISH_URL}
+# Electron Builder 打包配置 - 熵减桌面端
+appId: com.entropydecrease.app
+productName: "Entropy decrease"
+publish:
+  provider: github
+  owner: YourGitHubUsername
+  repo: KeBan
 directories:
   output: release
   buildResources: build
+asarUnpack:
+  - "**/*.node"
 files:
   - dist/**/*
   - dist-electron/**/*
@@ -34,6 +36,6 @@ nsis:
   # installerIcon/uninstallerIcon/installerHeaderIcon 省略
   # electron-builder 会自动从 win.icon 派生 NSIS 所需的 .ico 文件
   createDesktopShortcut: true
-  shortcutName: "课伴"
+  shortcutName: "Entropy decrease"
   perMachine: false
   language: "2052"

client/electron-builder.yml

@@ -125,7 +125,7 @@ function register(): void {
 
 export const feature: AIFeatureDef = {
   id: 'ai_feynman',
-  name: '费曼学习法',
+  name: '浮出水面',
   version: '1.0.0',
   register,
 };

client/electron/ai/handlers/feynmanHandler.ts

@@ -82,7 +82,7 @@ function register(): void {
 
 export const feature: AIFeatureDef = {
   id: 'ai_generate_cards',
-  name: 'AI 闪卡生成',
+  name: 'AI 反衰减呼吸生成',
   version: '1.0.0',
   register,
 };

client/electron/ai/handlers/flashcardHandler.ts

@@ -83,9 +83,10 @@ function register(): void {
       };
 
       interface SortSuggestionResp {
-        type: string;
+        category: string;
         reason: string;
         confidence: number;
+        suggested_action: string;
       }
       interface SortInspirationResp {
         suggestions: SortSuggestionResp[];
@@ -104,9 +105,10 @@ function register(): void {
       logger.info(`[IPC] ai_sort_inspiration end, suggestions_count=${resp.suggestions.length}`);
       return {
         suggestions: resp.suggestions.map((s) => ({
-          type: s.type,
+          category: s.category,
           reason: s.reason,
           confidence: s.confidence,
+          suggestedAction: s.suggested_action,
         })),
         model: resp.model,
         tokensUsed: resp.tokens_used,
@@ -123,7 +125,7 @@ function register(): void {
 
 export const feature: AIFeatureDef = {
   id: 'ai_tag',
-  name: 'AI 标签与灵感分类',
+  name: 'AI 标签与萤火海沟分类',
   version: '1.0.0',
   register,
 };

client/electron/ai/handlers/tagHandler.ts

@@ -9,7 +9,7 @@ import { ScreenCapture } from './screenCapture.js';
 import type { ScreenCaptureOptions, ScreenshotFrameData } from './screenCapture.js';
 import { AudioCapture, listAudioSources } from './audioCapture.js';
 import type { AudioCaptureOptions, AudioChunk } from './audioCapture.js';
-import { safeHandle } from './ipcUtils.js';
+import { safeHandle, getMainWindowId } from './ipcUtils.js';
 import { logger } from './logger.js';
 
 // ================================================================
@@ -22,6 +22,13 @@ let activeCapture: ScreenCapture | null = null;
 /** 当前活跃的音频捕获实例 */
 let activeAudioCapture: AudioCapture | null = null;
 
+/** screen_capture_start 防抖：500ms 内多次调用只响应最后一次 */
+let startDebounceTimer: ReturnType<typeof setTimeout> | null = null;
+const START_DEBOUNCE_MS = 500;
+
+/** 单调递增会话标识，用于防止 stop 后残留的 debounce 重启采集 */
+let captureSessionToken = 0;
+
 // ================================================================
 // 公共 API
 // ================================================================
@@ -35,26 +42,58 @@ export function registerCaptureHandlers(): void {
   safeHandle(
     'screen_capture_start',
     async (event, options: ScreenCaptureOptions) => {
-      if (activeCapture) {
-        activeCapture.dispose();
-        activeCapture = null;
+      // 防抖：500ms 内多次调用只响应最后一次
+      if (startDebounceTimer) {
+        clearTimeout(startDebounceTimer);
+        startDebounceTimer = null;
       }
 
-      const senderWin = BrowserWindow.fromWebContents(event.sender);
-
-      activeCapture = new ScreenCapture(options, (frame: ScreenshotFrameData) => {
-        if (senderWin && !senderWin.isDestroyed()) {
-          senderWin.webContents.send('screen_capture_frame', frame);
-        }
+      // 记录本次会话 token，用于 debounce 回调时校验是否仍然有效
+      const token = ++captureSessionToken;
+
+      return new Promise<{ success: boolean }>((resolve) => {
+        startDebounceTimer = setTimeout(() => {
+          startDebounceTimer = null;
+
+          // 如果在 debounce 期间调用了 stop（token 已变），放弃本次启动
+          if (token !== captureSessionToken) {
+            logger.info('[IPC] screen_capture_start debounce 已过期（stop 后残留），跳过');
+            resolve({ success: false });
+            return;
+          }
+
+          // 幂等：先清理旧实例
+          if (activeCapture) {
+            activeCapture.dispose();
+            activeCapture = null;
+          }
+
+          const senderWin = BrowserWindow.fromWebContents(event.sender);
+
+          activeCapture = new ScreenCapture(options, (frame: ScreenshotFrameData) => {
+            if (senderWin && !senderWin.isDestroyed()) {
+              senderWin.webContents.send('screen_capture_frame', frame);
+            }
+          });
+
+          activeCapture.start();
+          logger.info('[IPC] screen_capture_start 已启动（防抖后）');
+          resolve({ success: true });
+        }, START_DEBOUNCE_MS);
       });
-
-      activeCapture.start();
-      logger.info('[IPC] screen_capture_start 已启动');
-      return { success: true };
     },
   );
 
   safeHandle('screen_capture_stop', async () => {
+    // 递增 token，使残留的 debounce 回调失效
+    captureSessionToken++;
+
+    // 清理防抖定时器
+    if (startDebounceTimer) {
+      clearTimeout(startDebounceTimer);
+      startDebounceTimer = null;
+    }
+
     if (activeCapture) {
       activeCapture.dispose();
       activeCapture = null;
@@ -143,6 +182,15 @@ export function registerCaptureHandlers(): void {
   ipcMain.on(
     'audio_capture_chunk',
     (_event, data: { audioBuffer: ArrayBuffer; sampleRate: number; channels: number; durationMs: number }) => {
+      // SEC-005: sender 验证，仅接受主窗口的音频数据
+      const mainId = getMainWindowId();
+      if (mainId !== null && _event.sender.id !== mainId) {
+        logger.warn(
+          `[IPC] Sender verification failed for "audio_capture_chunk": ` +
+          `expected sender.id=${mainId}, got ${_event.sender.id}`
+        );
+        return;
+      }
       if (activeAudioCapture && activeAudioCapture.isCapturing) {
         activeAudioCapture.handleRendererChunk(data);
       }
@@ -158,6 +206,11 @@ export function registerCaptureHandlers(): void {
  * 释放所有活跃的采集实例
  */
 export function disposeCaptureHandlers(): void {
+  // 清理防抖定时器
+  if (startDebounceTimer) {
+    clearTimeout(startDebounceTimer);
+    startDebounceTimer = null;
+  }
   if (activeCapture) {
     activeCapture.dispose();
     activeCapture = null;