@talex-touch/utils 1.0.32 → 1.0.34

package/renderer/storage/storage-subscription.ts

@@ -0,0 +1,196 @@
+import type { IStorageChannel } from './base-storage'
+
+/**
+ * Storage subscription callback type
+ */
+export type StorageSubscriptionCallback = (data: any) => void
+
+/**
+ * Storage subscription manager for renderer process
+ * Provides easy subscription to storage updates via channel events
+ */
+class StorageSubscriptionManager {
+  private channel: IStorageChannel | null = null
+  private subscribers = new Map<string, Set<StorageSubscriptionCallback>>()
+  private channelListenerRegistered = false
+  private pendingUpdates = new Map<string, NodeJS.Timeout>()
+
+  /**
+   * Initialize the subscription manager with a channel
+   */
+  init(channel: IStorageChannel): void {
+    this.channel = channel
+
+    if (!this.channelListenerRegistered) {
+      // Listen to storage:update events from main process
+      this.channel.regChannel('storage:update', ({ data }) => {
+        const { name } = data as { name: string }
+        this.handleStorageUpdate(name)
+      })
+      this.channelListenerRegistered = true
+    }
+  }
+
+  /**
+   * Subscribe to storage changes for a specific config
+   * @param configName - The configuration file name (e.g., 'app-setting.ini')
+   * @param callback - Callback function to receive updates
+   * @returns Unsubscribe function
+   * 
+   * @example
+   * ```typescript
+   * const unsubscribe = subscribeStorage('app-setting.ini', (data) => {
+   *   console.log('Config updated:', data)
+   * })
+   * 
+   * // Later:
+   * unsubscribe()
+   * ```
+   */
+  subscribe(configName: string, callback: StorageSubscriptionCallback): () => void {
+    if (!this.subscribers.has(configName)) {
+      this.subscribers.set(configName, new Set())
+    }
+
+    this.subscribers.get(configName)!.add(callback)
+
+    // Immediately load and call with current data
+    if (this.channel) {
+      const currentData = this.channel.sendSync('storage:get', configName)
+      if (currentData) {
+        try {
+          callback(currentData)
+        }
+        catch (error) {
+          console.error(`[StorageSubscription] Callback error for "${configName}":`, error)
+        }
+      }
+    }
+
+    // Return unsubscribe function
+    return () => {
+      this.unsubscribe(configName, callback)
+    }
+  }
+
+  /**
+   * Unsubscribe from storage changes
+   * @param configName - The configuration file name
+   * @param callback - The same callback function used in subscribe
+   */
+  unsubscribe(configName: string, callback: StorageSubscriptionCallback): void {
+    const callbacks = this.subscribers.get(configName)
+    if (callbacks) {
+      callbacks.delete(callback)
+      if (callbacks.size === 0) {
+        this.subscribers.delete(configName)
+      }
+    }
+  }
+
+  /**
+   * Handle storage update events from main process
+   * @private
+   */
+  private async handleStorageUpdate(configName: string): Promise<void> {
+    const callbacks = this.subscribers.get(configName)
+    if (!callbacks || callbacks.size === 0) {
+      return
+    }
+
+    if (!this.channel) {
+      return
+    }
+
+    // Debounce updates to avoid excessive IPC and callback invocations
+    const existing = this.pendingUpdates.get(configName)
+    if (existing) {
+      clearTimeout(existing)
+    }
+
+    const timer = setTimeout(async () => {
+      // Fetch latest data
+      const data = await this.channel!.send('storage:get', configName)
+      if (!data) {
+        this.pendingUpdates.delete(configName)
+        return
+      }
+
+      // Notify all subscribers
+      callbacks.forEach((callback) => {
+        try {
+          callback(data)
+        }
+        catch (error) {
+          console.error(`[StorageSubscription] Callback error for "${configName}":`, error)
+        }
+      })
+
+      this.pendingUpdates.delete(configName)
+    }, 50) // 50ms debounce window
+
+    this.pendingUpdates.set(configName, timer)
+  }
+
+  /**
+   * Get the number of active subscriptions for a config
+   * @param configName - The configuration file name
+   * @returns Number of active callbacks subscribed to this config
+   */
+  getSubscriberCount(configName: string): number {
+    return this.subscribers.get(configName)?.size ?? 0
+  }
+
+  /**
+   * Clear all subscriptions
+   */
+  clear(): void {
+    this.subscribers.clear()
+  }
+}
+
+// Global singleton instance
+const subscriptionManager = new StorageSubscriptionManager()
+
+/**
+ * Initialize storage subscription system with channel
+ * Must be called before using subscribeStorage
+ * 
+ * @param channel - The storage channel
+ */
+export function initStorageSubscription(channel: IStorageChannel): void {
+  subscriptionManager.init(channel)
+}
+
+/**
+ * Subscribe to storage configuration changes
+ * 
+ * @param configName - Configuration file name (e.g., 'app-setting.ini')
+ * @param callback - Callback function that receives updated data
+ * @returns Unsubscribe function
+ * 
+ * @example
+ * ```typescript
+ * import { subscribeStorage } from '@talex-touch/utils/renderer/storage/storage-subscription'
+ * 
+ * const unsubscribe = subscribeStorage('app-setting.ini', (data) => {
+ *   console.log('Settings updated:', data)
+ * })
+ * 
+ * // Clean up when no longer needed
+ * unsubscribe()
+ * ```
+ */
+export function subscribeStorage(
+  configName: string,
+  callback: StorageSubscriptionCallback,
+): () => void {
+  return subscriptionManager.subscribe(configName, callback)
+}
+
+/**
+ * Get subscription manager instance (for debugging)
+ */
+export function getSubscriptionManager(): StorageSubscriptionManager {
+  return subscriptionManager
+}

package/types/icon.ts

@@ -37,6 +37,13 @@ export interface ITuffIcon {
   /** Icon value */
   value: string
 
+  /**
+   * Icon Colorful (Only for URL type)
+   * @desc This prop defines whether a URL icon should be rendered in colorful mode.
+   * It is only applicable when the icon type is 'url'.
+   */
+  colorful?: boolean
+
   /** Icon status (optional) */
   status?: TuffIconStatus
 

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