cloud-web-corejs 1.0.54-dev.81 → 1.0.54-dev.810

package/src/components/xform/XFormTabContainer//346/226/260/345/242/236/351/241/265/347/255/276/346/250/241/345/274/217-/346/234/200/347/273/210/345/256/236/347/216/260.md

@@ -0,0 +1,195 @@
+# xform 表单「新增页签模式」——最终实现（已落地）
+
+> 本文记录**实际已落地**的实现，替代前几版方案文档（`新增页签模式实现方案.md` / `新增页签模式-落地实施文档.md` / `新增页签模式-归一落地方案.md` / 弃用的 `IMPLEMENTATION_PLAN.md`）。
+> 需求：去掉固定「常规」页签承载新增 → 新增打开独立可关闭页签（标题"新增"）→ 保存后本页变编辑态（标题变名称字段）→ 提交（启动流程）后可配置「关闭页签回列表刷新」或「刷新本页」，并正确处理保存成功/提交失败/取消等边界。
+
+---
+
+## 一、最终交互与配置
+
+### 配置项（列表表单 formConfig，设计器「列表标签页信息」分组）
+
+| 字段 | 类型 | 默认 | 含义 |
+|------|------|------|------|
+| `addTabEnabled` | Boolean | `false` | 新增打开独立页签总开关。开启后新增走动态可关闭页签，不走「常规」 |
+| `submitBehavior` | String | `"closeToList"` | 提交后行为：`closeToList`（关页签回列表刷新）/ `refreshCurrent`（刷新本页出流程信息） |
+
+> 新增页签初始标题**固定为「新增」**，不提供配置项（保存后升级为名称字段值）。
+
+复用既有字段（未新造）：`hideNormalTab`（隐藏常规页签）、`multiTabLabelField`（页签标题字段，新增/编辑共用）、`multiTabEnabled`（编辑页签多开，语义不变）。
+
+> **配置位置统一在「列表表单」**，与 `multiTabEnabled` 同处。`submitBehavior` 运行时优先读列表表单配置。
+
+### 端到端行为（详情内容恰好刷新一次）
+
+| 分支 | 行为 | 详情刷新 |
+|------|------|:---:|
+| 新增保存（纯保存） | 页签升级编辑态、标题变名称字段、`dataId`=单号 | 1（编辑态重载） |
+| 保存并提交 → 提交成功 + `refreshCurrent` | 刷新本页，出流程信息 | 1 |
+| 保存并提交 → 提交成功 + `closeToList` | 关当前页签 → 切列表 → 刷新列表 | 0（详情） |
+| 保存并提交 → 提交失败 / 取消候选人弹框 | 刷新当前详情到编辑态（不重复入库） | 1 |
+| 直接启动流程（`wfStartBindSave` 开）→ 失败/取消 | 刷新到编辑态 | 1 |
+| **直接启动流程（`wfStartBindSave` 关）→ 失败/取消** | **不刷新表单** | 0 |
+| 直接启动流程 → 成功 | 按 `submitBehavior` 关页签/刷新 | 0 或 1 |
+
+---
+
+## 二、设计要点
+
+1. **归一**：新增 = 一个「还没有单号的编辑页签」，复用现有 `x-tabs` + `editTab` 插槽机制，不另写容器/分支体系。
+2. **合成唯一 id**：新增时给虚拟 row 合成 `id = tabName = "add_<时间戳>_<随机>"`，使 `x-tabs` 去重（按 `data.id`）/`tabName`/`paneName` 三者对齐；`dataId` 显式置 `null`，避免被当真实单号去 `getOne`。
+3. **元数据升级与内容重载解耦**：表单不 `watch` `dataId`，故改 `tab.dataId` 不触发重载。保存成功先只升级页签元数据（`dataId`/`isAdd`/`formCode`/标题），内容的那一次刷新交给流程结束后的分支，保证详情不刷两次。
+4. **wf 组件零业务耦合**：`wf.js` 只认通用钩子 `option.onStartSuccess` / `onStartFail` / `onCancel`，页签相关逻辑全部收在 xform 侧（`indexMixin`）。
+5. **两个入口统一**：「保存并提交」（`defaultHandle`）与「直接启动流程」（`indexMixin` 构造的 wf option）都通过同一批 xform 方法处理。
+
+---
+
+## 三、改动清单（实际代码）
+
+### 1. `components/xform/utils/util.js` — `getDefaultFormConfig()`
+新增 2 个默认字段（**真正生效的默认值源**，非 designer.js 内联对象）：
+```js
+addTabEnabled: false,
+submitBehavior: "closeToList",
+```
+
+### 2. `components/xform/form-designer/setting-panel/form-setting.vue`
+「列表标签页信息」分组新增：`addTabEnabled` 开关、`submitBehavior` 单选（新增页签标题固定「新增」，无输入项）。
+
+### 3. `components/vb-tabs/x-tabs.vue` — `removeTab` 既有 bug 修复
+`tabNameEnable=true` 且关闭非首个页签时引用了未定义的 `tab`，修为 `this.tabs[tabIndex-1]`：
+```js
+let prev = this.tabs[tabIndex - 1];
+this.activeName = tabNameEnable ? prev.tabName : prev.data[paneKeyName] + "";
+```
+
+### 4. `views/user/form/view/list.vue`
+
+**`openEditDialog`** — 归一分支，新增合成唯一 id、`dataId:null`、`isAdd`：
+```js
+let isAdd = !dataId;
+let addTab = formConfig.addTabEnabled && isAdd && tabLabelField;
+if ((multiTabEnabled && dataId) || addTab) {
+  let key = isAdd ? "add_" + Date.now() + "_" + Math.random().toString(36).slice(2,6) : dataId;
+  let openRow = isAdd ? { ...row, id: key, [tabLabelField]: "新增" } : row;
+  this.$refs.xTabs.openEditTab(openRow, param, {
+    tabParam: { formCode, tabLabelField, tabName: key, isAdd, ...(isAdd ? { dataId: null } : {}) },
+  });
+} else { /* 原「常规」分支不变 */ }
+```
+
+**新增方法**（`editTab` 插槽 `@reload` 改为 `(...args) => onEditTabReload(tab, ...args)`）：
+- `resolveFormModel(target)`：逐级解析真实表单 `formDataModel`（`target` → `target.$refs.vFormRef` → `target.getFormRef()`）。
+- `applyTabSaveResult(tab, dataId, formCode, formModel)`：升级编辑态 + 同步标题（标题取名称字段值，无值不回退单号）。**不含内容重渲染**。
+- `onEditTabReload(tab, target, param)`：纯保存路径 → `applyTabSaveResult` + `reloadTabContent`（重渲染）。
+- `promoteActiveAddTab(dataId, formCode, target)`：保存并提交路径 → 只对当前活动页签 `applyTabSaveResult`，**不重渲染**。
+
+### 5. `components/xform/mixins/defaultHandle.js` — `saveAndSubmitWfHandle`
+保存成功回调里：**先只升级页签元数据**（不刷详情），再开流程弹框，注入统一钩子：
+```js
+success: (res) => {
+  let editFormCode = formConfig.editFormCode;
+  let listPageRef = formRef.getListPageRef && formRef.getListPageRef();
+  if (listPageRef && listPageRef.promoteActiveAddTab) {
+    listPageRef.promoteActiveAddTab(res.objx, editFormCode, formRef); // 元数据升级，防重复入库，不刷详情
+  }
+  openStartWfDialog(formRef, {
+    objId: res.objx, wfCode: ..., formCode: ..., serviceId: ..., skipStartConfirm: true,
+    onStartSuccess: () => formRef.onWfStartSuccess && formRef.onWfStartSuccess(),
+    onStartFail:   () => formRef.onWfStartAbort  && formRef.onWfStartAbort(),   // 有保存 → 失败刷编辑态
+    onCancel:      () => formRef.onWfStartAbort  && formRef.onWfStartAbort(),   // 有保存 → 取消刷编辑态
+  });
+  option?.config?.success && option.config.success(res);
+},
+```
+
+### 6. `components/xform/form-render/indexMixin.js`
+
+**wf option 构造处**（直接启动按钮入口，约 L1379）：
+```js
+onStartSuccess: () => this.onWfStartSuccess(),   // 成功始终处理
+// ...
+if (formConfig.wfStartBindSave) {                // 仅当伴随自动保存时，失败/取消才刷新
+  option.onStartFail = () => this.onWfStartAbort();
+  option.onCancel   = () => this.onWfStartAbort();
+  option.onStart = ...; option.onBeforeStartSubmit = ...; // 既有自动保存逻辑
+}
+```
+
+**新增方法**（`switchToListTab` 附近）：
+```js
+getAddTabContext() {
+  // 返回 {xTabs, currentName, submitBehavior}，仅当处于开启 addTabEnabled 的动态页签内；否则 null
+}
+onWfStartSuccess() {
+  let ctx = this.getAddTabContext();
+  if (ctx) {
+    if (ctx.submitBehavior === "refreshCurrent") this.$baseReload();
+    else { this.switchToListTab({ handleType: "reload" }); ctx.xTabs.removeTab(ctx.currentName); }
+    return;
+  }
+  this.$baseReload(); // 非本模式：原默认行为
+}
+onWfStartAbort() {
+  // 失败/取消：本模式下刷新当前详情到编辑态（dataId 已升级为单号）；非本模式不处理
+  if (this.getAddTabContext()) this.$baseReload();
+}
+```
+> `getAddTabContext` 判定：当前页签名非 `first`/`second`/`otherTab*`，且列表表单 `addTabEnabled` 为真。
+
+### 7. `components/wf/wf.js` — `wfStartMixin`（仅通用钩子，无业务逻辑）
+- `data` 增 `wfSubmitted: false`。
+- `startSubmitHanlde` 首行 `this.wfSubmitted = true;`（进入提交后关闭弹框不算取消）。
+- 新增 `handleWfCancel()`：未提交则一次性回调 `option.onCancel`（防多弹框重复触发）。
+- `close()` 调 `handleWfCancel()`；新增 `watch.showSetCandidateDialog2`：候选人弹框未提交就关闭 → `handleWfCancel()`。
+- 失败分支沿用既有 `option.onStartFail && option.onStartFail()`。
+
+---
+
+## 四、关键边界与结论
+
+- **多次新增不覆盖**：合成唯一 id 保证每次新增各开一页签。
+- **新增不误触发 getOne**：`tabParam.dataId = null` 覆盖 x-tabs 默认取 `row.id`。
+- **标题**：取名称字段（`multiTabLabelField`）真实值，编辑态改名再保存会同步；无值保持原标题不回退单号。
+- **防重复入库**：保存成功即升级 `tab.dataId`=单号，提交失败/取消后再保存走更新。
+- **详情最多刷一次**：元数据升级不重渲染，内容刷新集中在流程结束分支。
+- **wf 解耦**：`wf.js` 仅新增通用 `onCancel` 钩子；页签逻辑全在 xform。
+- **`wfStartBindSave` 关 + 直接启动 + 失败/取消**：无保存，不注入 abort 钩子 → 不刷新表单。
+- **向后兼容**：`addTabEnabled` 默认 false，存量表单（含 `multiTabEnabled=true`）行为不变；非 xform 的 wf 表单不受影响。
+
+---
+
+## 五、测试清单
+
+| # | 场景 | 预期 |
+|---|------|------|
+| 1 | 旧表单未开 `addTabEnabled` 点新增 | 走「常规」，不变 |
+| 2 | 存量 `multiTabEnabled=true` 未开 `addTabEnabled` | 编辑开页签，新增仍走常规 |
+| 3 | 连续点新增 | 各开一页签，不覆盖 |
+| 4 | 新增点开 | 空白新增表单，不调 getOne |
+| 5 | 新增保存 | 标题变名称字段、转编辑态、`dataId` 正确、不新开页签、详情刷一次 |
+| 6 | 编辑态改名再保存 | 页签标题同步为新名称 |
+| 7 | 保存并提交成功 + `refreshCurrent` | 详情刷一次，出流程信息 |
+| 8 | 保存并提交成功 + `closeToList` | 关页签、切列表、列表刷新 |
+| 9 | 保存并提交 → 提交失败 | 详情刷到编辑态，不重复入库 |
+| 10 | 保存并提交 → 关候选人弹框取消 | 详情刷到编辑态，不重复入库 |
+| 11 | 保存并提交后重复提交 | 走更新，不产生重复单据 |
+| 12 | `wfStartBindSave` 关 + 直接启动 + 失败/取消 | 表单不刷新 |
+| 13 | `wfStartBindSave` 开 + 直接启动 + 失败/取消 | 刷到编辑态 |
+| 14 | 关闭非首个动态页签 | 不报错（x-tabs 修复） |
+| 15 | 非 xform 表单用流程 | 失败/取消不刷新，成功行为不变 |
+
+---
+
+## 六、涉及文件
+
+| 文件 | 改动 |
+|------|------|
+| `components/xform/utils/util.js` | `getDefaultFormConfig` 加 3 字段 |
+| `components/xform/form-designer/setting-panel/form-setting.vue` | 配置 UI |
+| `components/vb-tabs/x-tabs.vue` | `removeTab` bug 修复 |
+| `views/user/form/view/list.vue` | `openEditDialog` 归一分支 + `resolveFormModel`/`applyTabSaveResult`/`onEditTabReload`/`promoteActiveAddTab` |
+| `components/xform/mixins/defaultHandle.js` | `saveAndSubmitWfHandle` 元数据升级 + 注入钩子 |
+| `components/xform/form-render/indexMixin.js` | wf option 注入 + `getAddTabContext`/`onWfStartSuccess`/`onWfStartAbort` |
+| `components/wf/wf.js` | `wfStartMixin` 通用 `onCancel` 钩子 + `wfSubmitted` 标志 |
+</content>

