@talex-touch/utils 1.0.39 → 1.0.42

package/renderer/hooks/use-intelligence.ts

@@ -1,12 +1,51 @@
 import type { Ref } from 'vue'
 import type {
-  AiChatPayload,
-  AiEmbeddingPayload,
-  AiInvokeOptions,
-  AiInvokeResult,
-  AiProviderConfig,
-  AiVisionOcrPayload,
-  AiVisionOcrResult,
+  IntelligenceAgentPayload,
+  IntelligenceAgentResult,
+  IntelligenceChatPayload,
+  IntelligenceClassificationPayload,
+  IntelligenceClassificationResult,
+  IntelligenceCodeDebugPayload,
+  IntelligenceCodeDebugResult,
+  IntelligenceCodeExplainPayload,
+  IntelligenceCodeExplainResult,
+  IntelligenceCodeGeneratePayload,
+  IntelligenceCodeGenerateResult,
+  IntelligenceCodeRefactorPayload,
+  IntelligenceCodeRefactorResult,
+  IntelligenceCodeReviewPayload,
+  IntelligenceCodeReviewResult,
+  IntelligenceContentExtractPayload,
+  IntelligenceContentExtractResult,
+  IntelligenceEmbeddingPayload,
+  IntelligenceGrammarCheckPayload,
+  IntelligenceGrammarCheckResult,
+  IntelligenceImageAnalyzePayload,
+  IntelligenceImageAnalyzeResult,
+  IntelligenceImageCaptionPayload,
+  IntelligenceImageCaptionResult,
+  IntelligenceImageGeneratePayload,
+  IntelligenceImageGenerateResult,
+  IntelligenceIntentDetectPayload,
+  IntelligenceIntentDetectResult,
+  IntelligenceInvokeOptions,
+  IntelligenceInvokeResult,
+  IntelligenceKeywordsExtractPayload,
+  IntelligenceKeywordsExtractResult,
+  IntelligenceProviderConfig,
+  IntelligenceRAGQueryPayload,
+  IntelligenceRAGQueryResult,
+  IntelligenceRerankPayload,
+  IntelligenceRerankResult,
+  IntelligenceRewritePayload,
+  IntelligenceSemanticSearchPayload,
+  IntelligenceSemanticSearchResult,
+  IntelligenceSentimentAnalyzePayload,
+  IntelligenceSentimentAnalyzeResult,
+  IntelligenceSummarizePayload,
+  IntelligenceTranslatePayload,
+  IntelligenceVisionOcrPayload,
+  IntelligenceVisionOcrResult,
 } from '../../types/intelligence'
 import { ref } from 'vue'
 import { useChannel } from './use-channel'
@@ -20,11 +59,11 @@ interface IntelligenceComposable {
   invoke: <T = any>(
     capabilityId: string,
     payload: any,
-    options?: AiInvokeOptions,
-  ) => Promise<AiInvokeResult<T>>
+    options?: IntelligenceInvokeOptions,
+  ) => Promise<IntelligenceInvokeResult<T>>
 
   // Provider testing
