weaver-e10-builder 1.5.10 → 1.5.12

package/dist/commands/form-field-linkage.js

@@ -3,6 +3,13 @@ import { resolveFormRecord } from '../services/form-id.js';
 import { AuthSession } from '../core/auth.js';
 import { ApiClient } from '../core/client.js';
 import { genSfId, normalizeNumericFrontId } from '../services/actionflow/id_generator.js';
+// 查询条件的算子与字段类型族：与动作流 EnquiryForm 共用同一套（filter_rules.ts）。
+import { conditionFieldFamily, normalizeFilterOperator } from '../services/actionflow/filter_rules.js';
+// 生效维度/触发时机与函数联动共用同一套解析，避免两处各写一份。
+import { buildFdEffect, buildLinkageExt, extractEffect, isWorkflowDimension, buildTriggerSpecs, buildMonitorActions, mergeMonitorActions, specsFromStoredTriggers, storedTriggers, } from '../services/form-formula-linkage.js';
+import { fetchDrivingEvents, fetchDrivingColumns, resolveEbEffect, isWorkflowEffectInput, } from './form-formula-linkage.js';
+// 赋值前提走 ESB 条件服务（source=8），与动作流 Condition 节点同一套两步保存。
+import { buildConditionDisplayTree, stripTemporaryConditionIds } from '../services/actionflow/save_workflow_draft.js';
 /**
  * form field-linkage — 字段联动（FormDataLinkage，跨表带出赋值）。
  *
@@ -19,15 +26,136 @@ const ESB_APP_API = '/api/bs/esb/setting/application';
 const ESB_DESIGN_API = '/api/bs/esb/setting/flow/design';
 const FIELD_LINKAGE_API = '/api/bs/esb/setting/fieldlinkage';
 const FIELD_LINKAGE_LIGHT_ID = '941997121054621697';
+/** commander 可重复选项的收集器：`--assign a=b --assign c=d` → ['a=b','c=d'] */
+function collect(value, previous) {
+    return [...(previous || []), value];
+}
+/** 生效维度解析失败直接退出（与函数联动同一套 `resolveEbEffect`）。 */
+async function resolveEffectOrExit(client, baseUrl, formId, formName, o) {
+    try {
+        return await resolveEbEffect(client, baseUrl, formId, formName, o);
+    }
+    catch (error) {
+        console.error(`  ❌ ${error?.message || error}`);
+        process.exit(1);
+    }
+}
+/** 「主表联动明细表时」→ `linkageExt.subFormLikeType`。 */
+function resolveSubFormLikeType(input) {
+    if (!input)
+        return 'addSubForm';
+    const map = {
+        add: 'addSubForm', '添加明细': 'addSubForm', addSubForm: 'addSubForm',
+        cover: 'updSubForm', '覆盖明细': 'updSubForm', updSubForm: 'updSubForm',
+        update: 'rowUpdate', '更新明细': 'rowUpdate', rowUpdate: 'rowUpdate',
+    };
+    const hit = map[String(input).trim()] || map[String(input).trim().toLowerCase()];
+    if (!hit) {
+        console.error('--detail-mode 只接受 add（添加明细）/ cover（覆盖明细）/ update（更新明细）');
+        process.exit(1);
+    }
+    return hit;
+}
+/** 「明细表添加行时」→ `linkageExt.subFormAddType`。 */
+function resolveSubFormAddType(input) {
+    if (!input)
+        return 'override';
+    const map = {
+        override: 'override', '删除再添加': 'override', '删除已联动出的明细再添加': 'override',
+        append: 'append', '累计添加': 'append', '累计添加明细': 'append',
+    };
+    const hit = map[String(input).trim()] || map[String(input).trim().toLowerCase()];
+    if (!hit) {
+        console.error('--detail-add 只接受 override（删除再添加）/ append（累计添加）');
+        process.exit(1);
+    }
+    return hit;
+}
+/** 「联动出的值继续触发联动」→ `linkageExt.fissionState`。 */
+function parseFissionOrExit(input, fallback = 1) {
+    if (!input)
+        return fallback;
+    const v = String(input).toLowerCase();
+    if (v === 'on' || v === '1')
+        return 1;
+    if (v === 'off' || v === '0')
+        return 0;
+    console.error('--fission 只接受 on / off');
+    process.exit(1);
+}
+function parseStateOrExit(input, fallback = true) {
+    if (!input)
+        return fallback;
+    const v = String(input).toLowerCase();
+    if (v !== 'on' && v !== 'off') {
+        console.error('--state 只接受 on / off');
+        process.exit(1);
+    }
+    return v === 'on';
+}
+/** 触发动作：与函数联动同一套事件清单 + 字段解析（一个时机 × 一个字段 = 一条 action）。 */
+async function resolveTriggerActionsOrExit(p) {
+    try {
+        const [events, columns] = await Promise.all([
+            fetchDrivingEvents(p.client, p.baseUrl, p.appId, p.formId, p.objId, { workflowWide: isWorkflowDimension(p.effect?.effectType) }),
+            fetchDrivingColumns(p.client, p.baseUrl, p.appId, p.formId, p.objId),
+        ]);
+        const built = buildTriggerSpecs(events, columns, p.event, p.trigger ? [p.trigger] : []);
+        for (const w of built.warnings)
+            console.error(`  ⚠ ${w}`);
+        return buildMonitorActions(built.specs);
+    }
+    catch (error) {
+        console.error(`  ❌ ${error?.message || error}`);
+        process.exit(1);
+    }
+}
+/** 改联动的报文：形状 = 新建报文 + `id`，`dataSources` 原样回传读回的那份。 */
+export function buildFieldLinkageUpdatePayload(record, p) {
+    const ext = record?.linkageExt || {};
+    const extOverrides = {};
+    for (const key of ['subFormLikeType', 'subFormAddType', 'effectContent', 'fissionState']) {
+        if (ext[key] !== undefined && ext[key] !== null)
+            extOverrides[key] = ext[key];
+    }
+    for (const key of ['subFormLikeType', 'subFormAddType', 'fissionState']) {
+        const v = p.detailExt?.[key];
+        if (v !== undefined && v !== null)
+            extOverrides[key] = v;
+    }
+    return {
+        id: String(record?.id ?? ''),
+        formId: String(record?.formId ?? ''),
+        fdEffect: buildFdEffect(String(record?.formId ?? ''), p.effect),
+        linkageModule: 'ebuilderform',
+        linkageName: p.linkageName,
+        linkageState: p.linkageState,
+        linkageType: 'template',
+        linkageExt: buildLinkageExt({ subFormLikeType: 'addSubForm', subFormAddType: 'override', effectContent: '', fissionState: 1, ...extOverrides }),
+        monitorActions: p.monitorActions,
+        dataSources: record?.dataSources || [],
+        needSqlCompress: 1,
+        customParam: { appId: p.appId, objId: p.objId },
+    };
+}
 async function getFormId(client, baseUrl, appId, objId) {
     const f = await resolveFormRecord(client, baseUrl, appId, objId);
     if (!f?.formId)
         throw new Error(`无法获取 formId，请确认 objId=${objId}`);
     return { formId: String(f.formId), formName: f.formName || f.objName || f.name || '' };
 }
