@talex-touch/utils 1.0.39 → 1.0.42

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

@@ -803,6 +803,65 @@ export interface TuffContext {
   tags?: string[]
 }
 
+// ==================== Footer Hints 配置 ====================
+
+/**
+ * Footer hint 单项配置
+ */
+export interface TuffFooterHintItem {
+  /** 快捷键显示文本 */
+  key: string
+  /** 提示标签 */
+  label: string
+  /** 是否显示此提示 */
+  visible?: boolean
+  /** 触发的事件名称 */
+  event?: string
+  /** 事件携带的数据 */
+  eventData?: Record<string, unknown>
+}
+
+/**
+ * Footer hints 配置
+ * @description 控制 CoreBox 底部快捷键提示的显示和行为
+ */
+export interface TuffFooterHints {
+  /**
+   * 主操作提示（回车键）
+   * @description 自定义回车键的文案，如 "发送"、"执行"、"打开" 等
+   */
+  primary?: {
+    /** 自定义标签文案 */
+    label?: string
+    /** 是否显示 */
+    visible?: boolean
+  }
+
+  /**
+   * 辅助操作提示（Meta+K）
+   * @description 控制 Meta+K 快捷键的显示和行为
+   */
+  secondary?: {
+    /** 自定义标签文案 */
+    label?: string
+    /** 是否显示，默认 false（隐藏） */
+    visible?: boolean
+    /** 触发的事件名称 */
+    event?: string
+    /** 事件携带的数据 */
+    eventData?: Record<string, unknown>
+  }
+
+  /**
+   * 快速选择提示（Meta+1-0）
+   * @description 控制快速选择快捷键的显示
+   */
+  quickSelect?: {
+    /** 是否显示，默认根据场景自动判断 */
+    visible?: boolean
+  }
+}
+
 // ==================== 扩展元数据 ====================
 
 /**
@@ -1005,15 +1064,37 @@ export interface TuffMeta {
     permissions?: string[]
   }
 
+  /** TuffIntelligence */
+  intelligence?: any
+
+  /** Keep CoreBox open after action execution */
+  keepCoreBoxOpen?: boolean
+
+  /** 固定配置 */
+  pinned?: {
+    isPinned: boolean
+    pinnedAt?: number
+    order?: number
+  }
+
+  /** 推荐来源标记 */
+  recommendation?: {
+    source: 'frequent' | 'recent' | 'time-based' | 'trending' | 'pinned' | 'context'
+    score?: number
+  }
+
   /**
-   * TuffIntelligence
+   * 额外关键词
+   * @description 用于搜索索引的额外关键词，会参与关键字索引匹配
+   * @warning 不建议添加太多关键词（建议 <= 10），过多会影响搜索性能
    */
-  intelligence?: any
+  keywords?: string[]
 
   /**
-   * Keep CoreBox open after action execution
+   * Footer hints 配置
+   * @description 控制 CoreBox 底部快捷键提示的显示和行为
    */
-  keepCoreBoxOpen?: boolean
+  footerHints?: TuffFooterHints
 }
 
 // ==================== 前端展示结构 ====================
@@ -1267,71 +1348,69 @@ export interface SortStat {
   duration: number
 }
 
