@talex-touch/utils 1.0.30 → 1.0.32

package/types/icon.ts

@@ -11,8 +11,9 @@
  * - emoji: Emoji characters (e.g., "🚀")
  * - url: Remote URL (http/https) or Data URL (data:image/...)
  * - file: Local file path (relative to plugin root directory)
+ * - class: Class name (e.g., "i-ri-rocket-line")
  */
-export type TuffIconType = 'emoji' | 'url' | 'file'
+export type TuffIconType = 'emoji' | 'url' | 'file' | 'class'
 
 /**
  * Icon status enumeration

package/types/index.ts

@@ -1,3 +1,5 @@
-export * from './touch-app-core'
+export * from './division-box'
+export * from './intelligence'
 export * from './modules'
 export * from './storage'
+export * from './touch-app-core'

package/types/intelligence.ts

@@ -0,0 +1,413 @@
+export enum AiProviderType {
+  OPENAI = 'openai',
+  ANTHROPIC = 'anthropic',
+  DEEPSEEK = 'deepseek',
+  SILICONFLOW = 'siliconflow',
+  LOCAL = 'local',
+  CUSTOM = 'custom',
+}
+
+export enum AiCapabilityType {
+  CHAT = 'chat',
+  COMPLETION = 'completion',
+  EMBEDDING = 'embedding',
+  SUMMARIZE = 'summarize',
+  TRANSLATE = 'translate',
+  TTS = 'tts',
+  STT = 'stt',
+  VISION = 'vision',
+}
+
+export interface AiProviderRateLimit {
+  requestsPerMinute?: number
+  requestsPerDay?: number
+  tokensPerMinute?: number
+  tokensPerDay?: number
+}
+
+export interface AiVisionImageSource {
+  type: 'data-url' | 'file' | 'base64'
+  dataUrl?: string
+  filePath?: string
+  base64?: string
+}
+
+export interface AiVisionOcrBlock {
+  id?: string
+  text: string
+  language?: string
+  confidence?: number
+  boundingBox?: [number, number, number, number]
+  polygon?: Array<[number, number]>
+  type?: 'word' | 'line' | 'paragraph' | 'region'
+  children?: AiVisionOcrBlock[]
+}
+
+export interface AiVisionOcrResult {
+  text: string
+  confidence?: number
+  language?: string
+  keywords?: string[]
+  suggestions?: string[]
+  blocks?: AiVisionOcrBlock[]
+  raw?: any
+}
+
+export interface AiVisionOcrPayload {
+  source: AiVisionImageSource
+  language?: string
+  prompt?: string
+  metadata?: Record<string, any>
+  includeLayout?: boolean
+  includeKeywords?: boolean
+}
+
+export interface AiProviderConfig {
+  id: string
+  type: AiProviderType
+  name: string
+  enabled: boolean
+  apiKey?: string
+  baseUrl?: string
+  rateLimit?: AiProviderRateLimit
+  models?: string[]
+  defaultModel?: string
+  instructions?: string
+  timeout?: number
+  priority?: number
+  capabilities?: string[]
+  metadata?: Record<string, any>
+}
+
+export interface AiMessage {
+  role: 'system' | 'user' | 'assistant'
+  content: string
+  name?: string
+}
+
+export interface AiInvokeOptions {
+  strategy?: string
+  modelPreference?: string[]
+  costCeiling?: number
+  latencyTarget?: number
+  timeout?: number
+  stream?: boolean
+  preferredProviderId?: string
+  allowedProviderIds?: string[]
+  metadata?: Record<string, any>
+  testRun?: boolean
+}
+
+export interface AiInvokeContext {
+  source?: string
+  locale?: string
+  userId?: string
+  sessionId?: string
+}
+
+export interface AiUsageInfo {
+  promptTokens: number
+  completionTokens: number
+  totalTokens: number
+  cost?: number
+}
+
+export interface AiInvokeResult<T = any> {
+  result: T
+  usage: AiUsageInfo
+  model: string
+  latency: number
+  traceId: string
+  provider: string
+}
+
+export interface AiStreamChunk {
+  delta: string
+  done: boolean
+  usage?: AiUsageInfo
+}
+
+export interface AiCapabilityDescriptor {
+  id: string
+  type: AiCapabilityType
+  name: string
+  description: string
+  inputSchema?: any
+  outputSchema?: any
+  defaultStrategy?: string
+  supportedProviders: AiProviderType[]
+  metadata?: Record<string, any>
+}
+
+export interface AiChatPayload {
+  messages: AiMessage[]
+  context?: AiInvokeContext
+  temperature?: number
+  maxTokens?: number
+  topP?: number
+  frequencyPenalty?: number
+  presencePenalty?: number
+  stop?: string[]
+}
+
+export interface AiEmbeddingPayload {
+  text: string | string[]
+  model?: string
+}
+
+export interface AiTranslatePayload {
+  text: string
+  sourceLang?: string
+  targetLang: string
+}
+
+export interface AiSummarizePayload {
+  text: string
+  maxLength?: number
+  style?: 'concise' | 'detailed' | 'bullet-points'
+}
+
+export interface AiSDKConfig {
+  providers: AiProviderConfig[]
+  defaultStrategy: string
+  enableAudit: boolean
+  enableCache: boolean
+  cacheExpiration?: number
+  capabilities?: Record<string, AiCapabilityRoutingConfig>
+}
+
+export interface AiStrategyConfig {
+  id: string
+  name: string
+  type: 'rule-based' | 'adaptive' | 'custom'
+  rules?: any
+  priority?: number
+}
+
+export interface AiAuditLog {
+  traceId: string
+  timestamp: number
+  capabilityId: string
+  provider: string
+  model: string
+  promptHash?: string
+  caller?: string
+  usage: AiUsageInfo
+  latency: number
+  success: boolean
+  error?: string
+}
+
+export interface AiCapabilityProviderBinding {
+  providerId: string
+  models?: string[]
+  priority?: number
+  enabled?: boolean
+  metadata?: Record<string, any>
+}
+
+export interface AiCapabilityRoutingConfig {
+  label?: string
+  description?: string
+  providers: AiCapabilityProviderBinding[]
+  promptTemplate?: string
+  testResourceDir?: string
+  metadata?: Record<string, any>
+}
+
+export interface AiSDKPersistedConfig {
+  providers: AiProviderConfig[]
+  globalConfig: {
+    defaultStrategy: string
+    enableAudit: boolean
+    enableCache: boolean
+    cacheExpiration?: number
+  }
+  capabilities?: Record<string, AiCapabilityRoutingConfig>
+  version: number
+}
+
+export interface AiProviderAdapter {
+  readonly type: AiProviderType
+  getConfig: () => AiProviderConfig
+  updateConfig: (config: Partial<AiProviderConfig>) => void
+  isEnabled: () => boolean
+  chat: (payload: AiChatPayload, options: AiInvokeOptions) => Promise<AiInvokeResult<string>>
+  chatStream: (
+    payload: AiChatPayload,
+    options: AiInvokeOptions,
+  ) => AsyncGenerator<AiStreamChunk>
+  embedding: (payload: AiEmbeddingPayload, options: AiInvokeOptions) => Promise<AiInvokeResult<number[]>>
+  translate: (payload: AiTranslatePayload, options: AiInvokeOptions) => Promise<AiInvokeResult<string>>
+  visionOcr: (
+    payload: AiVisionOcrPayload,
+    options: AiInvokeOptions,
+  ) => Promise<AiInvokeResult<AiVisionOcrResult>>
+}
+
+export interface ProviderManagerAdapter {
+  clear: () => void
+  registerFromConfig: (config: AiProviderConfig) => AiProviderAdapter
+  getEnabled: () => AiProviderAdapter[]
+  get: (providerId: string) => AiProviderAdapter | undefined
+  createProviderInstance: (config: AiProviderConfig) => AiProviderAdapter
+}
+
+export interface AISDKGlobalConfig {
+  defaultStrategy: string
+  enableAudit: boolean
+  enableCache: boolean
+  cacheExpiration?: number
+  maxRetries?: number
+  defaultTimeout?: number
+  enableLogging?: boolean
+  logLevel?: 'debug' | 'info' | 'warn' | 'error'
+  enableCaching?: boolean
+  cacheSize?: number
+  fallbackStrategy?: 'next-available' | 'fail-fast' | 'round-robin'
+  parallelRequests?: boolean
+}
+
+export interface TestResult {
+  success: boolean
+  message?: string
+  latency?: number
+  timestamp: number
+}
+
+export interface AISDKCapabilityConfig {
+  id: string
+  label: string
+  description?: string
+  providers: AiCapabilityProviderBinding[]
+  promptTemplate?: string
+  testResourceDir?: string
+  metadata?: Record<string, any>
+}
+
+export interface AISDKStorageData {
+  providers: AiProviderConfig[]
+  globalConfig: AISDKGlobalConfig
+  capabilities: Record<string, AISDKCapabilityConfig>
+  version: number
+}
+
+export const DEFAULT_PROVIDERS: AiProviderConfig[] = [
+  {
+    id: 'openai-default',
+    type: AiProviderType.OPENAI,
+    name: 'OpenAI',
+    enabled: false,
+    priority: 1,
+    models: ['gpt-4o', 'gpt-4o-mini', 'gpt-4-turbo'],
+    defaultModel: 'gpt-4o-mini',
+    timeout: 30000,
+    rateLimit: {},
+  },
+  {
+    id: 'anthropic-default',
+    type: AiProviderType.ANTHROPIC,
+    name: 'Anthropic',
+    enabled: false,
+    priority: 2,
+    models: ['claude-3-5-sonnet-20241022', 'claude-3-opus-20240229', 'claude-3-haiku-20240307'],
+    defaultModel: 'claude-3-5-sonnet-20241022',
+    timeout: 30000,
+    rateLimit: {},
+  },
+  {
+    id: 'deepseek-default',
+    type: AiProviderType.DEEPSEEK,
+    name: 'DeepSeek',
+    enabled: false,
+    priority: 2,
+    models: ['deepseek-chat', 'deepseek-coder'],
+    defaultModel: 'deepseek-chat',
+    timeout: 30000,
+    rateLimit: {},
+  },
+  {
+    id: 'siliconflow-default',
+    type: AiProviderType.SILICONFLOW,
+    name: 'SiliconFlow',
+    enabled: false,
+    priority: 2,
+    baseUrl: 'https://api.siliconflow.cn/v1',
+    models: [
+      'deepseek-ai/DeepSeek-R1-0528-Qwen3-8B',
+      'tencent/Hunyuan-MT-7B',
+      'TeleAI/TeleSpeechASR',
+      'THUDM/GLM-4.1V-9B-Thinking',
+      'deepseek-ai/DeepSeek-R1-Distill-Qwen-7B',
+      'BAAI/bge-reranker-v2-m3',
+      'netease-youdao/bce-embedding-base_v1',
+      'Kwai-Kolors/Kolors',
+      'BAAI/bge-m3',
+    ],
+    defaultModel: 'deepseek-ai/DeepSeek-R1-0528-Qwen3-8B',
+    timeout: 30000,
+    rateLimit: {},
+  },
+  {
+    id: 'local-default',
+    type: AiProviderType.LOCAL,
+    name: 'Local Model',
+    enabled: false,
+    priority: 3,
+    models: [],
+    baseUrl: 'http://localhost:11434',
+    timeout: 60000,
+    rateLimit: {},
+  },
+]
+
+export const DEFAULT_GLOBAL_CONFIG: AISDKGlobalConfig = {
+  defaultStrategy: 'adaptive-default',
+  enableAudit: false,
+  enableCache: true,
+  cacheExpiration: 3600,
+}
+
+export const DEFAULT_CAPABILITIES: Record<string, AISDKCapabilityConfig> = {
+  'text.chat': {
+    id: 'text.chat',
+    label: '对话 / Chat',
+    description: '默认用于系统对话、翻译、总结等文本任务的模型集合',
+    providers: [
+      { providerId: 'openai-default', priority: 1, enabled: true },
+      { providerId: 'anthropic-default', priority: 2, enabled: true },
+      { providerId: 'deepseek-default', priority: 3, enabled: true },
+      { providerId: 'siliconflow-default', priority: 4, enabled: true },
+    ],
+  },
+  'embedding.generate': {
+    id: 'embedding.generate',
+    label: 'Embedding',
+    description: '为向量检索/摘要生成 embedding',
+    providers: [
+      {
+        providerId: 'siliconflow-default',
+        models: ['netease-youdao/bce-embedding-base_v1', 'BAAI/bge-m3'],
+        priority: 1,
+        enabled: true,
+      },
+    ],
+  },
+  'vision.ocr': {
+    id: 'vision.ocr',
+    label: '图像 OCR',
+    description: '识别截图、图片中的文字并生成关键词',
+    promptTemplate:
+      '你是 OCR 助手，识别图片所有文本，生成 keywords 数组（5 个以内）辅助搜索。',
+    testResourceDir: 'intelligence/test-capability/ocr',
+    providers: [
+      {
+        providerId: 'siliconflow-default',
+        models: ['deepseek-ai/DeepSeek-OCR', 'deepseek-ai/DeepSeek-R1-0528-Qwen3-8B'],
+        priority: 1,
+        enabled: true,
+        metadata: { defaultVisionModel: 'deepseek-ai/DeepSeek-OCR' },
+      },
+    ],
+  },
+}

package/types/modules/base.ts

@@ -2,13 +2,13 @@
  * Unique key for a module.
  * @public
  */
