@epxing/utils 5.3.0-beta.2 → 5.3.0-beta.3

package/dist/src/wiki-path.js

@@ -0,0 +1,111 @@
+function splitAnchor(href) {
+  const s = String(href || "");
+  const i = s.indexOf("#");
+  return i < 0 ? { path: s, anchor: "" } : { path: s.slice(0, i), anchor: s.slice(i + 1) };
+}
+function isExternal(href) {
+  return /^(https?:)?\/\//i.test(String(href || "")) || /^(mailto|tel|data|javascript):/i.test(String(href || ""));
+}
+function pagePath(path) {
+  return decodePath(path).replace(/\\/g, "/").split("/").filter((seg) => seg && seg !== ".").join("/");
+}
+function resolvePath(fromPath, href) {
+  const split = splitAnchor(href);
+  const path = decodePath(split.path);
+  const anchor = decodeAnchor(split.anchor);
+  if (!path) return { path: pagePath(fromPath), anchor };
+  if (isExternal(path)) return { path: "", anchor: "" };
+  const abs = path.startsWith("/");
+  const baseDir = abs ? [] : String(fromPath || "").split("/").slice(0, -1);
+  const parts = abs ? [] : baseDir.slice();
+  for (const seg of path.replace(/^\//, "").split("/")) {
+    if (!seg || seg === ".") continue;
+    if (seg === "..") {
+      if (!parts.length) return { path: "", anchor: "" };
+      parts.pop();
+      continue;
+    }
+    parts.push(seg);
+  }
+  return { path: pagePath(parts.join("/")), anchor };
+}
+function siteUrl(route, path, anchor) {
+  const routePath = pagePath(path);
+  const out = {
+    name: route.name,
+    params: { ...route.params, path: routePath },
+    query: {}
+  };
+  if (route.name === "wikiView") {
+    out.query = { path: routePath };
+    if (route.query.w) out.query.w = route.query.w;
+  }
+  const contextKeys = ["mode", "from", "back"];
+  contextKeys.forEach((key) => {
+    if (route.query[key]) out.query[key] = route.query[key];
+  });
+  if (anchor) out.hash = "#" + anchor;
+  return out;
+}
+function chatPreviewRoute(route, wikiId, pageId, anchor) {
+  const query = {
+    w: wikiId,
+    mode: "preview",
+    from: "chat",
+    back: route.fullPath
+  };
+  if (pageId) query.p = pageId;
+  if (anchor) query.h = anchor;
+  const client = route.params.client;
+  if (client) {
+    delete query.w;
+    return { name: "wikiSite", params: { client, system: "epxing-frame", wiki: wikiId }, query };
+  }
+  return { name: "wikiView", query };
+}
+function restoreChatWikiRoute(route) {
+  if (route.name !== "wikiView" || route.query.from !== "chat" || !route.query.w) return null;
+  const back = route.query.back;
+  const match = typeof back === "string" && /^\/(?:app|hall)\/([\w-]+)(?:\/|\?|$)/.exec(back);
+  if (!match || match[1] === "role" || match[1] === "login") return null;
+  const { w, ...query } = route.query;
+  return {
+    name: "wikiSite",
+    params: { client: match[1], system: "epxing-frame", wiki: w },
+    query,
+    hash: route.hash,
+    replace: true
+  };
+}
+function relativize(fromPath, toPath) {
+  const from = pagePath(fromPath).split("/").slice(0, -1);
+  const to = pagePath(toPath).split("/");
+  let common = 0;
+  while (common < from.length && common < to.length - 1 && from[common] === to[common]) common++;
+  const up = from.slice(common).map(() => "../").join("");
+  return up + to.slice(common).join("/");
+}
+function decodePath(value) {
+  try {
+    return decodeURI(String(value || ""));
+  } catch (e) {
+    return String(value || "");
+  }
+}
+function decodeAnchor(value) {
+  try {
+    return decodeURIComponent(String(value || ""));
+  } catch (e) {
+    return String(value || "");
+  }
+}
+export {
+  chatPreviewRoute,
+  isExternal,
+  pagePath,
+  relativize,
+  resolvePath,
+  restoreChatWikiRoute,
+  siteUrl,
+  splitAnchor
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epxing/utils",
-  "version": "5.3.0-beta.2",
+  "version": "5.3.0-beta.3",
   "description": "工具函数（util/fieldFactory/meta/formula/pdf 等；深路径 @epxing/utils/src/* 为公共 API）",
   "type": "module",
   "main": "./dist/src/public.js",

package/src/ai-call-method-form.js

@@ -0,0 +1,54 @@
+// 通用填写页和开发者自定义页共用聊天提交契约，字段编码及关联标识来自方法配置。
+export function createCallMethodInput (form, values) {
+  if (!form || !form.methodId || !form.draftId || !form.main) throw new Error('填写页面缺少方法或会话信息，请重新打开')
+  const scopeValues = (scope, data = {}) => {
+    const result = {}
+    scope.fields.forEach(field => {
+      const key = Object.prototype.hasOwnProperty.call(data, field.attriName) ? field.attriName : `bean.${field.attriName}`
+      if (!Object.prototype.hasOwnProperty.call(data, key)) return
+      let value = data[key]
+      if (value === '') value = null
+      if (value != null && ['int', 'order', 'num', 'currency'].includes(field.dataType)) {
+        value = Number(value)
+        if (!Number.isFinite(value)) throw new Error(`${field.attriLabel}必须是有效数字`)
+      }
+      if (value != null && field.dataType === 'switch') {
+        if ([true, '1', 1].includes(value)) value = true
+        else if ([false, '0', 0].includes(value)) value = false
+        else throw new Error(`${field.attriLabel}的开关值无效`)
+      }
+      result[field.attriName] = value
+    })
+    return result
+  }
+  const input = scopeValues(form.main, values)
+  const subEntitys = typeof values.subEntitys === 'string' ? JSON.parse(values.subEntitys) : (values.subEntitys || {})
+  for (const relation of form.relations || []) {
+    let data = values[relation.flag]
+    if (data === undefined) {
+      const key = Object.keys(subEntitys).find(key => key.toUpperCase() === relation.flag.toUpperCase())
+      if (key) data = subEntitys[key]
+    }
+    if (!relation.many && data === undefined) {
+      const prefix = `${relation.flag.toUpperCase()}|`
+      const fields = Object.entries(values).map(([key, value]) => [key.replace(/^bean\./, ''), value]).filter(([key]) => key.toUpperCase().startsWith(prefix))
+      if (fields.length) data = Object.fromEntries(fields.map(([key, value]) => [key.substring(prefix.length), value]))
+    }
+    if (data === undefined || data === null) continue
+    if (relation.many) {
+      if (!Array.isArray(data)) throw new Error(`${relation.title}应为对象列表`)
+      input[relation.flag] = data.filter(row => row.operateType !== 'delete').map(row => scopeValues(relation.scope, row))
+    } else {
+      if (typeof data !== 'object' || Array.isArray(data)) throw new Error(`${relation.title}应为对象`)
+      input[relation.flag] = scopeValues(relation.scope, data)
+    }
+  }
+  return { __finalize__: true, __callMethodCreate__: { methodId: form.methodId, draftId: form.draftId, values: input } }
+}
+
+// sendMessage返回false表示聊天仍忙，调用方应保留表单内容并允许稍后再提交。
+export function submitCallMethodForm (session, form, values) {
+  if (!session || typeof session.sendMessage !== 'function') throw new Error('当前页面未连接聊天会话')
+  const inputParam = createCallMethodInput(form, values)
+  return session.sendMessage(`确认提交${form.name || '新增信息'}`, null, { inputParam })
+}

package/src/chart-registry.js

@@ -1,41 +1,41 @@
-// Shared metadata; persisted type names and backend request types retain their existing meaning.
-export const chartTypes = [
-  { type: 'table', text: '统计表', icon: 'epx-icon-tongjibiao', component: 'chart-table', requestType: 'table', coordinate: 'none' },
-  { type: 'pie', text: '饼状图', icon: 'epx-icon-bingzhuangtu', component: 'chart-common', requestType: 'pie', coordinate: 'none' },
-  { type: 'circularPie', text: '环形饼图', icon: 'epx-icon-bingzhuangtu', component: 'chart-common', requestType: 'pie', coordinate: 'none' },
-  { type: 'line', text: '折线图', icon: 'epx-icon-zhexiantu', component: 'chart-common', requestType: 'line', coordinate: 'cartesian2d' },
-  { type: 'column', text: '柱状图', icon: 'epx-icon-zhuzhuangtu', component: 'chart-common', requestType: 'bar', coordinate: 'cartesian2d' },
-  { type: 'horiColumn', text: '横向柱图', icon: 'epx-icon-zhuzhuangtu', component: 'chart-common', requestType: 'bar', cellScopeType: 'column', coordinate: 'cartesian2d' },
-  { type: 'funnel', text: '漏斗图', icon: 'epx-icon-loudoutu', component: 'chart-common', requestType: 'funnel', coordinate: 'none' },
-  { type: 'wordcloud', text: '词云', icon: 'epx-icon-ciyun', component: 'chart-wordcloud', requestType: 'wordCloud', coordinate: 'none' },
-  { type: 'radar', text: '雷达图', icon: 'epx-icon-leidatu', component: 'chart-radar', requestType: 'radar', coordinate: 'radar' },
-  { type: 'columnAndLine', text: '折柱混合', icon: 'epx-icon-zhezhutu', component: 'chart-common', requestType: 'bar', coordinate: 'cartesian2d' },
-  { type: 'scatter', text: '散点图', icon: 'epx-icon-sandiantu', component: 'chart-scatter', requestType: 'scatter', coordinate: 'cartesian2d', binding: 'numericPairs', drill: false },
-  { type: 'map', text: '地图', icon: 'epx-icon-ditu', component: 'chart-map', requestType: 'map', coordinate: 'geo' },
-  { type: 'gauge', text: '仪表盘', icon: 'epx-icon-leidatu', component: 'chart-advanced', requestType: 'bar', cellScopeType: 'column', coordinate: 'none', dataHint: '单个统计值；设置一个指标且不拆分分类。' },
-  { type: 'treemap', text: '矩形树图', icon: 'epx-icon-tongjibiao', component: 'chart-advanced', requestType: 'bar', cellScopeType: 'column', coordinate: 'none', dataHint: '按指标、分类组成两层矩形树，使用非负统计值；叶子支持钻取。' },
-  { type: 'heatmap', text: '热力图', icon: 'epx-icon-zhuzhuangtu', component: 'chart-advanced', requestType: 'bar', cellScopeType: 'column', coordinate: 'cartesian2d', dataHint: '横轴为分类，纵轴为指标；各指标使用同一组分类。' },
-  { type: 'boxplot', text: '箱线图', selectable: false, icon: 'epx-icon-zhexiantu', component: 'chart-advanced', requestType: 'scatter', coordinate: 'cartesian2d', binding: 'numericPairs', drill: false, dataHint: '选择两个数字统计字段，不设置分类；使用原始值计算四分位数与 1.5 倍四分位距的离群值，不支持钻取。' }
-]
-
-export const selectableChartTypes = chartTypes.filter(item => item.selectable !== false)
-
-export function getChartType (type) {
-  return chartTypes.find(item => item.type === (type === 'bar' ? 'column' : type))
-}
-
-export const chartConfigCategories = [
-  { key: 'all', label: '全部' },
-  { key: 'appearance', label: '外观' }, { key: 'axis', label: '坐标与刻度' },
-  { key: 'shape', label: '图形' }, { key: 'label', label: '标签与提示' },
-  { key: 'interaction', label: '交互' }, { key: 'advanced', label: '高级' }
-]
-
-export function getChartConfigCategory (key) {
-  if (['title', 'grid', 'color', 'backgroundColor'].includes(key)) return 'appearance'
-  if (['xAxis', 'yAxis', 'dualAxes', 'dataZoom'].includes(key)) return 'axis'
-  if (key.startsWith('series-') || ['series.map', 'radar', 'scatter', 'table', 'visualMap'].includes(key)) return 'shape'
-  if (['legend', 'tooltip'].includes(key)) return 'label'
-  if (key === 'toolbox') return 'interaction'
-  return 'advanced'
-}
+// Shared metadata; persisted type names and backend request types retain their existing meaning.
+export const chartTypes = [
+  { type: 'table', text: '统计表', icon: 'epx-icon-tongjibiao', component: 'chart-table', requestType: 'table', coordinate: 'none' },
+  { type: 'pie', text: '饼状图', icon: 'epx-icon-bingzhuangtu', component: 'chart-common', requestType: 'pie', coordinate: 'none' },
+  { type: 'circularPie', text: '环形饼图', icon: 'epx-icon-bingzhuangtu', component: 'chart-common', requestType: 'pie', coordinate: 'none' },
+  { type: 'line', text: '折线图', icon: 'epx-icon-zhexiantu', component: 'chart-common', requestType: 'line', coordinate: 'cartesian2d' },
+  { type: 'column', text: '柱状图', icon: 'epx-icon-zhuzhuangtu', component: 'chart-common', requestType: 'bar', coordinate: 'cartesian2d' },
+  { type: 'horiColumn', text: '横向柱图', icon: 'epx-icon-zhuzhuangtu', component: 'chart-common', requestType: 'bar', cellScopeType: 'column', coordinate: 'cartesian2d' },
+  { type: 'funnel', text: '漏斗图', icon: 'epx-icon-loudoutu', component: 'chart-common', requestType: 'funnel', coordinate: 'none' },
+  { type: 'wordcloud', text: '词云', icon: 'epx-icon-ciyun', component: 'chart-wordcloud', requestType: 'wordCloud', coordinate: 'none' },
+  { type: 'radar', text: '雷达图', icon: 'epx-icon-leidatu', component: 'chart-radar', requestType: 'radar', coordinate: 'radar' },
+  { type: 'columnAndLine', text: '折柱混合', icon: 'epx-icon-zhezhutu', component: 'chart-common', requestType: 'bar', coordinate: 'cartesian2d' },
+  { type: 'scatter', text: '散点图', icon: 'epx-icon-sandiantu', component: 'chart-scatter', requestType: 'scatter', coordinate: 'cartesian2d', binding: 'numericPairs', drill: false },
+  { type: 'map', text: '地图', icon: 'epx-icon-ditu', component: 'chart-map', requestType: 'map', coordinate: 'geo' },
+  { type: 'gauge', text: '仪表盘', icon: 'epx-icon-leidatu', component: 'chart-advanced', requestType: 'bar', cellScopeType: 'column', coordinate: 'none', dataHint: '单个统计值；设置一个指标且不拆分分类。' },
+  { type: 'treemap', text: '矩形树图', icon: 'epx-icon-tongjibiao', component: 'chart-advanced', requestType: 'bar', cellScopeType: 'column', coordinate: 'none', dataHint: '按指标、分类组成两层矩形树，使用非负统计值；叶子支持钻取。' },
+  { type: 'heatmap', text: '热力图', icon: 'epx-icon-zhuzhuangtu', component: 'chart-advanced', requestType: 'bar', cellScopeType: 'column', coordinate: 'cartesian2d', dataHint: '横轴为分类，纵轴为指标；各指标使用同一组分类。' },
+  { type: 'boxplot', text: '箱线图', selectable: false, icon: 'epx-icon-zhexiantu', component: 'chart-advanced', requestType: 'scatter', coordinate: 'cartesian2d', binding: 'numericPairs', drill: false, dataHint: '选择两个数字统计字段，不设置分类；使用原始值计算四分位数与 1.5 倍四分位距的离群值，不支持钻取。' }
+]
+
+export const selectableChartTypes = chartTypes.filter(item => item.selectable !== false)
+
+export function getChartType (type) {
+  return chartTypes.find(item => item.type === (type === 'bar' ? 'column' : type))
+}
+
+export const chartConfigCategories = [
+  { key: 'all', label: '全部' },
+  { key: 'appearance', label: '外观' }, { key: 'axis', label: '坐标与刻度' },
+  { key: 'shape', label: '图形' }, { key: 'label', label: '标签与提示' },
+  { key: 'interaction', label: '交互' }, { key: 'advanced', label: '高级' }
+]
+
+export function getChartConfigCategory (key) {
+  if (['title', 'grid', 'color', 'backgroundColor'].includes(key)) return 'appearance'
+  if (['xAxis', 'yAxis', 'dualAxes', 'dataZoom'].includes(key)) return 'axis'
+  if (key.startsWith('series-') || ['series.map', 'radar', 'scatter', 'table', 'visualMap'].includes(key)) return 'shape'
+  if (['legend', 'tooltip'].includes(key)) return 'label'
+  if (key === 'toolbox') return 'interaction'
+  return 'advanced'
+}

package/src/fieldFactory.js

@@ -1,3 +1,3 @@
-// 兼容旧路径；新代码从 @epxing/core 导入。
-export { default } from '@epxing/core/src/runtime-utils/fieldFactory'
-export * from '@epxing/core/src/runtime-utils/fieldFactory'
+// 兼容旧路径；新代码从 @epxing/core 导入。
+export { default } from '@epxing/core/src/runtime-utils/fieldFactory'
+export * from '@epxing/core/src/runtime-utils/fieldFactory'

package/src/index.js

@@ -1,2 +1,2 @@
-// 保留历史 /src barrel；新产品从 @epxing/utils 导入纯工具。
-export * from './legacy'
+// 保留历史 /src barrel；新产品从 @epxing/utils 导入纯工具。
+export * from './legacy'

package/src/legacy.js

@@ -1,29 +1,29 @@
-import util from '@epxing/core/src/runtime-utils/util'
-// axios / mixins 已随 T17 迁 @epxing/core；barrel 暂经相对路径引用真身保持导出面不变（T23 收敛 barrel）
-// ADR-009：跨包引用必须用裸说明符（单包构建外置为 @epxing/core 依赖；相对路径会把 core 打进 utils 产物）
-import axios from '@epxing/core/src/axios'
-import Config from './Config'
-import FieldFactory from '@epxing/core/src/runtime-utils/fieldFactory'
-import Meta from '@epxing/core/src/runtime-utils/meta'
-import Page from './page'
-import http from '@epxing/core/src/api'
-import mixin from '@epxing/core/src/mixins/global'
-// import router from '@epxing/core/src/router'
-import PdfViewer from '@epxing/core/src/runtime-utils/pdf.viewer'
-// 统一的 #{path} 占位符解析（见 placeholder.js 头注释：存量有 8 种不同语义的复制品）
-import placeholder from './placeholder'
-const pdfViewer = new PdfViewer()
-export {
-  axios,
-  Config,
-  FieldFactory,
-  Meta,
-  Page,
-  util,
-  http,
-  mixin,
-  // router,
-  PdfViewer,
-  pdfViewer,
-  placeholder
-}
+import util from '@epxing/core/src/runtime-utils/util'
+// axios / mixins 已随 T17 迁 @epxing/core；barrel 暂经相对路径引用真身保持导出面不变（T23 收敛 barrel）
+// ADR-009：跨包引用必须用裸说明符（单包构建外置为 @epxing/core 依赖；相对路径会把 core 打进 utils 产物）
+import axios from '@epxing/core/src/axios'
+import Config from './Config'
+import FieldFactory from '@epxing/core/src/runtime-utils/fieldFactory'
+import Meta from '@epxing/core/src/runtime-utils/meta'
+import Page from './page'
+import http from '@epxing/core/src/api'
+import mixin from '@epxing/core/src/mixins/global'
+// import router from '@epxing/core/src/router'
+import PdfViewer from '@epxing/core/src/runtime-utils/pdf.viewer'
+// 统一的 #{path} 占位符解析（见 placeholder.js 头注释：存量有 8 种不同语义的复制品）
+import placeholder from './placeholder'
+const pdfViewer = new PdfViewer()
+export {
+  axios,
+  Config,
+  FieldFactory,
+  Meta,
+  Page,
+  util,
+  http,
+  mixin,
+  // router,
+  PdfViewer,
+  pdfViewer,
+  placeholder
+}

package/src/meta.js

@@ -1,2 +1,2 @@
-// 兼容旧路径；新代码从 @epxing/core 导入。
-export { default } from '@epxing/core/src/runtime-utils/meta'
+// 兼容旧路径；新代码从 @epxing/core 导入。
+export { default } from '@epxing/core/src/runtime-utils/meta'

package/src/pdf.viewer.js

@@ -1,2 +1,2 @@
-// 兼容旧路径；新代码从 @epxing/core 导入。
-export { default } from '@epxing/core/src/runtime-utils/pdf.viewer'
+// 兼容旧路径；新代码从 @epxing/core 导入。
+export { default } from '@epxing/core/src/runtime-utils/pdf.viewer'

package/src/public.js

@@ -1,11 +1,11 @@
-export { default as Config } from './Config'
-export { default as Page } from './page'
-export { default as placeholder } from './placeholder'
-export * from './placeholder'
-export * from './date-helper'
-export * from './dom-helper'
-export { default as storage, getXsrfToken, setXsrfToken } from './storage'
-export { default as cookie } from './storage'
-export { default as moment, default as dateTime, createMoment } from './moment-compat'
-export { default as lodash } from './collection'
-export * from './collection'
+export { default as Config } from './Config'
+export { default as Page } from './page'
+export { default as placeholder } from './placeholder'
+export * from './placeholder'
+export * from './date-helper'
+export * from './dom-helper'
+export { default as storage, getXsrfToken, setXsrfToken } from './storage'
+export { default as cookie } from './storage'
+export { default as moment, default as dateTime, createMoment } from './moment-compat'
+export { default as lodash } from './collection'
+export * from './collection'

package/src/util.js

@@ -1,2 +1,2 @@
-// 兼容旧路径；新代码从 @epxing/core 导入。
-export { default } from '@epxing/core/src/runtime-utils/util'
+// 兼容旧路径；新代码从 @epxing/core 导入。
+export { default } from '@epxing/core/src/runtime-utils/util'

package/src/wiki-path.js

@@ -0,0 +1,164 @@
+/**
+ * Wiki 路径工具。
+ *
+ * 规则必须与后端 `WikiPaths` 一致：正文里的相对链接是作者按目录写的，
+ * 两边解析口径不同就会出现「后端认得、前端点不开」，而这正是这套设计要消灭的问题。
+ */
+
+/** 拆出锚点。 */
+export function splitAnchor (href) {
+  const s = String(href || '')
+  const i = s.indexOf('#')
+  return i < 0 ? { path: s, anchor: '' } : { path: s.slice(0, i), anchor: s.slice(i + 1) }
+}
+
+/** 外链不参与站内解析。 */
+export function isExternal (href) {
+  return /^(https?:)?\/\//i.test(String(href || '')) ||
+    /^(mailto|tel|data|javascript):/i.test(String(href || ''))
+}
+
+/** 页表与接口使用 Store 的规范页标识；这里只解码并统一分隔符，不猜扩展名。 */
+export function pagePath (path) {
+  return decodePath(path)
+    .replace(/\\/g, '/')
+    .split('/')
+    .filter(seg => seg && seg !== '.')
+    .join('/')
+}
+
+/**
+ * 相对链接 → 站内绝对路径。
+ *
+ * `../` 必须真的回退一级，不能只做字符串拼接——后端曾经就栽在这里：
+ * 规范化时保留了 `../`，导致 `../implementation/05-sop.md` 永远匹配不上任何页。
+ */
+export function resolvePath (fromPath, href) {
+  const split = splitAnchor(href)
+  const path = decodePath(split.path)
+  const anchor = decodeAnchor(split.anchor)
+  if (!path) return { path: pagePath(fromPath), anchor }
+  if (isExternal(path)) return { path: '', anchor: '' }
+
+  const abs = path.startsWith('/')
+  const baseDir = abs ? [] : String(fromPath || '').split('/').slice(0, -1)
+  const parts = abs ? [] : baseDir.slice()
+
+  for (const seg of path.replace(/^\//, '').split('/')) {
+    if (!seg || seg === '.') continue
+    if (seg === '..') {
+      if (!parts.length) return { path: '', anchor: '' }
+      parts.pop()
+      continue
+    }
+    parts.push(seg)
+  }
+  return { path: pagePath(parts.join('/')), anchor }
+}
+
+/**
+ * 站点地址：`#/wiki/{客户}/{系统}/{空间}/{页路径}`，锚点挂 hash。
+ *
+ * 保留当前路由的前三段而不是自己拼——客户与系统段是权限边界的一部分，
+ * 在前端重新组装容易拼错，也容易被人改成别的租户去试。
+ */
+export function siteUrl (route, path, anchor) {
+  const routePath = pagePath(path)
+  const out = {
+    name: route.name,
+    params: { ...route.params, path: routePath },
+    query: {}
+  }
+  if (route.name === 'wikiView') {
+    // `/wiki/view` 这条路由没有路径段，params.path 落不到地址里。
+    // 不管用这一点会一口气错三样：地址栏始终是同一个 `#/wiki/view`，
+    // 刷新读不回当前页，浏览器历史里堆的全是同一条、返回看着像没反应。
+    // 所以这条路由上换页走 query，并且必须把 `w`（空间）原样带上：
+    // 丢了它，下一次读页就没有空间 ID，后端只能报「页不存在」——看着像页被删了。
+    out.query = { path: routePath }
+    if (route.query.w) out.query.w = route.query.w
+    // p / rev / h 属于那一条引用（冻结在某一版），换到别的页之后就不成立了，
+    // 留着会让 syncFromRoute 继续按引用读，点哪一页都回到引用那一页。
+  }
+  // 两种站点路由换页都必须保留预览模式和返回地址。
+  const contextKeys = ['mode', 'from', 'back']
+  contextKeys.forEach(key => {
+    if (route.query[key]) out.query[key] = route.query[key]
+  })
+  if (anchor) out.hash = '#' + anchor
+  return out
+}
+
+/**
+ * 从聊天页打开 Wiki 的统一入口。
+ *
+ * `mode=preview` 决定能力边界，`from/back` 只决定返回去向。两者分开后，分享链接可以
+ * 去掉聊天会话地址但继续保持只读，不会把分享接收者送进发起人的聊天路由。
+ */
+export function chatPreviewRoute (route, wikiId, pageId, anchor) {
+  const query = {
+    w: wikiId,
+    mode: 'preview',
+    from: 'chat',
+    back: route.fullPath
+  }
+  if (pageId) query.p = pageId
+  if (anchor) query.h = anchor
+  const client = route.params.client
+  // 新窗口没有聊天页的 Vuex 上下文，必须把租户写进地址。
+  // Wiki 属于该租户的平台系统，与聊天智能体所在的业务系统无关。
+  if (client) {
+    delete query.w
+    return { name: 'wikiSite', params: { client, system: 'epxing-frame', wiki: wikiId }, query }
+  }
+  return { name: 'wikiView', query }
+}
+
+/** 兼容旧聊天链接：在加载应用配置之前，恢复 back 中明确携带的租户。 */
+export function restoreChatWikiRoute (route) {
+  if (route.name !== 'wikiView' || route.query.from !== 'chat' || !route.query.w) return null
+  const back = route.query.back
+  const match = typeof back === 'string' && /^\/(?:app|hall)\/([\w-]+)(?:\/|\?|$)/.exec(back)
+  if (!match || match[1] === 'role' || match[1] === 'login') return null
+  const { w, ...query } = route.query
+  return {
+    name: 'wikiSite',
+    params: { client: match[1], system: 'epxing-frame', wiki: w },
+    query,
+    hash: route.hash,
+    replace: true
+  }
+}
+
+/**
+ * 绝对路径 → 从某一页看过去的相对链接。与后端 `WikiPaths.relativize` 同一套规则。
+ *
+ * 手写相对路径是死链的头号来源——数错一层 `../` 就指到不存在的地方，
+ * 而写的时候看不出来，要等体检或者别人点开才发现。所以内链一律由平台算好、只允许从选择器选。
+ *
+ * 结果保留目标页的 Store 规范标识：无扩展名、`.md`、`.html` 都不在前端改写。
+ */
+export function relativize (fromPath, toPath) {
+  const from = pagePath(fromPath).split('/').slice(0, -1)
+  const to = pagePath(toPath).split('/')
+  let common = 0
+  while (common < from.length && common < to.length - 1 && from[common] === to[common]) common++
+  const up = from.slice(common).map(() => '../').join('')
+  return up + to.slice(common).join('/')
+}
+
+function decodePath (value) {
+  try {
+    return decodeURI(String(value || ''))
+  } catch (e) {
+    return String(value || '')
+  }
+}
+
+function decodeAnchor (value) {
+  try {
+    return decodeURIComponent(String(value || ''))
+  } catch (e) {
+    return String(value || '')
+  }
+}

package/dist/src/assets/images/ai.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_2 = "" + new URL("../../../assets/ai-BBFn3QRy.png", import.meta.url).href;
-export {
-  __vite_glob_1_2 as default
-};

package/dist/src/assets/images/ai_import.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_3 = "" + new URL("../../../assets/ai_import-BxQ7Ohn6.png", import.meta.url).href;
-export {
-  __vite_glob_1_3 as default
-};

package/dist/src/assets/images/app.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_4 = "" + new URL("../../../assets/app-DBNIokDP.png", import.meta.url).href;
-export {
-  __vite_glob_1_4 as default
-};

package/dist/src/assets/images/approval.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_5 = "" + new URL("../../../assets/approval-DGcBv-re.png", import.meta.url).href;
-export {
-  __vite_glob_1_5 as default
-};

package/dist/src/assets/images/canvas-editor/option.svg.js

@@ -1,4 +0,0 @@
-const __vite_glob_2_31 = "" + new URL("../../../../assets/option-CG02tIgh.svg", import.meta.url).href;
-export {
-  __vite_glob_2_31 as default
-};

package/dist/src/assets/images/create_market_system.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_8 = "" + new URL("../../../assets/create_market_system-BH__UVbt.png", import.meta.url).href;
-export {
-  __vite_glob_1_8 as default
-};

package/dist/src/assets/images/create_system.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_9 = "" + new URL("../../../assets/create_system-irg--ePh.png", import.meta.url).href;
-export {
-  __vite_glob_1_9 as default
-};

package/dist/src/assets/images/custom.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_10 = "" + new URL("../../../assets/custom-C-ujlHz1.png", import.meta.url).href;
-export {
-  __vite_glob_1_10 as default
-};

package/dist/src/assets/images/default-icon.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_11 = "" + new URL("../../../assets/default-icon-2193FMjv.png", import.meta.url).href;
-export {
-  __vite_glob_1_11 as default
-};

package/dist/src/assets/images/ex_link.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_12 = "" + new URL("../../../assets/ex_link-4fYPd9nh.png", import.meta.url).href;
-export {
-  __vite_glob_1_12 as default
-};

package/dist/src/assets/images/excel.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_13 = "" + new URL("../../../assets/excel-BYqRm2Y8.png", import.meta.url).href;
-export {
-  __vite_glob_1_13 as default
-};

package/dist/src/assets/images/folder.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_1_15 = "" + new URL("../../../assets/folder-CFVsNbjj.png", import.meta.url).href;
-export {
-  __vite_glob_1_15 as default
-};

package/dist/src/assets/images/hall/form.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_0_0 = "" + new URL("../../../../assets/form-DD9HV-jN.png", import.meta.url).href;
-export {
-  __vite_glob_0_0 as default
-};

package/dist/src/assets/images/hall/meta.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_0_1 = "" + new URL("../../../../assets/meta-Qorpi70B.png", import.meta.url).href;
-export {
-  __vite_glob_0_1 as default
-};

package/dist/src/assets/images/hall/process.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_0_2 = "" + new URL("../../../../assets/process-Dcndu9m2.png", import.meta.url).href;
-export {
-  __vite_glob_0_2 as default
-};

package/dist/src/assets/images/hall/rule.png.js

@@ -1,4 +0,0 @@
-const __vite_glob_0_3 = "" + new URL("../../../../assets/rule-DcYhYse0.png", import.meta.url).href;
-export {
-  __vite_glob_0_3 as default
-};