-  testProvider: (config: AiProviderConfig) => Promise<{
+  testProvider: (config: IntelligenceProviderConfig) => Promise<{
     success: boolean
     message: string
     latency?: number
@@ -50,21 +89,56 @@ interface IntelligenceComposable {
     inputHint: string
   }>
 
-  // Convenient text methods
+  // Text methods
   text: {
-    chat: (payload: AiChatPayload, options?: AiInvokeOptions) => Promise<AiInvokeResult<string>>
-    translate: (payload: { text: string, sourceLang?: string, targetLang: string }, options?: AiInvokeOptions) => Promise<AiInvokeResult<string>>
-    summarize: (payload: { text: string, maxLength?: number, style?: 'concise' | 'detailed' | 'bullet-points' }, options?: AiInvokeOptions) => Promise<AiInvokeResult<string>>
+    chat: (payload: IntelligenceChatPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<string>>
+    translate: (payload: IntelligenceTranslatePayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<string>>
+    summarize: (payload: IntelligenceSummarizePayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<string>>
+    rewrite: (payload: IntelligenceRewritePayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<string>>
+    grammarCheck: (payload: IntelligenceGrammarCheckPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceGrammarCheckResult>>
   }
 
-  // Convenient embedding methods
+  // Embedding methods
   embedding: {
-    generate: (payload: AiEmbeddingPayload, options?: AiInvokeOptions) => Promise<AiInvokeResult<number[]>>
+    generate: (payload: IntelligenceEmbeddingPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<number[]>>
   }
 
-  // Convenient vision methods
+  // Code methods
+  code: {
+    generate: (payload: IntelligenceCodeGeneratePayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceCodeGenerateResult>>
+    explain: (payload: IntelligenceCodeExplainPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceCodeExplainResult>>
+    review: (payload: IntelligenceCodeReviewPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceCodeReviewResult>>
+    refactor: (payload: IntelligenceCodeRefactorPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceCodeRefactorResult>>
+    debug: (payload: IntelligenceCodeDebugPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceCodeDebugResult>>
+  }
+
+  // Analysis methods
+  analysis: {
+    detectIntent: (payload: IntelligenceIntentDetectPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceIntentDetectResult>>
+    analyzeSentiment: (payload: IntelligenceSentimentAnalyzePayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceSentimentAnalyzeResult>>
+    extractContent: (payload: IntelligenceContentExtractPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceContentExtractResult>>
+    extractKeywords: (payload: IntelligenceKeywordsExtractPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceKeywordsExtractResult>>
+    classify: (payload: IntelligenceClassificationPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceClassificationResult>>
+  }
+
+  // Vision methods
   vision: {
-    ocr: (payload: AiVisionOcrPayload, options?: AiInvokeOptions) => Promise<AiInvokeResult<AiVisionOcrResult>>
+    ocr: (payload: IntelligenceVisionOcrPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceVisionOcrResult>>
+    caption: (payload: IntelligenceImageCaptionPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceImageCaptionResult>>
+    analyze: (payload: IntelligenceImageAnalyzePayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceImageAnalyzeResult>>
+    generate: (payload: IntelligenceImageGeneratePayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceImageGenerateResult>>
+  }
+
+  // RAG methods
+  rag: {
+    query: (payload: IntelligenceRAGQueryPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceRAGQueryResult>>
+    semanticSearch: (payload: IntelligenceSemanticSearchPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceSemanticSearchResult>>
+    rerank: (payload: IntelligenceRerankPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceRerankResult>>
+  }
+
+  // Agent methods
+  agent: {
+    run: (payload: IntelligenceAgentPayload, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<IntelligenceAgentResult>>
   }
 
   // Loading state
@@ -143,13 +217,13 @@ export function useIntelligence(_options: UseIntelligenceOptions = {}): Intellig
 
   return {
     // Core invoke
-    invoke: <T = any>(capabilityId: string, payload: any, options?: AiInvokeOptions) =>
+    invoke: <T = any>(capabilityId: string, payload: any, options?: IntelligenceInvokeOptions) =>
       withLoadingState(() =>
-        sendChannelRequest<AiInvokeResult<T>>('intelligence:invoke', { capabilityId, payload, options }),
+        sendChannelRequest<IntelligenceInvokeResult<T>>('intelligence:invoke', { capabilityId, payload, options }),
       ),
 
     // Provider testing
-    testProvider: (config: AiProviderConfig) =>
+    testProvider: (config: IntelligenceProviderConfig) =>
       withLoadingState(() =>
         sendChannelRequest<{
           success: boolean
@@ -175,41 +249,59 @@ export function useIntelligence(_options: UseIntelligenceOptions = {}): Intellig
         inputHint: string
       }>('intelligence:get-capability-test-meta', params),
 
-    // Convenient text methods
+    // Text methods
     text: {
-      chat: (payload: AiChatPayload, options?: AiInvokeOptions) =>
+      chat: (payload: IntelligenceChatPayload, options?: IntelligenceInvokeOptions) =>
         withLoadingState(() =>
-          sendChannelRequest<AiInvokeResult<string>>('intelligence:invoke', {
+          sendChannelRequest<IntelligenceInvokeResult<string>>('intelligence:invoke', {
             capabilityId: 'text.chat',
             payload,
             options,
           }),
         ),
 
-      translate: (payload: { text: string, sourceLang?: string, targetLang: string }, options?: AiInvokeOptions) =>
+      translate: (payload: IntelligenceTranslatePayload, options?: IntelligenceInvokeOptions) =>
         withLoadingState(() =>
-          sendChannelRequest<AiInvokeResult<string>>('intelligence:invoke', {
+          sendChannelRequest<IntelligenceInvokeResult<string>>('intelligence:invoke', {
             capabilityId: 'text.translate',
             payload,
             options,
           }),
         ),
 
-      summarize: (payload: { text: string, maxLength?: number, style?: 'concise' | 'detailed' | 'bullet-points' }, options?: AiInvokeOptions) =>
+      summarize: (payload: IntelligenceSummarizePayload, options?: IntelligenceInvokeOptions) =>
         withLoadingState(() =>
-          sendChannelRequest<AiInvokeResult<string>>('intelligence:invoke', {
+          sendChannelRequest<IntelligenceInvokeResult<string>>('intelligence:invoke', {
             capabilityId: 'text.summarize',
             payload,
             options,
           }),
         ),
+
+      rewrite: (payload: IntelligenceRewritePayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<string>>('intelligence:invoke', {
+            capabilityId: 'text.rewrite',
+            payload,
+            options,
+          }),
+        ),
+
+      grammarCheck: (payload: IntelligenceGrammarCheckPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceGrammarCheckResult>>('intelligence:invoke', {
+            capabilityId: 'text.grammar',
+            payload,
+            options,
+          }),
+        ),
     },
 
-    // Convenient embedding methods
+    // Embedding methods
     embedding: {
-      generate: (payload: AiEmbeddingPayload, options?: AiInvokeOptions) =>
+      generate: (payload: IntelligenceEmbeddingPayload, options?: IntelligenceInvokeOptions) =>
         withLoadingState(() =>
-          sendChannelRequest<AiInvokeResult<number[]>>('intelligence:invoke', {
+          sendChannelRequest<IntelligenceInvokeResult<number[]>>('intelligence:invoke', {
             capabilityId: 'embedding.generate',
             payload,
             options,
@@ -217,16 +309,181 @@ export function useIntelligence(_options: UseIntelligenceOptions = {}): Intellig
         ),
     },
 
-    // Convenient vision methods
+    // Code methods
+    code: {
+      generate: (payload: IntelligenceCodeGeneratePayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceCodeGenerateResult>>('intelligence:invoke', {
+            capabilityId: 'code.generate',
+            payload,
+            options,
+          }),
+        ),
+
+      explain: (payload: IntelligenceCodeExplainPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceCodeExplainResult>>('intelligence:invoke', {
+            capabilityId: 'code.explain',
+            payload,
+            options,
+          }),
+        ),
+
+      review: (payload: IntelligenceCodeReviewPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceCodeReviewResult>>('intelligence:invoke', {
+            capabilityId: 'code.review',
+            payload,
+            options,
+          }),
+        ),
+
+      refactor: (payload: IntelligenceCodeRefactorPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceCodeRefactorResult>>('intelligence:invoke', {
+            capabilityId: 'code.refactor',
+            payload,
+            options,
+          }),
+        ),
+
+      debug: (payload: IntelligenceCodeDebugPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceCodeDebugResult>>('intelligence:invoke', {
+            capabilityId: 'code.debug',
+            payload,
+            options,
+          }),
+        ),
+    },
+
+    // Analysis methods
+    analysis: {
+      detectIntent: (payload: IntelligenceIntentDetectPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceIntentDetectResult>>('intelligence:invoke', {
+            capabilityId: 'intent.detect',
+            payload,
+            options,
+          }),
+        ),
+
+      analyzeSentiment: (payload: IntelligenceSentimentAnalyzePayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceSentimentAnalyzeResult>>('intelligence:invoke', {
+            capabilityId: 'sentiment.analyze',
+            payload,
+            options,
+          }),
+        ),
+
+      extractContent: (payload: IntelligenceContentExtractPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceContentExtractResult>>('intelligence:invoke', {
+            capabilityId: 'content.extract',
+            payload,
+            options,
+          }),
+        ),
+
+      extractKeywords: (payload: IntelligenceKeywordsExtractPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceKeywordsExtractResult>>('intelligence:invoke', {
+            capabilityId: 'keywords.extract',
+            payload,
+            options,
+          }),
+        ),
+
+      classify: (payload: IntelligenceClassificationPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceClassificationResult>>('intelligence:invoke', {
+            capabilityId: 'text.classify',
+            payload,
+            options,
+          }),
+        ),
+    },
+
+    // Vision methods
     vision: {
-      ocr: (payload: AiVisionOcrPayload, options?: AiInvokeOptions) =>
+      ocr: (payload: IntelligenceVisionOcrPayload, options?: IntelligenceInvokeOptions) =>
         withLoadingState(() =>
-          sendChannelRequest<AiInvokeResult<AiVisionOcrResult>>('intelligence:invoke', {
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceVisionOcrResult>>('intelligence:invoke', {
             capabilityId: 'vision.ocr',
             payload,
             options,
           }),
         ),
+
+      caption: (payload: IntelligenceImageCaptionPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceImageCaptionResult>>('intelligence:invoke', {
+            capabilityId: 'image.caption',
+            payload,
+            options,
+          }),
+        ),
+
+      analyze: (payload: IntelligenceImageAnalyzePayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceImageAnalyzeResult>>('intelligence:invoke', {
+            capabilityId: 'image.analyze',
+            payload,
+            options,
+          }),
+        ),
+
+      generate: (payload: IntelligenceImageGeneratePayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceImageGenerateResult>>('intelligence:invoke', {
+            capabilityId: 'image.generate',
+            payload,
+            options,
+          }),
+        ),
+    },
+
+    // RAG methods
+    rag: {
+      query: (payload: IntelligenceRAGQueryPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceRAGQueryResult>>('intelligence:invoke', {
+            capabilityId: 'rag.query',
+            payload,
+            options,
+          }),
+        ),
+
+      semanticSearch: (payload: IntelligenceSemanticSearchPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceSemanticSearchResult>>('intelligence:invoke', {
+            capabilityId: 'search.semantic',
+            payload,
+            options,
+          }),
+        ),
+
+      rerank: (payload: IntelligenceRerankPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceRerankResult>>('intelligence:invoke', {
+            capabilityId: 'search.rerank',
+            payload,
+            options,
+          }),
+        ),
+    },
+
+    // Agent methods
+    agent: {
+      run: (payload: IntelligenceAgentPayload, options?: IntelligenceInvokeOptions) =>
+        withLoadingState(() =>
+          sendChannelRequest<IntelligenceInvokeResult<IntelligenceAgentResult>>('intelligence:invoke', {
+            capabilityId: 'agent.run',
+            payload,
+            options,
+          }),
+        ),
     },
 
     // Reactive state

package/renderer/storage/base-storage.ts

@@ -113,6 +113,15 @@ export function createStorageProxy<T extends object>(key: string, factory: () =>
   })
 }
 
+/**
+ * Save result from main process
+ */
+export interface SaveResult {
+  success: boolean
+  version: number
+  conflict?: boolean
+}
+
 /**
  * A reactive storage utility with optional auto-save and update subscriptions.
  *
@@ -127,6 +136,8 @@ export class TouchStorage<T extends object> {
   private readonly _onUpdate: Array<() => void> = []
   #channelInitialized = false
   #skipNextWatchTrigger = false
+  #currentVersion = 0
+  #isRemoteUpdate = false
 
   /**
    * The reactive data exposed to users.
@@ -189,17 +200,29 @@ export class TouchStorage<T extends object> {
 
     this.#channelInitialized = true
 
-    const result = channel!.sendSync('storage:get', this.#qualifiedName)
-    const parsed = result ? (result as Partial<T>) : {}
-
-    this.assignData(parsed)
+    // Try to get versioned data first, fallback to legacy
+    const versionedResult = channel!.sendSync('storage:get-versioned', this.#qualifiedName) as { data: Partial<T>, version: number } | null
+    if (versionedResult) {
+      this.#currentVersion = versionedResult.version
+      this.assignData(versionedResult.data, true, true)
+    }
+    else {
+      const result = channel!.sendSync('storage:get', this.#qualifiedName)
+      const parsed = result ? (result as Partial<T>) : {}
+      this.#currentVersion = 1
+      this.assignData(parsed, true, true)
+    }
 
-    // Register update listener
+    // Register update listener - only triggered for OTHER windows' changes
+    // (source window is excluded by main process)
     channel!.regChannel('storage:update', ({ data }) => {
-      const { name } = data!
+      const { name, version } = data as { name: string, version?: number }
 
       if (name === this.#qualifiedName) {
-        this.loadFromRemote()
+        // Only reload if remote version is newer
+        if (version === undefined || version > this.#currentVersion) {
+          this.#loadFromRemoteWithVersion()
+        }
       }
     })
 
@@ -209,6 +232,24 @@ export class TouchStorage<T extends object> {
     }
   }
 
+  /**
+   * Load from remote and update version
+   * @private
+   */
+  #loadFromRemoteWithVersion(): void {
+    if (!channel)
+      return
+
+    const versionedResult = channel.sendSync('storage:get-versioned', this.#qualifiedName) as { data: Partial<T>, version: number } | null
+    if (versionedResult && versionedResult.version > this.#currentVersion) {
+      this.#currentVersion = versionedResult.version
+      // Mark as remote update to skip auto-save
+      this.#isRemoteUpdate = true
+      this.assignData(versionedResult.data, true, true)
+      this.#isRemoteUpdate = false
+    }
+  }
+
   /**
    * Returns the unique identifier of this storage.
    *
@@ -253,11 +294,26 @@ export class TouchStorage<T extends object> {
       return
     }
 
-    await channel.send('storage:save', {
+    // Skip save if this is a remote update (to avoid echo)
+    if (this.#isRemoteUpdate) {
+      return
+    }
+
+    const result = await channel.send('storage:save', {
       key: this.#qualifiedName,
       content: JSON.stringify(this.data),
       clear: false,
-    })
+      version: this.#currentVersion,
+    }) as SaveResult
+
+    if (result.success) {
+      this.#currentVersion = result.version
+    }
+    else if (result.conflict) {
+      // Conflict detected - reload from remote
+      console.warn(`[TouchStorage] Conflict detected for "${this.#qualifiedName}", reloading...`)
+      this.#loadFromRemoteWithVersion()
+    }
   }, 300)
 
   /**
@@ -364,8 +420,9 @@ export class TouchStorage<T extends object> {
    *
    * @param newData Partial update data
    * @param stopWatch Whether to stop the watcher during assignment
+   * @param skipSave Whether to skip saving (for remote updates)
    */
-  private assignData(newData: Partial<T>, stopWatch: boolean = true): void {
+  private assignData(newData: Partial<T>, stopWatch: boolean = true, skipSave: boolean = false): void {
     if (stopWatch && this.#autoSave) {
       this.#assigning = true
     }
@@ -385,7 +442,10 @@ export class TouchStorage<T extends object> {
         Promise.resolve().then(resetAssigning)
       }
 
-      this.#runAutoSavePipeline({ force: true })
+      // Only run auto-save pipeline if not a remote update
+      if (!skipSave && !this.#isRemoteUpdate) {
+        this.#runAutoSavePipeline({ force: true })
+      }
     }
   }
 
@@ -444,13 +504,36 @@ export class TouchStorage<T extends object> {
       return this
     }
 
-    const result = channel.sendSync('storage:get', this.#qualifiedName)
-    const parsed = result ? (result as Partial<T>) : {}
-    this.assignData(parsed, true)
-
+    this.#loadFromRemoteWithVersion()
     return this
   }
 
+  /**
+   * Get current version number
+   * @returns Current version
+   */
+  getVersion(): number {
+    return this.#currentVersion
+  }
+
+  /**
+   * Save data synchronously (for window close)
+   * This bypasses debouncing and saves immediately
+   */
+  saveSync(): void {
+    if (!channel)
+      return
+    if (this.#isRemoteUpdate)
+      return
+
+    channel.sendSync('storage:save-sync', {
+      key: this.#qualifiedName,
+      content: JSON.stringify(this.data),
+      clear: false,
+      version: this.#currentVersion,
+    })
+  }
+
   /**
    * Gets the current data state.
    *

package/renderer/storage/intelligence-storage.ts

@@ -1,8 +1,8 @@
-import type { AiProviderConfig, AISDKGlobalConfig, AISDKStorageData } from '../../types/intelligence'
+import type { IntelligenceProviderConfig, AISDKGlobalConfig, AISDKStorageData } from '../../types/intelligence'
 import { StorageList } from '../../common/storage/constants'
 import {
 
-  AiProviderType,
+  IntelligenceProviderType,
 
   DEFAULT_CAPABILITIES,
   DEFAULT_GLOBAL_CONFIG,
@@ -11,8 +11,8 @@ import {
 import { createStorageProxy, TouchStorage } from './base-storage'
 
 // Re-export types for convenience
-export { AiProviderType }
-export type { AiProviderConfig, AISDKGlobalConfig }
+export { IntelligenceProviderType }
+export type { IntelligenceProviderConfig, AISDKGlobalConfig }
 
 const defaultIntelligenceData: AISDKStorageData = {
   providers: [...DEFAULT_PROVIDERS],
@@ -32,7 +32,7 @@ class IntelligenceStorage extends TouchStorage<AISDKStorageData> {
   /**
    * 添加新的提供商
    */
-  addProvider(provider: AiProviderConfig): void {
+  addProvider(provider: IntelligenceProviderConfig): void {
     const currentData = this.get()
     const updatedProviders = [...currentData.providers, provider]
     this.set({
@@ -44,7 +44,7 @@ class IntelligenceStorage extends TouchStorage<AISDKStorageData> {
   /**
    * 更新提供商配置
    */
-  updateProvider(id: string, updatedProvider: Partial<AiProviderConfig>): void {
+  updateProvider(id: string, updatedProvider: Partial<IntelligenceProviderConfig>): void {
     const currentData = this.get()
     const providerIndex = currentData.providers.findIndex(p => p.id === id)
 
@@ -93,14 +93,14 @@ class IntelligenceStorage extends TouchStorage<AISDKStorageData> {
   /**
    * 获取特定类型的提供商
    */
-  getProvidersByType(type: AiProviderType): AiProviderConfig[] {
+  getProvidersByType(type: IntelligenceProviderType): IntelligenceProviderConfig[] {
     return this.get().providers.filter(p => p.type === type)
   }
 
   /**
    * 获取启用的提供商
    */
-  getEnabledProviders(): AiProviderConfig[] {
+  getEnabledProviders(): IntelligenceProviderConfig[] {
     return this.get().providers.filter(p => p.enabled)
   }
 
@@ -113,7 +113,7 @@ class IntelligenceStorage extends TouchStorage<AISDKStorageData> {
       return false
 
     // 检查是否有必要的配置项
-    const hasApiKey = provider.type === AiProviderType.LOCAL || !!provider.apiKey
+    const hasApiKey = provider.type === IntelligenceProviderType.LOCAL || !!provider.apiKey
     const hasModels = !!(provider.models && provider.models.length > 0)
 
     return hasApiKey && hasModels