cloud-web-corejs 1.0.54-dev.725 → 1.0.54-dev.727

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "cloud-web-corejs",
   "private": false,
-  "version": "1.0.54-dev.725",
+  "version": "1.0.54-dev.727",
   "scripts": {
     "dev": "vue-cli-service serve",
     "lint": "eslint --ext .js,.vue src",

package/src/components/vb-tabs/x-tabs.vue

@@ -91,9 +91,10 @@ export default {
       });
       if (this.activeName === targetName) {
         if (tabIndex > 0) {
+          let prev = this.tabs[tabIndex - 1];
           this.activeName = tabNameEnable
-            ? tab.tabName
-            : this.tabs[tabIndex - 1].data[paneKeyName] + "";
+            ? prev.tabName
+            : prev.data[paneKeyName] + "";
         } else {
           this.activeName = "second";
         }

package/src/components/wf/content.vue

@@ -7,7 +7,7 @@
   >
     <template #default>
       <div
-        style="margin: -49px 0 16px 124px; position: relative; z-index: 2; height: 28px"
+        style="margin: -36px 0 8px 124px; position: relative; z-index: 2; height: 28px"
         v-if="!wfConfig.hiddenAllButton"
       >
         <el-button

package/src/components/wf/wf.js

@@ -1659,7 +1659,8 @@ wfStartMixin = {
       startFormData:{},
       wfUserRangeEnabled: false,
       preStartResult:[],
-      showSetCandidateDialog2:false
+      showSetCandidateDialog2:false,
+      wfSubmitted: false
     };
   },
   computed: {
@@ -1815,6 +1816,7 @@ wfStartMixin = {
 
     },
     startSubmitHanlde(formData){
+      this.wfSubmitted = true; // 标记已进入提交，避免随后关闭弹框误判为「取消」
       this.showDialog = false;
       let that = getTarget(this);
       let option = this.option;
@@ -1850,10 +1852,23 @@ wfStartMixin = {
         }
       });
     },
+    handleWfCancel() {
+      // 未进入提交就关闭 = 取消启动，回调通用 onCancel（一次性，避免多个弹框关闭重复触发）
+      if (this.wfSubmitted) return;
+      this.wfSubmitted = true;
+      this.option && this.option.onCancel && this.option.onCancel();
+    },
     close() {
+      this.handleWfCancel();
       this.$emit("update:visible", false);
     },
   },
