weaver-e10-builder 1.6.5 → 1.6.7

package/dist/services/workflow-node-layout.d.ts

@@ -1,18 +1,3 @@
-/**
- * 流程节点独立布局 —— 节点上挂一套自己的表单布局，与表单默认布局并存。
- *
- * 关系是**互斥**的：一个节点同时只属于一套布局。把节点从 A 挪到 B 时，
- * 服务端会自动把它从 A 摘掉，摘掉后该节点回落到表单默认布局（`layoutId` 置空）。
- * 所以「绑定」这件事在接口层是**整集合覆盖**，不是增量追加：
- *   1. 读目标布局当前的引用节点全集；
- *   2. 加上/去掉本次要动的节点；
- *   3. `updateQuoteNode(nodeIds=新集合, sourceNodeIds=旧集合)` 整包提交。
- *
- * 端点分工（同一件事的三个视角）：
- * - 节点视角：`nodeLayout/getDisplayLayoutForm` → 这个节点挂的是哪套；
- * - 布局视角：`pathLayoutManage/getLayoutInfoParams` → 每套布局被哪些节点引用；
- * - 列表视角：`ebuilder/flow/form/layout/list` → 这个表单有哪些布局。
- */
 import { ApiClient } from '../core/client.js';
 import { type WorkflowFormKind } from './workflow-context.js';
 /**
@@ -44,7 +29,13 @@ interface FormRoute {
     designerSource: string;
     listLayouts: string;
     saveLayout: string;
+    /** 改布局元信息（名称/描述）。**与 saveLayout 不是同一条** —— 带 id 调 save 会主键冲突。 */
+    updateLayout: string;
+    /** 把某套布局设为该终端的默认布局。 */
+    updateDefault: string;
     getFormLayout: string;
+    /** 整份布局回写（设计器保存）。改组件内容只能走这条。 */
+    saveFormAndLayout: string;
     getConfig: string;
     initLayout: string;
 }
@@ -212,6 +203,133 @@ export declare function createFormLayout(client: ApiClient, opts: {
      */
     isNodeLayout?: boolean;
 }): Promise<FormLayoutRow>;
