@talex-touch/utils 1.0.29 → 1.0.30

package/auth/clerk-types.ts

@@ -0,0 +1,56 @@
+export interface ClerkUser {
+  id: string
+  emailAddresses: Array<{
+    emailAddress: string
+    id: string
+  }>
+  firstName?: string
+  lastName?: string
+  username?: string
+  imageUrl?: string
+  createdAt: string
+  updatedAt: string
+}
+
+export interface ClerkAuthState {
+  isLoaded: boolean
+  isSignedIn: boolean
+  user: ClerkUser | null
+  sessionId: string | null
+}
+
+export interface LoginOptions {
+  onSuccess?: (user: any) => void
+  onError?: (error: any) => void
+}
+
+export interface LoginResult {
+  success: boolean
+  user?: any
+  error?: any
+}
+
+export interface CurrentUser {
+  id: string
+  name: string
+  email: string
+  avatar?: string
+  provider: string
+}
+
+/**
+ * Clerk Auth Config
+ */
+export interface ClerkConfig {
+  publishableKey: string
+  domain?: string
+  signInUrl?: string
+  signUpUrl?: string
+  afterSignInUrl?: string
+  afterSignUpUrl?: string
+}
+
+export type ClerkResourceSnapshot = {
+  user?: any | null
+  session?: { id?: string | null } | null
+}

package/auth/index.ts

@@ -0,0 +1,4 @@
+export * from './clerk-types'
+export * from './useClerkConfig'
+export * from './useClerkProvider'
+export * from './useAuthState'

package/auth/useAuthState.ts

@@ -0,0 +1,44 @@
+import { createGlobalState } from '@vueuse/core'
+import { shallowReactive } from 'vue'
+import { ClerkAuthState, CurrentUser } from './clerk-types'
+
+export const useAuthState = createGlobalState(() => {
+  const authState = shallowReactive<ClerkAuthState>({
+    isLoaded: false,
+    isSignedIn: false,
+    user: null,
+    sessionId: null
+  })
+
+  return { authState }
+})
+
+export function useCurrentUser() {
+  const { authState } = useAuthState()
+
+  const currentUser = computed((): CurrentUser | null => {
+    if (!authState.isSignedIn || !authState.user) {
+      return null
+    }
+
+    const { firstName, lastName, username, imageUrl } = authState.user
+    let name = ''
+    if (firstName || lastName) {
+      name = [firstName, lastName].filter(Boolean).join(' ')
+    } else {
+      name = username || ''
+    }
+
+    const email = authState.user.emailAddresses?.[0]?.emailAddress || ''
+
+    return {
+      id: authState.user.id,
+      name,
+      email,
+      avatar: imageUrl,
+      provider: 'clerk'
+    }
+  })
+
+  return { currentUser, authState }
+}

package/auth/useClerkConfig.ts

@@ -0,0 +1,40 @@
+import { ClerkConfig } from "./clerk-types"
+
+const clerkPublishableKey = import.meta.env.VITE_CLERK_PUBLISHABLE_KEY
+const clerkDomain = import.meta.env.VITE_CLERK_DOMAIN
+
+if (!clerkPublishableKey?.length) {
+  throw new Error('VITE_CLERK_PUBLISHABLE_KEY is not set')
+}
+
+export const CLERK_PUBLISHABLE_KEY_KEY = 'clerk-publishable-key'
+
+export const defaultClerkConfig: ClerkConfig = {
+  publishableKey: clerkPublishableKey,
+  domain: clerkDomain,
+  signInUrl: '/sign-in',
+  signUpUrl: '/sign-up',
+  afterSignInUrl: '/home',
+  afterSignUpUrl: '/home'
+}
+
+export function useClerkConfig() {
+  const getClerkConfig = (): ClerkConfig => {
+    return {
+      ...defaultClerkConfig,
+      publishableKey:
+        localStorage.getItem(CLERK_PUBLISHABLE_KEY_KEY) || defaultClerkConfig.publishableKey
+    }
+  }
+
+  const setClerkConfig = (config: Partial<ClerkConfig>): void => {
+    if (config.publishableKey) {
+      localStorage.setItem(CLERK_PUBLISHABLE_KEY_KEY, config.publishableKey)
+    }
+  }
+
+  return {
+    getClerkConfig,
+    setClerkConfig
+  }
+}