-export type ModuleKey = symbol;
+export type ModuleKey = symbol
 
 /**
  * Utility type representing a synchronous or asynchronous value.
  * @public
  */
-export type MaybePromise<T> = T | Promise<T>;
+export type MaybePromise<T> = T | Promise<T>
 
 /**
  * Declarative file/directory configuration for a module (input).
@@ -31,21 +31,21 @@ export interface ModuleFileConfig {
    *
    * @defaultValue false
    */
-  create?: boolean;
+  create?: boolean
 
   /**
    * Optional custom directory name (basename only, no slashes).
    *
    * @example "clipboard"
    */
-  dirName?: string;
+  dirName?: string
 
   /**
    * Optional absolute root path under which the module directory will be created.
    *
    * @example "/var/app/modules"
    */
-  root?: string;
+  root?: string
 }
 
 /**
@@ -66,17 +66,17 @@ export interface ResolvedModuleFileConfig {
   /**
    * Final boolean indicating if the module has a dedicated directory.
    */
-  create: boolean;
+  create: boolean
 
   /**
    * Final directory name (basename), if a directory is created.
    */
-  dirName?: string;
+  dirName?: string
 
   /**
    * Final absolute path to the module directory, if a directory is created.
    */
-  dirPath?: string;
+  dirPath?: string
 }
 
 /**
@@ -93,7 +93,7 @@ export interface ModuleDirectory {
   /**
    * Absolute path to the module directory.
    */
