@talex-touch/utils 1.0.42 → 1.0.44

package/i18n/locales/zh.json

@@ -0,0 +1,226 @@
+{
+  "devServer": {
+    "disconnected": "开发服务器已断开",
+    "disconnectedDesc": "与开发服务器的连接已断开，可能是服务器崩溃或网络中断。",
+    "reconnected": "开发服务器已重连",
+    "reconnecting": "正在重连开发服务器...",
+    "checkServer": "请检查开发服务器是否正常运行，或尝试手动重连。",
+    "connectionLost": "开发服务器连接已断开",
+    "connectionRestored": "开发服务器连接已恢复"
+  },
+  "flowTransfer": {
+    "shareComplete": "分享完成",
+    "shareFailed": "分享失败",
+    "copiedToClipboard": "已复制到剪贴板",
+    "fileRevealed": "文件已显示",
+    "airdropReady": "AirDrop 已就绪",
+    "mailReady": "邮件已打开",
+    "messagesReady": "信息已打开"
+  },
+  "plugin": {
+    "loadFailed": "插件加载失败",
+    "manifestInvalid": "清单文件无效",
+    "dependencyMissing": "缺少依赖",
+    "versionMismatch": "版本不匹配",
+    "permissionDenied": "权限被拒绝",
+    "sdkVersionMissing": "插件未声明 SDK 版本",
+    "sdkVersionOutdated": "插件 SDK 版本过旧",
+    "permissionMissing": "缺少必需权限"
+  },
+  "permission": {
+    "category": {
+      "fs": "文件系统",
+      "clipboard": "剪贴板",
+      "network": "网络",
+      "system": "系统",
+      "intelligence": "Intelligence 能力",
+      "storage": "存储",
+      "window": "窗口"
+    },
+    "risk": {
+      "low": "低风险",
+      "medium": "中风险",
+      "high": "高风险"
+    },
+    "fs": {
+      "read": { "name": "读取文件", "desc": "读取用户文件系统中的文件" },
+      "write": { "name": "写入文件", "desc": "创建、修改或删除用户文件" },
+      "execute": { "name": "执行文件", "desc": "运行可执行文件或脚本" }
+    },
+    "clipboard": {
+      "read": { "name": "读取剪贴板", "desc": "访问剪贴板中的内容" },
+      "write": { "name": "写入剪贴板", "desc": "将内容复制到剪贴板" }
+    },
+    "network": {
+      "local": { "name": "本地网络", "desc": "访问本地网络资源" },
+      "internet": { "name": "互联网访问", "desc": "发送和接收互联网请求" },
+      "download": { "name": "下载文件", "desc": "从互联网下载文件到本地" }
+    },
+    "system": {
+      "shell": { "name": "执行命令", "desc": "运行系统命令或脚本" },
+      "notification": { "name": "系统通知", "desc": "发送系统通知" },
+      "tray": { "name": "托盘交互", "desc": "访问系统托盘功能" }
+    },
+    "intelligence": {
+      "basic": { "name": "基础 Intelligence", "desc": "使用基础 Intelligence 能力" },
+      "admin": { "name": "Intelligence 管理", "desc": "使用高风险 Intelligence 能力" },
+      "agents": { "name": "智能体", "desc": "调用智能体系统" }
+    },
+    "storage": {
+      "plugin": { "name": "插件存储", "desc": "使用插件私有存储空间" },
+      "shared": { "name": "共享存储", "desc": "访问跨插件共享存储" },
+      "sqlite": { "name": "插件 SQLite", "desc": "读写插件本地 SQLite 数据库" }
+    },
+    "window": {
+      "create": { "name": "创建窗口", "desc": "创建新窗口或视图" },
+      "capture": { "name": "屏幕截图", "desc": "捕获屏幕内容" }
+    },
+    "grant": "授予",
+    "revoke": "撤销",
+    "granted": "已授予",
+    "denied": "已拒绝",
+    "required": "必需",
+    "optional": "可选",
+    "allowOnce": "仅本次",
+    "allowAlways": "始终允许",
+    "requestTitle": "权限请求",
+    "requestDesc": "{plugin} 请求 {permission} 权限",
+    "enforcementDisabled": "权限校验已禁用",
+    "legacyPluginWarning": "此插件使用旧版 SDK，权限校验已跳过"
+  },
+  "widget": {
+    "compileFailed": "Widget 编译失败",
+    "unsupportedType": "不支持的 Widget 类型",
+    "invalidDependency": "无效的依赖",
+    "loadFailed": "Widget 加载失败"
+  },
+  "system": {
+    "networkError": "网络错误",
+    "timeout": "请求超时",
+    "unknownError": "未知错误",
+    "operationCancelled": "操作已取消"
+  },
+  "intelligence": {
+    "search": {
+      "placeholder": "搜索提供商...",
+      "clear": "清除"
+    },
+    "config": {
+      "api": {
+        "apiKeyRequired": "API Key 是必需的",
+        "baseUrlInvalid": "无效的 base URL 格式"
+      }
+    },
+    "usage": {
+      "requests": "请求数",
+      "tokens": "Token 数",
+      "cost": "花销",
+      "successRate": "成功率",
+      "success": "成功",
+      "failure": "失败",
+      "promptTokens": "提示 Token",
+      "completionTokens": "完成 Token",
+      "today": "今天",
+      "thisMonth": "本月"
+    },
+    "audit": {
+      "records": "条记录",
+      "noLogs": "暂无审计日志"
+    },
+    "agents": {
+      "enabled": "已启用",
+      "disabled": "已禁用",
+      "empty": "暂无可用智能体",
+      "active": "活跃",
+      "inactive": "未激活",
+      "description": "描述",
+      "capabilities": "能力",
+      "task_success": "任务执行成功",
+      "task_failed": "任务执行失败"
+    },
+    "landing": {
+      "prompts": {
+        "title": "提示词管理",
+        "desc": "管理各种任务的 AI 提示词",
+        "editTitle": "编辑提示词",
+        "editDesc": "创建和管理自定义提示词",
+        "editButton": "打开编辑器",
+        "folderTitle": "提示词文件夹",
+        "folderDesc": "直接访问提示词文件",
+        "folderButton": "打开文件夹",
+        "statsTitle": "{count} 个提示词",
+        "statsDesc": "约 {words} 字",
+        "newPromptButton": "新建提示词",
+        "folderOpenSuccess": "提示词文件夹已打开",
+        "folderOpenFailed": "打开提示词文件夹失败",
+        "createPromptHint": "在编辑器中创建新提示词"
+      },
+      "capabilities": {
+        "title": "能力配置",
+        "desc": "配置 AI 能力和路由",
+        "manageTitle": "管理能力",
+        "manageDesc": "配置提供商绑定和模型",
+        "manageButton": "配置",
+        "auditTitle": "审计日志",
+        "auditDesc": "查看能力调用历史",
+        "auditButton": "查看日志",
+        "statsTitle": "{count} 次调用",
+        "statsDesc": "{total} 个能力，{bound} 个已绑定，平均 {freq} 次/天",
+        "statsButton": "查看指标"
+      }
+    }
+  },
+  "settings": {
+    "intelligence": {
+      "selectProvider": "选择默认模型",
+      "selectProviderPlaceholder": "选择提供商",
+      "selectProviderHint": "选择提供商以查看可用模型",
+      "testCapability": "测试能力",
+      "testing": "测试中...",
+      "testSuccess": "测试成功",
+      "testFailed": "测试失败",
+      "selectModel": "选择模型",
+      "defaultModel": "默认模型",
+      "latency": "延迟",
+      "capabilitySearchPlaceholder": "搜索能力...",
+      "capabilityListEmpty": "未找到能力",
+      "capabilitySummary": "{count} 个可用能力",
+      "providers": "提供商",
+      "addChannel": "添加通道",
+      "emptyProviders": "未配置提供商。点击添加通道开始。",
+      "promptFilterAll": "所有提示词",
+      "builtin": "内置",
+      "custom": "自定义",
+      "promptMetaDescription": "暂无描述",
+      "promptNewDefaultName": "新提示词 {index}",
+      "promptDescriptionPlaceholder": "输入提示词描述...",
+      "promptCreateSuccess": "提示词创建成功",
+      "promptDuplicateSuffix": "（副本）",
+      "promptDuplicateSuccess": "提示词复制成功",
+      "promptSaveSuccess": "提示词保存成功",
+      "promptSaveFailed": "提示词保存失败",
+      "promptDeleteConfirm": "确定要删除此提示词吗？",
+      "promptDeleteSuccess": "提示词删除成功",
+      "promptDeleteFailed": "提示词删除失败",
+      "promptCopySuccess": "提示词已复制到剪贴板",
+      "promptImportSuccess": "成功导入 {count} 个提示词",
+      "promptImportFailed": "提示词导入失败",
+      "promptExportEmpty": "没有可导出的自定义提示词",
+      "promptExportSuccess": "成功导出 {count} 个提示词",
+      "promptTimestampUnknown": "未知",
+      "promptSearchPlaceholder": "搜索提示词...",
+      "promptListEmpty": "未找到提示词",
+      "promptStatsLabel": "{builtin} 个内置，{custom} 个自定义",
+      "promptPageTitle": "提示词管理",
+      "promptPageDesc": "创建和管理各种任务的 AI 提示词",
+      "landing": {
+        "prompts": {
+          "folderOpenSuccess": "提示词文件夹已打开",
+          "folderOpenFailed": "打开提示词文件夹失败",
+          "statsDesc": "约 {words} 字",
+          "newPromptButton": "新建提示词"
+        }
+      }
+    }
+  }
+}