+  watch: {
+    showSetCandidateDialog2(val, oldVal) {
+      // 候选人弹框未提交就关闭 = 取消启动
+      if (oldVal && !val) this.handleWfCancel();
+    },
+  },
 };
 
 wfModifyMixin = {

package/src/components/wf/wfUtil.js

@@ -141,7 +141,7 @@ f = async function (option) {
         appendPrevChildDom(wfBtnRegion, dom);
       }
 
-      if (wfBtnRegion && showStartBtn && !hasWf && !option.hiddenAllButton) {
+      if (wfBtnRegion && showStartBtn && option.injectStartBtn !== false && !hasWf && !option.hiddenAllButton) {
         let wfStartButtonName = configUtil.settingConfig.wfStartButtonName || this.$t2('流程启动', 'components.wf.wfStart');
         let dom = new configUtil.Vue({
           render: function (h) {

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` | 新增打开独立页签总开关。开启后新增走动态可关闭页签，不走「常规」 |
+| `addTabLabel` | String | `"新增"` | 新增页签初始标题 |
+| `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()`
+新增 3 个默认字段（**真正生效的默认值源**，非 designer.js 内联对象）：
+```js
+addTabEnabled: false,
+addTabLabel: "新增",
+submitBehavior: "closeToList",
+```
+
+### 2. `components/xform/form-designer/setting-panel/form-setting.vue`
+「列表标签页信息」分组新增：`addTabEnabled` 开关、`addTabLabel` 输入、`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]: formConfig.addTabLabel || "新增" } : 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/form-designer/designer.js

@@ -91,6 +91,10 @@ let chartContainers = [],
         wfConfigData: [],
         multiTabEnabled: false,
         multiTabLabelField: null,
+        addTabEnabled: false, // 新增打开独立页签（不走「常规」页签）
+        addTabLabel: "新增", // 新增页签初始标题
+        submitBehavior: "refreshCurrent", // 提交后行为: refreshCurrent(默认,留在详情页) | closeToList
+        billNavEnabled: false, // 详情页签显示「上一单/下一单」翻单按钮
         addFormCode: null,
         addFormName: null,
         wfTheme: null,

package/src/components/xform/form-designer/setting-panel/form-setting.vue

@@ -123,6 +123,12 @@
           <el-form-item :label="i18nt('新增页面表单名称')">
             {{ formConfig.addFormName }}
           </el-form-item>
+          <el-form-item :label="i18nt('详情翻单按钮')">
+            <el-switch v-model="formConfig.billNavEnabled"></el-switch>
+            <span style="margin-left: 8px; color: #999; font-size: 12px">
+              编辑态页签显示「上一单/下一单」
+            </span>
+          </el-form-item>
         </el-collapse-item>
         <el-collapse-item name="3" title="流程信息">
           <el-form-item :label="i18nt('启用流程')">
@@ -215,6 +221,31 @@
           <el-form-item :label="i18nt('标签名称字段')">
             <el-input type="text" v-model="formConfig.multiTabLabelField"></el-input>
           </el-form-item>
+          <el-form-item
+            v-if="formConfig.multiTabEnabled"
+            :label="i18nt('新增打开页签')"
+          >
+            <el-switch v-model="formConfig.addTabEnabled"></el-switch>
+            <span style="margin-left: 8px; color: #999; font-size: 12px">
+              开启后新增打开独立可关闭页签，需配置「标签名称字段」
+            </span>
+          </el-form-item>
+          <el-form-item
+            v-if="formConfig.multiTabEnabled && formConfig.addTabEnabled"
+            :label="i18nt('新增页签标题')"
+          >
+            <el-input
+              type="text"
+              v-model="formConfig.addTabLabel"
+              placeholder="默认`新增`"
+            ></el-input>
+          </el-form-item>
+          <el-form-item :label="i18nt('提交后行为')">
+            <el-radio-group v-model="formConfig.submitBehavior">
+              <el-radio label="closeToList">关闭页签并回列表刷新</el-radio>
+              <el-radio label="refreshCurrent">刷新当前页签</el-radio>
+            </el-radio-group>
+          </el-form-item>
         </el-collapse-item>
         <el-collapse-item name="5" title="其他标签页信息">
           <el-form-item :label="i18nt('自定义列表标签名称')">

package/src/components/xform/form-render/container-item/data-table-mixin.js

@@ -1526,11 +1526,29 @@ modules = {
       } else {
         formCode = formConfig.addFormCode || formConfig.editFormCode;
       }
+      // 上一单/下一单：打开详情时,按当前列表(排序/筛选后)有序行做快照,供详情页翻单使用
+      let navRows = null;
+      let navIndex = -1;
+      // 快照:当前页有序行引用 + 当前行下标(仅存引用,开销小)。
+      // 新增无当前行 → navIndex 置 -1,保存后由宿主把新单插入序列首位。
+      try {
+        let $grid = this.getGridTable && this.getGridTable();
+        let fullData = $grid && $grid.getTableData()?.fullData;
+        if (Array.isArray(fullData) && fullData.length) {
+          navRows = fullData;
+          navIndex = row?.id ? fullData.findIndex((r) => r.id === row.id) : -1;
+        }
+      } catch (e) {
+        navRows = null;
+        navIndex = -1;
+      }
       let parentTarget = formRef.$attrs["parent-target"];
       parentTarget &&
         parentTarget.$attrs.openEditDialog &&
         parentTarget.$attrs.openEditDialog(row, param, {
           formCode,
+          navRows,
+          navIndex,
           ...option,
         });
     },

package/src/components/xform/form-render/container-item/detail-item.vue

@@ -27,6 +27,31 @@
           </el-button>
         </div>-->
         <div class="fr">
+          <template v-if="billNav">
+            <el-button
+              class="button-sty"
+              size="mini"
+              icon="el-icon-arrow-left"
+              :disabled="!billNav.canPrev"
+              @click="navBill(-1)"
+              >上一单</el-button
+            >
+            <el-button
+              class="button-sty"
+              size="mini"
+              :disabled="!billNav.canNext"
+              @click="navBill(1)"
+              >下一单<i class="el-icon-arrow-right el-icon--right"></i
+            ></el-button>
+          </template>
+          <el-button
+            v-if="showWfStartBtn()"
+            class="button-sty yyy"
+            type="success"
+            icon="el-icon-video-play"
+            @click="startWf"
+            >{{ wfStartButtonName }}</el-button
+          >
           <template v-for="(subWidget, swIdx) in widget.widgetList">
             <template v-if="'container' === subWidget.category">
               <component
@@ -94,7 +119,8 @@ import containerItemMixin from "./containerItemMixin";
 import detailPaneWidget from "../../../../components/xform/form-render/container-item/detail-pane-item";
 import FieldComponents from "../../../../components/xform/form-designer/form-widget/field-widget/index";
 
-import { initWf } from "../../../../components/wf/wfUtil";
+import { initWf, openStartWfDialog } from "../../../../components/wf/wfUtil";
+import settingConfig from "@/settings.js";
 
 export default {
   name: "detail-item",
@@ -125,9 +151,82 @@ export default {
   data() {
     return {
       wfInfo: {},
+      wfReady: false, // 流程状态是否已就绪(callback 返回后)
+      wfHasStarted: false, // 流程是否已启动(已启动则不显示启动按钮)
+      wfStartOption: null, // 启动流程所需 option(createWf 构造)
+      wfStartCtx: null, // openStartWfDialog 的执行上下文(与 initWf 一致)
     };
   },
+  computed: {
+    wfStartButtonName() {
+      return (
+        settingConfig.wfStartButtonName ||
+        this.$t2("流程启动", "components.wf.wfStart")
+      );
+    },
+    // 「上一单/下一单」翻单按钮状态：详情表单开启 billNavEnabled 且宿主列表有翻单快照时才显示。
+    // detail-item 在每次翻单时随详情表单重挂载，故此处按当前挂载时机取一次即可。
+    billNav() {
+      let formRef = this.getFormRef && this.getFormRef();
+      if (
+        !formRef ||
+        !formRef.formConfig ||
+        !formRef.formConfig.billNavEnabled
+      ) {
+        return null;
+      }
+      let host = formRef.getListPageRef && formRef.getListPageRef();
+      if (!host || typeof host.getActiveBillNavState !== "function")
+        return null;
+      let state = host.getActiveBillNavState();
+      if (!state) return null;
+      return {
+        canPrev: state.index > 0,
+        canNext: state.index < state.rows.length - 1,
+      };
+    },
+  },
   methods: {
+    // 解析流程启动信息：优先取表单实例(indexMixin,xform 主链路)暴露的,回退到本组件 createWf(旧路径)。
+    // 用方法实时求值,避免 computed 缓存导致早于 wf 就绪时求值后不再更新。
+    wfStart() {
+      let formRef = this.getFormRef && this.getFormRef();
+      if (formRef && formRef.wfStartOption) {
+        return {
+          ctx: formRef.wfStartCtx || formRef,
+          option: formRef.wfStartOption,
+          hasWf: !!formRef.hasWf,
+        };
+      }
+      if (this.wfReady && this.wfStartOption && this.wfStartCtx) {
+        return {
+          ctx: this.wfStartCtx,
+          option: this.wfStartOption,
+          hasWf: this.wfHasStarted,
+        };
+      }
+      return null;
+    },
+    // 流程启动按钮：有启动信息、需要按钮(showStartBtn 未显式关闭)、未启动、非预览态才显示。
+    // 声明式渲染,替代 wfUtil 的 DOM 强制注入。
+    showWfStartBtn() {
+      let ws = this.wfStart();
+      if (!ws || this.previewState) return false;
+      let opt = ws.option || {};
+      return opt.showStartBtn !== false && !ws.hasWf;
+    },
+    // 声明式触发流程启动(替代原注入按钮的点击),复用 wfUtil 的 openStartWfDialog
+    startWf() {
+      let ws = this.wfStart();
+      if (!ws || !ws.option || !ws.ctx) return;
+      openStartWfDialog(ws.ctx, ws.option);
+    },
+    // 触发宿主翻单：step = -1 上一单 / +1 下一单
+    navBill(step) {
+      let host = this.getFormRef && this.getFormRef();
+      host = host && host.getListPageRef && host.getListPageRef();
+      host && host.navigateActiveBill && host.navigateActiveBill(step);
+    },
     reload() {
       this.getFormRef().$parent.$baseReload();
     },
@@ -145,12 +244,17 @@ export default {
         let option = {
           objId: formData.object_foreign_id, //单据ID
           wfCode: formCode, //流程编码
-          showStartBtn: true, //是否放出启动按钮,流程已启动时此参数失效
+          showStartBtn: true, //需要启动按钮(语义不变)
+          injectStartBtn: false, //不走 DOM 强制注入,改由本组件模板声明式渲染
           serviceId: "user",
-          callback: ({ wfInfo }) => {
+          callback: ({ wfInfo, hasWf }) => {
             this.wfInfo = wfInfo;
+            this.wfHasStarted = !!hasWf; //已启动则不显示启动按钮(与原注入条件 !hasWf 一致)
+            this.wfReady = true; //状态就绪后才显示按钮,避免回调前闪现
           },
         };
+        this.wfStartOption = option;
+        this.wfStartCtx = formTarget.$parent; //与 initWf 执行上下文一致,供 openStartWfDialog 使用
         initWf.call(formTarget.$parent, option);
       }
     },

package/src/components/xform/form-render/indexMixin.js

@@ -1342,7 +1342,8 @@ modules = {
             let option = {
               objId: dataId, //单据ID
               wfCode: wfCode, //流程编码
-              showStartBtn: true, //是否放出启动按钮,流程已启动时此参数失效
+              showStartBtn: true, //需要启动按钮(语义不变)
+              injectStartBtn: false, //但不走 wfUtil 的 DOM 强制注入,改由 detail-item 模板声明式渲染
               showWfFold: true,
               formCode: formCode,
               callback: (wfParam) => {
@@ -1376,9 +1377,16 @@ modules = {
                   wfParam.done();
                 }); */
               },
+              // 流程启动成功后的行为（新增页签模式）：复用 wf 已有的 onStartSuccess 契约，
+              // 覆盖「直接启动流程」按钮入口。逻辑收在 xform 侧。
+              onStartSuccess: () => this.onWfStartSuccess(),
             };
             if (formConfig.wfStartBindSave) {
               //启用流程启动自动保存
+              // 本次启动伴随了保存，失败/取消需把详情刷新到编辑态；
+              // 未启用自动保存（直接启动，无保存）时不注入，失败/取消不刷新表单。
+              option.onStartFail = () => this.onWfStartAbort();
+              option.onCancel = () => this.onWfStartAbort();
               option.onStart = (done) => {
                 let formRef = this.getFormRef ? this.getFormRef() : this;
                 formRef.validate((valid) => {
@@ -3576,6 +3584,16 @@ modules = {
       if (handleType) {
         let listTabFormRef = this.getListTabFormRef();
         if (handleType === "reload") {
+          // 若列表配置了「切换tab自动查询」,切到 second 时 watcher 已会触发查询,
+          // 此处再 reloadForm 会导致查询两次,故跳过,交给 tab 切换的自动查询。
+          let grid =
+            listTabFormRef && listTabFormRef.getGridWidgetRef
+              ? listTabFormRef.getGridWidgetRef()
+              : null;
+          let opts = grid && grid.widget ? grid.widget.options : null;
+          if (opts && opts.searchOnSwitchTab && opts.isQueryTable) {
+            return;
+          }
           listTabFormRef.reloadForm();
         } else if (handleType === "searchEvent") {
           listTabFormRef.getGridWidgetRef().searchEvent();
@@ -3584,6 +3602,82 @@ modules = {
         }
       }
     },
+    // 判断当前表单是否处于「详情多标签」的动态页签内；是则返回 {xTabs, currentName, submitBehavior}
+    // 门控为 multiTabEnabled(与「提交后行为」配置的显示条件一致)：动态编辑页签、新增页签均适用。
+    getAddTabContext() {
+      let listPageRef = this.getListPageRef && this.getListPageRef();
+      let listFormConfig =
+        listPageRef && listPageRef.formJson
+          ? listPageRef.formJson.formConfig
+          : null;
+      let xTabs =
+        listPageRef && listPageRef.$refs ? listPageRef.$refs.xTabs : null;
+      let currentName = xTabs ? xTabs.activeName : null;
+      let isDynamicTab =
+        currentName &&
+        currentName !== "first" &&
+        currentName !== "second" &&
+        !/^otherTab/.test(currentName);
+      if (listFormConfig && listFormConfig.multiTabEnabled && xTabs && isDynamicTab) {
+        return {
+          xTabs,
+          currentName,
+          submitBehavior: listFormConfig.submitBehavior || "refreshCurrent",
+        };
+      }
+      return null;
+    },
+    // 常规「first」页签的提交后上下文；否则 null。「提交后行为」不受 multiTabEnabled 限制。
+    getFirstPaneSubmitContext() {
+      let listPageRef = this.getListPageRef && this.getListPageRef();
+      let lfc =
+        listPageRef && listPageRef.formJson
+          ? listPageRef.formJson.formConfig
+          : null;
+      if (lfc && listPageRef.activeName === "first") {
+        return {
+          listPageRef,
+          submitBehavior: lfc.submitBehavior || "refreshCurrent",
+        };
+      }
+      return null;
+    },
+
+    onWfStartSuccess() {
+      // 流程启动成功后的通用钩子（由 wf 组件回调）。
+      // 「详情多标签」：按列表表单配置的 submitBehavior 处理；否则等价于默认刷新，不影响其它表单。
+      let ctx = this.getAddTabContext();
+      if (ctx) {
+        if (ctx.submitBehavior === "refreshCurrent") {
+          this.$baseReload(); // 刷新当前页签（出流程信息），保持编辑态
+        } else {
+          // 关闭页签并回列表刷新：先切列表（会把 activeName 置 second）再关当前页签
+          this.switchToListTab({ handleType: "reload" });
+          ctx.xTabs.removeTab(ctx.currentName);
+        }
+        return;
+      }
+      // 常规「first」页签（addTabEnabled 关时新增走此）同样按 submitBehavior 处理
+      let firstCtx = this.getFirstPaneSubmitContext();
+      if (firstCtx) {
+        if (firstCtx.submitBehavior === "refreshCurrent") {
+          this.$baseReload(); // 刷新当前 first 页签,显示已提交单据详情(dataId 已升级)
+        } else {
+          this.switchToListTab({ handleType: "reload" }); // 切列表并刷新
+          firstCtx.listPageRef.showEdit = false; // 关闭编辑态
+        }
+        return;
+      }
+      this.$baseReload();
+    },
+    onWfStartAbort() {
+      // 流程启动失败 / 取消（关闭启动或候选人弹框）的通用钩子。
+      // 「详情多标签」：把当前详情刷新到编辑态（此时元数据已升级，dataId 为单号）；
+      // 非本模式不处理，保持其它表单原有行为（失败/取消不刷新）。
+      if (this.getAddTabContext() || this.getFirstPaneSubmitContext()) {
+        this.$baseReload();
+      }
+    },
     reloadForm(option) {
       let target1 = this.$attrs["parent-target"];
       let target2 = target1?.$attrs["parent-target"];