@talex-touch/utils 1.0.33 → 1.0.35

package/common/file-scan-utils.ts

@@ -8,7 +8,6 @@
  */
 
 import type { FileScanOptions } from './file-scan-constants'
-// eslint-disable-next-line @typescript-eslint/no-var-requires
 import {
   BASE_BLACKLISTED_DIRS,
   BLACKLISTED_EXTENSIONS,

package/common/storage/constants.ts

@@ -3,6 +3,7 @@ export enum StorageList {
   SHORTCUT_SETTING = 'shortcut-setting.ini',
   OPENERS = 'openers.json',
   IntelligenceConfig = 'aisdk-config',
+  MARKET_SOURCES = 'market-sources.json',
 }
 
 /**

package/index.ts

@@ -11,3 +11,4 @@ export * from './types'
 export * from './types/download'
 export * from './types/icon'
 export * from './types/update'
+export * from './market'

package/market/constants.ts

@@ -0,0 +1,95 @@
+import { StorageList } from '../common/storage/constants'
+import type {
+  MarketProviderDefinition,
+  MarketSourcesPayload,
+  MarketSourcesStorageInfo,
+  MarketProviderTrustLevel,
+} from './types'
+
+export const MARKET_SOURCES_STORAGE_KEY = StorageList.MARKET_SOURCES
+export const MARKET_SOURCES_STORAGE_VERSION = 1
+
+function defineProvider(
+  provider: Omit<MarketProviderDefinition, 'trustLevel'> & {
+    trustLevel?: MarketProviderTrustLevel
+  },
+): MarketProviderDefinition {
+  return {
+    trustLevel: provider.trustLevel ?? 'unverified',
+    ...provider,
+  }
+}
+
+export const DEFAULT_MARKET_PROVIDERS: MarketProviderDefinition[] = [
+  defineProvider({
+    id: 'talex-official',
+    name: 'Talex Official',
+    type: 'nexusStore',
+    url: 'https://raw.githubusercontent.com/talex-touch/tuff-official-plugins/main/plugins.json',
+    description: '官方插件市场，提供经过审核的核心插件。',
+    enabled: true,
+    priority: 100,
+    trustLevel: 'official',
+    readOnly: true,
+    config: {
+      manifestUrl:
+        'https://raw.githubusercontent.com/talex-touch/tuff-official-plugins/main/plugins.json',
+      baseUrl: 'https://raw.githubusercontent.com/talex-touch/tuff-official-plugins/main/',
+    },
+  }),
+  defineProvider({
+    id: 'github-releases',
+    name: 'GitHub Releases',
+    type: 'repository',
+    description: '从 GitHub 仓库 releases / manifest 中读取插件。',
+    enabled: false,
+    priority: 80,
+    trustLevel: 'unverified',
+    config: {
+      platform: 'github',
+      apiBase: 'https://api.github.com',
+    },
+  }),
+  defineProvider({
+    id: 'gitee-repos',
+    name: 'Gitee 仓库',
+    type: 'repository',
+    description: 'Gitee 平台插件仓库，适合国内网络。',
+    enabled: false,
+    priority: 70,
+    trustLevel: 'unverified',
+    config: {
+      platform: 'gitee',
+      apiBase: 'https://gitee.com/api/v5',
+    },
+  }),
+  defineProvider({
+    id: 'npm-scope',
+    name: 'NPM 包',
+    type: 'npmPackage',
+    description: '基于 NPM 关键字或 scope 的插件发布渠道。',
+    enabled: false,
+    priority: 60,
+    trustLevel: 'unverified',
+    config: {
+      registryUrl: 'https://registry.npmjs.org',
+      keyword: 'talex-touch-plugin',
+    },
+  }),
+]
+
+export const MARKET_SOURCES_STORAGE_INFO: MarketSourcesStorageInfo = {
+  storageKey: MARKET_SOURCES_STORAGE_KEY,
+  version: MARKET_SOURCES_STORAGE_VERSION,
+}
+
+export function createDefaultMarketSourcesPayload(): MarketSourcesPayload {
+  const clone = typeof structuredClone === 'function'
+    ? structuredClone(DEFAULT_MARKET_PROVIDERS)
+    : JSON.parse(JSON.stringify(DEFAULT_MARKET_PROVIDERS))
+
+  return {
+    version: MARKET_SOURCES_STORAGE_VERSION,
+    sources: clone,
+  }
+}

package/market/index.ts

@@ -0,0 +1,2 @@
+export * from './types'
+export * from './constants'

package/market/types.ts

@@ -0,0 +1,118 @@
+import type { StorageList } from '../common/storage/constants'
+
+export type MarketProviderType = 'repository' | 'nexusStore' | 'npmPackage'
+
+export type MarketProviderTrustLevel = 'official' | 'verified' | 'unverified'
+
+export interface MarketProviderDefinition {
+  id: string
+  name: string
+  type: MarketProviderType
+  /**
+   * Base URL or identifier for the provider.
+   * Individual provider implementations can interpret this differently.
+   */
+  url?: string
+  /**
+   * Additional configuration object for provider specific options.
+   */
+  config?: Record<string, any>
+  description?: string
+  enabled: boolean
+  priority: number
+  trustLevel?: MarketProviderTrustLevel
+  tags?: string[]
+  /**
+    * Whether this provider should be treated as read-only (no install)
+    */
+  readOnly?: boolean
+}
+
+export interface MarketSourcesPayload {
+  /**
+   * Schema version, used for migrations.
+   */
+  version: number
+  sources: MarketProviderDefinition[]
+}
+
+export type MarketInstallInstruction =
+  | {
+    type: 'url'
+    url: string
+    format?: 'zip' | 'tar' | 'tgz' | 'tpex'
+    integrity?: string
+  }
+  | {
+    type: 'npm'
+    packageName: string
+    version?: string
+    registry?: string
+  }
+  | {
+    type: 'git'
+    repo: string
+    ref?: string
+    sparse?: boolean
+  }
+
+export interface MarketPlugin {
+  id: string
+  name: string
+  version?: string
+  description?: string
+  category?: string
+  tags?: string[]
+  author?: string
+  icon?: string
+  metadata?: Record<string, unknown>
+  readmeUrl?: string
+  homepage?: string
+  downloadUrl?: string
+  install?: MarketInstallInstruction
+  providerId: string
+  providerName: string
+  providerType: MarketProviderType
+  providerTrustLevel: MarketProviderTrustLevel
+  trusted: boolean
+  official?: boolean
+  timestamp?: number | string
+}
+
+export interface MarketProviderResultMeta {
+  providerId: string
+  providerName: string
+  providerType: MarketProviderType
+  success: boolean
+  error?: string
+  fetchedAt: number
+  itemCount: number
+}
+
+export interface MarketProviderListOptions {
+  keyword?: string
+  force?: boolean
+}
+
+export interface MarketHttpRequestOptions {
+  url: string
+  method?: 'GET' | 'POST' | 'PUT' | 'DELETE'
+  headers?: Record<string, string>
+  params?: Record<string, any>
+  data?: any
+  timeout?: number
+  responseType?: 'json' | 'text' | 'arraybuffer'
+}
+
+export interface MarketHttpResponse<T = unknown> {
+  status: number
+  statusText: string
+  headers: Record<string, string>
+  data: T
+  url: string
+}
+
+export interface MarketSourcesStorageInfo {
+  storageKey: StorageList
+  version: number
+}