package/i18n/message-keys.ts

@@ -0,0 +1,236 @@
+/**
+ * I18n Message Keys
+ *
+ * Centralized message keys for backend-to-frontend communication.
+ * Backend sends `$i18n:key` format, frontend resolves to localized string.
+ *
+ * @example
+ * Backend: { message: '$i18n:devServer.disconnected' }
+ * Frontend: resolveI18nMessage(message) => '开发服务器连接已断开'
+ */
+
+/**
+ * I18n message key prefix
+ */
+export const I18N_PREFIX = '$i18n:'
+
+/**
+ * Dev Server related message keys
+ */
+export const DevServerKeys = {
+  DISCONNECTED: 'devServer.disconnected',
+  DISCONNECTED_DESC: 'devServer.disconnectedDesc',
+  RECONNECTED: 'devServer.reconnected',
+  RECONNECTING: 'devServer.reconnecting',
+  CHECK_SERVER: 'devServer.checkServer',
+  CONNECTION_LOST: 'devServer.connectionLost',
+  CONNECTION_RESTORED: 'devServer.connectionRestored',
+} as const
+
+/**
+ * Flow Transfer related message keys
+ */
+export const FlowTransferKeys = {
+  SHARE_COMPLETE: 'flowTransfer.shareComplete',
+  SHARE_FAILED: 'flowTransfer.shareFailed',
+  COPIED_TO_CLIPBOARD: 'flowTransfer.copiedToClipboard',
+  FILE_REVEALED: 'flowTransfer.fileRevealed',
+  AIRDROP_READY: 'flowTransfer.airdropReady',
+  MAIL_READY: 'flowTransfer.mailReady',
+  MESSAGES_READY: 'flowTransfer.messagesReady',
+} as const
+
+/**
+ * Plugin related message keys
+ */
+export const PluginKeys = {
+  LOAD_FAILED: 'plugin.loadFailed',
+  MANIFEST_INVALID: 'plugin.manifestInvalid',
+  DEPENDENCY_MISSING: 'plugin.dependencyMissing',
+  VERSION_MISMATCH: 'plugin.versionMismatch',
+  PERMISSION_DENIED: 'plugin.permissionDenied',
+  SDK_VERSION_MISSING: 'plugin.sdkVersionMissing',
+  SDK_VERSION_OUTDATED: 'plugin.sdkVersionOutdated',
+  PERMISSION_MISSING: 'plugin.permissionMissing',
+} as const
+
+/**
+ * Permission related message keys
+ */
+export const PermissionKeys = {
+  // Categories
+  CATEGORY_FS: 'permission.category.fs',
+  CATEGORY_CLIPBOARD: 'permission.category.clipboard',
+  CATEGORY_NETWORK: 'permission.category.network',
+  CATEGORY_SYSTEM: 'permission.category.system',
+  CATEGORY_INTELLIGENCE: 'permission.category.intelligence',
+  CATEGORY_STORAGE: 'permission.category.storage',
+  CATEGORY_WINDOW: 'permission.category.window',
+
+  // Risk levels
+  RISK_LOW: 'permission.risk.low',
+  RISK_MEDIUM: 'permission.risk.medium',
+  RISK_HIGH: 'permission.risk.high',
+
+  // Filesystem permissions
+  FS_READ_NAME: 'permission.fs.read.name',
+  FS_READ_DESC: 'permission.fs.read.desc',
+  FS_WRITE_NAME: 'permission.fs.write.name',
+  FS_WRITE_DESC: 'permission.fs.write.desc',
+  FS_EXECUTE_NAME: 'permission.fs.execute.name',
+  FS_EXECUTE_DESC: 'permission.fs.execute.desc',
+  FS_TFILE_NAME: 'permission.fs.tfile.name',
+  FS_TFILE_DESC: 'permission.fs.tfile.desc',
+
+  // Clipboard permissions
+  CLIPBOARD_READ_NAME: 'permission.clipboard.read.name',
+  CLIPBOARD_READ_DESC: 'permission.clipboard.read.desc',
+  CLIPBOARD_WRITE_NAME: 'permission.clipboard.write.name',
+  CLIPBOARD_WRITE_DESC: 'permission.clipboard.write.desc',
+
+  // Network permissions
+  NETWORK_LOCAL_NAME: 'permission.network.local.name',
+  NETWORK_LOCAL_DESC: 'permission.network.local.desc',
+  NETWORK_INTERNET_NAME: 'permission.network.internet.name',
+  NETWORK_INTERNET_DESC: 'permission.network.internet.desc',
+  NETWORK_DOWNLOAD_NAME: 'permission.network.download.name',
+  NETWORK_DOWNLOAD_DESC: 'permission.network.download.desc',
+
+  // System permissions
+  SYSTEM_SHELL_NAME: 'permission.system.shell.name',
+  SYSTEM_SHELL_DESC: 'permission.system.shell.desc',
+  SYSTEM_NOTIFICATION_NAME: 'permission.system.notification.name',
+  SYSTEM_NOTIFICATION_DESC: 'permission.system.notification.desc',
+  SYSTEM_TRAY_NAME: 'permission.system.tray.name',
+  SYSTEM_TRAY_DESC: 'permission.system.tray.desc',
+
+  // Intelligence permissions
+  INTELLIGENCE_BASIC_NAME: 'permission.intelligence.basic.name',
+  INTELLIGENCE_BASIC_DESC: 'permission.intelligence.basic.desc',
+  INTELLIGENCE_ADMIN_NAME: 'permission.intelligence.admin.name',
+  INTELLIGENCE_ADMIN_DESC: 'permission.intelligence.admin.desc',
+  INTELLIGENCE_AGENTS_NAME: 'permission.intelligence.agents.name',
+  INTELLIGENCE_AGENTS_DESC: 'permission.intelligence.agents.desc',
+
+  // Storage permissions
+  STORAGE_PLUGIN_NAME: 'permission.storage.plugin.name',
+  STORAGE_PLUGIN_DESC: 'permission.storage.plugin.desc',
+  STORAGE_SHARED_NAME: 'permission.storage.shared.name',
+  STORAGE_SHARED_DESC: 'permission.storage.shared.desc',
+  STORAGE_SQLITE_NAME: 'permission.storage.sqlite.name',
+  STORAGE_SQLITE_DESC: 'permission.storage.sqlite.desc',
+
+  // Window permissions
+  WINDOW_CREATE_NAME: 'permission.window.create.name',
+  WINDOW_CREATE_DESC: 'permission.window.create.desc',
+  WINDOW_CAPTURE_NAME: 'permission.window.capture.name',
+  WINDOW_CAPTURE_DESC: 'permission.window.capture.desc',
+
+  // UI messages
+  GRANT: 'permission.grant',
+  REVOKE: 'permission.revoke',
+  GRANTED: 'permission.granted',
+  DENIED: 'permission.denied',
+  REQUIRED: 'permission.required',
+  OPTIONAL: 'permission.optional',
+  ALLOW_ONCE: 'permission.allowOnce',
+  ALLOW_ALWAYS: 'permission.allowAlways',
+  REQUEST_TITLE: 'permission.requestTitle',
+  REQUEST_DESC: 'permission.requestDesc',
+  ENFORCEMENT_DISABLED: 'permission.enforcementDisabled',
+  LEGACY_PLUGIN_WARNING: 'permission.legacyPluginWarning',
+} as const
+
+/**
+ * Widget related message keys
+ */
+export const WidgetKeys = {
+  COMPILE_FAILED: 'widget.compileFailed',
+  UNSUPPORTED_TYPE: 'widget.unsupportedType',
+  INVALID_DEPENDENCY: 'widget.invalidDependency',
+  LOAD_FAILED: 'widget.loadFailed',
+} as const
+
+/**
+ * System related message keys
+ */
+export const SystemKeys = {
+  NETWORK_ERROR: 'system.networkError',
+  TIMEOUT: 'system.timeout',
+  UNKNOWN_ERROR: 'system.unknownError',
+  OPERATION_CANCELLED: 'system.operationCancelled',
+} as const
+
+/**
+ * All message keys
+ */
+export const MessageKeys = {
+  devServer: DevServerKeys,
+  flowTransfer: FlowTransferKeys,
+  plugin: PluginKeys,
+  permission: PermissionKeys,
+  widget: WidgetKeys,
+  system: SystemKeys,
+} as const
+
+/**
+ * Create i18n message string
+ * @param key Message key (e.g., 'devServer.disconnected')
+ * @returns Formatted i18n message (e.g., '$i18n:devServer.disconnected')
+ */
+export function i18nMsg(key: string): string {
+  return `${I18N_PREFIX}${key}`
+}
+
+/**
+ * Create i18n message with parameters
+ * @param key Message key
+ * @param params Parameters to pass to the message
+ * @returns Formatted i18n message with params
+ *
+ * @example
+ * i18nMsgWithParams('plugin.loadFailed', { name: 'my-plugin' })
+ * // => '$i18n:plugin.loadFailed|{"name":"my-plugin"}'
+ */
+export function i18nMsgWithParams(key: string, params: Record<string, unknown>): string {
+  return `${I18N_PREFIX}${key}|${JSON.stringify(params)}`
+}
+
+/**
+ * Check if a string is an i18n message
+ */
+export function isI18nMessage(str: string): boolean {
+  return str.startsWith(I18N_PREFIX)
+}
+
+/**
+ * Parse i18n message to extract key and params
+ */
+export function parseI18nMessage(str: string): { key: string, params?: Record<string, unknown> } | null {
+  if (!isI18nMessage(str)) {
+    return null
+  }
+
+  const content = str.slice(I18N_PREFIX.length)
+  const pipeIndex = content.indexOf('|')
+
+  if (pipeIndex === -1) {
+    return { key: content }
+  }
+
+  const key = content.slice(0, pipeIndex)
+  try {
+    const params = JSON.parse(content.slice(pipeIndex + 1))
+    return { key, params }
+  }
+  catch {
+    return { key }
+  }
+}
+
+export type DevServerKey = typeof DevServerKeys[keyof typeof DevServerKeys]
+export type FlowTransferKey = typeof FlowTransferKeys[keyof typeof FlowTransferKeys]
+export type PluginKey = typeof PluginKeys[keyof typeof PluginKeys]
+export type PermissionKey = typeof PermissionKeys[keyof typeof PermissionKeys]
+export type WidgetKey = typeof WidgetKeys[keyof typeof WidgetKeys]
+export type SystemKey = typeof SystemKeys[keyof typeof SystemKeys]