-/**
- * 搜索结果结构
- *
- * @description
- * 定义搜索返回的结果集合和元数据。
- * 包含匹配项、统计信息和分页数据等。
- */
+/** 容器布局配置 */
+export interface TuffContainerLayout {
+  /** 布局模式 */
+  mode: 'list' | 'grid'
+  /** 宫格配置 */
+  grid?: {
+    /** 列数 */
+    columns: number
+    /** 间距(px) */
+    gap?: number
+    /** 单项尺寸 */
+    itemSize?: 'small' | 'medium' | 'large'
+  }
+  /** 分组配置 */
+  sections?: TuffSection[]
+}
+
+/** 分组元数据 */
+export interface TuffSectionMeta {
+  /** 是否为智能推荐分组 */
+  intelligence?: boolean
+  /** 扩展字段 */
+  [key: string]: unknown
+}
+
+/** 分组定义 */
+export interface TuffSection {
+  id: string
+  title?: string
+  layout: 'list' | 'grid'
+  /** 该分组的 item ids */
+  itemIds: string[]
+  collapsed?: boolean
+  /** 分组元数据 */
+  meta?: TuffSectionMeta
+}
+
+/** 搜索结果结构 */
 export interface TuffSearchResult {
-  /**
-   * A unique identifier for this specific search operation.
-   * This is crucial for the streaming model to associate updates with the correct search instance.
-   */
+  /** 搜索会话 ID */
   sessionId?: string
-
-  /**
-   * 结果项目
-   * @description 匹配的TuffItem列表
-   * @required
-   */
+  /** 结果项目 */
   items: TuffItem[]
 
-  /**
-   * 查询信息
-   * @description 原始查询参数
-   * @required
-   */
+  /** 原始查询参数 */
   query: TuffQuery
-
-  /**
-   * 搜索耗时
-   * @description 搜索执行的毫秒数
-   * @required
-   */
+  /** 搜索耗时(ms) */
   duration: number
-
-  /**
-   * 来源统计
-   * @description 各数据来源的结果统计
-   * @required
-   */
+  /** 来源统计 */
   sources: Array<{
-    /** Provider's unique ID. */
     providerId: string
-    /** Provider's display name. */
     providerName: string
-    /** Search duration in milliseconds. */
     duration: number
-    /** Number of results returned. */
     resultCount: number
-    /** Status of the search operation. */
     status: 'success' | 'timeout' | 'error'
   }>
-
-  /**
-   * AI 推荐
-   * @description AI生成的搜索建议
-   */
+  /** 容器布局配置 */
+  containerLayout?: TuffContainerLayout
+  /** AI 推荐建议 */
   suggestions?: string[]
-
-  /**
-   * The provider(s) to activate after this search result.
-   */
+  /** 激活的 provider */
   activate?: IProviderActivate[]
-
-  /** Optional statistics about the sorting process. */
+  /** 排序统计 */
   sort_stats?: SortStat[]
 }
 

package/intelligence/client.ts

