@talex-touch/utils 1.0.32 → 1.0.33

package/common/utils/polling.ts

@@ -1,3 +1,4 @@
+/* eslint-disable no-console */
 /**
  * @module polling
  * A high-precision, efficient, singleton polling service for scheduling periodic tasks.
@@ -75,7 +76,7 @@ export class PollingService {
       nextRunMs,
     })
 
-    console.log(`[PollingService] Task '${id}' registered to run every ${options.interval} ${options.unit}.`)
+    console.debug(`[PollingService] Task '${id}' registered to run every ${options.interval} ${options.unit}.`)
 
     if (this.isRunning) {
       this._reschedule()

package/core-box/index.ts

@@ -5,3 +5,4 @@ export * from './preview/index'
  * Search box core functionality package
  */
 export * from './tuff/index'
+export * from './recommendation'

package/core-box/recommendation.ts

@@ -0,0 +1,77 @@
+/**
+ * Time-based usage pattern context for recommendation matching.
+ */
+export interface TimePattern {
+  /** Hour of day (0-23) */
+  hourOfDay: number
+  /** Day of week (0-6, 0=Sunday) */
+  dayOfWeek: number
+  /** Whether current time falls within working hours (9-18, weekdays) */
+  isWorkingHours: boolean
+  /** Broad time categorization */
+  timeSlot: 'morning' | 'afternoon' | 'evening' | 'night'
+}
+
+/**
+ * Complete contextual signal for recommendation matching.
+ * Gathered from system state, clipboard, and active applications.
+ */
+export interface ContextSignal {
+  time: TimePattern
+  clipboard?: {
+    type: string
+    /** Hashed content for privacy (not original text) */
+    content: string
+    timestamp: number
+    contentType?: 'url' | 'text' | 'code' | 'file'
+    meta?: {
+      isUrl?: boolean
+      urlDomain?: string
+      textLength?: number
+      fileExtension?: string
+      fileType?: 'code' | 'text' | 'image' | 'document' | 'other'
+      language?: string
+    }
+  }
+  foregroundApp?: {
+    bundleId: string
+    name: string
+  }
+  systemState?: {
+    isOnline: boolean
+    batteryLevel: number
+    isDNDEnabled: boolean
+  }
+}
+
+/**
+ * Scored recommendation item from recommendation engine.
+ */
+export interface ScoredItem {
+  sourceId: string
+  itemId: string
+  score: number
+  source: 'frequent' | 'time-based' | 'recent' | 'trending' | 'context'
+  reason?: string
+}
+
+/**
+ * Recommendation badge display configuration for UI rendering.
+ */
+export interface RecommendationBadge {
+  text: string
+  icon: string
+  variant: 'frequent' | 'intelligent' | 'recent' | 'trending'
+}
+
+/**
+ * Enhanced item metadata for intelligent recommendations.
+ * Attached to TuffItem.meta for rendering and filtering.
+ */
+export interface RecommendationMetadata {
+  score: number
+  source: ScoredItem['source']
+  reason: string
+  isIntelligent: boolean
+  badge: RecommendationBadge
+}

package/electron/index.ts

@@ -1,3 +1,3 @@
-export * from './clipboard-helper'
 export * from './download-manager'
 export * from './env-tool'
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@talex-touch/utils",
-  "version": "1.0.32",
+  "version": "1.0.33",
   "private": false,
   "description": "Tuff series utils",
   "author": "TalexDreamSoul",

package/plugin/sdk/README.md