-  readonly path: string;
+  readonly path: string
 
   /**
    * Joins one or more path segments to the module directory path. Does not touch the filesystem.
@@ -101,24 +101,24 @@ export interface ModuleDirectory {
    * @param segments - One or more relative path segments.
    * @returns The combined absolute path string.
    */
-  join(...segments: string[]): string;
+  join: (...segments: string[]) => string
 
   /**
    * Ensures the directory exists, creating it if necessary.
    */
-  ensure(): MaybePromise<void>;
+  ensure: () => MaybePromise<void>
 
   /**
    * Checks whether the directory exists.
    */
-  exists(): MaybePromise<boolean>;
+  exists: () => MaybePromise<boolean>
 
   /**
    * Lists entries in the directory (filenames/subdirectory names).
    *
    * @returns An array of entry names (not absolute paths).
    */
-  list(): MaybePromise<string[]>;
+  list: () => MaybePromise<string[]>
 
   /**
    * Reads a file within the module directory.
@@ -126,7 +126,7 @@ export interface ModuleDirectory {
    * @param relativePath - Path relative to the module directory.
    * @returns File contents as a Buffer or string (implementation-dependent).
    */
-  readFile(relativePath: string): MaybePromise<Buffer | string>;
+  readFile: (relativePath: string) => MaybePromise<Buffer | string>
 
   /**
    * Writes a file within the module directory, creating parent folders if needed.
@@ -134,7 +134,7 @@ export interface ModuleDirectory {
    * @param relativePath - Path relative to the module directory.
    * @param data - File content.
    */
