@talex-touch/utils 1.0.32 → 1.0.34

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/common/utils/polling.ts

@@ -1,3 +1,4 @@
+/* eslint-disable no-console */
 /**
  * @module polling
  * A high-precision, efficient, singleton polling service for scheduling periodic tasks.
@@ -75,7 +76,7 @@ export class PollingService {
       nextRunMs,
     })
 
-    console.log(`[PollingService] Task '${id}' registered to run every ${options.interval} ${options.unit}.`)
+    console.debug(`[PollingService] Task '${id}' registered to run every ${options.interval} ${options.unit}.`)
 
     if (this.isRunning) {
       this._reschedule()

package/core-box/index.ts

@@ -5,3 +5,4 @@ export * from './preview/index'
  * Search box core functionality package
  */
 export * from './tuff/index'
+export * from './recommendation'

package/core-box/recommendation.ts

@@ -0,0 +1,77 @@
+/**
+ * Time-based usage pattern context for recommendation matching.
+ */
+export interface TimePattern {
+  /** Hour of day (0-23) */
+  hourOfDay: number
+  /** Day of week (0-6, 0=Sunday) */
+  dayOfWeek: number
+  /** Whether current time falls within working hours (9-18, weekdays) */
+  isWorkingHours: boolean
+  /** Broad time categorization */
+  timeSlot: 'morning' | 'afternoon' | 'evening' | 'night'
+}
+
+/**
+ * Complete contextual signal for recommendation matching.
+ * Gathered from system state, clipboard, and active applications.
+ */
+export interface ContextSignal {
+  time: TimePattern
+  clipboard?: {
+    type: string
+    /** Hashed content for privacy (not original text) */
+    content: string
+    timestamp: number
+    contentType?: 'url' | 'text' | 'code' | 'file'
+    meta?: {
+      isUrl?: boolean
+      urlDomain?: string
+      textLength?: number
+      fileExtension?: string
+      fileType?: 'code' | 'text' | 'image' | 'document' | 'other'
+      language?: string
+    }
+  }
+  foregroundApp?: {
+    bundleId: string
+    name: string
+  }
+  systemState?: {
+    isOnline: boolean
+    batteryLevel: number
+    isDNDEnabled: boolean
+  }
+}
+
+/**
+ * Scored recommendation item from recommendation engine.
+ */
+export interface ScoredItem {
+  sourceId: string
+  itemId: string
+  score: number
+  source: 'frequent' | 'time-based' | 'recent' | 'trending' | 'context'
+  reason?: string
+}
+
+/**
+ * Recommendation badge display configuration for UI rendering.
+ */
+export interface RecommendationBadge {
+  text: string
+  icon: string
+  variant: 'frequent' | 'intelligent' | 'recent' | 'trending'
+}
+
+/**
+ * Enhanced item metadata for intelligent recommendations.
+ * Attached to TuffItem.meta for rendering and filtering.
+ */
+export interface RecommendationMetadata {
+  score: number
+  source: ScoredItem['source']
+  reason: string
+  isIntelligent: boolean
+  badge: RecommendationBadge
+}

package/electron/index.ts

@@ -1,3 +1,3 @@
-export * from './clipboard-helper'
 export * from './download-manager'
 export * from './env-tool'
+

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.32",
+  "version": "1.0.34",
   "private": false,
   "description": "Tuff series utils",
   "author": "TalexDreamSoul",

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