package/src/components/xform/docs/2026-07 table/344/270/216excelExport/344/277/256/345/244/215/345/217/212/345/257/274/345/207/272/344/274/230/345/214/226.md"

@@ -0,0 +1,57 @@
+# table / excelExport 排查修复与导出优化记录（2026-07）
+
+> 排查范围：`src/components/table/**`、`src/components/excelExport/**`（xform 数据表格与列表导出的底层依赖）。
+> 本轮实施了方案的第一期（稳定性）与第二期（性能），第三期（体验：分片上送、完成通知、可中断取消、blob 下载）未实施。
+> 验证：`npm run build:prod` 编译通过；ESLint 改动文件除存量 `operator-linebreak` 外零错误。
+
+## 一、table/ 修复清单
+
+| # | 位置 | 问题 | 修复 |
+|---|------|------|------|
+| T1 | `index.js` handleToolbar | 引用未定义的 `that`，配置 `bindToolbar: true` 即 ReferenceError | 改用 `$grid.$nextTick` |
+| T2 | `index.js` addTableData | `success` 回调被塞进请求体 data，永不执行 | 移到 `$http` 顶层参数 |
+| T3 | `index.js` exportConfig | vxe 原生导出 mode=all 的 `queryAll` 用无鉴权 `fetch`，从未可用 | 删除 queryAll，`modes` 收敛为 `["current"]`（全量导出走 `$excelExport`） |
+| T4 | `index.js` columnDrop.onEnd | 原地放下不触发 onMove 时 `tableColumn[-1]` 崩 | oldIndex 从 `dropParam.oldIndex` 兜底 + `!oldColumn \|\| !newColumn` 防护；顺带清理 6 个调试残留变量 |
+| T5 | `vxeFilter/mixin.js` searchEvent | 列含空值/数值时 `value.indexOf` 崩（筛选面板输入关键字必现） | `value != null && String(value).indexOf(...)` |
+| T6 | `index.js` ×3 | `console.log` 残留（列拖拽/自定义列保存高频打印） | 删除 |
+| T7 | `index.js` | `$http({async:false})` 无效参数；`addTableExportJson(){}` 空函数 | 删除 |
+| — | `util/index.js` groupDomRender | 存量空代码块（no-empty） | 合并条件 |
+
+## 二、excelExport/ 修复清单
+
+| # | 位置 | 问题 | 修复 |
+|---|------|------|------|
+| E1 | `mixins.js` | `exportTimer/countTimer` 是 IIFE 模块级共享变量，**并发导出互相清除对方定时器/泄漏** | 移入组件 `data()`，全部引用改 `this.*`；无用的 `exportMtTimer` 删除 |
+| E2 | `index.js` | 单例 `instance` 被二次调用直接覆盖（旧实例与 DOM 泄漏）；`destroyComponent(undefined)` 时 `loadingObj.close()` 崩 | initInstance 先销毁旧实例；loadingObj 判空（对齐 button.vue 版本） |
+| E3 | `mixins.js` | `clearInterval(loopToDo)` 传的是函数（no-op），分页调度 interval 空转 | 改 `clearInterval(that.exportTimer)` 并置空 |
+| E4 | `mixins.js` hadleMergeExcel | 合并阶段同步 `clearExportTimer` 把用时统计一起停掉；`startPage > endPage` 不 return 仍发非法请求 | 删同步清除；越界改 `abortExport() + return` |
+| E5 | `mixins.js` startProcess/2 | `path.split`：path 为函数时崩、`'#'` 时得到 `/undefined` | 函数先求值 + `'#'` 排除；推不出 prefix 时明确提示并中止 |
+| E6 | `mixins.js` exportAll | `input.tpye` 拼写错误 | `input.type` |
+| E7 | `exportFieldDialog.vue` dialogConfirm + `mixins.js` getHeadTitleJson | rowSpan 只对顶层无 children 列设置，≥3 层分组表头导出错位；且依赖导出明细列上不存在的 `item.level` | 按勾选后的实际树深度计算：叶子 `rowSpan = maxRowspan - depth + 1`，分组行 `rowSpan = 1` |
+| E8 | `exportFieldDialog.vue` generateId | 随机数范围 0~12.5 万，列多时 node-key 碰撞导致勾选错乱 | `"expcol_" + Date.now() + "_" + 自增序号` |
+| E9 | `mixins.js` 全链路 | 任何一页失败只静默 clearTimer：无提示、进度条永卡 | 新增 `abortExport(msg?)`：停定时器 + 进度条置 exception（index.vue 两个进度条挂 `:status`）+ 按需弹错（服务端已 toast 的不重复弹）；createExcelFile/addExcelData/mergeExcel 失败路径全部接入 |
+| 重试 | `mixins.js` loopToDo | 网络抖动一页失败整个导出报废 | 单页拉取失败自动重试 1 次（500ms 后），仍失败中止并提示失败页码（**缺页合并会静默丢行，必须中止而非跳过**） |
+
+## 三、导出性能优化（第二期）
+
+1. **取值快路径**（`mixins.js` 新增 `getExportCellValue`）：导出取值按 `column.params.exportVal` → `slots.filterVal` → `formatter`（纯函数）→ 原始字段 的优先级；配置了 `renderCell` / 函数型或字符串型 `slots.default` 的列才走 `getCellValue` 的 vNode 挂载渲染兜底。此前每个渲染型单元格都要挂载一次 Vue 组件再爬 DOM（千行×20列 = 2 万次挂载），是导出耗时大头。
+   - **行为变化注意**：formatter 列（如 d1/n1 日期数字格式化、UTC 转换列）此前导出的是**原始值**，现在导出**格式化后的值**（与界面显示一致）。属修正，但导出文件内容会与旧版不同。
+2. **vNode 渲染实例批量复用**（`table/util/index.js` 新增 `beginCellValueBatch/endCellValueBatch`）：导出期间兜底路径复用同一个临时实例，`getExcelData` 以 try/finally 包裹，结束统一销毁。筛选面板等其它 `getCellValue` 调用方行为不变。
+
+## 三补、导出取值补充修复（超链接按钮列导出为空 / 值错位）
+
+1. **字符串具名插槽列支持导出**（`table/util/index.js` getCellValue）：xform 的 aLink 超链接按钮、widget、widgetList 等列的 `slots.default` 是字符串插槽名（由 data-table-item.vue 的 `#widget` 等模板提供），此前导出侧无法执行——修复前直接当函数调用会崩，快路径版本则退化为取原始字段，而设计器对按钮类列会清空 `prop`（table-column-dialog.vue changeFormatS：`row.prop = null`），导致**超链接按钮列导出全为空**。现在 getCellValue 遇到字符串插槽时从 `$table.$xegrid.$scopedSlots[插槽名]` 解析出插槽函数再走 vNode 渲染（所见即所得：isFormLabel 的按钮导出表单值，静态标签导出按钮文字）；解析不到仍回退原始字段。`mixins.js` getExportCellValue 同步把字符串插槽列纳入渲染兜底。
+2. **vNode 挂载补唯一 key**（`table/util/index.js` ensureVNodeKey）：复用临时实例连续挂载**无 key** 的同类型组件 vNode 时，Vue patch 会复用旧组件实例、props 更新异步生效，同步爬 DOM 拿到的是**上一个单元格的内容**（jsdom 实测：`["AAA","AAA","AAA"]`；带 key 则正确）。该问题在旧代码中已存在于"同一单元格多个组件 vNode"场景（多个按钮只有第一个的值），批量复用后扩大到跨单元格。现挂载前为无 key 的 vNode 补全局唯一 key，强制全新挂载、同步渲染正确内容。
+
+## 四、未实施（第三期备忘）
+
+- `startProcess2`（当前页/勾选导出）仍是一次性单包上送，大数据量有请求体超限风险 → 建议分片复用分页 append；
+- 导出完成无右下角通知；「取消」只销毁前端组件，进行中的请求与服务端临时文件不中止/清理（后端如有 `/excel/clear` 类接口可接入 beforeDestroy）；
+- 下载仍为表单 POST 携带 `access_token`，可改 axios blob + header 鉴权（需后端支持）。
+
+## 五、对下游的兼容性提示
+
+- vxe 原生导出（toolbar 自带导出按钮）不再提供 mode=all 选项（该选项从未真正可用）；
+- formatter 列导出值从原始值变为格式化值（见三.1）；
+- 超链接按钮/按钮类列现在会导出渲染文字（isFormLabel 按钮导出表单值，静态标签按钮导出按钮文字）；此前这类列导出为空或使导出崩溃；
+- 建议回归：条件导出（含多文件分卷 >10 万行场景）、勾选/当前页导出、分组表头（2 层与 3 层）导出、带图片列导出、超链接按钮列导出、同一单元格多组件列导出（值不应重复第一个）、导出中途断网（应弹错并置红进度条）、两个页签同时导出。