package/package.json

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

package/plugin/channel.ts

@@ -10,6 +10,8 @@ import {
   DataCode,
 } from '../channel'
 
+const CHANNEL_DEFAULT_TIMEOUT = 10_000
+
 let cachedIpcRenderer: IpcRenderer | null = null
 
 // 使用惰性解析避免在打包阶段静态引入 electron
@@ -197,6 +199,19 @@ class TouchChannel implements ITouchClientChannel {
     return true
   }
 
+  private formatPayloadPreview(payload: unknown): string {
+    if (payload === null || payload === undefined)
+      return String(payload)
+    if (typeof payload === 'string')
+      return payload.length > 200 ? `${payload.slice(0, 200)}…` : payload
+    try {
+      return JSON.stringify(payload)
+    }
+    catch {
+      return '[unserializable]'
+    }
+  }
+
   send(eventName: string, arg: any): Promise<any> {
     const uniqueId = `${new Date().getTime()}#${eventName}@${Math.random().toString(
       12,
@@ -207,7 +222,7 @@ class TouchChannel implements ITouchClientChannel {
       data: arg,
       sync: {
         timeStamp: new Date().getTime(),
-        timeout: 10000,
+        timeout: CHANNEL_DEFAULT_TIMEOUT,
         id: uniqueId,
       },
       name: eventName,
@@ -218,10 +233,40 @@ class TouchChannel implements ITouchClientChannel {
       },
     } as RawStandardChannelData
 
-    return new Promise((resolve) => {
-      this.ipcRenderer.send('@plugin-process-message', data)
+    return new Promise((resolve, reject) => {
+      try {
+        this.ipcRenderer.send('@plugin-process-message', data)
+      }
+      catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error)
+        console.error(
+          `[PluginChannel] Failed to send "${eventName}": ${errorMessage}`,
+          { payloadPreview: this.formatPayloadPreview(arg) },
+        )
+        reject(
+          Object.assign(
+            new Error(`Failed to send plugin channel message "${eventName}": ${errorMessage}`),
+            { code: 'plugin_channel_send_failed' },
+          ),
+        )
+        return
+      }
+
+      const timeoutMs = data.sync?.timeout ?? CHANNEL_DEFAULT_TIMEOUT
+      const timeoutHandle = setTimeout(() => {
+        if (!this.pendingMap.has(uniqueId))
+          return
+        this.pendingMap.delete(uniqueId)
+        const timeoutError = Object.assign(
+          new Error(`Plugin channel request "${eventName}" timed out after ${timeoutMs}ms`),
+          { code: 'plugin_channel_timeout' },
+        )
+        console.warn(timeoutError.message)
+        reject(timeoutError)
+      }, timeoutMs)
 
       this.pendingMap.set(uniqueId, (res: any) => {
+        clearTimeout(timeoutHandle)
         this.pendingMap.delete(uniqueId)
 
         resolve(res.data)
@@ -241,12 +286,26 @@ class TouchChannel implements ITouchClientChannel {
       },
     } as RawStandardChannelData
 
-    const res = this.__parse_raw_data(void 0, this.ipcRenderer.sendSync('@plugin-process-message', data))!
+    try {
+      const res = this.__parse_raw_data(
+        void 0,
+        this.ipcRenderer.sendSync('@plugin-process-message', data),
+      )!
 
-    if (res.header.status === 'reply')
-      return res.data
+      if (res.header.status === 'reply')
+        return res.data
 
-    return res
+      return res
+    }
+    catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error)
+      console.error('[PluginChannel] Failed to sendSync message', {
+        eventName,
+        error: errorMessage,
+        payloadPreview: this.formatPayloadPreview(arg),
+      })
+      throw new Error(`Failed to sendSync plugin channel message "${eventName}": ${errorMessage}`)
+    }
   }
 }
 

package/plugin/index.ts

@@ -498,3 +498,4 @@ export type { IPluginLogger, LogDataType, LogItem, LogLevel } from './log/types'
 export * from './providers'
 export * from './risk'
 export * from './sdk/index'
+export * from './widget'

package/plugin/sdk/README.md

@@ -26,8 +26,10 @@ plugin.box.shrink()
 plugin.box.hideInput()
 plugin.box.showInput()
 
-// 获取当前输入
+// 获取与设置输入
 const input = await plugin.box.getInput()
+await plugin.box.setInput('Hello Touch!')
+await plugin.box.clearInput()
 ```
 
 ### 2. FeatureSDK - 搜索结果管理
@@ -203,6 +205,8 @@ export default {
 - `core-box:hide-input` - 隐藏输入框
 - `core-box:show-input` - 显示输入框
 - `core-box:get-input` - 获取当前输入值
+- `core-box:set-input` - 设置输入框内容
+- `core-box:clear-input` - 清空输入框
 - `core-box:input-changed` - 输入变化广播（主进程 → 插件）
 - `core-box:set-input-visibility` - 设置输入框可见性（主进程 → 渲染进程）
 - `core-box:request-input-value` - 请求输入值（主进程 → 渲染进程）

package/plugin/sdk/box-sdk.ts

@@ -1,9 +1,28 @@
 /**
  * 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.
  */
+import { ensureRendererChannel } from './channel'
+
+/**
+ * Clipboard content type flags for binary combination
+ */
+export enum ClipboardType {
+  TEXT = 0b0001,
+  IMAGE = 0b0010,
+  FILE = 0b0100,
+}
+
+/**
+ * Preset clipboard type combinations
+ */
+export const ClipboardTypePresets = {
+  TEXT_ONLY: ClipboardType.TEXT,
+  TEXT_AND_IMAGE: ClipboardType.TEXT | ClipboardType.IMAGE,
+  ALL: ClipboardType.TEXT | ClipboardType.IMAGE | ClipboardType.FILE,
+} as const
 
 /**
  * Expand options for CoreBox window
@@ -17,18 +36,18 @@ export interface BoxExpandOptions {
 
 /**
  * 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()
  * ```
@@ -36,93 +55,142 @@ export interface BoxExpandOptions {
 export interface BoxSDK {
   /**
    * Hides the CoreBox window
-   * 
+   *
    * @example
    * ```typescript
    * plugin.box.hide()
    * ```
    */
-  hide(): void
+  hide: () => void
 
   /**
    * Shows the CoreBox window
-   * 
+   *
    * @example
    * ```typescript
    * plugin.box.show()
    * ```
    */
-  show(): void
+  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>
+  expand: (options?: BoxExpandOptions) => Promise<void>
 
   /**
    * Shrinks the CoreBox window to compact size
-   * 
+   *
    * @example
    * ```typescript
    * plugin.box.shrink()
    * ```
    */
-  shrink(): Promise<void>
+  shrink: () => Promise<void>
 
   /**
    * Hides the input field in CoreBox
-   * 
+   *
    * @example
    * ```typescript
    * plugin.box.hideInput()
    * ```
    */
-  hideInput(): Promise<void>
+  hideInput: () => Promise<void>
 
   /**
    * Shows the input field in CoreBox
-   * 
+   *
    * @example
    * ```typescript
    * plugin.box.showInput()
    * ```
    */
-  showInput(): Promise<void>
+  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>
+  getInput: () => Promise<string>
+
+  /**
+   * Sets the CoreBox search input to the specified value
+   *
+   * @example
+   * ```typescript
+   * await plugin.box.setInput('hello world')
+   * ```
+   */
+  setInput: (value: string) => Promise<void>
+
+  /**
+   * Clears the CoreBox search input
+   *
+   * @example
+   * ```typescript
+   * await plugin.box.clearInput()
+   * ```
+   */
+  clearInput: () => Promise<void>
+
+  /**
+   * Enable input monitoring for attached UI view
+   *
+   * @example
+   * ```typescript
+   * await plugin.box.allowInput()
+   * plugin.channel.regChannel('core-box:input-change', ({ data }) => {
+   *   console.log('Input changed:', data.input)
+   * })
+   * ```
+   */
+  allowInput: () => Promise<void>
+
+  /**
+   * Enable clipboard monitoring for specified type combination
+   *
+   * @param types - Binary combination of ClipboardType flags
+   *
+   * @example
+   * ```typescript
+   * // Allow text and images
+   * await plugin.box.allowClipboard(ClipboardType.TEXT | ClipboardType.IMAGE)
+   *
+   * // Or use presets
+   * await plugin.box.allowClipboard(ClipboardTypePresets.TEXT_AND_IMAGE)
+   * ```
+   */
+  allowClipboard: (types: number) => Promise<void>
 }
 
 /**
  * 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 {
@@ -148,7 +216,8 @@ export function createBoxSDK(channel: any): BoxSDK {
     async expand(options?: BoxExpandOptions): Promise<void> {
       try {
         await sendFn('core-box:expand', options || {})
-      } catch (error) {
+      }
+      catch (error) {
         console.error('[Box SDK] Failed to expand CoreBox:', error)
         throw error
       }
@@ -157,7 +226,8 @@ export function createBoxSDK(channel: any): BoxSDK {
     async shrink(): Promise<void> {
       try {
         await sendFn('core-box:expand', { mode: 'collapse' })
-      } catch (error) {
+      }
+      catch (error) {
         console.error('[Box SDK] Failed to shrink CoreBox:', error)
         throw error
       }
@@ -166,7 +236,8 @@ export function createBoxSDK(channel: any): BoxSDK {
     async hideInput(): Promise<void> {
       try {
         await sendFn('core-box:hide-input')
-      } catch (error) {
+      }
+      catch (error) {
         console.error('[Box SDK] Failed to hide input:', error)
         throw error
       }
@@ -175,7 +246,8 @@ export function createBoxSDK(channel: any): BoxSDK {
     async showInput(): Promise<void> {
       try {
         await sendFn('core-box:show-input')
-      } catch (error) {
+      }
+      catch (error) {
         console.error('[Box SDK] Failed to show input:', error)
         throw error
       }
@@ -185,35 +257,70 @@ export function createBoxSDK(channel: any): BoxSDK {
       try {
         const result = await sendFn('core-box:get-input')
         return result?.data?.input || result?.input || ''
-      } catch (error) {
+      }
+      catch (error) {
         console.error('[Box SDK] Failed to get input:', error)
         throw error
       }
-    }
+    },
+
+    async setInput(value: string): Promise<void> {
+      try {
+        await sendFn('core-box:set-input', { value })
+      }
+      catch (error) {
+        console.error('[Box SDK] Failed to set input:', error)
+        throw error
+      }
+    },
+
+    async clearInput(): Promise<void> {
+      try {
+        await sendFn('core-box:clear-input')
+      }
+      catch (error) {
+        console.error('[Box SDK] Failed to clear input:', error)
+        throw error
+      }
+    },
+
+    async allowInput(): Promise<void> {
+      try {
+        await sendFn('core-box:allow-input')
+      }
+      catch (error) {
+        console.error('[Box SDK] Failed to enable input monitoring:', error)
+        throw error
+      }
+    },
+
+    async allowClipboard(types: number): Promise<void> {
+      try {
+        await sendFn('core-box:allow-clipboard', types)
+      }
+      catch (error) {
+        console.error('[Box SDK] Failed to enable clipboard monitoring:', 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.')
-  }
-  
+  const channel = ensureRendererChannel('[Box SDK] Channel not available. Make sure this is called in a plugin context.')
   return createBoxSDK(channel)
 }

package/plugin/sdk/channel.ts

@@ -4,6 +4,34 @@ import { genChannel } from '../channel'
 
 const ensureClientChannel = (): ITouchClientChannel => genChannel()
 
+const DEFAULT_CHANNEL_ERROR = '[Plugin SDK] Channel not available. Make sure this code runs inside a plugin renderer context.'
+
+let cachedWindowChannel: ITouchClientChannel | null = null
+
+/**
+ * Ensures that the renderer-side plugin channel (window.$channel) exists and returns it.
+ *
+ * @param errorMessage - Optional custom error message when the channel is unavailable
+ */
+export function ensureRendererChannel(errorMessage = DEFAULT_CHANNEL_ERROR): ITouchClientChannel {
+  const globalWindow = typeof window === 'undefined' ? undefined : window
+  const channel = globalWindow?.$channel ?? cachedWindowChannel
+
+  if (!channel) {
+    throw new Error(errorMessage)
+  }
+
+  cachedWindowChannel = channel
+  return channel
+}
+
+/**
+ * Convenience hook for accessing window.$channel in plugin renderers.
+ */
+export function useChannel(errorMessage?: string): ITouchClientChannel {
+  return ensureRendererChannel(errorMessage)
+}
+
 export function createPluginRendererChannel(): IPluginRendererChannel {
   const client = ensureClientChannel()
 
@@ -46,3 +74,9 @@ export function usePluginRendererChannel(): IPluginRendererChannel {
 
   return cachedRendererChannel
 }
+
+declare global {
+  interface Window {
+    $channel: ITouchClientChannel
+  }
+}

package/plugin/sdk/division-box.ts

@@ -11,6 +11,7 @@ import type {
   DivisionBoxState,
   SessionInfo,
 } from '../../types/division-box'
+import { ensureRendererChannel } from './channel'
 
 /**
  * State change event handler
@@ -255,12 +256,6 @@ export function createDivisionBoxSDK(channel: any): DivisionBoxSDK {
  * ```
  */
 export function useDivisionBox(): DivisionBoxSDK {
-  // @ts-ignore - window.$channel is injected by the plugin system
-  const channel = window.$channel
-  
-  if (!channel) {
-    throw new Error('[DivisionBox SDK] Channel not available. Make sure this is called in a plugin context.')
-  }
-  
+  const channel = ensureRendererChannel('[DivisionBox SDK] Channel not available. Make sure this is called in a plugin context.')
   return createDivisionBoxSDK(channel)
 }

package/plugin/sdk/feature-sdk.ts

@@ -7,6 +7,7 @@
  */
 
 import type { TuffItem } from '../../core-box/tuff'
+import { ensureRendererChannel } from './channel'
 
 /**
  * Input change event handler
@@ -218,18 +219,13 @@ export function createFeatureSDK(boxItemsAPI: any, channel: any): FeatureSDK {
  * ```
  */
 export function useFeature(): FeatureSDK {
-  // @ts-ignore - window.$boxItems and window.$channel are injected by the plugin system
+  // @ts-ignore - window.$boxItems is injected by the plugin system
   const boxItemsAPI = window.$boxItems
-  // @ts-ignore
-  const channel = window.$channel
+  const channel = ensureRendererChannel('[Feature SDK] Channel not available. Make sure this is called in a plugin context.')
   
   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/hooks/bridge.ts

@@ -1,4 +1,5 @@
 import { BridgeEventForCoreBox } from '../enum/bridge-event'
+import { ensureRendererChannel } from '../channel'
 
 export type BridgeEvent = BridgeEventForCoreBox
 
@@ -26,7 +27,8 @@ export function injectBridgeEvent<T>(type: BridgeEvent, hook: BridgeHook<T>) {
 
   // Only register the channel listener once per event type
   if (hooks.length === 0) {
-    window.$channel.regChannel(type, ({ data }) => {
+    const channel = ensureRendererChannel('[TouchSDK] Bridge channel not available. Make sure hooks run in plugin renderer context.')
+    channel.regChannel(type, ({ data }) => {
       console.debug(`[TouchSDK] ${type} event received: `, data)
       // When the event is received, call all registered hooks for this type
       const registeredHooks = __hooks[type]

package/plugin/sdk/hooks/life-cycle.ts

@@ -1,3 +1,5 @@
+import { ensureRendererChannel } from '../channel'
+
 export enum LifecycleHooks {
   ENABLE = 'en',
   DISABLE = 'di',
@@ -22,7 +24,8 @@ export function injectHook(type: LifecycleHooks, hook: Function, processFunc = (
   const hooks: Array<Function> = __hooks[type] || (__hooks[type] = [])
 
   if (hooks.length === 0) {
-    window.$channel.regChannel(`@lifecycle:${type}`, (obj: any) => {
+    const channel = ensureRendererChannel('[Lifecycle Hook] Channel not available. Make sure hooks run in plugin renderer context.')
+    channel.regChannel(`@lifecycle:${type}`, (obj: any) => {
       processFunc(obj)
 
       // @ts-ignore

package/plugin/sdk/storage.ts

@@ -1,4 +1,5 @@
 import type { FileDetails, StorageStats, StorageTreeNode } from '../../types/storage'
+import { ensureRendererChannel } from './channel'
 
 /**
  * Get the storage for the current plugin.
@@ -15,7 +16,7 @@ export function usePluginStorage() {
     throw new Error('[Plugin SDK] Cannot determine plugin name. Make sure this is called in a plugin context.')
   }
 
-  const channel = window.$channel
+  const channel = ensureRendererChannel('[Plugin Storage] Channel not available. Make sure this is called in a plugin context.')
 
   return {
     /**

package/plugin/widget.ts

@@ -0,0 +1,25 @@
+export const DEFAULT_WIDGET_RENDERERS = {
+  CORE_PREVIEW_CARD: 'core-preview-card',
+  CORE_INTELLIGENCE_ANSWER: 'core-intelligence-answer',
+} as const
+
+const values = Object.values(DEFAULT_WIDGET_RENDERERS)
+export const DEFAULT_WIDGET_RENDERER_IDS = new Set<string>(values)
+
+export function isDefaultWidgetRenderer(id: string | undefined): boolean {
+  return Boolean(id) && DEFAULT_WIDGET_RENDERER_IDS.has(id!)
+}
+
+export interface WidgetRegistrationPayload {
+  widgetId: string
+  pluginName: string
+  featureId: string
+  filePath: string
+  code: string
+  styles: string
+  hash: string
+}
+
+export function makeWidgetId(pluginName: string, featureId: string): string {
+  return `${pluginName}::${featureId}`
+}

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