@@ -0,0 +1,216 @@
+# Plugin SDK 重构说明
+
+## 概述
+
+Plugin SDK 已重构为统一的工厂函数模式，参考 `DivisionBoxSDK` 的设计。旧版本 API 已废弃，调用时会抛出错误。
+
+## 新的 SDK 结构
+
+### 1. BoxSDK - CoreBox 窗口控制
+
+控制 CoreBox 窗口的显示、大小和输入框状态。
+
+```typescript
+// 隐藏/显示 CoreBox
+plugin.box.hide()
+plugin.box.show()
+
+// 扩展窗口（显示更多结果）
+plugin.box.expand({ length: 10 })
+plugin.box.expand({ forceMax: true })
+
+// 收缩窗口
+plugin.box.shrink()
+
+// 控制输入框
+plugin.box.hideInput()
+plugin.box.showInput()
+
+// 获取当前输入
+const input = await plugin.box.getInput()
+```
+
+### 2. FeatureSDK - 搜索结果管理
+
+管理插件推送的搜索结果项（TuffItems）。
+
+```typescript
+// 推送多个结果
+plugin.feature.pushItems([
+  { id: 'item-1', title: { text: 'Result 1' }, ... },
+  { id: 'item-2', title: { text: 'Result 2' }, ... }
+])
+
+// 更新单个结果
+plugin.feature.updateItem('item-1', {
+  title: { text: 'Updated Title' }
+})
+
+// 删除单个结果
+plugin.feature.removeItem('item-1')
+
+// 清空所有结果
+plugin.feature.clearItems()
+
+// 获取所有结果
+const items = plugin.feature.getItems()
+
+// 监听输入变化（实时搜索）
+const unsubscribe = plugin.feature.onInputChange((input) => {
+  console.log('User typed:', input)
+  // 执行实时搜索
+  performSearch(input)
+})
+
+// 取消监听
+unsubscribe()
+```
+
+## 废弃的 API
+
+以下 API 已废弃，调用时会抛出错误：
+
+### 旧的 Box API
+```typescript
+// ❌ 废弃
+plugin.$box.hide()
+plugin.$box.show()
+
+// ✅ 使用新 API
+plugin.box.hide()
+plugin.box.show()
+```
+
+### 旧的 Feature API
+```typescript
+// ❌ 废弃
+plugin.pushItems(items)
+plugin.clearItems()
+plugin.getItems()
+
+// ✅ 使用新 API
+plugin.feature.pushItems(items)
+plugin.feature.clearItems()
+plugin.feature.getItems()
+```
+
+## 迁移指南
+
+### 1. 更新 Box 控制代码
+
+**旧代码：**
+```typescript
+plugin.$box.hide()
+plugin.$box.show()
+```
+
+**新代码：**
+```typescript
+plugin.box.hide()
+plugin.box.show()
+plugin.box.expand({ length: 10 })
+plugin.box.shrink()
+```
+
+### 2. 更新搜索结果管理
+
+**旧代码：**
+```typescript
+plugin.pushItems([...])
+plugin.clearItems()
+const items = plugin.getItems()
+```
+
+**新代码：**
+```typescript
+plugin.feature.pushItems([...])
+plugin.feature.updateItem('id', { ... })
+plugin.feature.removeItem('id')
+plugin.feature.clearItems()
+const items = plugin.feature.getItems()
+```
+
+### 3. 添加实时搜索支持
+
+**新功能：**
+```typescript
+// 在插件初始化时注册监听器
+onInit(context) {
+  context.utils.feature.onInputChange((input) => {
+    // 用户输入变化时触发
+    this.performRealTimeSearch(input)
+  })
+}
+```
+
+## 完整示例
+
+```typescript
+export default {
+  onInit(context) {
+    const { feature, box } = context.utils
+    
+    // 监听输入变化
+    feature.onInputChange((input) => {
+      if (input.length > 2) {
+        // 执行搜索
+        const results = performSearch(input)
+        feature.pushItems(results)
+      } else {
+        feature.clearItems()
+      }
+    })
+  },
+  
+  onFeatureTriggered(featureId, query, feature) {
+    const { feature: featureSDK, box } = this.context.utils
+    
+    // 推送结果
+    featureSDK.pushItems([
+      {
+        id: 'result-1',
+        title: { text: 'Search Result' },
+        subtitle: { text: 'Description' },
+        source: { id: this.pluginName, name: this.pluginName }
+      }
+    ])
+    
+    // 扩展窗口显示结果
+    box.expand({ length: 5 })
+    
+    // 3秒后隐藏
+    setTimeout(() => {
+      box.hide()
+    }, 3000)
+  }
+}
+```
+
+## 技术细节
+
+### SDK 工厂函数
+
+所有 SDK 都通过工厂函数创建：
+
+- `createBoxSDK(channel)` - 创建 Box SDK 实例
+- `createFeatureSDK(boxItems, channel)` - 创建 Feature SDK 实例
+- `createDivisionBoxSDK(channel)` - 创建 DivisionBox SDK 实例
+
+### IPC 通道
+
+新增的 IPC 通道：
+
+- `core-box:hide-input` - 隐藏输入框
+- `core-box:show-input` - 显示输入框
+- `core-box:get-input` - 获取当前输入值
+- `core-box:input-changed` - 输入变化广播（主进程 → 插件）
+- `core-box:set-input-visibility` - 设置输入框可见性（主进程 → 渲染进程）
+- `core-box:request-input-value` - 请求输入值（主进程 → 渲染进程）
+
+### 架构优势
+
+1. **统一的 API 风格** - 所有 SDK 使用相同的工厂函数模式
+2. **更好的类型安全** - TypeScript 类型定义完整
+3. **功能分离** - Box 控制和 Feature 管理职责清晰
+4. **扩展性强** - 易于添加新功能
+5. **向后不兼容** - 强制迁移到新 API，避免技术债务