package/src/components/xform/docs/2026-07 /346/216/222/346/237/245/344/277/256/345/244/215/350/256/260/345/275/225.md"

@@ -0,0 +1,73 @@
+# xform 排查修复记录（2026-07）
+
+> 排查范围：`src/components/xform/**`（501 文件，约 3.7 万行）与 `src/views/user/form/view/**`。
+> 本目录**无 git 历史**，本文档是本轮修改的唯一完整记录，请勿删除。
+> 验证：`npm run build:prod` 编译通过；ESLint 改动文件除存量 `operator-linebreak` 风格问题外零错误。
+
+## 一、背景
+
+对 xform 低代码表单引擎和表单列表/详情视图做整体排查，共确认 20 个问题（16 个首轮 + 4 个混淆代码解开后新增），本轮修复其中 18 个，2 个遗留（见第六节）。
+
+多数崩溃级问题的根因一致：**历史上曾把 webpack 编译产物反搬回源码**，残留了编译期局部变量（`ie`、`o`、`we`、`searviceName`、`regeneratorRuntime`），这些函数一经调用即抛 ReferenceError。
+
+## 二、崩溃级修复
+
+| # | 文件 | 问题 | 修复 |
+|---|------|------|------|
+| 1 | `form-render/indexMixin.js` | `executeDataSource` 引用未定义的 `ie`/`regeneratorRuntime`，调用即崩 | 重写为普通 async 函数，语义不变 |
+| 2 | `form-render/indexMixin.js` | `showDrawer` 引用未定义的 `o`/`we`（同结构的 `showDialog` 之前已修，此处漏改） | 新建 `form-render/dynamicDrawerRender.js`（照 `dynamicDialogRender.js` 改为 el-drawer 版），`showDrawer` 改用之 |
+| 3 | `form-render/indexMixin.js` | `findFieldWidgetById` 使用的 `getFieldWidgetById` 未 import | import 补齐（util.js 本就有导出） |
+| 4 | `fieldMixin.js` | `loadRowGloatOptions` 里 `getOptionItemValueKey()()` 双重调用，必抛 "not a function" | 去掉多余的 `()` |
+| 5 | `views/user/form/view/list.vue` | `reloadAutoContent` 引用不存在的 `this.tabs`（组件 data 无此属性），otherTab 表单 reload 必崩 | 按 `activeName`（`otherTab{N}`）定位 `otherTabList` 对应项 |
+| 6 | `views/user/form/view/list.vue` | `openEditDialog` 裸取 `option.activeName`，两参调用（业务脚本常见）即崩 | 改 `option?.activeName` |
+| 7 | `views/user/form/view/list.vue` | `openOtherTab` 找不到对应 formCode 时对 undefined 赋值；`initOtherTabList` 在 `otherTabList` 未配置时对 undefined 调 `.filter` | findIndex<0 时提示并返回；`otherTabList || []` 兜底 |
+| 8 | `container-item/data-table-mixin.js` | `getSearchFormData` 的 `loop` 对容器传自身递归 → 查询区含布局容器时点搜索栈溢出 | 改用已导入的 `loopHandleWidget` 递归各类容器，容器节点跳过、仅收集字段 |
+| 9 | `views/user/form/vform/render.vue` | formCode 无效/模板内容为空时读 `formConfig.layoutType` 白屏崩溃 | 提示「表单模板不存在或内容为空」并中止 |
+
+## 三、逻辑/数据类修复
+
+| # | 文件 | 问题 | 修复 |
+|---|------|------|------|
+| 10 | `data-table-mixin.js` | `moveUpRow` 非树表分支判 `rowIndex >= 0`，首行上移触发 `splice(-1)` 负索引，**行被挪到倒数第二位** | 改 `rowIndex > 0` |
+| 11 | `data-table-mixin.js` | `moveDownRow` 未防 `getRowIndex` 返回 -1，可能误删末行 | 补 `rowIndex >= 0 &&` |
+| 12 | `mixins/defaultHandle.js` | `deleteRelRows` 边界分支返回 `{masters, slaves}`、正常分支返回 `{list1, list2}`，解构方在越界时静默拿到 undefined | 边界分支统一为 `{list1, list2}` |
+| 13 | `fieldMixin.js` | `handleConfirmSearchDialog`：① 未配 `searchDialogConfig` 时裸取 `.multipleChoices` 崩；② 非 vabsearch 分支清空时 `row[item.sourceField]` 对 null 取值崩 | ① 改用已做 `\|\| {}` 防护的局部变量；② `!isClear && row` 前置判断 |
+| 14 | `form-render/indexMixin.js` | `saveForm` 的 validateForm 回调忽略 valid 参数，校验失败仍继续（靠二次校验兜底，产生未捕获 rejection 与双重报错） | `if (!valid) return;` |
+| 15 | `containerItemMixin.js` | `unregisterFromRefList` 只删 `refList[name]`，与 `refMixin.initRefList` 的行内 key（`name + "@row" + rowIndex`）不对齐 → 行内容器销毁不注销（幽灵引用），且可能误删主表单同名容器 | 注销 key 与注册对齐；仅当 key 仍指向当前实例时才删除（与 fieldMixin 已修策略一致） |
+| 16 | `containerItemMixin.js` | `handleCustomEvent` 缺 `!this.designState` 防护（fieldMixin/indexMixin 同名方法均有） | 补齐 |
+
+## 四、scriptHttp 机制整体清除（经确认：功能废弃）
+
+`this.scriptHttp(...)` 在全库**没有任何实现**（`mixins/scriptHttp.js` 文件名叫 scriptHttp 但只导出 `formHttp`；唯一定义是 designer 侧 provide 的空桩），所有运行态调用点自带即崩，说明该功能从未可用。经确认按废弃处理，调用点与死代码全部清除：
+
+- `fieldMixin.js`：删 `autoExcScript` 方法及 `handleOnMounted` 中的调用（原 `accessAutoExc` 配置触发点）；
+- `containerItemMixin.js`：删死代码 `autoExcScript`（调用处早已注释）；
+- `views/user/form/vform/render.vue`：删死方法 `getFormInsData`（实际走 `getFormInsData2`）；
+- `form-designer/form-widget/dialog/vabSearchDialog.vue`：**整文件删除**（经确认组件已废弃，且全库无 import 引用）；另外 4 个 dialog 里注释掉的 `// name: "vabSearchDialog"` 一并清理；
+- `form-designer/indexMixin.js`：删 provide 里的空桩 `scriptHttp: () => {}`。
+
+**影响说明**：字段配置里的 `accessAutoExc`（自动执行脚本）、`isLoadDataByAccess`/`scriptUuid`（脚本查询）从此为 no-op——原本配置了也必崩，故无存量可用场景。设计器面板中 `isLoadDataByAccess` 开关 UI 仍保留（`script-editor.vue`），`accessAutoExc` 开关本就被注释。
+
+## 五、死代码与文件清理
+
+| 操作 | 对象 | 原因 |
+|------|------|------|
+| 删除文件 | `utils/formHttp.js` | 引用未定义的 `searviceName`（错拼），全库无 import，纯地雷 |
+| 删除文件 | `form-designer/form-widget/dialog/baseFormulaDialog copy.vue` | 971 行无引用副本，且会随 npm 包发布 |
+| 删除文件 | `form-designer/form-widget/dialog/vabSearchDialog.vue` | 见第四节 |
+| 删除方法 | `form-render/indexMixin.js` 的 `exportPdf1/2/4/5` | 四个实验变体共 399 行，全库无引用；保留正式版 `exportPdf` |
+| 删除语句 | `debugger` ×3（list.vue ×2、indexMixin `goChangeBill`）、`console.log` ×2（`openCopyEditTab`）、`let a = 1` | 调试残留；`debugger` 在用户开 DevTools 时会冻结界面 |
+| 新建文件 | `form-render/dynamicDrawerRender.js` | el-drawer 动态渲染组件，补齐 `showDrawer` 缺失的依赖 |
+
+## 六、遗留事项（未修，需决策/后续处理）
+
+1. **`view/edit.vue` 的 `Number(dataId)` 精度风险**：若后端 id 为超过 2^53 的雪花 long，URL 直开编辑页会丢精度打开错单。等确认后端 id 方案后决定是否改为字符串透传。
+2. **结构性优化（可选）**：`handleCustomEvent`/`getEventParam` 在三处各有一份且行为不一（建议抽公共 mixin）；`mixins/scriptHttp.js` 建议改名 `formHttp.js`（牵动几十处 import，需单独提交）；`utils/emitter.js` 全树递归广播在大表单有性能隐患。
+3. **存量 ESLint 风格问题**：约 319 处 `operator-linebreak`（修复前即存在），可 `npx eslint --fix` 一次清理，diff 较大建议单独提交。
+4. `form-render/refMixin.js`、`utils/request.js` 等仍为混淆/压缩代码，后续如需审计或修改需先解开。
+
+## 七、对消费方（npm 包 cloud-web-corejs）的兼容性提示
+
+- 删除的 `exportPdf1/2/4/5`、`vabSearchDialog`、`utils/formHttp.js`：源码内无引用；若下游应用的**表单低代码脚本**（onClick 等）直接调用过 `exportPdf1/2/4/5`，升级后会报 undefined——但这些变体导出效果本就不完整，风险极低。
+- `executeDataSource` / `showDrawer` / `findFieldWidgetById`：由「调用即崩」变为可用，属纯修复。
+- `moveUpRow` 首行行为变化：原先首行“上移”会错位到倒数第二，现为无操作（正确语义）。

