weaver-e10-builder 1.5.10 → 1.5.12

package/dist/commands/wf-form.js

@@ -11,7 +11,7 @@ import { randomUUID } from 'node:crypto';
 import { readFileSync } from 'node:fs';
 import { buildConditionDetail, resolveWorkflowEffect, readLinkageConfig } from '../services/form-linkage-condition.js';
 import { resolveFormulaRefs } from '../services/formula-detail.js';
-import { FLOW_ROUTE, assertAssignableTarget, buildAssignExpression, buildDrivingColumnsBody, buildDrivingEventsBody, buildFdEffect, buildFormulaLinkageName, buildFormulaSavePayload, buildLinkageApiUrl, buildLinkageDeleteBody, buildLinkageListBody, buildLinkageQueryBody, buildLinkageSavePayload, buildLinkageUpdatePayload, buildMonitorActions, buildPreCheckBody, describeColumn, extractEffect, extractTriggerState, findColumnById, isAssignableTarget, moduleColumnsOf, partitionDrivingColumns, resolveDrivingColumn, resolveDrivingEvent, summarizeLinkage, formatTriggerLine, targetDriftWarning, toBareLabel, } from '../services/form-formula-linkage.js';
+import { FLOW_ROUTE, assertAssignableTarget, buildAssignExpression, buildDrivingColumnsBody, buildDrivingEventsBody, buildFdEffect, buildFormulaLinkageName, buildFormulaSavePayload, buildLinkageApiUrl, buildLinkageExt, buildLinkageDeleteBody, buildLinkageListBody, buildLinkageQueryBody, buildLinkageSavePayload, buildLinkageUpdatePayload, buildMonitorActions, buildPreCheckBody, buildTriggerSpecs, describeColumn, extractEffect, findAssignEquals, formatSpecsLine, isAssignableTarget, isWorkflowDimension, mergeMonitorActions, moduleColumnsOf, partitionDrivingColumns, resolveDrivingColumn, specsFromStoredTriggers, storedTriggers, summarizeLinkage, formatTriggerLine, targetDriftWarning, toBareLabel, } from '../services/form-formula-linkage.js';
 /** 流程表单选项配色（对齐浏览器抓包 styleConfig.OptionBackground，循环取用）。 */
 const OPTION_COLORS = ['#FFBD4F', '#FF716E', '#3BD8C3', '#5B8FF9', '#5AD8A6', '#F6BD16', '#E86452', '#6DC8EC', '#945FB9', '#FF99C3'];
 /**
@@ -83,6 +83,21 @@ async function readConfigs(client, baseUrl, formId) {
         throw new Error(`getConfig 失败: ${cfg?.msg}`);
     return { ...meta, configs: normalizeDetailTableChildren(cfg?.data?.configs || []) };
 }
+/** 查重规则的可选字段：主表 + 明细子字段（跳过系统字段）。 */
+function validateCandidates(configs, formId) {
+    const candidates = [];
+    for (const c of configs) {
+        if (c.system)
+            continue;
+        if (c.componentKey === 'DataTable' || c.type === 'DetailTable') {
+            for (const ch of (c.children || []))
+                candidates.push({ fieldName: ch.name, fieldId: String(ch.id), subFormId: String(c.id) });
+        }
+        else
+            candidates.push({ fieldName: c.name, fieldId: String(c.id), subFormId: formId });
+    }
+    return candidates;
+}
 /** 读取运行时布局（getFormLayout pageLayouts comps），返回 singleRow=true 的字段 ID 集合。
  *  getConfig 的 configs 不带已保存的 singleRow（设计视图默认 false）；field-prop/group/layout init
  *  重排前若不从运行时合并回来，独占一行字段会被 initLayout 冲掉（实测：group initLayout 后 客户地址 singleRow 丢失）。 */