@@ -0,0 +1,216 @@
+# Plugin SDK 重构说明
+
+## 概述
+
+Plugin SDK 已重构为统一的工厂函数模式，参考 `DivisionBoxSDK` 的设计。旧版本 API 已废弃，调用时会抛出错误。
+
+## 新的 SDK 结构
+
+### 1. BoxSDK - CoreBox 窗口控制
+
+控制 CoreBox 窗口的显示、大小和输入框状态。
+
+```typescript
+// 隐藏/显示 CoreBox
+plugin.box.hide()
+plugin.box.show()
+
+// 扩展窗口（显示更多结果）
+plugin.box.expand({ length: 10 })
+plugin.box.expand({ forceMax: true })
+
+// 收缩窗口
+plugin.box.shrink()
+
+// 控制输入框
+plugin.box.hideInput()
+plugin.box.showInput()
+
+// 获取当前输入
+const input = await plugin.box.getInput()
+```
+
+### 2. FeatureSDK - 搜索结果管理
+
+管理插件推送的搜索结果项（TuffItems）。
+
+```typescript
+// 推送多个结果
+plugin.feature.pushItems([
+  { id: 'item-1', title: { text: 'Result 1' }, ... },
+  { id: 'item-2', title: { text: 'Result 2' }, ... }
+])
+
+// 更新单个结果
+plugin.feature.updateItem('item-1', {
+  title: { text: 'Updated Title' }
+})
+
+// 删除单个结果
+plugin.feature.removeItem('item-1')
+
+// 清空所有结果
+plugin.feature.clearItems()
+
+// 获取所有结果
+const items = plugin.feature.getItems()
+
+// 监听输入变化（实时搜索）
+const unsubscribe = plugin.feature.onInputChange((input) => {
+  console.log('User typed:', input)
+  // 执行实时搜索
+  performSearch(input)
+})
+
+// 取消监听
+unsubscribe()
+```
+
+## 废弃的 API
+
+以下 API 已废弃，调用时会抛出错误：
+
+### 旧的 Box API
+```typescript
+// ❌ 废弃
+plugin.$box.hide()
+plugin.$box.show()
+
+// ✅ 使用新 API
+plugin.box.hide()
+plugin.box.show()
+```
+
+### 旧的 Feature API
+```typescript
+// ❌ 废弃
+plugin.pushItems(items)
+plugin.clearItems()
+plugin.getItems()
+
+// ✅ 使用新 API
+plugin.feature.pushItems(items)
+plugin.feature.clearItems()
+plugin.feature.getItems()
+```
+
+## 迁移指南
+
+### 1. 更新 Box 控制代码
+
+**旧代码：**
+```typescript
+plugin.$box.hide()
+plugin.$box.show()
+```
+
+**新代码：**
+```typescript
+plugin.box.hide()
+plugin.box.show()
+plugin.box.expand({ length: 10 })
+plugin.box.shrink()
+```
+
+### 2. 更新搜索结果管理
+
+**旧代码：**
+```typescript
+plugin.pushItems([...])
+plugin.clearItems()
+const items = plugin.getItems()
+```
+
+**新代码：**
+```typescript
+plugin.feature.pushItems([...])
+plugin.feature.updateItem('id', { ... })
+plugin.feature.removeItem('id')
+plugin.feature.clearItems()
+const items = plugin.feature.getItems()
+```
+
+### 3. 添加实时搜索支持
+
+**新功能：**
+```typescript
+// 在插件初始化时注册监听器
+onInit(context) {
+  context.utils.feature.onInputChange((input) => {
+    // 用户输入变化时触发
+    this.performRealTimeSearch(input)
+  })
+}
+```
+
+## 完整示例
+
+```typescript
+export default {
+  onInit(context) {
+    const { feature, box } = context.utils
+    
+    // 监听输入变化
+    feature.onInputChange((input) => {
+      if (input.length > 2) {
+        // 执行搜索
+        const results = performSearch(input)
+        feature.pushItems(results)
+      } else {
+        feature.clearItems()
+      }
+    })
+  },
+  
+  onFeatureTriggered(featureId, query, feature) {
+    const { feature: featureSDK, box } = this.context.utils
+    
+    // 推送结果
+    featureSDK.pushItems([
+      {
+        id: 'result-1',
+        title: { text: 'Search Result' },
+        subtitle: { text: 'Description' },
+        source: { id: this.pluginName, name: this.pluginName }
+      }
+    ])
+    
+    // 扩展窗口显示结果
+    box.expand({ length: 5 })
+    
+    // 3秒后隐藏
+    setTimeout(() => {
+      box.hide()
+    }, 3000)
+  }
+}
+```
+
+## 技术细节
+
+### SDK 工厂函数
+
+所有 SDK 都通过工厂函数创建：
+
+- `createBoxSDK(channel)` - 创建 Box SDK 实例
+- `createFeatureSDK(boxItems, channel)` - 创建 Feature SDK 实例
+- `createDivisionBoxSDK(channel)` - 创建 DivisionBox SDK 实例
+
+### IPC 通道
+
+新增的 IPC 通道：
+
+- `core-box:hide-input` - 隐藏输入框
+- `core-box:show-input` - 显示输入框
+- `core-box:get-input` - 获取当前输入值
+- `core-box:input-changed` - 输入变化广播（主进程 → 插件）
+- `core-box:set-input-visibility` - 设置输入框可见性（主进程 → 渲染进程）
+- `core-box:request-input-value` - 请求输入值（主进程 → 渲染进程）
+
+### 架构优势
+
+1. **统一的 API 风格** - 所有 SDK 使用相同的工厂函数模式
+2. **更好的类型安全** - TypeScript 类型定义完整
+3. **功能分离** - Box 控制和 Feature 管理职责清晰
+4. **扩展性强** - 易于添加新功能
+5. **向后不兼容** - 强制迁移到新 API，避免技术债务

package/plugin/sdk/box-sdk.ts

