@dlient/plugin-sdk 3.0.2 → 3.0.4

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../src/types.ts","../src/worker.ts"],"sourcesContent":["/**\n * 领域模型：PluginManifest / PluginPermission / PluginRuntime / PluginInstalled / PluginType。\n * manifest 对应插件 package.json 的 `dlient` 子对象。\n * 该文件是类型与工具函数的事实来源（自 core 迁入），core 反向引用本包。\n */\n\n/** 本地化文案：字符串（默认值）或多语言映射（键为 locale，如 'zh-CN'/'en-US'；'default' 键兜底） */\nexport type LocalizedText = string | Record<string, string>\n\nexport interface PluginManifest {\n  id: string                          // 插件唯一 ID\n  version: string                     // semver\n  /** 显示名：字符串或多语言映射（键为 locale，如 'zh-CN'/'en-US'；'default' 兜底） */\n  name: LocalizedText\n  /** 描述：字符串或多语言映射（同上） */\n  description?: LocalizedText\n  /** dist 目录相对插件根目录的路径（默认 'dist'；开发插件可为任意外部目录的构建输出） */\n  dist?: string\n  /**\n   * 插件类型：\n   *  - app：独立应用，可在基座中直接启动（启动后打开页面）；\n   *  - full / worker / ui：提供能力给其它插件调用的常规插件。\n   * 缺省 'ui'。\n   */\n  type?: PluginType\n  /** 是否为系统级插件（不可卸载；基座首次启动时从服务器下载并安装） */\n  system?: boolean\n  /** 来源：market=市场；local=本地；dev=开发中（缺省由加载上下文决定） */\n  source?: PluginSource\n  /** 图标：相对插件根目录的路径（如 \"icon.svg\" / \"assets/icon.svg\"） */\n  icon?: string\n  requires?: string[]                 // 依赖的插件 ID\n  platforms?: PluginPlatform[]        // 支持平台（缺省=全平台）\n  permissions?: PluginPermission[]    // 申请的宿主能力\n  /** 对外暴露给其它插件调用的方法（plugin.invoke 校验） */\n  expose?: Record<string, { description?: string }>\n  /** 声明要调用的其它插件方法（plugin.invoke 校验） */\n  dependencies?: Record<string, string[]>\n  engines?: {\n    dlient?: string\n    electron?: string\n  }\n  author?: string\n  homepage?: string\n  repository?: string\n}\n\nexport type PluginPlatform = 'darwin' | 'win32' | 'linux'\n\nexport type PluginPermission =\n  | 'webview.create'\n  | 'webview.navigate'\n  | 'fs.read'\n  | 'fs.write'\n  | 'fs.delete'\n  | 'os.openExternal'\n  | 'clipboard.read'\n  | 'clipboard.write'\n  | 'notifications'\n  | 'system.getIdleState'\n  // app.* 宿主能力\n  | 'app.data'               // 插件数据隔离存储（USER_DATA/plugin-data/<pluginId>/）\n  | 'app.setAutoLaunch'      // 开机自启动\n  | 'app.shortcut.register'  // 快捷键注册\n  | 'app.crypt'              // 每插件独立密钥加解密（主进程内部派生，插件间隔离）\n  | 'app.window'             // 窗口控制（无头模式自绘标题栏：关闭窗口等）\n  | 'plugins.dev'            // 开发插件管理（外部目录注册 / 移除 / 热重载）\n\nexport interface PluginRuntime {\n  id: string\n  version: string\n  status: 'stopped' | 'starting' | 'running' | 'error' | 'stopping'\n  generation: number\n  enabled: boolean\n  error?: string\n  startTime?: number\n}\n\nexport interface PluginInstalled {\n  id: string\n  version: string\n  installedAt: number\n  enabled: boolean\n  updateAvailable?: string\n}\n\nexport type PluginType = 'full' | 'worker' | 'ui' | 'app'\n\n/** 插件来源：market=市场安装；local=本地导入；dev=开发中 */\nexport type PluginSource = 'market' | 'local' | 'dev'\n\n/** 缺省推断：显式声明优先；未声明按 'ui'（无 worker 依赖，最安全） */\nexport function inferPluginType(manifest: PluginManifest): PluginType {\n  return manifest.type ?? 'ui'\n}\n\n/** 解析本地化文案：locale 无匹配时回退 'default' 键 → 字符串本身 → fallback */\nexport function localizeText(text: LocalizedText | undefined, locale: string, fallback = ''): string {\n  if (!text) return fallback\n  if (typeof text === 'string') return text\n  return text[locale] ?? text['default'] ?? fallback\n}\n","/**\n * createWorkerRpc - 插件 worker（utilityProcess）端辅助。\n * 双通道：\n *   - parentPort 主通道：init / rpc-call（主进程 invokePlugin 转发）/ host-api / 心跳 / port-setup\n *   - directPort 直连通道（MessageChannelMain）：渲染层 preload 直连\n *     request/listen → 执行 registerHandler/registerStreamHandler → 自动按 request_id 回传\n * 插件开发者不感知 port 与 request_id：handler(args, ctx) 即可。\n */\n\nimport type {\n  PluginMessage,\n  RpcResponseMessage,\n  HostApiCallMessage,\n  HostApiResponseMessage,\n  PushMessage,\n  DirectRequestMessage,\n  DirectListenMessage,\n  DirectPortMessage,\n} from './protocol'\n\n/** Electron utilityProcess 的 parentPort（Node 全局 Process 类型无此成员，此处扩展） */\ninterface UtilityParentPort {\n  postMessage(message: unknown, transfer?: unknown[]): void\n  on(event: 'message', listener: (message: unknown) => void): void\n}\n\ndeclare global {\n  namespace NodeJS {\n    interface Process {\n      parentPort?: UtilityParentPort\n    }\n  }\n}\n\ntype WorkerRpcHandler = (args: unknown[], ctx?: HandlerContext) => unknown | Promise<unknown>\n\n/** handler 执行上下文（directPort 直连调用时填充） */\nexport interface HandlerContext {\n  from_plugin_id: string\n  request_id: string\n  /** 请求携带的大块数据（transfer 零拷贝） */\n  data?: ArrayBuffer\n  /** 流式发射（仅 registerStreamHandler / listen 模式可用） */\n  emit?: (chunk?: unknown, opts?: { data?: ArrayBuffer }) => void\n  /** 取消信号（UI 发 cancel 时 abort） */\n  signal: AbortSignal\n}\n\nexport interface WorkerRpc {\n  registerHandler: (method: string, handler: WorkerRpcHandler) => void\n  /** 流式 handler：ctx.emit(chunk) 多次，return 后自动发 stream-done */\n  registerStreamHandler: (method: string, handler: WorkerRpcHandler) => void\n  /** 跨插件调用：经主进程 plugin.invoke（expose + dependencies 校验） */\n  callPlugin: (pluginId: string, method: string, args?: unknown[]) => Promise<unknown>\n  /** 宿主能力调用 */\n  callHostApi: (method: string, args?: unknown[]) => Promise<unknown>\n  /** 推送事件给绑定本插件的渲染层 view（经主进程转发） */\n  push: (event: string, data?: unknown) => void\n  getPluginId: () => string\n  getGeneration: () => number\n  log: (level: 'info' | 'warn' | 'error' | 'debug', message: string, data?: unknown) => void\n}\n\nexport function createWorkerRpc(pluginId: string, generation: number): WorkerRpc {\n  const handlers = new Map<string, WorkerRpcHandler>()\n  const streamHandlers = new Set<string>()\n  let messageId = 0\n  const pending = new Map<string, { resolve: (value: unknown) => void; reject: (err: Error) => void }>()\n  /** directPort（渲染层直连通道）；port-setup 消息时设置 */\n  let directPort: { postMessage: (msg: unknown, transfer?: unknown[]) => void; on: (event: string, cb: (...args: unknown[]) => void) => void; start?: () => void } | null = null\n  /** 在途流式/请求的 AbortController（cancel 时 abort） */\n  const inFlight = new Map<string, AbortController>()\n\n  const sendMessage = (msg: PluginMessage) => {\n    if (typeof process !== 'undefined' && process.parentPort) {\n      process.parentPort.postMessage(msg)\n    }\n  }\n\n  // ---- directPort 直连消息处理（渲染层 preload 发出）----\n\n  /**\n   * 注意：utilityProcess 下发的 directPort 是 Electron MessagePortMain，\n   * 其 postMessage 的 transfer 仅接受 MessagePortMain[]（不支持 ArrayBuffer），\n   * 且传 undefined 第二参也会抛 \"transferables must be an array of MessagePorts\"。\n   * 因此 data 字段一律随消息结构化克隆（深拷贝），不启用 transfer。\n   */\n  const sendDirect = (msg: DirectPortMessage) => {\n    if (!directPort) return\n    directPort.postMessage(msg)\n  }\n\n  const handleDirectMessage = (event: { data: DirectPortMessage }) => {\n    const msg = event.data\n    switch (msg.type) {\n      case 'request':\n        runDirectHandler(msg, false)\n        break\n      case 'listen':\n        runDirectHandler(msg, true)\n        break\n      case 'cancel':\n        inFlight.get(msg.request_id)?.abort()\n        inFlight.delete(msg.request_id)\n        break\n    }\n  }\n\n  /** 执行 directPort 请求并自动按 request_id 回传（并发：每条消息独立 Promise，不互相等待） */\n  function runDirectHandler(msg: DirectRequestMessage | DirectListenMessage, isStream: boolean): void {\n    const handler = handlers.get(msg.method)\n    if (!handler) {\n      sendDirect({ type: 'error', request_id: msg.request_id, error: `Method \"${msg.method}\" not found` })\n      return\n    }\n    const ac = new AbortController()\n    inFlight.set(msg.request_id, ac)\n\n    const emit = (chunk?: unknown, opts?: { data?: ArrayBuffer }) => {\n      sendDirect({ type: 'stream', request_id: msg.request_id, chunk, data: opts?.data })\n    }\n\n    const ctx: HandlerContext = {\n      from_plugin_id: msg.from_plugin_id,\n      request_id: msg.request_id,\n      data: msg.data,\n      signal: ac.signal,\n      emit: isStream ? emit : undefined,\n    }\n\n    Promise.resolve()\n      .then(() => handler(msg.args, ctx))\n      .then((result) => {\n        if (ac.signal.aborted) return\n        const data = (result as { data?: ArrayBuffer } | null | undefined)?.data\n        const value = data !== undefined ? (result as { result?: unknown }).result : result\n        sendDirect(\n          isStream\n            ? { type: 'stream-done', request_id: msg.request_id, result: value }\n            : { type: 'response', request_id: msg.request_id, result: value, data },\n        )\n      })\n      .catch((err) => {\n        if (ac.signal.aborted) return\n        sendDirect({ type: 'error', request_id: msg.request_id, error: err instanceof Error ? err.message : String(err) })\n      })\n      .finally(() => {\n        inFlight.delete(msg.request_id)\n      })\n  }\n\n  if (typeof process !== 'undefined' && process.parentPort) {\n    // 主进程最近一次有消息的时间（心跳 / rpc-call / host-api-response 等均代表主进程存活）\n    let lastSeenAt = Date.now()\n\n    process.parentPort.on('message', (event: unknown) => {\n      const e = event as { data: PluginMessage; ports?: unknown[] }\n      const msg = e.data\n      lastSeenAt = Date.now()\n      switch (msg.type) {\n        case 'init': {\n          sendMessage({ type: 'ready', pluginId, generation, capabilities: Array.from(handlers.keys()) })\n          break\n        }\n        case 'port-setup': {\n          // 主进程下发直连 port → 设置 directPort 监听 → 通知主进程（据此下发 port1 给渲染层）\n          const [port] = (e.ports ?? []) as Array<{\n            postMessage: (msg: unknown, transfer?: unknown[]) => void\n            on: (event: string, cb: (...args: unknown[]) => void) => void\n            start: () => void\n          }>\n          if (port) {\n            directPort = port\n            port.on('message', (payload: unknown) => handleDirectMessage(payload as { data: DirectPortMessage }))\n            if (typeof port.start === 'function') port.start()\n            sendMessage({ type: 'direct-port-ready', pluginId })\n          }\n          break\n        }\n        case 'rpc-call':\n          handleRpcCall(msg as never)\n          break\n        case 'host-api-response':\n          handleHostApiResponse(msg as HostApiResponseMessage)\n          break\n        case 'heartbeat':\n          // 主进程存活信号：仅刷新 lastSeenAt（已在开头统一处理）\n          break\n      }\n    })\n\n    // worker → 主进程心跳：每 10s 上报一次，主进程据此判定 worker 是否失联\n    setInterval(() => {\n      sendMessage({ type: 'heartbeat', pluginId, ts: Date.now() })\n    }, 10000)\n\n    // worker 侧失联 watchdog：主进程心跳每 10s 一条，超过 30s 未收到任何消息\n    setInterval(() => {\n      if (Date.now() - lastSeenAt > 30000) {\n        const error = new Error('Main process lost (no message for 30s)')\n        for (const { reject } of pending.values()) reject(error)\n        pending.clear()\n      }\n    }, 5000)\n  }\n\n  const handleRpcCall = (msg: { id: string; method: string; args: unknown[] }) => {\n    const handler = handlers.get(msg.method)\n    const response: RpcResponseMessage = { type: 'rpc-response', id: msg.id, pluginId }\n    if (!handler) {\n      response.error = `Method \"${msg.method}\" not found`\n    } else {\n      try {\n        const result = handler(msg.args)\n        if (result instanceof Promise) {\n          result.then(\n            (value) => { response.result = value; sendMessage(response) },\n            (err) => { response.error = err.message; sendMessage(response) },\n          )\n          return\n        }\n        response.result = result\n      } catch (err) {\n        response.error = err instanceof Error ? err.message : String(err)\n      }\n    }\n    sendMessage(response)\n  }\n\n  const handleHostApiResponse = (msg: HostApiResponseMessage) => {\n    const pendingItem = pending.get(msg.id)\n    if (pendingItem) {\n      pending.delete(msg.id)\n      if (msg.error) {\n        pendingItem.reject(new Error(msg.error))\n      } else {\n        pendingItem.resolve(msg.result)\n      }\n    }\n  }\n\n  return {\n    getPluginId: () => pluginId,\n    getGeneration: () => generation,\n\n    registerHandler: (method: string, handler: WorkerRpcHandler) => {\n      handlers.set(method, handler)\n      streamHandlers.delete(method)\n    },\n\n    registerStreamHandler: (method: string, handler: WorkerRpcHandler) => {\n      handlers.set(method, handler)\n      streamHandlers.add(method)\n    },\n\n    callHostApi: (method: string, args: unknown[] = []) => callHostApiImpl(method, args),\n\n    callPlugin: (targetPluginId: string, method: string, args: unknown[] = []) =>\n      callHostApiImpl('plugin.invoke', [targetPluginId, method, args]),\n\n    push: (event: string, data?: unknown) => {\n      const msg: PushMessage = { type: 'push', pluginId, event, data }\n      sendMessage(msg)\n    },\n\n    log: (level: 'info' | 'warn' | 'error' | 'debug', message: string, data?: unknown) => {\n      sendMessage({ type: 'log', pluginId, level, message, data })\n    },\n  }\n\n  function callHostApiImpl(method: string, args: unknown[]): Promise<unknown> {\n    const id = `host-api-${pluginId}-${generation}-${++messageId}`\n    const msg: HostApiCallMessage = { type: 'host-api-call', id, method, args, pluginId }\n    return new Promise<unknown>((resolve, reject) => {\n      pending.set(id, { resolve, reject })\n      sendMessage(msg)\n    })\n  }\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.mjs","sources":["../src/types.ts","../src/worker.ts"],"sourcesContent":["/**\n * 领域模型：PluginManifest / PluginPermission / PluginRuntime / PluginInstalled / PluginType。\n * manifest 对应插件 package.json 的 `dlient` 子对象。\n * 该文件是类型与工具函数的事实来源（自 core 迁入），core 反向引用本包。\n */\n\n/** 本地化文案：字符串（默认值）或多语言映射（键为 locale，如 'zh-CN'/'en-US'；'default' 键兜底） */\nexport type LocalizedText = string | Record<string, string>\n\n/**\n * expose 方法调用权限（docs/v3/plugin-view.md §2.2）：\n *  - private           仅本插件自己；\n *  - default（缺省）   宿主（主进程侧）+ 本插件自己；\n *  - system            system 插件可默认调用，非 system 插件不可调；\n *  - public            所有插件，无需 dependencies 声明；\n *  - install-confirm   安装时用户确认（永久有效），须在 dependencies 中声明；\n *  - runtime-confirm   使用时用户确认（1 天内有效），须在 dependencies 中声明。\n * 支持组合表达式：'|' = 或（满足任一），'&' = 且（需全部满足）。\n * 例：`runtime-confirm | system` = system 直接调用，其它插件需运行时确认。\n */\nexport type ExposeAccess =\n  | 'private'\n  | 'default'\n  | 'system'\n  | 'public'\n  | 'install-confirm'\n  | 'runtime-confirm'\n\n/** expose 方法条目 */\nexport interface PluginExposeMethod {\n  /** 方法说明（确认框 / 上传校验文案用） */\n  description?: string\n  /** 调用权限表达式（缺省 'default'） */\n  access?: string\n}\n\nexport interface PluginManifest {\n  id: string                          // 插件唯一 ID\n  version: string                     // semver\n  /** 显示名：字符串或多语言映射（键为 locale，如 'zh-CN'/'en-US'；'default' 兜底） */\n  name: LocalizedText\n  /** 描述：字符串或多语言映射（同上） */\n  description?: LocalizedText\n  /** dist 目录相对插件根目录的路径（默认 'dist'；开发插件可为任意外部目录的构建输出） */\n  dist?: string\n  /**\n   * 产物打包方式（方案 build.md 2.3）：\n   *  - 'plain'（缺省）：多文件 dist 目录，dlientV3:// 协议直接读磁盘文件；\n   *  - 'asar'：发布时 dist 打成 <pluginDir>/plugin.asar，协议与 worker fork 从 asar 内读取。\n   */\n  packaging?: 'plain' | 'asar'\n  /**\n   * 插件类型：\n   *  - app：独立应用，可在基座中直接启动（启动后打开页面）；\n   *  - full / worker / ui：提供能力给其它插件调用的常规插件。\n   * 缺省 'ui'。\n   */\n  type?: PluginType\n  /** 是否为系统级插件（不可卸载；基座首次启动时从服务器下载并安装） */\n  system?: boolean\n  /** 来源：market=市场；local=本地；dev=开发中（缺省由加载上下文决定） */\n  source?: PluginSource\n  /** 图标：相对插件根目录的路径（如 \"icon.svg\" / \"assets/icon.svg\"） */\n  icon?: string\n  /** 插件标签（市场展示 / 检索；如 [\"ai\", \"chat\"]） */\n  tags?: string[]\n  /** 所属组织（组织标识，形如 \"@xxx\"） */\n  organization?: string\n  requires?: string[]                 // 依赖的插件 ID\n  platforms?: PluginPlatform[]        // 支持平台（缺省=全平台）\n  permissions?: PluginPermission[]    // 申请的宿主能力\n  /** 对外暴露给其它插件调用的方法（plugin.invoke 校验；access 见 ExposeAccess） */\n  expose?: Record<string, PluginExposeMethod>\n  /** 声明要调用的其它插件方法（plugin.invoke 校验） */\n  dependencies?: Record<string, string[]>\n  engines?: {\n    dlient?: string\n    electron?: string\n  }\n  author?: string\n  homepage?: string\n  repository?: string\n}\n\nexport type PluginPlatform = 'darwin' | 'win32' | 'linux'\n\nexport type PluginPermission =\n  | 'webview.create'\n  | 'webview.navigate'\n  | 'fs.read'\n  | 'fs.write'\n  | 'fs.delete'\n  | 'os.openExternal'\n  | 'clipboard.read'\n  | 'clipboard.write'\n  | 'notifications'\n  | 'system.getIdleState'\n  // app.* 宿主能力\n  | 'app.data'               // 插件数据隔离存储（USER_DATA/plugin-data/<pluginId>/）\n  | 'app.setAutoLaunch'      // 开机自启动\n  | 'app.shortcut.register'  // 快捷键注册\n  | 'app.crypt'              // 每插件独立密钥加解密（主进程内部派生，插件间隔离）\n  | 'app.window'             // 窗口控制（无头模式自绘标题栏：关闭窗口等）\n  | 'plugins.dev'            // 开发插件管理（外部目录注册 / 移除 / 热重载）\n\nexport interface PluginRuntime {\n  id: string\n  version: string\n  status: 'stopped' | 'starting' | 'running' | 'error' | 'stopping'\n  generation: number\n  enabled: boolean\n  error?: string\n  startTime?: number\n}\n\nexport interface PluginInstalled {\n  id: string\n  version: string\n  installedAt: number\n  enabled: boolean\n  updateAvailable?: string\n}\n\nexport type PluginType = 'full' | 'worker' | 'ui' | 'app'\n\n/** 插件来源：market=市场安装；local=本地导入；dev=开发中 */\nexport type PluginSource = 'market' | 'local' | 'dev'\n\n/** 缺省推断：显式声明优先；未声明按 'ui'（无 worker 依赖，最安全） */\nexport function inferPluginType(manifest: PluginManifest): PluginType {\n  return manifest.type ?? 'ui'\n}\n\n/** 解析本地化文案：locale 无匹配时回退 'default' 键 → 字符串本身 → fallback */\nexport function localizeText(text: LocalizedText | undefined, locale: string, fallback = ''): string {\n  if (!text) return fallback\n  if (typeof text === 'string') return text\n  return text[locale] ?? text['default'] ?? fallback\n}\n","/**\n * createWorkerRpc - 插件 worker（utilityProcess）端辅助。\n * 双通道：\n *   - parentPort 主通道：init / rpc-call（主进程 invokePlugin 转发）/ host-api / 心跳 / port-setup\n *   - directPort 直连通道（MessageChannelMain）：渲染层 preload 直连\n *     request/listen → 执行 registerHandler/registerStreamHandler → 自动按 request_id 回传\n * 插件开发者不感知 port 与 request_id：handler(args, ctx) 即可。\n */\n\nimport type {\n  PluginMessage,\n  RpcResponseMessage,\n  HostApiCallMessage,\n  HostApiResponseMessage,\n  PushMessage,\n  DirectRequestMessage,\n  DirectListenMessage,\n  DirectPortMessage,\n} from './protocol'\n\n/** Electron utilityProcess 的 parentPort（Node 全局 Process 类型无此成员，此处扩展） */\ninterface UtilityParentPort {\n  postMessage(message: unknown, transfer?: unknown[]): void\n  on(event: 'message', listener: (message: unknown) => void): void\n}\n\ndeclare global {\n  namespace NodeJS {\n    interface Process {\n      parentPort?: UtilityParentPort\n    }\n  }\n}\n\ntype WorkerRpcHandler = (args: unknown[], ctx?: HandlerContext) => unknown | Promise<unknown>\n\n/** handler 执行上下文（directPort 直连调用时填充） */\nexport interface HandlerContext {\n  from_plugin_id: string\n  request_id: string\n  /** 请求携带的大块数据（transfer 零拷贝） */\n  data?: ArrayBuffer\n  /** 流式发射（仅 registerStreamHandler / listen 模式可用） */\n  emit?: (chunk?: unknown, opts?: { data?: ArrayBuffer }) => void\n  /** 取消信号（UI 发 cancel 时 abort） */\n  signal: AbortSignal\n}\n\nexport interface WorkerRpc {\n  registerHandler: (method: string, handler: WorkerRpcHandler) => void\n  /** 流式 handler：ctx.emit(chunk) 多次，return 后自动发 stream-done */\n  registerStreamHandler: (method: string, handler: WorkerRpcHandler) => void\n  /** 跨插件调用：经主进程 plugin.invoke（expose + dependencies 校验） */\n  callPlugin: (pluginId: string, method: string, args?: unknown[]) => Promise<unknown>\n  /** 宿主能力调用 */\n  callHostApi: (method: string, args?: unknown[]) => Promise<unknown>\n  /** 推送事件给绑定本插件的渲染层 view（经主进程转发） */\n  push: (event: string, data?: unknown) => void\n  getPluginId: () => string\n  getGeneration: () => number\n  log: (level: 'info' | 'warn' | 'error' | 'debug', message: string, data?: unknown) => void\n}\n\nexport function createWorkerRpc(pluginId: string, generation: number): WorkerRpc {\n  const handlers = new Map<string, WorkerRpcHandler>()\n  const streamHandlers = new Set<string>()\n  let messageId = 0\n  const pending = new Map<string, { resolve: (value: unknown) => void; reject: (err: Error) => void }>()\n  /** directPort（渲染层直连通道）；port-setup 消息时设置 */\n  let directPort: { postMessage: (msg: unknown, transfer?: unknown[]) => void; on: (event: string, cb: (...args: unknown[]) => void) => void; start?: () => void } | null = null\n  /** 在途流式/请求的 AbortController（cancel 时 abort） */\n  const inFlight = new Map<string, AbortController>()\n\n  const sendMessage = (msg: PluginMessage) => {\n    if (typeof process !== 'undefined' && process.parentPort) {\n      process.parentPort.postMessage(msg)\n    }\n  }\n\n  // ---- directPort 直连消息处理（渲染层 preload 发出）----\n\n  /**\n   * 注意：utilityProcess 下发的 directPort 是 Electron MessagePortMain，\n   * 其 postMessage 的 transfer 仅接受 MessagePortMain[]（不支持 ArrayBuffer），\n   * 且传 undefined 第二参也会抛 \"transferables must be an array of MessagePorts\"。\n   * 因此 data 字段一律随消息结构化克隆（深拷贝），不启用 transfer。\n   */\n  const sendDirect = (msg: DirectPortMessage) => {\n    if (!directPort) return\n    directPort.postMessage(msg)\n  }\n\n  const handleDirectMessage = (event: { data: DirectPortMessage }) => {\n    const msg = event.data\n    switch (msg.type) {\n      case 'request':\n        runDirectHandler(msg, false)\n        break\n      case 'listen':\n        runDirectHandler(msg, true)\n        break\n      case 'cancel':\n        inFlight.get(msg.request_id)?.abort()\n        inFlight.delete(msg.request_id)\n        break\n    }\n  }\n\n  /** 执行 directPort 请求并自动按 request_id 回传（并发：每条消息独立 Promise，不互相等待） */\n  function runDirectHandler(msg: DirectRequestMessage | DirectListenMessage, isStream: boolean): void {\n    const handler = handlers.get(msg.method)\n    if (!handler) {\n      sendDirect({ type: 'error', request_id: msg.request_id, error: `Method \"${msg.method}\" not found` })\n      return\n    }\n    const ac = new AbortController()\n    inFlight.set(msg.request_id, ac)\n\n    const emit = (chunk?: unknown, opts?: { data?: ArrayBuffer }) => {\n      sendDirect({ type: 'stream', request_id: msg.request_id, chunk, data: opts?.data })\n    }\n\n    const ctx: HandlerContext = {\n      from_plugin_id: msg.from_plugin_id,\n      request_id: msg.request_id,\n      data: msg.data,\n      signal: ac.signal,\n      emit: isStream ? emit : undefined,\n    }\n\n    Promise.resolve()\n      .then(() => handler(msg.args, ctx))\n      .then((result) => {\n        if (ac.signal.aborted) return\n        const data = (result as { data?: ArrayBuffer } | null | undefined)?.data\n        const value = data !== undefined ? (result as { result?: unknown }).result : result\n        sendDirect(\n          isStream\n            ? { type: 'stream-done', request_id: msg.request_id, result: value }\n            : { type: 'response', request_id: msg.request_id, result: value, data },\n        )\n      })\n      .catch((err) => {\n        if (ac.signal.aborted) return\n        sendDirect({ type: 'error', request_id: msg.request_id, error: err instanceof Error ? err.message : String(err) })\n      })\n      .finally(() => {\n        inFlight.delete(msg.request_id)\n      })\n  }\n\n  if (typeof process !== 'undefined' && process.parentPort) {\n    // 主进程最近一次有消息的时间（心跳 / rpc-call / host-api-response 等均代表主进程存活）\n    let lastSeenAt = Date.now()\n\n    process.parentPort.on('message', (event: unknown) => {\n      const e = event as { data: PluginMessage; ports?: unknown[] }\n      const msg = e.data\n      lastSeenAt = Date.now()\n      switch (msg.type) {\n        case 'init': {\n          sendMessage({ type: 'ready', pluginId, generation, capabilities: Array.from(handlers.keys()) })\n          break\n        }\n        case 'port-setup': {\n          // 主进程下发直连 port → 设置 directPort 监听 → 通知主进程（据此下发 port1 给渲染层）\n          const [port] = (e.ports ?? []) as Array<{\n            postMessage: (msg: unknown, transfer?: unknown[]) => void\n            on: (event: string, cb: (...args: unknown[]) => void) => void\n            start: () => void\n          }>\n          if (port) {\n            directPort = port\n            port.on('message', (payload: unknown) => handleDirectMessage(payload as { data: DirectPortMessage }))\n            if (typeof port.start === 'function') port.start()\n            sendMessage({ type: 'direct-port-ready', pluginId })\n          }\n          break\n        }\n        case 'rpc-call':\n          handleRpcCall(msg as never)\n          break\n        case 'host-api-response':\n          handleHostApiResponse(msg as HostApiResponseMessage)\n          break\n        case 'heartbeat':\n          // 主进程存活信号：仅刷新 lastSeenAt（已在开头统一处理）\n          break\n      }\n    })\n\n    // worker → 主进程心跳：每 10s 上报一次，主进程据此判定 worker 是否失联\n    setInterval(() => {\n      sendMessage({ type: 'heartbeat', pluginId, ts: Date.now() })\n    }, 10000)\n\n    // worker 侧失联 watchdog：主进程心跳每 10s 一条，超过 30s 未收到任何消息\n    setInterval(() => {\n      if (Date.now() - lastSeenAt > 30000) {\n        const error = new Error('Main process lost (no message for 30s)')\n        for (const { reject } of pending.values()) reject(error)\n        pending.clear()\n      }\n    }, 5000)\n  }\n\n  const handleRpcCall = (msg: { id: string; method: string; args: unknown[] }) => {\n    const handler = handlers.get(msg.method)\n    const response: RpcResponseMessage = { type: 'rpc-response', id: msg.id, pluginId }\n    if (!handler) {\n      response.error = `Method \"${msg.method}\" not found`\n    } else {\n      try {\n        const result = handler(msg.args)\n        if (result instanceof Promise) {\n          result.then(\n            (value) => { response.result = value; sendMessage(response) },\n            (err) => { response.error = err.message; sendMessage(response) },\n          )\n          return\n        }\n        response.result = result\n      } catch (err) {\n        response.error = err instanceof Error ? err.message : String(err)\n      }\n    }\n    sendMessage(response)\n  }\n\n  const handleHostApiResponse = (msg: HostApiResponseMessage) => {\n    const pendingItem = pending.get(msg.id)\n    if (pendingItem) {\n      pending.delete(msg.id)\n      if (msg.error) {\n        pendingItem.reject(new Error(msg.error))\n      } else {\n        pendingItem.resolve(msg.result)\n      }\n    }\n  }\n\n  return {\n    getPluginId: () => pluginId,\n    getGeneration: () => generation,\n\n    registerHandler: (method: string, handler: WorkerRpcHandler) => {\n      handlers.set(method, handler)\n      streamHandlers.delete(method)\n    },\n\n    registerStreamHandler: (method: string, handler: WorkerRpcHandler) => {\n      handlers.set(method, handler)\n      streamHandlers.add(method)\n    },\n\n    callHostApi: (method: string, args: unknown[] = []) => callHostApiImpl(method, args),\n\n    callPlugin: (targetPluginId: string, method: string, args: unknown[] = []) =>\n      callHostApiImpl('plugin.invoke', [targetPluginId, method, args]),\n\n    push: (event: string, data?: unknown) => {\n      const msg: PushMessage = { type: 'push', pluginId, event, data }\n      sendMessage(msg)\n    },\n\n    log: (level: 'info' | 'warn' | 'error' | 'debug', message: string, data?: unknown) => {\n      sendMessage({ type: 'log', pluginId, level, message, data })\n    },\n  }\n\n  function callHostApiImpl(method: string, args: unknown[]): Promise<unknown> {\n    const id = `host-api-${pluginId}-${generation}-${++messageId}`\n    const msg: HostApiCallMessage = { type: 'host-api-call', id, method, args, pluginId }\n    return new Promise<unknown>((resolve, reject) => {\n      pending.set(id, { resolve, reject })\n      sendMessage(msg)\n    })\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -5,6 +5,25 @@
  */
 /** 本地化文案：字符串（默认值）或多语言映射（键为 locale，如 'zh-CN'/'en-US'；'default' 键兜底） */
 export type LocalizedText = string | Record<string, string>;
+/**
+ * expose 方法调用权限（docs/v3/plugin-view.md §2.2）：
+ *  - private           仅本插件自己；
+ *  - default（缺省）   宿主（主进程侧）+ 本插件自己；
+ *  - system            system 插件可默认调用，非 system 插件不可调；
+ *  - public            所有插件，无需 dependencies 声明；
+ *  - install-confirm   安装时用户确认（永久有效），须在 dependencies 中声明；
+ *  - runtime-confirm   使用时用户确认（1 天内有效），须在 dependencies 中声明。
+ * 支持组合表达式：'|' = 或（满足任一），'&' = 且（需全部满足）。
+ * 例：`runtime-confirm | system` = system 直接调用，其它插件需运行时确认。
+ */
+export type ExposeAccess = 'private' | 'default' | 'system' | 'public' | 'install-confirm' | 'runtime-confirm';
+/** expose 方法条目 */
+export interface PluginExposeMethod {
+    /** 方法说明（确认框 / 上传校验文案用） */
+    description?: string;
+    /** 调用权限表达式（缺省 'default'） */
+    access?: string;
+}
 export interface PluginManifest {
     id: string;
     version: string;
@@ -14,6 +33,12 @@ export interface PluginManifest {
     description?: LocalizedText;
     /** dist 目录相对插件根目录的路径（默认 'dist'；开发插件可为任意外部目录的构建输出） */
     dist?: string;
+    /**
+     * 产物打包方式（方案 build.md 2.3）：
+     *  - 'plain'（缺省）：多文件 dist 目录，dlientV3:// 协议直接读磁盘文件；
+     *  - 'asar'：发布时 dist 打成 <pluginDir>/plugin.asar，协议与 worker fork 从 asar 内读取。
+     */
+    packaging?: 'plain' | 'asar';
     /**
      * 插件类型：
      *  - app：独立应用，可在基座中直接启动（启动后打开页面）；
@@ -27,13 +52,15 @@ export interface PluginManifest {
     source?: PluginSource;
     /** 图标：相对插件根目录的路径（如 "icon.svg" / "assets/icon.svg"） */
     icon?: string;
+    /** 插件标签（市场展示 / 检索；如 ["ai", "chat"]） */
+    tags?: string[];
+    /** 所属组织（组织标识，形如 "@xxx"） */
+    organization?: string;
     requires?: string[];
     platforms?: PluginPlatform[];
     permissions?: PluginPermission[];
-    /** 对外暴露给其它插件调用的方法（plugin.invoke 校验） */
-    expose?: Record<string, {
-        description?: string;
-    }>;
+    /** 对外暴露给其它插件调用的方法（plugin.invoke 校验；access 见 ExposeAccess） */
+    expose?: Record<string, PluginExposeMethod>;
     /** 声明要调用的其它插件方法（plugin.invoke 校验） */
     dependencies?: Record<string, string[]>;
     engines?: {

package/dist/vite-config.d.ts

@@ -1,5 +1,5 @@
 /**
- * createPluginViteConfig - 插件 UI 构建预设（MF remote）。
+ * createPluginViteConfig - 插件 UI 构建预设（System.register 格式，宿主用 SystemJS 加载）。
  */
 import { type UserConfig } from 'vite';
 export interface PluginViteConfigOptions {

package/dist/vite-config.mjs

@@ -1,96 +1,66 @@
 import { defineConfig } from 'vite';
 import react from '@vitejs/plugin-react';
-import federation from 'vite-plugin-federation';
 
 function createPluginViteConfig(options) {
-  const { pluginId, pluginDir, uiEntry = "src/renderer/App.tsx" } = options;
+  const { pluginDir, pluginId, uiEntry = "src/renderer/App.tsx" } = options;
   return defineConfig({
     root: pluginDir,
     plugins: [
       react(),
-      // vite-plugin-federation 1.0.2 缺陷修复：依赖对同一共享包多个 import 被重写成同名
-      // 本地绑定后，Rollup deconflict 出 `local$M` 但 import 未同步 → ReferenceError。
-      // 泛化修复：未绑定的 local$M → 重命名第 (M+1) 个代理声明；React$1 特例补 R 导出。
+      // System.register 格式的 JS 不产出 CSS 引用（esm 会有 import './x.css'），而插件的
+      // remoteEntry.js 由宿主经 SystemJS 动态加载（无 HTML 流程）。这里把 CSS 保留为
+      // 独立文件，并在入口 chunk 注入 <link>：样式经 dlientV3:// 协议加载；CSS 内 url()
+      // 相对路径由浏览器按 CSS 文件位置解析，可正确引用插件内资源（不内联、无需重写）。
       {
-        name: "dlient:fix-mf-cjs-interop",
+        name: "dlient:css-link",
         enforce: "post",
-        generateBundle(_, bundle) {
-          const reactProxyRe = /(__mfe_internal__[A-Za-z0-9_]+__loadShare__react__loadShare__\.js\.js)/;
-          for (const chunk of Object.values(bundle)) {
-            if (chunk.type !== "chunk") continue;
-            let code = chunk.code;
-            const importRe = /import\{([^}]+)\}from(["'])([^"']*__loadShare__[^"']*)\2/g;
-            const decls = [];
-            let m;
-            while ((m = importRe.exec(code)) !== null) {
-              const full = m[0];
-              for (const spec of m[1].split(",")) {
-                const p = spec.trim().split(/\s+as\s+/);
-                decls.push({ imported: p[0].trim(), local: (p[1] || p[0]).trim(), full });
-              }
-            }
-            const bound = new Set(decls.map((d) => d.local));
-            let changed = false;
-            const original = code;
-            const refRe = /\b([A-Za-z_$][\w$]*)\$(\d+)\b/g;
-            while ((m = refRe.exec(original)) !== null) {
-              const unbound = m[0];
-              const base = m[1];
-              const idx = Number(m[2]);
-              if (bound.has(unbound)) continue;
-              const target = decls.filter((d) => d.local === base)[idx];
-              if (!target) continue;
-              const specRe = new RegExp(`(^|[,\\s])(${target.imported}(?:\\s+as\\s+${target.local})?)(?=[,}])`, "g");
-              const newFull = target.full.replace(specRe, `$1${target.imported} as ${unbound}`);
-              code = code.replace(target.full, newFull);
-              changed = true;
-            }
-            if (!changed && /\bReact\$1\b/.test(code) && !/[{(,]\s*R\s+as\s+React\$1\s*[,}]/.test(code) && !/export\s*\{[^}]*React\$1/.test(code)) {
-              const pm = reactProxyRe.exec(code);
-              if (pm) code = `import{R as React$1}from"./${pm[1]}";
-${code}`;
-            }
-            if (changed || code !== chunk.code) chunk.code = code;
-          }
+        generateBundle(_b, bundle) {
+          const css = Object.values(bundle).find(
+            (b) => b.type === "asset" && typeof b.source === "string" && b.fileName.endsWith(".css")
+          );
+          if (!css) return;
+          const entry = Object.values(bundle).find((b) => b.type === "chunk" && b.isEntry);
+          if (!entry) return;
+          entry.code += `
+;(function(){var l=document.createElement('link');l.rel='stylesheet';l.href='dlientV3://plugin/${pluginId}/dist/${css.fileName}?v=${Date.now()}';document.head.appendChild(l);})();`;
         }
-      },
-      federation({
-        name: pluginId,
-        filename: "remoteEntry.js",
-        // @dlient/ui 等打包进插件后依赖图较大，默认 10s 模块解析超时会使 require('react')
-        // 的 CJS 交织别名丢失（React$1 is not defined），按需调大。
-        moduleParseIdleTimeout: 60,
-        exposes: {
-          "./Plugin": uiEntry
-        },
-        shared: {
-          react: { singleton: true, version: "18.2.0", requiredVersion: "^18.2.0" },
-          "react/jsx-runtime": { singleton: true, version: "18.2.0", requiredVersion: "^18.2.0" },
-          "react-dom": { singleton: true, version: "18.2.0", requiredVersion: "^18.2.0" },
-          "react-dom/client": { singleton: true, version: "18.2.0", requiredVersion: "^18.2.0" },
-          // 必须与宿主同一实例的模块（api-bridge / i18n / ui）：
-          // 两包（i18n、ui）均已 lib 构建为 ESM + react external，本地 file: 依赖走
-          // workspace 分支纯运行时 loadShare，不触发预构建改写 → 规避 require$$0。
-          // import:false：不预构建/静态改写，纯共享缓存读取，避免插件构建把绑定导入合并丢失。
-          "@dlient/api-bridge": { singleton: true, version: "3.0.0", requiredVersion: "^3.0.0", import: false },
-          "@dlient/i18n": { singleton: true, version: "3.0.0", requiredVersion: "^3.0.0" },
-          "@dlient/ui": { singleton: true, version: "3.0.0", requiredVersion: "^3.0.0" }
-        }
-      })
+      }
     ],
     build: {
       outDir: "dist",
+      // worker 产物（dist/worker.js）与 UI 共享同一 dist，且 worker 不经 vite 构建；
+      // 关闭 emptyOutDir，避免 vite build 清空 dist 时误删 worker.js。
+      emptyOutDir: false,
       target: "esnext",
-      minify: false,
+      // 方案 build.md 2.2：UI 端 JS 仅压缩（不混淆——System.register 结构 / import map 裸依赖
+      // / 入口导出会被混淆器破坏）。产物始终不带 sourcemap，避免源码经 dlientV3:// 泄露。
+      minify: "esbuild",
+      sourcemap: false,
+      // CSS 压缩（esbuild）：vite 5 的 cssMinify 不跟随 minify，需显式开启。
+      cssMinify: "esbuild",
       modulePreload: false,
       cssCodeSplit: false,
       rollupOptions: {
         input: {
           main: uiEntry
         },
+        // 入口导出由宿主（SystemJS import）在运行时消费：'exports-only' 会把默认导出
+        // 当作未使用 tree-shake 掉，必须 'strict' 保留入口全部导出。
+        preserveEntrySignatures: "strict",
+        // react 系与 @dlient/* 全部 external：运行时从宿主 SystemJS registry 解析单实例
+        // （见 @dlient/ui PluginView 的 ensureSystemShared）。
+        external: [
+          "react",
+          "react/jsx-runtime",
+          "react-dom",
+          "react-dom/client",
+          "@dlient/api-bridge",
+          "@dlient/i18n",
+          "@dlient/ui"
+        ],
         output: {
-          format: "esm",
-          entryFileNames: "assets/[name].js",
+          format: "system",
+          entryFileNames: "remoteEntry.js",
           chunkFileNames: "assets/[name].js",
           assetFileNames: "assets/[name].[ext]"
         }

package/dist/vite-config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"vite-config.mjs","sources":["../src/vite-config.ts"],"sourcesContent":["/**\n * createPluginViteConfig - 插件 UI 构建预设（MF remote）。\n */\n\nimport { defineConfig, type UserConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\nimport federation from 'vite-plugin-federation'\n\nexport interface PluginViteConfigOptions {\n  pluginId: string\n  pluginDir: string\n  hasWorker: boolean\n  uiEntry?: string\n  workerEntry?: string\n}\n\nexport function createPluginViteConfig(options: PluginViteConfigOptions): UserConfig {\n  const { pluginId, pluginDir, uiEntry = 'src/renderer/App.tsx' } = options\n\n  return defineConfig({\n    root: pluginDir,\n    plugins: [\n      react(),\n      // vite-plugin-federation 1.0.2 缺陷修复：依赖对同一共享包多个 import 被重写成同名\n      // 本地绑定后，Rollup deconflict 出 `local$M` 但 import 未同步 → ReferenceError。\n      // 泛化修复：未绑定的 local$M → 重命名第 (M+1) 个代理声明；React$1 特例补 R 导出。\n      {\n        name: 'dlient:fix-mf-cjs-interop',\n        enforce: 'post',\n        generateBundle(_, bundle) {\n          const reactProxyRe = /(__mfe_internal__[A-Za-z0-9_]+__loadShare__react__loadShare__\\.js\\.js)/\n          for (const chunk of Object.values(bundle)) {\n            if (chunk.type !== 'chunk') continue\n            let code = chunk.code as string\n            const importRe = /import\\{([^}]+)\\}from([\"'])([^\"']*__loadShare__[^\"']*)\\2/g\n            const decls: Array<{ imported: string; local: string; full: string }> = []\n            let m: RegExpExecArray | null\n            while ((m = importRe.exec(code)) !== null) {\n              const full = m[0]\n              for (const spec of m[1].split(',')) {\n                const p = spec.trim().split(/\\s+as\\s+/)\n                decls.push({ imported: p[0].trim(), local: (p[1] || p[0]).trim(), full })\n              }\n            }\n            const bound = new Set(decls.map((d) => d.local))\n            let changed = false\n            const original = code\n            const refRe = /\\b([A-Za-z_$][\\w$]*)\\$(\\d+)\\b/g\n            while ((m = refRe.exec(original)) !== null) {\n              const unbound = m[0]\n              const base = m[1]\n              const idx = Number(m[2])\n              if (bound.has(unbound)) continue\n              const target = decls.filter((d) => d.local === base)[idx]\n              if (!target) continue\n              const specRe = new RegExp(`(^|[,\\\\s])(${target.imported}(?:\\\\s+as\\\\s+${target.local})?)(?=[,}])`, 'g')\n              const newFull = target.full.replace(specRe, `$1${target.imported} as ${unbound}`)\n              code = code.replace(target.full, newFull)\n              changed = true\n            }\n            if (!changed && /\\bReact\\$1\\b/.test(code) && !/[{(,]\\s*R\\s+as\\s+React\\$1\\s*[,}]/.test(code) && !/export\\s*\\{[^}]*React\\$1/.test(code)) {\n              const pm = reactProxyRe.exec(code)\n              if (pm) code = `import{R as React\\$1}from\"./${pm[1]}\";\\n${code}`\n            }\n            if (changed || code !== (chunk.code as string)) chunk.code = code\n          }\n        },\n      },\n      federation({\n        name: pluginId,\n        filename: 'remoteEntry.js',\n        // @dlient/ui 等打包进插件后依赖图较大，默认 10s 模块解析超时会使 require('react')\n        // 的 CJS 交织别名丢失（React$1 is not defined），按需调大。\n        moduleParseIdleTimeout: 60,\n        exposes: {\n          './Plugin': uiEntry,\n        },\n        shared: {\n          react: { singleton: true, version: '18.2.0', requiredVersion: '^18.2.0' },\n          'react/jsx-runtime': { singleton: true, version: '18.2.0', requiredVersion: '^18.2.0' },\n          'react-dom': { singleton: true, version: '18.2.0', requiredVersion: '^18.2.0' },\n          'react-dom/client': { singleton: true, version: '18.2.0', requiredVersion: '^18.2.0' },\n          // 必须与宿主同一实例的模块（api-bridge / i18n / ui）：\n          // 两包（i18n、ui）均已 lib 构建为 ESM + react external，本地 file: 依赖走\n          // workspace 分支纯运行时 loadShare，不触发预构建改写 → 规避 require$$0。\n          // import:false：不预构建/静态改写，纯共享缓存读取，避免插件构建把绑定导入合并丢失。\n          '@dlient/api-bridge': { singleton: true, version: '3.0.0', requiredVersion: '^3.0.0', import: false },\n          '@dlient/i18n': { singleton: true, version: '3.0.0', requiredVersion: '^3.0.0' },\n          '@dlient/ui': { singleton: true, version: '3.0.0', requiredVersion: '^3.0.0' },\n        },\n      }),\n    ],\n    build: {\n      outDir: 'dist',\n      target: 'esnext',\n      minify: false,\n      modulePreload: false,\n      cssCodeSplit: false,\n      rollupOptions: {\n        input: {\n          main: uiEntry,\n        },\n        output: {\n          format: 'esm',\n          entryFileNames: 'assets/[name].js',\n          chunkFileNames: 'assets/[name].js',\n          assetFileNames: 'assets/[name].[ext]',\n        },\n      },\n    },\n  } as UserConfig)\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"vite-config.mjs","sources":["../src/vite-config.ts"],"sourcesContent":["/**\n * createPluginViteConfig - 插件 UI 构建预设（System.register 格式，宿主用 SystemJS 加载）。\n */\n\nimport { defineConfig, type UserConfig } from 'vite'\nimport react from '@vitejs/plugin-react'\n\nexport interface PluginViteConfigOptions {\n  pluginId: string\n  pluginDir: string\n  hasWorker: boolean\n  uiEntry?: string\n  workerEntry?: string\n}\n\nexport function createPluginViteConfig(options: PluginViteConfigOptions): UserConfig {\n  const { pluginDir, pluginId, uiEntry = 'src/renderer/App.tsx' } = options\n\n  return defineConfig({\n    root: pluginDir,\n    plugins: [\n      react(),\n      // System.register 格式的 JS 不产出 CSS 引用（esm 会有 import './x.css'），而插件的\n      // remoteEntry.js 由宿主经 SystemJS 动态加载（无 HTML 流程）。这里把 CSS 保留为\n      // 独立文件，并在入口 chunk 注入 <link>：样式经 dlientV3:// 协议加载；CSS 内 url()\n      // 相对路径由浏览器按 CSS 文件位置解析，可正确引用插件内资源（不内联、无需重写）。\n      {\n        name: 'dlient:css-link',\n        enforce: 'post',\n        generateBundle(_b, bundle) {\n          const css = Object.values(bundle).find(\n            (b) => b.type === 'asset' && typeof b.source === 'string' && b.fileName.endsWith('.css'),\n          ) as unknown as { fileName: string; source: string } | undefined\n          if (!css) return\n          const entry = Object.values(bundle).find((b) => b.type === 'chunk' && b.isEntry) as unknown as\n            | { code: string }\n            | undefined\n          if (!entry) return\n          // 版本戳：dev 热重载 / 插件升级后 href 变化，避免浏览器缓存旧 style.css。\n          entry.code += `\\n;(function(){var l=document.createElement('link');l.rel='stylesheet';l.href='dlientV3://plugin/${pluginId}/dist/${css.fileName}?v=${Date.now()}';document.head.appendChild(l);})();`\n        },\n      },\n    ],\n    build: {\n      outDir: 'dist',\n      // worker 产物（dist/worker.js）与 UI 共享同一 dist，且 worker 不经 vite 构建；\n      // 关闭 emptyOutDir，避免 vite build 清空 dist 时误删 worker.js。\n      emptyOutDir: false,\n      target: 'esnext',\n      // 方案 build.md 2.2：UI 端 JS 仅压缩（不混淆——System.register 结构 / import map 裸依赖\n      // / 入口导出会被混淆器破坏）。产物始终不带 sourcemap，避免源码经 dlientV3:// 泄露。\n      minify: 'esbuild',\n      sourcemap: false,\n      // CSS 压缩（esbuild）：vite 5 的 cssMinify 不跟随 minify，需显式开启。\n      cssMinify: 'esbuild',\n      modulePreload: false,\n      cssCodeSplit: false,\n      rollupOptions: {\n        input: {\n          main: uiEntry,\n        },\n        // 入口导出由宿主（SystemJS import）在运行时消费：'exports-only' 会把默认导出\n        // 当作未使用 tree-shake 掉，必须 'strict' 保留入口全部导出。\n        preserveEntrySignatures: 'strict',\n        // react 系与 @dlient/* 全部 external：运行时从宿主 SystemJS registry 解析单实例\n        // （见 @dlient/ui PluginView 的 ensureSystemShared）。\n        external: [\n          'react',\n          'react/jsx-runtime',\n          'react-dom',\n          'react-dom/client',\n          '@dlient/api-bridge',\n          '@dlient/i18n',\n          '@dlient/ui',\n        ],\n        output: {\n          format: 'system',\n          entryFileNames: 'remoteEntry.js',\n          chunkFileNames: 'assets/[name].js',\n          assetFileNames: 'assets/[name].[ext]',\n        },\n      },\n    },\n  } as UserConfig)\n}\n"],"names":[],"mappings":";;;AAeO,SAAS,uBAAuB,OAAA,EAA8C;AACnF,EAAA,MAAM,EAAE,SAAA,EAAW,QAAA,EAAU,OAAA,GAAU,wBAAuB,GAAI,OAAA;AAElE,EAAA,OAAO,YAAA,CAAa;AAAA,IAClB,IAAA,EAAM,SAAA;AAAA,IACN,OAAA,EAAS;AAAA,MACP,KAAA,EAAM;AAAA;AAAA;AAAA;AAAA;AAAA,MAKN;AAAA,QACE,IAAA,EAAM,iBAAA;AAAA,QACN,OAAA,EAAS,MAAA;AAAA,QACT,cAAA,CAAe,IAAI,MAAA,EAAQ;AACzB,UAAA,MAAM,GAAA,GAAM,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA,CAAE,IAAA;AAAA,YAChC,CAAC,CAAA,KAAM,CAAA,CAAE,IAAA,KAAS,OAAA,IAAW,OAAO,CAAA,CAAE,MAAA,KAAW,QAAA,IAAY,CAAA,CAAE,QAAA,CAAS,QAAA,CAAS,MAAM;AAAA,WACzF;AACA,UAAA,IAAI,CAAC,GAAA,EAAK;AACV,UAAA,MAAM,KAAA,GAAQ,MAAA,CAAO,MAAA,CAAO,MAAM,CAAA,CAAE,IAAA,CAAK,CAAC,CAAA,KAAM,CAAA,CAAE,IAAA,KAAS,OAAA,IAAW,CAAA,CAAE,OAAO,CAAA;AAG/E,UAAA,IAAI,CAAC,KAAA,EAAO;AAEZ,UAAA,KAAA,CAAM,IAAA,IAAQ;AAAA,+FAAA,EAAoG,QAAQ,CAAA,MAAA,EAAS,GAAA,CAAI,QAAQ,CAAA,GAAA,EAAM,IAAA,CAAK,KAAK,CAAA,oCAAA,CAAA;AAAA,QACjK;AAAA;AACF,KACF;AAAA,IACA,KAAA,EAAO;AAAA,MACL,MAAA,EAAQ,MAAA;AAAA;AAAA;AAAA,MAGR,WAAA,EAAa,KAAA;AAAA,MACb,MAAA,EAAQ,QAAA;AAAA;AAAA;AAAA,MAGR,MAAA,EAAQ,SAAA;AAAA,MACR,SAAA,EAAW,KAAA;AAAA;AAAA,MAEX,SAAA,EAAW,SAAA;AAAA,MACX,aAAA,EAAe,KAAA;AAAA,MACf,YAAA,EAAc,KAAA;AAAA,MACd,aAAA,EAAe;AAAA,QACb,KAAA,EAAO;AAAA,UACL,IAAA,EAAM;AAAA,SACR;AAAA;AAAA;AAAA,QAGA,uBAAA,EAAyB,QAAA;AAAA;AAAA;AAAA,QAGzB,QAAA,EAAU;AAAA,UACR,OAAA;AAAA,UACA,mBAAA;AAAA,UACA,WAAA;AAAA,UACA,kBAAA;AAAA,UACA,oBAAA;AAAA,UACA,cAAA;AAAA,UACA;AAAA,SACF;AAAA,QACA,MAAA,EAAQ;AAAA,UACN,MAAA,EAAQ,QAAA;AAAA,UACR,cAAA,EAAgB,gBAAA;AAAA,UAChB,cAAA,EAAgB,kBAAA;AAAA,UAChB,cAAA,EAAgB;AAAA;AAClB;AACF;AACF,GACa,CAAA;AACjB;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dlient/plugin-sdk",
-  "version": "3.0.2",
+  "version": "3.0.4",
   "private": false,
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
@@ -24,7 +24,6 @@
     "@types/node": "^20.0.0",
     "@vitejs/plugin-react": "^4.2.1",
     "typescript": "^5.4.0",
-    "vite": "^5.1.6",
-    "vite-plugin-federation": "^1.0.2"
+    "vite": "^5.1.6"
   }
 }