-  writeFile(relativePath: string, data: string | Uint8Array): MaybePromise<void>;
+  writeFile: (relativePath: string, data: string | Uint8Array) => MaybePromise<void>
 
   /**
    * Removes a file or subdirectory within the module directory.
@@ -142,5 +142,5 @@ export interface ModuleDirectory {
    * @param relativePath - Path relative to the module directory. If omitted, implementations
    * may remove the entire directory (use with caution).
    */
-  remove(relativePath?: string): MaybePromise<void>;
+  remove: (relativePath?: string) => MaybePromise<void>
 }

package/types/modules/index.ts

@@ -1,4 +1,4 @@
 export * from './base'
-export * from './module-lifecycle'
 export * from './module'
+export * from './module-lifecycle'
 export * from './module-manager'

package/types/modules/module-lifecycle.ts

@@ -1,7 +1,7 @@
-import { ITouchEventBus } from "../../eventbus";
-import { ModuleKey } from ".";
-import { TalexTouch } from "../touch-app-core";
-import { ModuleDirectory, ResolvedModuleFileConfig } from "./base";
+import type { ModuleKey } from '.'
+import type { ITouchEventBus } from '../../eventbus'
+import type { TalexTouch } from '../touch-app-core'
+import type { ModuleDirectory, ResolvedModuleFileConfig } from './base'
 
 /**
  * Base context available to all lifecycle phases.
@@ -13,17 +13,17 @@ export interface ModuleBaseContext<E> {
   /**
    * The application root object (TalexTouch).
    */