@@ -0,0 +1,219 @@
+/**
+ * Box SDK for Plugin Development
+ * 
+ * Provides a unified API for plugins to control the CoreBox window behavior,
+ * including visibility, size, input field control, and input value access.
+ */
+
+/**
+ * Expand options for CoreBox window
+ */
+export interface BoxExpandOptions {
+  /** Number of items to show (affects window height) */
+  length?: number
+  /** Force maximum expansion */
+  forceMax?: boolean
+}
+
+/**
+ * Box SDK interface for plugins
+ * 
+ * @example
+ * ```typescript
+ * // Hide CoreBox
+ * plugin.box.hide()
+ * 
+ * // Show CoreBox
+ * plugin.box.show()
+ * 
+ * // Expand to show 10 items
+ * plugin.box.expand({ length: 10 })
+ * 
+ * // Get current input
+ * const input = plugin.box.getInput()
+ * ```
+ */
+export interface BoxSDK {
+  /**
+   * Hides the CoreBox window
+   * 
+   * @example
+   * ```typescript
+   * plugin.box.hide()
+   * ```
+   */
+  hide(): void
+
+  /**
+   * Shows the CoreBox window
+   * 
+   * @example
+   * ```typescript
+   * plugin.box.show()
+   * ```
+   */
+  show(): void
+
+  /**
+   * Expands the CoreBox window
+   * 
+   * @param options - Optional expansion configuration
+   * 
+   * @example
+   * ```typescript
+   * // Expand to show 10 items
+   * plugin.box.expand({ length: 10 })
+   * 
+   * // Force maximum expansion
+   * plugin.box.expand({ forceMax: true })
+   * 
+   * // Default expansion
+   * plugin.box.expand()
+   * ```
+   */
+  expand(options?: BoxExpandOptions): Promise<void>
+
+  /**
+   * Shrinks the CoreBox window to compact size
+   * 
+   * @example
+   * ```typescript
+   * plugin.box.shrink()
+   * ```
+   */
+  shrink(): Promise<void>
+
+  /**
+   * Hides the input field in CoreBox
+   * 
+   * @example
+   * ```typescript
+   * plugin.box.hideInput()
+   * ```
+   */
+  hideInput(): Promise<void>
+
+  /**
+   * Shows the input field in CoreBox
+   * 
+   * @example
+   * ```typescript
+   * plugin.box.showInput()
+   * ```
+   */
+  showInput(): Promise<void>
+
+  /**
+   * Gets the current input value from CoreBox search field
+   * 
+   * @returns Promise resolving to the current input string
+   * 
+   * @example
+   * ```typescript
+   * const input = await plugin.box.getInput()
+   * console.log('Current input:', input)
+   * ```
+   */
+  getInput(): Promise<string>
+}
+
+/**
+ * Creates a Box SDK instance for plugin use
+ * 
+ * @param channel - The plugin channel bridge for IPC communication
+ * @returns Configured Box SDK instance
+ * 
+ * @internal
+ */
+export function createBoxSDK(channel: any): BoxSDK {
+  const sendFn = channel.sendToMain || channel.send
+
+  if (!sendFn) {
+    throw new Error('[Box SDK] Channel send function not available')
+  }
+
+  return {
+    hide(): void {
+      sendFn('core-box:hide').catch((error: any) => {
+        console.error('[Box SDK] Failed to hide CoreBox:', error)
+      })
+    },
+
+    show(): void {
+      sendFn('core-box:show').catch((error: any) => {
+        console.error('[Box SDK] Failed to show CoreBox:', error)
+      })
+    },
+
+    async expand(options?: BoxExpandOptions): Promise<void> {
+      try {
+        await sendFn('core-box:expand', options || {})
+      } catch (error) {
+        console.error('[Box SDK] Failed to expand CoreBox:', error)
+        throw error
+      }
+    },
+
+    async shrink(): Promise<void> {
+      try {
+        await sendFn('core-box:expand', { mode: 'collapse' })
+      } catch (error) {
+        console.error('[Box SDK] Failed to shrink CoreBox:', error)
+        throw error
+      }
+    },
+
+    async hideInput(): Promise<void> {
+      try {
+        await sendFn('core-box:hide-input')
+      } catch (error) {
+        console.error('[Box SDK] Failed to hide input:', error)
+        throw error
+      }
+    },
+
+    async showInput(): Promise<void> {
+      try {
+        await sendFn('core-box:show-input')
+      } catch (error) {
+        console.error('[Box SDK] Failed to show input:', error)
+        throw error
+      }
+    },
+
+    async getInput(): Promise<string> {
+      try {
+        const result = await sendFn('core-box:get-input')
+        return result?.data?.input || result?.input || ''
+      } catch (error) {
+        console.error('[Box SDK] Failed to get input:', error)
+        throw error
+      }
+    }
+  }
+}
+
+/**
+ * Hook for using Box SDK in plugin context
+ * 
+ * @returns Box SDK instance
+ * 
+ * @example
+ * ```typescript
+ * const box = useBox()
+ * 
+ * box.hide()
+ * box.expand({ length: 10 })
+ * const input = await box.getInput()
+ * ```
+ */
+export function useBox(): BoxSDK {
+  // @ts-ignore - window.$channel is injected by the plugin system
+  const channel = window.$channel
+  
+  if (!channel) {
+    throw new Error('[Box SDK] Channel not available. Make sure this is called in a plugin context.')
+  }
+  
+  return createBoxSDK(channel)
+}

package/plugin/sdk/feature-sdk.ts

