adtec-core-package 3.3.0 → 3.3.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adtec-core-package",
-  "version": "3.3.0",
+  "version": "3.3.2",
   "private": false,
   "type": "module",
   "exports": {

package/src/components/autoToolTip/ElAutoToolTip.vue

@@ -8,6 +8,7 @@
     :content="props.tooltipContent ? props.tooltipContent : props.content"
     placement="top"
     :disabled="isShow"
+    :popper-options="{ strategy: 'fixed' }"
   >
     <template #content>
       <!-- 此处的默认值先看tooltipContent有没有，没有就给默认content -->

package/src/components/upload/OfficePreview.vue

@@ -4,18 +4,19 @@
       <office-preview-header-bar
         v-if="showHeader"
         :title="headerTitle"
+        :title-only="previewLoadFailed"
         :zoom="scale"
         :current-page="previewCurrentPage"
         :total-pages="previewTotalPages"
         :search-query="searchQuery"
         :search-index="searchMatchIndex"
         :search-total="searchMatchTotal"
-        :show-search="showSearch"
-        :show-page-nav="showPageNav && officeType !== 'excel'"
-        :show-zoom="showZoom"
-        :show-download="showDownload"
-        :show-refresh="showRefresh"
-        :show-fullscreen="showFullscreen"
+        :show-search="showHeaderSearch"
+        :show-page-nav="showHeaderPageNav"
+        :show-zoom="showHeaderZoom"
+        :show-download="showHeaderDownload"
+        :show-refresh="showHeaderRefresh"
+        :show-fullscreen="showHeaderFullscreen"
         :show-close="showClose"
         :fullscreen="fullscreen"
         :download-loading="downloadLoading"
@@ -79,6 +80,9 @@
             <p v-if="headerTitle" class="loading-sub">{{ headerTitle }}</p>
           </div>
         </div>
+        <div v-else-if="previewLoadFailed" class="office-rich-lost">
+          <el-empty :description="lostDescription" />
+        </div>
         <div v-else-if="isPreviewLoading && !fileSrc" class="office-rich-loading">
           <div class="loading-card">
             <span class="loading-spinner" />
@@ -137,6 +141,10 @@ const props = withDefaults(
     fullscreen?: boolean
     downloadLoading?: boolean
     refreshLoading?: boolean
+    /** 库里有附件记录但物理文件无法加载时的提示 */
+    lostDescription?: string
+    /** 父组件已判定附件丢失（如无下载地址）时直接展示丢失态 */
+    attachmentLost?: boolean
   }>(),
   {
     showHeader: true,
@@ -150,6 +158,8 @@ const props = withDefaults(
     fullscreen: false,
     downloadLoading: false,
     refreshLoading: false,
+    lostDescription: '附件已丢失',
+    attachmentLost: false,
   },
 )
 
@@ -176,6 +186,7 @@ const searchQuery = ref('')
 const searchMatchIndex = ref(-1)
 const searchMatchTotal = ref(0)
 const isPreviewLoading = ref(false)
+const previewLoadFailed = ref(false)
 const loadingPhase = ref<'fetch' | 'open'>('fetch')
 
 type RichViewer = {
@@ -201,11 +212,21 @@ const isLegacyDoc = computed(() =>
 
 const isRichPreview = computed(
   () =>
+    props.attachmentLost ||
     officeType.value === 'pdf' ||
     officeType.value === 'excel' ||
     officeType.value === 'docx',
 )
 
+const showHeaderSearch = computed(() => props.showSearch && !previewLoadFailed.value)
+const showHeaderPageNav = computed(
+  () => props.showPageNav && !previewLoadFailed.value && officeType.value !== 'excel',
+)
+const showHeaderZoom = computed(() => props.showZoom && !previewLoadFailed.value)
+const showHeaderDownload = computed(() => props.showDownload && !previewLoadFailed.value)
+const showHeaderRefresh = computed(() => props.showRefresh && !previewLoadFailed.value)
+const showHeaderFullscreen = computed(() => props.showFullscreen && !previewLoadFailed.value)
+
 const isUnsupportedType = computed(
   () => !!officeType.value && !isSupportedPreviewType(officeType.value),
 )
@@ -235,13 +256,25 @@ const resetPreview = () => {
   searchMatchIndex.value = -1
   searchMatchTotal.value = 0
   isPreviewLoading.value = false
+  previewLoadFailed.value = false
   loadingPhase.value = 'fetch'
   pdfViewerRef.value?.clearSearch()
   excelViewerRef.value?.clearSearch()
   docxViewerRef.value?.clearSearch()
 }
 
+const markPreviewLost = (err?: unknown) => {
+  isPreviewLoading.value = false
+  previewLoadFailed.value = true
+  fileSrc.value = undefined
+  emit('error', err)
+}
+
 const loadPreview = async () => {
+  if (props.attachmentLost) {
+    markPreviewLost()
+    return
+  }
   if (!props.url || !officeType.value) {
     return
   }
@@ -262,6 +295,10 @@ const loadPreview = async () => {
       }
       loadingPhase.value = 'open'
       const pdfBlob = await documentApi.previewWordAsPdf(props.fileId)
+      if (!pdfBlob || pdfBlob.size === 0) {
+        markPreviewLost()
+        return
+      }
       previewAsPdf.value = true
       fileSrc.value = pdfBlob
       return
@@ -273,16 +310,22 @@ const loadPreview = async () => {
     })
     if (officeType.value === 'txt') {
       txtContent.value = await res.data.text()
+      if (!txtContent.value.trim()) {
+        markPreviewLost()
+        return
+      }
       isPreviewLoading.value = false
       emit('loaded')
     } else {
       loadingPhase.value = 'open'
+      if (!res.data || res.data.size === 0) {
+        markPreviewLost()
+        return
+      }
       fileSrc.value = res.data
     }
   } catch (err) {
-    isPreviewLoading.value = false
-    frameworkUtils.messageError(err)
-    emit('error', err)
+    markPreviewLost(err)
   }
 }
 
@@ -294,8 +337,7 @@ const handleRendered = async () => {
 }
 
 const handleError = (err?: unknown) => {
-  isPreviewLoading.value = false
-  emit('error', err)
+  markPreviewLost(err)
 }
 
 const zoomIn = () => {
@@ -357,9 +399,13 @@ const goNextSearchMatch = async () => {
 }
 
 watch(
-  () => [props.url, props.fileName, props.fileType] as const,
-  ([fileUrl]) => {
+  () => [props.url, props.fileName, props.fileType, props.attachmentLost] as const,
+  ([fileUrl, , , attachmentLost]) => {
     resetPreview()
+    if (attachmentLost) {
+      markPreviewLost()
+      return
+    }
     if (fileUrl) {
       loadPreview()
     }
@@ -395,6 +441,9 @@ defineExpose({
     display: flex;
     flex-direction: column;
     overflow: hidden;
+    padding-bottom: 8px;
+    box-sizing: border-box;
+    background: #fff;
   }
 
   &.is-fullscreen {
@@ -402,6 +451,9 @@ defineExpose({
     background: #f5f5f5 !important;
 
     &.is-rich-preview {
+      padding-bottom: 0;
+      background: #f5f5f5 !important;
+
       .office-rich-wrap {
         flex: 1;
         min-height: 0;
@@ -434,6 +486,16 @@ defineExpose({
   flex-direction: column;
 }
 
+.office-rich-lost {
+  position: absolute;
+  inset: 0;
+  z-index: 3;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  background: #fff;
+}
+
 .office-rich-loading {
   position: absolute;
   inset: 0;

package/src/components/upload/OfficePreviewHeaderBar.vue

@@ -1,5 +1,5 @@
 <template>
-  <div class="office-preview-header">
+  <div class="office-preview-header" :class="{ 'is-title-only': titleOnly }">
     <div v-if="title" class="header-title" :title="title">{{ title }}</div>
 
     <div v-if="showSearch" class="header-search">
@@ -138,6 +138,7 @@ import { MAX_PDF_ZOOM, MIN_OFFICE_ZOOM } from '../../utils/officePreviewUtil.ts'
 const props = withDefaults(
   defineProps<{
     title?: string
+    titleOnly?: boolean
     zoom?: number
     currentPage?: number
     totalPages?: number
@@ -159,6 +160,7 @@ const props = withDefaults(
   }>(),
   {
     title: '',
+    titleOnly: false,
     zoom: 1,
     currentPage: 1,
     totalPages: 0,
@@ -234,6 +236,11 @@ const emitSearch = () => {
   flex-shrink: 0;
 }
 
+.is-title-only .header-title {
+  max-width: none;
+  flex: 1;
+}
+
 .header-search {
   display: flex;
   align-items: center;

package/src/config/ElementPlusConfig.ts

@@ -21,7 +21,10 @@ import elementPlus, {
   ElCascader,
   ElTable,
   ElTooltip,
+  ElPopover,
+  ElDropdown,
 } from 'element-plus'
+import { patchWujiePopperCoordinates } from '../utils/patchWujiePopperCoordinates'
 
 /**
  * vxe 单元格编辑时，Element 下拉/日期面板默认 teleport 到 body。
@@ -82,6 +85,33 @@ ElSelect.props.fitInputWidth = {
   type: Boolean,
   default: false,
 }
+const isWujieSubApp =
+  typeof window !== 'undefined' && !!(window as Window & { __POWERED_BY_WUJIE__?: boolean }).__POWERED_BY_WUJIE__
+/**
+ * 无界 iframe 内 Popper 坐标修正（与下拉框数据页同类问题）。
+ * ElSelect / ElDatePicker 等须保持 teleported 默认 true（vxe 单元格挂 body + popperClass 防 clearEdit），
+ * 仅通过 strategy/modifiers 修正偏移，避免各子应用逐页 v-bind。
+ */
+const wujiePopperOptions = {
+  strategy: 'fixed' as const,
+  modifiers: [
+    {
+      name: 'computeStyles',
+      options: { adaptive: false, gpuAcceleration: false },
+    },
+  ],
+}
+if (isWujieSubApp) {
+  patchWujiePopperCoordinates()
+  const wujiePopperProps = { type: Object, default: () => wujiePopperOptions }
+  ElSelect.props.popperOptions = wujiePopperProps
+  ElDatePicker.props.popperOptions = wujiePopperProps
+  ElTreeSelect.props.popperOptions = wujiePopperProps
+  ElCascader.props.popperOptions = wujiePopperProps
+  ElTooltip.props.popperOptions = wujiePopperProps
+  ElPopover.props.popperOptions = wujiePopperProps
+  ElDropdown.props.popperOptions = wujiePopperProps
+}
 ElSelect.props.popperClass = {
   type: String,
   default: VXE_IGNORE_CLEAR_POPPER,

package/src/config/VxeTableConfig.ts

@@ -17,6 +17,7 @@ import { VxeUIPluginExportPDF } from '@vxe-ui/plugin-export-pdf'
 import { jsPDF } from 'jspdf'
 // 导入默认的语言（使用 es 构建，避免 lib CJS 在 Vite 下无 default 导出）
 import zhCN from 'vxe-table/es/locale/lang/zh-CN'
+import { patchWujiePopperCoordinates } from '../utils/patchWujiePopperCoordinates'
 
 /**
  * 导出插件（Excel/PDF）全局注册一次。
@@ -32,7 +33,9 @@ function registerVxeExportPlugins() {
   VxeUI.use(VxeUIPluginExportXLSX, { ExcelJS })
   VxeUI.use(VxeUIPluginExportPDF, { jsPDF })
 }
-// 模块加载即注册，确保任何 grid 创建前 xlsx/pdf 类型已可用
+import { patchWujiePopperCoordinates } from '../utils/patchWujiePopperCoordinates'
+
+// 模块加载即注册导出插件；无界坐标补丁亦在 patch 模块内执行
 registerVxeExportPlugins()
 
 /**
@@ -43,6 +46,7 @@ export function initVxeTableInPage(
   enablePdf: boolean = false,
   enableElementPlus: boolean = true,
 ) {
+  patchWujiePopperCoordinates(true)
   // 设置语言
   VxeUI.setI18n('zh-CN', zhCN)
   VxeUI.setLanguage('zh-CN')

package/src/hooks/useDictHooks.ts

@@ -7,6 +7,39 @@ import { storeToRefs } from 'pinia'
 import { userInfoStore } from '../stores/userInfoStore.ts'
 import frameworkUtils from '../utils/FrameworkUtils.ts'
 
+/**
+ * 后端在带 orgId 且 Redis 未命中时，可能返回带 parentId 的扁平列表（未 buildTree）。
+ * 前端按 parentId 重建 children，恢复领域/项目类型等树形字典。
+ */
+const ensureDictTree = (list?: ISysDictDataCacheVo[]): ISysDictDataCacheVo[] => {
+  if (!list?.length) return list ?? []
+  if (list.some((item) => Array.isArray(item.children) && item.children.length > 0)) {
+    return list
+  }
+  const nodeMap = new Map<string, ISysDictDataCacheVo>()
+  list.forEach((item) => {
+    if (!item?.id) return
+    nodeMap.set(item.id, { ...item, children: undefined })
+  })
+  if (!nodeMap.size) return list
+
+  const roots: ISysDictDataCacheVo[] = []
+  let linked = 0
+  nodeMap.forEach((node) => {
+    const parentId = node.parentId
+    if (parentId && parentId !== '0' && nodeMap.has(parentId)) {
+      const parent = nodeMap.get(parentId)!
+      if (!parent.children) parent.children = []
+      parent.children.push(node)
+      linked += 1
+    } else {
+      roots.push(node)
+    }
+  })
+  if (!linked) return list
+  return roots
+}
+
 export default function useDictHooks(dictTypes?: string[], orgId?: string) {
   const userInfo = userInfoStore()
   const dictStores = dictStore()
@@ -19,38 +52,133 @@ export default function useDictHooks(dictTypes?: string[], orgId?: string) {
     return userInfo.user?.orgId
   }
 
+  const hasDictList = (list?: ISysDictDataCacheVo[]) => Array.isArray(list) && list.length > 0
+
+  const hasDictCache = (dictType: string, oid?: string): boolean => {
+    if (oid && hasDictList(dictMap.value[`${oid}:${dictType}`])) return true
+    if (hasDictList(dictMap.value[dictType])) return true
+    return Object.keys(dictMap.value).some(
+      (key) => key.endsWith(`:${dictType}`) && hasDictList(dictMap.value[key]),
+    )
+  }
+
+  const resolveDictMapKey = (dictType: string, orgId?: string): string | undefined => {
+    const tenantOrgId = resolveOrgId()
+    const scopedOrgId = orgId ?? tenantOrgId
+    if (scopedOrgId && hasDictList(dictMap.value[`${scopedOrgId}:${dictType}`])) {
+      return `${scopedOrgId}:${dictType}`
+    }
+    if (hasDictList(dictMap.value[dictType])) return dictType
+    const fallback = Object.keys(dictMap.value).find(
+      (key) => key.endsWith(`:${dictType}`) && hasDictList(dictMap.value[key]),
+    )
+    return fallback
+  }
+
+  const resolveDictDataKey = (dictType: string, orgId?: string): string | undefined => {
+    const tenantOrgId = resolveOrgId()
+    const scopedOrgId = orgId ?? tenantOrgId
+    if (scopedOrgId) {
+      const scopedKey = `${scopedOrgId}:${dictType}`
+      if (dictDataMap.value[scopedKey] && Object.keys(dictDataMap.value[scopedKey]).length) {
+        return scopedKey
+      }
+    }
+    if (dictDataMap.value[dictType] && Object.keys(dictDataMap.value[dictType]).length) {
+      return dictType
+    }
+    return Object.keys(dictDataMap.value).find(
+      (key) => key.endsWith(`:${dictType}`) && Object.keys(dictDataMap.value[key]).length > 0,
+    )
+  }
+
+  const repairCachedDictTrees = (): boolean => {
+    let repaired = false
+    for (const key of Object.keys(dictMap.value)) {
+      const list = dictMap.value[key]
+      if (!hasDictList(list)) continue
+      const tree = ensureDictTree(list)
+      if (tree !== list && tree.some((item) => item.children?.length)) {
+        dictMap.value[key] = tree
+        repaired = true
+      }
+    }
+    return repaired
+  }
+
   const getDict = async (dictTypes?: string[], orgId?: string): Promise<void> => {
     try {
       if (!dictTypes || !dictTypes.length) return
       await userInfo.ensureUserHydrated()
       const tenantOrgId = resolveOrgId(orgId)
-      const dictKeySet = new Set(Object.keys(dictMap.value))
-      let uncachedDictTypes: string[] = []
-      if (orgId || tenantOrgId) {
-        const oid = orgId ?? tenantOrgId!
-        uncachedDictTypes = dictTypes.filter((dictType) => !dictKeySet.has(`${oid}:${dictType}`))
-      } else {
-        uncachedDictTypes = dictTypes.filter((dictType) => !dictKeySet.has(dictType))
+      // orgId 就绪后清理 session 里「有 key 无数据」的脏缓存，避免误判已命中
+      let cacheDirty = false
+      if (tenantOrgId) {
+        const oid = orgId ?? tenantOrgId
+        for (const key of Object.keys(dictMap.value)) {
+          if (
+            (key.startsWith(`${oid}:`) || !key.includes(':')) &&
+            Array.isArray(dictMap.value[key]) &&
+            dictMap.value[key].length === 0
+          ) {
+            delete dictMap.value[key]
+            delete dictDataMap.value[key]
+            delete dictDefaultValueMap.value[key]
+            cacheDirty = true
+          }
+        }
+      }
+      // 修复「扁平但含 parentId」的脏缓存（带 orgId 后后端未 buildTree 的历史数据）
+      if (repairCachedDictTrees()) {
+        cacheDirty = true
       }
+      if (cacheDirty) {
+        dictStores.publishToSharedCache()
+      }
+      const uncachedDictTypes = dictTypes.filter(
+        (dictType) => !hasDictCache(dictType, orgId ?? tenantOrgId),
+      )
       if (!uncachedDictTypes.length) return
       const data = await SysDictCacheApi.batchGetSysDictDataCacheVo(uncachedDictTypes, orgId ?? tenantOrgId)
-      dictMap.value = { ...dictMap.value, ...data }
-      const promises = Object.keys(data).map(async (item: string) => {
+      const normalized: typeof data = {}
+      Object.entries(data).forEach(([key, value]) => {
+        if (!value?.length) return
+        const tree = ensureDictTree(value)
+        normalized[key] = tree
+        const colon = key.indexOf(':')
+        if (colon > 0) {
+          const bare = key.slice(colon + 1)
+          if (!normalized[bare]?.length) {
+            normalized[bare] = tree
+          }
+        } else if (tenantOrgId) {
+          const scoped = `${tenantOrgId}:${key}`
+          if (!normalized[scoped]?.length) {
+            normalized[scoped] = tree
+          }
+        }
+      })
+      dictMap.value = { ...dictMap.value, ...normalized }
+      const nextDataMap = { ...dictDataMap.value }
+      const nextDefaultMap = { ...dictDefaultValueMap.value }
+      const promises = Object.keys(normalized).map(async (item: string) => {
         const dataMap: dictDataMapVoType = {}
         const defaultList: ISysDictDataCacheVo[] = []
-        await packageDictDataMap(dataMap, defaultList, data[item])
+        await packageDictDataMap(dataMap, defaultList, normalized[item])
         return { item, dataMap, defaultList }
       })
       const results = await Promise.allSettled(promises)
       results.forEach((result, index) => {
         if (result.status === 'fulfilled') {
           const { item, dataMap, defaultList } = result.value
-          dictDataMap.value[item] = dataMap
-          dictDefaultValueMap.value[item] = defaultList
+          nextDataMap[item] = dataMap
+          nextDefaultMap[item] = defaultList
         } else {
-          ElMessage.error(`处理键 ${Object.keys(data)[index]} 时出错:`, result.reason)
+          ElMessage.error(`处理键 ${Object.keys(normalized)[index]} 时出错:`, result.reason)
         }
       })
+      dictDataMap.value = nextDataMap
+      dictDefaultValueMap.value = nextDefaultMap
       dictStores.publishToSharedCache()
     } catch (error: any) {
       frameworkUtils.messageError(error)
@@ -76,13 +204,8 @@ export default function useDictHooks(dictTypes?: string[], orgId?: string) {
   }
 
   const getDictName = (value?: string, dictType?: string, orgId?: string): string | undefined => {
-    let key = orgId ? `${orgId}:${dictType}` : dictType
-    if (dictDataMap.value[key!]) return dictDataMap.value[key!][value!]?.label || value
-    const tenantOrgId = resolveOrgId()
-    if (tenantOrgId) {
-      key = `${tenantOrgId}:${dictType}`
-      if (dictDataMap.value[key!]) return dictDataMap.value[key!][value!]?.label || value
-    }
+    const key = resolveDictDataKey(dictType!, orgId)
+    if (key && dictDataMap.value[key]) return dictDataMap.value[key][value!]?.label || value
     return value
   }
 
@@ -91,39 +214,38 @@ export default function useDictHooks(dictTypes?: string[], orgId?: string) {
     dictType: string,
     orgId?: string,
   ): ISysDictDataCacheVo | {} => {
-    let key = orgId ? `${orgId}:${dictType}` : dictType
-    if (dictDataMap.value[key!] && dictDataMap.value[key!][value!])
-      return dictDataMap.value[key!][value!]
-    const tenantOrgId = resolveOrgId()
-    if (tenantOrgId) {
-      key = `${tenantOrgId}:${dictType}`
-      if (dictDataMap.value[key!] && dictDataMap.value[key!][value!])
-        return dictDataMap.value[key!][value!]
-    }
+    const key = resolveDictDataKey(dictType, orgId)
+    if (key && dictDataMap.value[key]?.[value]) return dictDataMap.value[key][value]
     return {}
   }
   const getDictDefaultValue = (
     dictType: string,
     orgId?: string
   ): ISysDictDataCacheVo[] => {
-    let key = orgId ? `${orgId}:${dictType}` : dictType
-    if (dictDefaultValueMap.value[key!]) return dictDefaultValueMap.value[key!]
     const tenantOrgId = resolveOrgId()
-    if (tenantOrgId) {
-      key = `${tenantOrgId}:${dictType}`
-      if (dictDefaultValueMap.value[key!]) return dictDefaultValueMap.value[key!]
+    const scopedOrgId = orgId ?? tenantOrgId
+    if (scopedOrgId) {
+      const scoped = dictDefaultValueMap.value[`${scopedOrgId}:${dictType}`]
+      if (scoped?.length) return scoped
     }
-    return []
+    return dictDefaultValueMap.value[dictType] ?? []
   }
   const getDictTypeData = (dictType: string, orgId?: string): ISysDictDataCacheVo[] => {
-    let key = orgId ? `${orgId}:${dictType}` : dictType
-    if (dictMap.value[key!]) return dictMap.value[key!]
-    const tenantOrgId = resolveOrgId()
-    if (tenantOrgId) {
-      key = `${tenantOrgId}:${dictType}`
-      if (dictMap.value[key!]) return dictMap.value[key!]
+    const key = resolveDictMapKey(dictType, orgId)
+    if (!key) return []
+    const list = dictMap.value[key]
+    const tree = ensureDictTree(list)
+    if (tree !== list && tree.some((item) => item.children?.length)) {
+      dictMap.value[key] = tree
+      const bare = key.includes(':') ? key.slice(key.indexOf(':') + 1) : key
+      const tenantOrgId = resolveOrgId(orgId)
+      if (tenantOrgId && !key.includes(':')) {
+        dictMap.value[`${tenantOrgId}:${bare}`] = tree
+      } else if (key.includes(':') && !dictMap.value[bare]?.some((i) => i.children?.length)) {
+        dictMap.value[bare] = tree
+      }
     }
-    return []
+    return tree
   }
   const clearDict = (dictType?: string[], orgId?: string, all?: Boolean) => {
     clearDictCache(dictType, resolveOrgId(), orgId, all)
@@ -142,6 +264,9 @@ export default function useDictHooks(dictTypes?: string[], orgId?: string) {
     getDict,
     userReady,
     dictReady,
+    dictMap,
+    dictDataMap,
+    dictDefaultValueMap,
     getDictName,
     getDictData,
     getDictTypeData,

package/src/utils/patchWujiePopperCoordinates.ts

@@ -0,0 +1,91 @@
+/**
+ * 无界 DocElementRectPlugin 将子应用 document.documentElement 的
+ * scrollTop/scrollLeft/clientWidth/clientHeight 代理到主应用窗口。
+ *
+ * vxe-table overflow tooltip 用 getAbsolutePos：top = document.scrollTop + cell.getBoundingClientRect().top
+ * 混用主应用 scroll 与 iframe 内坐标 → 浮层整体下移（常见 1～3 行高度）。
+ *
+ * Element Plus Popper → ElementPlusConfig 使用 strategy:fixed。
+ * vxe tooltip → 本补丁：document 级滚动归零 + tooltip 改为 position:fixed。
+ */
+const STYLE_ID = 'adtec-wujie-popper-fix-style'
+const HTML_CLASS = 'adtec-wujie-subapp'
+
+let patched = false
+
+const IFRAME_DOC_PROPS = [
+  'scrollTop',
+  'scrollLeft',
+  'clientHeight',
+  'clientWidth',
+] as const
+
+function isWujieSubApp() {
+  return (
+    typeof window !== 'undefined' &&
+    !!(window as Window & { __POWERED_BY_WUJIE__?: boolean }).__POWERED_BY_WUJIE__
+  )
+}
+
+function injectWujiePopperStyles() {
+  if (typeof document === 'undefined' || document.getElementById(STYLE_ID)) {
+    return
+  }
+  const style = document.createElement('style')
+  style.id = STYLE_ID
+  style.textContent = `
+html.${HTML_CLASS} .vxe-tooltip--wrapper,
+html.${HTML_CLASS} .vxe-table--tooltip-wrapper {
+  position: fixed !important;
+  z-index: 9999;
+}
+`
+  document.head.appendChild(style)
+}
+
+function restoreIframeDocumentMetrics(docEl: HTMLElement, body: HTMLElement) {
+  IFRAME_DOC_PROPS.forEach((key) => {
+    Object.defineProperty(docEl, key, {
+      configurable: true,
+      enumerable: true,
+      get() {
+        if (key === 'clientWidth') {
+          return window.innerWidth
+        }
+        if (key === 'clientHeight') {
+          return window.innerHeight
+        }
+        // 子应用页面滚动在表格/容器内，document 级滚动恒为 0
+        return 0
+      },
+      set(val: number) {
+        try {
+          ;(body as HTMLElement & Record<string, number>)[key] = val
+        } catch {
+          // ignore
+        }
+      },
+    })
+  })
+}
+
+/** 无界子应用内统一修正 Popper / vxe tooltip 坐标系 */
+export function patchWujiePopperCoordinates(force = false) {
+  if (typeof window === 'undefined') {
+    return
+  }
+  if (!isWujieSubApp()) {
+    return
+  }
+  if (patched && !force) {
+    return
+  }
+
+  document.documentElement.classList.add(HTML_CLASS)
+  injectWujiePopperStyles()
+  restoreIframeDocumentMetrics(document.documentElement, document.body)
+  patched = true
+}
+
+// 核心包被 import 时即尝试打补丁（覆盖未调用 initVxeTableInPage 的 vxe-grid 页面）
+patchWujiePopperCoordinates()