package/i18n/resolver.ts

@@ -0,0 +1,181 @@
+/**
+ * I18n Message Resolver
+ *
+ * Frontend utility to resolve $i18n:key messages to localized strings.
+ * Works with both Vue i18n and standalone usage.
+ */
+
+import enMessages from './locales/en.json'
+import zhMessages from './locales/zh.json'
+import { I18N_PREFIX, isI18nMessage, parseI18nMessage } from './message-keys'
+
+type MessageLocale = 'en' | 'zh'
+type Messages = typeof enMessages
+
+const locales: Record<MessageLocale, Messages> = {
+  en: enMessages,
+  zh: zhMessages,
+}
+
+/**
+ * Get nested value from object by dot-separated path
+ */
+function getNestedValue(obj: Record<string, unknown>, path: string): string | undefined {
+  const keys = path.split('.')
+  let current: unknown = obj
+
+  for (const key of keys) {
+    if (current === null || current === undefined || typeof current !== 'object') {
+      return undefined
+    }
+    current = (current as Record<string, unknown>)[key]
+  }
+
+  return typeof current === 'string' ? current : undefined
+}
+
+/**
+ * Interpolate parameters into message
+ * @param message Message with placeholders like {name}
+ * @param params Parameters to interpolate
+ */
+function interpolate(message: string, params?: Record<string, unknown>): string {
+  if (!params)
+    return message
+
+  return message.replace(/\{(\w+)\}/g, (_, key) => {
+    return params[key] !== undefined ? String(params[key]) : `{${key}}`
+  })
+}
+
+/**
+ * I18n Message Resolver
+ *
+ * Resolves $i18n:key format messages to localized strings.
+ */
+export class I18nResolver {
+  private locale: MessageLocale = 'en'
+  private customMessages: Partial<Record<MessageLocale, Record<string, unknown>>> = {}
+
+  /**
+   * Set current locale
+   */
+  setLocale(locale: MessageLocale): void {
+    this.locale = locale
+  }
+
+  /**
+   * Get current locale
+   */
+  getLocale(): MessageLocale {
+    return this.locale
+  }
+
+  /**
+   * Add custom messages for a locale
+   */
+  addMessages(locale: MessageLocale, messages: Record<string, unknown>): void {
+    this.customMessages[locale] = {
+      ...this.customMessages[locale],
+      ...messages,
+    }
+  }
+
+  /**
+   * Resolve a message string
+   *
+   * If the string starts with $i18n:, it will be resolved to a localized string.
+   * Otherwise, the original string is returned.
+   *
+   * @param str The message string to resolve
+   * @param fallbackLocale Fallback locale if message not found in current locale
+   */
+  resolve(str: string, fallbackLocale: MessageLocale = 'en'): string {
+    if (!isI18nMessage(str)) {
+      return str
+    }
+
+    const parsed = parseI18nMessage(str)
+    if (!parsed) {
+      return str
+    }
+
+    const { key, params } = parsed
+
+    // Try current locale
+    let message = this.getMessage(key, this.locale)
+
+    // Try fallback locale
+    if (!message && this.locale !== fallbackLocale) {
+      message = this.getMessage(key, fallbackLocale)
+    }
+
+    // Return key if no message found
+    if (!message) {
+      return key
+    }
+
+    return interpolate(message, params)
+  }
+
+  /**
+   * Get message from locale
+   */
+  private getMessage(key: string, locale: MessageLocale): string | undefined {
+    // Try custom messages first
+    const customMessage = getNestedValue(
+      this.customMessages[locale] as Record<string, unknown> || {},
+      key,
+    )
+    if (customMessage) {
+      return customMessage
+    }
+
+    // Try built-in messages
+    return getNestedValue(locales[locale] as unknown as Record<string, unknown>, key)
+  }
+}
+
+/**
+ * Singleton resolver instance
+ */
+export const i18nResolver = new I18nResolver()
+
+/**
+ * Resolve i18n message shorthand
+ *
+ * @example
+ * resolveI18nMessage('$i18n:devServer.disconnected') // => 'Dev Server Disconnected'
+ * resolveI18nMessage('Hello World') // => 'Hello World' (unchanged)
+ */
+export function resolveI18nMessage(str: string): string {
+  return i18nResolver.resolve(str)
+}
+
+/**
+ * Create i18n message for backend use
+ *
+ * @example
+ * createI18nMessage('devServer.disconnected') // => '$i18n:devServer.disconnected'
+ */
+export function createI18nMessage(key: string, params?: Record<string, unknown>): string {
+  if (params) {
+    return `${I18N_PREFIX}${key}|${JSON.stringify(params)}`
+  }
+  return `${I18N_PREFIX}${key}`
+}
+
+/**
+ * Vue composable for i18n message resolution
+ */
+export function useI18nResolver() {
+  return {
+    resolve: resolveI18nMessage,
+    setLocale: (locale: MessageLocale) => i18nResolver.setLocale(locale),
+    getLocale: () => i18nResolver.getLocale(),
+    addMessages: (locale: MessageLocale, messages: Record<string, unknown>) =>
+      i18nResolver.addMessages(locale, messages),
+  }
+}
+
+export type { MessageLocale, Messages }