@@ -0,0 +1,235 @@
+/**
+ * Feature SDK for Plugin Development
+ * 
+ * Provides a unified API for plugins to manage search result items (TuffItems)
+ * in the CoreBox interface. This SDK handles item lifecycle, updates, and
+ * input change notifications.
+ */
+
+import type { TuffItem } from '../../core-box/tuff'
+
+/**
+ * Input change event handler
+ */
+export type InputChangeHandler = (input: string) => void
+
+/**
+ * Feature SDK interface for plugins
+ * 
+ * @example
+ * ```typescript
+ * // Push items to CoreBox
+ * plugin.feature.pushItems([
+ *   { id: 'item-1', title: 'Result 1', ... },
+ *   { id: 'item-2', title: 'Result 2', ... }
+ * ])
+ * 
+ * // Update a specific item
+ * plugin.feature.updateItem('item-1', { title: 'Updated Title' })
+ * 
+ * // Listen for input changes
+ * plugin.feature.onInputChange((input) => {
+ *   console.log('User typed:', input)
+ * })
+ * ```
+ */
+export interface FeatureSDK {
+  /**
+   * Pushes multiple items to the CoreBox search results
+   * 
+   * @param items - Array of TuffItem objects to display
+   * 
+   * @example
+   * ```typescript
+   * plugin.feature.pushItems([
+   *   {
+   *     id: 'calc-result',
+   *     title: { text: '42' },
+   *     subtitle: { text: 'Calculation result' },
+   *     source: { id: 'calculator', name: 'Calculator' }
+   *   }
+   * ])
+   * ```
+   */
+  pushItems(items: TuffItem[]): void
+
+  /**
+   * Updates a specific item by ID
+   * 
+   * @param id - The unique ID of the item to update
+   * @param updates - Partial TuffItem with fields to update
+   * 
+   * @example
+   * ```typescript
+   * // Update title and subtitle
+   * plugin.feature.updateItem('item-1', {
+   *   title: { text: 'New Title' },
+   *   subtitle: { text: 'Updated subtitle' }
+   * })
+   * ```
+   */
+  updateItem(id: string, updates: Partial<TuffItem>): void
+
+  /**
+   * Removes a specific item by ID
+   * 
+   * @param id - The unique ID of the item to remove
+   * 
+   * @example
+   * ```typescript
+   * plugin.feature.removeItem('item-1')
+   * ```
+   */
+  removeItem(id: string): void
+
+  /**
+   * Clears all items pushed by this plugin
+   * 
+   * @example
+   * ```typescript
+   * plugin.feature.clearItems()
+   * ```
+   */
+  clearItems(): void
+
+  /**
+   * Gets all items currently pushed by this plugin
+   * 
+   * @returns Array of TuffItem objects
+   * 
+   * @example
+   * ```typescript
+   * const items = plugin.feature.getItems()
+   * console.log(`Currently showing ${items.length} items`)
+   * ```
+   */
+  getItems(): TuffItem[]
+
+  /**
+   * Registers a listener for input changes in the CoreBox search field
+   * 
+   * @param handler - Callback function invoked when input changes
+   * @returns Unsubscribe function
+   * 
+   * @example
+   * ```typescript
+   * const unsubscribe = plugin.feature.onInputChange((input) => {
+   *   console.log('User typed:', input)
+   *   // Perform real-time search
+   *   performSearch(input)
+   * })
+   * 
+   * // Later, unsubscribe
+   * unsubscribe()
+   * ```
+   */
+  onInputChange(handler: InputChangeHandler): () => void
+}
+
+/**
+ * Creates a Feature SDK instance for plugin use
+ * 
+ * @param boxItemsAPI - The boxItems API object from plugin context
+ * @param channel - The plugin channel bridge for IPC communication
+ * @returns Configured Feature SDK instance
+ * 
+ * @internal
+ */
+export function createFeatureSDK(boxItemsAPI: any, channel: any): FeatureSDK {
+  const inputChangeHandlers: Set<InputChangeHandler> = new Set()
+
+  // Register listener for input change events from main process
+  const registerListener = () => {
+    if (channel.onMain) {
+      // Main process plugin context
+      channel.onMain('core-box:input-changed', (event: any) => {
+        const input = event.data?.input || event.input || ''
+        inputChangeHandlers.forEach(handler => handler(input))
+      })
+    } else if (channel.on) {
+      // Renderer process context
+      channel.on('core-box:input-changed', (data: any) => {
+        const input = data?.input || data || ''
+        inputChangeHandlers.forEach(handler => handler(input))
+      })
+    }
+  }
+
+  registerListener()
+
+  return {
+    pushItems(items: TuffItem[]): void {
+      if (!boxItemsAPI || !boxItemsAPI.pushItems) {
+        throw new Error('[Feature SDK] boxItems API not available')
+      }
+      boxItemsAPI.pushItems(items)
+    },
+
+    updateItem(id: string, updates: Partial<TuffItem>): void {
+      if (!boxItemsAPI || !boxItemsAPI.update) {
+        throw new Error('[Feature SDK] boxItems API not available')
+      }
+      boxItemsAPI.update(id, updates)
+    },
+
+    removeItem(id: string): void {
+      if (!boxItemsAPI || !boxItemsAPI.remove) {
+        throw new Error('[Feature SDK] boxItems API not available')
+      }
+      boxItemsAPI.remove(id)
+    },
+
+    clearItems(): void {
+      if (!boxItemsAPI || !boxItemsAPI.clear) {
+        throw new Error('[Feature SDK] boxItems API not available')
+      }
+      boxItemsAPI.clear()
+    },
+
+    getItems(): TuffItem[] {
+      if (!boxItemsAPI || !boxItemsAPI.getItems) {
+        throw new Error('[Feature SDK] boxItems API not available')
+      }
+      return boxItemsAPI.getItems()
+    },
+
+    onInputChange(handler: InputChangeHandler): () => void {
+      inputChangeHandlers.add(handler)
+      
+      return () => {
+        inputChangeHandlers.delete(handler)
+      }
+    }
+  }
+}
+
+/**
+ * Hook for using Feature SDK in plugin context
+ * 
+ * @returns Feature SDK instance
+ * 
+ * @example
+ * ```typescript
+ * const feature = useFeature()
+ * 
+ * feature.pushItems([
+ *   { id: '1', title: { text: 'Item 1' }, ... }
+ * ])
+ * ```
+ */
+export function useFeature(): FeatureSDK {
+  // @ts-ignore - window.$boxItems and window.$channel are injected by the plugin system
+  const boxItemsAPI = window.$boxItems
+  // @ts-ignore
+  const channel = window.$channel
+  
+  if (!boxItemsAPI) {
+    throw new Error('[Feature SDK] boxItems API not available. Make sure this is called in a plugin context.')
+  }
+  
+  if (!channel) {
+    throw new Error('[Feature SDK] Channel not available. Make sure this is called in a plugin context.')
+  }
+  
+  return createFeatureSDK(boxItemsAPI, channel)
+}

