feat(ai): P2-11 激活离线 AI 队列（生命周期引导+摘要离线入队联网重放）

Author: Aparencia

client/src/App.tsx

@@ -20,6 +20,7 @@ import { useTheme } from '@/hooks/useTheme';
 import { db } from '@/lib/storage/database';
 import { soundPlayer } from '@/lib/audio/SoundPlayer';
 import { getAIConfig } from '@/lib/ai/config';
+import { OfflineAIQueueBootstrap } from '@/lib/ai/OfflineAIQueueBootstrap';
 import '@/stores/useSettingsStore'; // 导入以触发音效设置初始化
 
 // 启动时预加载所有音效（不阻塞渲染）
@@ -114,6 +115,7 @@ function App() {
               <RouterProvider router={router} />
               <AchievementToast />
               <UpdateNotification />
+              <OfflineAIQueueBootstrap />
             </ErrorBoundary>
           </SyncProvider>
         </AuthProvider>

client/src/lib/ai/AIPluginLoader.ts

@@ -14,6 +14,7 @@ import { LocalDurationRecommender } from './LocalFallback';
 import { AIError } from './ai-errors';
 import { ensureOnline, ensureMinLength } from './aiGuards';
 import { getAIPlugin, getRemotePlugin, getElectronPlugin } from './aiPluginProvider';
+import { offlineAIQueue } from './offlineAIQueue';
 import type { AIPlugin, DurationHistoryData, DurationOptions, DurationResult,
   SummarizeResult, FlashcardResult, EvaluateResult,
   SummarizeOptions, FlashcardOptions, EvaluateOptions,
@@ -41,12 +42,23 @@ class AIPluginLoader {
   /**
    * 统一非流式调用包装：守卫 → 取插件 → 能力检查 → 调用
    * invoke 返回 undefined 表示当前插件未实现该可选能力
+   * @ai-context P2-11：opts.offline 提供离线入队描述（feature/endpoint/payload）时，
+   * 离线不再单纯报错，而是 fire-and-forget 入队（联网后自动重放）后再抛 offline 提示。
    */
   private async call<T>(
     invoke: (plugin: AIPlugin) => Promise<T> | undefined,
-    opts: { contentCheck?: string; unsupportedMsg: string },
+    opts: { contentCheck?: string; unsupportedMsg: string; offline?: { feature: string; endpoint: string; payload: unknown } },
   ): Promise<T> {
-    ensureOnline();
+    try {
+      ensureOnline();
+    } catch (err) {
+      if (opts.offline && err instanceof AIError && err.code === 'offline') {
+        // 离线入队（不阻塞、不报错，联网后自动重放；测试环境无 indexedDB 时静默失败）
+        offlineAIQueue.enqueue(opts.offline.feature, opts.offline.endpoint, opts.offline.payload).catch(() => {});
+        throw new AIError('当前处于离线状态，请求已加入队列，联网后自动完成', 'offline', false);
+      }
+      throw err;
+    }
     ensureMinLength(opts.contentCheck);
     const plugin = await getAIPlugin();
     const result = invoke(plugin);
@@ -75,10 +87,15 @@ class AIPluginLoader {
 
   // ── 非流式功能 ─────────────────────────────────────────
 
-  /** 摘要功能 */
+  /** 摘要功能（P2-11：离线入队，联网后自动重放） */
   async summarizeNote(content: string, options?: SummarizeOptions): Promise<SummarizeResult> {
     return this.call(p => p.summarizeNote(content, options),
-      { contentCheck: content, unsupportedMsg: '当前 AI 插件不支持摘要' });
+      { contentCheck: content, unsupportedMsg: '当前 AI 插件不支持摘要',
+        offline: {
+          feature: 'summarize',
+          endpoint: '/api/v1/ai/summarize',
+          payload: { text: content, options: { max_length: options?.maxLength, style: options?.style, language: options?.language } },
+        } });
   }
 
   /** 闪卡生成 */

client/src/lib/ai/OfflineAIQueueBootstrap.tsx

@@ -0,0 +1,25 @@
+/**
+ * OfflineAIQueueBootstrap — 离线 AI 队列引导（P2-11）
+ *
+ * 挂载于 ToastProvider 内，激活 offlineAIQueue：
+ * - registerQueueToast：把应用 toast 注入队列模块（入队/重放成功/失败提示）；
+ * - startAutoProcess：注册 window online 监听 + 启动时在线即消费积压请求。
+ * 渲染为 null，纯副作用组件。
+ *
+ * @ai-context: hook 层。offlineAIQueue 为独立 Dexie 库 'keban-ai-queue'（品牌豁免，
+ * 不可改名）；本组件是其唯一激活点，移除则离线队列退回死代码。
+ */
+import { useEffect } from 'react';
+import { useToast } from '@/components/ui/Toast';
+import { offlineAIQueue } from '@/lib/ai/offlineAIQueue';
+
+export function OfflineAIQueueBootstrap() {
+  const { toast } = useToast();
+
+  useEffect(() => {
+    offlineAIQueue.registerQueueToast(toast);
+    offlineAIQueue.startAutoProcess();
+  }, [toast]);
+
+  return null;
+}