@@ -1,4 +1,4 @@
-import type { AiInvokeOptions, AiInvokeResult, AiProviderConfig } from '../types/intelligence'
+import type { IntelligenceInvokeOptions, IntelligenceInvokeResult, IntelligenceProviderConfig } from '../types/intelligence'
 
 export interface IntelligenceClientChannel {
   send: (eventName: string, payload: unknown) => Promise<any>
@@ -50,10 +50,10 @@ async function assertResponse<T>(promise: Promise<ChannelResponse<T>>): Promise<
 }
 
 export interface IntelligenceClient {
-  invoke: <T = any>(capabilityId: string, payload: any, options?: AiInvokeOptions) => Promise<AiInvokeResult<T>>
-  testProvider: (config: AiProviderConfig) => Promise<unknown>
+  invoke: <T = any>(capabilityId: string, payload: any, options?: IntelligenceInvokeOptions) => Promise<IntelligenceInvokeResult<T>>
+  testProvider: (config: IntelligenceProviderConfig) => Promise<unknown>
   testCapability: (params: Record<string, any>) => Promise<unknown>
-  fetchModels: (config: AiProviderConfig) => Promise<{ success: boolean, models?: string[], message?: string }>
+  fetchModels: (config: IntelligenceProviderConfig) => Promise<{ success: boolean, models?: string[], message?: string }>
 }
 
 export function createIntelligenceClient(channel?: IntelligenceClientChannel, resolvers?: IntelligenceChannelResolver[]): IntelligenceClient {
@@ -63,12 +63,12 @@ export function createIntelligenceClient(channel?: IntelligenceClientChannel, re
   }
 
   return {
-    invoke<T = any>(capabilityId: string, payload: any, options?: AiInvokeOptions) {
-      return assertResponse<AiInvokeResult<T>>(
+    invoke<T = any>(capabilityId: string, payload: any, options?: IntelligenceInvokeOptions) {
+      return assertResponse<IntelligenceInvokeResult<T>>(
         resolvedChannel.send('intelligence:invoke', { capabilityId, payload, options }),
       )
     },
-    testProvider(config: AiProviderConfig) {
+    testProvider(config: IntelligenceProviderConfig) {
       return assertResponse(
         resolvedChannel.send('intelligence:test-provider', { provider: config }),
       )
@@ -78,7 +78,7 @@ export function createIntelligenceClient(channel?: IntelligenceClientChannel, re
         resolvedChannel.send('intelligence:test-capability', params),
       )
     },
-    fetchModels(config: AiProviderConfig) {
+    fetchModels(config: IntelligenceProviderConfig) {
       return assertResponse<{ success: boolean, models?: string[], message?: string }>(
         resolvedChannel.send('intelligence:fetch-models', { provider: config }),
       )

package/market/constants.ts

@@ -21,6 +21,20 @@ function defineProvider(
 }
 
 export const DEFAULT_MARKET_PROVIDERS: MarketProviderDefinition[] = [
+  defineProvider({
+    id: 'tuff-nexus',
+    name: 'Tuff Nexus',
+    type: 'tpexApi',
+    url: 'https://tuff.tagzxia.com',
+    description: 'Tuff 官方插件市场，提供经过审核的插件。',
+    enabled: true,
+    priority: 110,
+    trustLevel: 'official',
+    readOnly: true,
+    config: {
+      apiUrl: 'https://tuff.tagzxia.com/api/market/plugins',
+    },
+  }),
   defineProvider({
     id: 'talex-official',
     name: 'Talex Official',

package/market/types.ts

@@ -1,6 +1,6 @@
 import type { StorageList } from '../common/storage/constants'
 
-export type MarketProviderType = 'repository' | 'nexusStore' | 'npmPackage'
+export type MarketProviderType = 'repository' | 'nexusStore' | 'npmPackage' | 'tpexApi'
 
 export type MarketProviderTrustLevel = 'official' | 'verified' | 'unverified'
 

package/package.json

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

package/plugin/index.ts

@@ -134,7 +134,8 @@ export interface ITouchPlugin extends IPluginBaseInfo {
 export interface IFeatureCommand {
   type: 'match' | 'contain' | 'regex' | 'function' | 'over' | 'image' | 'files' | 'directory' | 'window'
   value: string | string[] | RegExp | Function
-  onTrigger: () => void
+  /** Optional trigger callback - not serialized over IPC */
+  onTrigger?: () => void
 }
 
 export interface IPluginFeature {
@@ -142,10 +143,15 @@ export interface IPluginFeature {
   name: string
   desc: string
   icon: ITuffIcon
+  keywords?: string[]
   push: boolean
   platform: IPlatform
   commands: IFeatureCommand[]
   interaction?: IFeatureInteraction
+  /**
+   * Internal search tokens generated at runtime for better matching
+   */
+  searchTokens?: string[]
   /**
    * Priority of the feature for sorting in search results
    * Higher numbers have higher priority (displayed first)

package/plugin/providers/index.ts

@@ -1,2 +1,6 @@
 export * from './registry'
 export * from './types'
+export * from './tpex-types'
+export * from './tpex-provider'
+export * from './npm-provider'
+export * from './market-client'

package/plugin/providers/market-client.ts

@@ -0,0 +1,215 @@
+import type { NpmPackageInfo } from './npm-provider'
+import type { TpexPluginInfo } from './tpex-provider'
+import { NpmProvider } from './npm-provider'
+import { TpexProvider } from './tpex-provider'
+import { PluginProviderType } from './types'
+
+export type PluginSourceType = 'tpex' | 'npm' | 'all'
+
+export interface MarketPluginInfo {
+  id: string
+  name: string
+  slug: string
+  version: string
+  description: string
+  author: string
+  icon?: string
+  source: PluginSourceType
+  isOfficial: boolean
+  downloads?: number
+  category?: string
+  keywords?: string[]
+  homepage?: string
+  packageUrl?: string
+  raw: TpexPluginInfo | NpmPackageInfo
+}
+
+export interface MarketSearchOptions {
+  keyword?: string
+  source?: PluginSourceType
+  category?: string
+  limit?: number
+  offset?: number
+}
+
+export interface MarketSearchResult {
+  plugins: MarketPluginInfo[]
+  total: number
+  sources: {
+    tpex: number
+    npm: number
+  }
+}
+
+function normalizeTpexPlugin(plugin: TpexPluginInfo): MarketPluginInfo {
+  return {
+    id: plugin.id,
+    name: plugin.name,
+    slug: plugin.slug,
+    version: plugin.latestVersion?.version ?? '0.0.0',
+    description: plugin.summary,
+    author: plugin.author?.name ?? 'Unknown',
+    icon: plugin.iconUrl ?? undefined,
+    source: 'tpex',
+    isOfficial: plugin.isOfficial,
+    downloads: plugin.installs,
+    category: plugin.category,
+    homepage: plugin.homepage ?? undefined,
+    packageUrl: plugin.latestVersion?.packageUrl,
+    raw: plugin,
+  }
+}
+
+function normalizeNpmPlugin(pkg: NpmPackageInfo): MarketPluginInfo {
+  const authorName = typeof pkg.author === 'string'
+    ? pkg.author
+    : pkg.author?.name ?? 'Unknown'
+
+  return {
+    id: pkg.name,
+    name: pkg.name.replace(/^tuff-plugin-/, '').replace(/^@tuff\//, ''),
+    slug: pkg.name,
+    version: pkg.version,
+    description: pkg.description ?? '',
+    author: authorName,
+    icon: pkg.tuff?.icon,
+    source: 'npm',
+    isOfficial: pkg.name.startsWith('@tuff/'),
+    keywords: pkg.keywords,
+    packageUrl: pkg.dist.tarball,
+    raw: pkg,
+  }
+}
+
+/**
+ * Unified plugin market client supporting multiple sources
+ */
+export class PluginMarketClient {
+  private tpexProvider: TpexProvider
+  private npmProvider: NpmProvider
+
+  constructor(options?: {
+    tpexApiBase?: string
+    npmRegistry?: string
+  }) {
+    this.tpexProvider = new TpexProvider(options?.tpexApiBase)
+    this.npmProvider = new NpmProvider(options?.npmRegistry)
+  }
+
+  /**
+   * Search plugins from all sources
+   */
+  async search(options: MarketSearchOptions = {}): Promise<MarketSearchResult> {
+    const { keyword, source = 'all', limit = 50, offset = 0 } = options
+    const results: MarketPluginInfo[] = []
+    let tpexCount = 0
+    let npmCount = 0
+
+    if (source === 'all' || source === 'tpex') {
+      try {
+        const tpexPlugins = keyword
+          ? await this.tpexProvider.searchPlugins(keyword)
+          : await this.tpexProvider.listPlugins()
+
+        const normalized = tpexPlugins.map(normalizeTpexPlugin)
+        results.push(...normalized)
+        tpexCount = normalized.length
+      }
+      catch (error) {
+        console.warn('[MarketClient] TPEX search failed:', error)
+      }
+    }
+
+    if (source === 'all' || source === 'npm') {
+      try {
+        const npmPlugins = await this.npmProvider.searchPlugins(keyword)
+        const normalized = npmPlugins.map(normalizeNpmPlugin)
+        results.push(...normalized)
+        npmCount = normalized.length
+      }
+      catch (error) {
+        console.warn('[MarketClient] NPM search failed:', error)
+      }
+    }
+
+    const sorted = results.sort((a, b) => {
+      if (a.isOfficial !== b.isOfficial) return a.isOfficial ? -1 : 1
+      return (b.downloads ?? 0) - (a.downloads ?? 0)
+    })
+
+    const paginated = sorted.slice(offset, offset + limit)
+
+    return {
+      plugins: paginated,
+      total: results.length,
+      sources: {
+        tpex: tpexCount,
+        npm: npmCount,
+      },
+    }
+  }
+
+  /**
+   * Get plugin details by identifier
+   */
+  async getPlugin(identifier: string, source?: PluginSourceType): Promise<MarketPluginInfo | null> {
+    if (source === 'tpex' || (!source && !identifier.includes('/'))) {
+      try {
+        const plugin = await this.tpexProvider.getPlugin(identifier)
+        if (plugin) return normalizeTpexPlugin(plugin)
+      }
+      catch {
+        // Fall through to npm
+      }
+    }
+
+    if (source === 'npm' || !source) {
+      try {
+        const pkg = await this.npmProvider.getPackageInfo(identifier)
+        if (pkg) return normalizeNpmPlugin(pkg)
+      }
+      catch {
+        // Not found
+      }
+    }
+
+    return null
+  }
+
+  /**
+   * Get install source string for a plugin
+   */
+  getInstallSource(plugin: MarketPluginInfo): string {
+    if (plugin.source === 'tpex') {
+      return `tpex:${plugin.slug}`
+    }
+    return `npm:${plugin.id}`
+  }
+
+  /**
+   * Get provider type for a plugin
+   */
+  getProviderType(plugin: MarketPluginInfo): PluginProviderType {
+    return plugin.source === 'tpex'
+      ? PluginProviderType.TPEX
+      : PluginProviderType.NPM
+  }
+
+  /**
+   * List all plugins from official source (TPEX)
+   */
+  async listOfficialPlugins(): Promise<MarketPluginInfo[]> {
+    const plugins = await this.tpexProvider.listPlugins()
+    return plugins.map(normalizeTpexPlugin)
+  }
+
+  /**
+   * List all plugins from npm
+   */
+  async listNpmPlugins(): Promise<MarketPluginInfo[]> {
+    const plugins = await this.npmProvider.listPlugins()
+    return plugins.map(normalizeNpmPlugin)
+  }
+}
+
+export const defaultMarketClient = new PluginMarketClient()