package/src/components/xform/docs/2026-08 /345/210/227/350/241/250/345/257/274/345/207/272/350/204/261/346/225/217/345/210/227/345/211/224/351/231/244/350/220/275/345/234/260/346/226/207/346/241/243.md"

@@ -0,0 +1,173 @@
+# 列表导出脱敏列剔除（2026-08）
+
+> 起因：配置了「加密」（密文文本）的字段，页面显示 `138****1234`，导出 Excel 却是完整明文。
+> 排查范围：`src/components/xform/**`、`src/components/excelExport/**`、`src/components/table/**`。
+
+## 一、问题定性
+
+「加密」是**纯前端展示遮罩**，不是数据加密：
+
+- 配置入口：属性面板 `textFlag-editor.vue` → `options.userTextRuleEnabled` + `options.userTextRuleConfig[]`
+- 单条规则 `{ serveName, companyCodes, roleCodes, type, encryptFormula }`，`type=1` 角色不匹配时脱敏、`type=2` 角色匹配时脱敏，`encryptFormula` 形如 `3*3`
+- 改造前实现只有一处：`form-item-wrapper.vue` —— `created` → `initShowType()` 算出 `widgetTextFlag=2`，模板改渲染 `<span>{{ getShowValue() }}</span>`，`getShowValue()` → `getProcessText()` 做星号替换
+
+**原始值始终完整存在于 `row[field]` / `fieldModel` 中**，遮罩只发生在渲染层。
+
+## 二、根因：导出取值绕开渲染层
+
+导出取值优先级（`excelExport/mixins.js:828 getExportCellValue`）：
+
+1. `column.params.exportVal`
+2. **`column.slots.filterVal(params)`** ← 命中点
+3. 无自定义渲染 → `row[field]`（有 `formatter` 则格式化）
+4. 兜底 `getCellValue()`：挂载 vNode 渲染再爬 DOM
+
+而 `data-table-mixin.js:1888` 对 `input / number / text / select / checkbox / radio / status / vabsearch / date / textarea / a-link / a-text` 这 12 类组件列统一注册了 `col.slots.filterVal`，函数体直接返回 `row[field]`（select/radio/checkbox 返回 optionLabel，vabsearch 返回 label 字段，date 返回格式化值）——**整条路径不碰 `form-item-wrapper`，不读 `widgetTextFlag`**。
+
+这 12 类恰好是最常配脱敏的字段类型。副作用是不一致：不在这 12 类里的组件列（`slots.default = "widget"`，无 `filterVal`）走第 4 条兜底，会真实渲染 wrapper 并爬 DOM，**导出的反而是星号**。同一张表有的列明文、有的列打码，且非有意设计。
+
+其它同源泄漏点：
+
+| 路径 | 改造前 |
+|---|---|
+| 明细导出（`exportItemColumns`，`data-table-mixin.js:2406`） | 必明文：列只有 `field/title`，行数据后端原样返回 |
+| 条件导出 / 全量导出 | 明文：`loopToDo` 分页拉后端原始行 → 同一个 `getExcelData` |
+| H5 列表容器 `list-h5-item.vue` | 明文：独立 `exportData`，列带 `params.widget` 但无 `filterVal` |
+| vxe 工具栏自带导出（`table/index.js` `exportConfig`） | 明文：vxe 用行原始值 |
+| 列筛选下拉候选值（`vxeFilter/mixin.js`） | 明文（不属导出，本轮未处理） |
+| 接口响应 / JS 内存 | 明文（需后端脱敏，前端不可解） |
+
+## 三、方案选型
+
+| 档位 | 做法 | 结论 |
+|---|---|---|
+| 1 | 前端一致性：给 `filterVal` 结果也套一层遮罩 | 未选。要同步改 4 处取值路径，且"导出打码值"对下游数据消费无意义 |
+| **2** | **命中脱敏规则的列直接整列不导出** | **本次采用** |
+| 3 | 后端按角色脱敏返回 / 提供脱敏导出接口 | 真正解法，本轮范围外。方案 1、2 都只是"看不见"，不是"拿不到" |
+
+方案 2 之所以成立：**所有导出（列表 / 条件 / 选择 / 明细）都必须先过 `exportFieldDialog`**（`mixins.js:133` 是唯一入口，`:1072` 回传 columns/leafColumns），而 `params.exportDisabled` 已被三处消费：
+
+| 位置 | 效果 |
+|---|---|
+| `exportFieldDialog.vue:95 filterNonDataExportColumns`（`:160` 调用） | 字段选择树里不出现该列，子列全没了则父分组也去掉 |
+| `exportFieldDialog.vue:319 dialogConfirm→loopDo` | 生成表头 JSON 时跳过 |
+| `excelExport/mixins.js:860 getExcelData` | 取数时过滤 `leafColumns` |
+
+所以只要把标记打到列上即可一次收口，无需改任何取值逻辑。
+
+> 曾评估过变体「保留表头、值置空」：需给通用 `excelExport` 新增 `exportMasked` 语义，且整列空白易被下游误读成"该记录无值"，已否决。
+
+## 四、改动清单
+
+### 1. 新增 `src/components/xform/utils/textMaskUtil.js`
+
+脱敏判定的**唯一实现**，渲染侧与导出侧共用（否则界面打码、导出放行必然漂移）。
+
+| 导出 | 职责 |
+|---|---|
+| `resolveTextMaskFlag(widgetOptions, ctx)` | 判定是否脱敏 + 带出命中的 `encryptFormula` |
+| `compareToList(list1, list2)` | 编码列表匹配，空列表表示不限 |
+| `hasTextMaskRule(widgetOptions)` | 是否配了有效规则（不代表当前用户命中） |
+| `buildTextMaskContext(formRef, companyCode)` | 组装 `{ bdService, companyCode, roleCodeList }` |
+| `markMaskedExportColumns($grid, ctx)` | 给命中列打 `params.exportDisabled`，并同步到明细导出列 |
+
+判定逻辑逐行照搬原 `initShowType`，包括两个易被"优化"掉的细节：
+
+- 规则列表**全遍历而非命中即止**，后置规则会覆盖前置结论；
+- `encryptFormula` 只要 serveName/companyCodes 命中就赋值，与 masked 与否无关。
+
+### 2. `form-item-wrapper.vue:676 initShowType`
+
+保留两个早退外壳（`!!this.designer`、`isLoadEntity && !dataId`）与 `field.options.widgetTextFlag` 写回，中间判定改调 util。行为等价，净减 73 行。
+
+`compareToList` 保留为薄封装委托 util —— 本包对外发布，不删以免破坏下游调用。
+
+### 3. `data-table-mixin.js`
+
+- `:3231 markMaskedColumnsForExport()` —— 3 行委托 util
+- `:3245 exportData()` 入口调用
+- `:253 mounted` 建列后 `$nextTick` 再调一次（见下节决策 3）
+
+### 4. `list-h5-item.vue:1664 / :1671`
+
+H5 列表容器有独立 `exportData`，同样处理。这是编码阶段才发现的第二条泄漏路径。
+
+### 5. `components/table/index.js:580`
+
+`exportConfig` 增加 `columnFilterMethod`，堵 vxe 工具栏自带导出旁路。
+
+**行为变化**：原有的操作列、图片列等 `exportDisabled` 列也会从原生导出中消失。属修正，但需业务知晓。
+
+### 6. `tests/unit/components/xform/textMaskUtil.spec.js`
+
+17 个用例，覆盖规则匹配的各分支、fail-closed、自愈还原、分组表头递归、明细列对齐。
+
+## 五、关键设计决策
+
+**决策 1 —— 判定放在导出触发时，不放在建列时。**
+`bdService` / `userRoleDTOs` 由异步接口填充（`form-render/indexMixin.js:458、479、498`），建列时可能尚未就绪。
+
+**决策 2 —— 不做"上下文未就绪"的收紧判断（踩过坑，见第十节）。**
+判定结论与渲染层严格一致即可：同一个 `resolveTextMaskFlag`、同一份用户上下文，且导出必然发生在单元格渲染之后（用户已经看到明文或密文）。**不要再引入任何"上下文是否就绪"的启发式**。
+
+**决策 3 —— `mounted` 也标记一次。**
+vxe 原生导出不走 `exportData()`，若只在导出入口标记，`columnFilterMethod` 会拿到一张没标记的列表，等于没堵。故建列后先按当时的上下文标记一次；此刻结论未必准，但只会"少防护"不会误伤，之后每次 `exportData` 会按最新上下文自愈修正。
+
+**决策 4 —— 标记幂等且可自愈，用私有键区分归属。**
+`exportDisabled` 也可能是 `isNonDataExportColumn`（`data-table-mixin.js:1710`）打的。若无差别地 `delete`，自愈会误放行操作列。故引入 `MASK_MARK_KEY = "exportDisabledByTextMask"`（`textMaskUtil.js:19`）：
+
+- 列本就带 `exportDisabled` 且无私有键 → 不接管，不打私有键
+- 由本函数从无到有打上 → 同时写私有键
+- 撤销时只在私有键存在时才删
+
+## 六、覆盖范围
+
+| 泄漏点 | 现状 |
+|---|---|
+| 列表导出 / 条件导出 / 选择导出 | ✅ 堵住 |
+| H5 列表导出 | ✅ 堵住 |
+| 明细导出 | ⚠️ 按 field 名对齐，见局限 L1 |
+| vxe 工具栏原生导出 | ✅ 决策 3 + 改动 5 |
+| 列筛选下拉候选值明文 | ❌ 未纳入（不属导出） |
+| 接口响应 / JS 内存明文 | ❌ 需后端脱敏 |
+| 打印 / PDF | 走 DOM，应是打码的，**未验证** |
+| 单元格区域复制 | **未验证**，疑似明文 |
+
+## 七、已知局限
+
+- **L1**：明细导出列只有 `field/title`，只能按字段名匹配主表脱敏字段集合。明细独有字段、或明细导出脚本返回的字段名与主表不一致时，仍会明文导出。
+- **L2**：动态列 / 行级 schema（`fieldSchemaMap`）下同列不同行配置可能不同，判定按列模板走；模板未配、个别行配了的情况会漏。
+- **L3**：表单低代码脚本里直接读 `row.xxx`、或列上配了自定义 `params.exportVal` 的，不受影响。
+- **L4**：脱敏是**列级**判定；将来若出现行级脱敏，本方案不适用。
+- **L5**：`exportFieldDialog.addTableExportColumns()`（`:252`）会把勾选状态持久化到 `$grid.exportColumns`。脱敏列不在树里 → 记为 `export:false`。同一用户换成不脱敏角色后，该列默认不勾选，需手动勾一次。
+
+## 八、验证情况
+
+已验证：
+
+- `npx jest`：13 套 157 个用例全过（新增 18 个）
+- ESLint：新增文件 0 error；改动文件只剩改动前就存在的既有错误（全库 132 个，`npm run lint` 本就不通过）
+
+**未做真机联调**，以下回归项待验：
+
+1. 配了脱敏的字段列，四种导出（列表 / 条件 / 选择 / 明细）文件中均无该列；
+2. 两种规则方向：`type=2 + 角色匹配`、`type=1 + 角色不匹配`；
+3. 未配脱敏的列完全不受影响；
+4. **分组表头 2 层 / 3 层下剔除叶子列后表头不错位**（`loopDo` 会重算 `colSpan/rowSpan`，本轮风险最高的一处）；
+5. 页面遮罩显示效果与改造前一致（验证 `initShowType` 重构无回归）；
+6. vxe 工具栏导出（若宿主开启了该按钮）。
+
+## 九、联调发现的问题（2026-08-04，已修）
+
+**现象**：配了规则后，部分用户看明文、部分看密文（符合预期），但**所有用户导出时该列都消失**。
+
+**根因**：首版实现有一个 `isTextMaskContextReady(ctx)`，用 `ctx.bdService` 非空 + 角色列表非空当作"用户上下文已就绪"的判据，未就绪时 fail-closed 剔除整列。但 `bdService` 来自 `/form_develop/getBdService`（`indexMixin.js:489`），`res.objx` 在大量环境本就是空值 —— 于是 `contextReady` 恒为 false，凡配了规则的列对所有用户一律被剔除。
+
+**修复**：删除 `isTextMaskContextReady`，`markMaskedExportColumns` 直接采用 `resolveTextMaskFlag` 的结论。
+
+**教训**：fail-closed 本身没错，错在"就绪"判据是拿业务值反推运行状态的启发式。这里根本不需要它 —— 渲染层用同一函数、同一上下文，且导出必然晚于渲染，结论天然一致；页面显示什么，导出就该按什么处理。回归用例见 spec 中「bdService 为空时结论仍只由规则决定」。
+
+## 十、同步提示
+
+- `textMaskUtil.js` 属包内新增文件，海尔分支（stdxx）整体覆盖时需一并带上，否则 `form-item-wrapper.vue` 与两个容器的 import 会解析失败；
+- 改动 5 落在 `components/table/index.js`（通用表格默认配置），影响面超出 xform，同步时注意与分支上的本地修改合并。

