@epxing/core 5.3.0-beta.1 → 5.3.0-beta.3

package/src/loadComponent.js

@@ -1,187 +1,187 @@
-import { loadBusinessComponents } from './runtime-services'
-// 按页面配置的 pagePath 推导组件名，并（首次遇到时）懒注册整个 system.component 组件组。
-//
-// T29：原实现用 **Vue2 的 resolve 回调式异步组件**：
-//   Vue.component(name, function (resolve) { import(...).then(m => resolve(m.default[name])) })
-// 这在 @vue/compat 下靠 `COMPONENT_ASYNC` 开关兜着。但 Element Plus 与 compat 共存**必须**
-// 关掉 COMPONENT_ASYNC（否则 compat 把 EP 的函数组件误当 Vue2 异步组件转换 → 登录页白屏），
-// 于是这里的 `resolve` 不再被注入 → `TypeError: resolve is not a function`，
-// **所有走懒注册的页面组件（entity-list 等）全部加载失败、表格消失**。
-//
-// ⇒ 改用 Vue3 原生 `defineAsyncComponent`（loader 返回 Promise<Component>）。
-//    行为等价：首次渲染该组件名时才真正 import；import 完顺带把整组注册进 app。
-//
-// （顺带纠正一条记档：此前断言"全仓无 Vue2 异步组件用法、关 COMPONENT_ASYNC 安全"——**是错的**，
-//   漏了这一处 resolve 回调式注册。它不是 `() => import()` 也不是 `() => ({component})`，
-//   所以按那两种形态 grep 时没命中。）
-import { defineAsyncComponent } from 'vue'
-import ensureRemoteDeps from '@epxing/core/src/remote-deps'
-
-/* global __EPX_BUSINESS_REMOTE__ */
-// ADR-010 阶段2：__EPX_BUSINESS_REMOTE__ 是构建期常量（vite define，见 vite.config.mjs）。
-//  - 未定义 / false（默认）：业务视图随平台构建，本地 import system.component.js（行为不变）。
-//  - true（EXTERNALIZE_BUSINESS=true 构建）：平台【不含】业务视图（本地分支被 tree-shake，
-//    system.component.js 掉出产物 → 瘦平台）。运行时从 window.__EPX_BUSINESS_REMOTE_URL__
-//    指向的【独立部署】import() 拉起 business remote bundle（vue/vuex/http 走 window.frame 共享）。
-
-// remote 的 style.css 只注入一次
-let remoteCssInjected = false
-function injectRemoteCss (href) {
-  if (remoteCssInjected || !href) return
-  remoteCssInjected = true
-  const link = document.createElement('link')
-  link.rel = 'stylesheet'
-  link.href = href
-  document.head.appendChild(link)
-}
-
-// 可选能力组（designer/dashboard）运行时懒加载：
-// 原为启动时静态注册（component.designer/dashboard.js 经 @platform-optional/* spread 进 113 表），
-// 设计器 210 文件被 eager 打进 frame chunk，而绝大多数用户从不打开设计器。
-// 现平台构建把静态别名【永远】指空桩，本处经 -lazy 说明符按需 import：
-//   业务组（system.component）没命中 → dashboard（小）→ designer（大），谁命中用谁。
-// INCLUDE_DESIGNER/DASHBOARD=false 时 -lazy 也指空桩（裁剪版行为与 ADR-009 一致：兜底报错）。
-// ⚠️ 注册须兑现 .install 语义（Dashboard/PageDesigner 等聚合的 install 会注册一组子组件），
-//    用「录名 guard」捕获 install 里每个 name→comp（异步组件名已被 wrapper 占位，须从表取真身）。
-// 按需形态严格模式（可插拔子路径入口，PROJECT-GUIDE §三）：window.EPX_DISABLE_LAZY_PACKS = true
-// 时，未显式 app.use() 安装的能力包（business/designer/dashboard）**不做运行时懒加载兜底**——
-// 页面配置引用到其组件名走 loadComponent 报错兜底（不渲染 + console 报名字），"没装就不出现"。
-// 默认关：产品 dev 壳登录后落的是平台页面（服务大厅等由 business 组件拼成），兜底保证不白屏。
-const strictPacks = () => typeof window !== 'undefined' && window.EPX_DISABLE_LAZY_PACKS
-
-const optionalGroupCache = {}
-const OPTIONAL_GROUPS = {
-  dashboard: () => import('@platform-optional/dashboard-lazy'),
-  designer: () => import('@platform-optional/designer-lazy')
-}
-function loadOptionalGroup (app, which) {
-  if (strictPacks()) return Promise.resolve({})
-  if (!optionalGroupCache[which]) {
-    optionalGroupCache[which] = OPTIONAL_GROUPS[which]().then(m => {
-      const group = m.default || {}
-      const byName = {}
-      const guard = new Proxy(app, {
-        get (target, prop, receiver) {
-          if (prop === 'component') {
-            return (name, comp) => {
-              if (comp === undefined) return target.component(name)
-              byName[name] = comp
-              if (typeof window !== 'undefined' && window.componentLibrary) window.componentLibrary[name] = comp
-              if (!target.component(name)) target.component(name, comp)
-              return guard
-            }
-          }
-          const v = Reflect.get(target, prop, receiver)
-          return typeof v === 'function' ? v.bind(target) : v
-        }
-      })
-      for (const key in group) {
-        const comp = group[key]
-        if (!comp) continue
-        if (comp.install) comp.install(guard)
-        else guard.component(comp.name || key, comp)
-      }
-      return byName
-    })
-  }
-  return optionalGroupCache[which]
-}
-
-// 业务组解析（两种模式，只 import 一次）：
-//  - 瘦平台（__EPX_BUSINESS_REMOTE__）：remote bundle 整组加载（远程产物本就单包，不拆）
-//  - 本地默认：**按名文件级懒加载**（system.component.lazy.js）——名→文件索引 + async wrapper
-//    全量注册（业务视图模板互相按名引用可命中）；索引未命中/校验不符自动回退整组，
-//    最坏情况 = 旧整组行为。返回统一的 { resolve(app, name) } 接口。
-let systemComponentsPromise = null
-function loadSystemComponents (app) {
-  // 严格模式只拦「隐式懒加载兜底」；瘦平台的 remote business 是显式部署配置
-  // （EXTERNALIZE_BUSINESS 构建 + config.js 配 URL）＝"已安装"，不受严格模式影响。
-  const isRemote = typeof __EPX_BUSINESS_REMOTE__ !== 'undefined' && __EPX_BUSINESS_REMOTE__
-  if (strictPacks() && !isRemote) {
-    return Promise.resolve({ resolve: () => Promise.resolve(null) })
-  }
-  if (!systemComponentsPromise) {
-    if (typeof __EPX_BUSINESS_REMOTE__ !== 'undefined' && __EPX_BUSINESS_REMOTE__) {
-      // 瘦平台：从独立部署的 remote bundle 拉业务视图（整组注册）
-      const remote = (typeof window !== 'undefined' && window.__EPX_BUSINESS_REMOTE_URL__) || {}
-      injectRemoteCss(remote.css)
-      // 先备好该远程包要用到的懒加载平台组件，再 import 它（见 core/remote-deps.js）。
-      // .catch(() => {}) 是硬约束「绝不因自动 ensure 挡住远程加载」的护栏：ensure 只是优化，
-      // 它 reject 了也必须继续 import remote（真缺组件时由 frame.js 的自解释 shim 兜底报错）。
-      systemComponentsPromise = ensureRemoteDeps([remote.js]).catch(() => {}).then(() => import(/* @vite-ignore */ remote.js))
-        .then(mod => mod.components || (mod.default && mod.default.components) || mod.default)
-        .then(components => {
-          for (const key in components) {
-            if (!app.component(key)) app.component(key, components[key])
-          }
-          return { resolve: (_app, name) => Promise.resolve(components[name]) }
-        })
-    } else {
-      // 默认：按名文件级懒加载（含整组兜底与 wrapper 全量注册）
-      systemComponentsPromise = loadBusinessComponents(app)
-    }
-  }
-  return systemComponentsPromise
-}
-
-// 注：入参在 T30b app 化后是 **app 实例**（不再是 compat 的全局 Vue）。
-// `app.component(name)` / `app.component(name, comp)` 与 `Vue.component` 同签名，故调用点无需改。
-export default function loadComponentFactory (app) {
-  return (pagePath, defaultComponent) => {
-    let pathName
-    let componentName = 'epx-' + defaultComponent
-    if (pagePath) {
-      const rootMatch = pagePath.match(/^@\/(frame\/|product\/|project\/)?/)
-      if (rootMatch) {
-        pathName = pagePath.split(rootMatch[0])[1].replace('.vue', '')
-      }
-      const componentPath = pathName.replace(/\//g, '-').replace(/(\w)([A-Z])/g, '$1-$2').replace('views-', '').replace('components-', '').replace('packages-', '').toLowerCase()
-      componentName = 'epx-' + componentPath
-    }
-    if (!app.component(componentName)) {
-      app.component(componentName, defineAsyncComponent(() =>
-        loadSystemComponents(app).then(m => m.resolve(app, componentName)).then(comp => {
-          if (comp) return comp
-          // 产品/项目远程库的组件表兜底。
-          //
-          // 为什么必须有这一环：本工厂与产品库的 install 都是「没人占我才占」——
-          //   平台 ↓ 本文件                    产品 ↓ 其 src/index.js
-          //   if (!app.component(name)) …      if (!app.component(key)) …
-          // 谁先跑谁赢。页面配置引用到某个产品组件时 Page.vue 会先按名字调本工厂
-          // （Page.vue:234/330），此时远程库可能还没 install，占位就落位了；随后产品库
-          // install 看到「已存在」直接跳过 —— 槽位归占位，解析时在平台组件里找不到就抛
-          // `system.component 里没有 epx-xxx`，**产品组件永远出不来**。
-          // 2026-09-03 product/hr 的 epx-hr-search 实测就是这条路径。
-          //
-          // window.componentLibrary 由 util.loadJs 的 onload 按组件名汇总各远程库的组件，
-          // 到解析时（渲染时机，loadLibrary 早已在路由守卫里 await 过）必然已就绪。
-          //
-          // ⚠️ 放在可选能力组**之前**：产品组件走到这里就该命中，否则会为了一个
-          //    epx-hr-* 白拉一遍 dashboard 和体积很大的 designer。
-          // ⚠️ 只认对象/函数：loadJs 会把远程库导出的 name/version 这些标量也一并汇总进来。
-          const fromProduct = (typeof window !== 'undefined' && window.componentLibrary) || {}
-          const pc = fromProduct[componentName]
-          if (pc && (typeof pc === 'object' || typeof pc === 'function')) return pc
-          // 可选能力组兜底：dashboard（小）→ designer（大），运行时按需拉起
-          return loadOptionalGroup(app, 'dashboard').then(dash => {
-            if (dash[componentName]) return dash[componentName]
-            return loadOptionalGroup(app, 'designer').then(des => {
-              const c = des[componentName]
-              if (!c) {
-                throw new Error(strictPacks()
-                  ? `[loadComponent] 严格模式（EPX_DISABLE_LAZY_PACKS）下未做懒加载兜底：${componentName} 若来自 business/designer/dashboard，请 app.use(对应 epx-frame 子路径入口) 显式安装`
-                  : `[loadComponent] 找不到 ${componentName}：平台组件、产品远程库` +
-                    '（window.componentLibrary）、dashboard、designer 里都没有。\n' +
-                    '  若它来自产品/项目远程库：确认该库已在 FM_SYSTEM_WEBPACK 配好且加载成功' +
-                    '（控制台看 window.componentLibrary 有没有这个名字），' +
-                    '并检查库里组件的 name 与页面配置引用的名字是否一致。')
-              }
-              return c
-            })
-          })
-        })
-      ))
-    }
-    return componentName
-  }
-}
+import { loadBusinessComponents } from './runtime-services'
+// 按页面配置的 pagePath 推导组件名，并（首次遇到时）懒注册整个 system.component 组件组。
+//
+// T29：原实现用 **Vue2 的 resolve 回调式异步组件**：
+//   Vue.component(name, function (resolve) { import(...).then(m => resolve(m.default[name])) })
+// 这在 @vue/compat 下靠 `COMPONENT_ASYNC` 开关兜着。但 Element Plus 与 compat 共存**必须**
+// 关掉 COMPONENT_ASYNC（否则 compat 把 EP 的函数组件误当 Vue2 异步组件转换 → 登录页白屏），
+// 于是这里的 `resolve` 不再被注入 → `TypeError: resolve is not a function`，
+// **所有走懒注册的页面组件（entity-list 等）全部加载失败、表格消失**。
+//
+// ⇒ 改用 Vue3 原生 `defineAsyncComponent`（loader 返回 Promise<Component>）。
+//    行为等价：首次渲染该组件名时才真正 import；import 完顺带把整组注册进 app。
+//
+// （顺带纠正一条记档：此前断言"全仓无 Vue2 异步组件用法、关 COMPONENT_ASYNC 安全"——**是错的**，
+//   漏了这一处 resolve 回调式注册。它不是 `() => import()` 也不是 `() => ({component})`，
+//   所以按那两种形态 grep 时没命中。）
+import { defineAsyncComponent } from 'vue'
+import ensureRemoteDeps from '@epxing/core/src/remote-deps'
+
+/* global __EPX_BUSINESS_REMOTE__ */
+// ADR-010 阶段2：__EPX_BUSINESS_REMOTE__ 是构建期常量（vite define，见 vite.config.mjs）。
+//  - 未定义 / false（默认）：业务视图随平台构建，本地 import system.component.js（行为不变）。
+//  - true（EXTERNALIZE_BUSINESS=true 构建）：平台【不含】业务视图（本地分支被 tree-shake，
+//    system.component.js 掉出产物 → 瘦平台）。运行时从 window.__EPX_BUSINESS_REMOTE_URL__
+//    指向的【独立部署】import() 拉起 business remote bundle（vue/vuex/http 走 window.frame 共享）。
+
+// remote 的 style.css 只注入一次
+let remoteCssInjected = false
+function injectRemoteCss (href) {
+  if (remoteCssInjected || !href) return
+  remoteCssInjected = true
+  const link = document.createElement('link')
+  link.rel = 'stylesheet'
+  link.href = href
+  document.head.appendChild(link)
+}
+
+// 可选能力组（designer/dashboard）运行时懒加载：
+// 原为启动时静态注册（component.designer/dashboard.js 经 @platform-optional/* spread 进 113 表），
+// 设计器 210 文件被 eager 打进 frame chunk，而绝大多数用户从不打开设计器。
+// 现平台构建把静态别名【永远】指空桩，本处经 -lazy 说明符按需 import：
+//   业务组（system.component）没命中 → dashboard（小）→ designer（大），谁命中用谁。
+// INCLUDE_DESIGNER/DASHBOARD=false 时 -lazy 也指空桩（裁剪版行为与 ADR-009 一致：兜底报错）。
+// ⚠️ 注册须兑现 .install 语义（Dashboard/PageDesigner 等聚合的 install 会注册一组子组件），
+//    用「录名 guard」捕获 install 里每个 name→comp（异步组件名已被 wrapper 占位，须从表取真身）。
+// 按需形态严格模式（可插拔子路径入口，PROJECT-GUIDE §三）：window.EPX_DISABLE_LAZY_PACKS = true
+// 时，未显式 app.use() 安装的能力包（business/designer/dashboard）**不做运行时懒加载兜底**——
+// 页面配置引用到其组件名走 loadComponent 报错兜底（不渲染 + console 报名字），"没装就不出现"。
+// 默认关：产品 dev 壳登录后落的是平台页面（服务大厅等由 business 组件拼成），兜底保证不白屏。
+const strictPacks = () => typeof window !== 'undefined' && window.EPX_DISABLE_LAZY_PACKS
+
+const optionalGroupCache = {}
+const OPTIONAL_GROUPS = {
+  dashboard: () => import('@platform-optional/dashboard-lazy'),
+  designer: () => import('@platform-optional/designer-lazy')
+}
+function loadOptionalGroup (app, which) {
+  if (strictPacks()) return Promise.resolve({})
+  if (!optionalGroupCache[which]) {
+    optionalGroupCache[which] = OPTIONAL_GROUPS[which]().then(m => {
+      const group = m.default || {}
+      const byName = {}
+      const guard = new Proxy(app, {
+        get (target, prop, receiver) {
+          if (prop === 'component') {
+            return (name, comp) => {
+              if (comp === undefined) return target.component(name)
+              byName[name] = comp
+              if (typeof window !== 'undefined' && window.componentLibrary) window.componentLibrary[name] = comp
+              if (!target.component(name)) target.component(name, comp)
+              return guard
+            }
+          }
+          const v = Reflect.get(target, prop, receiver)
+          return typeof v === 'function' ? v.bind(target) : v
+        }
+      })
+      for (const key in group) {
+        const comp = group[key]
+        if (!comp) continue
+        if (comp.install) comp.install(guard)
+        else guard.component(comp.name || key, comp)
+      }
+      return byName
+    })
+  }
+  return optionalGroupCache[which]
+}
+
+// 业务组解析（两种模式，只 import 一次）：
+//  - 瘦平台（__EPX_BUSINESS_REMOTE__）：remote bundle 整组加载（远程产物本就单包，不拆）
+//  - 本地默认：**按名文件级懒加载**（system.component.lazy.js）——名→文件索引 + async wrapper
+//    全量注册（业务视图模板互相按名引用可命中）；索引未命中/校验不符自动回退整组，
+//    最坏情况 = 旧整组行为。返回统一的 { resolve(app, name) } 接口。
+let systemComponentsPromise = null
+function loadSystemComponents (app) {
+  // 严格模式只拦「隐式懒加载兜底」；瘦平台的 remote business 是显式部署配置
+  // （EXTERNALIZE_BUSINESS 构建 + config.js 配 URL）＝"已安装"，不受严格模式影响。
+  const isRemote = typeof __EPX_BUSINESS_REMOTE__ !== 'undefined' && __EPX_BUSINESS_REMOTE__
+  if (strictPacks() && !isRemote) {
+    return Promise.resolve({ resolve: () => Promise.resolve(null) })
+  }
+  if (!systemComponentsPromise) {
+    if (typeof __EPX_BUSINESS_REMOTE__ !== 'undefined' && __EPX_BUSINESS_REMOTE__) {
+      // 瘦平台：从独立部署的 remote bundle 拉业务视图（整组注册）
+      const remote = (typeof window !== 'undefined' && window.__EPX_BUSINESS_REMOTE_URL__) || {}
+      injectRemoteCss(remote.css)
+      // 先备好该远程包要用到的懒加载平台组件，再 import 它（见 core/remote-deps.js）。
+      // .catch(() => {}) 是硬约束「绝不因自动 ensure 挡住远程加载」的护栏：ensure 只是优化，
+      // 它 reject 了也必须继续 import remote（真缺组件时由 frame.js 的自解释 shim 兜底报错）。
+      systemComponentsPromise = ensureRemoteDeps([remote.js]).catch(() => {}).then(() => import(/* @vite-ignore */ remote.js))
+        .then(mod => mod.components || (mod.default && mod.default.components) || mod.default)
+        .then(components => {
+          for (const key in components) {
+            if (!app.component(key)) app.component(key, components[key])
+          }
+          return { resolve: (_app, name) => Promise.resolve(components[name]) }
+        })
+    } else {
+      // 默认：按名文件级懒加载（含整组兜底与 wrapper 全量注册）
+      systemComponentsPromise = loadBusinessComponents(app)
+    }
+  }
+  return systemComponentsPromise
+}
+
+// 注：入参在 T30b app 化后是 **app 实例**（不再是 compat 的全局 Vue）。
+// `app.component(name)` / `app.component(name, comp)` 与 `Vue.component` 同签名，故调用点无需改。
+export default function loadComponentFactory (app) {
+  return (pagePath, defaultComponent) => {
+    let pathName
+    let componentName = 'epx-' + defaultComponent
+    if (pagePath) {
+      const rootMatch = pagePath.match(/^@\/(frame\/|product\/|project\/)?/)
+      if (rootMatch) {
+        pathName = pagePath.split(rootMatch[0])[1].replace('.vue', '')
+      }
+      const componentPath = pathName.replace(/\//g, '-').replace(/(\w)([A-Z])/g, '$1-$2').replace('views-', '').replace('components-', '').replace('packages-', '').toLowerCase()
+      componentName = 'epx-' + componentPath
+    }
+    if (!app.component(componentName)) {
+      app.component(componentName, defineAsyncComponent(() =>
+        loadSystemComponents(app).then(m => m.resolve(app, componentName)).then(comp => {
+          if (comp) return comp
+          // 产品/项目远程库的组件表兜底。
+          //
+          // 为什么必须有这一环：本工厂与产品库的 install 都是「没人占我才占」——
+          //   平台 ↓ 本文件                    产品 ↓ 其 src/index.js
+          //   if (!app.component(name)) …      if (!app.component(key)) …
+          // 谁先跑谁赢。页面配置引用到某个产品组件时 Page.vue 会先按名字调本工厂
+          // （Page.vue:234/330），此时远程库可能还没 install，占位就落位了；随后产品库
+          // install 看到「已存在」直接跳过 —— 槽位归占位，解析时在平台组件里找不到就抛
+          // `system.component 里没有 epx-xxx`，**产品组件永远出不来**。
+          // 2026-09-03 product/hr 的 epx-hr-search 实测就是这条路径。
+          //
+          // window.componentLibrary 由 util.loadJs 的 onload 按组件名汇总各远程库的组件，
+          // 到解析时（渲染时机，loadLibrary 早已在路由守卫里 await 过）必然已就绪。
+          //
+          // ⚠️ 放在可选能力组**之前**：产品组件走到这里就该命中，否则会为了一个
+          //    epx-hr-* 白拉一遍 dashboard 和体积很大的 designer。
+          // ⚠️ 只认对象/函数：loadJs 会把远程库导出的 name/version 这些标量也一并汇总进来。
+          const fromProduct = (typeof window !== 'undefined' && window.componentLibrary) || {}
+          const pc = fromProduct[componentName]
+          if (pc && (typeof pc === 'object' || typeof pc === 'function')) return pc
+          // 可选能力组兜底：dashboard（小）→ designer（大），运行时按需拉起
+          return loadOptionalGroup(app, 'dashboard').then(dash => {
+            if (dash[componentName]) return dash[componentName]
+            return loadOptionalGroup(app, 'designer').then(des => {
+              const c = des[componentName]
+              if (!c) {
+                throw new Error(strictPacks()
+                  ? `[loadComponent] 严格模式（EPX_DISABLE_LAZY_PACKS）下未做懒加载兜底：${componentName} 若来自 business/designer/dashboard，请 app.use(对应 epx-frame 子路径入口) 显式安装`
+                  : `[loadComponent] 找不到 ${componentName}：平台组件、产品远程库` +
+                    '（window.componentLibrary）、dashboard、designer 里都没有。\n' +
+                    '  若它来自产品/项目远程库：确认该库已在 FM_SYSTEM_WEBPACK 配好且加载成功' +
+                    '（控制台看 window.componentLibrary 有没有这个名字），' +
+                    '并检查库里组件的 name 与页面配置引用的名字是否一致。')
+              }
+              return c
+            })
+          })
+        })
+      ))
+    }
+    return componentName
+  }
+}

package/src/loadLibrary.js

@@ -1,99 +1,99 @@
-import util from '@epxing/core/src/runtime-utils/util'
-import http from '@epxing/core/src/api'
-import ensureRemoteDeps from '@epxing/core/src/remote-deps'
-import { registerLegacySelectStyles } from './vue2-select-style-compat'
-
-// 同一个系统正在加载中的 Promise。结果缓存（window.loadSystemLibrarys）要等
-// listWebpackUrl 回来且所有 js/css 都落地后才写入，这中间若不复用，并发调用方
-// （路由守卫重跑、多个 epx-page 同时挂载）会各自再发一次 listWebpackUrl 并重复
-// 执行产品库脚本；产品库 install 里带 router.replace，于是又反过来触发守卫重跑。
-const loadingLibrarys = {}
-
-export default function (params) {
-  if (!window.loadSystemLibrarys) window.loadSystemLibrarys = {}
-  if (window.loadSystemLibrarys[params.busiSystemCode]) return Promise.resolve(window.loadSystemLibrarys[params.busiSystemCode])
-  if (loadingLibrarys[params.busiSystemCode]) return loadingLibrarys[params.busiSystemCode]
-  const promise = loadLibrary(params)
-    .then(data => {
-      delete loadingLibrarys[params.busiSystemCode]
-      return data
-    })
-  loadingLibrarys[params.busiSystemCode] = promise
-  return promise
-}
-
-function loadLibrary (params) {
-  return new Promise(resolve => {
-    http.get({
-      action: 'listWebpackUrl',
-      entityId: 'FM_SYSTEM_WEBPACK',
-      ...params
-    })
-      .then(data => {
-        // 记录加载前各库的引用快照。webpack UMD 每次执行都会给 window.library[name]
-        // 赋一个新对象引用,所以用「引用是否变化」来定位本次真正加载的产品库,
-        // 既能识别新注册的库,也能识别 key 已存在但被重新加载的库,
-        // 避免 util 里因 isEqual(cloneDeep 丢失函数) 失效而把上一个产品的库串过来
-        const beforeRefs = { ...(window.library || {}) }
-        const finish = () => {
-          const lib = window.library || {}
-          const changed = Object.keys(lib).filter(k => lib[k] && lib[k] !== beforeRefs[k])
-          const chosen = changed.map(k => lib[k]).find(l => l.version) ||
-            (changed.length && lib[changed[0]]) || {}
-          window.loadSystemLibrarys[params.busiSystemCode] = chosen
-          resolve(chosen)
-        }
-        let fileLength = 0
-        let loadFile = 0
-        const jsFiles = []
-        data.entitys.forEach(item => {
-          item.path.forEach(file => {
-            if (!file.includes('https://') && !file.includes('http://')) file = `${window.IP.slice(0, window.IP.length - 1)}${file}`
-            fileLength++
-            if (/\.js$/.test(file)) {
-              // 加载池
-              jsFiles.push(file)
-            } else if (/\.css$/.test(file)) {
-              util.loadCss({
-                url: file,
-                callback: () => {
-                  registerLegacySelectStyles(file)
-                  loadFile++
-                  if (fileLength === loadFile) finish()
-                }
-              })
-            } else {
-              loadFile++
-            }
-          })
-        })
-        if (jsFiles.length > 0) {
-          // 先把这些远程 JS 要用到的懒加载平台组件备好，再开始串行加载（见 core/remote-deps.js）。
-          // ⚠️ 这条链上的两个 catch 都不能省：本函数返回的 Promise 是路由守卫里 await 的
-          //    （router/config.js 的 loadLibrary 调用点），一旦有 rejection 逃逸，外层
-          //    new Promise 永不 resolve → 守卫卡死 → 白屏。改造前这段逻辑在 http.get 的
-          //    .then 内部，同步抛错会落进下面那个 .catch(resolve)，是有保护的；搬到这个游离的
-          //    .then 里就失去了。「绝不因自动 ensure 白屏」不该押在 remote-deps 的实现细节上。
-          ensureRemoteDeps(jsFiles).catch(() => {}).then(() => {
-            let loadIndex = 0
-            const cb = () => {
-              if (fileLength === ++loadFile) finish()
-              loadIndex++
-              if (loadIndex < jsFiles.length) {
-                util.loadJs(jsFiles[loadIndex], cb)
-              }
-            }
-            util.loadJs(jsFiles[loadIndex], cb)
-          }).catch(err => {
-            console.error(err)
-            finish()
-          })
-        }
-        if (fileLength === loadFile) finish()
-      })
-      .catch(err => {
-        console.error(err)
-        resolve()
-      })
-  })
-}
+import util from '@epxing/core/src/runtime-utils/util'
+import http from '@epxing/core/src/api'
+import ensureRemoteDeps from '@epxing/core/src/remote-deps'
+import { registerLegacySelectStyles } from './vue2-select-style-compat'
+
+// 同一个系统正在加载中的 Promise。结果缓存（window.loadSystemLibrarys）要等
+// listWebpackUrl 回来且所有 js/css 都落地后才写入，这中间若不复用，并发调用方
+// （路由守卫重跑、多个 epx-page 同时挂载）会各自再发一次 listWebpackUrl 并重复
+// 执行产品库脚本；产品库 install 里带 router.replace，于是又反过来触发守卫重跑。
+const loadingLibrarys = {}
+
+export default function (params) {
+  if (!window.loadSystemLibrarys) window.loadSystemLibrarys = {}
+  if (window.loadSystemLibrarys[params.busiSystemCode]) return Promise.resolve(window.loadSystemLibrarys[params.busiSystemCode])
+  if (loadingLibrarys[params.busiSystemCode]) return loadingLibrarys[params.busiSystemCode]
+  const promise = loadLibrary(params)
+    .then(data => {
+      delete loadingLibrarys[params.busiSystemCode]
+      return data
+    })
+  loadingLibrarys[params.busiSystemCode] = promise
+  return promise
+}
+
+function loadLibrary (params) {
+  return new Promise(resolve => {
+    http.get({
+      action: 'listWebpackUrl',
+      entityId: 'FM_SYSTEM_WEBPACK',
+      ...params
+    })
+      .then(data => {
+        // 记录加载前各库的引用快照。webpack UMD 每次执行都会给 window.library[name]
+        // 赋一个新对象引用,所以用「引用是否变化」来定位本次真正加载的产品库,
+        // 既能识别新注册的库,也能识别 key 已存在但被重新加载的库,
+        // 避免 util 里因 isEqual(cloneDeep 丢失函数) 失效而把上一个产品的库串过来
+        const beforeRefs = { ...(window.library || {}) }
+        const finish = () => {
+          const lib = window.library || {}
+          const changed = Object.keys(lib).filter(k => lib[k] && lib[k] !== beforeRefs[k])
+          const chosen = changed.map(k => lib[k]).find(l => l.version) ||
+            (changed.length && lib[changed[0]]) || {}
+          window.loadSystemLibrarys[params.busiSystemCode] = chosen
+          resolve(chosen)
+        }
+        let fileLength = 0
+        let loadFile = 0
+        const jsFiles = []
+        data.entitys.forEach(item => {
+          item.path.forEach(file => {
+            if (!file.includes('https://') && !file.includes('http://')) file = `${window.IP.slice(0, window.IP.length - 1)}${file}`
+            fileLength++
+            if (/\.js$/.test(file)) {
+              // 加载池
+              jsFiles.push(file)
+            } else if (/\.css$/.test(file)) {
+              util.loadCss({
+                url: file,
+                callback: () => {
+                  registerLegacySelectStyles(file)
+                  loadFile++
+                  if (fileLength === loadFile) finish()
+                }
+              })
+            } else {
+              loadFile++
+            }
+          })
+        })
+        if (jsFiles.length > 0) {
+          // 先把这些远程 JS 要用到的懒加载平台组件备好，再开始串行加载（见 core/remote-deps.js）。
+          // ⚠️ 这条链上的两个 catch 都不能省：本函数返回的 Promise 是路由守卫里 await 的
+          //    （router/config.js 的 loadLibrary 调用点），一旦有 rejection 逃逸，外层
+          //    new Promise 永不 resolve → 守卫卡死 → 白屏。改造前这段逻辑在 http.get 的
+          //    .then 内部，同步抛错会落进下面那个 .catch(resolve)，是有保护的；搬到这个游离的
+          //    .then 里就失去了。「绝不因自动 ensure 白屏」不该押在 remote-deps 的实现细节上。
+          ensureRemoteDeps(jsFiles).catch(() => {}).then(() => {
+            let loadIndex = 0
+            const cb = () => {
+              if (fileLength === ++loadFile) finish()
+              loadIndex++
+              if (loadIndex < jsFiles.length) {
+                util.loadJs(jsFiles[loadIndex], cb)
+              }
+            }
+            util.loadJs(jsFiles[loadIndex], cb)
+          }).catch(err => {
+            console.error(err)
+            finish()
+          })
+        }
+        if (fileLength === loadFile) finish()
+      })
+      .catch(err => {
+        console.error(err)
+        resolve()
+      })
+  })
+}

package/src/menu-route.js

@@ -87,12 +87,23 @@ export function effectiveRouteName (name) {
   return MENU_ROUTE_ALIAS[name] || name
 }
 
-// 由当前路由 + menuKey 生成菜单直达位置（保留 client/system/app；不带 role——role 在 storage）。
+// 配置中心兼容旧的查询参数链接，新链接统一使用菜单路径段。
+export function getRouteMenuKey (route) {
+  const key = route.params?.menuKey || (effectiveRouteName(route.name) === 'system' ? route.query?.menuKey : '')
+  return typeof key === 'string' ? key : ''
+}
+
+// 生成菜单直达位置；角色通过已有持久化机制恢复，兼容旧地址中的角色段。
 // query 传了则整体替换（页面参数进 URL，刷新/分享自然保留，页面从 $route.query 读），
 // 不传沿用当前 URL 的 query。
 export function menuLocation (route, key, query) {
   const q = query !== undefined ? query : route.query
   const { client, system, app } = route.params || {}
+  if (effectiveRouteName(route.name) === 'system') {
+    const systemQuery = { ...q }
+    delete systemQuery.menuKey
+    return { name: 'system', params: { client, system, menuKey: key }, query: systemQuery }
+  }
   if (effectiveRouteName(route.name) === 'hall') {
     return { name: 'hallMenu', params: { client, menuKey: key }, query: q }
   }