weaver-e10-builder 1.0.2-beta

package/dist/commands/workflow.js

@@ -0,0 +1,2359 @@
+import { AuthSession } from '../core/auth.js';
+import { ApiClient } from '../core/client.js';
+import { resolveSourceForm, fetchEbField } from '../services/action-detail.js';
+/**
+ * Generate a negative temporary ID for saveAddActionList new items.
+ * The API requires negative IDs for new items that haven't been persisted yet.
+ */
+export function tempIdNeg() {
+    return String(-Date.now() * 1000 - Math.floor(Math.random() * 10000));
+}
+/**
+ * Normalize a row returned by getAddActionDataList into the write format
+ * expected by saveAddActionList.
+ *
+ * The read format differs from the write format and MUST NOT be re-sent verbatim:
+ * - actionType=2: read `actionData` lacks paramsSet/sysCustomAction/id and carries
+ *   isSetLocale; `async` is boolean false (write needs 0); extra fields hasRule/
+ *   pubAction/sync/syncTime/objId/actionSelect are present.
+ * - actionType=0: targetValue/firstValue/operatorValue/customValue are nested under
+ *   `fieldMappingData`; flat versions, dateRule, isCreate, dateRuleStr are dropped.
+ *
+ * Re-sending the raw read format corrupts the node: the save itself returns 200 but
+ * every subsequent getAddActionDataList/saveAddActionList returns 500 (the server
+ * loads the broken rows on every later call). The node then becomes unrecoverable
+ * through the API. So every existing row must be normalized before being merged
+ * back into a save payload.
+ */
+export function normalizeActionRow(row) {
+    if (!row || typeof row !== 'object')
+        return row;
+    if (row.actionType === 2) {
+        const actionSet = row.actionData?.actionSet || [];
+        const out = {
+            id: row.id,
+            actionName: row.actionName,
+            open: row.open,
+            actionId: row.actionId,
+            esbName: row.esbName || row.actionName,
+            customName: row.customName || '',
+            actionType: 2,
+            actionData: {
+                actionSelect: row.actionData?.actionSelect || '1',
+                sysCustomAction: [],
+                paramsSet: actionSet.map((a) => ({
+                    id: a.id, name: a.name,
+                    eventType: a.eventType || 'WorkflowTrigger',
+                    interfaceCreate: false, isKeepDiary: 1,
+                })),
+                actionSet,
+                actionName: '',
+                id: row.id,
+                customDataId: '',
+            },
+            async: 0,
+            triggerType: row.triggerType,
+            order: row.order,
+        };
+        if (row.executeTime)
+            out.executeTime = row.executeTime;
+        return out;
+    }
+    if (row.actionType === 0) {
+        const fm = row.fieldMappingData || row;
+        return {
+            id: row.id,
+            actionName: row.actionName,
+            executeTime: row.executeTime || ['1'],
+            open: row.open,
+            async: 0,
+            actionType: 0,
+            dateRuleStr: row.dateRuleStr || '',
+            triggerType: row.triggerType,
+            order: row.order,
+            targetValue: fm.targetValue,
+            firstValue: fm.firstValue,
+            operatorValue: fm.operatorValue || '',
+            secondValue: fm.secondValue || '',
+            customValue: fm.customValue,
+            dateRule: row.dateRule || [],
+            isCreate: row.isCreate ?? false,
+        };
+    }
+    return row;
+}
+export function registerWorkflowCommands(program) {
+    const wf = program.command('workflow').description('流程管理');
+    wf.command('create')
+        .description('创建流程（自动设置所有人可发起）')
+        .argument('<appId>', '应用 ID')
+        .argument('<formObjId>', '表单 objId')
+        .argument('<name>', '流程名称')
+        .argument('[desc]', '流程描述', '')
+        .option('--no-menu', '不自动添加发起菜单（默认建流程后自动加，指向表单新建页）')
+        .action(async (appId, formObjId, name, desc, 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();
+        // objId → formId
+        const formInfo = await client.get(`${baseUrl}/api/ebuilder/form/obj/getInfo/${formObjId}`);
+        const realFormId = formInfo?.data?.formId || '';
+        if (!realFormId) {
+            console.error(`错误: 无法获取 formId，传入的是 objId=${formObjId}`);
+            process.exit(1);
+        }
+        console.error(`  objId ${formObjId} -> formId ${realFormId}`);
+        // Create workflow
+        const ts = Date.now();
+        const payload = {
+            workflowDescMultiLang: { tablefiled: 'wfp_base.workflowdesc', targetId: String(ts + 1), needReplaceTargetId: true },
+            createClient: '0', ebFormId: realFormId, createPcShow: ['0'], wfSymbol: '',
+            orderId: '0.0', moduleCard: 0, createType: '0', workflowName: name,
+            workflowDesc: desc, relateForm: '4', isLock: '0', isFree: '0',
+            addDefaultHide: 0, createPcShowCustom: '', workflowType: '-1', id: '0',
+            workflowNameMultiLang: { tablefiled: 'wfp_base.workflowname', targetId: String(ts), needReplaceTargetId: true },
+            createMobileShowCustom: '', status: '1', createMobileShow: ['0'],
+            formMode: '0', formId: 0, relateFormMode: '0', workflowId: -1,
+            isCreate: 1, workflowNameCurrenLangData: name, source: 'ebuilderCreate',
+            messageParams: { appId, groupId: '-1', sourceType: 'BACK' },
+            copyForm: 0, pathManage: 0, subCompanyId: 0, helpDoc: 0,
+            relateType: '', externalForm: 0, belongType: 1,
+        };
+        const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/baseSet/addForm`, payload);
+        // 成功哨兵：code=200, status=true, data.workflowId 存在且不为 "-1"
+        // 注意：不能用 data.id（可能为 "0"），必须取 data.workflowId
+        const workflowId = data?.data?.workflowId || '';
+        if (data?.code !== 200 || !data?.status || workflowId === '-1' || !workflowId) {
+            console.error(`创建失败: ${data?.data?.msg || data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        console.error(`流程已创建，ID: ${workflowId}`);
+        // 文档要求：创建后立即 getBaseInfoList 回读验证
+        try {
+            const verify = await client.post(`${baseUrl}/api/bs/workflow/pathdef/baseSet/getBaseInfoList`, {
+                belongType: 1, current: 1, pageSize: 1, isTemplate: 0,
+                searchParams: {
+                    quickSearchDatas: { workflowName: name },
+                    searchDatas: { workflowNameCondition: 'in', workflowTypeCondition: 'in', formType: 'all', formCondition: 'in', status: '0', subCompanyIdCondition: 'in', type: 'and' },
+                    otherSearchDatas: { workflowType: '', workflowId: '', subCompanyId: '' },
+                },
+            });
+            const vlist = verify?.data?.list || verify?.data?.data || [];
+            const found = vlist.find((w) => String(w.id || w.workflowId) === String(workflowId));
+            if (!found) {
+                console.error(`回读警告: getBaseInfoList 未找到 workflowId=${workflowId}`);
+            }
+        }
+        catch { /* 回读失败不阻塞 */ }
+        // Auto-set initiator permission
+        try {
+            const nodes = await client.get(`${baseUrl}/api/bs/workflow/pathdef/nodeBase/getNodeAndLinkId?type=all&workflowId=${workflowId}`);
+            const nodeId = nodes?.data?.[0];
+            if (nodeId) {
+                const rg = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/getLayoutConfigInfo`, {
+                    groupId: '', workflowId, nodeId, sourceType: '1', isOperatorRuleAuth: true,
+                });
+                const rgid = rg?.data?.reserveGroupId || '';
+                if (rgid) {
+                    await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/saveOperatorGroup`, {
+                        workflowId, nodeId, groupId: '', isCreate: '1', reserveGroupId: rgid,
+                        itemDatas: [{
+                                level: '0~100', isOut: false, isSaveHrmOperator: false,
+                                id: '1', groupType: '    ', itemName: '', itemLevel: '0~100',
+                                endApprovers: '', hrmOperators: '', levelObj: '',
+                                workflowId, nodeId, conditionId: '', orders: '0.00',
+                                groupTypeId: '110', isOpen: true, bigTypeId: 1,
+                                condition: '', groupCondition: '', isSuportVirtualId: true,
+                                openProjectOrganization: false, isExtendType: 0,
+                            }],
+                        oldGroupName: '', refWorkflowId: '', oldItemDatas: [],
+                        groupName: '', deleteDatas: [], mustreview: 0,
+                    });
+                    console.error('  已设置所有人可发起');
+                }
+            }
+        }
+        catch {
+            console.error('  警告: 无法自动设置发起权限，请手动设置');
+        }
+        const workflowUrl = `${baseUrl}/sp/workflow/flowpage/create/${workflowId}`;
+        // Auto-add 发起 menu (LAYOUT → form create page, triggers bound workflow)
+        let menuId = null;
+        if (cmdOpts.menu !== false) {
+            try {
+                const { addFormStartMenu } = await import('./menu.js');
+                menuId = await addFormStartMenu(client, baseUrl, appId, formObjId, name);
+                console.error(`  发起菜单已添加${menuId ? ` (id=${menuId})` : ''}`);
+            }
+            catch (e) {
+                console.error(`  发起菜单添加失败: ${e.message}（可用 \`e10-cli menu add-start ${appId} ${formObjId}\` 手动补加）`);
+            }
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ workflowId, name, url: workflowUrl, menuId }));
+        }
+        else {
+            console.log(`流程入口: ${workflowUrl}`);
+        }
+    });
+    wf.command('list')
+        .description('列出应用下的所有流程')
+        .argument('<appId>', '应用 ID')
+        .option('--out <file>', '将 JSON 输出写入文件（UTF-8）')
+        .action(async (appId, 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 data = await client.post(`${baseUrl}/api/bs/ebuilder/flow/approval/getApprovalListDatasByAppId?apid=${appId}&cid=${appId}`, { appId, viewType: '', sortParams: [], searchParamData: {} }, { ebbusinessid: '10000000000000000' });
+        if (data?.code !== 200 || !data?.data?.data) {
+            console.error(`查询失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const workflows = data.data.data.map((w) => ({
+            workflowId: w.workflowid || '',
+            name: w.workflowname || '',
+            formName: w.dataset?.text || '',
+            formId: w.formid || '',
+            objId: w.objId || '',
+            status: w.status === '1' ? '启用' : '停用',
+            createTime: w.createTime || '',
+        }));
+        if (cmdOpts?.out) {
+            const { writeFileSync } = await import('fs');
+            writeFileSync(cmdOpts.out, JSON.stringify({ workflows }, null, 2), 'utf-8');
+            console.error(`已写入: ${cmdOpts.out}`);
+        }
+        else if (opts.json) {
+            console.log(JSON.stringify({ workflows }, null, 2));
+        }
+        else {
+            console.log(`共 ${workflows.length} 个流程:\n`);
+            for (const w of workflows) {
+                console.log(`  ${w.workflowId}  ${w.name.padEnd(20)} ${w.status}  表单: ${w.formName}`);
+            }
+        }
+    });
+    wf.command('search')
+        .description('按名称/ID 搜索工作流（不依赖应用 ID，通用搜索）')
+        .option('--name <keyword>', '工作流名称（模糊匹配）')
+        .option('--id <workflowId>', '精确工作流 ID')
+        .option('--type <typeId>', '工作流类型 ID')
+        .option('--belong <n>', '所属类型: 0=个人, 1=团队', '1')
+        .option('--page-size <n>', '每页条数', '20')
+        .option('--page-no <n>', '页码', '1')
+        .action(async (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 body = {
+            isTemplate: 0,
+            belongType: parseInt(cmdOpts.belong) || 1,
+            current: parseInt(cmdOpts.pageNo) || 1,
+            pageSize: parseInt(cmdOpts.pageSize) || 20,
+            searchParams: {
+                searchDatas: { type: 'and', status: '0', formType: 'all' },
+                quickSearchDatas: {},
+                otherSearchDatas: {},
+            },
+        };
+        if (cmdOpts.name)
+            body.searchParams.quickSearchDatas.workflowName = cmdOpts.name;
+        if (cmdOpts.id)
+            body.searchParams.otherSearchDatas.workflowId = cmdOpts.id;
+        if (cmdOpts.type)
+            body.searchParams.otherSearchDatas.workflowType = cmdOpts.type;
+        const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/baseSet/getBaseInfoList`, body);
+        if (data?.code !== 200 || !data?.status) {
+            console.error(`查询失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const records = data?.data?.data || [];
+        const total = data?.data?.total || 0;
+        if (opts.json) {
+            console.log(JSON.stringify({ total, current: data?.data?.current, pageSize: data?.data?.pageSize, records }, null, 2));
+        }
+        else {
+            console.log(`共 ${total} 个工作流 (第 ${data?.data?.current || 1} 页):\n`);
+            for (const r of records) {
+                const statusLabel = r.status === '1' ? '启用' : r.status === '5' ? '停用' : r.status || '-';
+                console.log(`  ${r.id}  ${(r.workflowName || '').padEnd(24)} ${statusLabel}  ${r.typeName || ''}  ${r.subCompanyName || ''}`);
+            }
+        }
+    });
+    wf.command('nodes')
+        .description('查看流程节点详情')
+        .argument('<workflowId>', '流程 ID')
+        .option('--out <file>', '将 JSON 输出写入文件（UTF-8）')
+        .option('--mode <mode>', '展示模式: chart(默认, 流程图XML) / list(节点编辑列表, 含分流/合流/属性)', 'chart')
+        .action(async (workflowId, 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();
+        // --mode list: use getNodeEditTable (list-based, richer info)
+        if (cmdOpts.mode === 'list') {
+            const nodeData = await client.get(`${baseUrl}/api/bs/workflow/pathdef/nodeBase/getNodeEditTable?workflowId=${workflowId}`);
+            if (nodeData?.code !== 200 || !nodeData?.status) {
+                console.error(`查询失败: ${nodeData?.msg || '未知错误'}`);
+                process.exit(1);
+            }
+            const nodes = nodeData?.data?.data || [];
+            const nodeTypeLabels = {
+                '0': '发起', '1': '审批', '2': '确认', '3': '结束',
+                '5': '投票', '7': '自动处理', '8': '等待',
+                'forkstart': '分流点', 'forkend': '合流点',
+            };
+            const mergeLabels = { '0': '全部分支', '1': '指定分支', '2': '分支数', '3': '比例' };
+            if (cmdOpts?.out) {
+                const { writeFileSync } = await import('fs');
+                writeFileSync(cmdOpts.out, JSON.stringify({ nodes, formItemProps: nodeData?.data?.formItemProps }, null, 2), 'utf-8');
+                console.error(`已写入: ${cmdOpts.out}`);
+            }
+            else if (opts.json) {
+                console.log(JSON.stringify({ nodes }, null, 2));
+            }
+            else {
+                console.log(`共 ${nodes.length} 个节点:\n`);
+                for (const n of nodes) {
+                    const typeLabel = nodeTypeLabels[n.nodeType] || n.nodeType;
+                    const attr = n.nodeAttr && n.nodeAttr !== '0' ? ` attr=${n.nodeAttr}` : '';
+                    const merge = n.mergeType != null ? ` 合流:${mergeLabels[n.mergeType] || n.mergeType}` : '';
+                    console.log(`  ${n.id}  ${(n.nodeName || '').padEnd(20)} ${typeLabel}${attr}${merge}`);
+                }
+            }
+            return;
+        }
+        const data = await client.postForm(`${baseUrl}/api/bs/workflow/pathdef/chart/getXml`, `workflowId=${workflowId}&keepTitle=undefined&showType=0`);
+        if (data?.code !== 200) {
+            console.error(`查询失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const xml = data?.data?.xml || '';
+        if (!xml) {
+            console.error('该流程没有 XML 数据');
+            process.exit(1);
+        }
+        // Parse nodes and links from mxGraph XML
+        const nodeMap = new Map();
+        const links = [];
+        const nodeIdToRef = new Map(); // nodeId → node ref (node_xxx)
+        // Extract node cells: vertex="1" with nodeId (root cells have no nodeId)
+        const nodeRe = /<mxCell\s[^>]*nodeId="([^"]*)"[^>]*>/g;
+        for (const match of xml.matchAll(nodeRe)) {
+            const tag = match[0];
+            const nodeId = match[1]; // captured from regex
+            const value = tag.match(/value="([^"]*)"/)?.[1] || '';
+            const nodeType = tag.match(/nodeType="([^"]*)"/)?.[1] || '';
+            const operator = tag.match(/operatorNameStr="([^"]*)"/)?.[1] || '';
+            const id = tag.match(/id="([^"]*)"/)?.[1] || ''; // node_xxx ref
+            const nodeName = value || '(未命名)';
+            nodeMap.set(nodeId, { name: nodeName, type: nodeType, operator });
+            if (id)
+                nodeIdToRef.set(nodeId, id);
+        }
+        // Extract link cells: edge="1"
+        const linkRe = /<mxCell\s[^>]*edge="1"[^>]*>/g;
+        for (const match of xml.matchAll(linkRe)) {
+            const tag = match[0];
+            const linkId = tag.match(/linkId="([^"]*)"/)?.[1] || '';
+            const source = tag.match(/source="([^"]*)"/)?.[1] || '';
+            const target = tag.match(/target="([^"]*)"/)?.[1] || '';
+            const label = tag.match(/linkNameInputValue="([^"]*)"/)?.[1] || '';
+            const hasCondition = tag.match(/hasCondition="([^"]*)"/)?.[1] || '0';
+            // Resolve source/target from node ref (node_xxx) to nodeId
+            const sourceNodeId = [...nodeIdToRef.entries()].find(([, ref]) => ref === source)?.[0] || source;
+            const targetNodeId = [...nodeIdToRef.entries()].find(([, ref]) => ref === target)?.[0] || target;
+            links.push({ linkId, source: sourceNodeId, target: targetNodeId, label, condition: hasCondition });
+        }
+        // Build ordered node list following links
+        const visited = new Set();
+        const ordered = [];
+        // Find start node (source not present as target of any link, or nodeType=0)
+        const targetIds = new Set(links.map(l => l.target));
+        const startNodeId = [...nodeMap.keys()].find(id => {
+            const n = nodeMap.get(id);
+            return n.type === '0' || !targetIds.has(id);
+        });
+        if (startNodeId) {
+            const queue = [startNodeId];
+            while (queue.length > 0) {
+                const cur = queue.shift();
+                if (visited.has(cur))
+                    continue;
+                visited.add(cur);
+                ordered.push(cur);
+                for (const l of links.filter(l => l.source === cur)) {
+                    if (!visited.has(l.target))
+                        queue.push(l.target);
+                }
+            }
+        }
+        // Remaining unvisited nodes
+        for (const nodeId of nodeMap.keys()) {
+            if (!visited.has(nodeId))
+                ordered.push(nodeId);
+        }
+        const TYPE_LABELS = {
+            '0': '发起',
+            '1': '审批',
+            '2': '分支',
+            '3': '归档',
+            '4': '抄送',
+        };
+        const nodesJson = ordered.map(nodeId => {
+            const n = nodeMap.get(nodeId);
+            return { nodeId, name: n.name, type: n.type, typeLabel: TYPE_LABELS[n.type] || n.type, operator: n.operator };
+        });
+        const jsonOutput = JSON.stringify({ nodes: nodesJson, links }, null, 2);
+        if (cmdOpts?.out) {
+            const { writeFileSync } = await import('fs');
+            writeFileSync(cmdOpts.out, jsonOutput, 'utf-8');
+            console.error(`已写入: ${cmdOpts.out}`);
+        }
+        else if (opts.json) {
+            console.log(jsonOutput);
+        }
+        else {
+            const wfName = data?.data?.workflowDatas?.workflowName || workflowId;
+            console.log(`流程: ${wfName}`);
+            console.log(`共 ${nodeMap.size} 个节点, ${links.length} 条连线:\n`);
+            for (let i = 0; i < ordered.length; i++) {
+                const nodeId = ordered[i];
+                const n = nodeMap.get(nodeId);
+                const typeLabel = TYPE_LABELS[n.type] || n.type;
+                const op = n.operator ? ` [${n.operator}]` : '';
+                console.log(`  ${i + 1}. ${n.name}`);
+                console.log(`     ${nodeId}  ${typeLabel}${op}`);
+            }
+        }
+    });
+    wf.command('set-operator')
+        .description('设置审批节点的操作者')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<nodeId>', '节点 ID')
+        .argument('[keyword]', '人员/角色关键词（--type form 时不需要）', '')
+        .option('--type <type>', '操作者类型: user(指定人) / role(指定角色) / dept(指定部门) / position(指定岗位) / all(所有人) / free(自由选择) / superior(发起人上级) / prev-node(上一节点) / form(表单相关人员) / matrix(矩阵对应)', 'user')
+        .option('--source <formObjId>', '表单 ID（--type form 时必填）')
+        .option('--target <fieldId>', '人员字段 ID（--type form 时必填）')
+        .option('--condition <json>', '筛选条件 JSON / @文件（--type form 时可选）')
+        .option('--sign-order <order>', '签署顺序: 会签(默认) / 非会签 / 竞签 / 依次处理 / 抄送 / 抄送需批注', '会签')
+        .option('--orders <orders>', '批次号（两位小数，如 0.00 / 1.00）', '0.00')
+        .option('--workflow-form <objId>', '流程绑定的表单 objId（valueFieldId 引用字段时在此表单查找）')
+        .option('--matrix-id <id>', '矩阵 ID（--type matrix 必填）')
+        .option('--value-config-id <id>', '值字段 configId，即矩阵列的字段 ID（--type matrix 必填）')
+        .option('--matrix-rule <rules...>', '矩阵条件映射规则。格式: "条件configId:数据来源type:匹配operate:维度virtualId"。type: 0=指定部门/1=发起人部门/5=当前操作人部门。operate: 1=本部门/2=本及下级/3=本及上级/49=逐级向上/67=本及下级逐级向上')
+        .option('--batch-condition <expr>', '批次条件表达式（--type matrix 可选）')
+        .option('--append', '追加操作者组（不清空节点已有操作者组；默认是清空后全量重建）')
+        .action(async (workflowId, nodeId, keyword, 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();
+        // 追加模式（--append）下提示语用「追加」，否则「设置」
+        const verb = cmdOpts.append ? '已追加操作者组' : '已设置操作者';
+        // 0. 清理节点已有的操作者组（防止重复设置堆积多组，全量重建）。
+        //    --append 时跳过清理：新组追加到已有组之后（如 部门领导矩阵 + 门店经理矩阵 双组会签）。
+        if (!cmdOpts.append) {
+            const { clearNodeOperatorGroups } = await import('../services/workflow-operator.js');
+            try {
+                const cleared = await clearNodeOperatorGroups(client, baseUrl, workflowId, nodeId);
+                if (cleared > 0)
+                    console.error(`  已清理 ${cleared} 个旧操作者组`);
+            }
+            catch { /* 无旧组或读取失败则跳过 */ }
+        }
+        const isRole = cmdOpts.type === 'role';
+        // 1. Search for user or role
+        let targetId = '';
+        let targetName = '';
+        let browserData;
+        let browserDatas = [];
+        let groupType;
+        let groupTypeId;
+        let itemName;
+        let itemLevel = '';
+        let includeType = '';
+        let includeTypeCN = '';
+        const isSuperior = cmdOpts.type === 'superior';
+        if (isSuperior) {
+            // Superior type: no keyword needed, fixed fields
+            targetId = '';
+            targetName = '直接上级';
+            groupType = '流程发起人';
+            groupTypeId = '114';
+            itemName = '直接上级';
+            // Build payload directly — superior has no browserData
+            console.error(`  操作者: 发起人上级 (直接上级) 类型: ${groupType}`);
+            const rg = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/getLayoutConfigInfo`, {
+                groupId: '', workflowId, nodeId, sourceType: '1', isOperatorRuleAuth: true,
+            });
+            const reserveGroupId = rg?.data?.reserveGroupId || '';
+            const payload = {
+                workflowId, nodeId, groupId: '', isCreate: '', reserveGroupId,
+                itemDatas: [{
+                        includeType: '13',
+                        includeTypeCN: '上级',
+                        objLevelType: '1',
+                        objLevelTypeCN: '全部机构',
+                        objectId: '1',
+                        objectIdCN: '直接上级',
+                        signOrder: '1',
+                        signOrderCN: '会签',
+                        isOut: false,
+                        isSaveHrmOperator: false,
+                        id: '1',
+                        groupType,
+                        itemName,
+                        itemLevel: '',
+                        endApprovers: '',
+                        hrmOperators: '',
+                        levelObj: '',
+                        workflowId, nodeId,
+                        conditionId: '',
+                        orders: '0.00',
+                        groupTypeId,
+                        isOpen: true,
+                        bigTypeId: 1,
+                        condition: '',
+                        groupCondition: '',
+                        level: '',
+                        isSuportVirtualId: false,
+                        openProjectOrganization: false,
+                        isExtendType: 0,
+                    }],
+                oldGroupName: '',
+                refWorkflowId: '',
+                oldItemDatas: [],
+                groupName: '',
+                deleteDatas: [],
+                mustreview: 0,
+            };
+            const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/saveOperatorGroup`, payload);
+            if (data?.code === 200 && data?.status) {
+                const msg = opts.json
+                    ? JSON.stringify({ success: true, workflowId, nodeId, operator: '直接上级', type: groupType, append: !!cmdOpts.append })
+                    : `${verb}: 发起人上级(直接上级) → 节点 ${nodeId}`;
+                console.log(msg);
+            }
+            else {
+                console.error(`设置失败: ${data?.msg || '未知错误'}`);
+                process.exit(1);
+            }
+            return;
+        }
+        const isForm = cmdOpts.type === 'form';
+        if (isForm) {
+            // --type form: 从表单数据中动态获取相关人员
+            if (!cmdOpts.source || !cmdOpts.target) {
+                console.error('--type form 需要 --source <表单ID> 和 --target <人员字段ID>');
+                process.exit(1);
+            }
+            // Parse optional condition
+            let ebFormCondition = {};
+            let ebFormConditionCn = '';
+            if (cmdOpts.condition) {
+                let condStr = cmdOpts.condition;
+                if (condStr.startsWith('@')) {
+                    const { readFileSync: rfs, existsSync: exs } = await import('fs');
+                    const fp = condStr.slice(1);
+                    if (!exs(fp)) {
+                        console.error(`文件不存在: ${fp}`);
+                        process.exit(1);
+                    }
+                    condStr = rfs(fp, 'utf-8');
+                }
+                const cond = JSON.parse(condStr);
+                const isFormFieldValue = !!cond.valueFieldId;
+                const funcMap = { gt: '大于', lt: '小于', eq: '等于', gte: '大于等于', lte: '小于等于', like: '包含' };
+                // Need field list to resolve valueFieldId
+                // Determine which form to look up valueFieldId in:
+                // workflowForm (流程绑定的表单) takes priority, fallback to source (矩阵表单)
+                const lookupFormObjId = cmdOpts.workflowForm || cmdOpts.source;
+                let allSrcFields = [];
+                if (isFormFieldValue) {
+                    try {
+                        const srcFields = await client.post(`${baseUrl}/api/ebuilder/form/dataset/v1/getFields`, {
+                            objId: lookupFormObjId, userid: auth.userId, tenantKey: auth.tenantKey,
+                        });
+                        allSrcFields = [...(srcFields?.data?.mainFields || []), ...(srcFields?.data?.subFields || [])];
+                    }
+                    catch { /* ignore */ }
+                }
+                // Build conditions object
+                let conditions;
+                let valueDesc;
+                if (isFormFieldValue) {
+                    const refField = allSrcFields.find((f) => f.fieldId === cond.valueFieldId || f.id === cond.valueFieldId);
+                    if (!refField) {
+                        console.error(`未找到引用字段: ${cond.valueFieldId}（在表单 ${lookupFormObjId} 中）`);
+                        process.exit(1);
+                    }
+                    const ffType = refField.fieldType || refField.type || 'Text';
+                    const ffId = refField.fieldId || refField.id || '';
+                    const fmk = {
+                        id: ffId,
+                        text: refField.fieldName || refField.name || '',
+                        type: ffType,
+                        compType: ffType,
+                        formInfo: { fieldId: ffId },
+                        objId: lookupFormObjId,
+                        name: refField.dataKey || refField.columnName || '',
+                        showName: refField.fieldName || refField.name || '',
+                        multiSelect: refField.multiSelect || 'false',
+                        mainField: true,
+                        module: '',
+                        parseMark: true,
+                        usage: '',
+                        subTableId: '',
+                        lazyLoad: false,
+                        fieldClassification: '',
+                        browserType: '',
+                        optionType: '',
+                        disAllowedUsage: [],
+                        mainPrimaryKey: false,
+                        deleteType: false,
+                        parentId: '',
+                        physicalField: '',
+                        placeholderMark: false,
+                        dbFieldType: '',
+                        richEditor: false,
+                        describe: '',
+                        changeTrigger: '1',
+                        browserParams: {
+                            formId: '', layoutId: '',
+                            serviceModule: 'ebuilderform',
+                            fieldId: ffId,
+                        },
+                    };
+                    if (ffType === 'Employee') {
+                        fmk.conditionType = [
+                            { id: 'in', content: '属于', disabled: false },
+                            { id: 'notIn', content: '不属于', disabled: false },
+                        ];
+                    }
+                    conditions = {
+                        func: cond.func || 'eq',
+                        value: { compareFormField: fmk },
+                        type: 'formField',
+                        filterValueType: ffType,
+                        text: { compareFormField: { ...fmk } },
+                        isEsb: false,
+                    };
+                    valueDesc = refField.fieldName || refField.name || cond.valueFieldId;
+                }
+                else {
+                    conditions = {
+                        func: cond.func || 'gt',
+                        value: String(cond.value || ''),
+                        type: '',
+                        text: '',
+                        isEsb: false,
+                    };
+                    valueDesc = String(cond.value || '');
+                }
+                // Build ebFormCondition from simplified condition
+                const condKey = String(Date.now());
+                ebFormCondition = {
+                    key: condKey,
+                    relationship: '1',
+                    isParent: true,
+                    isNewFilter: true,
+                    parentNode: '',
+                    datas: [{
+                            isParent: false,
+                            parentNode: condKey,
+                            id: cond.fieldId,
+                            fieldName: cond.fieldId,
+                            fieldType: cond.fieldType || 'Text',
+                            optionType: '',
+                            text: cond.fieldName || cond.fieldId,
+                            objId: cmdOpts.source,
+                            compType: (cond.fieldType === 'Number' || cond.fieldType === 'Money') ? 'NumberComponent' : 'TextComponent',
+                            type: 'condition',
+                            conditions,
+                            multiSelect: 'false',
+                            formInfo: { fieldId: cond.fieldId },
+                            originBrowserType: '',
+                            module: '',
+                            mainField: true,
+                            subTableId: '',
+                            key: String(Date.now()),
+                            config: { fieldId: cond.fieldId },
+                        }],
+                    version: 1,
+                    filterIsNull: true,
+                };
+                ebFormConditionCn = `( ${cond.fieldName || cond.fieldId} ${funcMap[cond.func] || cond.func} '${valueDesc}' )`;
+            }
+            const signOrder = cmdOpts.signOrder === '或签' ? '2' : '1';
+            const signOrderCN = cmdOpts.signOrder === '或签' ? '或签' : '会签';
+            // Try to get form name and field name via API
+            let sourceIdCN = '';
+            let targetIdCN = '';
+            try {
+                const formFields = await client.post(`${baseUrl}/api/ebuilder/form/dataset/v1/getFields`, {
+                    objId: cmdOpts.source, userid: auth.userId, tenantKey: auth.tenantKey,
+                });
+                const allFields = [...(formFields?.data?.mainFields || []), ...(formFields?.data?.subFields || [])];
+                const targetField = allFields.find((f) => f.fieldId === cmdOpts.target || f.id === cmdOpts.target);
+                if (targetField) {
+                    targetIdCN = targetField.fieldName || targetField.name || '';
+                }
+                // Try to get form name from app list or form list — skip for now, not critical
+            }
+            catch { /* ignore */ }
+            console.error(`  操作者: 表单相关人员 source=${cmdOpts.source} target=${cmdOpts.target} ${ebFormConditionCn || '(无筛选)'}`);
+            const rg = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/getLayoutConfigInfo`, {
+                groupId: '', workflowId, nodeId, sourceType: '1', isOperatorRuleAuth: true,
+            });
+            const reserveGroupId = rg?.data?.reserveGroupId || '';
+            const itemData = {
+                signOrder,
+                signOrderCN,
+                isOut: false,
+                isSaveHrmOperator: false,
+                id: '1',
+                groupType: 'EB表单相关(人员基础数据)',
+                itemName: targetIdCN || cmdOpts.target,
+                itemLevel: '',
+                endApprovers: '',
+                hrmOperators: '',
+                levelObj: '',
+                workflowId, nodeId,
+                conditionId: '',
+                orders: '0.00',
+                groupTypeId: '1201',
+                isOpen: true,
+                bigTypeId: 12,
+                sourceId: cmdOpts.source,
+                sourceIdCN: sourceIdCN || cmdOpts.source,
+                targetId: cmdOpts.target,
+                targetIdCN: targetIdCN || cmdOpts.target,
+                ebFormCondition,
+                ebFormConditionCn,
+                condition: '',
+                groupCondition: '',
+                isSuportVirtualId: true,
+                openProjectOrganization: false,
+                isExtendType: 0,
+            };
+            const payload = {
+                workflowId, nodeId, groupId: '', isCreate: '', reserveGroupId,
+                itemDatas: [itemData],
+                oldGroupName: '',
+                refWorkflowId: '',
+                oldItemDatas: [],
+                groupName: '',
+                deleteDatas: [],
+                mustreview: 0,
+            };
+            const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/saveOperatorGroup`, payload);
+            if (data?.code === 200 && data?.status) {
+                const msg = opts.json
+                    ? JSON.stringify({ success: true, workflowId, nodeId, type: 'form', source: cmdOpts.source, target: cmdOpts.target, append: !!cmdOpts.append })
+                    : `${verb}: 表单相关人员 → 节点 ${nodeId} (${targetIdCN || cmdOpts.target})`;
+                console.log(msg);
+            }
+            else {
+                console.error(`设置失败: ${data?.msg || '未知错误'}`);
+                process.exit(1);
+            }
+            return;
+        }
+        // New types from Phase 4: dept / position / all / free / prev-node
+        if (cmdOpts.type === 'dept' || cmdOpts.type === 'position' || cmdOpts.type === 'all' || cmdOpts.type === 'free' || cmdOpts.type === 'prev-node') {
+            let groupType = '';
+            let groupTypeId = '';
+            let itemName = '';
+            const itemData = {};
+            if (cmdOpts.type === 'dept') {
+                if (!keyword) {
+                    console.error('--type dept 需要部门关键词');
+                    process.exit(1);
+                }
+                const deptRes = await client.post(`${baseUrl}/api/workflow/pathdef/common/browser/complete/department`, {
+                    browserMultiple: true, virtualType: 'All', showSanYuan: true, newly: 0, searchValue: keyword,
+                });
+                const dept = deptRes?.data?.data?.[0];
+                if (!dept) {
+                    console.error(`未找到部门: ${keyword}`);
+                    process.exit(1);
+                }
+                groupType = '指定部门';
+                groupTypeId = '102';
+                itemName = dept.name || keyword;
+                itemData.hrmOperators = dept.id || '';
+                itemData.hrmOperatorsCN = dept.name || '';
+                itemData.includeType = '2';
+                itemData.includeTypeCN = '本部门及下级部门';
+                itemData.level = '10~90';
+                itemData.itemLevel = '10~90';
+                itemData.hrmBrowserDataDtos = [{ id: dept.id, name: dept.name, _entityType: 'department' }];
+                console.error(`  操作者: ${dept.name} (${dept.id})  类型: 指定部门(包含下级)`);
+            }
+            else if (cmdOpts.type === 'position') {
+                if (!keyword) {
+                    console.error('--type position 需要岗位关键词');
+                    process.exit(1);
+                }
+                const posRes = await client.post(`${baseUrl}/api/workflow/pathdef/common/browser/complete/position`, {
+                    browserMultiple: true, newly: 0, searchValue: keyword,
+                });
+                const pos = posRes?.data?.data?.[0];
+                if (!pos) {
+                    console.error(`未找到岗位: ${keyword}`);
+                    process.exit(1);
+                }
+                groupType = '指定岗位';
+                groupTypeId = '105';
+                itemName = pos.name || keyword;
+                itemData.hrmOperators = pos.id || '';
+                itemData.hrmOperatorsCN = pos.name || '';
+                itemData.objLevelType = '1';
+                itemData.objLevelTypeCN = '全部机构';
+                itemData.hrmBrowserDataDtos = [{ id: pos.id, name: pos.name, _entityType: 'position' }];
+                console.error(`  操作者: ${pos.name} (${pos.id})  类型: 指定岗位(全部机构)`);
+            }
+            else if (cmdOpts.type === 'all') {
+                groupType = '所有人';
+                groupTypeId = '110';
+                itemName = '所有人';
+                itemData.level = '0~100';
+                itemData.itemLevel = '0~100';
+                itemData.hrmOperators = '';
+                console.error(`  操作者: 所有人  类型: ${groupType}`);
+            }
+            else if (cmdOpts.type === 'free') {
+                groupType = '自由选择';
+                groupTypeId = '112';
+                itemName = '发起时自由选择';
+                itemData.hrmOperators = '';
+                console.error(`  操作者: 发起时自由选择  类型: ${groupType}`);
+            }
+            else if (cmdOpts.type === 'prev-node') {
+                groupType = '节点操作者';
+                groupTypeId = '115';
+                itemName = '上一节点操作者';
+                itemData.includeType = '23';
+                itemData.includeTypeCN = '[上一节点]';
+                itemData.objLevelType = '13';
+                itemData.objLevelTypeCN = '本人';
+                itemData.isLastCycle = '1';
+                itemData.isLastCycleCN = '仅最后一轮操作者';
+                itemData.hrmOperators = '';
+                console.error(`  操作者: 上一节点操作者(本人)  类型: ${groupType}`);
+            }
+            // Common fields
+            const signOrderMap = {
+                '会签': { code: '1', cn: '会签' },
+                '非会签': { code: '0', cn: '非会签' },
+                '竞签': { code: '0', cn: '非会签', competeSignOrder: '1', competeSignOrderCN: '竞签' },
+                '依次处理': { code: '2', cn: '依次处理', executeOrders: '1-1,2-2', executeOrdersCN: '安全级别-正序,人员显示顺序-倒序' },
+                '抄送': { code: '3', cn: '抄送' },
+                '抄送需批注': { code: '4', cn: '抄送' },
+            };
+            const so = signOrderMap[cmdOpts.signOrder || '会签'] || signOrderMap['会签'];
+            // Get reserveGroupId
+            const rg = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/getLayoutConfigInfo`, {
+                groupId: '', workflowId, nodeId, sourceType: '1', isOperatorRuleAuth: true,
+            });
+            const reserveGroupId = rg?.data?.reserveGroupId || '';
+            const payload = {
+                workflowId, nodeId, groupId: '', isCreate: '', reserveGroupId,
+                itemDatas: [{
+                        ...itemData,
+                        signOrder: so.code,
+                        signOrderCN: so.cn,
+                        orders: cmdOpts.orders || '0.00',
+                        isOut: false, isSaveHrmOperator: false, id: '1',
+                        groupType, itemName,
+                        endApprovers: '', levelObj: '',
+                        workflowId, nodeId, conditionId: '',
+                        groupTypeId, isOpen: true, bigTypeId: 1,
+                        condition: '', groupCondition: '',
+                        isSuportVirtualId: false, openProjectOrganization: false, isExtendType: 0,
+                        ...(so.competeSignOrder ? { competeSignOrder: so.competeSignOrder, competeSignOrderCN: so.competeSignOrderCN } : {}),
+                        ...(so.executeOrders ? { executeOrders: so.executeOrders, executeOrdersCN: so.executeOrdersCN } : {}),
+                    }],
+                oldGroupName: '', refWorkflowId: '', oldItemDatas: [],
+                groupName: '', deleteDatas: [], mustreview: 0,
+            };
+            const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/saveOperatorGroup`, payload);
+            if (data?.code === 200 && data?.status) {
+                const msg = opts.json
+                    ? JSON.stringify({ success: true, workflowId, nodeId, operator: itemName, type: groupType, append: !!cmdOpts.append })
+                    : `${verb}: ${itemName} [${groupType}] → 节点 ${nodeId}`;
+                console.log(msg);
+            }
+            else {
+                console.error(`设置失败: ${data?.msg || '未知错误'}`);
+                process.exit(1);
+            }
+            return;
+        }
+        // --type matrix: 矩阵对应操作者
+        if (cmdOpts.type === 'matrix') {
+            if (!cmdOpts.matrixId) {
+                console.error('--type matrix 需要 --matrix-id <矩阵ID>');
+                process.exit(1);
+            }
+            if (!cmdOpts.valueConfigId) {
+                console.error('--type matrix 需要 --value-config-id <值字段configId>');
+                process.exit(1);
+            }
+            // Parse matrix rules: "条件configId:数据来源type:匹配operate:维度virtualId"
+            const matrixRules = [];
+            const ruleErrors = [];
+            let matrixRuleCondition = '';
+            const condParts = [];
+            if (cmdOpts.matrixRule && cmdOpts.matrixRule.length > 0) {
+                for (const ruleStr of cmdOpts.matrixRule) {
+                    const parts = ruleStr.split(':');
+                    const sourceField = parts[0];
+                    const type = parts[1] || '0'; // 0=指定部门 1=发起人部门
+                    const operate = parts[2] || '1'; // 1=本部门
+                    const virtualId = parts[3] || '1'; // 1=行政组织
+                    const typeLabels = { '0': '指定部门', '1': '发起人部门（系统）', '5': '当前操作人部门（系统）' };
+                    const operateLabels = { '1': '本部门', '2': '本部门及下级部门', '3': '本部门及上级部门', '49': '本部门（逐级向上）', '67': '本部门及下级部门（逐级向上）' };
+                    matrixRules.push({
+                        sourceField, sourceFieldCN: '', sourceType: '', type, typeCN: typeLabels[type] || '',
+                        virtualId, virtualIdCN: virtualId === '1' ? '行政组织' : virtualId,
+                        operate: parseInt(operate) || 1, operateCN: operateLabels[operate] || '',
+                        isFieldEmpty: 0,
+                    });
+                    condParts.push(`config_${sourceField} ${operateLabels[operate] || operate}`);
+                }
+                if (ruleErrors.length > 0) {
+                    for (const e of ruleErrors)
+                        console.error(`  ❌ ${e}`);
+                    process.exit(1);
+                }
+                matrixRuleCondition = condParts.join('; ');
+            }
+            // Get reserveGroupId
+            const rg = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/getLayoutConfigInfo`, {
+                groupId: '', workflowId, nodeId, sourceType: '1', isOperatorRuleAuth: true,
+            });
+            const reserveGroupId = rg?.data?.reserveGroupId || '';
+            const signOrderMap = {
+                '会签': { code: '1', cn: '会签' }, '非会签': { code: '0', cn: '非会签' },
+            };
+            const so = signOrderMap[cmdOpts.signOrder || '会签'] || signOrderMap['会签'];
+            const batchCond = cmdOpts.batchCondition || '';
+            const conditionDesc = batchCond ? `矩阵条件：${matrixRuleCondition}\\n批次条件：${batchCond}` : `矩阵条件：${matrixRuleCondition}`;
+            const itemData = {
+                signOrder: so.code,
+                signOrderCN: so.cn,
+                isOut: false, isSaveHrmOperator: false,
+                sourceId: cmdOpts.matrixId,
+                sourceIdCN: '', sourceIdType: '2',
+                targetId: cmdOpts.valueConfigId,
+                targetIdCN: '',
+                id: '1',
+                groupType: `矩阵对应`,
+                itemName: '',
+                itemLevel: '',
+                matrixRules,
+                endApprovers: '', hrmOperators: '', levelObj: '',
+                workflowId, nodeId,
+                conditionId: '',
+                orders: cmdOpts.orders || '0.00',
+                groupTypeId: '401',
+                isOpen: true, bigTypeId: 4,
+                conditionSourceId: '-1',
+                condition: conditionDesc,
+                groupCondition: batchCond,
+                matrixRuleCondition,
+                isSuportVirtualId: true, openProjectOrganization: false, isExtendType: 0,
+            };
+            const payload = {
+                workflowId, nodeId, groupId: '', isCreate: '', reserveGroupId,
+                itemDatas: [itemData],
+                oldGroupName: '', refWorkflowId: '', oldItemDatas: [],
+                groupName: '', deleteDatas: [], mustreview: 0,
+            };
+            console.error(`  矩阵对应: matrixId=${cmdOpts.matrixId}  valueConfig=${cmdOpts.valueConfigId}  规则: ${matrixRuleCondition || '(无)'}`);
+            const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/saveOperatorGroup`, payload);
+            if (data?.code === 200 && data?.status) {
+                const msg = opts.json
+                    ? JSON.stringify({ success: true, workflowId, nodeId, type: 'matrix', matrixId: cmdOpts.matrixId, append: !!cmdOpts.append })
+                    : `${verb}（矩阵）: 矩阵 ${cmdOpts.matrixId} → 节点 ${nodeId}`;
+                console.log(msg);
+            }
+            else {
+                console.error(`设置失败: ${data?.msg || '未知错误'}`);
+                process.exit(1);
+            }
+            return;
+        }
+        if (isRole) {
+            // Search roles — keyword 支持逗号分隔多角色（组内多操作者，如竞签多候选）
+            const { findRolesByKeywords } = await import('../services/workflow-operator.js');
+            const treeData = await client.get(`${baseUrl}/api/bs/auth/role/tree?menuCode=roleSettings`);
+            if (treeData?.code !== 200) {
+                console.error('查询角色列表失败');
+                process.exit(1);
+            }
+            const roles = treeData?.data?.data || [];
+            if (!keyword.split(',').map(s => s.trim()).filter(Boolean).length) {
+                console.error('--type role 需要角色关键词');
+                process.exit(1);
+            }
+            const { found: foundList, missing } = findRolesByKeywords(roles, keyword);
+            if (missing) {
+                console.error(`未找到角色: ${missing}`);
+                process.exit(1);
+            }
+            targetId = foundList.map(f => f.id).join(',');
+            targetName = foundList.map(f => f.content).join(',');
+            browserDatas = foundList.map(f => ({
+                id: f.id,
+                name: f.content,
+                content: f.content,
+                contentDesc: '',
+                isLeaf: true,
+                icon: f.icon || 'Icon-role',
+                stopDepartment: false,
+                leaf: true,
+            }));
+            groupType = '指定角色';
+            groupTypeId = '104';
+            itemName = `${targetName}(所有级别)`;
+            itemLevel = '所有级别';
+            includeType = '51';
+            includeTypeCN = '所有级别';
+        }
+        else {
+            // Search users
+            const userData = await client.post(`${baseUrl}/api/hrm/common/getEmployeeByKeyWords`, {
+                keyword,
+                searchType: 1,
+                searchCount: 1,
+                appDetachModule: 'EM',
+                disableAppDetach: 0,
+                pageNo: 1,
+                pageSize: 1,
+            });
+            if (userData?.code !== 200 || !userData?.data?.userList?.length) {
+                console.error(`未找到人员: ${keyword}`);
+                process.exit(1);
+            }
+            const emp = userData.data.userList[0];
+            targetId = emp.id || '';
+            targetName = emp.name || '';
+            browserData = {
+                id: emp.id || '',
+                cid: emp.cid || emp.companyId || '',
+                userid: emp.userid || emp.userId || emp.id || '',
+                name: emp.name || '',
+                statusCode: emp.statusCode || 'normal',
+                content: emp.name || '',
+                title: `${emp.name || ''}|${emp.department || ''}`,
+                contentDesc: emp.name || '',
+                department: emp.department || '',
+                avatar: emp.avatar || { previewPath: '', appPreviewPath: '', name: emp.name || '', userId: emp.id || '' },
+                indexType: 'R',
+                isLeaf: true,
+                templateType: 'default',
+                originTargetType: 'user',
+                pid: '',
+                richContent: emp.name || '',
+                departmentId: emp.departmentId || emp.departmentid || '',
+                mainId: emp.mainId || emp.id || '',
+                stopDepartment: false,
+                leaf: true,
+            };
+            groupType = '指定人';
+            groupTypeId = '101';
+            itemName = emp.name || '';
+            browserDatas = [browserData];
+        }
+        console.error(`  操作者: ${targetName} (${targetId}) 类型: ${groupType}`);
+        // 2. Get reserveGroupId from layout config
+        const rg = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/getLayoutConfigInfo`, {
+            groupId: '', workflowId, nodeId, sourceType: '1', isOperatorRuleAuth: true,
+        });
+        const reserveGroupId = rg?.data?.reserveGroupId || '';
+        // 3. Build payload
+        const soMap = {
+            '会签': { code: '1', cn: '会签' },
+            '非会签': { code: '0', cn: '非会签' },
+            '竞签': { code: '0', cn: '非会签', competeSignOrder: '1', competeSignOrderCN: '竞签' },
+            '依次处理': { code: '2', cn: '依次处理', executeOrders: '1-1,2-2', executeOrdersCN: '安全级别-正序,人员显示顺序-倒序' },
+            '抄送': { code: '3', cn: '抄送' },
+            '抄送需批注': { code: '4', cn: '抄送' },
+        };
+        const so = soMap[cmdOpts.signOrder || '会签'] || soMap['会签'];
+        const itemData = {
+            hrmOperators: targetId,
+            hrmOperatorsCN: targetName,
+            signOrder: so.code,
+            signOrderCN: so.cn,
+            detailSignOrder: '0',
+            detailSignOrderCN: '',
+            organizeSignOrder: '0',
+            organizeSignOrderCN: '',
+            competeOtherView: '0',
+            competeOtherViewCN: '',
+            ...(so.competeSignOrder ? { competeSignOrder: so.competeSignOrder, competeSignOrderCN: so.competeSignOrderCN } : {}),
+            ...(so.executeOrders ? { executeOrders: so.executeOrders, executeOrdersCN: so.executeOrdersCN } : {}),
+            isOut: false,
+            isSaveHrmOperator: false,
+            id: '2',
+            groupType,
+            itemName,
+            itemLevel,
+            endApprovers: '',
+            levelObj: '',
+            workflowId, nodeId,
+            conditionId: '',
+            orders: '0.00',
+            groupTypeId,
+            isOpen: true,
+            bigTypeId: 1,
+            condition: '',
+            groupCondition: '',
+            isSuportVirtualId: false,
+            openProjectOrganization: false,
+            isExtendType: 0,
+            hrmBrowserDataDtos: browserDatas,
+        };
+        // Role-specific fields
+        if (isRole) {
+            itemData.includeType = includeType;
+            itemData.includeTypeCN = includeTypeCN;
+        }
+        const payload = {
+            workflowId, nodeId, groupId: '', isCreate: '', reserveGroupId,
+            itemDatas: [itemData],
+            oldGroupName: '',
+            refWorkflowId: '',
+            oldItemDatas: [],
+            groupName: '',
+            deleteDatas: [],
+            mustreview: 0,
+        };
+        const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeOperator/saveOperatorGroup`, payload);
+        if (data?.code === 200 && data?.status) {
+            const msg = opts.json
+                ? JSON.stringify({ success: true, workflowId, nodeId, operator: targetName, type: groupType, append: !!cmdOpts.append })
+                : `${verb}: ${targetName} [${groupType}] → 节点 ${nodeId}`;
+            console.log(msg);
+        }
+        else {
+            console.error(`设置失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    wf.command('link-list')
+        .description('查看流程出口列表（含默认/退回/条件状态）')
+        .argument('<workflowId>', '流程 ID')
+        .option('--node-id <nodeId>', '限定单个源节点（不传则展示全部出口）')
+        .option('--out <file>', '将 JSON 输出写入文件（UTF-8）')
+        .action(async (workflowId, 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 params = new URLSearchParams();
+        params.set('workflowId', workflowId);
+        if (cmdOpts.nodeId)
+            params.set('nodeId', cmdOpts.nodeId);
+        const data = await client.get(`${baseUrl}/api/bs/workflow/pathdef/nodeLink/getWfpNodeLinkTable?${params.toString()}`);
+        if (data?.code !== 200 || !data?.status) {
+            console.error(`查询失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const links = data?.data?.data || [];
+        const nodeTypeMap = data?.data?.otherParams?.nodeTypeMap || {};
+        const nodeAttrMap = data?.data?.otherParams?.nodeAttrMap || {};
+        if (cmdOpts?.out) {
+            const { writeFileSync } = await import('fs');
+            writeFileSync(cmdOpts.out, JSON.stringify({ links, nodeTypeMap, nodeAttrMap }, null, 2), 'utf-8');
+            console.error(`已写入: ${cmdOpts.out}`);
+        }
+        else if (opts.json) {
+            console.log(JSON.stringify({ links }, null, 2));
+        }
+        else {
+            console.log(`共 ${links.length} 条出口:\n`);
+            for (const l of links) {
+                const flags = [];
+                if (l.isDefault === '1')
+                    flags.push('默认');
+                if (l.isReject === '1')
+                    flags.push('退回');
+                if (l.hasCondition)
+                    flags.push('有条件');
+                const flagStr = flags.length > 0 ? ` [${flags.join(',')}]` : '';
+                console.log(`  ${l.id}  ${l.srcNodeId} → ${l.destNodeId}  ${l.linkName || '(未命名)'}${flagStr}`);
+            }
+        }
+    });
+    wf.command('generate-link-id')
+        .description('生成一个新的连线 ID')
+        .argument('<workflowId>', '流程 ID')
+        .action(async (workflowId) => {
+        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 data = await client.get(`${baseUrl}/api/bs/workflow/pathdef/nodeLink/generateId?v=${Date.now()}`);
+        if (data?.code === 200 && data?.status) {
+            const linkId = data?.data || '';
+            if (opts.json) {
+                console.log(JSON.stringify({ linkId }));
+            }
+            else {
+                console.log(linkId);
+            }
+        }
+        else {
+            console.error(`生成失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    wf.command('add-link')
+        .description('给流程添加新连线（列表 API：生成ID + 获取出口列表 + 添加 + 保存）')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<fromNodeId>', '来源节点 ID')
+        .argument('<toNodeId>', '目标节点 ID')
+        .argument('<label>', '连线标签')
+        .option('--reject', '标记为退回线')
+        .option('--default', '标记为默认出口（同源节点只一条）')
+        .action(async (workflowId, fromNodeId, toNodeId, label, 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 BASE = `${baseUrl}/api/bs/workflow/pathdef`;
+        // 1. Generate link ID
+        const genData = await client.get(`${BASE}/nodeLink/generateId?_=${Date.now()}`);
+        const linkId = genData?.data || '';
+        if (!linkId) {
+            console.error('生成连线 ID 失败');
+            process.exit(1);
+        }
+        // 2. Read current link table
+        const linkRes = await client.get(`${BASE}/nodeLink/getWfpNodeLinkTable?workflowId=${workflowId}&_=${Date.now()}`);
+        if (linkRes?.code !== 200 || !linkRes?.status) {
+            console.error(`读取出口列表失败: ${linkRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const links = linkRes?.data?.data || [];
+        // If --default, clear other defaults from the same source node
+        if (cmdOpts.default) {
+            for (const l of links) {
+                if (String(l.srcNodeId) === String(fromNodeId) && l.isDefault === '1') {
+                    l.isDefault = '0';
+                }
+            }
+        }
+        // 3. Build new link row and append
+        const newLink = {
+            flag: 'add',
+            id: linkId,
+            conditionKey: { conditionKey: '', source: '2' },
+            isReject: cmdOpts.reject ? '1' : '0',
+            isDefault: cmdOpts.default ? '1' : '0',
+            srcNodeId: fromNodeId,
+            destNodeId: toNodeId,
+            publicSegmentId: '',
+            linkName: label,
+            orderId: String(links.length),
+        };
+        links.push(newLink);
+        // 4. Save
+        const saveRes = await client.post(`${BASE}/nodeLink/saveNodeLinkEditTable`, {
+            workflowId,
+            datas: JSON.stringify(links),
+            deleteRows: '',
+            changedLinkIds: '',
+            updateRowIds: [],
+        });
+        if (saveRes?.code !== 200 || !saveRes?.status || saveRes?.fail !== false || saveRes?.data?.status !== true) {
+            console.error(`添加连线失败: ${saveRes?.data?.msg || saveRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const flags = [];
+        if (cmdOpts.reject)
+            flags.push('退回');
+        if (cmdOpts.default)
+            flags.push('默认出口');
+        const flagStr = flags.length ? ` (${flags.join(', ')})` : '';
+        if (opts.json) {
+            console.log(JSON.stringify({ success: true, workflowId, linkId, fromNodeId, toNodeId, label, reject: !!cmdOpts.reject, default: !!cmdOpts.default }));
+        }
+        else {
+            console.log(`连线已添加: ${label}  id=${linkId}  ${fromNodeId} → ${toNodeId}${flagStr}`);
+        }
+    });
+    wf.command('add-links')
+        .description('批量添加连线（列表 API，一次保存完成所有连线）')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<links>', '连线 JSON 数组或 @文件路径。格式：[{"from":"nodeId","to":"nodeId","label":"标签"}]')
+        .option('--reject', '全部标记为退回线')
+        .option('--default', '全部标记为默认出口')
+        .action(async (workflowId, linksArg, 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 BASE = `${baseUrl}/api/bs/workflow/pathdef`;
+        let linksStr = linksArg;
+        if (linksArg.startsWith('@')) {
+            const { readFileSync: rfl, existsSync: exl } = await import('fs');
+            const fp = linksArg.slice(1);
+            if (!exl(fp)) {
+                console.error(`文件不存在: ${fp}`);
+                process.exit(1);
+            }
+            linksStr = rfl(fp, 'utf-8');
+        }
+        let linkDefs;
+        try {
+            linkDefs = JSON.parse(linksStr);
+        }
+        catch {
+            console.error('JSON 解析失败');
+            process.exit(1);
+        }
+        if (!Array.isArray(linkDefs) || linkDefs.length === 0) {
+            console.error('links 必须是非空数组');
+            process.exit(1);
+        }
+        // 1. Generate IDs for all new links
+        const newLinkIds = [];
+        for (let i = 0; i < linkDefs.length; i++) {
+            const genData = await client.get(`${BASE}/nodeLink/generateId?_=${Date.now()}`);
+            const lid = genData?.data || '';
+            if (!lid) {
+                console.error(`生成第 ${i + 1} 条连线 ID 失败`);
+                process.exit(1);
+            }
+            newLinkIds.push(lid);
+        }
+        // 2. Read current link table
+        const linkRes = await client.get(`${BASE}/nodeLink/getWfpNodeLinkTable?workflowId=${workflowId}&_=${Date.now()}`);
+        if (linkRes?.code !== 200 || !linkRes?.status) {
+            console.error(`读取出口列表失败: ${linkRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const links = linkRes?.data?.data || [];
+        // 3. Append all new links
+        for (let i = 0; i < linkDefs.length; i++) {
+            const l = linkDefs[i];
+            const reject = l.reject ?? cmdOpts.reject ?? false;
+            const isDefault = l.default ?? cmdOpts.default ?? false;
+            // Clear other defaults from same source if this one is default
+            if (isDefault) {
+                for (const existing of links) {
+                    if (String(existing.srcNodeId) === String(l.from) && existing.isDefault === '1') {
+                        existing.isDefault = '0';
+                    }
+                }
+            }
+            links.push({
+                flag: 'add',
+                id: newLinkIds[i],
+                conditionKey: { conditionKey: '', source: '2' },
+                isReject: reject ? '1' : '0',
+                isDefault: isDefault ? '1' : '0',
+                srcNodeId: l.from,
+                destNodeId: l.to,
+                publicSegmentId: '',
+                linkName: l.label,
+                orderId: String(links.length),
+            });
+        }
+        // 4. Save all at once
+        const saveRes = await client.post(`${BASE}/nodeLink/saveNodeLinkEditTable`, {
+            workflowId,
+            datas: JSON.stringify(links),
+            deleteRows: '',
+            changedLinkIds: '',
+            updateRowIds: [],
+        });
+        if (saveRes?.code !== 200 || !saveRes?.status || saveRes?.fail !== false || saveRes?.data?.status !== true) {
+            console.error(`批量添加连线失败: ${saveRes?.data?.msg || saveRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ success: true, workflowId, added: linkDefs.length, linkIds: newLinkIds }));
+        }
+        else {
+            console.log(`已添加 ${linkDefs.length} 条连线`);
+            for (let i = 0; i < linkDefs.length; i++) {
+                console.log(`  ${linkDefs[i].label}  id=${newLinkIds[i]}  ${linkDefs[i].from} → ${linkDefs[i].to}`);
+            }
+        }
+    });
+    const NODE_TYPES = {
+        '0': '发起',
+        '1': '审批',
+        '2': '确认/会签',
+        '3': '归档',
+        '5': '投递',
+        '7': '自动处理',
+        '8': '等待',
+        'forkstart': '分流点',
+        'forkend': '合流点',
+        'forkmiddle': '分流中间点',
+    };
+    wf.command('add-node')
+        .description('添加流程节点（列表 API，自动同步到流程图）')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<type>', `节点类型: ${Object.entries(NODE_TYPES).map(([k, v]) => `${k}=${v}`).join(', ')}`)
+        .argument('<name>', '节点名称')
+        .option('--node-attr <attr>', '节点属性: 0=一般(默认), 1=分流点, 2=分流中间点, 3=合流点', '0')
+        .option('--merge-type <type>', '合流方式 (合流点必填): 0=全部, 1=指定, 2=数量, 3=比例')
+        .option('--merge-num <num>', '合流分支数或百分比 (mergeType=2/3 时必填)')
+        .option('--branch-nodes <ids>', '指定合流分支节点 ID，逗号分隔 (mergeType=1 时必填)')
+        .action(async (workflowId, type, name, cmdOpts) => {
+        if (!NODE_TYPES[type]) {
+            console.error(`不支持的节点类型: ${type}，可选: ${Object.keys(NODE_TYPES).join(', ')}`);
+            process.exit(1);
+        }
+        // Resolve actual nodeType and nodeAttr
+        let actualType = type;
+        let nodeAttr = cmdOpts.nodeAttr || '0';
+        if (type === 'forkmiddle') {
+            actualType = '1';
+            nodeAttr = '2';
+        }
+        else if (type === 'forkstart') {
+            nodeAttr = '1';
+        }
+        else if (type === 'forkend') {
+            nodeAttr = '3';
+        }
+        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 BASE = `${baseUrl}/api/bs/workflow/pathdef`;
+        // 1. Generate new node ID via multilang
+        const mlRes = await client.post(`${BASE}/multilang/getTargetId`, { targetId: '-1' });
+        const nodeId = mlRes?.data || '';
+        if (!nodeId) {
+            console.error('生成节点 ID 失败');
+            process.exit(1);
+        }
+        // 2. Read current node edit table
+        const nodeRes = await client.get(`${BASE}/nodeBase/getNodeEditTable?workflowId=${workflowId}&_=${Date.now()}`);
+        if (nodeRes?.code !== 200 || !nodeRes?.status) {
+            console.error(`读取节点列表失败: ${nodeRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const nodeRows = nodeRes?.data?.data || [];
+        // 3. Build new node row
+        const tempRowId = `rowId_${Date.now()}`;
+        const newRow = {
+            id: tempRowId,
+            targetId: nodeId,
+            needReplaceTargetId: true,
+            nodeName: name,
+            nodeType: actualType,
+            nodeAttr,
+            orderId: String(nodeRows.length),
+        };
+        // Forkend merge settings
+        if (actualType === 'forkend') {
+            const mergeType = cmdOpts.mergeType || '0';
+            newRow.mergeType = mergeType;
+            if (mergeType === '1') {
+                newRow.branchNodes = cmdOpts.branchNodes || '';
+                newRow.flowToForkend = true;
+            }
+            else if (mergeType === '2' || mergeType === '3') {
+                newRow.mergeNum = cmdOpts.mergeNum || (mergeType === '2' ? '1' : '50');
+            }
+        }
+        nodeRows.forEach((n, i) => { n.orderId = String(i); });
+        nodeRows.push(newRow);
+        // 4. Save
+        const saveRes = await client.post(`${BASE}/nodeBase/saveNodeEditTable`, {
+            workflowId,
+            datas: JSON.stringify(nodeRows),
+            deleteRows: '',
+            changeRows: '',
+            changeControlledRows: '',
+        });
+        if (saveRes?.code !== 200 || !saveRes?.status || saveRes?.fail !== false || saveRes?.data?.status !== true) {
+            console.error(`添加节点失败: ${saveRes?.data?.msg || saveRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const mergeInfo = actualType === 'forkend'
+            ? ` mergeType=${newRow.mergeType}${newRow.mergeNum ? ' mergeNum=' + newRow.mergeNum : ''}`
+            : '';
+        if (opts.json) {
+            console.log(JSON.stringify({ success: true, workflowId, nodeId, type, name, nodeAttr, ...(actualType === 'forkend' ? { mergeType: newRow.mergeType, mergeNum: newRow.mergeNum } : {}) }));
+        }
+        else {
+            console.log(`节点已添加: ${name} (${NODE_TYPES[type]})  id=${nodeId}${mergeInfo}`);
+        }
+    });
+    wf.command('rename-node')
+        .description('重命名节点（通过 saveNodeSetForm API）')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<nodeId>', '节点 ID')
+        .argument('<name>', '新名称')
+        .action(async (workflowId, nodeId, name) => {
+        const opts = program.opts();
+        const auth = await AuthSession.fromOptions(opts);
+        if (!auth)
+            process.exit(1);
+        const client = new ApiClient(auth);
+        const baseUrl = auth.getBaseUrl();
+        // 1. Get current node settings
+        const getRes = await client.get(`${baseUrl}/api/bs/workflow/pathdef/nodeBase/getNodeSetForm?workflowId=${workflowId}&nodeId=${nodeId}`);
+        if (getRes?.code !== 200 || !getRes?.data?.data) {
+            console.error(`获取节点设置失败: ${getRes?.msg || '节点不存在'}`);
+            process.exit(1);
+        }
+        const nodeData = getRes.data.data;
+        // 节点不存在时 getNodeSetForm 只回一个空的 {nodeName:""}，直接回传会让 saveNodeSetForm 报「系统错误」。
+        // 用字段数判断（真实节点有 nodeType/operator/voteSet 等完整配置，空节点只有 1 个 key）。
+        if (Object.keys(nodeData).length <= 1) {
+            console.error(`节点不存在或 nodeId 有误: ${nodeId}`);
+            console.error('  可用 `e10-cli workflow nodes <workflowId>` 查看该流程下真实节点 ID');
+            process.exit(1);
+        }
+        const oldName = nodeData.nodeName || '';
+        // 2. Update name
+        nodeData.nodeName = name;
+        nodeData.nodeNameMultilang = name;
+        // 3. Save
+        const payload = { workflowId, nodeId };
+        for (const [k, v] of Object.entries(nodeData)) {
+            payload[k] = v;
+        }
+        const saveRes = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeBase/saveNodeSetForm`, payload);
+        if (saveRes?.code === 200 && saveRes?.status) {
+            console.log(opts.json
+                ? JSON.stringify({ success: true, workflowId, nodeId, oldName, name })
+                : `节点已改名: ${oldName} → ${name}`);
+        }
+        else {
+            console.error(`保存失败: ${saveRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    wf.command('save-layout')
+        .description('保存流程图布局（浏览器 mxGraph 格式 XML，非 getXml 输出）')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<xml>', '浏览器格式的 XML 或 @文件路径')
+        .option('--delete-links <ids>', '要删除的连线 ID，逗号分隔')
+        .option('--delete-nodes <ids>', '要删除的节点 ID，逗号分隔')
+        .action(async (workflowId, xmlArg, 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();
+        let xml = xmlArg;
+        if (xmlArg.startsWith('@')) {
+            const { readFileSync, existsSync } = await import('fs');
+            const filePath = xmlArg.slice(1);
+            if (!existsSync(filePath)) {
+                console.error(`文件不存在: ${filePath}`);
+                process.exit(1);
+            }
+            xml = readFileSync(filePath, 'utf-8').trim();
+        }
+        // If XML starts with <?xml, strip declaration and set grid=0 for browser format
+        xml = xml.replace(/^<\?xml[^>]*\?>\s*/, '');
+        xml = xml.replace(/grid="1"/, 'grid="0"');
+        // 服务器 saveLayout 只认浏览器 mxGraph 格式（纯数字 cell id + source/target 数字引用）。
+        // 不要转成 node_X/link_X——服务器解析不了会静默失败。直接回传浏览器格式 XML，
+        // 仅对服务器不存在的 nodeId/linkId（新增节点/连线）注入 flag="add"。
+        try {
+            const chartData = await client.postForm(`${baseUrl}/api/bs/workflow/pathdef/chart/getXml`, `workflowId=${workflowId}&keepTitle=undefined&showType=0`);
+            const serverXml = chartData?.data?.xml || '';
+            if (serverXml) {
+                const knownNodes = new Set([...serverXml.matchAll(/nodeId="(\d+)"/g)].map(m => m[1]));
+                const knownLinks = new Set([...serverXml.matchAll(/linkId="(\d+)"/g)].map(m => m[1]));
+                // 新增节点 cell：nodeId 不在服务器已知集 → 注入 flag="add"
+                for (const m of xml.matchAll(/<mxCell\b[^>]*nodeId="(\d+)"[^>]*>/g)) {
+                    if (!knownNodes.has(m[1]) && !/flag="add"/.test(m[0])) {
+                        xml = xml.replace(m[0], m[0].replace('nodeId=', 'flag="add" nodeId='));
+                    }
+                }
+                // 新增连线 cell：linkId 不在服务器已知集 → 注入 flag="add"
+                for (const m of xml.matchAll(/<mxCell\b[^>]*linkId="(\d+)"[^>]*>/g)) {
+                    if (!knownLinks.has(m[1]) && !/flag="add"/.test(m[0])) {
+                        xml = xml.replace(m[0], m[0].replace('linkId=', 'flag="add" linkId='));
+                    }
+                }
+            }
+        }
+        catch { /* best effort */ }
+        // Lock the chart for editing (browser does this before save)
+        try {
+            await client.postForm(`${baseUrl}/api/bs/workflow/pathdef/chart/checkoutHeart`, `workflowId=${workflowId}&chartSrc=0`);
+        }
+        catch { /* best effort */ }
+        // Base64-encode: standard base64 then replace + with $ (avoids form-decoding + as space)
+        const xmlB64 = Buffer.from(xml).toString('base64').replace(/\+/g, '$');
+        // Build form body — server expects unencoded JSON braces
+        const body = `workflowId=${workflowId}&deleteLinks=${cmdOpts.deleteLinks || ''}&deleteNodes=${cmdOpts.deleteNodes || ''}&groups={"col":[],"row":[]}&deleteGroups=&templateKey=0&chartSrc=0&showConditionName=false&showLinkName=false&isSaveBySkipLinkValidate=false&xml=${xmlB64}`;
+        const data = await client.postForm(`${baseUrl}/api/bs/workflow/pathdef/chart/saveLayout`, body);
+        if (data?.code === 200 && data?.status) {
+            const msg = opts.json
+                ? JSON.stringify({ success: true, workflowId })
+                : `流程图已保存: ${workflowId}`;
+            console.log(msg);
+        }
+        else {
+            console.error(`保存失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    wf.command('auto-layout')
+        .description('流程节点自动排版（分层布局，全量重排节点坐标）')
+        .argument('<workflowId>', '流程 ID')
+        .option('--direction <dir>', '布局方向: ltr=左右(默认), ttb=上下', 'ltr')
+        .option('--gap-x <n>', '相邻层间距（ltr=列距, ttb=行距）', '90')
+        .option('--gap-y <n>', '同层节点间距（ltr=行距, ttb=列距）', '40')
+        .option('--dry-run', '只计算坐标，不回写')
+        .option('--out <file>', '配合 --dry-run 输出新 XML 到文件')
+        .action(async (workflowId, 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 { autoLayoutWorkflow } = await import('../services/workflow-layout.js');
+        const res = await autoLayoutWorkflow({
+            client: client,
+            baseUrl,
+            workflowId,
+            options: {
+                direction: (cmdOpts.direction === 'ttb' ? 'ttb' : 'ltr'),
+                gapX: cmdOpts.gapX ? Number(cmdOpts.gapX) : undefined,
+                gapY: cmdOpts.gapY ? Number(cmdOpts.gapY) : undefined,
+                dryRun: cmdOpts.dryRun,
+            },
+        });
+        if (res.error) {
+            console.error(`排版失败: ${res.error}`);
+            process.exit(1);
+        }
+        if (cmdOpts.dryRun) {
+            console.error(`[dry-run] 方向=${res.direction} 节点=${res.nodeCount} 连线=${res.linkCount} 层=${res.layerCount}`);
+            for (const n of res.nodes) {
+                console.log(`  层${n.layer}  (${n.x},${n.y})  ${n.name}  ${n.nodeId}`);
+            }
+            if (cmdOpts.out) {
+                const { writeFileSync } = await import('fs');
+                writeFileSync(cmdOpts.out, res.xml ?? '', 'utf-8');
+                console.error(`新 XML 已写入: ${cmdOpts.out}`);
+            }
+            return;
+        }
+        if (res.saved) {
+            console.error(`布局已保存，回读验证: ${res.verified ? '坐标全部生效 ✓' : '未通过（请检查）'}`);
+        }
+        else {
+            console.error(`保存失败: 服务器未确认（可用 --dry-run 排查）`);
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ ...res, xml: undefined }, null, 2));
+        }
+        else {
+            console.log(`共 ${res.nodeCount} 个节点, ${res.linkCount} 条连线, ${res.layerCount} 层:`);
+            for (const n of res.nodes) {
+                console.log(`  层${n.layer}  (${n.x},${n.y})  ${n.name}  ${n.nodeId}`);
+            }
+        }
+    });
+    wf.command('link-save')
+        .description('修改/删除出口（列表方式，传完整 datas JSON 字符串 或 @文件）')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<datas>', '完整出口数组的 JSON 字符串，或 @文件路径（JSON 文件）')
+        .option('--delete-rows <ids>', '要删除的出口 ID，逗号分隔')
+        .option('--changed-link-ids <ids>', '源/目标发生变化的出口 ID，逗号分隔')
+        .option('--update-row-ids <json>', '明确要更新的出口 ID 数组，JSON 格式，如 \'["id1","id2"]\'')
+        .action(async (workflowId, datasArg, 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();
+        let datasStr = datasArg;
+        if (datasArg.startsWith('@')) {
+            const { readFileSync, existsSync } = await import('fs');
+            const filePath = datasArg.slice(1);
+            if (!existsSync(filePath)) {
+                console.error(`文件不存在: ${filePath}`);
+                process.exit(1);
+            }
+            datasStr = readFileSync(filePath, 'utf-8');
+        }
+        // datas must be a JSON string (not array) per the API contract
+        let datas;
+        try {
+            let parsed = JSON.parse(datasStr);
+            // If parsed is a string, it's already a JSON string; use as-is
+            if (typeof parsed === 'string') {
+                datas = parsed;
+            }
+            else {
+                // Strip read-only fields to avoid "系统错误" from unknown fields
+                const ALLOWED_KEYS = new Set([
+                    'flag', 'id', 'srcNodeId', 'destNodeId', 'linkName',
+                    'isReject', 'isDefault', 'orderId', 'publicSegmentId',
+                ]);
+                const rows = Array.isArray(parsed) ? parsed : [parsed];
+                const cleaned = rows.map((row) => {
+                    const out = {};
+                    for (const k of ALLOWED_KEYS) {
+                        if (row[k] !== undefined)
+                            out[k] = row[k];
+                    }
+                    // Always preserve conditionKey (nested object)
+                    out.conditionKey = {
+                        conditionKey: row?.conditionKey?.conditionKey || '',
+                        source: row?.conditionKey?.source || '2',
+                    };
+                    return out;
+                });
+                datas = JSON.stringify(cleaned);
+            }
+        }
+        catch {
+            datas = datasStr; // assume it's already a JSON string
+        }
+        let updateRowIds = [];
+        if (cmdOpts.updateRowIds) {
+            try {
+                updateRowIds = JSON.parse(cmdOpts.updateRowIds);
+            }
+            catch {
+                console.error('--update-row-ids 必须是 JSON 数组，如 \'["id1","id2"]\'');
+                process.exit(1);
+            }
+        }
+        const payload = {
+            workflowId,
+            datas,
+            deleteRows: cmdOpts.deleteRows || '',
+            changedLinkIds: cmdOpts.changedLinkIds || '',
+            updateRowIds,
+        };
+        const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeLink/saveNodeLinkEditTable`, payload);
+        // 成功哨兵：code=200, status=true, data.status=true
+        if (data?.code === 200 && data?.status && data?.data?.status !== false) {
+            const deletedNodes = data?.data?.deletedNodes;
+            const warn = deletedNodes?.length ? ` (警告: ${deletedNodes.length} 个节点已被删除)` : '';
+            const msg = opts.json
+                ? JSON.stringify({ success: true, workflowId, ...(deletedNodes ? { deletedNodes } : {}) })
+                : `出口已保存${warn}`;
+            console.log(msg);
+        }
+        else {
+            console.error(`保存失败: ${data?.data?.msg || data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    wf.command('link-rename')
+        .description('重命名出口（连线名称）：读出口列表 → 改 linkName → 保存')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<linkId>', '连线 ID（用 link-list 查看）')
+        .argument('<name>', '新的出口名称')
+        .action(async (workflowId, linkId, name) => {
+        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 BASE = `${baseUrl}/api/bs/workflow/pathdef`;
+        // 1. 读出口列表
+        const linkRes = await client.get(`${BASE}/nodeLink/getWfpNodeLinkTable?workflowId=${workflowId}&_=${Date.now()}`);
+        if (linkRes?.code !== 200 || !linkRes?.status) {
+            console.error(`读取出口列表失败: ${linkRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const links = linkRes?.data?.data || [];
+        // 2. 找目标连线
+        const target = links.find((l) => String(l.id) === String(linkId));
+        if (!target) {
+            console.error(`未找到连线: ${linkId}。可用: ${links.map((l) => `${l.id}(${l.linkName || '未命名'})`).join(', ')}`);
+            process.exit(1);
+        }
+        const oldName = target.linkName || '';
+        target.linkName = name;
+        // 3. 清洗后保存（去掉只读字段，保留 conditionKey，避免"系统错误"）
+        const ALLOWED_KEYS = ['flag', 'id', 'srcNodeId', 'destNodeId', 'linkName',
+            'isReject', 'isDefault', 'orderId', 'publicSegmentId'];
+        const cleaned = links.map((row) => {
+            const out = {};
+            for (const k of ALLOWED_KEYS)
+                if (row[k] !== undefined)
+                    out[k] = row[k];
+            out.conditionKey = {
+                conditionKey: row?.conditionKey?.conditionKey || '',
+                source: row?.conditionKey?.source || '2',
+            };
+            return out;
+        });
+        const saveRes = await client.post(`${BASE}/nodeLink/saveNodeLinkEditTable`, {
+            workflowId,
+            datas: JSON.stringify(cleaned),
+            deleteRows: '',
+            changedLinkIds: '',
+            updateRowIds: [String(linkId)],
+        });
+        if (saveRes?.code !== 200 || !saveRes?.status || saveRes?.fail !== false || saveRes?.data?.status !== true) {
+            console.error(`重命名失败: ${saveRes?.data?.msg || saveRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const msg = opts.json
+            ? JSON.stringify({ success: true, workflowId, linkId, name })
+            : `出口已重命名: ${oldName || '(未命名)'} → ${name}`;
+        console.log(msg);
+    });
+    wf.command('delete-link')
+        .description('删除连线（列表 API：读取出口列表 → 过滤 → 保存）')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<linkIds...>', '要删除的连线 ID（可多个）')
+        .action(async (workflowId, linkIds) => {
+        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 BASE = `${baseUrl}/api/bs/workflow/pathdef`;
+        // 1. Read current link table
+        const linkRes = await client.get(`${BASE}/nodeLink/getWfpNodeLinkTable?workflowId=${workflowId}&_=${Date.now()}`);
+        if (linkRes?.code !== 200 || !linkRes?.status) {
+            console.error(`读取出口列表失败: ${linkRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const links = linkRes?.data?.data || [];
+        // 2. Filter out deleted links
+        const linkIdSet = new Set(linkIds.map(String));
+        const remaining = links.filter((l) => !linkIdSet.has(String(l.id)));
+        const deletedCount = links.length - remaining.length;
+        if (deletedCount === 0) {
+            console.error(`未找到要删除的连线: ${linkIds.join(', ')}`);
+            process.exit(1);
+        }
+        remaining.forEach((l, i) => { l.orderId = String(i); });
+        // 3. Save with deleteRows
+        const saveRes = await client.post(`${BASE}/nodeLink/saveNodeLinkEditTable`, {
+            workflowId,
+            datas: JSON.stringify(remaining),
+            deleteRows: linkIds.join(','),
+            changedLinkIds: '',
+            updateRowIds: [],
+        });
+        if (saveRes?.code !== 200 || !saveRes?.status || saveRes?.fail !== false || saveRes?.data?.status !== true) {
+            console.error(`删除连线失败: ${saveRes?.data?.msg || saveRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        if (saveRes?.data?.deletedNodes?.length) {
+            console.error(`警告: ${saveRes.data.deletedNodes.length} 个关联节点已被自动删除`);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify({ success: true, workflowId, deleted: linkIds.slice(0, deletedCount) }));
+        }
+        else {
+            console.log(`已删除 ${deletedCount} 条连线: ${linkIds.slice(0, deletedCount).join(', ')}`);
+        }
+    });
+    wf.command('delete-node')
+        .description('删除节点（列表 API，自动清理关联出口并可选桥接）')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<nodeId>', '要删除的节点 ID')
+        .option('--bridge', '自动桥接上下游（上游→下游直连）')
+        .action(async (workflowId, nodeId, 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 BASE = `${baseUrl}/api/bs/workflow/pathdef`;
+        // 1. Read node table
+        const nodeRes = await client.get(`${BASE}/nodeBase/getNodeEditTable?workflowId=${workflowId}&_=${Date.now()}`);
+        if (nodeRes?.code !== 200 || !nodeRes?.status) {
+            console.error(`读取节点列表失败: ${nodeRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        const nodeRows = nodeRes?.data?.data || [];
+        const targetNode = nodeRows.find((n) => String(n.id) === String(nodeId));
+        if (!targetNode) {
+            console.error(`节点 ${nodeId} 在列表中不存在`);
+            process.exit(1);
+        }
+        // 2. Read link table BEFORE deleting node (to find upstream/downstream for bridge)
+        let upstreamId = '';
+        let downstreamId = '';
+        if (cmdOpts.bridge) {
+            const linkRes = await client.get(`${BASE}/nodeLink/getWfpNodeLinkTable?workflowId=${workflowId}&_=${Date.now()}`);
+            if (linkRes?.code === 200 && linkRes?.status) {
+                const links = linkRes?.data?.data || [];
+                const incoming = links.find((l) => String(l.destNodeId) === String(nodeId));
+                const outgoing = links.find((l) => String(l.srcNodeId) === String(nodeId));
+                upstreamId = incoming?.srcNodeId || '';
+                downstreamId = outgoing?.destNodeId || '';
+            }
+        }
+        // 3. Delete node (platform auto-cleans associated links)
+        const remaining = nodeRows.filter((n) => String(n.id) !== String(nodeId));
+        remaining.forEach((n, i) => { n.orderId = String(i); });
+        const saveNodeRes = await client.post(`${BASE}/nodeBase/saveNodeEditTable`, {
+            workflowId,
+            datas: JSON.stringify(remaining),
+            deleteRows: nodeId,
+            changeRows: '',
+            changeControlledRows: '',
+        });
+        if (saveNodeRes?.code !== 200 || !saveNodeRes?.status || saveNodeRes?.data?.status === false) {
+            console.error(`删除节点失败: ${saveNodeRes?.data?.msg || saveNodeRes?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+        // 4. Add bridge link if needed
+        let bridgeResult = undefined;
+        if (cmdOpts.bridge && upstreamId && downstreamId) {
+            const gidRes = await client.get(`${BASE}/nodeLink/generateId?_=${Date.now()}`);
+            const newLinkId = String(gidRes?.data || `link_${Date.now()}`);
+            // Read current links (after auto-clean)
+            const linkRes2 = await client.get(`${BASE}/nodeLink/getWfpNodeLinkTable?workflowId=${workflowId}&_=${Date.now()}`);
+            const currentLinks = (linkRes2?.data?.data || []).map((l, i) => ({ ...l, orderId: String(i) }));
+            currentLinks.push({
+                flag: 'add',
+                id: newLinkId,
+                conditionKey: { conditionKey: '', source: '2' },
+                isReject: '0',
+                isDefault: '0',
+                srcNodeId: upstreamId,
+                destNodeId: downstreamId,
+                publicSegmentId: '',
+                linkName: '桥接',
+                orderId: String(currentLinks.length),
+            });
+            const saveLinkRes = await client.post(`${BASE}/nodeLink/saveNodeLinkEditTable`, {
+                workflowId,
+                datas: JSON.stringify(currentLinks),
+                deleteRows: '',
+                changedLinkIds: '',
+                updateRowIds: [],
+            });
+            if (saveLinkRes?.code === 200 && saveLinkRes?.status && saveLinkRes?.data?.status !== false) {
+                bridgeResult = { from: upstreamId, to: downstreamId, linkId: newLinkId };
+            }
+        }
+        const result = {
+            success: true,
+            workflowId,
+            deletedNode: { id: nodeId, name: targetNode.nodeName },
+            bridged: bridgeResult,
+        };
+        if (opts.json) {
+            console.log(JSON.stringify(result));
+        }
+        else {
+            console.log(`已删除节点: ${targetNode.nodeName} (${nodeId})`);
+            if (bridgeResult)
+                console.log(`  桥接: ${upstreamId} → ${downstreamId} (${bridgeResult.linkId})`);
+        }
+    });
+    wf.command('delete')
+        .description('删除流程')
+        .argument('<workflowId>', '流程 ID')
+        .option('--with-form', '同时删除关联表单')
+        .action(async (workflowId, 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 deleteForm = cmdOpts.withForm ? 'true' : 'false';
+        const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/baseSet/deletePath?workflowId=${workflowId}&deleteForm=${deleteForm}`);
+        if (data?.code === 200 && data?.status) {
+            const msg = opts.json
+                ? JSON.stringify({ success: true, workflowId })
+                : `流程已删除: ${workflowId}`;
+            console.log(msg);
+        }
+        else {
+            console.error(`删除失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    wf.command('set-link-condition-key')
+        .description('将条件 Key 绑定到连线')
+        .argument('<workflowId>', '流程 ID')
+        .argument('<linkId>', '连线 ID')
+        .argument('<conditionKey>', '条件 Key（由 saveCondition 返回）')
+        .argument('<nodeId>', '来源节点 ID')
+        .action(async (workflowId, linkId, conditionKey, nodeId) => {
+        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 payload = { workflowId, linkId, conditionKey, nodeId };
+        const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeLink/saveLinkConditionKey`, payload);
+        if (data?.code === 200 && data?.status) {
+            const msg = opts.json
+                ? JSON.stringify({ success: true, linkId, conditionKey })
+                : `条件已绑定: ${conditionKey} → 连线 ${linkId}`;
+            console.log(msg);
+        }
+        else {
+            console.error(`绑定失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    wf.command('save-condition')
+        .description('保存连线条件规则（自动生成节点 ID，简化 JSON 只需写条件逻辑）')
+        .argument('<json>', '条件定义 JSON，以 @ 开头表示文件路径')
+        .option('--app-id <appId>', '应用 ID（用于生成唯一 ID）')
+        .action(async (jsonArg, cmdOpts) => {
+        const opts = program.opts();
+        const auth = await AuthSession.fromOptions(opts);
+        if (!auth)
+            process.exit(1);
+        let jsonStr = jsonArg;
+        if (jsonArg.startsWith('@')) {
+            const { readFileSync, existsSync } = await import('fs');
+            const filePath = jsonArg.slice(1);
+            if (!existsSync(filePath)) {
+                console.error(`文件不存在: ${filePath}`);
+                process.exit(1);
+            }
+            jsonStr = readFileSync(filePath, 'utf-8');
+        }
+        let payload;
+        try {
+            payload = JSON.parse(jsonStr);
+        }
+        catch {
+            console.error('JSON 解析失败');
+            process.exit(1);
+        }
+        const client = new ApiClient(auth);
+        const baseUrl = auth.getBaseUrl();
+        // Auto-fetch mapBaseId from getConditionSet (platform requires it for linking condition to link)
+        if (!payload.mapBaseId) {
+            try {
+                const csRes = await client.post(`${baseUrl}/api/workflow/pathdef/rule/condition/getConditionSet`, {
+                    source: payload.source ?? 2,
+                    sourceId: payload.sourceId,
+                    workflowId: payload.workflowId,
+                    conditionName: payload.conditionName || '',
+                    linkName: payload.linkName || '',
+                    needFormfield: true,
+                    readOnly: false,
+                    templateTokenId: String(Date.now()),
+                });
+                if (csRes?.code === 200 && csRes?.data?.mapBaseId) {
+                    payload.mapBaseId = csRes.data.mapBaseId;
+                }
+            }
+            catch { /* best effort */ }
+        }
+        // Always enrich formField + add leaf helper fields required by platform
+        const enrichChildrens = (childrens, fieldList) => {
+            for (const c of childrens) {
+                if (c.childrens && c.relation !== undefined) {
+                    enrichChildrens(c.childrens, fieldList);
+                }
+                else {
+                    // Leaf: fill required helper fields (platform requires them)
+                    c.workflowId = c.workflowId || payload.workflowId;
+                    c.elementValue1Id = c.elementValue1Id ?? '';
+                    c.elementValue2Id = c.elementValue2Id ?? '';
+                    c.expressionBaseId = c.expressionBaseId ?? '';
+                    c.dataValueId = c.dataValueId ?? '';
+                    // Stringify selectType (platform expects string)
+                    if (c.selectType !== undefined && typeof c.selectType !== 'string') {
+                        c.selectType = String(c.selectType);
+                    }
+                    if (c.formField && fieldList.length > 0) {
+                        for (let i = 0; i < c.formField.length; i++) {
+                            const ff = c.formField[i];
+                            const fid = String(ff.id || ff.fieldId || '');
+                            const fname = ff.name || ff.fieldName || '';
+                            const full = fieldList.find((f) => String(f.id) === fid || f.name === fname);
+                            if (full) {
+                                c.formField[i] = {
+                                    id: full.id,
+                                    name: full.name,
+                                    fieldType: full.fieldType,
+                                    detail: full.detail ?? false,
+                                    detailName: full.detailName ?? '主表',
+                                    total: full.total ?? false,
+                                    formId: full.formId,
+                                    sourceModule: full.sourceModule ?? 'ebuilder',
+                                    dataTemplateId: full.dataTemplateId ?? '-1',
+                                    detailTableId: full.detailTableId ?? '-1',
+                                    layoutDetail: full.layoutDetail || '',
+                                    selectDataSource: full.selectDataSource ?? false,
+                                    groupKey: full.groupKey || full.fieldType,
+                                    supportContainType: full.supportContainType ?? false,
+                                    newFormDesigner: full.newFormDesigner ?? false,
+                                    variable: full.variable ?? false,
+                                    valueCount: full.valueCount ?? false,
+                                };
+                            }
+                        }
+                    }
+                }
+            }
+        };
+        let fieldList = [];
+        try {
+            const browserRes = await client.post(`${baseUrl}/api/workflow/pathdef/common/browser/complete/conditionFieldBrowser`, {
+                browserMultiple: false,
+                sourceId: payload.sourceId,
+                tab: 'formField',
+                source: 2,
+                workflowId: payload.workflowId,
+                newly: 1,
+                searchValue: '',
+            });
+            fieldList = browserRes?.data?.data || [];
+        }
+        catch { /* best effort */ }
+        if (payload.childrens)
+            enrichChildrens(payload.childrens, fieldList);
+        // Platform requires allRuleIsEmpty at top level
+        if (payload.allRuleIsEmpty === undefined)
+            payload.allRuleIsEmpty = false;
+        const data = await client.post(`${baseUrl}/api/workflow/pathdef/rule/condition/saveCondition`, payload);
+        if (data?.code === 200 && data?.status) {
+            const conditionKey = data?.data?.conditionKey || data?.data?.conditionId || '';
+            const conditionCn = data?.data?.conditionCn || '';
+            // Auto-bind conditionKey to the link (without this, the link's hasCondition stays 0)
+            let bindKey = conditionKey;
+            if (!bindKey || bindKey === '-1') {
+                try {
+                    const csRes = await client.post(`${baseUrl}/api/workflow/pathdef/rule/condition/getConditionSet`, {
+                        source: payload.source ?? 2,
+                        sourceId: payload.sourceId,
+                        workflowId: payload.workflowId,
+                        conditionName: payload.conditionName || '',
+                        linkName: payload.linkName || '',
+                        needFormfield: true, readOnly: false,
+                        templateTokenId: String(Date.now()),
+                    });
+                    if (csRes?.code === 200 && csRes?.data?.mapBaseId) {
+                        bindKey = csRes.data.mapBaseId;
+                    }
+                }
+                catch { /* best effort */ }
+            }
+            const sourceNodeId = payload.nodeId || '';
+            if (bindKey && bindKey !== '-1' && sourceNodeId) {
+                try {
+                    await client.post(`${baseUrl}/api/bs/workflow/pathdef/nodeLink/saveLinkConditionKey`, {
+                        workflowId: payload.workflowId,
+                        linkId: payload.sourceId,
+                        conditionKey: bindKey,
+                        nodeId: sourceNodeId,
+                    });
+                }
+                catch { /* best effort — binding is optional */ }
+            }
+            if (opts.json) {
+                console.log(JSON.stringify(data.data, null, 2));
+            }
+            else {
+                console.log(`条件已保存: conditionKey=${conditionKey}${conditionCn ? ' (' + conditionCn + ')' : ''}${sourceNodeId && bindKey && bindKey !== '-1' ? ' [已绑定到连线]' : ''}`);
+            }
+        }
+        else {
+            console.error(`保存失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    wf.command('save-action')
+        .description('保存节点提交事件/动作。只接 JSON 一个参数（workflowId/nodeId 写在 JSON 内部，不是位置参数）。简化 JSON（常量赋值）或完整 data[] 结构（高级）')
+        .argument('<json>', '动作定义 JSON，以 @ 开头表示文件路径；workflowId/nodeId 等均在 JSON 内')
+        .action(async (jsonArg) => {
+        const opts = program.opts();
+        const auth = await AuthSession.fromOptions(opts);
+        if (!auth)
+            process.exit(1);
+        let jsonStr = jsonArg;
+        if (jsonArg.startsWith('@')) {
+            const { readFileSync, existsSync } = await import('fs');
+            const filePath = jsonArg.slice(1);
+            if (!existsSync(filePath)) {
+                console.error(`文件不存在: ${filePath}`);
+                process.exit(1);
+            }
+            jsonStr = readFileSync(filePath, 'utf-8');
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(jsonStr);
+        }
+        catch {
+            console.error('JSON 解析失败');
+            process.exit(1);
+        }
+        // 简化 schema → 构造 saveAddActionList 正确 payload（actionType=0 字段常量赋值）
+        // 真实浏览器 payload: data[0] = {id(负临时), actionName, executeTime:["1"], open:true, async:0,
+        // actionType:0, triggerType:"pre", targetValue:<字段id>, firstValue:"custom", customValue:<值>, ...}
+        let payload;
+        if (Array.isArray(parsed?.data)) {
+            // 完整结构（高级用法）原样透传
+            payload = parsed;
+        }
+        else if (parsed?.fieldId !== undefined && parsed?.value !== undefined) {
+            const wf = parsed.workflowId;
+            const nodeId = parsed.nodeId;
+            if (!wf || !nodeId) {
+                console.error('简化 JSON 缺少 workflowId / nodeId');
+                process.exit(1);
+            }
+            const fieldName = parsed.fieldName || '';
+            const value = String(parsed.value);
+            const nodeName = parsed.nodeName || '节点';
+            const trigger = parsed.trigger || 'pre';
+            payload = {
+                workflowId: wf, objId: nodeId, triggerType: 'all',
+                data: [{
+                        id: tempIdNeg(),
+                        actionName: `${fieldName} = ${value}`.trim(),
+                        executeTime: ['1'], open: true, async: 0, actionType: 0,
+                        dateRuleStr: '', triggerType: trigger, order: 0,
+                        targetValue: parsed.fieldId,
+                        firstValue: 'custom',
+                        operatorValue: '', secondValue: '',
+                        customValue: value,
+                        dateRule: [], isCreate: false,
+                    }],
+                isNodeFlag: '1', objName: nodeName,
+            };
+        }
+        else {
+            // 兜底：旧式裸 payload 直接透传（向后兼容）
+            payload = parsed;
+        }
+        const client = new ApiClient(auth);
+        const baseUrl = auth.getBaseUrl();
+        // 归一化用户提供的 data[] 行——高级用法常直接回传 list-node 的读回格式
+        // （fieldMappingData 嵌套 / async:false 布尔 / 无 paramsSet），原样写入会坏节点
+        // （之后读该节点恒 500，API 不可恢复）。normalizeActionRow 对已是写格式的行幂等。
+        payload.data = (payload.data || []).map(normalizeActionRow);
+        // Fetch existing actions and merge (same pattern as action create / message create)
+        const wfId = payload.workflowId;
+        const nId = payload.objId;
+        // 校验 actionType=0 行的 targetValue(=fieldId) 必须是流程表单里真实存在的字段。
+        // 无效 fieldId 会被服务端存成空字段映射（targetValue/customValue 全空），之后任何
+        // 合并写回都会把空映射行带回 saveAddActionList → 节点写坏、读恒 500。在源头拦住。
+        const type0Rows = (payload.data || []).filter((r) => r.actionType === 0);
+        if (type0Rows.length > 0) {
+            const srcForm = await resolveSourceForm(client, baseUrl, wfId);
+            if (srcForm) {
+                const srcFields = await fetchEbField(client, baseUrl, srcForm.sourceObjId, srcForm.sourceAppId);
+                const validIds = new Set([
+                    ...srcFields.main,
+                    ...srcFields.detail.flatMap((d) => d.fields || []),
+                ].map((f) => String(f.id)));
+                for (const r of type0Rows) {
+                    if (!validIds.has(String(r.targetValue ?? ''))) {
+                        console.error(`  ❌ 字段不存在: fieldId=${r.targetValue ?? '(空)'} 不在流程表单「${srcForm.sourceFormName}」中`);
+                        console.error(`     可用字段: ${srcFields.main.map((f) => `${f.id}(${f.showName})`).join(', ')}`);
+                        process.exit(1);
+                    }
+                }
+            }
+        }
+        let existingActions = [];
+        let nodeCorrupted = false;
+        try {
+            const existing = await client.post(`${baseUrl}/api/bs/workflow/pathdef/addaction/getAddActionDataList`, {
+                workflowId: wfId, objId: nId, triggerType: 'all', isNodeFlag: '1',
+            });
+            if (existing?.code === 200 && existing?.status) {
+                existingActions = existing?.data?.data || [];
+            }
+            else if (existing?.code === 500 || /系统错误/.test(existing?.msg || '')) {
+                nodeCorrupted = true;
+            }
+        }
+        catch {
+            nodeCorrupted = true;
+        }
+        if (nodeCorrupted) {
+            console.error(`  ⚠ 节点动作读取失败(500)：该节点很可能已被写坏（曾以读回格式原样保存）。`);
+            console.error(`    API 无法修复，请用 \`workflow delete-node ${wfId} ${nId}\` 删除节点后重建。`);
+            process.exit(1);
+        }
+        if (existingActions.length > 0) {
+            // Merge: normalize existing read-format rows back to write format, then append.
+            // Re-sending raw read rows (fieldMappingData nesting / async:false / no paramsSet)
+            // corrupts the node — every later read returns 500.
+            const oldCount = existingActions.length;
+            // 归一化已有行；跳过 actionType=0 且 targetValue 为空的残留坏动作（无效 fieldId 造成），
+            // 这类空映射行写回会坏节点。跳过后合并仍可安全进行。
+            const normalized = existingActions.map(normalizeActionRow).filter((r) => {
+                if (r.actionType === 0 && !r.targetValue) {
+                    console.error(`  ⚠ 跳过空字段映射的已有动作「${r.actionName || ''}」（无效 fieldId 残留，写回会坏节点）`);
+                    return false;
+                }
+                return true;
+            });
+            for (const item of (payload.data || [])) {
+                item.order = normalized.length;
+                normalized.push(item);
+            }
+            payload.data = normalized;
+            console.error(`  已有 ${oldCount} 个动作，归一化合并后 ${normalized.length} 个`);
+        }
+        const data = await client.post(`${baseUrl}/api/bs/workflow/pathdef/addaction/saveAddActionList`, payload);
+        if (data?.code === 200 && data?.status) {
+            if (opts.json) {
+                console.log(JSON.stringify(data.data, null, 2));
+            }
+            else {
+                const actions = payload?.data?.length || 0;
+                console.log(`动作已保存: ${actions} 个动作 → 节点 ${payload?.objId}`);
+            }
+        }
+        else {
+            console.error(`保存失败: ${data?.msg || '未知错误'}`);
+            process.exit(1);
+        }
+    });
+    return wf;
+}
+//# sourceMappingURL=workflow.js.map