package/src/components/xform/docs/autocomplete /350/207/252/345/212/250/345/256/214/346/210/220/347/273/204/344/273/266/350/257/264/346/230/216.md"

@@ -0,0 +1,126 @@
+# autocomplete 自动完成组件
+
+基于 `el-autocomplete` 的远程搜索表单字段，支持**同时存储 ID 和名称**，可配置**后台逻辑脚本编码**进行远程搜索。
+
+## 特性
+
+- 远程搜索：输入关键词实时调用后台逻辑脚本获取候选项
+- 双值存储：选中后 ID 存入字段本身（`keyName`），名称存入展示字段（`vabSearchName`）
+- 逻辑脚本配置：复用 `httpConfig`（`formScriptCode` / `formScriptParam` / `formScriptSuccess`）
+- 选中回填：选中某项后可自动回填其他表单字段
+- ID 反查：编辑态可选通过反查脚本根据 ID 获取名称回显
+- 自定义下拉项模板：支持脚本自定义候选项展示 HTML
+- 支持子表单、只读模式、流程属性、显示规则等通用能力
+
+## 文件清单
+
+| 文件 | 作用 |
+|------|------|
+| `form-designer/form-widget/field-widget/autocomplete-widget.vue` | 运行期/设计期共用字段组件 |
+| `form-designer/form-widget/field-widget/mixins/autocomplete-mixin.js` | 核心逻辑（远程搜索、选择、回填、反查） |
+| `form-designer/widget-panel/widgetsConfig.js` | `autocompleteConfig` schema + 注册到 `advancedFields` |
+| `form-designer/setting-panel/property-editor/field-autocomplete/autocomplete-vabSearchName-editor.vue` | 属性编辑器（展示字段、回填配置等） |
+| `lang/zh-CN.js` / `lang/en-US.js` | 组件库标签 i18n |
+
+## 设计器配置
+
+在表单设计器左侧「高级字段」分组中拖入「自动完成」组件，右侧属性面板可配置：
+
+### 自动完成设置（`autocomplete-vabSearchName-editor`）
+
+面板精简为核心配置（参考「搜索框」组件的精简风格）：
+- **来源ID字段**（`valueField`）：候选项数据中 ID 对应的字段名，留空则使用字段本身 `keyName`；ID 始终存入字段本身
+- **来源名称字段**（`vabSearchName`）：候选项数据中名称对应的字段名，同时作为名称持久化的展示字段
+- **选中回填**（`autocompleteFillConfig`）：数组，每项 `{ targetField, targetFormField, sourceField }`
+
+其余通用项由标准编辑器提供：**输入提示**（`placeholder`）、**可清空**（`clearable`）在「常用设置」中配置；**清空回调**（`onSearchClear`）在「事件设置」中配置；**查询脚本编码**等在下方「请求访问设置」区块维护。
+
+> 以下选项仍保留在 `autocompleteConfig` schema 中（保证旧表单兼容与运行时行为），但已从设计器面板移除，如需使用可直接写入组件 `options` JSON：
+> - `triggerOnFocus`（默认 `true`）：聚焦空输入框时是否触发一次查询
+> - `debounce`（默认 `300`）：输入防抖毫秒数
+> - `getByIdScriptCode`：编辑态根据 ID 反查名称的脚本编码
+> - `autocompleteItemTemplate`：自定义下拉项模板脚本（入参 `item`，返回 HTML 字符串）
+
+## 远程搜索请求约定
+
+`querySearchAsync` 调用 `formHttp`，请求结构：
+
+```js
+{
+  scriptCode: formScriptCode,        // 配置的逻辑脚本编码
+  data: {
+    formCode,                        // 当前表单编码
+    formVersion,                     // 表单版本
+    taBm: fieldKeyName,              // 字段名
+    data: {
+      ...accessParam,                // formScriptParam 返回的额外参数
+      keyword: queryString           // 用户输入的关键词
+    }
+  }
+}
+```
+
+后台脚本返回的数据（`res.objx`）应为数组（或 `{ records: [...] }`），每个元素至少包含：
+- ID 字段：对应配置的 `valueField`（或字段 `keyName`）
+- 名称字段：对应配置的 `vabSearchName`
+
+`formScriptSuccess` 回调可对返回结果二次处理，返回新数组。
+
+## 选中行为
+
+`handleSelect(item)`：
+1. 取 `item[valueField]` 作为 ID，写入 `currentData[fieldKeyName]`（提交字段）
+2. 取 `item[labelField]` 作为名称，写入 `currentData[vabSearchName]`（展示字段）
+3. 按 `autocompleteFillConfig` 把 `item[sourceField]` 回填到目标字段/属性
+4. 触发 `onChange(value, oldValue, item)` 自定义事件
+
+## 清空行为
+
+`handleClear()`：同时清空 ID 与名称，触发 `onSearchClear`。
+
+## 编辑态回显
+
+- 默认：表单数据中 ID（`keyName`）与名称（`vabSearchName`）同时存在时，直接回显名称
+- 仅 ID 无名称：若配置了 `getByIdScriptCode`，`mounted` 时自动调用反查脚本获取名称回显
+
+反查脚本请求结构：
+```js
+{
+  scriptCode: getByIdScriptCode,
+  data: { formCode, formVersion, taBm, data: { ...accessParam, id } }
+}
+```
+
+## 与 vabsearch 的区别
+
+| 维度 | vabsearch | autocomplete |
+|------|-----------|--------------|
+| 交互 | 点击弹框选择 | 输入实时搜索下拉选择 |
+| 组件 | `el-input` + 弹框 | `el-autocomplete` |
+| 多选 | 支持 | 不支持（单选） |
+| 脚本 | 弹框表单编码 | 逻辑脚本编码（远程搜索） |
+| 存储 | ID + 名称 | ID + 名称（同） |
+
+## 关键选项 JSON 示例
+
+```json
+{
+  "type": "autocomplete",
+  "options": {
+    "name": "input123456",
+    "keyNameEnabled": true,
+    "keyName": "customer_id",
+    "vabSearchName": "customer_name",
+    "label": "客户",
+    "valueField": "id",
+    "formScriptEnabled": true,
+    "formScriptCode": "searchCustomer",
+    "triggerOnFocus": true,
+    "debounce": 300,
+    "clearable": true,
+    "autocompleteFillConfig": [
+      { "targetFormField": "customer_code", "sourceField": "code" }
+    ]
+  }
+}
+```