+/**
+ * `layout/update` 的 `formLayoutMultiple`：列表行 + 新名称/描述。
+ *
+ * `includeDescribe=false` 时不下发该键 —— 平台列表行本来就没有 `describe` 的
+ * （eb 表关联流程的默认布局就是这样）报文里也不带，按原样对齐，不凭空补空串。
+ */
+export declare function buildLayoutUpdateRow(row: FormLayoutRow, name: string, describe: string, includeDescribe?: boolean): Record<string, unknown>;
+export interface UpdateFormLayoutResult {
+    changed: boolean;
+    layoutId: string;
+    oldName: string;
+    oldDescribe: string;
+    name: string;
+    describe: string;
+    terminalType: string;
+    layoutType: string;
+    isDefault: boolean;
+}
+/**
+ * 修改布局名称或描述（保留布局内容、引用节点与默认设置）。
+ *
+ * `layout` 可传布局 ID 或布局名称；同名多套时报歧义并列 ID，不替调用方挑。
+ * 改完**回读布局列表**：名称/描述必须落库，且终端、类型、默认标记等元信息不能被顺手改掉。
+ */
+export declare function updateFormLayout(client: ApiClient, opts: {
+    formId: string;
+    /** 布局 ID（formLayoutMultiple.id）或布局名称 */
+    layout: string;
+    /** 新名称；不传 = 保持原名 */
+    name?: string;
+    /** 新描述；不传 = 保持原描述 */
+    describe?: string;
+    workflowId?: string;
+    formKind?: WorkflowFormKind;
+}): Promise<UpdateFormLayoutResult>;
+export interface SetDefaultLayoutResult {
+    changed: boolean;
+    layoutId: string;
+    name: string;
+    terminalType: string;
+    /** 改之前该终端上的默认布局（没有则为空串）。 */
+    previousDefaultId: string;
+}
+/**
+ * 把某套布局设为**该终端**的默认布局。
+ *
+ * 真机抓包（mulinquan 2026-10-29）：
+ * `POST {route}/layout/updateDefault`
+ * `{ module, formLayoutMultiple:{ id, form:{id:formId}, default:true, terminalType }, local:true }`
+ *
+ * 默认布局是**表单维度**、且 PC/移动端各自一套 —— 所以终端取自目标布局自身，
+ * 不是让调用方再传一次（传错就会把另一端的默认改掉）。
+ * 改完回读：目标必须是默认，**同终端不能还有第二套默认**。
+ */
+export declare function setDefaultLayout(client: ApiClient, opts: {
+    formId: string;
+    /** 布局 ID（formLayoutMultiple.id）或布局名称 */
+    layout: string;
+    workflowId?: string;
+    formKind?: WorkflowFormKind;
+}): Promise<SetDefaultLayoutResult>;
+/**
+ * 流程系统字段目录。`key` = `config.fieldId/valueKey`，`type` = 组件类型。
+ *
+ * 样式三档来自设计器落库的组件（真机抓包 2026-10-29，mulinquan）：
+ * `FlowPageSysFieldInput`+34 = 可输入；`FlowPageSysFieldReadOnly`+35 = 只读；
+ * `FlowPageSysFieldNoContent`+36 = 无内容（流程状态）。
+ *
+ * 标 `inferred` 的几项没在设计器里摆出来过，样式按平台常量推断 ——
+ * 若设计器摆出来的实际样式不同，以导出的组件为准改这里。
+ */
+export interface SystemFieldDef {
+    key: string;
+    type: string;
+    label: string;
+    compKey: string;
+    applyStyle: string;
+    inferred?: boolean;
+}
+export declare const SYSTEM_FIELD_CATALOG: SystemFieldDef[];
+/** 按 名称 / key / 组件类型 解析系统字段；认不出就报错并列出可选。 */
+export declare function resolveSystemField(input: string): SystemFieldDef;
+/** 拼一个系统字段组件（形状对齐设计器落库，见 2026-10-29 抓包）。 */
+export declare function buildSystemFieldComp(def: SystemFieldDef, ctx: {
+    formId: string;
+    tenantKey: string;
+    showOrder: number;
+    offsetTop: number;
+    singleRow?: boolean;
+}): Record<string, any>;
+export interface AddSystemFieldsResult {
+    layoutId: string;
+    layoutName: string;
+    terminalType: string;
+    added: Array<{
+        key: string;
+        title: string;
+    }>;
+    skipped: Array<{
+        key: string;
+        title: string;
+    }>;
+}
+/**
+ * 往某套流程表单布局里摆流程系统字段（提交人/流程编号/流程状态…）。
+ *
+ * 写的是**整份布局**：读取 `getFormLayout` → 在 `pageLayouts[0].comps` 末尾追加组件 →
+ * `builder/saveFormAndLayout` 回写。报文形状是设计器保存时的那套
+ * （真机抓包 2026-10-29）：`formLayout.pageLayouts` 直接发原始 JSON 就能落库，
+ * 不需要 `pageLayoutEncodes`；但 `formLayout.multipleLayoutId` 必带。
+ *
+ * 已经在布局里的系统字段会跳过（幂等）；写完回读核对新增字段，并确认原有组件一个没少。
+ */
+export declare function addSystemFieldsToLayout(client: ApiClient, opts: {
+    formId: string;
+    /** 目标布局 ID；不传 = PC 端默认布局 */
+    layoutId?: string;
+    /** 字段名/key/组件类型 */
+    fields?: string[];
+    /** true = 目录里全部字段 */
+    all?: boolean;
+    singleRow?: boolean;
+    workflowId?: string;
+    formKind?: WorkflowFormKind;
+    /** 认证会话里的租户标识（组件上有该字段） */
+    tenantKey: string;
+}): Promise<AddSystemFieldsResult>;
 /** 读某套布局的内容（不传 layoutId 读默认布局）。 */
 export declare function getLayoutContent(client: ApiClient, formId: string, layoutId?: string, workflowId?: string, formKind?: WorkflowFormKind): Promise<{
     layout: any;

package/dist/services/workflow-node-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"workflow-node-layout.d.ts","sourceRoot":"","sources":["../../src/services/workflow-node-layout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"workflow-node-layout.d.ts","sourceRoot":"","sources":["../../src/services/workflow-node-layout.ts"],"names":[],"mappings":"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"}

package/dist/services/workflow-node-layout.js

@@ -1,3 +1,19 @@
+/**
+ * 流程节点独立布局 —— 节点上挂一套自己的表单布局，与表单默认布局并存。
+ *
+ * 关系是**互斥**的：一个节点同时只属于一套布局。把节点从 A 挪到 B 时，
+ * 服务端会自动把它从 A 摘掉，摘掉后该节点回落到表单默认布局（`layoutId` 置空）。
+ * 所以「绑定」这件事在接口层是**整集合覆盖**，不是增量追加：
+ *   1. 读目标布局当前的引用节点全集；
+ *   2. 加上/去掉本次要动的节点；
+ *   3. `updateQuoteNode(nodeIds=新集合, sourceNodeIds=旧集合)` 整包提交。
+ *
+ * 端点分工（同一件事的三个视角）：
+ * - 节点视角：`nodeLayout/getDisplayLayoutForm` → 这个节点挂的是哪套；
+ * - 布局视角：`pathLayoutManage/getLayoutInfoParams` → 每套布局被哪些节点引用；
+ * - 列表视角：`ebuilder/flow/form/layout/list` → 这个表单有哪些布局。
+ */
+import { randomBytes } from 'node:crypto';
 import { getWorkflowContext } from './workflow-context.js';
 const PATHDEF = '/api/bs/workflow/pathdef';
 const FLOW_FORM = '/api/ebuilder/flow/form';
@@ -10,7 +26,11 @@ const ROUTE_EBUILDER = {
     designerSource: 'ebuilderform',
     listLayouts: `${FLOW_FORM}/layout/list`,
     saveLayout: `${FLOW_FORM}/layout/save`,
+    updateLayout: `${FLOW_FORM}/layout/update`,
+    updateDefault: `${FLOW_FORM}/layout/updateDefault`,
     getFormLayout: `${FORM_BUILDER}/getFormLayout`,
+    // ⚠ 与 getFormLayout 不是同一个前缀：保存是 `/api/ebuilder/form/form/builder/*`
+    saveFormAndLayout: '/api/ebuilder/form/form/builder/saveFormAndLayout',
     getConfig: '/api/ebuilder/form/form/view/relate/getConfig',
     initLayout: '/api/ebuilder/form/form/view/relate/initLayout',
 };
@@ -22,7 +42,10 @@ const ROUTE_WORKFLOW = {
     designerSource: 'workflow',
     listLayouts: '/api/workflow/core/form/layout/list',
     saveLayout: '/api/workflow/core/form/layout/save',
+    updateLayout: '/api/workflow/core/form/layout/update',
+    updateDefault: '/api/workflow/core/form/layout/updateDefault',
     getFormLayout: '/api/workflow/core/form/builder/getFormLayout',
+    saveFormAndLayout: '/api/workflow/core/form/builder/saveFormAndLayout',
     getConfig: '/api/workflow/core/form/view/relate/getConfig',
     initLayout: '/api/workflow/core/form/view/relate/initLayout',
 };
@@ -283,6 +306,377 @@ export async function createFormLayout(client, opts) {
         isDefault: !!flm.isDefault,
     };
 }
+/**
+ * 「改布局名称/描述」的报文字段白名单（真机抓包 2026-10-29，mulinquan）。
+ *
+ * 平台走的是**独立的** `layout/update`，不是 `layout/save`：
+ * 带 `formLayoutMultiple.id` 调 `save` 会走插入分支，直接主键冲突 500。
+ * 报文就是把 `layout/list` 那一行原样带回来、只换 `name`/`describe`，
+ * 所以这里按行取值，不自己造字段。
+ */
+const LAYOUT_UPDATE_FIELDS = [
+    'id', 'name', 'describe', 'terminalType', 'operator', 'creator', 'createTime', 'updateTime',
+    'isDefault', 'versionId', 'layoutType', 'isSys', 'parentId', 'readOnly', 'simple', 'labelObj',
+];
+/**
+ * `layout/update` 的 `formLayoutMultiple`：列表行 + 新名称/描述。
+ *
+ * `includeDescribe=false` 时不下发该键 —— 平台列表行本来就没有 `describe` 的
+ * （eb 表关联流程的默认布局就是这样）报文里也不带，按原样对齐，不凭空补空串。
+ */
+export function buildLayoutUpdateRow(row, name, describe, includeDescribe = true) {
+    const out = {};
+    for (const key of LAYOUT_UPDATE_FIELDS) {
+        if (row[key] !== undefined)
+            out[key] = row[key];
+    }
+    out.id = row.id;
+    out.name = name;
+    if (includeDescribe)
+        out.describe = describe;
+    else
+        delete out.describe;
+    // 默认布局那一行列表里没有 labelObj，抓包里该键是 "{}" —— 缺了它平台会按空对象存
+    if (out.labelObj === undefined)
+        out.labelObj = '{}';
+    return out;
+}
+/**
+ * 修改布局名称或描述（保留布局内容、引用节点与默认设置）。
+ *
+ * `layout` 可传布局 ID 或布局名称；同名多套时报歧义并列 ID，不替调用方挑。
+ * 改完**回读布局列表**：名称/描述必须落库，且终端、类型、默认标记等元信息不能被顺手改掉。
+ */
+export async function updateFormLayout(client, opts) {
+    const base = client.getBaseUrl();
+    const rows = await collectLayoutsBothTerminals(client, opts.formId, opts.workflowId, opts.formKind);
+    const key = String(opts.layout).trim();
+    if (!key)
+        throw new Error('布局 ID 或名称不能为空');
+    const byId = rows.filter((r) => r.id === key);
+    const matches = byId.length ? byId : rows.filter((r) => r.name === key);
+    const listCurrent = () => (rows.map((r) => `${r.name}(${r.id}/${r.terminalType})`).join('、') || '（该表单还没有任何布局）');
+    if (!matches.length)
+        throw new Error(`未找到布局「${opts.layout}」。现有：${listCurrent()}`);
+    if (matches.length > 1) {
+        throw new Error(`有 ${matches.length} 套布局都叫「${key}」，无法确定目标。请用布局 ID：`
+            + matches.map((r) => `${r.id}（${r.terminalType}）`).join('、'));
+    }
+    const row = matches[0];
+    // ⚠ 不要按 isSys / readOnly 拦：**默认布局本来就是 isSys:true + readOnly:true**
+    // （eb 表关联流程真机抓包 2026-10-29，布局管理里照样能改名）。拦了就是「能用的命令不让用」。
+    // 真的不允许改时由平台拒绝，我们照常报错。
+    const name = opts.name === undefined ? row.name : opts.name.trim();
+    if (!name)
+        throw new Error('布局名称不能为空');
+    const describe = opts.describe === undefined ? String(row.describe ?? '') : opts.describe;
+    const oldDescribe = String(row.describe ?? '');
+    const result = (changed) => ({
+        changed,
+        layoutId: row.id,
+        oldName: row.name,
+        oldDescribe,
+        name,
+        describe,
+        terminalType: row.terminalType,
+        layoutType: row.layoutType,
+        isDefault: row.isDefault,
+    });
+    if (name === row.name && describe === oldDescribe)
+        return result(false);
+    const route = await resolveFormRoute(client, opts.formId, opts.workflowId, opts.workflowId ? undefined : 'workflow');
+    ok(await client.post(`${base}${route.updateLayout}`, {
+        module: route.cardModule,
+        customParam: {
+            // 与 `layout add` 一致：显式给了就用，没给用 formId 兜底
+            workflowId: opts.workflowId || opts.formId,
+            isNodeLayout: true,
+        },
+        formLayoutMultiple: buildLayoutUpdateRow(row, name, describe, row.describe !== undefined || opts.describe !== undefined),
+        local: true,
+        copyConfig: { formDataLinkage: true, excelLinkage: true },
+    }, { ebbusinessid: opts.formId }), '修改布局');
+    const after = await collectLayoutsBothTerminals(client, opts.formId, opts.workflowId, opts.formKind);
+    const saved = after.find((r) => r.id === row.id);
+    if (!saved)
+        throw new Error(`修改后回读布局列表里找不到布局 ${row.id}`);
+    if (saved.name !== name || String(saved.describe ?? '') !== describe) {
+        throw new Error(`修改后回读不一致：期望「${name}」/「${describe}」，实际「${saved.name}」/「${saved.describe ?? ''}」`);
+    }
+    // 只改名字，别把终端/类型/默认设置一起动了
+    const drift = ['terminalType', 'layoutType', 'isDefault', 'isSys', 'readOnly']
+        .filter((k) => String(row[k] ?? '') !== String(saved[k] ?? ''));
+    if (drift.length) {
+        throw new Error(`改名的同时这些布局属性被平台改动：${drift.join('、')} —— 请到布局管理核对`);
+    }
+    return result(true);
+}
+/**
+ * 把某套布局设为**该终端**的默认布局。
+ *
+ * 真机抓包（mulinquan 2026-10-29）：
+ * `POST {route}/layout/updateDefault`
+ * `{ module, formLayoutMultiple:{ id, form:{id:formId}, default:true, terminalType }, local:true }`
+ *
+ * 默认布局是**表单维度**、且 PC/移动端各自一套 —— 所以终端取自目标布局自身，
+ * 不是让调用方再传一次（传错就会把另一端的默认改掉）。
+ * 改完回读：目标必须是默认，**同终端不能还有第二套默认**。
+ */
+export async function setDefaultLayout(client, opts) {
+    const base = client.getBaseUrl();
+    const rows = await collectLayoutsBothTerminals(client, opts.formId, opts.workflowId, opts.formKind);
+    const key = String(opts.layout).trim();
+    if (!key)
+        throw new Error('布局 ID 或名称不能为空');
+    const byId = rows.filter((r) => r.id === key);
+    const matches = byId.length ? byId : rows.filter((r) => r.name === key);
+    if (!matches.length) {
+        throw new Error(`未找到布局「${opts.layout}」。现有：`
+            + (rows.map((r) => `${r.name}(${r.id}/${r.terminalType})`).join('、') || '（该表单还没有任何布局）'));
+    }
+    if (matches.length > 1) {
+        throw new Error(`有 ${matches.length} 套布局都叫「${key}」，无法确定目标。请用布局 ID：`
+            + matches.map((r) => `${r.id}（${r.terminalType}）`).join('、'));
+    }
+    const row = matches[0];
+    const terminal = row.terminalType || 'PC';
+    const currentDefault = rows.find((r) => r.terminalType === terminal && r.isDefault);
+    const previousDefaultId = currentDefault?.id || '';
+    if (row.isDefault) {
+        return { changed: false, layoutId: row.id, name: row.name, terminalType: terminal, previousDefaultId };
+    }
+    const route = await resolveFormRoute(client, opts.formId, opts.workflowId, opts.workflowId ? undefined : 'workflow');
+    ok(await client.post(`${base}${route.updateDefault}`, {
+        module: route.cardModule,
+        formLayoutMultiple: {
+            id: row.id,
+            form: { id: opts.formId },
+            default: true,
+            terminalType: terminal,
+        },
+        local: true,
+    }, { ebbusinessid: opts.formId }), '设置默认布局');
+    const after = await collectLayoutsBothTerminals(client, opts.formId, opts.workflowId, opts.formKind);
+    const saved = after.find((r) => r.id === row.id);
+    if (!saved)
+        throw new Error(`设置后回读布局列表里找不到布局 ${row.id}`);
+    if (!saved.isDefault) {
+        throw new Error(`设置后回读「${saved.name}」仍不是默认布局 —— 请到布局管理核对`);
+    }
+    const rivalDefaults = after.filter((r) => r.terminalType === terminal && r.id !== row.id && r.isDefault);
+    if (rivalDefaults.length) {
+        throw new Error(`${terminal} 端同时存在多个默认布局：${rivalDefaults.map((r) => `${r.name}(${r.id})`).join('、')}`
+            + ` —— 请到布局管理核对`);
+    }
+    return { changed: true, layoutId: row.id, name: row.name, terminalType: terminal, previousDefaultId };
+}
+export const SYSTEM_FIELD_CATALOG = [
+    { key: 'REQ_REQUEST_NAME', type: 'FlowPageSysFieldReqName', label: '流程标题', compKey: 'FlowPageSysFieldInput', applyStyle: '34' },
+    { key: 'REQUEST_NO', type: 'FlowPageSysFieldMarkReserved', label: '流程编号', compKey: 'FlowPageSysFieldReadOnly', applyStyle: '35' },
+    { key: 'REQUEST_LEVEL', type: 'FlowPageSysFieldRequestlevel', label: '紧急程度', compKey: 'FlowPageSysFieldInput', applyStyle: '34' },
+    { key: 'REQUEST_SECRET_LEVEL', type: 'FlowPageSysFieldSeclevel', label: '密级', compKey: 'FlowPageSysFieldInput', applyStyle: '34', inferred: true },
+    { key: 'CREATE_USER', type: 'FlowPageSysFieldCreator', label: '提交人', compKey: 'FlowPageSysFieldReadOnly', applyStyle: '35' },
+    { key: 'CREATE_DEPT', type: 'FlowPageSysFieldCreatorDept', label: '提交人部门', compKey: 'FlowPageSysFieldReadOnly', applyStyle: '35' },
+    { key: 'CREATE_SUB', type: 'FlowPageSysFieldCreatorSubCompany', label: '提交人分部', compKey: 'FlowPageSysFieldReadOnly', applyStyle: '35' },
+    { key: 'CREATE_DATETIME', type: 'FlowPageSysFieldCreateTime', label: '提交时间', compKey: 'FlowPageSysFieldReadOnly', applyStyle: '35' },
+    { key: 'FINISH_DATETIME', type: 'FlowPageSysFieldFinishTime', label: '结束时间', compKey: 'FlowPageSysFieldReadOnly', applyStyle: '35' },
+    { key: 'FlowPageSysFieldExpiryTime', type: 'FlowPageSysFieldExpiryTime', label: '到期时间', compKey: 'FlowPageSysFieldInput', applyStyle: '34', inferred: true },
+    { key: 'PRINT_COUNT', type: 'FlowPageSysFieldPrintCount', label: '打印次数', compKey: 'FlowPageSysFieldReadOnly', applyStyle: '35', inferred: true },
+    { key: 'WORKFLOW_NAME', type: 'FlowPageSysFieldWorkflowName', label: '工作流名称', compKey: 'FlowPageSysFieldReadOnly', applyStyle: '35' },
+    { key: 'WORKFLOW_TYPE', type: 'FlowPageSysFieldWorkflowType', label: '工作流类型', compKey: 'FlowPageSysFieldReadOnly', applyStyle: '35' },
+    { key: 'WORKFLOW_DESC', type: 'FlowPageSysFieldWorkflowDesc', label: '工作流描述', compKey: 'FlowPageSysFieldReadOnly', applyStyle: '35' },
+    { key: 'FLOW_STATUS_COMP', type: 'FlowPageFlowStatus', label: '流程状态', compKey: 'FlowPageSysFieldNoContent', applyStyle: '36' },
+];
+/** 按 名称 / key / 组件类型 解析系统字段；认不出就报错并列出可选。 */
+export function resolveSystemField(input) {
+    const raw = String(input ?? '').trim();
+    if (!raw)
+        throw new Error('系统字段不能为空');
+    const hit = SYSTEM_FIELD_CATALOG.find((d) => d.key === raw)
+        || SYSTEM_FIELD_CATALOG.find((d) => d.type === raw)
+        || SYSTEM_FIELD_CATALOG.find((d) => d.label === raw);
+    if (!hit) {
+        throw new Error(`不支持的流程系统字段「${input}」。可选：`
+            + SYSTEM_FIELD_CATALOG.map((d) => `${d.label}(${d.key})`).join('、'));
+    }
+    return hit;
+}
+/** 组件 id：32 位十六进制，**首位取 a-f**（与平台生成的一致）。 */
+function randomCompId() {
+    const first = 'abcdef';
+    const hex = '0123456789abcdef';
+    const b = randomBytes(32);
+    let out = first[b[0] % first.length];
+    for (let i = 1; i < 32; i++)
+        out += hex[b[i] % hex.length];
+    return out;
+}
+/** `config.flow.nodeId`：10 位 URL-safe 随机串。 */
+function randomFlowNodeId() {
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+    const b = randomBytes(10);
+    let out = '';
+    for (let i = 0; i < 10; i++)
+        out += chars[b[i] % chars.length];
+    return out;
+}
+/** 拼一个系统字段组件（形状对齐设计器落库，见 2026-10-29 抓包）。 */
+export function buildSystemFieldComp(def, ctx) {
+    const isInput = def.compKey === 'FlowPageSysFieldInput';
+    return {
+        id: randomCompId(),
+        refCompId: '',
+        type: def.type,
+        category: '111',
+        refModule: '',
+        tenantKey: ctx.tenantKey,
+        styleCategoryCompKey: def.compKey,
+        styleCategoryPackage: '@weapp/workflow',
+        applyStyle: def.applyStyle,
+        isCover: 0,
+        // 可输入那两档（流程标题/紧急程度）设计器落库时没有 prop:EB，只读/无内容才有
+        ...(isInput ? {} : { prop: 'EB' }),
+        config: {
+            compPackage: '@weapp/workflow',
+            fieldId: def.key,
+            fieldKey: def.type,
+            flow: { parent: 'ROOT', nodes: [], isCanvas: false, linkedNodes: {}, nodeId: randomFlowNodeId() },
+            formId: ctx.formId,
+            isFormSyncTitleLayout: true,
+            layout: { selected: false, offsetTop: ctx.offsetTop },
+            name: def.label,
+            permission: {},
+            size: 'large',
+            switchFormItem: true,
+            title: def.label,
+            type: def.type,
+            valueKey: def.key,
+            showOrder: ctx.showOrder,
+            disableEdit: false,
+            display: true,
+            singleRow: ctx.singleRow === true,
+            readOnly: false,
+            required: false,
+        },
+        package: '@weapp/workflow',
+    };
+}
+/**
+ * 往某套流程表单布局里摆流程系统字段（提交人/流程编号/流程状态…）。
+ *
+ * 写的是**整份布局**：读取 `getFormLayout` → 在 `pageLayouts[0].comps` 末尾追加组件 →
+ * `builder/saveFormAndLayout` 回写。报文形状是设计器保存时的那套
+ * （真机抓包 2026-10-29）：`formLayout.pageLayouts` 直接发原始 JSON 就能落库，
+ * 不需要 `pageLayoutEncodes`；但 `formLayout.multipleLayoutId` 必带。
+ *
+ * 已经在布局里的系统字段会跳过（幂等）；写完回读核对新增字段，并确认原有组件一个没少。
+ */
+export async function addSystemFieldsToLayout(client, opts) {
+    const base = client.getBaseUrl();
+    const route = await resolveFormRoute(client, opts.formId, opts.workflowId, opts.workflowId ? undefined : 'workflow');
+    // 目标布局：显式给了就按 id/名称找；没给 = PC 默认布局
+    const rows = await collectLayoutsBothTerminals(client, opts.formId, opts.workflowId, opts.formKind);
+    let target;
+    if (opts.layoutId) {
+        const key = String(opts.layoutId).trim();
+        const byId = rows.filter((r) => r.id === key);
+        const matches = byId.length ? byId : rows.filter((r) => r.name === key);
+        if (!matches.length) {
+            throw new Error(`未找到布局「${opts.layoutId}」。现有：`
+                + (rows.map((r) => `${r.name}(${r.id}/${r.terminalType})`).join('、') || '（该表单还没有任何布局）'));
+        }
+        if (matches.length > 1) {
+            throw new Error(`有 ${matches.length} 套布局都叫「${key}」，请用布局 ID：`
+                + matches.map((r) => `${r.id}（${r.terminalType}）`).join('、'));
+        }
+        target = matches[0];
+    }
+    else {
+        target = rows.find((r) => r.terminalType === 'PC' && r.isDefault)
+            || rows.find((r) => r.isDefault);
+        if (!target)
+            throw new Error('该表单没有默认布局，请用 --layout-id 指定目标布局');
+    }
+    const defs = opts.all
+        ? [...SYSTEM_FIELD_CATALOG]
+        : (opts.fields || []).map(resolveSystemField);
+    if (!defs.length)
+        throw new Error('请给出要添加的系统字段，或加 --all 添加全部');
+    const read = async () => {
+        const res = ok(await client.post(`${base}${route.getFormLayout}`, { ...getFormLayoutBody(opts.formId, target.id), module: route.formModule }, { ebbusinessid: opts.formId }), '读取布局内容');
+        return res;
+    };
+    const data = await read();
+    const layout = structuredClone(data?.formLayout || {});
+    const pages = Array.isArray(layout.pageLayouts) ? layout.pageLayouts : [];
+    if (!pages.length)
+        throw new Error('该布局没有 pageLayouts，无法添加字段');
+    const page = pages[0];
+    const comps = Array.isArray(page.comps) ? page.comps : [];
+    const existingKeys = new Set(comps.map((c) => String(c?.config?.fieldId ?? c?.config?.valueKey ?? '')).filter(Boolean));
+    const beforeIds = new Set(comps.map((c) => String(c?.id ?? '')).filter(Boolean));
+    const added = [];
+    const skipped = [];
+    let maxOrder = comps.reduce((m, c) => Math.max(m, Number(c?.config?.showOrder) || 0), -1);
+    let maxTop = comps.reduce((m, c) => Math.max(m, Number(c?.config?.layout?.offsetTop) || 0), -1);
+    for (const def of defs) {
+        if (existingKeys.has(def.key)) {
+            skipped.push({ key: def.key, title: def.label });
+            continue;
+        }
+        maxOrder += 1;
+        maxTop += 79;
+        comps.push(buildSystemFieldComp(def, {
+            formId: opts.formId, tenantKey: opts.tenantKey,
+            showOrder: maxOrder, offsetTop: maxTop, singleRow: opts.singleRow,
+        }));
+        existingKeys.add(def.key);
+        added.push({ key: def.key, title: def.label });
+    }
+    if (!added.length) {
+        return { layoutId: target.id, layoutName: target.name, terminalType: target.terminalType, added, skipped };
+    }
+    page.comps = comps;
+    const form = data?.form || {};
+    ok(await client.post(`${base}${route.saveFormAndLayout}`, {
+        module: route.cardModule,
+        // 与设计器保存一致：workflowId 必带；layoutMultiId/nodeId 置空
+        customParam: { workflowId: opts.workflowId || opts.formId, layoutMultiId: '', nodeId: '' },
+        designerParam: { permissionId: '', changes: {}, onlyLayout: false, convert: false },
+        form: {
+            module: form.module || route.formModule,
+            id: String(form.id || opts.formId),
+            name: String(form.name || ''),
+            describe: String(form.describe || ''),
+            physicalTable: !!form.physicalTable,
+            pageNo: 0, current: 0, pageSize: 0,
+            isVirtualForm: !!form.isVirtualForm,
+        },
+        formLayout: {
+            updateTimeStamp: layout.updateTimeStamp,
+            id: layout.id,
+            name: layout.name,
+            describe: layout.describe || '',
+            multipleLayoutId: target.id,
+            formId: opts.formId,
+            pageLayouts: layout.pageLayouts,
+            formStyle: layout.formStyle,
+        },
+    }, { ebbusinessid: opts.formId }), '保存布局');
+    // 回读：新字段必须在、原有组件一个不能少
+    const after = await read();
+    const afterComps = (after?.formLayout?.pageLayouts?.[0]?.comps) || [];
+    const afterKeys = new Set(afterComps.map((c) => String(c?.config?.fieldId ?? c?.config?.valueKey ?? '')).filter(Boolean));
+    const missing = added.filter((x) => !afterKeys.has(x.key)).map((x) => `${x.title}(${x.key})`);
+    if (missing.length)
+        throw new Error(`保存后回读缺少系统字段：${missing.join('、')}`);
+    const afterIds = new Set(afterComps.map((c) => String(c?.id ?? '')).filter(Boolean));
+    const lost = [...beforeIds].filter((id) => !afterIds.has(id));
+    if (lost.length) {
+        throw new Error(`保存后原有组件少了 ${lost.length} 个（${lost.slice(0, 3).join('、')}${lost.length > 3 ? '…' : ''}）—— 请到设计器核对`);
+    }
+    return { layoutId: target.id, layoutName: target.name, terminalType: target.terminalType, added, skipped };
+}
 /** 读某套布局的内容（不传 layoutId 读默认布局）。 */
 export async function getLayoutContent(client, formId, layoutId, workflowId, formKind) {
     const base = client.getBaseUrl();