@@ -817,17 +832,7 @@ export function registerWorkflowFormCommands(program) {
             const ebb = { ebbusinessid: formId };
             // getConfig 解析字段（主表 subFormId=formId；明细 subFormId=子表 id）
             const { configs } = await readConfigs(client, baseUrl, formId);
-            const candidates = [];
-            for (const c of configs) {
-                if (c.system)
-                    continue;
-                if (c.componentKey === 'DataTable' || c.type === 'DetailTable') {
-                    for (const ch of (c.children || []))
-                        candidates.push({ fieldName: ch.name, fieldId: String(ch.id), subFormId: String(c.id) });
-                }
-                else
-                    candidates.push({ fieldName: c.name, fieldId: String(c.id), subFormId: formId });
-            }
+            const candidates = validateCandidates(configs, formId);
             const checkFields = fieldNames.map((n) => {
                 const c = candidates.find((x) => x.fieldName === n || String(x.fieldId) === n);
                 if (!c)
@@ -874,6 +879,114 @@ export function registerWorkflowFormCommands(program) {
             process.exitCode = 1;
         }
     });
+    validateCmd.command('update')
+        .description('修改查重规则（只改传入的项，其余保持原值）')
+        .argument('<formId>', '流程表单 formId')
+        .argument('<ruleId>', '规则 ID（wf-form validate list 查看）')
+        .option('--fields <names...>', '改查重字段（多个 AND；不给则沿用原字段）')
+        .option('--help <text>', '改重复提示内容（不给则沿用原提示）')
+        .option('--remind', '改成重复时仅提醒（允许提交）')
+        .option('--no-remind', '改成重复时禁止提交（NOSUBMISSION）')
+        .action(async (formId, ruleId, cmdOpts) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const ebb = { ebbusinessid: formId };
+            if (cmdOpts.fields === undefined && cmdOpts.help === undefined && cmdOpts.remind === undefined) {
+                throw new Error('没有要修改的项（至少给 --fields / --help / --remind / --no-remind 之一）');
+            }
+            // 翻页取全，避免规则数超过一页时定位不到
+            const PAGE = 100;
+            const rules = [];
+            for (let pageNo = 1;; pageNo++) {
+                const res = await client.post(`${baseUrl}${ROUTE}/validate/pageFormDataValidate`, { module: MODULE, formId, pageNo, pageSize: PAGE }, ebb);
+                if (res?.code !== 200 || !res?.status)
+                    throw new Error(res?.msg || '未知错误');
+                const page = res?.data?.records || [];
+                rules.push(...page);
+                if (page.length < PAGE)
+                    break;
+            }
+            const rule = rules.find((r) => String(r.id) === String(ruleId));
+            if (!rule)
+                throw new Error(`规则不存在或不属于该表单: ${ruleId}（wf-form validate list 查看可用规则）`);
+            const { configs } = await readConfigs(client, baseUrl, formId);
+            const candidates = validateCandidates(configs, formId);
+            // checkFields 是整组替换：没改字段也要把完整一组带上
+            let checkFields;
+            if (cmdOpts.fields !== undefined) {
+                checkFields = cmdOpts.fields.map((n) => {
+                    const c = candidates.find((x) => x.fieldName === n || String(x.fieldId) === n);
+                    if (!c)
+                        throw new Error(`未找到字段: ${n}，可用: ${candidates.map((x) => x.fieldName).join(', ')}`);
+                    return c;
+                });
+            }
+            else {
+                checkFields = (rule.checkFields || []).map((c) => {
+                    const hit = candidates.find((x) => x.fieldId === String(c.fieldId));
+                    if (!hit)
+                        throw new Error(`规则里的字段 ${c.fieldName || c.fieldId} 已不在当前表单中，请用 --fields 重新指定查重字段`);
+                    return hit;
+                });
+            }
+            if (!checkFields.length)
+                throw new Error('规则里没有查重字段，请用 --fields 指定');
+            const treatmentMethod = cmdOpts.remind === undefined
+                ? (rule.treatmentMethod === 'REMINDER' ? 'REMINDER' : 'NOSUBMISSION')
+                : (cmdOpts.remind ? 'REMINDER' : 'NOSUBMISSION');
+            const helpContent = cmdOpts.help === undefined ? rule.helpContent : String(cmdOpts.help);
+            const payload = {
+                id: String(ruleId),
+                module: MODULE, formId,
+                treatmentMethod,
+                remindTime: rule.remindTime || 'SUB_REMIND',
+                taggingColour: rule.taggingColour || '#000000',
+                subFieldCheckType: rule.subFieldCheckType || 'ALL_DATA',
+                helpContent,
+                checkFields,
+            };
+            const res = await client.post(`${baseUrl}${ROUTE}/validate/save`, payload, ebb);
+            if (res?.code !== 200 || !res?.status)
+                throw new Error(`保存失败: ${res?.msg || '未知错误'}`);
+            // 回读校验：处理方式、查重字段集合、提示内容
+            const afterRules = [];
+            for (let pageNo = 1;; pageNo++) {
+                const pageRes = await client.post(`${baseUrl}${ROUTE}/validate/pageFormDataValidate`, { module: MODULE, formId, pageNo, pageSize: PAGE }, ebb);
+                const page = pageRes?.data?.records || [];
+                afterRules.push(...page);
+                if (page.length < PAGE)
+                    break;
+            }
+            const after = afterRules.find((r) => String(r.id) === String(ruleId));
+            if (!after)
+                throw new Error(`保存后回读不到规则 ${ruleId}`);
+            const want = checkFields.map((f) => f.fieldId).sort().join(',');
+            const got = (after.checkFields || []).map((c) => String(c.fieldId)).sort().join(',');
+            const diffs = [];
+            if (after.treatmentMethod !== treatmentMethod)
+                diffs.push(`处理方式 期望=${treatmentMethod} 实际=${after.treatmentMethod}`);
+            if (got !== want)
+                diffs.push(`查重字段 期望=${want} 实际=${got}`);
+            if (String(after.helpContent ?? '') !== String(helpContent ?? ''))
+                diffs.push('提示内容不一致');
+            if (diffs.length)
+                throw new Error(`保存后回读不一致：${diffs.join('; ')}`);
+            const fieldNames = (after.checkFields || []).map((c) => c.fieldName);
+            const method = after.treatmentMethod === 'REMINDER' ? '提醒' : '禁止提交';
+            console.log(opts.json
+                ? JSON.stringify({ success: true, ruleId: String(ruleId), fields: fieldNames, method: after.treatmentMethod }, null, 2)
+                : `已修改查重规则 [${ruleId}]：${fieldNames.join(' + ')}（${method}）`);
+        }
+        catch (e) {
+            console.error(`修改查重规则失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
     // ---------- wf-form linkage ----------
     wfForm.command('linkage')
         .description('显隐联动管理（/api/workflow/core/form/setting/viewlinkage）')
@@ -2118,6 +2231,70 @@ export function registerWorkflowFormCommands(program) {
         }
         return res.data;
     }
+    /** 改公式正文（表达式 / 赋值目标）：公式记录与联动分开，走 formula/save 带 formulaId 原地更新。 */
+    async function wfUpdateFormula(client, baseUrl, formId, workflowId, record, o) {
+        const excelId = summarizeLinkage(record).excelId;
+        if (!excelId)
+            throw new Error('这条联动没有关联公式（excelId 为空），无法修改公式');
+        const detailRes = await client.post(`${baseUrl}/api/excel/formula/detail`, { formulaId: excelId });
+        const fd = detailRes?.resultJson?.data;
+        if (!detailRes?.resultJson?.excute || !fd) {
+            throw new Error(`读取原公式失败: ${detailRes?.resultJson?.error || detailRes?.msg || '未知错误'}`);
+        }
+        const { columns, source } = await wfLinkageContext(client, baseUrl, formId, workflowId);
+        let targetCol;
+        if (o.target !== undefined) {
+            targetCol = resolveDrivingColumn(columns, o.target, FLOW_ROUTE);
+        }
+        else {
+            // 不给 --target 就沿用原公式的目标 —— 参数表首位在建公式时恒为赋值目标
+            const curId = String(fd?.parameters?.[0]?.fieldId ?? '');
+            const hit = columns.find((c) => String(c.id) === curId);
+            if (!hit)
+                throw new Error('无法从原公式的参数表确定赋值目标，请用 --target 指定');
+            targetCol = hit;
+        }
+        assertAssignableTarget(targetCol, FLOW_ROUTE);
+        const drift = targetDriftWarning(targetCol, FLOW_ROUTE);
+        if (drift)
+            console.error(`  ⚠ ${drift}`);
+        let body;
+        if (o.expression !== undefined) {
+            body = readExpressionArg(o.expression);
+        }
+        else {
+            // 只改目标：沿用原公式右侧，剥掉旧的赋值左侧
+            const stored = String(fd.expressSql || '');
+            const eq = findAssignEquals(stored);
+            body = eq >= 0 ? stored.slice(eq + 1).trim() : stored;
+        }
+        const { expression } = buildAssignExpression(targetCol, body);
+        const parsed = resolveFormulaRefs(expression, {
+            mainFields: source.mainFields, detailTables: source.detailTables,
+            moduleColumns: moduleColumnsOf(columns, FLOW_ROUTE),
+            formId, module: FLOW_ROUTE.module, hint: FLOW_ROUTE.columnsHint,
+        });
+        for (const w of parsed.warnings)
+            console.error(`  ⚠ ${w}`);
+        if (parsed.errors.length)
+            throw new Error(parsed.errors.join('\n'));
+        if (String(parsed.parameters[0]?.fieldId) !== String(targetCol.id)) {
+            throw new Error(`赋值目标没有出现在公式参数表首位（首位是 ${parsed.parameters[0]?.fieldId ?? '空'}），已中止`);
+        }
+        const formulaName = String(fd.name || summarizeLinkage(record).excelName || '函数联动公式');
+        const saveRes = await client.post(`${baseUrl}/api/excel/formula/save`, buildFormulaSavePayload({
+            expression: parsed.normalizedExpression, name: formulaName,
+            parameters: parsed.parameters, formulaId: excelId, route: FLOW_ROUTE,
+        }));
+        if (!saveRes?.resultJson?.excute) {
+            throw new Error(`公式更新失败: ${saveRes?.resultJson?.error || saveRes?.msg || '未知错误'}`);
+        }
+        const newId = String(saveRes.resultJson.id || '');
+        if (newId !== excelId) {
+            throw new Error(`期望原地更新 ${excelId}，平台返回的是 ${newId}（可能新建了一条公式，联动仍指向旧公式）`);
+        }
+        console.error(`  公式已更新: ${parsed.normalizedExpression}`);
+    }
     flCmd.command('list')
         .description('列出该流程表单下的函数联动')
         .argument('<formId>', '流程表单 formId')
@@ -2147,6 +2324,7 @@ export function registerWorkflowFormCommands(program) {
                 console.log(`  [${s.id}] ${s.name} (${s.state ? '启用' : '停用'})`);
                 console.log(`      生效范围: ${wfEffectLabel(s.effect)}`);
                 console.log(`      触发: ${formatTriggerLine(s)}`);
+                console.log(`      联动出值继续触发: ${s.fissionState ? '开' : '关'}`);
             }
             if (records.length)
                 console.log('  （列表不返回公式正文，要表达式/参数用 wf-form formula-linkage read）');
@@ -2181,6 +2359,7 @@ export function registerWorkflowFormCommands(program) {
             console.log(`  refId: ${data?.refId || '—'}`);
             console.log(`  生效范围: ${wfEffectLabel(s.effect)}`);
             console.log(`  触发: ${formatTriggerLine(s)}`);
+            console.log(`  联动出值继续触发: ${s.fissionState ? '开' : '关'}`);
             console.log(`  公式记录: ${s.excelName} (excelId=${s.excelId})`);
             console.log(`  表达式: ${s.expression || '-'}`);
             if (s.parameters.length) {
@@ -2262,12 +2441,12 @@ export function registerWorkflowFormCommands(program) {
         }
     });
     flCmd.command('add')
-        .description('新增函数联动：事件 + 触发字段 + 赋值目标 + 公式')
+        .description('新增函数联动：触发时机（可多个）+ 触发字段 + 赋值目标 + 公式')
         .argument('<formId>', '流程表单 formId')
         .requiredOption('--target <field>', '赋值目标字段（被写入）')
         .requiredOption('--expression <expr>', '公式右侧函数体；也接受整段赋值式，或用 @文件 传长表达式')
-        .option('--event <event>', '触发事件（名称或 type，见 events），默认 changeField 值改变时', 'changeField')
-        .option('--trigger <fields...>', '触发字段，可多个')
+        .option('--event <event...>', '触发时机，**可多个**；每个可自带触发字段 —— 「名称或 type」或「类型:字段,字段」。默认 changeField 值改变时', ['changeField'])
+        .option('--trigger <fields...>', '触发字段，可多个。作用于**没有自带字段**的字段级触发时机')
         .option('--effect <dimension>', '生效维度: form=当前表单（默认）/ formLayout=表单布局 / workFlow=当前工作流 / includeNode=选择节点')
         .option('--workflow-id <id>', '流程 ID（refId，也是 workFlow/includeNode 的取值来源；不给按 formId 兜底）')
         .option('--node <node>', 'includeNode 的节点（id 或节点名）')
@@ -2275,6 +2454,7 @@ export function registerWorkflowFormCommands(program) {
         .option('--name <name>', '联动名称（默认「<公式名> - 公式_<时间戳>」）')
         .option('--formula-name <name>', '公式名称')
         .option('--formula-id <id>', '复用/更新已有公式（传了就原地更新那张公式）')
+        .option('--fission <onoff>', '联动出的值继续触发联动: on（默认）/ off')
         .action(async (formId, cmdOpts) => {
         try {
             const opts = program.opts();
@@ -2286,22 +2466,21 @@ export function registerWorkflowFormCommands(program) {
             const ebb = { ebbusinessid: formId };
             const refId = cmdOpts.workflowId || formId;
             const { events, columns, source } = await wfLinkageContext(client, baseUrl, formId, cmdOpts.workflowId);
-            const event = resolveDrivingEvent(events, cmdOpts.event);
             const targetCol = resolveDrivingColumn(columns, cmdOpts.target, FLOW_ROUTE);
             assertAssignableTarget(targetCol, FLOW_ROUTE);
             const drift = targetDriftWarning(targetCol, FLOW_ROUTE);
             if (drift)
                 console.error(`  ⚠ ${drift}`);
-            const triggerCols = (cmdOpts.trigger || []).map((t) => resolveDrivingColumn(columns, t, FLOW_ROUTE));
-            if (!event.selectColumn && triggerCols.length) {
-                console.error(`  ⚠ 事件「${event.name}」是表单级的，不需要触发字段，--trigger 已忽略`);
-            }
-            const monitorActions = buildMonitorActions(event, triggerCols);
+            const built = buildTriggerSpecs(events, columns, cmdOpts.event, cmdOpts.trigger || [], FLOW_ROUTE);
+            const specs = built.specs;
+            for (const w of built.warnings)
+                console.error(`  ⚠ ${w}`);
+            const monitorActions = buildMonitorActions(specs);
             const { effect } = await wfEffectOf(client, baseUrl, formId, cmdOpts);
             const { expression, stripped } = buildAssignExpression(targetCol, readExpressionArg(cmdOpts.expression));
             if (stripped)
                 console.error('  ℹ 表达式自带赋值式，已按 --target 校验左侧并沿用右侧');
-            console.error(`  联动: ${effect.effectName} / ${event.name} ← ${triggerCols.map((c) => toBareLabel(c)).join('、') || '（表单级）'} → 填 ${toBareLabel(targetCol)}(${targetCol.id})`);
+            console.error(`  联动: ${effect.effectName} / ${formatSpecsLine(specs)} → 填 ${toBareLabel(targetCol)}(${targetCol.id})`);
             // 这条路由的 parameter **不带 appId 键**，所以 ctx 里不给 appId
             const parsed = resolveFormulaRefs(expression, {
                 mainFields: source.mainFields, detailTables: source.detailTables,
@@ -2333,6 +2512,7 @@ export function registerWorkflowFormCommands(program) {
             const linkRes = await client.post(`${baseUrl}${buildLinkageApiUrl(FLOW_ROUTE, 'saveFormDataLinkage')}`, buildLinkageSavePayload({
                 formId, appId: '', objId: '', linkageName, excelId, excelName: formulaName,
                 monitorActions, route: FLOW_ROUTE, refId,
+                linkageExt: buildLinkageExt({ fissionState: parseFissionOrExit(cmdOpts.fission) }),
             }), ebb);
             if (linkRes?.code !== 200 || !linkRes?.status) {
                 throw new Error(`联动保存失败: ${linkRes?.msg || '未知错误'}（公式已创建 excelId=${excelId}，可用 --formula-id ${excelId} 复用重试）`);
@@ -2353,10 +2533,13 @@ export function registerWorkflowFormCommands(program) {
                 success: true, linkageId, excelId, formId, refId, effect: effect.effectName,
                 expression: s.expression || parsed.normalizedExpression,
                 target: { id: targetCol.id, name: toBareLabel(targetCol) },
-                event: event.type, triggers: triggerCols.map((c) => ({ id: c.id, name: toBareLabel(c) })),
+                events: specs.map((sp) => ({
+                    type: sp.event.type, name: sp.event.name,
+                    triggers: sp.cols.map((c) => ({ id: String(c.id), name: toBareLabel(c) })),
+                })),
             };
             console.log(opts.json ? JSON.stringify(out, null, 2)
-                : `函数联动已创建: [${linkageId}] ${effect.effectName} / ${event.name} ← ${triggerCols.map((c) => toBareLabel(c)).join('、') || '（表单级）'} → ${toBareLabel(targetCol)}`);
+                : `函数联动已创建: [${linkageId}] ${effect.effectName} / ${formatSpecsLine(specs)} → ${toBareLabel(targetCol)}`);
         }
         catch (e) {
             console.error(`新增函数联动失败: ${e.message}`);
@@ -2364,17 +2547,20 @@ export function registerWorkflowFormCommands(program) {
         }
     });
     flCmd.command('update')
-        .description('改已有函数联动的触发条件/生效维度/名称/启停（不传的项沿用现有）')
+        .description('改已有函数联动的触发时机/生效维度/名称/启停/公式（不给 --event/--trigger 就原样沿用现有的触发时机）')
         .argument('<formId>', '流程表单 formId')
         .argument('<linkageId>', '联动 ID')
-        .option('--event <event>', '改触发事件')
-        .option('--trigger <fields...>', '改触发字段')
+        .option('--expression <expr>', '改公式右侧函数体（也可整段赋值式，或用 @文件）。不给则沿用现有公式')
+        .option('--target <field>', '改赋值目标字段（只改目标时沿用现有公式右侧）')
+        .option('--event <event...>', '改触发时机，可多个（写法同 add：可带 --event 类型:字段,字段）。不给则沿用现有')
+        .option('--trigger <fields...>', '改触发字段（作用于记录里的字段级触发时机）。不给则沿用现有')
         .option('--effect <dimension>', '改生效维度: form / formLayout / workFlow / includeNode')
         .option('--workflow-id <id>', '流程 ID（refId；不给沿用记录里的）')
         .option('--node <node>', 'includeNode 的节点')
         .option('--layout-id <id>', 'formLayout 指定的布局')
         .option('--name <name>', '改联动名称')
         .option('--state <onoff>', '启用或停用: on / off')
+        .option('--fission <onoff>', '联动出的值继续触发联动: on / off（不给则沿用现有）')
         .action(async (formId, linkageId, cmdOpts) => {
         try {
             const opts = program.opts();
@@ -2386,26 +2572,44 @@ export function registerWorkflowFormCommands(program) {
             const ebb = { ebbusinessid: formId };
             const record = await wfReadLinkage(client, baseUrl, formId, linkageId, cmdOpts.workflowId);
             const refId = String(record?.refId || cmdOpts.workflowId || formId);
-            const cur = extractTriggerState(record);
-            const { events, columns } = await wfLinkageContext(client, baseUrl, formId, cmdOpts.workflowId);
-            const event = resolveDrivingEvent(events, cmdOpts.event || cur.eventType);
-            const triggerInput = cmdOpts.trigger?.length ? cmdOpts.trigger : cur.triggerIds;
-            const triggerCols = [];
-            for (const t of triggerInput) {
-                const col = findColumnById(columns, t) || (() => { try {
-                    return resolveDrivingColumn(columns, t, FLOW_ROUTE);
-                }
-                catch {
-                    return undefined;
-                } })();
-                if (!col)
-                    throw new Error(`触发字段「${t}」在当前表单里找不到了（可能已被删除）。用 wf-form formula-linkage columns 复核`);
-                triggerCols.push(col);
-            }
-            const monitorActions = buildMonitorActions(event, triggerCols);
+            const curEffect = extractEffect(record);
             const effect = cmdOpts.effect
                 ? (await wfEffectOf(client, baseUrl, formId, cmdOpts)).effect
-                : extractEffect(record);
+                : curEffect;
+            // 在「表单/布局」与「工作流/节点」之间换维度时，可用事件整个换了一套；不给 --event 就会存出
+            // 一条「事件是工作流事件、维度却是当前表单」的坏规则 —— 当场拦下
+            if (isWorkflowDimension(curEffect?.effectType) !== isWorkflowDimension(effect?.effectType)
+                && !cmdOpts.event?.length) {
+                throw new Error('生效维度在「当前表单/表单布局」与「当前工作流/选择节点」之间切换时，必须同时用 --event 指定新维度下可用的触发时机');
+            }
+            let specs = null;
+            const wantEvents = !!cmdOpts.event?.length;
+            const wantTrigger = !!cmdOpts.trigger?.length;
+            if (wantEvents || wantTrigger) {
+                const { events, columns } = await wfLinkageContext(client, baseUrl, formId, cmdOpts.workflowId);
+                if (wantEvents) {
+                    const built = buildTriggerSpecs(events, columns, cmdOpts.event, cmdOpts.trigger || [], FLOW_ROUTE);
+                    specs = built.specs;
+                    for (const w of built.warnings)
+                        console.error(`  ⚠ ${w}`);
+                }
+                else {
+                    // 只给 --trigger：触发时机沿用记录里的（记录自己说了算哪些是字段级），只换字段
+                    const built = specsFromStoredTriggers(storedTriggers(record), events, columns, cmdOpts.trigger || []);
+                    specs = built.specs;
+                    if (!built.overrideApplied)
+                        console.error('  ⚠ 记录里没有字段级触发时机，--trigger 已忽略');
+                }
+            }
+            // 公式正文不在联动记录里，单独更新（见 wfUpdateFormula）
+            if (cmdOpts.expression !== undefined || cmdOpts.target !== undefined) {
+                await wfUpdateFormula(client, baseUrl, formId, cmdOpts.workflowId, record, {
+                    expression: cmdOpts.expression, target: cmdOpts.target,
+                });
+            }
+            // ⚠ 两个都没给就**原样透传**读回的 monitorActions —— 早先这里是拿 `actions[0]` 重建，
+            // 一条挂了多个触发时机的规则改个名字就会把其余触发时机静默抹掉
+            const monitorActions = specs ? mergeMonitorActions(record?.monitorActions || [], specs) : (record?.monitorActions || []);
             let linkageState = record?.linkageState !== false;
             if (cmdOpts.state) {
                 const v = String(cmdOpts.state).toLowerCase();
@@ -2417,14 +2621,21 @@ export function registerWorkflowFormCommands(program) {
                 appId: '', objId: '',
                 linkageName: cmdOpts.name || String(record?.linkageName || ''),
                 linkageState, monitorActions, effect, route: FLOW_ROUTE, refId,
+                fissionState: cmdOpts.fission !== undefined ? parseFissionOrExit(cmdOpts.fission) : undefined,
             }), ebb);
             if (res?.code !== 200 || !res?.status)
                 throw new Error(`更新失败: ${res?.msg || '未知错误'}`);
             await client.post(`${baseUrl}${buildLinkageApiUrl(FLOW_ROUTE, 'preCheck')}`, buildPreCheckBody(FLOW_ROUTE, { formId, linkageIds: [linkageId], refId }), ebb);
             const after = summarizeLinkage(await wfReadLinkage(client, baseUrl, formId, linkageId, refId));
-            const out = { success: true, linkageId, name: after.name, state: after.state, effect: wfEffectLabel(after.effect), event: after.eventNames.join('、'), triggers: after.triggerNames };
+            // 触发时机数量对不上就是被平台吞了 —— 这种静默丢失必须当场喊出来
+            const want = monitorActions.map((a) => String(a?.actionType || '')).filter(Boolean).join(',');
+            const got = after.triggers.map((t) => t.eventType).join(',');
+            if (want !== got) {
+                console.error(`  ⚠ 回读的触发时机与提交的不一致，以平台为准\n      提交: ${want || '（空）'}\n      回读: ${got || '（空）'}`);
+            }
+            const out = { success: true, linkageId, name: after.name, state: after.state, effect: wfEffectLabel(after.effect), events: after.triggers };
             console.log(opts.json ? JSON.stringify(out, null, 2)
-                : `函数联动已更新: [${linkageId}] ${after.name} (${after.state ? '启用' : '停用'})  ${wfEffectLabel(after.effect)} / ${after.eventNames.join('、')} ← ${after.triggerNames.join('、')}`);
+                : `函数联动已更新: [${linkageId}] ${after.name} (${after.state ? '启用' : '停用'})  ${wfEffectLabel(after.effect)} / ${formatTriggerLine(after)}`);
         }
         catch (e) {
             console.error(`更新函数联动失败: ${e.message}`);
@@ -2478,6 +2689,17 @@ function readExpressionArg(raw) {
         throw new Error(`读取表达式文件失败: ${v.slice(1)}（${e?.message || e}）`);
     }
 }
+/** 「联动出的值继续触发联动」：on=1 / off=0。 */
+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;
+    throw new Error('--fission 只接受 on / off');
+}
 /** 生效维度的可读写法：当前表单 / 表单布局（布局名）/ 当前工作流（流程名【V1】）/ 选择节点（节点名）。 */
 function wfEffectLabel(e) {
     if (!e || e.effectType === 'form')