package/plugin/sdk/index.ts

@@ -7,10 +7,12 @@ export interface ITouchSDK {
 
 // Note: Window.$touchSDK is declared in ../preload.ts to avoid duplicate declarations
 
+export * from './box-sdk'
 export * from './channel'
 export * from './clipboard'
 export * from './core-box'
 export * from './division-box'
+export * from './feature-sdk'
 export { createFeaturesManager, useFeatures } from './features'
 
 export * from './hooks/index'

package/plugin/sdk/types.ts

@@ -183,6 +183,18 @@ export interface IPluginUtils {
    */
   divisionBox: import('./division-box').DivisionBoxSDK
 
+  /**
+   * Box SDK for controlling CoreBox window behavior
+   * @see {@link BoxSDK}
+   */
+  box: import('./box-sdk').BoxSDK
+
+  /**
+   * Feature SDK for managing search result items
+   * @see {@link FeatureSDK}
+   */
+  feature: import('./feature-sdk').FeatureSDK
+
   /**
    * Opens a URL in the default browser
    * @param url - The URL to open
@@ -190,21 +202,22 @@ export interface IPluginUtils {
   openUrl: (url: string) => void
 
   /**
-   * Pushes search result items to the search interface
-   * @param items - Array of search result items to add
+   * @deprecated Use plugin.feature.pushItems() instead
+   * @throws Error indicating the API is deprecated
    */
-  pushItems: (items: any[]) => void
+  pushItems: (items: any[]) => never
 
   /**
-   * Clears all current search results
+   * @deprecated Use plugin.feature.clearItems() instead
+   * @throws Error indicating the API is deprecated
    */
-  clearItems: () => void
+  clearItems: () => never
 
   /**
-   * Gets all current search result items
-   * @returns Array of current search result items
+   * @deprecated Use plugin.feature.getItems() instead
+   * @throws Error indicating the API is deprecated
    */
-  getItems: () => any[]
+  getItems: () => never
 
   /**
    * Features manager for dynamic feature management

package/renderer/storage/intelligence-storage.ts

@@ -18,7 +18,7 @@ const defaultIntelligenceData: AISDKStorageData = {
   providers: [...DEFAULT_PROVIDERS],
   globalConfig: { ...DEFAULT_GLOBAL_CONFIG },
   capabilities: { ...DEFAULT_CAPABILITIES },
-  version: 1,
+  version: 2,
 }
 
 const INTELLIGENCE_STORAGE_KEY = `storage:${StorageList.IntelligenceConfig}`
@@ -145,8 +145,9 @@ export async function migrateIntelligenceSettings(): Promise<void> {
   console.log('[Intelligence Storage] Starting migration check...')
   const currentData = intelligenceStorage.data
 
-  if (!currentData.version || currentData.version < 1) {
-    console.log('[Intelligence Storage] Migrating settings to version 1')
+  // Version 2: Force update capabilities to include all new ones
+  if (!currentData.version || currentData.version < 2) {
+    console.log('[Intelligence Storage] Migrating settings to version 2')
 
     const migratedProviders = currentData.providers.map(provider => ({
       ...provider,
@@ -169,24 +170,26 @@ export async function migrateIntelligenceSettings(): Promise<void> {
       cacheExpiration: currentData.globalConfig?.cacheExpiration ?? 3600,
     }
 
-    const migratedCapabilities = currentData.capabilities ?? { ...DEFAULT_CAPABILITIES }
-
+    // Force update to latest DEFAULT_CAPABILITIES (version 2)
+    console.log('[Intelligence Storage] Updating capabilities to latest defaults')
+    
     intelligenceStorage.applyData({
       providers: migratedProviders,
       globalConfig: migratedGlobalConfig,
-      capabilities: migratedCapabilities,
-      version: 1,
+      capabilities: { ...DEFAULT_CAPABILITIES },
+      version: 2,
     })
 
     await intelligenceStorage.saveToRemote({ force: true })
 
-    console.log('[Intelligence Storage] Migration complete')
+    console.log('[Intelligence Storage] Migration to v2 complete, capabilities count:', Object.keys(DEFAULT_CAPABILITIES).length)
   }
   else {
     console.log('[Intelligence Storage] No migration needed, current version:', currentData.version)
   }
 
   console.log('[Intelligence Storage] Final providers count:', intelligenceStorage.data.providers.length)
+  console.log('[Intelligence Storage] Final capabilities count:', Object.keys(intelligenceStorage.data.capabilities).length)
 }
 
 /**
@@ -201,7 +204,7 @@ export async function resetIntelligenceConfig(): Promise<void> {
     providers: [...DEFAULT_PROVIDERS],
     globalConfig: { ...DEFAULT_GLOBAL_CONFIG },
     capabilities: { ...DEFAULT_CAPABILITIES },
-    version: 1,
+    version: 2,
   })
 
   await intelligenceStorage.saveToRemote({ force: true })

package/types/intelligence.ts

@@ -382,7 +382,7 @@ export const DEFAULT_CAPABILITIES: Record<string, AISDKCapabilityConfig> = {
   },
   'embedding.generate': {
     id: 'embedding.generate',
-    label: 'Embedding',
+    label: 'Embedding / 向量生成',
     description: '为向量检索/摘要生成 embedding',
     providers: [
       {
@@ -391,11 +391,17 @@ export const DEFAULT_CAPABILITIES: Record<string, AISDKCapabilityConfig> = {
         priority: 1,
         enabled: true,
       },
+      {
+        providerId: 'openai-default',
+        models: ['text-embedding-3-small', 'text-embedding-3-large'],
+        priority: 2,
+        enabled: false,
+      },
     ],
   },
   'vision.ocr': {
     id: 'vision.ocr',
-    label: '图像 OCR',
+    label: '图像 OCR / Image Recognition',
     description: '识别截图、图片中的文字并生成关键词',
     promptTemplate:
       '你是 OCR 助手，识别图片所有文本，生成 keywords 数组（5 个以内）辅助搜索。',
@@ -403,10 +409,198 @@ export const DEFAULT_CAPABILITIES: Record<string, AISDKCapabilityConfig> = {
     providers: [
       {
         providerId: 'siliconflow-default',
-        models: ['deepseek-ai/DeepSeek-OCR', 'deepseek-ai/DeepSeek-R1-0528-Qwen3-8B'],
+        models: ['deepseek-ai/DeepSeek-OCR', 'THUDM/GLM-4.1V-9B-Thinking'],
         priority: 1,
         enabled: true,
-        metadata: { defaultVisionModel: 'deepseek-ai/DeepSeek-OCR' },
+      },
+      {
+        providerId: 'openai-default',
+        models: ['gpt-4o', 'gpt-4o-mini'],
+        priority: 2,
+        enabled: false,
+      },
+      {
+        providerId: 'anthropic-default',
+        models: ['claude-3-5-sonnet-20241022'],
+        priority: 3,
+        enabled: false,
+      },
+    ],
+  },
+  'text.translate': {
+    id: 'text.translate',
+    label: '翻译 / Translation',
+    description: '多语言文本翻译',
+    promptTemplate: '你是专业翻译助手。请将以下文本翻译成 {{targetLang}}，只返回译文，不要解释。',
+    providers: [
+      { providerId: 'deepseek-default', priority: 1, enabled: true },
+      { providerId: 'openai-default', priority: 2, enabled: false },
+      { providerId: 'anthropic-default', priority: 3, enabled: false },
+    ],
+  },
+  'text.summarize': {
+    id: 'text.summarize',
+    label: '摘要 / Summarization',
+    description: '生成文本内容的简洁摘要',
+    promptTemplate: '请用简洁的语言总结以下内容的核心要点，不超过 {{maxLength}} 字。',
+    providers: [
+      { providerId: 'deepseek-default', priority: 1, enabled: true },
+      { providerId: 'openai-default', priority: 2, enabled: false },
+      { providerId: 'anthropic-default', priority: 3, enabled: false },
+    ],
+  },
+  'intent.detect': {
+    id: 'intent.detect',
+    label: '意图识别 / Intent Detection',
+    description: '识别用户查询的意图类型（搜索、打开、计算等）',
+    promptTemplate: '分析用户输入的意图，返回 JSON 格式：{intent: string, confidence: number, entities: string[]}',
+    providers: [
+      { providerId: 'deepseek-default', priority: 1, enabled: true },
+      { providerId: 'openai-default', priority: 2, enabled: false },
+    ],
+  },
+  'code.generate': {
+    id: 'code.generate',
+    label: '代码生成 / Code Generation',
+    description: '根据需求生成代码片段',
+    promptTemplate: '你是编程助手。根据需求生成 {{language}} 代码，包含注释说明。',
+    providers: [
+      { providerId: 'deepseek-default', models: ['deepseek-coder'], priority: 1, enabled: true },
+      { providerId: 'openai-default', models: ['gpt-4o'], priority: 2, enabled: false },
+    ],
+  },
+  'code.explain': {
+    id: 'code.explain',
+    label: '代码解释 / Code Explanation',
+    description: '解释代码的功能和逻辑',
+    promptTemplate: '你是编程导师。用通俗易懂的语言解释这段代码的功能、逻辑和关键点。',
+    providers: [
+      { providerId: 'deepseek-default', models: ['deepseek-coder'], priority: 1, enabled: true },
+      { providerId: 'anthropic-default', priority: 2, enabled: false },
+    ],
+  },
+  'content.extract': {
+    id: 'content.extract',
+    label: '内容提取 / Content Extraction',
+    description: '从文本中提取关键信息（日期、人名、地点等）',
+    promptTemplate: '从文本中提取关键信息，返回 JSON 格式：{dates: [], people: [], locations: [], keywords: []}',
+    providers: [
+      { providerId: 'deepseek-default', priority: 1, enabled: true },
+      { providerId: 'openai-default', priority: 2, enabled: false },
+    ],
+  },
+  'sentiment.analyze': {
+    id: 'sentiment.analyze',
+    label: '情感分析 / Sentiment Analysis',
+    description: '分析文本的情感倾向（积极/消极/中性）',
+    promptTemplate: '分析文本情感倾向，返回 JSON：{sentiment: "positive"|"negative"|"neutral", score: 0-1, keywords: []}',
+    providers: [
+      { providerId: 'deepseek-default', priority: 1, enabled: true },
+      { providerId: 'openai-default', priority: 2, enabled: false },
+    ],
+  },
+  'code.review': {
+    id: 'code.review',
+    label: '代码审查 / Code Review',
+    description: '审查代码，发现潜在问题、最佳实践和改进建议',
+    promptTemplate: '作为资深代码审查员，审查以下代码。关注：1) 潜在bug 2) 性能问题 3) 安全隐患 4) 最佳实践 5) 可读性',
+    providers: [
+      { providerId: 'deepseek-default', models: ['deepseek-coder'], priority: 1, enabled: true },
+      { providerId: 'anthropic-default', priority: 2, enabled: false },
+      { providerId: 'openai-default', models: ['gpt-4o'], priority: 3, enabled: false },
+    ],
+  },
+  'keywords.extract': {
+    id: 'keywords.extract',
+    label: '关键词提取 / Keyword Extraction',
+    description: '从文本中提取关键词和短语',
+    promptTemplate: '从文本中提取最重要的关键词，返回 JSON 数组：{keywords: [{term: string, relevance: number}]}',
+    providers: [
+      { providerId: 'deepseek-default', priority: 1, enabled: true },
+      { providerId: 'openai-default', priority: 2, enabled: false },
+    ],
+  },
+  'audio.transcribe': {
+    id: 'audio.transcribe',
+    label: '音频转录 / Audio Transcription',
+    description: '将语音转换为文字（支持多语言）',
+    providers: [
+      {
+        providerId: 'openai-default',
+        models: ['whisper-1'],
+        priority: 1,
+        enabled: false,
+      },
+      {
+        providerId: 'siliconflow-default',
+        models: ['TeleAI/TeleSpeechASR'],
+        priority: 2,
+        enabled: true,
+      },
+    ],
+  },
+  'audio.tts': {
+    id: 'audio.tts',
+    label: '语音合成 / Text-to-Speech',
+    description: '将文字转换为自然语音',
+    providers: [
+      {
+        providerId: 'openai-default',
+        models: ['tts-1', 'tts-1-hd'],
+        priority: 1,
+        enabled: false,
+      },
+    ],
+  },
+  'image.caption': {
+    id: 'image.caption',
+    label: '图像标题 / Image Captioning',
+    description: '为图片生成描述性标题',
+    promptTemplate: '生成简洁准确的图片描述（中英文），捕捉主要内容和氛围。',
+    providers: [
+      {
+        providerId: 'siliconflow-default',
+        models: ['THUDM/GLM-4.1V-9B-Thinking'],
+        priority: 1,
+        enabled: true,
+      },
+      {
+        providerId: 'openai-default',
+        models: ['gpt-4o', 'gpt-4o-mini'],
+        priority: 2,
+        enabled: false,
+      },
+      {
+        providerId: 'anthropic-default',
+        models: ['claude-3-5-sonnet-20241022'],
+        priority: 3,
+        enabled: false,
+      },
+    ],
+  },
+  'image.analyze': {
+    id: 'image.analyze',
+    label: '图像分析 / Image Analysis',
+    description: '深度分析图像内容、物体、场景和上下文',
+    promptTemplate: '详细分析图片，包括：物体识别、场景理解、颜色分析、构图评估。返回结构化结果。',
+    providers: [
+      {
+        providerId: 'siliconflow-default',
+        models: ['THUDM/GLM-4.1V-9B-Thinking'],
+        priority: 1,
+        enabled: true,
+      },
+      {
+        providerId: 'openai-default',
+        models: ['gpt-4o'],
+        priority: 2,
+        enabled: false,
+      },
+      {
+        providerId: 'anthropic-default',
+        models: ['claude-3-5-sonnet-20241022'],
+        priority: 3,
+        enabled: false,
       },
     ],
   },

package/types/update.ts

@@ -51,6 +51,18 @@ export interface UpdateCheckResult {
   source: string
 }
 
+export type UpdateUserAction = 'update-now' | 'skip' | 'remind-later'
+
+export interface CachedUpdateRecord {
+  release: GitHubRelease
+  channel: AppPreviewChannel
+  status: 'pending' | 'skipped' | 'snoozed' | 'acknowledged'
+  fetchedAt: number
+  snoozeUntil?: number | null
+  tag: string
+  source: string
+}
+
 /**
  * Custom provider definition used to extend the updater beyond the built-ins.
  */

package/electron/clipboard-helper.ts

@@ -1,207 +0,0 @@
-import { clipboard } from 'electron'
-
-/**
- * Represents a file object from the clipboard
- */
-interface ClipboardFileInfo {
-  /** File data as a buffer */
-  buffer: Buffer
-  /** MIME type of the file */
-  mimetype: string
-  /** Original filename */
-  originalname: string
-}
-
-/**
- * Possible return types from clipboard file operations
- */
-export type ClipboardFileResult = string | ClipboardFileInfo
-
-/**
- * Utility class for handling clipboard file operations across different platforms
- */
-export class ClipboardHelper {
-  /**
-   * Check if the current platform is macOS
-   * @private
-   */
-  private get isMac(): boolean {
-    return process.platform === 'darwin'
-  }
-
-  /**
-   * Generate a unique identifier with specified length and radix
-   * @param length - Length of the generated string
-   * @param radix - Radix for number conversion (default: 16)
-   * @returns Generated unique identifier
-   * @private
-   */
-  private generateUuid(length: number, radix: number = 16): string {
-    const chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'.split('')
-    const uuid: string[] = []
-    let i: number
-
-    radix = radix || chars.length
-
-    if (length) {
-      for (i = 0; i < length; i++) {
-        uuid[i] = chars[0 | (Math.random() * radix)]
-      }
-    }
-    else {
-      let r: number
-      uuid[8] = uuid[13] = uuid[18] = uuid[23] = '-'
-      uuid[14] = '4'
-
-      for (i = 0; i < 36; i++) {
-        if (!uuid[i]) {
-          r = 0 | (Math.random() * 16)
-          uuid[i] = chars[i === 19 ? (r & 0x3) | 0x8 : r]
-        }
-      }
-    }
-
-    return uuid.join('')
-  }
-
-  /**
-   * Process clipboard files on macOS platform
-   * @returns Array of file paths or file info objects
-   * @private
-   */
-  private getClipboardFilesMac(): ClipboardFileResult[] {
-    let filePath: ClipboardFileResult[] = []
-
-    if (clipboard.has('NSFilenamesPboardType')) {
-      // Handle multiple files
-      const tagContent = clipboard.read('NSFilenamesPboardType').match(/<string>.*<\/string>/g)
-      filePath = tagContent ? tagContent.map(item => item.replace(/<string>|<\/string>/g, '')) : []
-    }
-    else {
-      // Handle single file
-      const clipboardImage = clipboard.readImage('clipboard')
-      if (!clipboardImage.isEmpty()) {
-        // Handle image from clipboard
-        const png = clipboardImage.toPNG()
-        const fileInfo: ClipboardFileInfo = {
-          buffer: png,
-          mimetype: 'image/png',
-          originalname: `${this.generateUuid(8, 16)}.png`,
-        }
-        filePath = [fileInfo]
-      }
-      else {
-        // Handle single file path
-        const fileUrl = clipboard.read('public.file-url')
-        if (fileUrl) {
-          filePath = [fileUrl.replace('file://', '')].filter(item => item)
-        }
-      }
-    }
-
-    return filePath
-  }
-
-  /**
-   * Process clipboard files on Windows platform
-   * @returns Array of file paths or file info objects
-   * @private
-   */
-  private getClipboardFilesWindows(): ClipboardFileResult[] {
-    let filePath: ClipboardFileResult[] = []
-
-    if (clipboard.has('CF_HDROP')) {
-      // Handle multiple files
-      const rawFilePathStr = clipboard.readBuffer('CF_HDROP').toString('ucs2') || ''
-      let formatFilePathStr = [...rawFilePathStr]
-        .filter((_, index) => rawFilePathStr.charCodeAt(index) !== 0)
-        .join('')
-        .replace(/\\/g, '\\\\')
-
-      const drivePrefix = formatFilePathStr.match(/[a-z]:\\/i)
-
-      if (drivePrefix) {
-        const drivePrefixIndex = formatFilePathStr.indexOf(drivePrefix[0])
-        if (drivePrefixIndex !== 0) {
-          formatFilePathStr = formatFilePathStr.substring(drivePrefixIndex)
-        }
-        filePath = formatFilePathStr
-          .split(drivePrefix[0])
-          .filter(item => item)
-          .map(item => drivePrefix[0] + item)
-      }
-    }
-    else {
-      // Handle single file
-      const clipboardImage = clipboard.readImage('clipboard')
-      if (!clipboardImage.isEmpty()) {
-        // Handle image from clipboard
-        const png = clipboardImage.toPNG()
-        const fileInfo: ClipboardFileInfo = {
-          buffer: png,
-          mimetype: 'image/png',
-          originalname: `${this.generateUuid(8, 16)}.png`,
-        }
-        filePath = [fileInfo]
-      }
-      else {
-        // Handle single file path
-        try {
-          const fileName = clipboard.readBuffer('FileNameW').toString('ucs2').replace(new RegExp(String.fromCharCode(0), 'g'), '')
-          if (fileName) {
-            filePath = [fileName]
-          }
-        }
-        catch (error) {
-          // Ignore read errors for non-file clipboard content
-        }
-      }
-    }
-
-    return filePath
-  }
-
-  /**
-   * Retrieves file paths or file information from the system clipboard
-   *
-   * This method handles both file paths and images from the clipboard across different platforms.
-   * On macOS, it uses NSFilenamesPboardType for multiple files and public.file-url for single files.
-   * On Windows, it uses CF_HDROP for multiple files and FileNameW for single files.
-   *
-   * @returns Array of file paths (strings) or file info objects containing buffer data for images
-   * @throws {Error} When clipboard access fails or platform is unsupported
-   *
-   * @example
-   * ```typescript
-   * const clipboardHelper = new ClipboardHelper()
-   * const files = clipboardHelper.getClipboardFiles()
-   *
-   * files.forEach(file => {
-   *   if (typeof file === 'string') {
-   *     console.log('File path:', file)
-   *   } else {
-   *     console.log('Image file:', file.originalname, 'Size:', file.buffer.length)
-   *   }
-   * })
-   * ```
-   */
-  public getClipboardFiles(): ClipboardFileResult[] {
-    try {
-      if (this.isMac) {
-        return this.getClipboardFilesMac()
-      }
-      else {
-        return this.getClipboardFilesWindows()
-      }
-    }
-    catch (error) {
-      console.error('Failed to read clipboard files:', error)
-      return []
-    }
-  }
-}
-
-/**
- * Default export of ClipboardHelper class for convenience
- */
-export default ClipboardHelper