-  app: TalexTouch.TouchApp;
+  app: TalexTouch.TouchApp
 
   /**
    * The module manager controlling creation, lifecycle, and lookup.
    */
-  manager: TalexTouch.IModuleManager<E>;
+  manager: TalexTouch.IModuleManager<E>
 
   /**
    * The unique key for the current module (same as the module's `name`).
    */
-  moduleKey: ModuleKey;
+  moduleKey: ModuleKey
 
   /**
    * Optional configuration accessor bound to the application or module.
@@ -31,12 +31,12 @@ export interface ModuleBaseContext<E> {
    * @param key - Configuration key.
    * @returns The typed configuration value.
    */
-  config?<T = unknown>(key: string): T;
+  config?: <T = unknown>(key: string) => T
 
   /**
    * Optional event bus bound to the application or module layer.
    */
-  events?: ITouchEventBus<E>;
+  events?: ITouchEventBus<E>
 
   /**
    * The module's directory instance if a directory was created; otherwise `undefined`.
@@ -44,7 +44,7 @@ export interface ModuleBaseContext<E> {
    * @remarks
    * **Single-directory rule**: Each module can expose at most one `ModuleDirectory` instance here.
    */
-  directory?: ModuleDirectory;
+  directory?: ModuleDirectory
 }
 
 /**
@@ -57,18 +57,18 @@ export interface ModuleCreateContext<E> extends ModuleBaseContext<E> {
   /**
    * Resolved file/directory configuration for the module.
    */
-  file: ResolvedModuleFileConfig;
+  file: ResolvedModuleFileConfig
 
   /**
    * Fully resolved module entry file path if a custom path was provided,
    * or a default path computed by the manager; otherwise `undefined`.
    */
-  resolvedPath?: string;
+  resolvedPath?: string
 
   /**
    * Indicates whether this load is part of a hot-reload/replace cycle.
    */
-  hot?: boolean;
+  hot?: boolean
 }
 
 /**
@@ -81,12 +81,12 @@ export interface ModuleInitContext<E> extends ModuleBaseContext<E> {
   /**
    * Optional hint that dependencies have been verified and are ready.
    */
-  depsReady?: boolean;
+  depsReady?: boolean
 
   /**
    * Resolved file/directory configuration for the module.
    */
-  file: ResolvedModuleFileConfig;
+  file: ResolvedModuleFileConfig
 }
 
 /**
@@ -99,12 +99,12 @@ export interface ModuleStartContext<E> extends ModuleBaseContext<E> {
   /**
    * Optional startup arguments or mode flags.
    */
-  startArgs?: Record<string, unknown>;
+  startArgs?: Record<string, unknown>
 
   /**
    * Resolved file/directory configuration for the module.
    */
-  file: ResolvedModuleFileConfig;
+  file: ResolvedModuleFileConfig
 }
 
 /**
@@ -121,12 +121,12 @@ export interface ModuleStopContext<E> extends ModuleBaseContext<E> {
    * - `"hot-reload"`: Stop as part of a hot reload / replacement cycle.
    * - `string`: Custom reason.
    */
-  reason?: "normal" | "error" | "hot-reload" | string;
+  reason?: 'normal' | 'error' | 'hot-reload' | string
 
   /**
    * Resolved file/directory configuration for the module.
    */
-  file: ResolvedModuleFileConfig;
+  file: ResolvedModuleFileConfig
 }
 
 /**
@@ -139,10 +139,10 @@ export interface ModuleDestroyContext<E> extends ModuleBaseContext<E> {
   /**
    * Indicates the module is being destroyed as part of application shutdown.
    */
-  appClosing?: boolean;
+  appClosing?: boolean
 
   /**
    * Resolved file/directory configuration for the module.
    */
-  file: ResolvedModuleFileConfig;
+  file: ResolvedModuleFileConfig
 }