-async function getFormFields(client, baseUrl, objId, userId, tenantKey) {
+/** 主表字段 + 明细表（字段联动可以把值写到明细表，需要 subFormId）。 */
+async function getFormMeta(client, baseUrl, objId, userId, tenantKey) {
     const res = await client.post(`${baseUrl}/api/ebuilder/form/dataset/v1/getFields`, { objId, userid: userId, tenantKey, isReturnDetail: 'y' });
-    return res?.data?.mainFields || [];
+    const details = (res?.data?.detailFields || []).map((d) => ({
+        id: String(d.fields?.[0]?.subFormId || d.id || ''),
+        name: String(d.fields?.[0]?.subFormName || d.name || ''),
+        fields: d.fields || [],
+    })).filter((d) => /^\d+$/.test(d.id));
+    return { main: res?.data?.mainFields || [], details };
+}
+async function getFormFields(client, baseUrl, objId, userId, tenantKey) {
+    return (await getFormMeta(client, baseUrl, objId, userId, tenantKey)).main;
 }
 function findFieldId(fields, name) {
     const f = fields.find((x) => x.fieldName === name && /^\d+$/.test(String(x.fieldId)));
@@ -158,14 +286,200 @@ export function registerFormFieldLinkageCommands(form, program) {
         for (const f of fields)
             console.log(`  ${f.id || f.fieldId}  ${f.showName || f.fieldName}  (${f.componentKey || f.fieldKey})`);
     });
-    // ─── add（支持单跳和多跳链式）───
-    fl.command('add').description('新增字段联动。--hops 多跳链式（objId:字段名,objId:字段名,...），或 --source-form/--query-field 单跳')
+    fl.command('events').description('列出可用的触发动作').argument('<appId>').argument('<objId>')
+        .option('--effect <dimension>', '按哪个生效维度列：form=当前表单 / formLayout=表单布局 / workFlow=当前工作流 / includeNode=选择节点')
+        .option('--workflow-id <id>', '流程 ID（与 add 写法保持一致，不影响清单）')
+        .action(async (appId, objId, cmdOpts) => {
+        const opts = program.opts();
+        const auth = await AuthSession.fromOptions(opts);
+        if (!auth)
+            process.exit(1);
+        const client = new ApiClient(auth);
+        const baseUrl = auth.getBaseUrl();
+        const { formId } = await getFormId(client, baseUrl, appId, objId);
+        const workflowWide = isWorkflowEffectInput(cmdOpts.effect);
+        const events = await fetchDrivingEvents(client, baseUrl, appId, formId, objId, { workflowWide });
+        if (opts.json) {
+            console.log(JSON.stringify(events, null, 2));
+            return;
+        }
+        console.log(`共 ${events.length} 个触发动作${workflowWide ? '（含流程级，需配合 --effect workFlow/includeNode 使用）' : ''}:`);
+        for (const e of events) {
+            console.log(`  ${e.groupName ? `${e.groupName} / ` : ''}${e.name}  ${e.type}  ${e.selectColumn ? '（需触发字段）' : '（表单级/流程级，无需触发字段）'}`);
+        }
+        if (!workflowWide)
+            console.log('  （流程级事件加 --effect workFlow --workflow-id <流程id> 才列得出来）');
+    });
+    fl.command('update').description('改字段联动的名称/启停/触发动作/生效维度（不给 --event/--trigger 就原样沿用现有的触发动作）')
+        .argument('<appId>').argument('<objId>').argument('<linkageId>')
+        .option('--name <name>', '改联动名称')
+        .option('--state <onoff>', '启用或停用: on / off')
+        .option('--event <event...>', '改触发动作，可多个（写法同 add：事件名或 type，可带「类型:字段,字段」）。不给则沿用现有')
+        .option('--trigger <fields...>', '改触发字段（作用于记录里的字段级触发动作）。不给则沿用现有')
+        .option('--effect <dimension>', '改生效维度（默认沿用现有）')
+        .option('--detail-mode <mode>', '主表联动明细表时: add=添加明细 / cover=覆盖明细 / update=更新明细（不给沿用现有）')
+        .option('--detail-add <mode>', '明细表添加行时: override=删除再添加 / append=累计添加（不给沿用现有）')
+        .option('--fission <onoff>', '联动出的值继续触发联动: on / off（不给沿用现有）')
+        .option('--precondition <expr>', '设置/替换赋值前提（可重复，多个为「且」）：源表字段:算子[:值]；值写 @字段名 表示引用查询结果字段', collect, [])
+        .option('--clear-precondition', '关闭赋值前提')
+        .option('--workflow-id <id>', '流程 ID（workFlow / includeNode 必给；不给沿用记录里的）')
+        .option('--node <node>', 'includeNode 的节点（id 或节点名）')
+        .option('--layout-id <id>', 'formLayout 指定的布局 id')
+        .action(async (appId, objId, linkageId, cmdOpts) => {
+        const opts = program.opts();
+        const auth = await AuthSession.fromOptions(opts);
+        if (!auth)
+            process.exit(1);
+        const client = new ApiClient(auth);
+        const baseUrl = auth.getBaseUrl();
+        const { formId, formName } = await getFormId(client, baseUrl, appId, objId);
+        const rb = await client.post(`${baseUrl}${LINKAGE_API}/queryById?apid=${appId}`, { id: linkageId, formId, module: 'ebuilderform', customParam: { appId, objId } }, { ebbusinessid: formId });
+        if (rb?.code !== 200 || !rb?.status) {
+            console.error(`查询失败: ${rb?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const record = rb?.data;
+        if (String(record?.linkageType) !== 'template') {
+            console.error(`这条的 linkageType 是 ${record?.linkageType}，不是字段联动（跨表带出）—— 用 form formula-linkage 那套命令改`);
+            process.exit(1);
+        }
+        // 只改启停时走专用接口（设计器里点开关就是这一个请求），不重发整套联动报文
+        const onlyState = cmdOpts.state !== undefined
+            && !cmdOpts.name && !cmdOpts.event?.length && !cmdOpts.trigger?.length
+            && !cmdOpts.effect && cmdOpts.detailMode === undefined
+            && cmdOpts.detailAdd === undefined && cmdOpts.fission === undefined;
+        if (onlyState) {
+            const target = parseStateOrExit(cmdOpts.state);
+            const stateRes = await client.post(`${baseUrl}${LINKAGE_API}/updateFormDataLinkageState?apid=${appId}`, {
+                id: linkageId, formId, linkageModule: 'ebuilderform', linkageType: 'template',
+                linkageState: target, customParam: { appId, objId },
+            }, { ebbusinessid: formId });
+            if (stateRes?.code !== 200 || !stateRes?.status) {
+                console.error(`更新启用状态失败: ${stateRes?.msg || '未知错误'}`);
+                process.exit(1);
+            }
+            const rbState = await client.post(`${baseUrl}${LINKAGE_API}/queryById?apid=${appId}`, { id: linkageId, formId, module: 'ebuilderform', customParam: { appId, objId } }, { ebbusinessid: formId });
+            const afterState = rbState?.data || {};
+            const state = afterState.linkageState !== false;
+            if (state !== target) {
+                console.error(`  ⚠ 回读的启用状态与提交的不一致，以平台为准（提交 ${target}，回读 ${state}）`);
+            }
+            console.log(opts.json
+                ? JSON.stringify({ success: true, linkageId, state })
+                : `已${state ? '启用' : '停用'}字段联动: [${linkageId}] ${afterState.linkageName || ''}`);
+            return;
+        }
+        let effect;
+        let specs = null;
+        try {
+            const curEffect = extractEffect(record);
+            const workflowId = cmdOpts.workflowId
+                || (isWorkflowDimension(curEffect?.effectType) ? String(curEffect?.effectValue || '') : '')
+                || String(record?.refId || '');
+            effect = cmdOpts.effect
+                ? await resolveEbEffect(client, baseUrl, formId, formName, { effect: cmdOpts.effect, workflowId, node: cmdOpts.node, layoutId: cmdOpts.layoutId })
+                : curEffect;
+            // 换维度时可用事件整个换了一套；不给 --event 会存出「事件与维度不匹配」的坏规则
+            if (isWorkflowDimension(curEffect?.effectType) !== isWorkflowDimension(effect?.effectType) && !cmdOpts.event?.length) {
+                throw new Error('生效维度在「当前表单/表单布局」与「当前工作流/选择节点」之间切换时，必须同时用 --event 指定新维度下可用的触发动作');
+            }
+            const wantEvents = !!cmdOpts.event?.length;
+            const wantTrigger = !!cmdOpts.trigger?.length;
+            if (wantEvents || wantTrigger) {
+                const [events, columns] = await Promise.all([
+                    fetchDrivingEvents(client, baseUrl, appId, formId, objId, { workflowWide: isWorkflowDimension(effect?.effectType) }),
+                    fetchDrivingColumns(client, baseUrl, appId, formId, objId),
+                ]);
+                if (wantEvents) {
+                    const built = buildTriggerSpecs(events, columns, cmdOpts.event, cmdOpts.trigger || []);
+                    specs = built.specs;
+                    for (const w of built.warnings)
+                        console.error(`  ⚠ ${w}`);
+                }
+                else {
+                    const built = specsFromStoredTriggers(storedTriggers(record), events, columns, cmdOpts.trigger || []);
+                    specs = built.specs;
+                    if (!built.overrideApplied)
+                        console.error('  ⚠ 记录里没有字段级触发动作，--trigger 已忽略');
+                }
+            }
+        }
+        catch (error) {
+            console.error(`  ❌ ${error?.message || error}`);
+            process.exit(1);
+        }
+        // 两个都没给就原样透传读回的 monitorActions，避免只改名称时把其余触发动作抹掉
+        const monitorActions = specs ? mergeMonitorActions(record?.monitorActions || [], specs) : (record?.monitorActions || []);
+        const linkageState = parseStateOrExit(cmdOpts.state, record?.linkageState !== false);
+        // 三个明细开关：不给就沿用读回值（buildFieldLinkageUpdatePayload 内部判断）
+        const detailExt = {
+            subFormLikeType: cmdOpts.detailMode !== undefined ? resolveSubFormLikeType(cmdOpts.detailMode) : undefined,
+            subFormAddType: cmdOpts.detailAdd !== undefined ? resolveSubFormAddType(cmdOpts.detailAdd) : undefined,
+            fissionState: cmdOpts.fission !== undefined ? parseFissionOrExit(cmdOpts.fission) : undefined,
+        };
+        const res = await client.post(`${baseUrl}${LINKAGE_API}/updateFormDataLinkage?apid=${appId}`, buildFieldLinkageUpdatePayload(record, {
+            appId, objId,
+            linkageName: cmdOpts.name || String(record?.linkageName || ''),
+            linkageState,
+            monitorActions,
+            effect,
+            detailExt,
+        }), { ebbusinessid: formId });
+        if (res?.code !== 200 || !res?.status) {
+            console.error(`更新失败: ${res?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        if (cmdOpts.precondition.length > 0 && cmdOpts.clearPrecondition) {
+            console.error('--precondition 与 --clear-precondition 只能二选一');
+            process.exit(1);
+        }
+        if (cmdOpts.precondition.length > 0 || cmdOpts.clearPrecondition) {
+            await updatePreconditionOrExit({
+                client, baseUrl, auth, record, objId,
+                precondition: cmdOpts.precondition,
+                disable: !!cmdOpts.clearPrecondition,
+            });
+        }
+        await client.post(`${baseUrl}${LINKAGE_API}/preCheck?apid=${appId}`, { module: 'ebuilderform', formId, linkageIds: [linkageId], customParam: { appId, objId } }, { ebbusinessid: formId });
+        const rb2 = await client.post(`${baseUrl}${LINKAGE_API}/queryById?apid=${appId}`, { id: linkageId, formId, module: 'ebuilderform', customParam: { appId, objId } }, { ebbusinessid: formId });
+        const after = rb2?.data || {};
+        const want = monitorActions.map((a) => String(a?.actionType || '')).filter(Boolean).join(',');
+        const got = storedTriggers(after).map(t => t.eventType).join(',');
+        if (want !== got) {
+            console.error(`  ⚠ 回读的触发动作与提交的不一致，以平台为准\n      提交: ${want || '（空）'}\n      回读: ${got || '（空）'}`);
+        }
+        const summary = {
+            success: true, linkageId,
+            name: after.linkageName,
+            state: after.linkageState !== false,
+            triggers: storedTriggers(after).map(t => ({ type: t.eventType, name: t.eventName, fields: t.fieldNames })),
+        };
+        console.log(opts.json
+            ? JSON.stringify(summary)
+            : `已更新字段联动: [${linkageId}] ${summary.name}（${summary.state ? '启用' : '停用'}）`);
+    });
+    // ─── add（快捷配置 / 单跳 / 多跳链式）───
+    fl.command('add').description('新增字段联动。快捷配置用 --condition/--query-fields/--assign；多跳链式用 --hops')
         .argument('<appId>').argument('<objId>')
-        .requiredOption('--trigger <字段名>', '本表触发字段名')
-        .requiredOption('--target <字段名>', '本表目标字段名（被赋值）')
+        .option('--trigger <字段名>', '本表触发字段名（默认触发事件「值改变时」的字段；旧单跳/多跳必给）')
+        .option('--event <event...>', '触发动作，可多个：事件名或 type，可带「类型:字段,字段」（默认 changeField 值改变时）', ['changeField'])
+        .option('--state <onoff>', '启用状态 on / off（默认 on）')
+        .option('--effect <dimension>', '生效维度: form=当前表单（默认）/ formLayout=表单布局 / workFlow=当前工作流 / includeNode=选择节点')
+        .option('--workflow-id <id>', '流程 ID（workFlow / includeNode 必给）')
+        .option('--node <node>', 'includeNode 的节点（id 或节点名）')
+        .option('--layout-id <id>', 'formLayout 指定的布局 id')
+        .option('--target <字段名>', '本表目标字段名（与 --query-field / --hops 配合）')
         .option('--hops <list>', '多跳链式：objId:字段名,objId:字段名,...（每跳查一张表带出一个字段，前一跳的输出喂下一跳的过滤）')
-        .option('--source-form <objId>', '单跳：查询目标表单 objId（与 --query-field 配合）')
+        .option('--source-form <objId>', '查询目标表单 objId')
         .option('--query-field <字段名>', '单跳：目标表要带出的字段名')
+        .option('--condition <expr>', '查询条件：源表字段:算子:值；值写 @本表字段名 表示引用本表字段', collect, [])
+        .option('--query-fields <list>', '查询字段：源表字段名，逗号分隔（不给则从 --assign 的源字段推导）')
+        .option('--assign <expr>', '赋值：源表查询字段=本表目标字段（写「明细表名.字段名」则赋到明细表；可重复）', collect, [])
+        .option('--basis <expr>', '明细行依据：明细表名=源表字段名（可重复；不给则取该表第一个赋值的源字段）', collect, [])
+        .option('--detail-mode <mode>', '主表联动明细表时: add=添加明细（默认）/ cover=覆盖明细 / update=更新明细')
+        .option('--detail-add <mode>', '明细表添加行时: override=删除已联动出的明细再添加（默认）/ append=累计添加明细')
+        .option('--fission <onoff>', '联动出的值继续触发联动: on（默认）/ off')
+        .option('--precondition <expr>', '赋值前提（可重复，多个为「且」）：源表字段:算子[:值]；值写 @字段名 表示引用查询结果字段', collect, [])
         .option('--name <联动名>', '联动名称', '')
         .action(async (appId, objId, cmdOpts) => {
         const opts = program.opts();
@@ -175,7 +489,33 @@ export function registerFormFieldLinkageCommands(form, program) {
         const client = new ApiClient(auth);
         const baseUrl = auth.getBaseUrl();
         const { formId: selfFormId, formName: selfFormName } = await getFormId(client, baseUrl, appId, objId);
-        const selfFields = await getFormFields(client, baseUrl, objId, auth.userId, auth.tenantKey);
+        const { main: selfFields, details: selfDetails } = await getFormMeta(client, baseUrl, objId, auth.userId, auth.tenantKey);
+        const effect = await resolveEffectOrExit(client, baseUrl, selfFormId, selfFormName, cmdOpts);
+        const linkageState = parseStateOrExit(cmdOpts.state);
+        const detailExt = {
+            subFormLikeType: resolveSubFormLikeType(cmdOpts.detailMode),
+            subFormAddType: resolveSubFormAddType(cmdOpts.detailAdd),
+            fissionState: parseFissionOrExit(cmdOpts.fission),
+        };
+        const monitorActions = await resolveTriggerActionsOrExit({
+            client, baseUrl, appId, formId: selfFormId, objId,
+            event: cmdOpts.event, trigger: cmdOpts.trigger, effect,
+        });
+        if (cmdOpts.assign.length > 0) {
+            await addQuickLinkage({
+                client, baseUrl, appId, objId, selfFormId, selfFormName, selfFields, selfDetails,
+                trigger: cmdOpts.trigger, monitorActions, effect, linkageState, detailExt, auth, opts, cmdOpts,
+            });
+            return;
+        }
+        if (!cmdOpts.trigger) {
+            console.error('旧单跳/多跳用法需要 --trigger');
+            process.exit(1);
+        }
+        if (!cmdOpts.target) {
+            console.error('需要 --target，或改用快捷配置的 --assign');
+            process.exit(1);
+        }
         const triggerField = findFieldId(selfFields, cmdOpts.trigger);
         const targetField = findFieldId(selfFields, cmdOpts.target);
         // 解析 hops（多跳）或单跳
@@ -231,10 +571,10 @@ export function registerFormFieldLinkageCommands(form, program) {
         // 3. saveFormDataLinkage
         const linkagePayload = {
             formId: selfFormId,
-            fdEffect: { formId: selfFormId, effectModule: 'ebuilderform', effectType: 'form', effectName: '当前表单', optionList: [{ effectValue: selfFormId, effectName: '当前表单' }] },
-            linkageModule: 'ebuilderform', linkageName, linkageState: true, linkageType: 'template',
-            linkageExt: { subFormLikeType: 'addSubForm', subFormAddType: 'override', effectContent: '', fissionState: 1 },
-            monitorActions: [{ actionType: 'changeField', actionName: '值改变时', monitorFields: [{ targetField: triggerField.fieldId, targetName: `主表.${cmdOpts.trigger}`, fieldObj: { dataKey: triggerField.fieldKey || '', groupName: '表单字段', address: '主表', addressType: 'form', groupId: 'formField', name: `主表.${cmdOpts.trigger}`, descType: triggerField.fieldKey || '', id: triggerField.fieldId, content: `主表.${cmdOpts.trigger}`, desc: '' } }] }],
+            fdEffect: buildFdEffect(selfFormId, effect),
+            linkageModule: 'ebuilderform', linkageName, linkageState, linkageType: 'template',
+            linkageExt: buildLinkageExt({ ...detailExt, effectContent: '' }),
+            monitorActions,
             dataSources: [{ menuKey: '1', sourceName: '联动设置1', linkageType: 'esb', dataMappings: [], sourceEsb: { configType: 'SIMPLE', parameters: [{ targetField: triggerField.fieldId, targetName: cmdOpts.trigger }] }, dataSourceId: esbAppId, dataSourceName: `${linkageName}-联动设置1` }],
             needSqlCompress: 1, customParam: { appId, objId },
         };
@@ -319,4 +659,678 @@ function buildSaveDesign(p) {
         addIds: [], deleteActions: [], version: 0, delCheckMsg: [], addCheckMsg: [], assistLayer: '{"nodes":[],"layout":{}}', versionConfig: '{}', saveNewVersion: false, lightId: p.lightId, initData: '', secretKey: '', operateType: '', appName: p.appName,
     };
 }
+/**
+ * 快捷配置：源表任意字段条件 + 多查询字段 + 多赋值参数。
+ *
+ * 与旧 add（数据ID = 触发字段值）的区别只在 `filterInput`：
+ * 旧模型固定查系统字段「数据ID」，新模型查 `--condition` 指定的源表字段。
+ * 条件值可以写 `@本表字段名`，此时走 `isEsb:true` + `esbAssign` 动态引用（与旧模型同一形状）。
+ */
+/** ESB 条件服务的算子码（与动作流 condition_rules 同一套）。 */
+const CONDITION_OPT_CODE = {
+    eq: 5, neq: 6, gt: 1, gte: 2, lt: 3, lte: 4,
+    contains: 9, uncontains: 10, aggregate: 11, unaggregate: 12, empty: 13, nempty: 14,
+};
+/**
+ * 赋值前提：先调 ESB 条件服务（source=8）持久化条件，再返回 Output 节点要的
+ * `conditionEnable` / `conditionInfo`。
+ *
+ * 注意它**不在**联动记录（`linkageExt`）里 —— 开关赋值前提等价于重新 `saveDesign`。
+ */
+/** 查询结果字段的上下文公式（条件左右两侧共用）。 */
+function buildContextFormula(field, srcFormObjId, srcFormName, eqWId) {
+    const fid = String(field.fieldId);
+    const paramKey = `${srcFormObjId}[].field_${fid}`;
+    const valuePath = `FormData.${srcFormObjId}[].field_${fid}`;
+    const parentName = `${srcFormName}[].${field.fieldName}`;
+    return {
+        paramType: 'string', formulaType: 'string', name: String(field.fieldName),
+        businessId: genSfId(), selectType: '-1', id: genSfId(), source: eqWId, type: '3',
+        value: valuePath,
+        config: {
+            paramKey, isMultCom: false, comType: 'EnquiryForm', parentComId: '0',
+            fieldInfo: { paramKey, tablePrimaryKey: 'FormData' },
+            tableName: '表单数据', paramType: 'string', parentName, newParentName: parentName,
+            multName: '', multKey: '',
+            multTypeObj: { currentName: parentName, allName: parentName, currentParamKey: valuePath, allParamKey: valuePath },
+            comId: eqWId,
+        },
+        fieldType: 'browser',
+    };
+}
+/** 解析赋值前提：`源表字段:算子[:值]`；值写 `@字段名` 引用查询结果字段或本表字段。 */
+function parsePreconditionListOrExit(inputs, srcFields, selfFields) {
+    return inputs.map(expr => {
+        const c = parseConditionExpr(expr, srcFields);
+        if (c.range) {
+            console.error('赋值前提暂不支持区间条件');
+            process.exit(1);
+        }
+        let refField;
+        let refSelf = false;
+        if (c.literal && c.literal.startsWith('@')) {
+            const name = c.literal.slice(1);
+            refField = srcFields.find((f) => f.fieldName === name);
+            if (!refField) {
+                refField = selfFields.find((f) => f.fieldName === name);
+                refSelf = true;
+            }
+            if (!refField) {
+                console.error(`赋值前提引用字段 "${name}" 既不在查询结果也不在本表字段里`);
+                process.exit(1);
+            }
+        }
+        return { field: c.field, func: c.func, literal: refField ? undefined : c.literal, refField, refSelf };
+    });
+}
+/** 本表字段的上下文化公式（赋值前提右值）：source 指向 FieldLinkage 事件，而不是查询节点。 */
+function buildSelfContextFormula(field, selfFormId, selfFormName, eventId, esbAppId) {
+    const fid = String(field.fieldId);
+    const paramKey = `${selfFormId}.${fid}`;
+    const valuePath = `FormData.${selfFormId}.${fid}`;
+    const parentName = `${selfFormName}.${field.fieldName}`;
+    return {
+        paramKey, paramName: fid, showName: String(field.fieldName),
+        paramType: 'string', dataType: 'node', arrs: false, required: false, description: fid,
+        paramTypeString: 'STRING', dataTypeSting: 'NODE', paramId: fid,
+        hideParamNameInSelect: false, hideParam: false, readonlyParam: false, sensitiveFlag: false, newdata: false,
+        parentName, name: String(field.fieldName),
+        source: eventId, value: valuePath, type: '3', formulaType: 'string', frontId: fid,
+        config: {
+            paramKey, paramType: 'string', parentName, newParentName: parentName,
+            multKey: '', multName: '',
+            multTypeObj: { currentName: parentName, allName: parentName, currentParamKey: valuePath, allParamKey: valuePath },
+            comId: eventId, isMultCom: false, tableName: '表单数据',
+            fieldInfo: { paramKey, tablePrimaryKey: 'FormData' },
+            comType: 'FieldLinkage', parentComId: '0',
+        },
+        id: genSfId(), applicationId: esbAppId, businessId: genSfId(),
+        selectType: '-1', needType: 'browser',
+    };
+}
+async function savePreconditionOrExit(p) {
+    const leaves = p.conds.map(c => {
+        const code = CONDITION_OPT_CODE[c.func];
+        if (code === undefined) {
+            console.error(`赋值前提不支持的算子 "${c.func}"`);
+            process.exit(1);
+        }
+        const leaf = {
+            expressionBaseId: genSfId(), dataValueId: genSfId(), elementValue2Id: genSfId(), elementValue1Id: genSfId(),
+            selectType: 97, BrowserCompareOptionLeft: code,
+            customFieldType: buildContextFormula(c.field, p.srcFormObjId, p.srcFormName, p.eqWId),
+        };
+        // 包含 / 不包含 额外带「任一值/全部」标记
+        if (code === 9 || code === 10)
+            leaf.containType = 1;
+        if (c.refField) {
+            leaf.BrowserTextValueLeft = c.refSelf
+                ? buildSelfContextFormula(c.refField, p.selfFormId, p.selfFormName, p.eventId, p.esbAppId)
+                : buildContextFormula(c.refField, p.srcFormObjId, p.srcFormName, p.eqWId);
+        }
+        else if (c.literal !== undefined && c.literal !== '') {
+            leaf.BrowserTextValueLeft = {
+                formulaType: 'string', name: String(c.literal), businessId: genSfId(),
+                selectType: '-1', id: genSfId(), type: '1', value: String(c.literal), fieldType: 'browser',
+            };
+        }
+        return leaf;
+    });
+    const tree = {
+        sourceId: '-1', source: 8, relation: 1,
+        expressionId: genSfId(), mapBaseId: genSfId(), conditionId: genSfId(), mapId: genSfId(),
+        // 根 AND 下直接放叶子；外面再套分组会让每个条件多一层括号
+        childrens: leaves,
+    };
+    try {
+        const mb = await p.client.get(`${p.baseUrl}/api/bs/esb/setting/condition/getConditionSet`);
+        const mapBaseId = typeof mb?.data === 'string'
+            ? mb.data
+            : String(mb?.data?.mapBaseId || mb?.data?.conditionKey || '');
+        if (!mapBaseId)
+            throw new Error('getConditionSet 未返回 mapBaseId');
+        tree.mapBaseId = mapBaseId;
+        stripTemporaryConditionIds(tree);
+        const resp = await p.client.post(`${p.baseUrl}/api/bs/esb/setting/condition/saveCondition`, tree);
+        const data = resp?.data || {};
+        if (resp?.code !== 200 || resp?.status === false || data?.result !== true || data?.haveData !== true
+            || !data.conditionKey || !data.conditionId || !data.mapId) {
+            throw new Error(`saveCondition 返回异常: ${resp?.msg || ''} code=${resp?.code}`);
+        }
+        const persisted = await p.client.get(`${p.baseUrl}/api/bs/esb/setting/condition/getExpressionBean?conditionId=${data.conditionId}`);
+        const storedTree = buildConditionDisplayTree(persisted?.data || {});
+        storedTree.sourceId = '-1';
+        storedTree.mapBaseId = String(data.conditionKey);
+        storedTree.conditionId = String(data.conditionId);
+        storedTree.mapId = String(data.mapId);
+        storedTree.source = 8;
+        storedTree.relation = Number(storedTree.relation) === 2 ? 2 : 1;
+        return {
+            conditionId: String(data.conditionId),
+            conditionDetail: {
+                conditionId: String(data.conditionId),
+                conditionCn: String(data.conditionCn || ''),
+                mapBaseId: String(data.conditionKey),
+                mapId: String(data.mapId),
+                sourceIds: Array.isArray(data.sourceIds) ? data.sourceIds.map(String) : [p.eqWId],
+                conditionDataJson: JSON.stringify({
+                    code: 200, msg: resp?.msg || '接口返回成功', status: resp?.status !== false, fail: false, data: storedTree,
+                }),
+            },
+        };
+    }
+    catch (error) {
+        console.error(`  ❌ 保存赋值前提失败: ${error?.message || error}`);
+        process.exit(1);
+    }
+}
+/**
+ * 改赋值前提：它只存在于 ESB 设计的 Output 节点，所以要读回设计 → 改 Output → 重新 saveDesign。
+ * `disable` 时清掉三个条件键；否则先保存新条件再回填。
+ */
+async function updatePreconditionOrExit(p) {
+    const esbAppId = String(p.record?.dataSources?.[0]?.dataSourceId || '');
+    if (!esbAppId) {
+        console.error('这条联动没有关联的 ESB 应用，无法配置赋值前提');
+        process.exit(1);
+    }
+    const ver = await p.client.get(`${p.baseUrl}/api/bs/esb/setting/application/version/versionList/${esbAppId}`);
+    const list = Array.isArray(ver?.data) ? ver.data : [];
+    const sceneId = String(ver?.data?.activeVersion
+        || list.find((v) => v.active || v.status === 1 || v.isActive)?.id
+        || list[0]?.id || '');
+    if (!sceneId) {
+        console.error(`取不到 ESB 设计版本（appId=${esbAppId}）`);
+        process.exit(1);
+    }
+    const dr = await p.client.get(`${p.baseUrl}/api/bs/esb/setting/flow/design/getDesignBySceneId/${sceneId}`);
+    if (dr?.code !== 200 || !dr?.data) {
+        console.error(`读取 ESB 设计失败: ${dr?.msg || '未知错误'}`);
+        process.exit(1);
+    }
+    const design = dr.data;
+    const output = (design.actions || []).find((a) => a.type === 'Output');
+    if (!output) {
+        console.error('ESB 设计里没有赋值节点');
+        process.exit(1);
+    }
+    if (p.disable) {
+        output.data.conditionEnable = false;
+        delete output.data.conditionId;
+        delete output.data.conditionDetail;
+        delete output.data.conditionInfo;
+    }
+    else {
+        const enquiry = (design.actions || []).find((a) => a.type === 'EnquiryForm');
+        const srcObjId = String(enquiry?.data?.dataSource?.id || '');
+        const srcFormName = String(enquiry?.data?.dataSource?.text || '');
+        if (!srcObjId || !enquiry?.wId) {
+            console.error('ESB 设计里找不到查询节点，无法定位前提字段');
+            process.exit(1);
+        }
+        const srcFields = await getFormFields(p.client, p.baseUrl, srcObjId, p.auth.userId, p.auth.tenantKey);
+        const selfFields = await getFormFields(p.client, p.baseUrl, p.objId, p.auth.userId, p.auth.tenantKey);
+        const conds = parsePreconditionListOrExit(p.precondition || [], srcFields, selfFields);
+        const info = await savePreconditionOrExit({
+            client: p.client, baseUrl: p.baseUrl, conds,
+            srcFormObjId: srcObjId, srcFormName, eqWId: String(enquiry.wId),
+            selfFormId: String(design.event?.data?.ownForm?.[0]?.id || p.record?.formId || ''),
+            selfFormName: String(design.event?.data?.ownForm?.[0]?.name || ''),
+            eventId: String(design.event?.wId || design.event?.id || ''),
+            esbAppId,
+        });
+        output.data.conditionEnable = true;
+        output.data.conditionInfo = info;
+        output.data.conditionId = info.conditionId;
+        output.data.conditionDetail = info.conditionDetail;
+        console.error(`  赋值前提: ${conds.map(c => `${c.field.fieldName} ${c.func} ${c.refField ? `@${c.refField.fieldName}` : c.literal ?? ''}`).join(' 且 ')}`);
+    }
+    const body = {
+        ...design,
+        ajaxUrl: '/api/bs/esb/setting/flow/design/saveDesign',
+        saveAndStart: true,
+        appId: esbAppId,
+        sceneId,
+        lightId: FIELD_LINKAGE_LIGHT_ID,
+        initData: '',
+        operateType: '',
+        reloadFormula: [],
+    };
+    const res = await p.client.post(`${p.baseUrl}${ESB_DESIGN_API}/saveDesign`, body, { ebbusinessid: esbAppId });
+    if (res?.code !== 200 || !res?.status) {
+        console.error(`保存 ESB 设计失败: ${res?.msg || '未知错误'}`);
+        process.exit(1);
+    }
+}
+async function addQuickLinkage(p) {
+    const { client, baseUrl, appId, objId, selfFormId, selfFormName, selfFields, selfDetails, trigger, monitorActions, effect, linkageState, detailExt, auth, opts, cmdOpts } = p;
+    if (!cmdOpts.sourceForm) {
+        console.error('快捷配置需要 --source-form <查询目标表 objId>');
+        process.exit(1);
+    }
+    if (cmdOpts.condition.length === 0) {
+        console.error('快捷配置需要至少一个 --condition');
+        process.exit(1);
+    }
+    const { formName: srcFormName } = await getFormId(client, baseUrl, appId, cmdOpts.sourceForm);
+    const srcFields = await getFormFields(client, baseUrl, cmdOpts.sourceForm, auth.userId, auth.tenantKey);
+    const condList = cmdOpts.condition.map(expr => {
+        const c = parseConditionExpr(expr, srcFields);
+        const refField = c.literal && c.literal.startsWith('@') ? findFieldId(selfFields, c.literal.slice(1)) : undefined;
+        return { field: c.field, func: c.func, literal: refField ? undefined : c.literal, range: c.range, refField };
+    });
+    const assigns = cmdOpts.assign.map(parseAssignExpr);
+    const assignPairs = assigns.map(a => {
+        const t = splitAssignTarget(a.target);
+        const srcField = findFieldId(srcFields, a.src);
+        if (!t.table)
+            return { srcField, targetField: findFieldId(selfFields, t.field) };
+        const detail = selfDetails.find(d => d.name === t.table);
+        if (!detail) {
+            console.error(`明细表 "${t.table}" 未找到。可用: ${selfDetails.map(d => d.name).join('、') || '（本表没有明细表）'}`);
+            process.exit(1);
+        }
+        return { srcField, targetField: findFieldId(detail.fields, t.field), subForm: detail };
+    });
+    // 明细行依据：用户指定，缺省取该表第一个赋值的源字段（设计器里「依据值本身」那种配置）
+    const basis = new Map();
+    for (const expr of cmdOpts.basis || []) {
+        const i = expr.indexOf('=');
+        if (i <= 0) {
+            console.error(`--basis 格式错误: ${expr}（应为 明细表名=源表字段名）`);
+            process.exit(1);
+        }
+        const tableName = expr.slice(0, i).trim();
+        const detail = selfDetails.find(d => d.name === tableName);
+        if (!detail) {
+            console.error(`明细表 "${tableName}" 未找到`);
+            process.exit(1);
+        }
+        basis.set(detail.id, findFieldId(srcFields, expr.slice(i + 1).trim()));
+    }
+    for (const a of assignPairs) {
+        if (a.subForm && !basis.has(a.subForm.id))
+            basis.set(a.subForm.id, a.srcField);
+    }
+    const queryNames = cmdOpts.queryFields
+        ? cmdOpts.queryFields.split(',').map(s => s.trim()).filter(Boolean)
+        : [];
+    const queryFieldList = [...new Set([
+            ...queryNames,
+            ...assigns.map(a => a.src),
+            ...[...basis.values()].map((f) => f.fieldName),
+        ])];
+    const queryFields = queryFieldList.map(n => findFieldId(srcFields, n));
+    if (queryFields.length === 0) {
+        console.error('需要 --query-fields 或 --assign 指定查询字段');
+        process.exit(1);
+    }
+    // orgId：ESB app 必须归属机构，否则 saveDesign 失败
+    const formRes = await client.post(`${baseUrl}/api/ebuilder/form/form/formmanage/getForm?apid=${appId}`, { module: 'ebuilderform', form: { id: selfFormId }, baseSettingPartType: 'basic', customParam: { appId, objId } }, { ebbusinessid: selfFormId });
+    const orgId = String(formRes?.data?.form?.orgId || '');
+    const condDesc = condList.map(c => `${c.field.fieldName} ${c.func} ${c.range ? c.range.join('~') : (c.refField ? `@${c.refField.fieldName}` : c.literal ?? '')}`).join(' 且 ');
+    const linkageName = cmdOpts.name || `${selfFormName}.${trigger || '联动'}→${srcFormName}.${condList[0].field.fieldName}`;
+    console.error(`  联动: ${trigger || '（表单级触发）'} → 查 ${srcFormName}: ${condDesc}`);
+    console.error(`  赋值: ${assignPairs.map(a => `${a.srcField.fieldName}→${a.targetField.fieldName}`).join(', ')}`);
+    // 1. ESB app
+    const appRes = await client.post(`${baseUrl}${ESB_APP_API}/save`, { id: genSfId(), name: linkageName, canDelete: false, lightId: FIELD_LINKAGE_LIGHT_ID, initData: '', orgId }, { ebbusinessid: appId });
+    if (appRes?.code !== 200 || !appRes?.status) {
+        console.error(`建 ESB app 失败: ${appRes?.msg}`);
+        process.exit(1);
+    }
+    const esbAppId = String(appRes?.data?.id || '');
+    const sceneId = String(appRes?.data?.activeVersion || '');
+    console.error(`  ESB app: ${esbAppId}  scene: ${sceneId}`);
+    // 2. saveDesign
+    const design = buildQuickSaveDesign({
+        esbAppId, sceneId, lightId: FIELD_LINKAGE_LIGHT_ID, appName: linkageName,
+        selfFormId, selfFormName, appId, selfFields,
+        srcFormObjId: cmdOpts.sourceForm, srcFormName,
+        conditions: condList,
+        queryFields, assigns: assignPairs,
+        details: selfDetails, basis,
+    });
+    if (cmdOpts.precondition.length > 0) {
+        const conds = parsePreconditionListOrExit(cmdOpts.precondition, srcFields, selfFields);
+        const info = await savePreconditionOrExit({
+            client, baseUrl, conds,
+            srcFormObjId: String(cmdOpts.sourceForm), srcFormName,
+            eqWId: String(design.actions[0].wId),
+            selfFormId, selfFormName, eventId: String(design.event.id), esbAppId,
+        });
+        design.actions[1].data.conditionEnable = true;
+        design.actions[1].data.conditionInfo = info;
+        // 设计器报文在 Output.data 上还平铺了这两个键，只发 conditionInfo 平台不会落库
+        design.actions[1].data.conditionId = info.conditionId;
+        design.actions[1].data.conditionDetail = info.conditionDetail;
+        console.error(`  赋值前提: ${conds.map(c => `${c.field.fieldName} ${c.func} ${c.refField ? `@${c.refField.fieldName}` : c.literal ?? ''}`).join(' 且 ')}`);
+    }
+    const designRes = await client.post(`${baseUrl}${ESB_DESIGN_API}/saveDesign`, design, { ebbusinessid: esbAppId });
+    if (designRes?.code !== 200 || !designRes?.status) {
+        console.error(`saveDesign 失败: ${designRes?.msg}`);
+        process.exit(1);
+    }
+    console.error('  ESB 设计已保存（1 查询 + 1 赋值）');
+    // 3. saveFormDataLinkage
+    const linkagePayload = {
+        formId: selfFormId,
+        fdEffect: buildFdEffect(selfFormId, effect),
+        linkageModule: 'ebuilderform', linkageName, linkageState, linkageType: 'template',
+        linkageExt: buildLinkageExt({ ...detailExt, effectContent: '' }),
+        monitorActions,
+        dataSources: [{
+                menuKey: '1', sourceName: '联动设置1', linkageType: 'esb', dataMappings: [],
+                sourceEsb: { configType: 'SIMPLE', parameters: assignPairs.map(a => ({ targetField: String(a.targetField.fieldId), targetName: `${a.subForm ? `${a.subForm.name}.` : ''}${a.targetField.fieldName}` })) },
+                dataSourceId: esbAppId, dataSourceName: `${linkageName}-联动设置1`,
+            }],
+        needSqlCompress: 1, customParam: { appId, objId },
+    };
+    const linkRes = await client.post(`${baseUrl}${LINKAGE_API}/saveFormDataLinkage?apid=${appId}`, linkagePayload, { ebbusinessid: selfFormId });
+    if (linkRes?.code !== 200 || !linkRes?.status) {
+        console.error(`saveFormDataLinkage 失败: ${linkRes?.msg}`);
+        process.exit(1);
+    }
+    const linkageId = String(linkRes?.data?.id || '');
+    console.error(`  联动已绑定: ${linkageId}`);
+    // 4. preCheck + 5. 回读
+    await client.post(`${baseUrl}${LINKAGE_API}/preCheck?apid=${appId}`, { module: 'ebuilderform', formId: selfFormId, linkageIds: [linkageId], customParam: { appId, objId } }, { ebbusinessid: selfFormId });
+    const rb = await client.post(`${baseUrl}${LINKAGE_API}/queryById?apid=${appId}`, { id: linkageId, formId: selfFormId, module: 'ebuilderform', customParam: { appId, objId } }, { ebbusinessid: selfFormId });
+    const ds = (rb?.data?.dataSources || [])[0] || {};
+    const inF = (ds.inFields || []).map((f) => f.id).join(',');
+    const outF = (ds.outFields || []).map((f) => `${f.content}(${f.id})`).join(',');
+    console.log(opts.json
+        ? JSON.stringify({ success: true, linkageId, esbAppId, inFields: inF, outFields: outF })
+        : `字段联动已创建: [${linkageId}] ${trigger || '（表单级触发）'}→${assignPairs.map(a => a.srcField.fieldName).join(',')}  in:${inF} out:${outF}`);
+}
+/** `明细表名.字段名` → 明细表 + 字段；没有点号就是主表字段。 */
+function splitAssignTarget(target) {
+    const i = target.indexOf('.');
+    if (i <= 0)
+        return { field: target };
+    return { table: target.slice(0, i).trim(), field: target.slice(i + 1).trim() };
+}
+/**
+ * 解析 `源表字段:算子:值`。
+ *
+ * 算子表直接复用动作流 filter_rules：中文/符号别名（等于、包含、区间、为空…）→ 平台 func 码，
+ * 并按字段类型族做白名单校验；区间写成 `起始~结束`。
+ */
+function parseConditionExpr(expr, srcFields) {
+    const i = expr.indexOf(':');
+    if (i <= 0) {
+        console.error(`--condition 格式错误: ${expr}（应为 源表字段:算子:值）`);
+        process.exit(1);
+    }
+    const fieldName = expr.slice(0, i).trim();
+    const rest = expr.slice(i + 1);
+    const j = rest.indexOf(':');
+    const rawFunc = (j < 0 ? rest : rest.slice(0, j)).trim();
+    let value = j < 0 ? '' : rest.slice(j + 1).trim();
+    const field = findFieldId(srcFields, fieldName);
+    const family = conditionFieldFamily(String(field.fieldKey || 'Text'), String(field.fieldType || field.type || ''));
+    const multiSelect = field.multiSelect === true || String(field.multiSelect) === 'true';
+    let func;
+    try {
+        func = normalizeFilterOperator(rawFunc, family, { multiSelect });
+    }
+    catch (error) {
+        console.error(error.message);
+        process.exit(1);
+    }
+    let range;
+    if (func === 'range') {
+        const parts = value.split('~').map(s => s.trim());
+        if (parts.length !== 2) {
+            console.error(`区间条件写法: ${fieldName}:区间:起始值~结束值`);
+            process.exit(1);
+        }
+        range = parts;
+    }
+    if (func === 'empty' || func === 'nempty')
+        value = '';
+    else if (value === '') {
+        console.error(`--condition 格式错误: ${expr}`);
+        process.exit(1);
+    }
+    if (range && value.startsWith('@')) {
+        console.error('区间条件不支持引用本表字段');
+        process.exit(1);
+    }
+    return { field, func, literal: value, range };
+}
+function parseAssignExpr(expr) {
+    const i = expr.indexOf('=');
+    if (i <= 0 || i === expr.length - 1) {
+        console.error(`--assign 格式错误: ${expr}（应为 源表查询字段=本表目标字段）`);
+        process.exit(1);
+    }
+    return { src: expr.slice(0, i).trim(), target: expr.slice(i + 1).trim() };
+}
+function fieldTypeOf(componentKey) {
+    const k = String(componentKey || '').toLowerCase();
+    if (k.includes('date'))
+        return 'Date';
+    if (/number|int|decimal|float|money|percent/.test(k))
+        return 'Number';
+    return 'String';
+}
+function dbFieldTypeOf(componentKey) {
+    const t = fieldTypeOf(componentKey);
+    return t === 'Date' ? 'DATE' : t === 'Number' ? 'NUMBER' : 'STRING';
+}
+/** 选项/关联类字段回读时要带名称（与设计器一致）；纯文本/数字/日期不带 */
+function parseMarkOf(componentKey) {
+    return /select|radio|checkbox|browser|ebuilder|employee|department/i.test(String(componentKey || ''));
+}
+export function buildQuickSaveDesign(p) {
+    const eventId = genSfId();
+    const eqWId = genSfId();
+    const filterKey = String(Date.now());
+    const selfFormFields = p.selfFields.filter((f) => /^\d+$/.test(String(f.fieldId))).map((f) => ({
+        id: f.fieldId, orderNum: 1, paramName: f.dataKey || f.fieldKey || '', showName: f.fieldName,
+        paramType: 'string', multipleSelect: f.multiSelect === true || f.multiSelect === 'true', componentKey: f.fieldKey || '', required: false,
+    }));
+    // 多个条件在同一个 filterInput 下用 datas 数组表达，relationship=1 为「且」。
+    const datas = p.conditions.map(c => {
+        const cf = c.field;
+        const cfId = String(cf.fieldId);
+        const cComp = String(cf.fieldKey || 'Text');
+        let conditions;
+        if (c.refField) {
+            const rf = c.refField;
+            const rfId = String(rf.fieldId);
+            const filterValue = {
+                paramKey: `${p.selfFormId}.${rfId}`, paramName: rfId, showName: String(rf.fieldName),
+                paramType: 'string', dataType: 'node', arrs: false, paramTypeString: 'STRING', dataTypeSting: 'NODE',
+                paramId: rfId, name: String(rf.fieldName), source: eventId,
+                value: `FormData.${p.selfFormId}.${rfId}`, type: '3', formulaType: 'string',
+                frontId: normalizeNumericFrontId(rfId, '字段联动 FormulaBean.frontId'),
+                config: {
+                    paramKey: `${p.selfFormId}.${rfId}`, paramType: 'string',
+                    parentName: `${p.selfFormName}.${rf.fieldName}`, newParentName: `${p.selfFormName}.${rf.fieldName}`,
+                    comId: eventId, isMultCom: false, tableName: '表单数据',
+                    fieldInfo: { tablePrimaryKey: 'FormData', paramKey: `${p.selfFormId}.${rfId}` },
+                },
+                applicationId: p.esbAppId, fieldType: 'string',
+            };
+            conditions = { func: c.func, value: filterValue, text: String(rf.fieldName), isEsb: true, esbAssign: { wId: eqWId, textarea: false, withoutDftNum: true } };
+        }
+        else {
+            const nullary = c.func === 'empty' || c.func === 'nempty';
+            conditions = {
+                func: c.func,
+                text: nullary ? '' : String(c.literal ?? ''),
+                value: nullary ? '' : (c.range ?? c.literal),
+                type: '',
+                isEsb: false,
+            };
+        }
+        return {
+            isParent: false, parentNode: filterKey, id: cfId, fieldName: `field_${cfId}`,
+            fieldType: fieldTypeOf(cComp), optionType: '', text: String(cf.fieldName), objId: p.srcFormObjId,
+            compType: cComp, type: 'condition', conditions,
+            multiSelect: cf.multiSelect === true || cf.multiSelect === 'true' ? 'true' : 'false',
+            formInfo: { fieldId: cfId }, originBrowserType: '', module: 'ebuilderform', mainField: true, subTableId: '',
+            formatType: '4', dbFieldType: dbFieldTypeOf(cComp), key: genSfId(), config: { fieldId: cfId },
+        };
+    });
+    const FUNC_CN = {
+        eq: '等于', neq: '不等于', gt: '大于', gte: '大于等于', lt: '小于', lte: '小于等于',
+        contains: '包含', uncontains: '不包含', startWith: '开头包含', unStartWith: '开头不包含',
+        endWith: '结尾包含', unEndWith: '结尾不包含', range: '区间', containedWith: '被包含于',
+        aggregate: '属于', unaggregate: '不属于', empty: '为空', nempty: '不为空',
+    };
+    const describe = (c) => {
+        const cn = FUNC_CN[c.func] || '等于';
+        if (c.func === 'empty' || c.func === 'nempty')
+            return `${c.field.fieldName} ${cn}`;
+        if (c.range)
+            return `${c.field.fieldName} ${cn} '${c.range[0]}' ~ '${c.range[1]}'`;
+        return `${c.field.fieldName} ${cn} '${c.refField ? c.refField.fieldName : c.literal}'`;
+    };
+    const rootStr = `( ${p.conditions.map(describe).join(' 且 ')} )`;
+    const enquiryAction = {
+        id: eqWId, wId: eqWId, nodeType: 'Normal', comType: 'EnquiryForm', type: 'EnquiryForm',
+        previousId: eventId, parentId: '0', name: '设置查询数据', isAdd: true, isOpen: false, attr: { icon: 'Icon-Data-preprocessing' },
+        data: {
+            currentApplication: p.esbAppId,
+            person: { type: '8', name: '', value: `textarea#${genSfId()}#`, formulaType: 'string', applicationId: p.esbAppId, config: { paramType: 'string', switchType: 'assign' }, childs: [{ id: genSfId(), type: '9', name: '{userid}', value: '{userid}', fieldType: 'string', formulaType: 'string', config: { paramType: 'string' }, applicationId: p.esbAppId }] },
+            conditionFormula: '',
+            dataSource: { id: p.srcFormObjId, text: p.srcFormName, type: 'LOGIC', groupId: 'weaver-ebuilder-form-service', isPhysical: true, usage: 'all', detailTable: false, objType: 'physical', module: 'ebuilder', appId: p.appId, isFormModuleSelected: true, enquiryId: -1 },
+            filterInput: { key: filterKey, relationship: '1', isParent: true, isNewFilter: true, parentNode: '', datas, version: 1, filterIsNull: false, rootStr },
+            authorityFlag: '0', opType: 'list',
+            queryFields: p.queryFields.map(f => ({
+                id: `field_${f.fieldId}`, content: String(f.fieldName), parseMark: parseMarkOf(f.fieldKey),
+                fieldGroup: { name: p.srcFormName, id: p.srcFormObjId }, formId: p.srcFormObjId,
+            })),
+            type: 'EventButton', applicationId: p.esbAppId,
+        },
+        branchs: [], multKey: '', multName: '', ignoreFlowCheck: true,
+    };
+    const outWId = genSfId();
+    const mainTableId = genSfId();
+    const baseFormulaValue = (sf) => {
+        const sid = String(sf.fieldId);
+        const paramKey = `${p.srcFormObjId}[].field_${sid}`;
+        return {
+            paramKey, paramName: `field_${sid}`, showName: String(sf.fieldName), paramType: 'string',
+            dataType: 'attribute', arrs: false, paramTypeString: 'STRING', dataTypeSting: 'ATTRIBUTE',
+            formulaId: '0', name: String(sf.fieldName), source: eqWId,
+            value: `FormData.${p.srcFormObjId}[${genSfId()}].field_${sid}`, type: '3', formulaType: 'string',
+            config: {
+                paramKey, paramType: 'string',
+                parentName: `${p.srcFormName}[].${sf.fieldName}`, newParentName: `${p.srcFormName}[].${sf.fieldName}`,
+                comId: eqWId, isMultCom: false, tableName: '表单数据',
+                fieldInfo: { tablePrimaryKey: 'FormData', paramKey }, switchType: 'assign',
+            },
+            switchType: 'assign',
+        };
+    };
+    /** 明细字段被赋的源字段正好是「依据值」时，设计器存的是 esbAssignSelf。 */
+    const buildAssignField = (a, tableId, basisField) => {
+        const sf = a.srcField;
+        const tf = a.targetField;
+        const isBasisSelf = !!basisField && String(basisField.fieldId) === String(sf.fieldId);
+        if (a.subForm && isBasisSelf) {
+            const sid = String(sf.fieldId);
+            const paramKey = `${p.srcFormObjId}[].field_${sid}`;
+            return {
+                id: genSfId(), paramName: '', showName: '', paramType: 'string', isRequired: false,
+                fieldComments: '', skipNull: '1', assignFieldId: String(tf.fieldId),
+                fieldPath: `${tableId}.${tf.fieldId}`, fieldType: String(tf.fieldKey || 'Text'), switchType: 'sub',
+                formulaValue: {
+                    id: genSfId(), name: `${sf.fieldName}(依据值本身)`, value: 'esbAssignSelf', type: '10',
+                    fieldType: 'string', formulaType: 'string', applicationId: p.esbAppId, switchType: 'sub',
+                    config: {
+                        originValue: 'esbAssignSelf', switchType: 'sub', id: 'esbAssignSelf',
+                        content: `${sf.fieldName}(依据值本身)`, source: eqWId, frontId: genSfId(),
+                        value: `FormData.${p.srcFormObjId}[].field_${sid}`, paramKey,
+                        config: baseFormulaValue(sf).config, level: 0, basisType: 'formSetting',
+                    },
+                },
+            };
+        }
+        return {
+            id: genSfId(), paramName: '', showName: '', paramType: 'string', isRequired: false,
+            fieldComments: '', skipNull: a.subForm ? '1' : '0', assignFieldId: String(tf.fieldId),
+            fieldPath: `${tableId}.${tf.fieldId}`, fieldType: String(tf.fieldKey || 'Text'),
+            ...(a.subForm ? { switchType: 'sub' } : {}),
+            formulaValue: baseFormulaValue(sf),
+        };
+    };
+    const buildBasisValue = (field) => {
+        const fid = String(field.fieldId);
+        const paramKey = `${p.srcFormObjId}[].field_${fid}`;
+        return {
+            id: genSfId(), deleteType: 0, paramKey, paramName: `field_${fid}`, showName: String(field.fieldName),
+            paramType: 'string', dataType: 'attribute', arrs: false, required: false, description: `field_${fid}`,
+            paramTypeString: 'STRING', dataTypeSting: 'ATTRIBUTE', formulaId: '0',
+            hideParamNameInSelect: false, hideParam: false, readonlyParam: false, sensitiveFlag: false, newdata: false,
+            parentName: `${p.srcFormName}[].${field.fieldName}`, name: String(field.fieldName),
+            source: eqWId, value: `FormData.${p.srcFormObjId}[].field_${fid}`, type: '3', formulaType: 'string',
+            frontId: genSfId(),
+            config: {
+                paramKey, paramType: 'string',
+                parentName: `${p.srcFormName}[].${field.fieldName}`, newParentName: `${p.srcFormName}[].${field.fieldName}`,
+                comId: eqWId, isMultCom: false, tableName: '表单数据',
+                fieldInfo: { tablePrimaryKey: 'FormData', paramKey }, comType: 'EnquiryForm', parentComId: '0', switchType: 'assign',
+            },
+            applicationId: p.esbAppId, businessId: genSfId(), fieldType: 'string',
+        };
+    };
+    const tableList = [{
+            id: mainTableId, formId: p.selfFormId, showName: p.selfFormName, orderNum: 0,
+            fields: p.assigns.filter(a => !a.subForm).map(a => buildAssignField(a, mainTableId)),
+            main: true, isMain: true,
+        }];
+    for (const det of p.details) {
+        const detAssigns = p.assigns.filter(a => a.subForm?.id === det.id);
+        if (!detAssigns.length)
+            continue;
+        const detTableId = genSfId();
+        const basisField = p.basis.get(det.id);
+        tableList.push({
+            id: detTableId, formId: det.id, showName: det.name, orderNum: 1,
+            fields: detAssigns.map(a => buildAssignField(a, detTableId, basisField)),
+            main: false, isMain: false,
+            ...(basisField ? { basisValue: buildBasisValue(basisField) } : {}),
+        });
+    }
+    const detailFormFields = p.details
+        .filter(det => p.assigns.some(a => a.subForm?.id === det.id))
+        .map((det, idx) => ({
+        id: det.id, formId: det.id, showName: det.name, orderNum: idx + 1, main: false,
+        fields: [
+            { id: '5', orderNum: 0, paramName: 'rowId', showName: 'rowId', paramType: 'string', componentKey: 'Text' },
+            ...det.fields.filter((f) => /^\d+$/.test(String(f.fieldId))).map((f, i) => ({
+                id: f.fieldId, orderNum: i + 1, paramName: f.dataKey || '', showName: f.fieldName,
+                paramType: 'string', multipleSelect: f.multiSelect === true || String(f.multiSelect) === 'true',
+                componentKey: f.fieldKey || '', required: false,
+            })),
+        ],
+    }));
+    const outputAction = {
+        id: outWId, wId: outWId, nodeType: 'Normal', comType: 'Output', type: 'Output',
+        previousId: eqWId, parentId: '0', name: '设置赋值字段', isAdd: true, isOpen: false,
+        componentName: '终止', attr: { icon: 'Icon-termination-1' }, isControl: true,
+        data: {
+            outputStatus: '1', pageAction: '0', reminder: '0', fixedData: [], triggerFlag: false, nextAction: false,
+            customOutputData: '', currentApplication: p.esbAppId,
+            fieldLinkCustomParamSetting: {
+                customId: '', formType: 'output', businessModule: '',
+                tableList,
+                deleteTableIds: [], appId: p.esbAppId,
+            },
+            applicationId: p.esbAppId,
+        },
+        canDelete: false, options: { type: 'Output', name: '设置赋值字段', canDelete: false },
+        sources: [{ wId: eqWId }], ignoreFlowCheck: true,
+    };
+    return {
+        ajaxUrl: '/api/bs/esb/setting/flow/design/saveDesign', saveAndStart: true, appId: p.esbAppId, sceneId: p.sceneId,
+        event: { id: eventId, wId: eventId, nodeType: 'Normal', comType: 'FieldLinkage', type: 'FieldLinkage', previousId: '0', parentId: '0', isAdd: true, isOpen: true, attr: { icon: 'Icon-trigger03' }, isControl: true, name: '字段联动触发', canEdit: false, canDelete: false, triggerType: 'SystemTrigger', data: { ownForm: [{ id: p.selfFormId, name: p.selfFormName }], ownModule: 'ebuilderform', ownApplication: [{ id: p.appId, name: p.appId }], formFields: [{ id: genSfId(), formId: p.selfFormId, showName: p.selfFormName, orderNum: 0, fields: selfFormFields, main: true }, ...detailFormFields] } },
+        actions: [enquiryAction, outputAction],
+        addIds: [], deleteActions: [], version: 0, delCheckMsg: [], addCheckMsg: [], assistLayer: '{"nodes":[],"layout":{}}', versionConfig: '{}', saveNewVersion: false, lightId: p.lightId, initData: '', secretKey: '', operateType: '', appName: p.appName,
+    };
+}
 //# sourceMappingURL=form-field-linkage.js.map