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

package/src/mixins/component.js

@@ -1,1461 +1,1464 @@
-/* eslint-disable no-eval */
-/* eslint-disable no-unused-vars */
-// 组件实例
-import { mapState, mapGetters } from 'vuex'
-import { evalWith } from '@epxing/utils/src/eval-with'
-import { CREATE_TAB } from '@epxing/core/src/store/actions'
-import util from '@epxing/core/src/runtime-utils/util'
-import { isSafeFn } from '@epxing/utils/src/security'
-import { isCustomOption } from './custom-option'
-// 纯函数层，零依赖（见 menu-route.js 头注释），不会与 router/store 成环
-import { resolveRouteRole } from '@epxing/core/src/menu-route'
-// 条件初始化：与 global.js / methods-to-prototype.js 共享同一个弹窗栈，
-// 无条件重置会让先求值模块捕获的引用变成孤儿数组
-if (!window.openedPopup) {
-  window.openedPopup = []
-}
-const openedPopup = window.openedPopup
-
-/**
- * ⚙️ T17 修复轮 1（评审 C2）——**一行开关**：keep-alive 剪枝/页签销毁这条路径上要不要执行
- * 用户脚本 `onDestory`（设计器事件面板里的「组件销毁时」，见 designer/src/visual/config/Event.vue）。
- *
- *   false（当前值）= 保持 Task 17 之前的可观察语义：这条路径**不**触发 onDestory。
- *   true           = 放开，让这些脚本随真卸载开始执行。
- *
- * 为什么默认 false：Task 17 的目标是内存修复，不是行为变更。真卸载唤醒了成千上万个此前从未跑过的
- * `unmounted`，其中就包括这个**面向低代码用户脚本的逃逸口**——线上页面配置里可能已经存在
- * 从迁到 Vue 3 之后一次都没执行过的 onDestory 脚本，它们可以 $store.commit / $bus.off / 写 window /
- * 发请求 / 跳转，内容不可静态判定、也没有任何人验证过。让它们在一次内存修复里**顺带开始跑**，
- * 属于带风险的范围蔓延。放开前必须先盘点存量配置（FM_PAGE_CONFIG 里 componentEvents.onDestory
- * 非空的有多少、分别写了什么），再灰度。
- *
- * 注意作用域：这个开关**只**管"整棵页面树被销毁"这条路径。页面还活着、只是某个组件被 v-if 摘掉
- * 之类的单点卸载，onDestory 照常执行（那条路径在 Task 17 之前本来就在跑，不能反向改掉）。
- */
-const EXEC_ON_DESTORY_ON_TEARDOWN = false
-
-/**
- * 沿 parent 链找 RouterView 打的 `_epxTeardown` 标记（在 RouterView 的 removeKeepAliveCache /
- * beforeUnmount 里打），用来区分"整棵页面树被销毁"与"页面还活着、单个组件被摘掉"。
- * 不能用"父实例 scope 是否已 stop"来判：unmountComponent 的顺序是
- * 「bum → scope.stop() → 递归卸载子树 → queuePostRenderEffect(um)」，而被剪枝页面的父级是
- * KeepAlive，它的 scope 在那一刻仍然 active，判据在最要紧的那一层恰好失效。
- */
-function isEpxTeardown (inst) {
-  let p = inst
-  let guard = 0
-  while (p && guard++ < 500) {
-    if (p._epxTeardown === true) return true
-    p = p.parent
-  }
-  return false
-}
-
-// T31：改组件注册表（page._epxReg，替代 $children 树遍历，Vue3 无 $children）。
-// this = 页面实例（调用方 apply 到 $parentPage/页面）。
-function broadcast (id, eventName, ...params) {
-  const reg = this && this._epxReg
-  if (!reg) return
-  const child = reg.byId.get(id)
-  if (child && child[eventName]) child[eventName].apply(child, params)
-}
-function broadcastCom (componentName, eventName, params) {
-  const reg = this && this._epxReg
-  if (!reg) return
-  const set = reg.byName.get('epx-' + componentName)
-  if (set) for (const child of set) child.$emit.apply(child, [eventName].concat(params))
-}
-function getComponentById (id) {
-  const reg = this && this._epxReg
-  return reg ? reg.byId.get(id) : undefined
-}
-
-function findNavId (menus = [], menuId, parent) {
-  for (let i = 0; i < menus.length; i++) {
-    const menu = menus[i]
-    if (menu.ID === menuId) {
-      return { ...menu, parentMenu: parent }
-    } else {
-      if (menu.children) {
-        const activeMenu = findNavId(menu.children, menuId, menu)
-        if (activeMenu) return activeMenu
-      }
-    }
-  }
-}
-
-function appendCss (id, css) {
-  let style = document.createElement('style')
-  style.id = 'style_' + id
-  style.textContent = css.replace(/:current/g, '.css_' + id).replace(/url\s*\(([\w+-/.\s]+)\)/g, (str, $1) => {
-    return `url(${util.getFileUrl($1)})`
-  })
-
-  style.setAttribute('type', 'text/css')
-  document.head.appendChild(style)
-  style = null
-}
-function removeCss (id) {
-  let element = document.getElementById('style_' + id)
-  if (element) {
-    document.head.removeChild(element)
-    element = null
-  }
-}
-export default {
-  $componentType: 'component',
-  // T33（关 compat 同刻翻转）：
-  //
-  // 为什么最终要 true：Vue2 里 `inheritAttrs: false` **不管 class/style** —— 它们走
-  // `$vnode.data.staticClass/class`，无条件落到根元素。Vue3 把 class/style 并进了 attrs，
-  // false 会把它们一起挡掉 → 父传的 class 全丢。recon-classloss.mjs 实测：**20 个组件**受影响。
-  //
-  // 为什么不能提前翻：compat 开着时 Vue2 语义已经让 class 落根了，此时翻成 true 只剩副作用——
-  // 未声明的级联属性被序列化成 DOM attribute，**渲染直接断**（实测：应用开发平台左侧菜单
-  // 92 项 → 0 项，且 errors×0 静默失败；commit 1e2ab4f1c 当时测到的 "元素 1642→702" 同因）。
-  // ⇒ 与 `.native` 一样，语义在开关翻转前后互斥，只能同一刻改。
-  //
-  // 翻转时的配套（见 .claude/codemod/codemod-forward-attrs.mjs）：
-  //   1. 转发给子组件的 `$attrs` 已剔掉 class/style（`$forwardAttrs`），否则容器根上的 class
-  //      会被复制到它的每个子组件上；✅ 已完成
-  //   2. 级联下发的 currentRoute / pageInfo / queryParams 已上提为 props；✅ 已完成
-  //   3. 透明代理组件（epx-component / widget-preview）保留自己的 `inheritAttrs: false` +
-  //      原样转发 `$attrs` —— 它们没有自己的根，class 要送到所渲染的叶子组件上。✅ 已完成
-  //   4. 翻转后仍会有未声明的级联属性落到根（如 currentQuery / inline）→ 那一刀时按实测逐个声明。
-  inheritAttrs: true,
-  navConfigs: {
-    flag: false
-  },
-
-  props: {
-    // 当前页面信息
-    page: {
-      type: Object
-    },
-    // 当前对象元数据信息
-    meta: {
-      type: Object,
-      default () {
-        return {}
-      }
-    },
-    compId: {
-      type: [String, Number]
-    }, // 组件id
-    contentType: String, // 模板名称
-    _component: {
-      type: Object,
-      default () {
-        return {}
-      }
-    },
-    compStyle: {
-      type: Object,
-      default () {
-        return {}
-      }
-    }, // 组件样式
-    compConfigs: {
-      type: Object,
-      default () {
-        return {}
-      }
-    },
-    compFlex: {
-      type: Boolean
-    },
-    compTitle: String,
-    items: Array, //
-    itemConfigs: Object,
-    metaId: String,
-    // 以下三个由 epx-component / epx-page 沿 $attrs 级联下发，此前无人声明 → 停在 $attrs 里。
-    // Vue3 的 $attrs 含 class/style，将来把 inheritAttrs 打开（让父传的 class 落到 root）时，
-    // 未声明的属性会被序列化成 DOM attribute（对象值变 "[object Object]"）。声明成 props 即被消费掉。
-    // 详见 T30b-compat-warning-census.md「INSTANCE_ATTRS 否定结果被推翻」一节。
-    currentRoute: Object,
-    pageInfo: Object,
-    // Component.vue 给**每个** leaf 都绑 :query-params，但只有 EntityList 自己声明了它
-    // （同形状 Object/default {}，合并无冲突）。核对过：无 mixin 使用者把 queryParams 写在
-    // data() 或 computed 里，故可安全上提。formData 则不行——有 6 个使用者写在 data()。
-    queryParams: {
-      type: Object,
-      default () {
-        return {}
-      }
-    }
-  },
-  data () {
-    return {
-      pageConfig: {},
-      $defaultConfigs: {},
-      httpLoading: {},
-      component: {},
-      configs: {}
-    }
-  },
-  inject: {
-    pageId: {
-      type: String,
-      default: null
-    },
-    pageMetaId: {
-      type: String,
-      default: null
-    },
-    // T31：最近的 epx 父容器（provide 下发），mounted 注册进其 _epxChildren 支撑子树遍历
-    _epxParentComp: {
-      default: null
-    },
-    upPage: {
-      type: Object,
-      default: () => null
-    },
-    // 获取所属标签页
-    $getTab: {
-      type: Function,
-      default: null
-    },
-    template: {
-      type: Object,
-      default: null
-    },
-    createRoute: {
-      default: null
-    },
-    destoryRoute: {
-      default: null
-    },
-    reloadRoute: {
-      default: null
-    }
-  },
-  /**
-   * 向下传递页面实例和模板
-   *
-   * 设计说明：
-   * 1. 页面组件（isPage=true）在 BasePage.vue 中提供 upPage，这里不需要重复提供
-   * 2. 非页面组件需要继续向下传递 upPage，确保所有子组件都能访问到页面实例
-   *
-   * 为什么需要 inject 后再 provide？
-   * - Vue 的 provide/inject 是单向的，只向下传递，不会自动向上查找
-   * - 如果中间某个组件不 provide，其子组件将无法获取 upPage（即使祖先组件提供了）
-   * - 通过在 mixin 中统一处理，确保所有组件都能自动传递，避免遗漏
-   *
-   * 这种模式被称为"透传"（pass-through），是 Vue provide/inject 的常见用法
-   * 优点：
-   * - 统一在 mixin 中处理，所有组件自动继承，无需手动处理
-   * - 确保页面实例能够传递到任意深度的子组件
-   * - 避免因中间组件忘记 provide 而导致子组件无法获取的问题
-   */
-  provide () {
-    // T31：每 epx 组件把自己作为「最近 epx 父容器」下发，子组件 mounted 时注册进 _epxChildren，
-    // 支撑子树级遍历（Card.refesh/AddForm 容器子收集，替代 $children 递归）。
-    const base = { _epxParentComp: this }
-    // 页面组件已经在 BasePage.vue 中提供了 upPage，这里不需要重复提供
-    // 非页面组件需要继续向下传递，确保子组件能够访问到页面实例
-    if (!this.isPage) {
-      base.upPage = this.upPage // 透传页面实例
-      base.template = this.template // 透传模板
-    }
-    // T28：Vue3 的 provide 合并不容忍 undefined 返回值
-    return base
-  },
-  computed: {
-    ...mapState({
-      appMenus: state => state.config.appMenus,
-      $screen: state => state.config.screen || {}, // 屏幕信息
-      $tabs: state => state.tabs.tabs, // 标签页
-      metas: state => state.meta.metas, // 元数据信息集合
-      user: state => state.user.user, // 用户信息
-      componentGlobalConfig: state => state.config.componentGlobalConfig, // 组件全局配置
-      systemComponentGlobalConfig: state => state.config.systemComponentGlobalConfig, // 组件全局配置
-      currentMenu: state => state.config.currentMenu // 当前导航菜单
-    }),
-    ...mapGetters([
-      'getMeta',
-      'getPageById'
-    ]),
-    CLIENT () {
-      const { CLIENT: queryClient } = this.$query
-      const { CLIENT: tabClient } = this.$tab
-      const { client: routeClient } = this.$route.query
-      const { client: userClient } = this.user
-      const { CLIENT: appClient, 'CLIENT|ID': clientId } = this.appConfig
-      return queryClient || tabClient || routeClient || userClient || appClient || clientId
-    },
-    SYSTEM () {
-      const { SYSTEM: querySystem } = this.$query
-      const { SYSTEM: tabSystem } = this.$tab
-      const { system: routeSystem } = this.$route.query
-      const { configSystem = {} } = this.$store.state.config
-      const { SYSTEM: appSystem, 'SYSTEM|ID': systemId } = this.appConfig
-      return querySystem || tabSystem || routeSystem || configSystem.ID || appSystem || systemId
-    },
-    APP () {
-      const { APP: queryApp } = this.$query
-      const { APP: tabApp } = this.$tab
-      return queryApp || tabApp
-    },
-    $tab () {
-      if (this.$getTab) return this.$getTab()
-      return this.$activeTab || {}
-    },
-    /**
-     * 选中标签页
-     */
-    $activeTab () {
-      return this.$tabs.find(item => item.active) || {}
-    },
-    $tabQuery () {
-      return this.$tabs.find(item => item.active) || {}
-    },
-    isPage () {
-      const { $componentType } = this.$options
-      return $componentType === 'page'
-    },
-    /**
-       * 当前页面参数
-       */
-    $query () {
-      // 获取该组件是否是页面
-      // 获取路由参数
-      // 当前路由不是登录页
-      const routeQuery = {}
-      const { name, query = {}, params = {} } = this.$route || {}
-      if (name !== 'hallLogin' && name !== 'login') {
-        for (const key in query) {
-          if (query[key]) routeQuery[key] = query[key]
-        }
-        for (const key in params) {
-          if (params[key]) routeQuery[key] = params[key]
-        }
-      }
-      if (!this.$_.isEmpty(this.currentQuery)) {
-        const currentQuery = this.currentQuery || {}
-        return { ...routeQuery, ...currentQuery }
-      } else {
-        // 获取上级页面
-        if (this.upPage) {
-          const currentQuery = this.upPage.currentQuery || {}
-          return { ...routeQuery, ...currentQuery, ...(this.upPage.pageParams || {}) }
-        }
-        return routeQuery
-      }
-    },
-    $configVersion () {
-      const queryPageConfigs = this.$query.pageConfigs || {}
-      const { config = queryPageConfigs } = this.$pageInfo
-      return config.version
-    },
-    getComponentId () {
-      return component => {
-        const queryPageConfigs = this.$query.pageConfigs || {}
-        const { config = queryPageConfigs } = this.$pageInfo
-        if (!this.isPage && !config.version) {
-          const { id } = this.$component
-          return id + '-' + component.id
-        }
-        return component.id
-      }
-    },
-    $component: {
-      get () {
-        return this.component
-      },
-      set (v) {
-        this.component = v
-      }
-    },
-    $subcomponents () {
-      const { items } = this.$component
-      // 判断是否迭代
-      return this.$formatComponents(items, this._component) || []
-    },
-    $compData () {
-      const iterator = this._component.iterator || {}
-      return { ...iterator, $templateVariables: this.$templateVariables }
-    },
-    $configs: {
-      get () {
-        // 格式化内容
-        const _configs = {}
-        // 动态参数的取值来源建**一次**就够。$formatContent 的默认参数是
-        // `{ ...$tab, ...pageParams, ...$query, ...$compData }`，而默认参数是**每次调用都求值**的——
-        // 原先这里逐个字符串键调用，一个组件有多少个字符串配置就重建多少遍同一个对象。
-        // 实测（.claude 微基准，28 个字符串键）：合并对象 324 µs、两遍正则只要 28 µs，
-        // 也就是说这条路径 92% 的开销花在重复构造上，提出来能砍掉约九成。
-        //
-        // ⚠️ 必须**惰性**构造，不能提到循环外无条件建：那样 getter 会无条件依赖
-        // $tab/$query/$compData，连一个字符串配置都没有的组件也会在路由参数变化时失效重算，
-        // 平白多出依赖边。惰性构造与原先「首次调用 $formatContent 时才求值」的依赖集完全一致。
-        let data
-        for (const key in this.configs) {
-          const item = this.configs[key]
-          if (typeof item === 'string') {
-            if (data === undefined) {
-              data = { ...this.$tab, ...(this.upPage?.pageParams || {}), ...this.$query, ...this.$compData }
-            }
-            _configs[key] = this.$formatContent(item, data)
-          } else if (/operates$/i.test(key)) {
-            // 按钮文案统一走界面文案翻译，覆盖组件内置的默认按钮（含运行时注入的默认操作）
-            _configs[key] = this.$translateOperates(item)
-          } else {
-            _configs[key] = this.configs[key]
-          }
-        }
-        return _configs
-      },
-      set (v) {
-        this.configs = v
-      }
-    },
-    // 当前页面id
-    $pageMetaId () {
-      // 获取当前传递的metaId
-      let metaId = null
-      if (this.meta && this.meta.id) {
-        metaId = this.meta.id
-      }
-      return metaId || this.pageMetaId
-    },
-    /**
-     * 当前组件对象元数据id 不设置 默认为当前页面对象
-     */
-    $metaId () {
-      const { metaId } = this.$configs
-      return this.metaId || metaId || this.$pageMetaId || this.$query.metaId
-    },
-    // 当前组件对象
-    $meta () {
-      if (this.$metaId) {
-        const meta = this.getMeta(this.$metaId)
-        return meta
-      } else {
-        return null
-      }
-    },
-    $metaKey () {
-      if (this.$meta) {
-        return this.$meta.getKey() || 'ID'
-      } else {
-        return 'ID'
-      }
-    },
-    $parentPage () {
-      // 父级页面
-      const { parentPage } = this.component
-      return parentPage
-    },
-    $parentPageModel () {
-      const { parentPage = {} } = this.component
-      return parentPage.model
-    },
-    $pageId () {
-      const { pageId } = this.page || {}
-      return this.isPage ? pageId : this.pageId || pageId
-    },
-    $pageInfo () {
-      if (this.$pageId) return this.getPageById(this.$pageId) || {}
-
-      return this.page || (!this.isPage && this.upPage && this.upPage.page) || {}
-    },
-    $pageParams () {
-      if (this.isPage) return this.pageParams || {}
-      else if (this.upPage) return this.upPage.pageParams || {}
-      return {}
-    },
-    $templateVariables () {
-      return this.template?.variables || {}
-    },
-    /**
-     * 事件处理总线
-     */
-    $event () {
-      const vm = this
-      let comp = vm
-      while (comp.$parent && comp.$options.$componentType !== 'page') comp = comp.$parent
-      return {
-        emit (event, ...params) {
-          // T25：程序化通道走 $epxEmit（Vue3 无实例事件）；$emit 保留给模板 @listener
-          comp.$epxEmit(event, [...params])
-          comp.$emit(event, [...params])
-        },
-        on (event, callback) {
-          const handler = params => callback.apply(comp, params)
-          comp.$epxOn(event, handler)
-          // 记录在组件实例上，beforeDestroy 时解除绑定
-          if (!vm._pageEventHandlers) vm._pageEventHandlers = []
-          vm._pageEventHandlers.push({ comp, event, handler })
-        }
-      }
-    },
-    $currentRole () {
-      // 菜单直达路由（appMenu/hallMenu）没有 role 段，URL 末段是 menuKey——直接读
-      // $route.params.role 会得到 undefined，$currentRole 恒为 {}。页面配置的 showIf
-      // 表达式里也拿得到 $currentRole（见下方 elData），空值会让按角色显示的节点全部消失。
-      const role = resolveRouteRole(this.$route)
-      const { serviceRoles = {} } = this.user
-      const roleList = serviceRoles[this.appConfig.ID] || []
-      let roleCode = role
-      if (role && role.endsWith('-client')) {
-        roleCode = role.replace(/-client$/, '')
-        // 从通用角色获取
-        return roleList.find(item => item.code === roleCode && item.type === 'client') || {}
-      } else {
-        return roleList.find(item => item.code === roleCode && item.type !== 'client') || {}
-      }
-    },
-    $currentRoleId () {
-      return this.$currentRole.id
-    }
-  },
-  watch: {
-    compConfigs (v) {
-      if (!this.$_.isEqual(this.oldCompConfigs, v)) {
-        this._createComponent()
-      }
-      this.oldCompConfigs = this.$_.cloneDeep(v)
-    }
-  },
-  methods: {
-    // ========== T31 组件注册表（替代 $children 树遍历）==========
-    // 页面级作用域：注册表挂在页面组件（isPage）上，非页面组件经 upPage 就近找页面注册。
-    _epxPage () {
-      if (this.isPage) return this
-      const inst = this.upPage && this.upPage.instance
-      return inst || null
-    },
-    _epxRegistry (page) {
-      const p = page || this._epxPage()
-      if (!p) return null
-      if (!p._epxReg) p._epxReg = { byId: new Map(), byName: new Map() }
-      return p._epxReg
-    },
-    _epxRegister () {
-      // 页面级注册表（broadcast/getComponentById 用）
-      const reg = this._epxRegistry()
-      if (reg) {
-        if (this.compId != null) reg.byId.set(this.compId, this)
-        const name = this.$options.name
-        if (name) {
-          let set = reg.byName.get(name)
-          if (!set) { set = new Set(); reg.byName.set(name, set) }
-          set.add(this)
-        }
-      }
-      // 父子注册（子树遍历用，Card.refesh/AddForm 容器）：注册进最近 epx 父容器
-      const parent = this._epxParentComp
-      if (parent && parent !== this) {
-        if (!parent._epxChildren) parent._epxChildren = new Set()
-        parent._epxChildren.add(this)
-      }
-    },
-    _epxDeregister () {
-      const page = this._epxPage()
-      if (page && page._epxReg) {
-        const reg = page._epxReg
-        if (this.compId != null && reg.byId.get(this.compId) === this) reg.byId.delete(this.compId)
-        const name = this.$options.name
-        const set = name && reg.byName.get(name)
-        if (set) set.delete(this)
-      }
-      const parent = this._epxParentComp
-      if (parent && parent._epxChildren) parent._epxChildren.delete(this)
-    },
-    // T31：遍历子树内 epx 组件（含深层后代，递归 _epxChildren），cb(comp)。替代 $children 递归。
-    _epxWalkChildren (cb) {
-      const stack = this._epxChildren ? [...this._epxChildren] : []
-      while (stack.length) {
-        const c = stack.pop()
-        if (!c) continue
-        cb(c)
-        if (c._epxChildren) for (const gc of c._epxChildren) stack.push(gc)
-      }
-    },
-    $formatComponents (arr, component = this._component) {
-      const { iterator: compIterator } = component
-      const queryPageConfigs = this.pageConfig || this.$query.pageConfigs || {}
-      const { config: pageConfigs = queryPageConfigs } = this.$pageInfo
-      const itemConfigs = pageConfigs.itemConfigs || {}
-      const page = this.upPage || this
-      const components = []
-      if (!arr) return []
-      for (const item of arr) {
-        const { configs = {}, id } = item
-        const compConfigs = itemConfigs[id] || {}
-        const allConfigs = { ...compConfigs, ...configs }
-        const { iterator, showIf, showTerminal } = allConfigs
-        const terminal = this.$isMobile ? 'mobile' : 'pc'
-        if (!showTerminal || showTerminal.includes(terminal)) {
-          if (iterator?.data) {
-            const { data, name = 'item', key = 'ID', index = 'index' } = iterator
-            let iteratorData = []
-            if (Array.isArray(data)) {
-              iteratorData = data
-            } else {
-              const matches = /^\$\[([\w.|$-]+)\]$/.exec(data)
-              if (matches) {
-                const data = { ...this.$tab, ...(page.pageParams || {}), ...this.$query, ...this.$compData, ...(compIterator || {}), template: this.template, $templateVariables: this.$templateVariables }
-                iteratorData = this.$util.getValueByPath(matches[1], data)
-              }
-            }
-            if (iteratorData && Array.isArray(iteratorData)) {
-              for (let i = 0; i < iteratorData.length; i++) {
-                const data = iteratorData[i]
-                const iteratorKey = data[key] || i
-                if (showIf) {
-                  const elData = { user: this.user, $currentRole: this.$currentRole, $tab: this.$tab, ...this.$query, ...this.$pageParams, ...(compIterator || {}), [name]: data, [index]: i, key: iteratorKey, template: this.template, $templateVariables: this.$templateVariables }
-                  if (typeof showIf === 'object') {
-                    if (showIf.el && !util.evalExpression(showIf.el, elData)) {
-                      continue
-                    }
-                  } else {
-                    if (!util.evalExpression(showIf, elData)) {
-                      continue
-                    }
-                  }
-                }
-                const component = { ...item, key: item.id + '-' + iteratorKey, iterator: { ...(compIterator || {}), [name]: data, [index]: i, key: iteratorKey } }
-                if (item.type === 'template') {
-                  components.push(component)
-                } else {
-                  components.push(component)
-                }
-              }
-            }
-          } else {
-            const elData = { user: this.user, $currentRole: this.$currentRole, $tab: this.$tab, ...this.$query, ...this.$pageParams, ...(compIterator || {}), template: this.template, $templateVariables: this.$templateVariables }
-            if (showIf) {
-              if (typeof showIf === 'string' && !util.evalExpression(showIf, elData)) {
-                continue
-              } else if (showIf.el && !util.evalExpression(showIf.el, elData)) {
-                continue
-              }
-            }
-            const component = compIterator ? { ...item, iterator: compIterator } : { ...item }
-            component.key = component.id
-            if (item.type === 'template') {
-              components.push(component)
-            } else {
-              components.push(component)
-            }
-          }
-        }
-      }
-      return components
-    },
-    $formatContent (content, data = { ...this.$tab, ...(this.upPage?.pageParams || {}), ...this.$query, ...this.$compData }) {
-      if (!content) return content
-      // 当内容整体以 {{ 开头、}} 结尾时，直接返回表达式执行结果，避免 replace 将对象类型强制转换为字符串
-      const fullMatch = content.match(/^\s*\{\{([\w-.,:?+\s|$#[/\]()"']+)\}\}\s*$/)
-      if (fullMatch) {
-        try {
-          // 表达式执行失败时保留原内容，占位符可继续交由下面的 $[...] 分支按实例上下文解析
-          return this.$util.evalExpression(fullMatch[1], data, content)
-        } catch (error) {
-          return content
-        }
-      }
-      return content.replace(/\{\{([\w-.,:?+\s|$#[/\]()"']+)\}\}/g, (macth, key) => {
-        try {
-          // 执行表达式，失败时保留原占位符
-          return this.$util.evalExpression(key, data, macth)
-        } catch (error) {
-          return `{{${key}}}`
-        }
-      }).replace(/\$\[([\w-.|$#]+)\]/g, (macth, key) => {
-        try {
-          const value = this.$util.getValueByPath(key, this) || this.$util.getValueByPath(key, data)
-          return this.$_.isNil(value) ? '' : value
-        } catch (error) {
-          return `$[${key}]`
-        }
-      })
-    },
-    /**
-     * 翻译按钮文案。组件代码内置的默认按钮（如「保存」「返回」）不在页面配置里，
-     * 服务端配置投影覆盖不到，只能走界面文案通道：以中文原文为 key 调 $t。
-     * 页面里配置出来的按钮文案已由服务端投影翻好，$t 未命中会原样返回 key，
-     * 因此对它们无副作用，重复调用也是幂等的。
-     * 按原数组缓存结果，保证同一份配置每次拿到的引用不变。
-     */
-    $translateOperates (operates) {
-      // 组件库脱离 i18n 插件单独使用时不做翻译，避免影响渲染主链路
-      if (!Array.isArray(operates) || !this.$i18n || typeof this.$t !== 'function') return operates
-      const cache = this._operatesI18nCache || (this._operatesI18nCache = new WeakMap())
-      if (cache.has(operates)) return cache.get(operates)
-      let translated = false
-      const result = operates.map(operate => {
-        if (!operate || typeof operate !== 'object') return operate
-        const { text } = operate
-        if (typeof text !== 'string' || !text) return operate
-        const value = this.$t(text)
-        if (value === text) return operate
-        translated = true
-        return { ...operate, text: value }
-      })
-      // 无一条命中译文时返回原数组，默认语言下等同于未改动
-      const value = translated ? result : operates
-      cache.set(operates, value)
-      return value
-    },
-    /**
-     * 解析 url 中的变量占位符，支持 {{CLIENT}} 和 $[CLIENT] 两种写法
-     * 变量可为实例路径表达式，如 {{$route.params.client}}、{{appConfig['CLIENT']}}
-     * 取值顺序与 $formatParams 一致：组件实例（CLIENT/SYSTEM/APP 等计算属性）→ 标签页/页面参数
-     * 无法解析的占位符保留原样
-     */
-    $formatUrl (url) {
-      if (!url) return url
-      return url.replace(/\{\{([^}]+)\}\}|\$\[((?:[^[\]]|\[[^\]]*\])+)\]/g, (match, curlyKey, bracketKey) => {
-        const key = (curlyKey || bracketKey).trim()
-        try {
-          const value = this.$util.getValueByPath(key, this)
-          if (!this.$_.isNil(value) && value !== '') return value
-          const fallback = this.$util.getValueByPath(key, { ...this.$tab, ...this.$query, ...this.$pageParams, ...this.$compData })
-          return this.$_.isNil(fallback) ? match : fallback
-        } catch (error) {
-          return match
-        }
-      })
-    },
-    $formatScope (scopeParams, data = this.data) {
-      const _scopeParams = this.$_.cloneDeep(scopeParams)
-      const that = this
-      const paramData = { ...this.$tab, ...this.$query, ...this.$pageParams, ...that.$compData }
-      for (const scopeKey in _scopeParams) {
-        const scope = _scopeParams[scopeKey]
-        if (!scope) continue
-        let values = scope.values
-        if (/#\{([\w-.|$#]+)\}/.test(values)) {
-          values = values.replace(/#\{([\w-.|$#]+)\}/, (match, key) => {
-            try {
-              // #{key} 里的 key 是相对组件实例的路径：显式传作用域，不能靠直接 eval 捕获 that（见 eval-with.js）
-              return evalWith(`that.${key}`, { that }) || evalWith(`that.$query.${key}`, { that }) || evalWith(`that.$tab.${key}`, { that }) || ''
-            } catch (error) {
-              return scope.values
-            }
-          })
-        }
-        if (/\$\[([\w-_.|$#]+)\]/.test(values)) {
-          values = values.replace(/\$\[([\w-.|$#]+)\]/, (match, key) => {
-            try {
-              return that.$util.getValueByPath(key, this) || that.$util.getValueByPath(key, paramData) || ''
-            } catch (error) {
-              return scope.values
-            }
-          })
-        }
-        if (/#\[([\w-.|$#]+)\]/.test(values)) {
-          values = values.replace(/#\[([\w-.|$#]+)\]/, (match, key) => {
-            try {
-              return evalWith(`data.${key}`, { data }) || ''
-            } catch (error) {
-              return scope.values
-            }
-          })
-        }
-        if (/\{\{([\w-_.,|$#[\]()"'\s]+)\}\}/g.test(values)) {
-          values = values.replace(/\{\{([\w-.,|$#[\]()"'\s]+)\}\}/g, (macth, key) => {
-            try {
-              // 执行表达式
-              return this.$util.evalExpression(key, paramData)
-            } catch (error) {
-              return `{{${key}}}`
-            }
-          })
-        }
-        scope.values = values
-        if (scope.scopeParams) {
-          scope.scopeParams = this.$formatScope(scope.scopeParams, data)
-        }
-      }
-      return _scopeParams
-    },
-    goWebLink (config) {
-      const { webLinkUrl } = config
-      if (!webLinkUrl) return
-      window.open(this.$formatUrl(webLinkUrl))
-    },
-    async goApp (config, item) {
-      let { serviceId, params = {} } = config
-      // 格式化params
-      const formatParams = this.$formatParams(params, item)
-      if (!serviceId && formatParams.serviceId) serviceId = formatParams.serviceId
-      if (!serviceId) return
-      let app = {}
-      await this.$http.get({
-        entityId: 'FM_SERVICE',
-        id: serviceId
-      })
-        .then(data => {
-          if (data && data.data) {
-            app = data.data
-          }
-        })
-      if (!app.SYSTEM) return
-      this.$http.get({
-        link: 'client',
-        entityId: 'FM_SYSTEM',
-        id: app.SYSTEM
-      })
-        .then(data => {
-          if (data && data.data) {
-            const rootPath = this.$util.getRootPath()
-            let url = `${rootPath}/app/${data.data['CLIENT|CODE']}/${data.data.CODE}/${app.CODE}`
-            // 拼接 query 参数（排除 serviceId 和空值）
-            const queryPairs = []
-            Object.keys(formatParams).forEach(key => {
-              if (key === 'serviceId') return
-              const value = formatParams[key]
-              if (value === undefined || value === null || value === '') return
-              queryPairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
-            })
-            if (queryPairs.length) url += `?${queryPairs.join('&')}`
-            window.open(url)
-          }
-        })
-    },
-    /**
-     * 通用打印
-     */
-    print ({ num = 0, printWay = 'custom', printCode = '', cptName = '', params = {}, ...props }, row) {
-      // 格式化params
-      let selections = []
-      // 检测是否选中元素
-      if (row) {
-        selections = [{ ...row }]
-      } else {
-        if (this.selection) selections = [...this.selection]
-      }
-      if (num !== 0 && num !== '0') {
-        if (selections.length === 0) {
-          this.$message.error(this.$t('please select a record'))
-          return
-        } else if (selections.length > 1) {
-          if (num === 1 || num === '1') {
-            this.$message.error(this.$t('Only one record can be selected'))
-            return
-          }
-        }
-      }
-      // 添加主键
-      if (!params.id) params.id = `#[${this.$metaKey}]`
-      const formatParams = this.$formatParams(params, selections)
-      if (printWay === 'fine') {
-        const ids = selections.map(item => `'${item[this.$metaKey]}'`)
-        formatParams.id = ids.join(',')
-        this.fineReportPrint(cptName, formatParams)
-      } else {
-        this.customReportPrint(printCode, formatParams, props)
-      }
-    },
-    /**
-     * 自定义报表打印方法
-     * @param {String} code 报表编号
-     * @param {Object} params 参数
-     */
-    customReportPrint (code, params, props) {
-      if (params.code) code = params.code
-      this.$http.find({
-        entityId: 'FM_FORM',
-        'scope.CODE': code
-      })
-        .then(data => {
-          const { NAME } = data.data
-          this.$createPage({
-            component: 'excel-preview-page',
-            name: NAME,
-            code,
-            params,
-            openType: props.openMode,
-            ...props
-          })
-        })
-    },
-    fineReportPrint (cptName, params) {
-      const { 'CLIENT|CODE': client } = this.appConfig
-      const rootPath = window.IP + 'report/ReportServer'
-      let query = `?client=${client}&reportlet=com.epxing.frame.core.report.ReportReader&__bypagesize__=false&cptname=${cptName}`
-      for (const key in params) {
-        query += '&' + key + '=' + params[key]
-      }
-
-      const token = this.$util.getToken(client) || ''
-      window.open(rootPath + query + '&token=' + token)
-    },
-
-    /**
-     * 执行自定义JS
-     */
-    executeCustomJs (functionName, ...args) {
-      let pageEvents = {}
-      if (this.isPage) {
-        pageEvents = this.pageEvents
-      } else if (this.template) {
-        pageEvents = this.template.pageEvents
-      } else {
-        pageEvents = this.upPage.pageEvents
-      }
-      if (functionName && pageEvents[functionName]) {
-        const fn = pageEvents[functionName]
-        if (!isSafeFn(fn)) return false
-        return fn.call(this, ...args)
-      } else {
-        return true
-      }
-    },
-    customJs ({ function: functionName, ...otherConfigs }, row) {
-      this.executeCustomJs(functionName, row || otherConfigs, otherConfigs)
-    },
-
-    commonRuleAction (config, ...props) {
-      this.commonAction({ ...config, requestType: 'rule' }, ...props)
-    },
-    /**
-     * 通用请求
-     * @param action 请求命令
-     * @param rule 请求业务规则
-     * @param metaId 请求对象，默认为当前页面对象
-     * @param num 选中记录数(1,必须选中且只能选中一条记录；n：必须选中至少一条记录；0不需要选中记录)
-     * @param comfirmMsg 操作提交之前的确认信息（如果为空，就不需要确认）
-     * @param params #[列表对象的某字段名]"，(如果是选中的多条记录，将字段值拼成一个字符串，用逗号隔开) "$[当前页面的某变量名]"
-     * @param successMsg 操作成功的提示
-     * @param failMsg 操作失败的提示
-     * @param row 操作的列
-     */
-    commonAction ({ id, text, requestType, action, rule, metaId = (this.$metaId), num = 0, confirm, confirmMsg = null, confirmButtonText, cancelButtonText, mask = false, params = {}, successMsg = '处理成功', failMsg = '处理失败', afterTrigger, afterTriggerPage, afterTriggerPageOpenMode, afterTriggerParams }, row) {
-      let selections = []
-      // 检测是否选中元素
-      if (row) {
-        selections = [{ ...row }]
-      } else {
-        if (this.selection) selections = [...this.selection]
-      }
-      if (selections.length === 0) {
-        if (num !== 0 && num !== '0') {
-          this.$message.error(this.$t('please select a record'))
-          return
-        }
-      } else if (selections.length > 1) {
-        if (num === 1 || num === '1') {
-          this.$message.error(this.$t('Only one record can be selected'))
-          return
-        }
-      }
-
-      if (!params.id) {
-        params.id = `#[${this.$metaKey}]`
-      }
-      const formatParams = this.$formatParams(params, selections)
-      const loadingKey = id || text || `common-${action}`
-      // 提交方法
-      const submitFn = () => {
-        if (this.httpLoading[loadingKey]) {
-          return this.$message.error('正在提交，请稍后...')
-        }
-        this.httpLoading[loadingKey] = true
-        let loading = null
-        if (mask) {
-          loading = this.$loading({
-            target: this.upPage ? this.upPage.$parent.$el : this.$el,
-            background: 'rgba(255, 255, 255, 0.5)',
-            text: '正在操作,请稍后...',
-            lock: true
-          })
-        }
-        const timer = setTimeout(() => {
-          this.httpLoading[loadingKey] = false
-          clearTimeout(timer)
-        }, 2000)
-        const params = {
-          action,
-          entityId: metaId,
-          ...formatParams
-        }
-        if (requestType === 'rule') params.rule = rule
-
-        this.$http.$post(params)
-          .then((res) => {
-            // 如果存在下一个事件，执行下一个事件
-            const _afterTriggerParams = this.$formatAfterTriggerParams(afterTriggerParams, { res, data: row || this.data })
-            this.$message.success(successMsg)
-            if (afterTrigger) {
-              this[afterTrigger]({ pageId: afterTriggerPage, openMode: afterTriggerPageOpenMode, params: _afterTriggerParams })
-            } else {
-              if (this.reloadData) this.reloadData()
-            }
-            // 广播「这一页的数据被改动了」。reloadData 只刷自己那张列表，够不到同一页上的
-            // 统计卡：处理完一条待办，列表少一行而顶上的「待办 N」还是原来的数字，
-            // 看着像统计不准。谁关心谁监听（见 CardNum 的 data-changed）
-            if (this.$event) this.$event.emit('data-changed', { action, metaId })
-          })
-          .catch(err => {
-            this.$message.error(err.message || failMsg)
-          })
-          .finally(() => {
-            this.httpLoading[loadingKey] = false
-            if (loading) loading.close()
-          })
-      }
-      // 判断是否需要确认弹窗
-      if (confirm && confirmMsg) {
-        this.$confirm(confirmMsg, this.$t('hint'), {
-          confirmButtonText: confirmButtonText || this.$t('confirm'),
-          cancelButtonText: cancelButtonText || this.$t('cancel'),
-          type: 'warning'
-        }).then(() => {
-          submitFn()
-        })
-      } else {
-        submitFn()
-      }
-    },
-    /**
-     * 下载文件
-     * @param action 请求命令
-     * @param rule 请求业务规则
-     * @param metaId 请求对象，默认为当前页面对象
-     * @param num 选中记录数(1,必须选中且只能选中一条记录；n：必须选中至少一条记录；0不需要选中记录)
-     * @param comfirmMsg 操作提交之前的确认信息（如果为空，就不需要确认）
-     * @param params #[列表对象的某字段名]"，(如果是选中的多条记录，将字段值拼成一个字符串，用逗号隔开) "$[当前页面的某变量名]"
-     * @param successMsg 操作成功的提示
-     * @param failMsg 操作失败的提示
-     * @param row 操作的列
-     */
-    downloadFile ({ requestType, action, rule, metaId = (this.$metaId), num = 0, confirm, confirmMsg = null, confirmButtonText, cancelButtonText, mask = false, params = {}, successMsg = '处理成功', failMsg = '处理失败', afterTrigger, afterTriggerPage, afterTriggerParams }, row) {
-      let selections = []
-      // 检测是否选中元素
-      if (row) {
-        selections = [{ ...row }]
-      } else {
-        if (this.selection) selections = [...this.selection]
-      }
-      if (selections.length === 0) {
-        if (num !== 0 && num !== '0') {
-          this.$message.error(this.$t('please select a record'))
-          return
-        }
-      } else if (selections.length > 1) {
-        if (num === 1 || num === '1') {
-          this.$message.error(this.$t('Only one record can be selected'))
-          return
-        }
-      }
-
-      if (!params.id) {
-        params.id = `#[${this.$metaKey}]`
-      }
-      // 格式化params
-      const formatParams = this.$formatParams(params, selections)
-      // 提交方法
-      const submitFn = () => {
-        if (this.httpLoading[`common-${action}`]) {
-          return this.$message.error('正在提交，请稍后...')
-        }
-        this.httpLoading[`common-${action}`] = true
-        let loading = null
-        if (mask) {
-          loading = this.$loading({
-            target: this.upPage ? this.upPage.$parent.$el : this.$el,
-            background: 'rgba(255, 255, 255, 0.5)',
-            text: '正在操作,请稍后...',
-            lock: true
-          })
-        }
-        const timer = setTimeout(() => {
-          this.httpLoading[`common-${action}`] = false
-          clearTimeout(timer)
-        }, 2000)
-        const params = {
-          action,
-          entityId: metaId,
-          ...formatParams
-        }
-        if (requestType === 'rule') params.rule = rule
-
-        this.$http.$post(params, {
-          responseType: 'blob'
-        })
-          .then(({ blob, filename }) => {
-            var a = document.createElement('a')
-            document.body.appendChild(a)
-            const objectUrl = URL.createObjectURL(blob)
-            a.href = objectUrl
-            a.download = filename
-            a.click()
-            window.URL.revokeObjectURL(objectUrl)
-            document.body.removeChild(a)
-            // 如果存在下一个事件，执行下一个事件
-            const _afterTriggerParams = this.$formatAfterTriggerParams(afterTriggerParams, { data: row || this.data })
-            this.$message.success(successMsg)
-            if (afterTrigger) {
-              this[afterTrigger]({ pageId: afterTriggerPage, params: _afterTriggerParams })
-            } else {
-              if (this.reloadData) this.reloadData()
-            }
-          })
-          .catch(err => {
-            this.$message.error(err.message || failMsg)
-          })
-          .finally(() => {
-            this.httpLoading[`common-${action}`] = false
-            if (loading) loading.close()
-          })
-      }
-      // 判断是否需要确认弹窗
-      if (confirm && confirmMsg) {
-        this.$confirm(confirmMsg, this.$t('hint'), {
-          confirmButtonText: confirmButtonText || this.$t('confirm'),
-          cancelButtonText: cancelButtonText || this.$t('cancel'),
-          type: 'warning'
-        }).then(() => {
-          submitFn()
-        })
-      } else {
-        submitFn()
-      }
-    },
-    $refesh () {
-      // this.$children.forEach(child => {
-      //   if (child.$options.componentType === 'component') {
-      //     if (child.$refesh) child.$refesh()
-      //   }
-      // })
-    },
-    $refeshPage () {
-      if (this.upPage) this.upPage.$refesh()
-    },
-    // 获取上级页面
-    $getParentPage () {
-      var parent = this.$parent || this.$root
-      var type = parent.$options.$componentType
-
-      while (parent && (!type || type !== 'page')) {
-        parent = parent.$parent
-
-        if (parent) {
-          type = parent.$options.componentName
-        }
-      }
-      if (parent) {
-        return parent
-      }
-    },
-    // 修改上级页面数据
-    $setParentPageModel (model) {
-      if (this.$parentPage) {
-        for (const key in model) {
-          this.$parentPage.model[key] = model[key]
-        }
-      }
-    },
-    // 调用上级页面内组件事件
-    $dispatchComponent (id, eventName, ...params) {
-      if (this.$parentPage) { // 组件id
-        broadcast.apply(this.$parentPage, [id, eventName, ...params])
-      }
-    },
-    // 获取页面内组件（T31：注册表 byId，替代 $children 树遍历）
-    $getPageComponent (id, current = this, prefix) {
-      const newId = prefix ? prefix + '-' + id : id
-      const page = current && current._epxPage ? current._epxPage() : this._epxPage()
-      const reg = page && page._epxReg
-      return reg ? reg.byId.get(newId) : undefined
-    },
-    $excuteEvent (key, ...args) {
-      const { componentEvents = [] } = this.$configs
-      const { [key]: keyEvents = [] } = componentEvents
-      keyEvents.map(event => this.executeCustomJs(event, ...args))
-    },
-    // 这些方法依赖实例属性（如 httpLoading），保留在混入中
-    $setPageConfig (page) {
-      const currentPage = page || this.page || {}
-      const { config = this.compConfigs } = currentPage
-      for (const key in this.$options) {
-        if (isCustomOption(key, this.$options[key])) {
-          this.pageConfig[key] = this.$options[key]
-        }
-      }
-      for (const key in config) {
-        try {
-          if (this.$_.isObject(config[key])) {
-            if (Array.isArray(config[key])) {
-              this.pageConfig[key] = [...config[key]]
-            } else {
-              // ⚠️ 别往 $options 上写。它是 Vue 按**组件类型**缓存的
-              // （appContext.optionsCache），同一个 app 里该类型所有实例共用同一个对象。
-              // 原先写的是 `if (!this.$options[key]) this.$options[key] = {}`，于是任何一个
-              // 页面配置里出现过的对象型键都被永久种进了共享 $options，此后所有同类型实例
-              // 都会读到 `{}` 而不是 `undefined`——假值变真值，`if (x)` 分支整个翻转，
-              // 而且**取决于页面访问顺序**，刷新即恢复，极难归因。
-              // `if (!x) x = {}` 之后再展开，与直接展开 `x || {}` 完全等价（原逻辑也只在
-              // 假值时赋 {}），所以去掉写入不改变合并结果。回归测试见
-              // test/unit/config-options-isolation.test.js。
-              this.pageConfig[key] = { ...(this.$options[key] || {}), ...config[key] }
-            }
-          } else {
-            this.pageConfig[key] = config[key]
-          }
-        } catch (error) {
-          this.pageConfig[key] = config[key]
-        }
-      }
-    },
-    $setCompConfigs () {
-      for (const key in this.$options) {
-        if (isCustomOption(key, this.$options[key])) {
-          this.configs[key] = this.$options[key]
-        }
-      }
-      for (const key in this.compConfigs) {
-        try {
-          if (this.$_.isObject(this.compConfigs[key])) {
-            if (Array.isArray(this.compConfigs[key])) {
-              this.configs[key] = [...this.compConfigs[key]]
-            } else {
-              // 同上：不写共享 $options（见 $setPageConfig 里的说明）
-              this.configs[key] = { ...(this.$options[key] || {}), ...this.compConfigs[key] }
-            }
-          } else {
-            this.configs[key] = this.compConfigs[key]
-          }
-        } catch (error) {
-          this.configs[key] = this.compConfigs[key]
-        }
-      }
-    },
-    _createComponent () {
-      let height = ''
-      // 页面配置
-      const _configs = {}
-      const globalConfigs = (this.componentGlobalConfig && this.componentGlobalConfig[this.contentType]) || {}
-      const systemGlobalConfigs = (this.systemComponentGlobalConfig && this.systemComponentGlobalConfig[this.contentType]) || {}
-      const queryPageConfigs = this.pageConfig || this.$query.pageConfigs || {}
-      const { config: pageConfigs = queryPageConfigs } = this.$pageInfo
-      const { css, itemConfigs = {}, ...otherConfigs } = pageConfigs
-      const _itemConfigs = this.itemConfigs || itemConfigs
-      const itemConfig = _itemConfigs[this.compId]
-      let allConfigs = { ...globalConfigs, ...systemGlobalConfigs, ...this.compConfigs, ...itemConfig }
-      if (this.isPage) {
-        allConfigs = { ...allConfigs, ...otherConfigs }
-        // 获取函数库
-        const exports = {}
-        // eslint-disable-next-line no-eval
-        eval('(function (exports) {' + pageConfigs.compileJS + ' }(exports));')
-        this.pageEvents = { ...exports }
-        if (css) {
-          appendCss(this.$pageId, css)
-        }
-      } else {
-        const { css } = this._component
-        if (css) {
-          appendCss(this.compId, css)
-        }
-      }
-      // 从组件 $options 收割「配置点默认值」。判定统一走 isCustomOption——
-      // 这里原先另有一份内联的保留名单，和 custom-option.js 的那份各写各的，已经漂了：
-      // 内联那份少 18 个键，其中最要命的是 **extends**。Vue 3 的 mergeOptions 对 extends
-      // 没有合并策略、直接把基类定义对象赋到解析后的 $options 上（runtime-core 4031-4039），
-      // 于是每个 `extends: XxxList` 的组件都会把**整个基类定义对象**当成配置点塞进 configs，
-      // 被 $configs 每次重算时整体拷贝、被 get-component 广播出去。
-      // 本仓库 61 个组件用了 extends。另有 activated/deactivated/updated 等钩子数组同样泄漏。
-      //
-      // 注意这个过滤只作用在「收割默认值」这一步；页面配置走下面的 allConfigs 合并，
-      // 不受影响——所以线上已有的页面配置数据语义不变。
-      for (const key in this.$options) {
-        if (isCustomOption(key, this.$options[key])) {
-          _configs[key] = this.$options[key]
-        }
-      }
-      for (const key in allConfigs) {
-        try {
-          if (this.$_.isObject(allConfigs[key])) {
-            if (Array.isArray(allConfigs[key])) {
-              _configs[key] = [...allConfigs[key]]
-            } else {
-              // 同上：不写共享 $options（见 $setPageConfig 里的说明）
-              _configs[key] = { ...(this.$options[key] || {}), ...allConfigs[key] }
-            }
-          } else {
-            _configs[key] = allConfigs[key]
-          }
-        } catch (error) {
-          _configs[key] = allConfigs[key]
-        }
-      }
-      const { items = [], mItems, style = {} } = _configs
-      delete _configs.items
-      const _items = this.items || items
-      const configs = { ...this.configs, ..._configs }
-      this.configs = configs
-
-      if (configs.height) {
-        height = typeof configs.height === 'string' && configs.height.includes('%') ? configs.height : configs.height + 'px'
-      }
-      // 获取页面配置
-      const _style = { ...style, ...this.compStyle }
-      if (_style.backgroundImage) {
-        _style.backgroundImage = _style.backgroundImage.replace(/url\s*\(([\w+-/.\s]+)\)/g, (str, $1) => {
-          return `url(${util.getFileUrl($1)})`
-        })
-      }
-      if (height) _style.height = height
-      this.component = {
-        id: this.compId || this.$pageId,
-        title: this.$formatContent(this.compTitle || this.$attrs.title),
-        contentType: this.contentType,
-        style: _style,
-        configs: this.$configs,
-        flex: this.compFlex === undefined ? !!this.$configs.flex : !!this.compFlex,
-        items: _items, // 子节点
-        mItems,
-        metaId: this.$metaId,
-        meta: this.$meta,
-        parentPage: this.$getParentPage()
-      }
-      this.$emit('get-component', this.component)
-      this.$event.emit('get-component', this.component)
-      if (this.isPage) {
-        this.component.itemConfigs = itemConfigs
-      }
-      this.$emit('load-component', this.component)
-      this.$event.emit('load-component', this.component)
-    },
-
-    // 创建组件前
-    beforeCreateComponent () {
-    },
-    // 初始化配置 可在此更改默认配置
-    beforeInitComponent () {
-
-    },
-    /**
-     * 初始化组件
-     */
-    initComponent (component) {
-
-    }
-  },
-  async created () {
-    // T31 修正：注册必须早于下面 _createComponent() 发出的 `load-component`——BasePage 收到该
-    // 事件后要用 getComponentById 拿本组件实例、给页面变量建 $watch，注册晚了就恒为 undefined、
-    // 在 BasePage.watchCompValue 里静默早退（页面变量恒空 ⇒ 由它驱动的 scopeParams 条件被
-    // createHttp 整条丢弃）。Vue2 靠 $children（在 _init 里就填好、早于 created）天然满足这个
-    // 不变式；Vue3 没有 $children，改用 _epxReg 之后这个先后顺序就得自己保证。
-    // mounted 里那句保留不删：Map.set / Set.add 幂等，重复注册零代价。
-    this._epxRegister()
-    // ⚠️ `compoennt` 是笔误（少个 n），**别顺手改对**——它是承重的。
-    // 原意见 global.js 里对称的那一对：「非 page → setCompConfigs / 非 component → setPageConfig」，
-    // 即 $setPageConfig() 本该只跑在页面上。笔误让条件恒真 ⇒ 多年来**每个**组件都在跑它，
-    // 于是 _createComponent() / $formatComponents() 的 pageConfig 回退路径，以及
-    // Collapse / ApprovalIndex / TaskList / TodoList / PermissManage / Template 等组件里的
-    // `this.pageConfig.xxx` 读取，全都建立在这个恒真之上。
-    // 拼写改对 = 所有非页面组件的 pageConfig 一次性清零 ⇒ 按 compId 下发的逐组件配置静默丢失
-    // （按钮不渲染、checkPageId / detailPageFlag 变 undefined 走错分支），而且现有单测抓不到
-    // （component-register-timing.test.js 把 $setPageConfig stub 掉了，只断言注册顺序）。
-    // 真要收敛回原意，得当独立重构立项：先给每个消费点补断言，再改条件，最后跑全量 e2e。
-    if (this.$options.$componentType !== 'compoennt') {
-      this.$setPageConfig()
-    }
-    this.$componentStatus = 'beforeCreate'
-    this.beforeCreateComponent()
-    // 创建组件
-    this._createComponent()
-    this.$componentStatus = 'created'
-    try {
-      this.oldCompConfigs = this.$_.cloneDeep(this.compConfigs)
-    } catch (error) {}
-    // 初始化组件配置
-    this.$componentStatus = 'beforeInit'
-    const component = this.beforeInitComponent()
-    if (component instanceof Promise) {
-      await component
-    }
-    // 如果this.$metaId 并且不存在this.$meta 获取meta对象
-    if (this.$metaId && !this.$meta) {
-      await this.$store.dispatch({
-        type: 'ADD_META',
-        metaId: this.$metaId
-      })
-    }
-    // 初始化组件
-    this.$componentStatus = 'init'
-    this.initComponent(this.$component)
-    this.$nextTick(() => {
-      if (this.$el) {
-        const compId = this.isPage ? this.$pageId : this.compId
-        if (this.$el.classList) {
-          this.$el.classList.add('css_' + compId)
-        } else {
-          this.$el.className = 'css_' + compId
-        }
-      }
-    })
-  },
-  mounted () {
-    // T31：组件注册表（替代 $children 树遍历，Vue3 无 $children）。每组件注册进其页面的
-    // _epxRegistry，broadcast/getComponentById 改 O(1) 查表。页面级作用域（upPage 就近）。
-    this._epxRegister()
-    // 系统返回（popstate）已由 @epxing/utils/src/nav-history 的全局唯一监听器统一处理，
-    // 不再每个页面各挂一个（keep-alive 缓存页/隐藏 tab 页的监听器会导致一次返回连弹多页）
-    this.$excuteEvent('onMounted')
-  },
-  unmounted () {
-    this._epxDeregister() // T31：从页面注册表注销
-    const compId = this.isPage ? this.$pageId : this.compId
-    removeCss(compId)
-    // 1. 清理事件监听器
-    if (this._pageEventHandlers && this._pageEventHandlers.length) {
-      for (const { comp, event, handler } of this._pageEventHandlers) {
-        // 解绑到真正绑定的 page component 上
-        if (comp && comp.$epxOff) comp.$epxOff(event, handler)
-      }
-    }
-    this._pageEventHandlers = []
-
-    // 2. 清理 openedPopup 中对当前组件的引用（关键！防止连锁泄漏）
-    // 如果当前组件被保存在 openedPopup 数组中（通过 opener 引用），
-    // 即使组件销毁了，openedPopup 仍然持有引用，导致整个引用链无法回收
-    if (window.openedPopup && Array.isArray(window.openedPopup)) {
-      for (let i = window.openedPopup.length - 1; i >= 0; i--) {
-        const popup = window.openedPopup[i]
-        if (popup && popup.opener === this) {
-          // 清理 opener 引用，防止阻止垃圾回收
-          popup.opener = null
-          // 如果弹窗已经关闭，从数组中移除
-          if (popup.closed || !popup.visible) {
-            window.openedPopup.splice(i, 1)
-          }
-        }
-      }
-    }
-
-    // 3. 清理 component 对象中的循环引用
-    if (this.component) {
-      // 清理 parentPage 引用（防止父页面持有子组件引用导致无法回收）
-      if (this.component.parentPage) {
-        this.component.parentPage = null
-      }
-      // 清理其他可能的引用
-      this.component = null
-    }
-
-    // 4. 执行组件自定义的销毁事件
-    //    ⚙️ 见文件顶部 EXEC_ON_DESTORY_ON_TEARDOWN（评审 C2）：整棵页面树被销毁这条**本次新唤醒**的
-    //    路径上保持 Task 17 之前的语义（不跑用户脚本）；单个组件被摘掉的路径照常跑。
-    if (EXEC_ON_DESTORY_ON_TEARDOWN || !isEpxTeardown(this.$)) {
-      this.$excuteEvent('onDestory')
-    }
-  },
-  beforeUnmount () {
-    // ⚙️ 与上面 onDestory 同一道闸门（最终评审 I-1）：M0 的真卸载把 bum 和 um **两个**钩子一起
-    // 唤醒了，而 EXEC_ON_DESTORY_ON_TEARDOWN 原来只挡住了 um 那半边 —— `onBeforeDestory` 是
-    // 同一类低代码用户脚本的逃逸口（线上页面配置里可能存在从未执行过的脚本），漏掉它等于闸门只关了一半。
-    // `_epxTeardown` 由 RouterView 在剪枝前打上，bum 触发时已就位。
-    if (EXEC_ON_DESTORY_ON_TEARDOWN || !isEpxTeardown(this.$)) {
-      this.$excuteEvent('onBeforeDestory')
-    }
-  }
-}
+/* eslint-disable no-eval */
+/* eslint-disable no-unused-vars */
+// 组件实例
+import { mapState, mapGetters } from 'vuex'
+import { evalWith } from '@epxing/utils/src/eval-with'
+import { CREATE_TAB } from '@epxing/core/src/store/actions'
+import util from '@epxing/core/src/runtime-utils/util'
+import { isSafeFn } from '@epxing/utils/src/security'
+import { isCustomOption } from './custom-option'
+// 纯函数层，零依赖（见 menu-route.js 头注释），不会与 router/store 成环
+import { resolveRouteRole } from '@epxing/core/src/menu-route'
+// 条件初始化：与 global.js / methods-to-prototype.js 共享同一个弹窗栈，
+// 无条件重置会让先求值模块捕获的引用变成孤儿数组
+if (!window.openedPopup) {
+  window.openedPopup = []
+}
+const openedPopup = window.openedPopup
+
+/**
+ * ⚙️ T17 修复轮 1（评审 C2）——**一行开关**：keep-alive 剪枝/页签销毁这条路径上要不要执行
+ * 用户脚本 `onDestory`（设计器事件面板里的「组件销毁时」，见 designer/src/visual/config/Event.vue）。
+ *
+ *   false（当前值）= 保持 Task 17 之前的可观察语义：这条路径**不**触发 onDestory。
+ *   true           = 放开，让这些脚本随真卸载开始执行。
+ *
+ * 为什么默认 false：Task 17 的目标是内存修复，不是行为变更。真卸载唤醒了成千上万个此前从未跑过的
+ * `unmounted`，其中就包括这个**面向低代码用户脚本的逃逸口**——线上页面配置里可能已经存在
+ * 从迁到 Vue 3 之后一次都没执行过的 onDestory 脚本，它们可以 $store.commit / $bus.off / 写 window /
+ * 发请求 / 跳转，内容不可静态判定、也没有任何人验证过。让它们在一次内存修复里**顺带开始跑**，
+ * 属于带风险的范围蔓延。放开前必须先盘点存量配置（FM_PAGE_CONFIG 里 componentEvents.onDestory
+ * 非空的有多少、分别写了什么），再灰度。
+ *
+ * 注意作用域：这个开关**只**管"整棵页面树被销毁"这条路径。页面还活着、只是某个组件被 v-if 摘掉
+ * 之类的单点卸载，onDestory 照常执行（那条路径在 Task 17 之前本来就在跑，不能反向改掉）。
+ */
+const EXEC_ON_DESTORY_ON_TEARDOWN = false
+
+/**
+ * 沿 parent 链找 RouterView 打的 `_epxTeardown` 标记（在 RouterView 的 removeKeepAliveCache /
+ * beforeUnmount 里打），用来区分"整棵页面树被销毁"与"页面还活着、单个组件被摘掉"。
+ * 不能用"父实例 scope 是否已 stop"来判：unmountComponent 的顺序是
+ * 「bum → scope.stop() → 递归卸载子树 → queuePostRenderEffect(um)」，而被剪枝页面的父级是
+ * KeepAlive，它的 scope 在那一刻仍然 active，判据在最要紧的那一层恰好失效。
+ */
+function isEpxTeardown (inst) {
+  let p = inst
+  let guard = 0
+  while (p && guard++ < 500) {
+    if (p._epxTeardown === true) return true
+    p = p.parent
+  }
+  return false
+}
+
+// T31：改组件注册表（page._epxReg，替代 $children 树遍历，Vue3 无 $children）。
+// this = 页面实例（调用方 apply 到 $parentPage/页面）。
+function broadcast (id, eventName, ...params) {
+  const reg = this && this._epxReg
+  if (!reg) return
+  const child = reg.byId.get(id)
+  if (child && child[eventName]) child[eventName].apply(child, params)
+}
+function broadcastCom (componentName, eventName, params) {
+  const reg = this && this._epxReg
+  if (!reg) return
+  const set = reg.byName.get('epx-' + componentName)
+  if (set) for (const child of set) child.$emit.apply(child, [eventName].concat(params))
+}
+function getComponentById (id) {
+  const reg = this && this._epxReg
+  return reg ? reg.byId.get(id) : undefined
+}
+
+function findNavId (menus = [], menuId, parent) {
+  for (let i = 0; i < menus.length; i++) {
+    const menu = menus[i]
+    if (menu.ID === menuId) {
+      return { ...menu, parentMenu: parent }
+    } else {
+      if (menu.children) {
+        const activeMenu = findNavId(menu.children, menuId, menu)
+        if (activeMenu) return activeMenu
+      }
+    }
+  }
+}
+
+function appendCss (id, css) {
+  let style = document.createElement('style')
+  style.id = 'style_' + id
+  style.textContent = css.replace(/:current/g, '.css_' + id).replace(/url\s*\(([\w+-/.\s]+)\)/g, (str, $1) => {
+    return `url(${util.getFileUrl($1)})`
+  })
+
+  style.setAttribute('type', 'text/css')
+  document.head.appendChild(style)
+  style = null
+}
+function removeCss (id) {
+  let element = document.getElementById('style_' + id)
+  if (element) {
+    document.head.removeChild(element)
+    element = null
+  }
+}
+export default {
+  $componentType: 'component',
+  // T33（关 compat 同刻翻转）：
+  //
+  // 为什么最终要 true：Vue2 里 `inheritAttrs: false` **不管 class/style** —— 它们走
+  // `$vnode.data.staticClass/class`，无条件落到根元素。Vue3 把 class/style 并进了 attrs，
+  // false 会把它们一起挡掉 → 父传的 class 全丢。recon-classloss.mjs 实测：**20 个组件**受影响。
+  //
+  // 为什么不能提前翻：compat 开着时 Vue2 语义已经让 class 落根了，此时翻成 true 只剩副作用——
+  // 未声明的级联属性被序列化成 DOM attribute，**渲染直接断**（实测：应用开发平台左侧菜单
+  // 92 项 → 0 项，且 errors×0 静默失败；commit 1e2ab4f1c 当时测到的 "元素 1642→702" 同因）。
+  // ⇒ 与 `.native` 一样，语义在开关翻转前后互斥，只能同一刻改。
+  //
+  // 翻转时的配套（见 .claude/codemod/codemod-forward-attrs.mjs）：
+  //   1. 转发给子组件的 `$attrs` 已剔掉 class/style（`$forwardAttrs`），否则容器根上的 class
+  //      会被复制到它的每个子组件上；✅ 已完成
+  //   2. 级联下发的 currentRoute / pageInfo / queryParams 已上提为 props；✅ 已完成
+  //   3. 透明代理组件（epx-component / widget-preview）保留自己的 `inheritAttrs: false` +
+  //      原样转发 `$attrs` —— 它们没有自己的根，class 要送到所渲染的叶子组件上。✅ 已完成
+  //   4. 翻转后仍会有未声明的级联属性落到根（如 currentQuery / inline）→ 那一刀时按实测逐个声明。
+  inheritAttrs: true,
+  navConfigs: {
+    flag: false
+  },
+
+  props: {
+    // 当前页面信息
+    page: {
+      type: Object
+    },
+    // 当前对象元数据信息
+    meta: {
+      type: Object,
+      default () {
+        return {}
+      }
+    },
+    compId: {
+      type: [String, Number]
+    }, // 组件id
+    contentType: String, // 模板名称
+    _component: {
+      type: Object,
+      default () {
+        return {}
+      }
+    },
+    compStyle: {
+      type: Object,
+      default () {
+        return {}
+      }
+    }, // 组件样式
+    compConfigs: {
+      type: Object,
+      default () {
+        return {}
+      }
+    },
+    compFlex: {
+      type: Boolean
+    },
+    compTitle: String,
+    items: Array, //
+    itemConfigs: Object,
+    metaId: String,
+    // 以下三个由 epx-component / epx-page 沿 $attrs 级联下发，此前无人声明 → 停在 $attrs 里。
+    // Vue3 的 $attrs 含 class/style，将来把 inheritAttrs 打开（让父传的 class 落到 root）时，
+    // 未声明的属性会被序列化成 DOM attribute（对象值变 "[object Object]"）。声明成 props 即被消费掉。
+    // 详见 T30b-compat-warning-census.md「INSTANCE_ATTRS 否定结果被推翻」一节。
+    currentRoute: Object,
+    pageInfo: Object,
+    // Component.vue 给**每个** leaf 都绑 :query-params，但只有 EntityList 自己声明了它
+    // （同形状 Object/default {}，合并无冲突）。核对过：无 mixin 使用者把 queryParams 写在
+    // data() 或 computed 里，故可安全上提。formData 则不行——有 6 个使用者写在 data()。
+    queryParams: {
+      type: Object,
+      default () {
+        return {}
+      }
+    }
+  },
+  data () {
+    return {
+      pageConfig: {},
+      $defaultConfigs: {},
+      httpLoading: {},
+      component: {},
+      configs: {}
+    }
+  },
+  inject: {
+    pageId: {
+      type: String,
+      default: null
+    },
+    pageMetaId: {
+      type: String,
+      default: null
+    },
+    // T31：最近的 epx 父容器（provide 下发），mounted 注册进其 _epxChildren 支撑子树遍历
+    _epxParentComp: {
+      default: null
+    },
+    upPage: {
+      type: Object,
+      default: () => null
+    },
+    // 获取所属标签页
+    $getTab: {
+      type: Function,
+      default: null
+    },
+    template: {
+      type: Object,
+      default: null
+    },
+    createRoute: {
+      default: null
+    },
+    destoryRoute: {
+      default: null
+    },
+    reloadRoute: {
+      default: null
+    }
+  },
+  /**
+   * 向下传递页面实例和模板
+   *
+   * 设计说明：
+   * 1. 页面组件（isPage=true）在 BasePage.vue 中提供 upPage，这里不需要重复提供
+   * 2. 非页面组件需要继续向下传递 upPage，确保所有子组件都能访问到页面实例
+   *
+   * 为什么需要 inject 后再 provide？
+   * - Vue 的 provide/inject 是单向的，只向下传递，不会自动向上查找
+   * - 如果中间某个组件不 provide，其子组件将无法获取 upPage（即使祖先组件提供了）
+   * - 通过在 mixin 中统一处理，确保所有组件都能自动传递，避免遗漏
+   *
+   * 这种模式被称为"透传"（pass-through），是 Vue provide/inject 的常见用法
+   * 优点：
+   * - 统一在 mixin 中处理，所有组件自动继承，无需手动处理
+   * - 确保页面实例能够传递到任意深度的子组件
+   * - 避免因中间组件忘记 provide 而导致子组件无法获取的问题
+   */
+  provide () {
+    // T31：每 epx 组件把自己作为「最近 epx 父容器」下发，子组件 mounted 时注册进 _epxChildren，
+    // 支撑子树级遍历（Card.refesh/AddForm 容器子收集，替代 $children 递归）。
+    const base = { _epxParentComp: this }
+    // 页面组件已经在 BasePage.vue 中提供了 upPage，这里不需要重复提供
+    // 非页面组件需要继续向下传递，确保子组件能够访问到页面实例
+    if (!this.isPage) {
+      base.upPage = this.upPage // 透传页面实例
+      base.template = this.template // 透传模板
+    }
+    // T28：Vue3 的 provide 合并不容忍 undefined 返回值
+    return base
+  },
+  computed: {
+    ...mapState({
+      appMenus: state => state.config.appMenus,
+      $screen: state => state.config.screen || {}, // 屏幕信息
+      $tabs: state => state.tabs.tabs, // 标签页
+      metas: state => state.meta.metas, // 元数据信息集合
+      user: state => state.user.user, // 用户信息
+      componentGlobalConfig: state => state.config.componentGlobalConfig, // 组件全局配置
+      systemComponentGlobalConfig: state => state.config.systemComponentGlobalConfig, // 组件全局配置
+      currentMenu: state => state.config.currentMenu // 当前导航菜单
+    }),
+    ...mapGetters([
+      'getMeta',
+      'getPageById'
+    ]),
+    CLIENT () {
+      const { CLIENT: queryClient } = this.$query
+      const { CLIENT: tabClient } = this.$tab
+      const { client: routeClient } = this.$route.query
+      const { client: userClient } = this.user
+      const { CLIENT: appClient, 'CLIENT|ID': clientId } = this.appConfig
+      return queryClient || tabClient || routeClient || userClient || appClient || clientId
+    },
+    SYSTEM () {
+      const { SYSTEM: querySystem } = this.$query
+      const { SYSTEM: tabSystem } = this.$tab
+      const { system: routeSystem } = this.$route.query
+      const { configSystem = {} } = this.$store.state.config
+      const { SYSTEM: appSystem, 'SYSTEM|ID': systemId } = this.appConfig
+      return querySystem || tabSystem || routeSystem || configSystem.ID || appSystem || systemId
+    },
+    APP () {
+      const { APP: queryApp } = this.$query
+      const { APP: tabApp } = this.$tab
+      return queryApp || tabApp
+    },
+    $tab () {
+      if (this.$getTab) return this.$getTab()
+      return this.$activeTab || {}
+    },
+    /**
+     * 选中标签页
+     */
+    $activeTab () {
+      return this.$tabs.find(item => item.active) || {}
+    },
+    $tabQuery () {
+      return this.$tabs.find(item => item.active) || {}
+    },
+    isPage () {
+      const { $componentType } = this.$options
+      return $componentType === 'page'
+    },
+    /**
+       * 当前页面参数
+       */
+    $query () {
+      // 获取该组件是否是页面
+      // 获取路由参数
+      // 当前路由不是登录页
+      const routeQuery = {}
+      const { name, query = {}, params = {} } = this.$route || {}
+      if (name !== 'hallLogin' && name !== 'login') {
+        for (const key in query) {
+          if (query[key]) routeQuery[key] = query[key]
+        }
+        for (const key in params) {
+          if (params[key]) routeQuery[key] = params[key]
+        }
+      }
+      if (!this.$_.isEmpty(this.currentQuery)) {
+        const currentQuery = this.currentQuery || {}
+        return { ...routeQuery, ...currentQuery }
+      } else {
+        // 获取上级页面
+        if (this.upPage) {
+          const currentQuery = this.upPage.currentQuery || {}
+          return { ...routeQuery, ...currentQuery, ...(this.upPage.pageParams || {}) }
+        }
+        return routeQuery
+      }
+    },
+    $configVersion () {
+      const queryPageConfigs = this.$query.pageConfigs || {}
+      const { config = queryPageConfigs } = this.$pageInfo
+      return config.version
+    },
+    getComponentId () {
+      return component => {
+        const queryPageConfigs = this.$query.pageConfigs || {}
+        const { config = queryPageConfigs } = this.$pageInfo
+        if (!this.isPage && !config.version) {
+          const { id } = this.$component
+          return id + '-' + component.id
+        }
+        return component.id
+      }
+    },
+    $component: {
+      get () {
+        return this.component
+      },
+      set (v) {
+        this.component = v
+      }
+    },
+    $subcomponents () {
+      const { items } = this.$component
+      // 判断是否迭代
+      return this.$formatComponents(items, this._component) || []
+    },
+    $compData () {
+      const iterator = this._component.iterator || {}
+      return { ...iterator, $templateVariables: this.$templateVariables }
+    },
+    $configs: {
+      get () {
+        // 格式化内容
+        const _configs = {}
+        // 动态参数的取值来源建**一次**就够。$formatContent 的默认参数是
+        // `{ ...$tab, ...pageParams, ...$query, ...$compData }`，而默认参数是**每次调用都求值**的——
+        // 原先这里逐个字符串键调用，一个组件有多少个字符串配置就重建多少遍同一个对象。
+        // 实测（.claude 微基准，28 个字符串键）：合并对象 324 µs、两遍正则只要 28 µs，
+        // 也就是说这条路径 92% 的开销花在重复构造上，提出来能砍掉约九成。
+        //
+        // ⚠️ 必须**惰性**构造，不能提到循环外无条件建：那样 getter 会无条件依赖
+        // $tab/$query/$compData，连一个字符串配置都没有的组件也会在路由参数变化时失效重算，
+        // 平白多出依赖边。惰性构造与原先「首次调用 $formatContent 时才求值」的依赖集完全一致。
+        let data
+        for (const key in this.configs) {
+          const item = this.configs[key]
+          if (typeof item === 'string') {
+            if (data === undefined) {
+              data = { ...this.$tab, ...(this.upPage?.pageParams || {}), ...this.$query, ...this.$compData }
+            }
+            _configs[key] = this.$formatContent(item, data)
+          } else if (/operates$/i.test(key)) {
+            // 按钮文案统一走界面文案翻译，覆盖组件内置的默认按钮（含运行时注入的默认操作）
+            _configs[key] = this.$translateOperates(item)
+          } else {
+            _configs[key] = this.configs[key]
+          }
+        }
+        return _configs
+      },
+      set (v) {
+        this.configs = v
+      }
+    },
+    // 当前页面id
+    $pageMetaId () {
+      // 获取当前传递的metaId
+      let metaId = null
+      if (this.meta && this.meta.id) {
+        metaId = this.meta.id
+      }
+      return metaId || this.pageMetaId
+    },
+    /**
+     * 当前组件对象元数据id 不设置 默认为当前页面对象
+     */
+    $metaId () {
+      const { metaId } = this.$configs
+      return this.metaId || metaId || this.$pageMetaId || this.$query.metaId
+    },
+    // 当前组件对象
+    $meta () {
+      if (this.$metaId) {
+        const meta = this.getMeta(this.$metaId)
+        return meta
+      } else {
+        return null
+      }
+    },
+    $metaKey () {
+      if (this.$meta) {
+        return this.$meta.getKey() || 'ID'
+      } else {
+        return 'ID'
+      }
+    },
+    $parentPage () {
+      // 父级页面
+      const { parentPage } = this.component
+      return parentPage
+    },
+    $parentPageModel () {
+      const { parentPage = {} } = this.component
+      return parentPage.model
+    },
+    $pageId () {
+      const { pageId } = this.page || {}
+      return this.isPage ? pageId : this.pageId || pageId
+    },
+    $pageInfo () {
+      if (this.$pageId) return this.getPageById(this.$pageId) || {}
+
+      return this.page || (!this.isPage && this.upPage && this.upPage.page) || {}
+    },
+    $pageParams () {
+      if (this.isPage) return this.pageParams || {}
+      else if (this.upPage) return this.upPage.pageParams || {}
+      return {}
+    },
+    $templateVariables () {
+      return this.template?.variables || {}
+    },
+    /**
+     * 事件处理总线
+     */
+    $event () {
+      const vm = this
+      let comp = vm
+      while (comp.$parent && comp.$options.$componentType !== 'page') comp = comp.$parent
+      return {
+        emit (event, ...params) {
+          // T25：程序化通道走 $epxEmit（Vue3 无实例事件）；$emit 保留给模板 @listener
+          comp.$epxEmit(event, [...params])
+          comp.$emit(event, [...params])
+        },
+        on (event, callback) {
+          const handler = params => callback.apply(comp, params)
+          comp.$epxOn(event, handler)
+          // 记录在组件实例上，beforeDestroy 时解除绑定
+          if (!vm._pageEventHandlers) vm._pageEventHandlers = []
+          vm._pageEventHandlers.push({ comp, event, handler })
+        }
+      }
+    },
+    $currentRole () {
+      // 菜单直达路由（appMenu/hallMenu）没有 role 段，URL 末段是 menuKey——直接读
+      // $route.params.role 会得到 undefined，$currentRole 恒为 {}。页面配置的 showIf
+      // 表达式里也拿得到 $currentRole（见下方 elData），空值会让按角色显示的节点全部消失。
+      const role = resolveRouteRole(this.$route)
+      const { serviceRoles = {} } = this.user
+      const roleList = serviceRoles[this.appConfig.ID] || []
+      let roleCode = role
+      if (role && role.endsWith('-client')) {
+        roleCode = role.replace(/-client$/, '')
+        // 从通用角色获取
+        return roleList.find(item => item.code === roleCode && item.type === 'client') || {}
+      } else {
+        return roleList.find(item => item.code === roleCode && item.type !== 'client') || {}
+      }
+    },
+    $currentRoleId () {
+      return this.$currentRole.id
+    }
+  },
+  watch: {
+    compConfigs (v) {
+      if (!this.$_.isEqual(this.oldCompConfigs, v)) {
+        this._createComponent()
+      }
+      this.oldCompConfigs = this.$_.cloneDeep(v)
+    }
+  },
+  methods: {
+    // ========== T31 组件注册表（替代 $children 树遍历）==========
+    // 页面级作用域：注册表挂在页面组件（isPage）上，非页面组件经 upPage 就近找页面注册。
+    _epxPage () {
+      if (this.isPage) return this
+      const inst = this.upPage && this.upPage.instance
+      return inst || null
+    },
+    _epxRegistry (page) {
+      const p = page || this._epxPage()
+      if (!p) return null
+      if (!p._epxReg) p._epxReg = { byId: new Map(), byName: new Map() }
+      return p._epxReg
+    },
+    _epxRegister () {
+      // 页面级注册表（broadcast/getComponentById 用）
+      const reg = this._epxRegistry()
+      if (reg) {
+        if (this.compId != null) reg.byId.set(this.compId, this)
+        const name = this.$options.name
+        if (name) {
+          let set = reg.byName.get(name)
+          if (!set) { set = new Set(); reg.byName.set(name, set) }
+          set.add(this)
+        }
+      }
+      // 父子注册（子树遍历用，Card.refesh/AddForm 容器）：注册进最近 epx 父容器
+      const parent = this._epxParentComp
+      if (parent && parent !== this) {
+        if (!parent._epxChildren) parent._epxChildren = new Set()
+        parent._epxChildren.add(this)
+      }
+    },
+    _epxDeregister () {
+      const page = this._epxPage()
+      if (page && page._epxReg) {
+        const reg = page._epxReg
+        if (this.compId != null && reg.byId.get(this.compId) === this) reg.byId.delete(this.compId)
+        const name = this.$options.name
+        const set = name && reg.byName.get(name)
+        if (set) set.delete(this)
+      }
+      const parent = this._epxParentComp
+      if (parent && parent._epxChildren) parent._epxChildren.delete(this)
+    },
+    // T31：遍历子树内 epx 组件（含深层后代，递归 _epxChildren），cb(comp)。替代 $children 递归。
+    _epxWalkChildren (cb) {
+      const stack = this._epxChildren ? [...this._epxChildren] : []
+      while (stack.length) {
+        const c = stack.pop()
+        if (!c) continue
+        cb(c)
+        if (c._epxChildren) for (const gc of c._epxChildren) stack.push(gc)
+      }
+    },
+    $formatComponents (arr, component = this._component) {
+      const { iterator: compIterator } = component
+      const queryPageConfigs = this.pageConfig || this.$query.pageConfigs || {}
+      const { config: pageConfigs = queryPageConfigs } = this.$pageInfo
+      const itemConfigs = pageConfigs.itemConfigs || {}
+      const page = this.upPage || this
+      const components = []
+      if (!arr) return []
+      for (const item of arr) {
+        const { configs = {}, id } = item
+        const compConfigs = itemConfigs[id] || {}
+        const allConfigs = { ...compConfigs, ...configs }
+        const { iterator, showIf, showTerminal } = allConfigs
+        const terminal = this.$isMobile ? 'mobile' : 'pc'
+        if (!showTerminal || showTerminal.includes(terminal)) {
+          if (iterator?.data) {
+            const { data, name = 'item', key = 'ID', index = 'index' } = iterator
+            let iteratorData = []
+            if (Array.isArray(data)) {
+              iteratorData = data
+            } else {
+              const matches = /^\$\[([\w.|$-]+)\]$/.exec(data)
+              if (matches) {
+                const data = { ...this.$tab, ...(page.pageParams || {}), ...this.$query, ...this.$compData, ...(compIterator || {}), template: this.template, $templateVariables: this.$templateVariables }
+                iteratorData = this.$util.getValueByPath(matches[1], data)
+              }
+            }
+            if (iteratorData && Array.isArray(iteratorData)) {
+              for (let i = 0; i < iteratorData.length; i++) {
+                const data = iteratorData[i]
+                const iteratorKey = data[key] || i
+                if (showIf) {
+                  const elData = { user: this.user, $currentRole: this.$currentRole, $tab: this.$tab, ...this.$query, ...this.$pageParams, ...(compIterator || {}), [name]: data, [index]: i, key: iteratorKey, template: this.template, $templateVariables: this.$templateVariables }
+                  if (typeof showIf === 'object') {
+                    if (showIf.el && !util.evalExpression(showIf.el, elData)) {
+                      continue
+                    }
+                  } else {
+                    if (!util.evalExpression(showIf, elData)) {
+                      continue
+                    }
+                  }
+                }
+                const component = { ...item, key: item.id + '-' + iteratorKey, iterator: { ...(compIterator || {}), [name]: data, [index]: i, key: iteratorKey } }
+                if (item.type === 'template') {
+                  components.push(component)
+                } else {
+                  components.push(component)
+                }
+              }
+            }
+          } else {
+            const elData = { user: this.user, $currentRole: this.$currentRole, $tab: this.$tab, ...this.$query, ...this.$pageParams, ...(compIterator || {}), template: this.template, $templateVariables: this.$templateVariables }
+            if (showIf) {
+              if (typeof showIf === 'string' && !util.evalExpression(showIf, elData)) {
+                continue
+              } else if (showIf.el && !util.evalExpression(showIf.el, elData)) {
+                continue
+              }
+            }
+            const component = compIterator ? { ...item, iterator: compIterator } : { ...item }
+            component.key = component.id
+            if (item.type === 'template') {
+              components.push(component)
+            } else {
+              components.push(component)
+            }
+          }
+        }
+      }
+      return components
+    },
+    $formatContent (content, data = { ...this.$tab, ...(this.upPage?.pageParams || {}), ...this.$query, ...this.$compData }) {
+      if (!content) return content
+      // 当内容整体以 {{ 开头、}} 结尾时，直接返回表达式执行结果，避免 replace 将对象类型强制转换为字符串
+      const fullMatch = content.match(/^\s*\{\{([\w-.,:?+\s|$#[/\]()"']+)\}\}\s*$/)
+      if (fullMatch) {
+        try {
+          // 表达式执行失败时保留原内容，占位符可继续交由下面的 $[...] 分支按实例上下文解析
+          return this.$util.evalExpression(fullMatch[1], data, content)
+        } catch (error) {
+          return content
+        }
+      }
+      return content.replace(/\{\{([\w-.,:?+\s|$#[/\]()"']+)\}\}/g, (macth, key) => {
+        try {
+          // 执行表达式，失败时保留原占位符
+          return this.$util.evalExpression(key, data, macth)
+        } catch (error) {
+          return `{{${key}}}`
+        }
+      }).replace(/\$\[([\w-.|$#]+)\]/g, (macth, key) => {
+        try {
+          const value = this.$util.getValueByPath(key, this) || this.$util.getValueByPath(key, data)
+          return this.$_.isNil(value) ? '' : value
+        } catch (error) {
+          return `$[${key}]`
+        }
+      })
+    },
+    /**
+     * 翻译按钮文案。组件代码内置的默认按钮（如「保存」「返回」）不在页面配置里，
+     * 服务端配置投影覆盖不到，只能走界面文案通道：以中文原文为 key 调 $t。
+     * 页面里配置出来的按钮文案已由服务端投影翻好，$t 未命中会原样返回 key，
+     * 因此对它们无副作用，重复调用也是幂等的。
+     * 按原数组缓存结果，保证同一份配置每次拿到的引用不变。
+     */
+    $translateOperates (operates) {
+      // 组件库脱离 i18n 插件单独使用时不做翻译，避免影响渲染主链路
+      if (!Array.isArray(operates) || !this.$i18n || typeof this.$t !== 'function') return operates
+      const cache = this._operatesI18nCache || (this._operatesI18nCache = new WeakMap())
+      if (cache.has(operates)) return cache.get(operates)
+      let translated = false
+      const result = operates.map(operate => {
+        if (!operate || typeof operate !== 'object') return operate
+        const { text } = operate
+        if (typeof text !== 'string' || !text) return operate
+        const value = this.$t(text)
+        if (value === text) return operate
+        translated = true
+        return { ...operate, text: value }
+      })
+      // 无一条命中译文时返回原数组，默认语言下等同于未改动
+      const value = translated ? result : operates
+      cache.set(operates, value)
+      return value
+    },
+    /**
+     * 解析 url 中的变量占位符，支持 {{CLIENT}} 和 $[CLIENT] 两种写法
+     * 变量可为实例路径表达式，如 {{$route.params.client}}、{{appConfig['CLIENT']}}
+     * 取值顺序与 $formatParams 一致：组件实例（CLIENT/SYSTEM/APP 等计算属性）→ 标签页/页面参数
+     * 无法解析的占位符保留原样
+     */
+    $formatUrl (url) {
+      if (!url) return url
+      return url.replace(/\{\{([^}]+)\}\}|\$\[((?:[^[\]]|\[[^\]]*\])+)\]/g, (match, curlyKey, bracketKey) => {
+        const key = (curlyKey || bracketKey).trim()
+        try {
+          const value = this.$util.getValueByPath(key, this)
+          if (!this.$_.isNil(value) && value !== '') return value
+          const fallback = this.$util.getValueByPath(key, { ...this.$tab, ...this.$query, ...this.$pageParams, ...this.$compData })
+          return this.$_.isNil(fallback) ? match : fallback
+        } catch (error) {
+          return match
+        }
+      })
+    },
+    $formatScope (scopeParams, data = this.data) {
+      const _scopeParams = this.$_.cloneDeep(scopeParams)
+      const that = this
+      const paramData = { ...this.$tab, ...this.$query, ...this.$pageParams, ...that.$compData }
+      for (const scopeKey in _scopeParams) {
+        const scope = _scopeParams[scopeKey]
+        if (!scope) continue
+        let values = scope.values
+        if (/#\{([\w-.|$#]+)\}/.test(values)) {
+          values = values.replace(/#\{([\w-.|$#]+)\}/, (match, key) => {
+            try {
+              // #{key} 里的 key 是相对组件实例的路径：显式传作用域，不能靠直接 eval 捕获 that（见 eval-with.js）
+              return evalWith(`that.${key}`, { that }) || evalWith(`that.$query.${key}`, { that }) || evalWith(`that.$tab.${key}`, { that }) || ''
+            } catch (error) {
+              return scope.values
+            }
+          })
+        }
+        if (/\$\[([\w-_.|$#]+)\]/.test(values)) {
+          values = values.replace(/\$\[([\w-.|$#]+)\]/, (match, key) => {
+            try {
+              return that.$util.getValueByPath(key, this) || that.$util.getValueByPath(key, paramData) || ''
+            } catch (error) {
+              return scope.values
+            }
+          })
+        }
+        if (/#\[([\w-.|$#]+)\]/.test(values)) {
+          values = values.replace(/#\[([\w-.|$#]+)\]/, (match, key) => {
+            try {
+              return evalWith(`data.${key}`, { data }) || ''
+            } catch (error) {
+              return scope.values
+            }
+          })
+        }
+        if (/\{\{([\w-_.,|$#[\]()"'\s]+)\}\}/g.test(values)) {
+          values = values.replace(/\{\{([\w-.,|$#[\]()"'\s]+)\}\}/g, (macth, key) => {
+            try {
+              // 执行表达式
+              return this.$util.evalExpression(key, paramData)
+            } catch (error) {
+              return `{{${key}}}`
+            }
+          })
+        }
+        scope.values = values
+        if (scope.scopeParams) {
+          scope.scopeParams = this.$formatScope(scope.scopeParams, data)
+        }
+      }
+      return _scopeParams
+    },
+    goWebLink (config) {
+      const { webLinkUrl } = config
+      if (!webLinkUrl) return
+      window.open(this.$formatUrl(webLinkUrl))
+    },
+    async goApp (config, item) {
+      let { serviceId, params = {} } = config
+      // 格式化params
+      const formatParams = this.$formatParams(params, item)
+      if (!serviceId && formatParams.serviceId) serviceId = formatParams.serviceId
+      if (!serviceId) return
+      let app = {}
+      await this.$http.get({
+        entityId: 'FM_SERVICE',
+        id: serviceId
+      })
+        .then(data => {
+          if (data && data.data) {
+            app = data.data
+          }
+        })
+      if (!app.SYSTEM) return
+      this.$http.get({
+        link: 'client',
+        entityId: 'FM_SYSTEM',
+        id: app.SYSTEM
+      })
+        .then(data => {
+          if (data && data.data) {
+            const rootPath = this.$util.getRootPath()
+            let url = `${rootPath}/app/${data.data['CLIENT|CODE']}/${data.data.CODE}/${app.CODE}`
+            // 拼接 query 参数（排除 serviceId 和空值）
+            const queryPairs = []
+            Object.keys(formatParams).forEach(key => {
+              if (key === 'serviceId') return
+              const value = formatParams[key]
+              if (value === undefined || value === null || value === '') return
+              queryPairs.push(`${encodeURIComponent(key)}=${encodeURIComponent(value)}`)
+            })
+            if (queryPairs.length) url += `?${queryPairs.join('&')}`
+            window.open(url)
+          }
+        })
+    },
+    /**
+     * 通用打印
+     */
+    print ({ num = 0, printWay = 'custom', printCode = '', cptName = '', params = {}, ...props }, row) {
+      // 格式化params
+      let selections = []
+      // 检测是否选中元素
+      if (row) {
+        selections = [{ ...row }]
+      } else {
+        if (this.selection) selections = [...this.selection]
+      }
+      if (num !== 0 && num !== '0') {
+        if (selections.length === 0) {
+          this.$message.error(this.$t('please select a record'))
+          return
+        } else if (selections.length > 1) {
+          if (num === 1 || num === '1') {
+            this.$message.error(this.$t('Only one record can be selected'))
+            return
+          }
+        }
+      }
+      // 添加主键
+      if (!params.id) params.id = `#[${this.$metaKey}]`
+      const formatParams = this.$formatParams(params, selections)
+      if (printWay === 'fine') {
+        const ids = selections.map(item => `'${item[this.$metaKey]}'`)
+        formatParams.id = ids.join(',')
+        this.fineReportPrint(cptName, formatParams)
+      } else {
+        this.customReportPrint(printCode, formatParams, props)
+      }
+    },
+    /**
+     * 自定义报表打印方法
+     * @param {String} code 报表编号
+     * @param {Object} params 参数
+     */
+    customReportPrint (code, params, props) {
+      if (params.code) code = params.code
+      this.$http.find({
+        entityId: 'FM_FORM',
+        'scope.CODE': code
+      })
+        .then(data => {
+          const { NAME } = data.data
+          this.$createPage({
+            component: 'excel-preview-page',
+            name: NAME,
+            code,
+            params,
+            openType: props.openMode,
+            ...props
+          })
+        })
+    },
+    fineReportPrint (cptName, params) {
+      const { 'CLIENT|CODE': client } = this.appConfig
+      const rootPath = window.IP + 'report/ReportServer'
+      let query = `?client=${client}&reportlet=com.epxing.frame.core.report.ReportReader&__bypagesize__=false&cptname=${cptName}`
+      for (const key in params) {
+        query += '&' + key + '=' + params[key]
+      }
+
+      const token = this.$util.getToken(client) || ''
+      window.open(rootPath + query + '&token=' + token)
+    },
+
+    /**
+     * 执行自定义JS
+     */
+    executeCustomJs (functionName, ...args) {
+      let pageEvents = {}
+      if (this.isPage) {
+        pageEvents = this.pageEvents
+      } else if (this.template) {
+        pageEvents = this.template.pageEvents
+      } else {
+        pageEvents = this.upPage.pageEvents
+      }
+      if (functionName && pageEvents[functionName]) {
+        const fn = pageEvents[functionName]
+        if (!isSafeFn(fn)) return false
+        return fn.call(this, ...args)
+      } else {
+        return true
+      }
+    },
+    customJs ({ function: functionName, ...otherConfigs }, row) {
+      this.executeCustomJs(functionName, row || otherConfigs, otherConfigs)
+    },
+
+    commonRuleAction (config, ...props) {
+      this.commonAction({ ...config, requestType: 'rule' }, ...props)
+    },
+    /**
+     * 通用请求
+     * @param action 请求命令
+     * @param rule 请求业务规则
+     * @param metaId 请求对象，默认为当前页面对象
+     * @param num 选中记录数(1,必须选中且只能选中一条记录；n：必须选中至少一条记录；0不需要选中记录)
+     * @param comfirmMsg 操作提交之前的确认信息（如果为空，就不需要确认）
+     * @param params #[列表对象的某字段名]"，(如果是选中的多条记录，将字段值拼成一个字符串，用逗号隔开) "$[当前页面的某变量名]"
+     * @param successMsg 操作成功的提示
+     * @param failMsg 操作失败的提示
+     * @param row 操作的列
+     */
+    commonAction ({ id, text, requestType, action, rule, metaId = (this.$metaId), num = 0, confirm, confirmMsg = null, confirmButtonText, cancelButtonText, mask = false, params = {}, successMsg = '处理成功', failMsg = '处理失败', afterTrigger, afterTriggerPage, afterTriggerPageOpenMode, afterTriggerParams }, row) {
+      let selections = []
+      // 检测是否选中元素
+      if (row) {
+        selections = [{ ...row }]
+      } else {
+        if (this.selection) selections = [...this.selection]
+      }
+      if (selections.length === 0) {
+        if (num !== 0 && num !== '0') {
+          this.$message.error(this.$t('please select a record'))
+          return
+        }
+      } else if (selections.length > 1) {
+        if (num === 1 || num === '1') {
+          this.$message.error(this.$t('Only one record can be selected'))
+          return
+        }
+      }
+
+      if (!params.id) {
+        params.id = `#[${this.$metaKey}]`
+      }
+      const formatParams = this.$formatParams(params, selections)
+      const loadingKey = id || text || `common-${action}`
+      // 提交方法
+      const submitFn = () => {
+        if (this.httpLoading[loadingKey]) {
+          return this.$message.error('正在提交，请稍后...')
+        }
+        this.httpLoading[loadingKey] = true
+        let loading = null
+        if (mask) {
+          loading = this.$loading({
+            target: this.upPage ? this.upPage.$parent.$el : this.$el,
+            background: 'rgba(255, 255, 255, 0.5)',
+            text: '正在操作,请稍后...',
+            lock: true
+          })
+        }
+        const timer = setTimeout(() => {
+          this.httpLoading[loadingKey] = false
+          clearTimeout(timer)
+        }, 2000)
+        const params = {
+          action,
+          entityId: metaId,
+          ...formatParams
+        }
+        if (requestType === 'rule') params.rule = rule
+
+        this.$http.$post(params)
+          .then((res) => {
+            // 如果存在下一个事件，执行下一个事件
+            const _afterTriggerParams = this.$formatAfterTriggerParams(afterTriggerParams, { res, data: row || this.data })
+            this.$message.success(successMsg)
+            if (afterTrigger) {
+              this[afterTrigger]({ pageId: afterTriggerPage, openMode: afterTriggerPageOpenMode, params: _afterTriggerParams })
+            } else {
+              if (this.reloadData) this.reloadData()
+            }
+            // 广播「这一页的数据被改动了」。reloadData 只刷自己那张列表，够不到同一页上的
+            // 统计卡：处理完一条待办，列表少一行而顶上的「待办 N」还是原来的数字，
+            // 看着像统计不准。谁关心谁监听（见 CardNum 的 data-changed）
+            if (this.$event) this.$event.emit('data-changed', { action, metaId })
+          })
+          .catch(err => {
+            this.$message.error(err.message || failMsg)
+          })
+          .finally(() => {
+            this.httpLoading[loadingKey] = false
+            if (loading) loading.close()
+          })
+      }
+      // 判断是否需要确认弹窗
+      if (confirm && confirmMsg) {
+        this.$confirm(confirmMsg, this.$t('hint'), {
+          confirmButtonText: confirmButtonText || this.$t('confirm'),
+          cancelButtonText: cancelButtonText || this.$t('cancel'),
+          type: 'warning'
+        }).then(() => {
+          submitFn()
+        })
+      } else {
+        submitFn()
+      }
+    },
+    /**
+     * 下载文件
+     * @param action 请求命令
+     * @param rule 请求业务规则
+     * @param metaId 请求对象，默认为当前页面对象
+     * @param num 选中记录数(1,必须选中且只能选中一条记录；n：必须选中至少一条记录；0不需要选中记录)
+     * @param comfirmMsg 操作提交之前的确认信息（如果为空，就不需要确认）
+     * @param params #[列表对象的某字段名]"，(如果是选中的多条记录，将字段值拼成一个字符串，用逗号隔开) "$[当前页面的某变量名]"
+     * @param successMsg 操作成功的提示
+     * @param failMsg 操作失败的提示
+     * @param row 操作的列
+     */
+    downloadFile ({ requestType, action, rule, metaId = (this.$metaId), num = 0, confirm, confirmMsg = null, confirmButtonText, cancelButtonText, mask = false, params = {}, successMsg = '处理成功', failMsg = '处理失败', afterTrigger, afterTriggerPage, afterTriggerParams }, row) {
+      let selections = []
+      // 检测是否选中元素
+      if (row) {
+        selections = [{ ...row }]
+      } else {
+        if (this.selection) selections = [...this.selection]
+      }
+      if (selections.length === 0) {
+        if (num !== 0 && num !== '0') {
+          this.$message.error(this.$t('please select a record'))
+          return
+        }
+      } else if (selections.length > 1) {
+        if (num === 1 || num === '1') {
+          this.$message.error(this.$t('Only one record can be selected'))
+          return
+        }
+      }
+
+      if (!params.id) {
+        params.id = `#[${this.$metaKey}]`
+      }
+      // 格式化params
+      const formatParams = this.$formatParams(params, selections)
+      // 提交方法
+      const submitFn = () => {
+        if (this.httpLoading[`common-${action}`]) {
+          return this.$message.error('正在提交，请稍后...')
+        }
+        this.httpLoading[`common-${action}`] = true
+        let loading = null
+        if (mask) {
+          loading = this.$loading({
+            target: this.upPage ? this.upPage.$parent.$el : this.$el,
+            background: 'rgba(255, 255, 255, 0.5)',
+            text: '正在操作,请稍后...',
+            lock: true
+          })
+        }
+        const timer = setTimeout(() => {
+          this.httpLoading[`common-${action}`] = false
+          clearTimeout(timer)
+        }, 2000)
+        const params = {
+          action,
+          entityId: metaId,
+          ...formatParams
+        }
+        if (requestType === 'rule') params.rule = rule
+
+        this.$http.$post(params, {
+          responseType: 'blob'
+        })
+          .then(({ blob, filename }) => {
+            var a = document.createElement('a')
+            document.body.appendChild(a)
+            const objectUrl = URL.createObjectURL(blob)
+            a.href = objectUrl
+            a.download = filename
+            a.click()
+            window.URL.revokeObjectURL(objectUrl)
+            document.body.removeChild(a)
+            // 如果存在下一个事件，执行下一个事件
+            const _afterTriggerParams = this.$formatAfterTriggerParams(afterTriggerParams, { data: row || this.data })
+            this.$message.success(successMsg)
+            if (afterTrigger) {
+              this[afterTrigger]({ pageId: afterTriggerPage, params: _afterTriggerParams })
+            } else {
+              if (this.reloadData) this.reloadData()
+            }
+          })
+          .catch(err => {
+            this.$message.error(err.message || failMsg)
+          })
+          .finally(() => {
+            this.httpLoading[`common-${action}`] = false
+            if (loading) loading.close()
+          })
+      }
+      // 判断是否需要确认弹窗
+      if (confirm && confirmMsg) {
+        this.$confirm(confirmMsg, this.$t('hint'), {
+          confirmButtonText: confirmButtonText || this.$t('confirm'),
+          cancelButtonText: cancelButtonText || this.$t('cancel'),
+          type: 'warning'
+        }).then(() => {
+          submitFn()
+        })
+      } else {
+        submitFn()
+      }
+    },
+    $refesh () {
+      // this.$children.forEach(child => {
+      //   if (child.$options.componentType === 'component') {
+      //     if (child.$refesh) child.$refesh()
+      //   }
+      // })
+    },
+    $refeshPage () {
+      if (this.upPage) this.upPage.$refesh()
+    },
+    // 获取上级页面
+    $getParentPage () {
+      var parent = this.$parent || this.$root
+      var type = parent.$options.$componentType
+
+      while (parent && (!type || type !== 'page')) {
+        parent = parent.$parent
+
+        if (parent) {
+          type = parent.$options.componentName
+        }
+      }
+      if (parent) {
+        return parent
+      }
+    },
+    // 修改上级页面数据
+    $setParentPageModel (model) {
+      if (this.$parentPage) {
+        for (const key in model) {
+          this.$parentPage.model[key] = model[key]
+        }
+      }
+    },
+    // 调用上级页面内组件事件
+    $dispatchComponent (id, eventName, ...params) {
+      if (this.$parentPage) { // 组件id
+        broadcast.apply(this.$parentPage, [id, eventName, ...params])
+      }
+    },
+    // 获取页面内组件（T31：注册表 byId，替代 $children 树遍历）
+    $getPageComponent (id, current = this, prefix) {
+      const newId = prefix ? prefix + '-' + id : id
+      const page = current && current._epxPage ? current._epxPage() : this._epxPage()
+      const reg = page && page._epxReg
+      return reg ? reg.byId.get(newId) : undefined
+    },
+    $excuteEvent (key, ...args) {
+      const { componentEvents = [] } = this.$configs
+      const { [key]: keyEvents = [] } = componentEvents
+      keyEvents.map(event => this.executeCustomJs(event, ...args))
+    },
+    // 这些方法依赖实例属性（如 httpLoading），保留在混入中
+    $setPageConfig (page) {
+      const currentPage = page || this.page || {}
+      const { config = this.compConfigs } = currentPage
+      for (const key in this.$options) {
+        if (isCustomOption(key, this.$options[key])) {
+          this.pageConfig[key] = this.$options[key]
+        }
+      }
+      for (const key in config) {
+        try {
+          if (this.$_.isObject(config[key])) {
+            if (Array.isArray(config[key])) {
+              this.pageConfig[key] = [...config[key]]
+            } else {
+              // ⚠️ 别往 $options 上写。它是 Vue 按**组件类型**缓存的
+              // （appContext.optionsCache），同一个 app 里该类型所有实例共用同一个对象。
+              // 原先写的是 `if (!this.$options[key]) this.$options[key] = {}`，于是任何一个
+              // 页面配置里出现过的对象型键都被永久种进了共享 $options，此后所有同类型实例
+              // 都会读到 `{}` 而不是 `undefined`——假值变真值，`if (x)` 分支整个翻转，
+              // 而且**取决于页面访问顺序**，刷新即恢复，极难归因。
+              // `if (!x) x = {}` 之后再展开，与直接展开 `x || {}` 完全等价（原逻辑也只在
+              // 假值时赋 {}），所以去掉写入不改变合并结果。回归测试见
+              // test/unit/config-options-isolation.test.js。
+              this.pageConfig[key] = { ...(this.$options[key] || {}), ...config[key] }
+            }
+          } else {
+            this.pageConfig[key] = config[key]
+          }
+        } catch (error) {
+          this.pageConfig[key] = config[key]
+        }
+      }
+    },
+    $setCompConfigs () {
+      for (const key in this.$options) {
+        if (isCustomOption(key, this.$options[key])) {
+          this.configs[key] = this.$options[key]
+        }
+      }
+      for (const key in this.compConfigs) {
+        try {
+          if (this.$_.isObject(this.compConfigs[key])) {
+            if (Array.isArray(this.compConfigs[key])) {
+              this.configs[key] = [...this.compConfigs[key]]
+            } else {
+              // 同上：不写共享 $options（见 $setPageConfig 里的说明）
+              this.configs[key] = { ...(this.$options[key] || {}), ...this.compConfigs[key] }
+            }
+          } else {
+            this.configs[key] = this.compConfigs[key]
+          }
+        } catch (error) {
+          this.configs[key] = this.compConfigs[key]
+        }
+      }
+    },
+    _createComponent () {
+      let height = ''
+      // 页面配置
+      const _configs = {}
+      const globalConfigs = (this.componentGlobalConfig && this.componentGlobalConfig[this.contentType]) || {}
+      const systemGlobalConfigs = (this.systemComponentGlobalConfig && this.systemComponentGlobalConfig[this.contentType]) || {}
+      const queryPageConfigs = this.pageConfig || this.$query.pageConfigs || {}
+      const { config: pageConfigs = queryPageConfigs } = this.$pageInfo
+      const { css, itemConfigs = {}, ...otherConfigs } = pageConfigs
+      const _itemConfigs = this.itemConfigs || itemConfigs
+      const itemConfig = _itemConfigs[this.compId]
+      let allConfigs = { ...globalConfigs, ...systemGlobalConfigs, ...this.compConfigs, ...itemConfig }
+      if (this.isPage) {
+        allConfigs = { ...allConfigs, ...otherConfigs }
+        // 获取函数库
+        const exports = {}
+        // eslint-disable-next-line no-eval
+        eval('(function (exports) {' + pageConfigs.compileJS + ' }(exports));')
+        this.pageEvents = { ...exports }
+        if (css) {
+          appendCss(this.$pageId, css)
+        }
+      } else {
+        const { css } = this._component
+        if (css) {
+          appendCss(this.compId, css)
+        }
+      }
+      // 从组件 $options 收割「配置点默认值」。判定统一走 isCustomOption——
+      // 这里原先另有一份内联的保留名单，和 custom-option.js 的那份各写各的，已经漂了：
+      // 内联那份少 18 个键，其中最要命的是 **extends**。Vue 3 的 mergeOptions 对 extends
+      // 没有合并策略、直接把基类定义对象赋到解析后的 $options 上（runtime-core 4031-4039），
+      // 于是每个 `extends: XxxList` 的组件都会把**整个基类定义对象**当成配置点塞进 configs，
+      // 被 $configs 每次重算时整体拷贝、被 get-component 广播出去。
+      // 本仓库 61 个组件用了 extends。另有 activated/deactivated/updated 等钩子数组同样泄漏。
+      //
+      // 注意这个过滤只作用在「收割默认值」这一步；页面配置走下面的 allConfigs 合并，
+      // 不受影响——所以线上已有的页面配置数据语义不变。
+      for (const key in this.$options) {
+        if (isCustomOption(key, this.$options[key])) {
+          _configs[key] = this.$options[key]
+        }
+      }
+      for (const key in allConfigs) {
+        try {
+          if (this.$_.isObject(allConfigs[key])) {
+            if (Array.isArray(allConfigs[key])) {
+              _configs[key] = [...allConfigs[key]]
+            } else {
+              // 同上：不写共享 $options（见 $setPageConfig 里的说明）
+              _configs[key] = { ...(this.$options[key] || {}), ...allConfigs[key] }
+            }
+          } else {
+            _configs[key] = allConfigs[key]
+          }
+        } catch (error) {
+          _configs[key] = allConfigs[key]
+        }
+      }
+      const { items = [], mItems, style = {} } = _configs
+      delete _configs.items
+      const _items = this.items || items
+      const configs = { ...this.configs, ..._configs }
+      this.configs = configs
+
+      if (configs.height) {
+        height = typeof configs.height === 'string' && configs.height.includes('%') ? configs.height : configs.height + 'px'
+      }
+      // 获取页面配置
+      const _style = { ...style, ...this.compStyle }
+      if (_style.backgroundImage) {
+        _style.backgroundImage = _style.backgroundImage.replace(/url\s*\(([\w+-/.\s]+)\)/g, (str, $1) => {
+          return `url(${util.getFileUrl($1)})`
+        })
+      }
+      if (height) _style.height = height
+      this.component = {
+        id: this.compId || this.$pageId,
+        title: this.$formatContent(this.compTitle || this.$attrs.title),
+        contentType: this.contentType,
+        style: _style,
+        configs: this.$configs,
+        flex: this.compFlex === undefined ? !!this.$configs.flex : !!this.compFlex,
+        items: _items, // 子节点
+        mItems,
+        metaId: this.$metaId,
+        meta: this.$meta,
+        parentPage: this.$getParentPage()
+      }
+      this.$emit('get-component', this.component)
+      this.$event.emit('get-component', this.component)
+      if (this.isPage) {
+        this.component.itemConfigs = itemConfigs
+      }
+      this.$emit('load-component', this.component)
+      this.$event.emit('load-component', this.component)
+    },
+
+    // 创建组件前
+    beforeCreateComponent () {
+    },
+    // 初始化配置 可在此更改默认配置
+    beforeInitComponent () {
+
+    },
+    /**
+     * 初始化组件
+     */
+    initComponent (component) {
+
+    }
+  },
+  async created () {
+    // T31 修正：注册必须早于下面 _createComponent() 发出的 `load-component`——BasePage 收到该
+    // 事件后要用 getComponentById 拿本组件实例、给页面变量建 $watch，注册晚了就恒为 undefined、
+    // 在 BasePage.watchCompValue 里静默早退（页面变量恒空 ⇒ 由它驱动的 scopeParams 条件被
+    // createHttp 整条丢弃）。Vue2 靠 $children（在 _init 里就填好、早于 created）天然满足这个
+    // 不变式；Vue3 没有 $children，改用 _epxReg 之后这个先后顺序就得自己保证。
+    // mounted 里那句保留不删：Map.set / Set.add 幂等，重复注册零代价。
+    this._epxRegister()
+    // ⚠️ `compoennt` 是笔误（少个 n），**别顺手改对**——它是承重的。
+    // 原意见 global.js 里对称的那一对：「非 page → setCompConfigs / 非 component → setPageConfig」，
+    // 即 $setPageConfig() 本该只跑在页面上。笔误让条件恒真 ⇒ 多年来**每个**组件都在跑它，
+    // 于是 _createComponent() / $formatComponents() 的 pageConfig 回退路径，以及
+    // Collapse / ApprovalIndex / TaskList / TodoList / PermissManage / Template 等组件里的
+    // `this.pageConfig.xxx` 读取，全都建立在这个恒真之上。
+    // 拼写改对 = 所有非页面组件的 pageConfig 一次性清零 ⇒ 按 compId 下发的逐组件配置静默丢失
+    // （按钮不渲染、checkPageId / detailPageFlag 变 undefined 走错分支），而且现有单测抓不到
+    // （component-register-timing.test.js 把 $setPageConfig stub 掉了，只断言注册顺序）。
+    // 真要收敛回原意，得当独立重构立项：先给每个消费点补断言，再改条件，最后跑全量 e2e。
+    if (this.$options.$componentType !== 'compoennt') {
+      this.$setPageConfig()
+    }
+    this.$componentStatus = 'beforeCreate'
+    this.beforeCreateComponent()
+    // 创建组件
+    this._createComponent()
+    this.$componentStatus = 'created'
+    try {
+      this.oldCompConfigs = this.$_.cloneDeep(this.compConfigs)
+    } catch (error) {}
+    // 初始化组件配置
+    this.$componentStatus = 'beforeInit'
+    const component = this.beforeInitComponent()
+    if (component instanceof Promise) {
+      await component
+    }
+    if (this._isBeingDestroyed || this._isDestroyed) return
+    // 如果this.$metaId 并且不存在this.$meta 获取meta对象
+    if (this.$metaId && !this.$meta) {
+      await this.$store.dispatch({
+        type: 'ADD_META',
+        metaId: this.$metaId
+      })
+    }
+    if (this._isBeingDestroyed || this._isDestroyed) return
+    // 初始化组件
+    this.$componentStatus = 'init'
+    this.initComponent(this.$component)
+    this.$nextTick(() => {
+      if (this._isBeingDestroyed || this._isDestroyed) return
+      if (this.$el) {
+        const compId = this.isPage ? this.$pageId : this.compId
+        if (this.$el.classList) {
+          this.$el.classList.add('css_' + compId)
+        } else {
+          this.$el.className = 'css_' + compId
+        }
+      }
+    })
+  },
+  mounted () {
+    // T31：组件注册表（替代 $children 树遍历，Vue3 无 $children）。每组件注册进其页面的
+    // _epxRegistry，broadcast/getComponentById 改 O(1) 查表。页面级作用域（upPage 就近）。
+    this._epxRegister()
+    // 系统返回（popstate）已由 @epxing/utils/src/nav-history 的全局唯一监听器统一处理，
+    // 不再每个页面各挂一个（keep-alive 缓存页/隐藏 tab 页的监听器会导致一次返回连弹多页）
+    this.$excuteEvent('onMounted')
+  },
+  unmounted () {
+    this._epxDeregister() // T31：从页面注册表注销
+    const compId = this.isPage ? this.$pageId : this.compId
+    removeCss(compId)
+    // 1. 清理事件监听器
+    if (this._pageEventHandlers && this._pageEventHandlers.length) {
+      for (const { comp, event, handler } of this._pageEventHandlers) {
+        // 解绑到真正绑定的 page component 上
+        if (comp && comp.$epxOff) comp.$epxOff(event, handler)
+      }
+    }
+    this._pageEventHandlers = []
+
+    // 2. 清理 openedPopup 中对当前组件的引用（关键！防止连锁泄漏）
+    // 如果当前组件被保存在 openedPopup 数组中（通过 opener 引用），
+    // 即使组件销毁了，openedPopup 仍然持有引用，导致整个引用链无法回收
+    if (window.openedPopup && Array.isArray(window.openedPopup)) {
+      for (let i = window.openedPopup.length - 1; i >= 0; i--) {
+        const popup = window.openedPopup[i]
+        if (popup && popup.opener === this) {
+          // 清理 opener 引用，防止阻止垃圾回收
+          popup.opener = null
+          // 如果弹窗已经关闭，从数组中移除
+          if (popup.closed || !popup.visible) {
+            window.openedPopup.splice(i, 1)
+          }
+        }
+      }
+    }
+
+    // 3. 清理 component 对象中的循环引用
+    if (this.component) {
+      // 清理 parentPage 引用（防止父页面持有子组件引用导致无法回收）
+      if (this.component.parentPage) {
+        this.component.parentPage = null
+      }
+      // 清理其他可能的引用
+      this.component = null
+    }
+
+    // 4. 执行组件自定义的销毁事件
+    //    ⚙️ 见文件顶部 EXEC_ON_DESTORY_ON_TEARDOWN（评审 C2）：整棵页面树被销毁这条**本次新唤醒**的
+    //    路径上保持 Task 17 之前的语义（不跑用户脚本）；单个组件被摘掉的路径照常跑。
+    if (EXEC_ON_DESTORY_ON_TEARDOWN || !isEpxTeardown(this.$)) {
+      this.$excuteEvent('onDestory')
+    }
+  },
+  beforeUnmount () {
+    // ⚙️ 与上面 onDestory 同一道闸门（最终评审 I-1）：M0 的真卸载把 bum 和 um **两个**钩子一起
+    // 唤醒了，而 EXEC_ON_DESTORY_ON_TEARDOWN 原来只挡住了 um 那半边 —— `onBeforeDestory` 是
+    // 同一类低代码用户脚本的逃逸口（线上页面配置里可能存在从未执行过的脚本），漏掉它等于闸门只关了一半。
+    // `_epxTeardown` 由 RouterView 在剪枝前打上，bum 触发时已就位。
+    if (EXEC_ON_DESTORY_ON_TEARDOWN || !isEpxTeardown(this.$)) {
+      this.$excuteEvent('onBeforeDestory')
+    }
+  }
+}