package/auth/useClerkProvider.ts

@@ -0,0 +1,51 @@
+import { Clerk } from '@clerk/clerk-js'
+import { useClerkConfig } from './useClerkConfig'
+
+let clerkInstance: Clerk | null = null
+
+export function useClerkProvider() {
+  const initializeClerk = async (): Promise<Clerk> => {
+    if (clerkInstance) {
+      return clerkInstance
+    }
+
+    const { getClerkConfig } = useClerkConfig()
+    const config = getClerkConfig()
+
+    if (!config.publishableKey) {
+      throw new Error('Clerk publishable key is required')
+    }
+
+    try {
+      clerkInstance = new Clerk(config.publishableKey)
+      await clerkInstance.load()
+
+      console.log('Clerk initialized successfully')
+      return clerkInstance
+    } catch (error) {
+      console.error('Failed to initialize Clerk:', error)
+      throw error
+    }
+  }
+
+  const getClerk = (): Clerk | null => {
+    return clerkInstance
+  }
+
+  const isClerkInitialized = (): boolean => {
+    return clerkInstance !== null
+  }
+
+  const cleanupClerk = (): void => {
+    if (clerkInstance) {
+      clerkInstance = null
+    }
+  }
+
+  return {
+    initializeClerk,
+    getClerk,
+    isClerkInitialized,
+    cleanupClerk
+  }
+}

package/common/storage/entity/app-settings.ts

@@ -14,7 +14,7 @@ const _appSettingOriginData = {
   },
   lang: {
     followSystem: true,
-    locale: 0,
+    locale: 'zh-CN',
   },
   keyBind: {
     summon: 'CTRL + E',

package/core-box/README.md

@@ -140,7 +140,7 @@ The core interface for all search results:
 interface ISearchItem {
   name: string;                    // Display name
   desc: string;                    // Description
-  icon: IPluginIcon;              // Icon configuration
+  icon: ITuffIcon;              // Icon configuration
   push: boolean;                   // Push mode support
   names: string[];                 // Searchable names
   keyWords: string[];             // Search keywords

package/core-box/tuff/tuff-dsl.ts

@@ -16,7 +16,7 @@
  * @module core-box/tuff-dsl
  */
 
-import { TalexTouch } from "packages/utils/types";
+// import { TalexTouch } from "packages/utils/types";
 
 /**
  * 定义高亮范围
@@ -375,55 +375,15 @@ export interface TuffCustomRender {
   scripts?: string[];
 }
 
+import type { ITuffIcon } from '../../types/icon'
+
 /**
- * 图标定义
+ * Icon definition
  *
  * @description
- * 支持多种图标类型，从简单的emoji到复杂的组件。
- * 可以是简单字符串或包含详细配置的对象。
+ * Unified icon type supporting only ITuffIcon object format
  */
-export type TuffIcon =
-  | string  // 简单字符串：emoji、URL、组件名
-  | {
-      /**
-       * 图标类型
-       * @description 指定图标的数据格式和来源
-       * @required
-       */
-      type: 'emoji' | 'url' | 'base64' | 'fluent' | 'component';
-
-      /**
-       * 图标值
-       * @description 根据type不同，可能是emoji字符、URL地址、Base64编码或组件名
-       * @required
-       */
-      value: string;
-
-      /**
-       * 备用图标
-       * @description 当主图标无法加载时显示的替代图标
-       */
-      fallback?: string;
-
-      /**
-       * 动态加载函数
-       * @description 用于异步加载图标资源的函数
-       */
-      loader?: () => Promise<string>;
-
-      /**
-       * 样式配置
-       * @description 控制图标的视觉效果
-       */
-      style?: {
-        /** 图标尺寸 */
-        size?: number;
-        /** 图标颜色 */
-        color?: string;
-        /** 动画效果 */
-        animation?: 'spin' | 'pulse' | 'bounce';
-      };
-    };
+export type TuffIcon = ITuffIcon
 
 /**
  * 标签定义

package/index.ts

@@ -1,8 +1,12 @@
+export * from './auth'
 export * from './base'
 export * from './common'
 export * from './plugin'
 export * from './core-box'
 export * from './channel'
 export * from './types'
+export * from './types/icon'
 export * from './eventbus'
 export * from './preload'
+export * from './types/download'
+export * from './types/update'

package/package.json

@@ -5,7 +5,7 @@
   "module": "./index.ts",
   "license": "MPL-2.0",
   "private": false,
-  "version": "1.0.29",
+  "version": "1.0.30",
   "scripts": {
     "publish": "npm publish --access public"
   },

package/plugin/index.ts

@@ -14,6 +14,9 @@ export enum PluginStatus {
   LOADING,
   LOADED,
   LOAD_FAILED,
+
+  DEV_DISCONNECTED,  // Dev Server 断连
+  DEV_RECONNECTING,  // 正在重连
 }
 
 export interface PluginIssue {
@@ -26,14 +29,16 @@ export interface PluginIssue {
   timestamp?: number
 }
 
-export interface IPluginIcon {
-  type: string | 'remixicon' | 'class'
-  value: any
-  _value?: string
-
-  init(): Promise<void>
+export interface DevServerHealthCheckResult {
+  healthy: boolean
+  version?: string
+  timestamp: number
+  error?: string
 }
 
+import type { ITuffIcon } from '../types/icon'
+
+
 export interface IPlatformInfo {
   enable: boolean
   arch: Arch[]
@@ -51,7 +56,7 @@ export interface IPluginBaseInfo {
   readme: string
   version: string
   desc: string
-  icon: IPluginIcon
+  icon: ITuffIcon
   platforms: IPlatform
   _uniqueChannelKey: string
 }
@@ -134,7 +139,7 @@ export interface IPluginFeature {
   id: string
   name: string
   desc: string
-  icon: IPluginIcon
+  icon: ITuffIcon
   push: boolean
   platform: IPlatform
   commands: IFeatureCommand[]
@@ -323,11 +328,14 @@ export interface IPluginManager {
   pluginPath: string
   watcher: FSWatcher | null
   devWatcher: any // Temporarily any, as DevPluginWatcher is internal to core-app
+  healthMonitor: any | null // DevServerHealthMonitor instance, set by PluginModule
 
   getPluginList(): Array<object>
   setActivePlugin(pluginName: string): boolean
   hasPlugin(name: string): boolean
   getPluginByName(name: string): ITouchPlugin | undefined
+  enablePlugin(pluginName: string): Promise<boolean>
+  disablePlugin(pluginName: string): Promise<boolean>
   reloadPlugin(pluginName: string): Promise<void>
   persistEnabledPlugins(): Promise<void>
   listPlugins(): Promise<Array<string>>

package/plugin/sdk/features.ts

@@ -121,7 +121,7 @@ export interface IFeaturesManager {
  * ```
  */
 export function createFeaturesManager(
-  pluginName: string,
+  _pluginName: string,
   utils: any
 ): IFeaturesManager {
   return {

package/plugin/sdk/index.ts

@@ -22,4 +22,4 @@ export * from './clipboard'
 export * from './core-box'
 export * from './storage'
 export * from './system'
-export * from './features'
+export { createFeaturesManager, useFeatures } from './features'

package/plugin/sdk/storage.ts

@@ -1,3 +1,5 @@
+import type { StorageStats, StorageTreeNode, FileDetails } from '../../types/storage'
+
 /**
  * Get the storage for the current plugin.
  * It provides simple file-based storage that is persisted across application launches.
@@ -50,6 +52,68 @@ export function usePluginStorage() {
      */
     listFiles: async (): Promise<string[]> => {
       return channel.send('plugin:storage:list-files', { pluginName })
+    },
+
+    /**
+     * Gets storage statistics for the current plugin.
+     * @returns A promise that resolves with storage statistics.
+     */
+    getStats: async (): Promise<StorageStats> => {
+      return channel.send('plugin:storage:get-stats', { pluginName })
+    },
+
+    /**
+     * Gets the directory tree structure of plugin storage.
+     * @returns A promise that resolves with the tree structure.
+     */
+    getTree: async (): Promise<StorageTreeNode[]> => {
+      return channel.send('plugin:storage:get-tree', { pluginName })
+    },
+
+    /**
+     * Gets detailed information about a specific file.
+     * @param fileName The name of the file to get details for.
+     * @returns A promise that resolves with file details.
+     */
+    getFileDetails: async (fileName: string): Promise<FileDetails | null> => {
+      return channel.send('plugin:storage:get-file-details', { pluginName, fileName })
+    },
+
+    /**
+     * Clears all storage for the current plugin.
+     * @returns A promise that resolves with the operation result.
+     */
+    clearAll: async (): Promise<{ success: boolean, error?: string }> => {
+      return channel.send('plugin:storage:clear', { pluginName })
+    },
+
+    /**
+     * Opens the plugin storage folder in the system file manager.
+     * @returns A promise that resolves when the folder is opened.
+     */
+    openFolder: async (): Promise<void> => {
+      await channel.send('plugin:storage:open-folder', { pluginName })
+    },
+
+    /**
+     * Listens for changes to the storage.
+     * @param fileName The file name to listen for changes
+     * @param callback The function to call when the storage changes for the current plugin.
+     * @returns A function to unsubscribe from the listener.
+     */
+    onDidChange: (fileName: string, callback: (newConfig: any) => void) => {
+      const listener = (data: { name: string, fileName?: string }) => {
+        if (data.name === pluginName &&
+            (data.fileName === fileName || data.fileName === undefined)) {
+          callback(data)
+        }
+      }
+
+      channel.regChannel('plugin:storage:update', listener)
+
+      return () => {
+        channel.unRegChannel('plugin:storage:update', listener)
+      }
     }
   }
 }

package/plugin/sdk/types.ts

@@ -842,3 +842,78 @@ export interface IPluginInfoManager {
    */
   getPlatforms(): any
 }
+
+/**
+ * Plugin state change event types
+ *
+ * @description
+ * Represents different types of plugin state changes for incremental updates
+ */
+export type PluginStateEvent =
+  | { type: 'added'; plugin: any }
+  | { type: 'removed'; name: string }
+  | { type: 'updated'; name: string; changes: Partial<any> }
+  | { type: 'status-changed'; name: string; status: number }
+  | { type: 'readme-updated'; name: string; readme: string }
+
+/**
+ * Plugin filter options for list queries
+ */
+export interface PluginFilters {
+  /** Filter by plugin status */
+  status?: number
+  /** Filter by enabled state */
+  enabled?: boolean
+  /** Filter by development mode */
+  dev?: boolean
+}
+
+/**
+ * Trigger feature request payload
+ */
+export interface TriggerFeatureRequest {
+  /** Plugin name */
+  plugin: string
+  /** Feature ID */
+  feature: string
+  /** Search query or trigger input */
+  query?: string
+}
+
+/**
+ * Input changed event payload
+ */
+export interface InputChangedRequest {
+  /** Plugin name */
+  plugin: string
+  /** Feature ID */
+  feature: string
+  /** Current input value */
+  query: string
+}
+
+/**
+ * Plugin install request payload
+ */
+export interface InstallRequest {
+  /** Install source (URL, file path, etc) */
+  source: string
+  /** Hint type for installer */
+  hintType?: string
+  /** Additional metadata */
+  metadata?: Record<string, any>
+  /** Client metadata */
+  clientMetadata?: Record<string, any>
+}
+
+/**
+ * Plugin install response
+ */
+export interface InstallResponse {
+  /** Whether installation was successful */
+  success: boolean
+  /** Error message if failed */
+  error?: string
+  /** Installed plugin name */
+  pluginName?: string
+}

package/preload/renderer.ts

@@ -2,7 +2,7 @@ import type { LoadingEvent, LoadingMode, LoadingState, PreloadAPI } from './load
 
 function getPreloadApi(): PreloadAPI | null {
   if (typeof window === 'undefined') return null
-  return window.api ?? null
+  return (window as any).api ?? null
 }
 
 export function sendPreloadEvent(event: LoadingEvent): void {

package/renderer/hooks/index.ts

@@ -1,2 +1,3 @@
 export * from './arg-mapper'
 export * from './initialize'
+export * from './performance'

package/renderer/hooks/initialize.ts

@@ -196,3 +196,8 @@ export function refreshPerformanceInfo(): IInitializationInfo {
   }
   return window.$initInfo
 }
+
+/**
+ * Development mode flag
+ */
+export const isDev = import.meta.env.MODE === 'development'

package/renderer/hooks/performance.ts

@@ -0,0 +1,87 @@
+/**
+ * Renderer Process Performance Monitoring
+ *
+ * Collects detailed performance metrics in the renderer process
+ */
+
+/**
+ * Renderer performance metrics
+ */
+export interface RendererPerformanceMetrics {
+  /** Performance timing origin */
+  timeOrigin: number
+  /** Navigation start time */
+  navigationStart: number
+  /** DOM content loaded event end */
+  domContentLoadedEventEnd?: number
+  /** Load event end */
+  loadEventEnd?: number
+  /** DOM interactive time */
+  domInteractive?: number
+  /** First paint time */
+  firstPaint?: number
+  /** First contentful paint time */
+  firstContentfulPaint?: number
+}
+
+/**
+ * Get current renderer performance metrics
+ */
+export function getRendererPerformanceMetrics(): RendererPerformanceMetrics {
+  const navEntry = performance.getEntriesByType('navigation')[0] as PerformanceNavigationTiming
+  const paintEntries = performance.getEntriesByType('paint')
+
+  const firstPaint = paintEntries.find(e => e.name === 'first-paint')
+  const firstContentfulPaint = paintEntries.find(e => e.name === 'first-contentful-paint')
+
+  return {
+    timeOrigin: performance.timeOrigin,
+    navigationStart: performance.timeOrigin,
+    domContentLoadedEventEnd: navEntry?.domContentLoadedEventEnd,
+    loadEventEnd: navEntry?.loadEventEnd,
+    domInteractive: navEntry?.domInteractive,
+    firstPaint: firstPaint?.startTime,
+    firstContentfulPaint: firstContentfulPaint?.startTime
+  }
+}
+
+/**
+ * Wait for page load and collect metrics
+ */
+export function collectPerformanceMetricsOnLoad(): Promise<RendererPerformanceMetrics> {
+  return new Promise((resolve) => {
+    if (document.readyState === 'complete') {
+      // Page already loaded
+      setTimeout(() => {
+        resolve(getRendererPerformanceMetrics())
+      }, 0)
+    } else {
+      // Wait for load event
+      window.addEventListener('load', () => {
+        setTimeout(() => {
+          resolve(getRendererPerformanceMetrics())
+        }, 0)
+      }, { once: true })
+    }
+  })
+}
+
+/**
+ * Get performance summary for display
+ */
+export function getPerformanceSummary(): {
+  domReady: number
+  pageLoad: number
+  firstPaint: number | undefined
+  firstContentfulPaint: number | undefined
+} {
+  const metrics = getRendererPerformanceMetrics()
+
+  return {
+    domReady: metrics.domContentLoadedEventEnd || 0,
+    pageLoad: metrics.loadEventEnd || 0,
+    firstPaint: metrics.firstPaint,
+    firstContentfulPaint: metrics.firstContentfulPaint
+  }
+}
+

package/renderer/storage/app-settings.ts

@@ -32,5 +32,3 @@ class AppSettingsStorage extends TouchStorage<AppSetting> {
  * Global instance of the application settings
  */
 export const appSettings = new AppSettingsStorage();
-
-console.log(appSettings)

package/renderer/storage/base-storage.ts

@@ -327,7 +327,6 @@ export class TouchStorage<T extends object> {
     }
 
     const result = channel.sendSync('storage:get', this.#qualifiedName)
-    console.log("result", result)
     const parsed = result ? (result as Partial<T>) : {};
     this.assignData(parsed, true);
 

package/search/types.ts

@@ -16,7 +16,8 @@
  * @version 1.0.0
  */
 
-import type { IPluginIcon, IFeatureCommand } from '../plugin';
+import type { IFeatureCommand } from '../plugin';
+import type { ITuffIcon } from '../types/icon';
 
 /**
  * Search Result Item Interface
@@ -59,9 +60,9 @@ export interface ISearchItem {
    * Defines how the item's icon should be displayed in the UI.
    * Supports various icon types including files, remix icons, and data URLs.
    *
-   * @see {@link IPluginIcon} for icon configuration options
+   * @see {@link ITuffIcon} for icon configuration options
    */
-  icon: IPluginIcon;
+  icon: ITuffIcon;
 
   /**
    * Whether this item supports push mode functionality
@@ -592,7 +593,7 @@ export function createDataItem(options: {
     icon: {
       type: iconType,
       value: iconValue,
-      init: async () => {} // Required by IPluginIcon interface
+      init: async () => {} // Required by ITuffIcon interface
     },
     push: false,                    // Data items don't support push mode
     names: [name],                  // Include name in searchable names
@@ -675,7 +676,7 @@ export function createSearchItem(options: {
   /** Description or subtitle text */
   desc: string;
   /** Icon configuration object */
-  icon: IPluginIcon;
+  icon: ITuffIcon;
   /** Name of the plugin creating this item */
   pluginName: string;
   /** Plugin type (defaults to "feature") */

package/types/download.ts

@@ -0,0 +1,162 @@
+// 下载优先级枚举
+export enum DownloadPriority {
+  CRITICAL = 100,    // 用户手动触发
+  HIGH = 80,         // 插件安装
+  NORMAL = 50,       // 应用更新
+  LOW = 20,          // 资源文件
+  BACKGROUND = 10    // 后台预加载
+}
+
+// 下载模块枚举
+export enum DownloadModule {
+  APP_UPDATE = 'app_update',
+  PLUGIN_INSTALL = 'plugin_install',
+  RESOURCE_DOWNLOAD = 'resource_download',
+  USER_MANUAL = 'user_manual'
+}
+
+// 下载状态枚举
+export enum DownloadStatus {
+  PENDING = 'pending',       // 等待中
+  DOWNLOADING = 'downloading', // 下载中
+  PAUSED = 'paused',         // 已暂停
+  COMPLETED = 'completed',   // 已完成
+  FAILED = 'failed',         // 失败
+  CANCELLED = 'cancelled'    // 已取消
+}
+
+// 切片状态枚举
+export enum ChunkStatus {
+  PENDING = 'pending',
+  DOWNLOADING = 'downloading',
+  COMPLETED = 'completed',
+  FAILED = 'failed'
+}
+
+// 下载任务请求接口
+export interface DownloadRequest {
+  id?: string
+  url: string
+  destination: string
+  filename?: string
+  priority: DownloadPriority
+  module: DownloadModule
+  metadata?: Record<string, any>
+  checksum?: string
+  headers?: Record<string, string>
+}
+
+// 下载任务实体
+export interface DownloadTask {
+  id: string
+  url: string
+  destination: string
+  filename: string
+  priority: DownloadPriority
+  module: DownloadModule
+  status: DownloadStatus
+  progress: DownloadProgress
+  chunks: ChunkInfo[]
+  metadata: Record<string, any>
+  createdAt: Date
+  updatedAt: Date
+  error?: string
+}
+
+// 下载进度接口
+export interface DownloadProgress {
+  totalSize?: number
+  downloadedSize: number
+  speed: number // bytes/s
+  remainingTime?: number // seconds
+  percentage: number // 0-100
+}
+
+// 切片信息接口
+export interface ChunkInfo {
+  index: number
+  start: number
+  end: number
+  size: number
+  downloaded: number
+  status: ChunkStatus
+  filePath: string
+}
+
+// 下载配置接口
+export interface DownloadConfig {
+  concurrency: {
+    maxConcurrent: number        // 最大并发数 (1-10)
+    autoAdjust: boolean          // 自动调整
+    networkAware: boolean       // 网络感知
+    priorityBased: boolean       // 基于优先级
+  }
+  chunk: {
+    size: number                 // 切片大小
+    resume: boolean             // 断点续传
+    autoRetry: boolean          // 自动重试
+    maxRetries: number          // 最大重试次数
+  }
+  storage: {
+    tempDir: string             // 临时目录
+    historyRetention: number    // 历史保留天数
+    autoCleanup: boolean        // 自动清理
+  }
+  network: {
+    timeout: number             // 超时时间
+    retryDelay: number          // 重试延迟
+    maxRetries: number          // 最大重试次数
+  }
+}
+
+// 网络状态接口
+export interface NetworkStatus {
+  speed: number        // bytes/s
+  latency: number      // ms
+  stability: number     // 0-1
+  recommendedConcurrency: number
+}
+
+// 队列状态接口
+export interface QueueStatus {
+  totalTasks: number
+  pendingTasks: number
+  activeTasks: number
+  completedTasks: number
+  failedTasks: number
+}
+
+// 下载统计接口
+export interface DownloadStats {
+  totalTasks: number
+  completedTasks: number
+  failedTasks: number
+  totalDownloaded: number
+  averageSpeed: number
+}
+
+// 默认下载配置
+export const defaultDownloadConfig: DownloadConfig = {
+  concurrency: {
+    maxConcurrent: 3,
+    autoAdjust: true,
+    networkAware: true,
+    priorityBased: true
+  },
+  chunk: {
+    size: 1024 * 1024, // 1MB
+    resume: true,
+    autoRetry: true,
+    maxRetries: 3
+  },
+  storage: {
+    tempDir: '', // 将在运行时设置
+    historyRetention: 30,
+    autoCleanup: true
+  },
+  network: {
+    timeout: 30000,
+    retryDelay: 5000,
+    maxRetries: 3
+  }
+}

package/types/icon.ts

@@ -0,0 +1,44 @@
+/**
+ * Icon type definitions
+ *
+ * @description
+ * Defines common icon interfaces and types, supporting emoji, url, and file types
+ */
+
+/**
+ * Icon type enumeration
+ * @description
+ * - emoji: Emoji characters (e.g., "🚀")
+ * - url: Remote URL (http/https) or Data URL (data:image/...)
+ * - file: Local file path (relative to plugin root directory)
+ */
+export type TuffIconType = 'emoji' | 'url' | 'file'
+
+/**
+ * Icon status enumeration
+ * @description
+ * - normal: Normal state
+ * - loading: Loading state
+ * - error: Error state
+ */
+export type TuffIconStatus = 'normal' | 'loading' | 'error'
+
+/**
+ * Common icon interface
+ *
+ * @description
+ * Unified icon data structure supporting three icon types and status management
+ */
+export interface ITuffIcon {
+  /** Icon type */
+  type: TuffIconType
+
+  /** Icon value */
+  value: string
+
+  /** Icon status (optional) */
+  status?: TuffIconStatus
+
+  /** Error message (when status is error) */
+  error?: string
+}

package/types/index.ts

@@ -1,2 +1,3 @@
 export * from './touch-app-core'
 export * from './modules'
+export * from './storage'

package/types/modules/module-lifecycle.ts

@@ -1,4 +1,4 @@
-import { ITouchEventBus } from "packages/utils/eventbus";
+import { ITouchEventBus } from "../../eventbus";
 import { ModuleKey } from ".";
 import { TalexTouch } from "../touch-app-core";
 import { ModuleDirectory, ResolvedModuleFileConfig } from "./base";

package/types/storage.ts

@@ -0,0 +1,56 @@
+/**
+ * Plugin storage statistics
+ */
+export interface StorageStats {
+  /** Total size in bytes */
+  totalSize: number
+  /** Number of files (excluding directories) */
+  fileCount: number
+  /** Number of directories */
+  dirCount: number
+  /** Maximum size limit in bytes (10MB) */
+  maxSize: number
+  /** Usage percentage (0-100) */
+  usagePercent: number
+}
+
+/**
+ * Storage tree node representing a file or directory
+ */
+export interface StorageTreeNode {
+  /** File or directory name */
+  name: string
+  /** Relative path from storage root */
+  path: string
+  /** Node type */
+  type: 'file' | 'directory'
+  /** Size in bytes (for directories, this is the total size of all contained files) */
+  size: number
+  /** Last modified timestamp */
+  modified: number
+  /** Child nodes (only for directories) */
+  children?: StorageTreeNode[]
+}
+
+/**
+ * Detailed information about a specific file
+ */
+export interface FileDetails {
+  /** File name */
+  name: string
+  /** Relative path from storage root */
+  path: string
+  /** File size in bytes */
+  size: number
+  /** Creation timestamp */
+  created: number
+  /** Last modified timestamp */
+  modified: number
+  /** File type (extension or detected type) */
+  type: string
+  /** File content (if available and size permits) */
+  content?: any
+  /** Whether content was truncated due to size */
+  truncated?: boolean
+}
+

package/types/update.ts

@@ -0,0 +1,99 @@
+// 更新源类型枚举
+export enum UpdateProviderType {
+  GITHUB = 'github',
+  OFFICIAL = 'official',
+  CUSTOM = 'custom'
+}
+
+// 更新源配置接口
+export interface UpdateSourceConfig {
+  type: UpdateProviderType
+  name: string
+  url?: string
+  enabled: boolean
+  priority: number
+}
+
+// 下载资源接口
+export interface DownloadAsset {
+  name: string
+  url: string
+  size: number
+  platform: 'win32' | 'darwin' | 'linux'
+  arch: 'x64' | 'arm64'
+  checksum?: string
+}
+
+// GitHub Release接口（兼容GitHub API格式）
+export interface GitHubRelease {
+  tag_name: string
+  name: string
+  published_at: string
+  body: string
+  assets: DownloadAsset[]
+}
+
+// 更新检查结果接口
+export interface UpdateCheckResult {
+  hasUpdate: boolean
+  release?: GitHubRelease
+  error?: string
+  source: string
+}
+
+// 自定义更新源配置
+export interface CustomUpdateConfig {
+  name: string
+  url: string
+  apiFormat: 'github' | 'custom'
+  headers?: Record<string, string>
+}
+
+// 应用预览渠道枚举
+export enum AppPreviewChannel {
+  MASTER = 'master',
+  SNAPSHOT = 'snapshot'
+}
+
+// 更新设置配置
+export interface UpdateSettings {
+  enabled: boolean
+  frequency: 'startup' | 'daily' | 'weekly' | 'manual'
+  source: UpdateSourceConfig
+  crossChannel: boolean
+  ignoredVersions: string[]
+  customSources: CustomUpdateConfig[]
+}
+
+// 默认更新设置
+export const defaultUpdateSettings: UpdateSettings = {
+  enabled: true,
+  frequency: 'startup',
+  source: {
+    type: UpdateProviderType.GITHUB,
+    name: 'GitHub Releases',
+    url: 'https://api.github.com/repos/talex-touch/tuff/releases',
+    enabled: true,
+    priority: 1
+  },
+  crossChannel: false,
+  ignoredVersions: [],
+  customSources: []
+}
+
+// 更新错误类型
+export enum UpdateErrorType {
+  NETWORK_ERROR = 'network_error',
+  TIMEOUT_ERROR = 'timeout_error',
+  API_ERROR = 'api_error',
+  PARSE_ERROR = 'parse_error',
+  VERSION_ERROR = 'version_error',
+  UNKNOWN_ERROR = 'unknown_error'
+}
+
+// 更新错误接口
+export interface UpdateError extends Error {
+  type: UpdateErrorType
+  code?: string
+  statusCode?: number
+}