weaver-e10-builder 1.0.3-beta → 1.0.7-beta

package/dist/commands/wf-form.js

@@ -0,0 +1,1002 @@
+import { AuthSession } from '../core/auth.js';
+import { ApiClient } from '../core/client.js';
+import { toSubTableName, toColumnName } from '../utils/column-name.js';
+import { normalizeDetailTableChildren, placeholderFromFormat } from '../services/form-create.js';
+import { randomUUID } from 'node:crypto';
+/** 流程表单选项配色（对齐浏览器抓包 styleConfig.OptionBackground，循环取用）。 */
+const OPTION_COLORS = ['#FFBD4F', '#FF716E', '#3BD8C3', '#5B8FF9', '#5AD8A6', '#F6BD16', '#E86452', '#6DC8EC', '#945FB9', '#FF99C3'];
+/**
+ * wf-form — 流程表单（工作流程表单）表单管理。与 eb 表 `form` 命令对齐，但走流程表单引擎：
+ *
+ *   路由前缀:  /api/workflow/core/form/...        （eb 表为 /api/ebuilder/form/...）
+ *   body:       { module:'workflow', customParam:{} }  （eb 表 module:'ebuilderform', customParam:{appId,objId}）
+ *   无 apid 查询参 / 无 ebbusinessid header（eb 表带）；generatorIds 无需 apid。
+ *   默认布局:   FLOW（eb 表为 EXCEL）→ initLayout 模板按 layoutType 选。
+ *
+ * 探针实测（mulinquan formId=1307197331401359360，2026-08-24）：
+ *   - getFormLayout  /api/workflow/core/form/builder/getFormLayout  ✅（module=workflow）
+ *   - getConfig      /api/workflow/core/form/view/relate/getConfig  ✅（返回 configs 含系统字段 REQ_xxx / REQUEST_xxx）
+ *   - saveFormFieldNew /api/workflow/core/form/field/manage/saveFormFieldNew ✅ 落库（formTableId 省略）
+ *   - saveSubForm    /api/workflow/core/form/field/manage/saveSubForm ✅（首字段 omit formTableId，同 eb 机制）
+ *   - initLayout     /api/workflow/core/form/view/relate/initLayout ✅
+ *   回读用 getConfig（getFormFieldPage 返回结构不同，count 不可靠）。
+ *
+ * 不改 form.ts/form-layout-init.ts/form-add-detail-table.ts；老 eb 命令保持原样。
+ */
+const ROUTE = '/api/workflow/core/form';
+const MODULE = 'workflow';
+/** 类型别名归一（小写/口语变体 → 平台 componentKey），内联小表。 */
+function canon(ck) {
+    const m = {
+        textarea: 'TextArea', text: 'Text', number: 'Number', money: 'Money',
+        date: 'Date', datetime: 'DateTime', select: 'Select', selectmultiple: 'SelectMultiple',
+        employee: 'Employee', department: 'Department', browser: 'Browser',
+    };
+    return m[ck.toLowerCase()] || ck;
+}
+async function getLayoutMeta(client, baseUrl, formId) {
+    const res = await client.post(`${baseUrl}${ROUTE}/builder/getFormLayout`, {
+        formId, module: MODULE, customParam: {}, formTableIdList: [],
+        designerParam: { onlyLayout: false, convert: false }, form: { id: formId },
+    }, { ebbusinessid: formId });
+    if (res?.code !== 200 || !res?.status)
+        throw new Error(`getFormLayout 失败: ${res?.msg}`);
+    const fl = res.data?.formLayout || {}, flm = res.data?.formLayoutMultiple || {};
+    return { layoutId: fl.id || '', layoutMultiId: flm.id || '', layoutName: flm.name || '', layoutType: flm.layoutType || 'FLOW' };
+}
+async function readConfigs(client, baseUrl, formId) {
+    const meta = await getLayoutMeta(client, baseUrl, formId);
+    const cfg = await client.post(`${baseUrl}${ROUTE}/view/relate/getConfig`, {
+        formId, module: MODULE, apiModule: 'workflow/form', layoutId: meta.layoutId,
+        customParam: { terminal: '', objId: formId }, initMode: 5, groupFieldIds: [],
+        designerParam: { sourceModule: MODULE },
+    }, { ebbusinessid: formId });
+    if (cfg?.code !== 200 || !cfg?.status)
+        throw new Error(`getConfig 失败: ${cfg?.msg}`);
+    return { ...meta, configs: normalizeDetailTableChildren(cfg?.data?.configs || []) };
+}
+async function genIds(client, baseUrl, n) {
+    const r = await client.post(`${baseUrl}/api/form/local/generatorIds?size=${n}`, {});
+    return (r?.data?.generatorIds || []).map(String);
+}
+export function registerWorkflowFormCommands(program) {
+    const wfForm = program.command('wf-form').description('流程表单（工作流程表单）管理：read / add-field / add-detail-table / layout init');
+    // ---------- wf-form read ----------
+    wfForm.command('read')
+        .description('读取流程表单字段（getConfig）')
+        .argument('<formId>', '流程表单 formId（workflow create-workflow 回吐）')
+        .action(async (formId) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const { layoutType, configs } = await readConfigs(client, baseUrl, formId);
+            const rows = configs.map((c) => ({
+                id: c.id, name: c.name, componentKey: c.componentKey || c.type,
+                system: c.system ? '系统' : '业务',
+                children: c.children?.length || undefined,
+            }));
+            if (opts.json) {
+                console.log(JSON.stringify({ formId, layoutType, count: rows.length, fields: rows }, null, 2));
+            }
+            else {
+                console.error(`流程表单 ${formId}  布局=${layoutType}  字段=${rows.length}`);
+                for (const r of rows)
+                    console.log(`  ${r.system} ${String(r.id).padEnd(20)} ${String(r.componentKey).padEnd(14)} ${r.name}${r.children ? ` (明细×${r.children})` : ''}`);
+            }
+        }
+        catch (e) {
+            console.error(`读取失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    // ---------- wf-form add-field ----------
+    wfForm.command('add-field')
+        .description('给流程表单加字段（Text/TextArea/Number/Money/Date/DateTime/Select/Employee/Department/Browser）')
+        .argument('<formId>', '流程表单 formId')
+        .argument('<fieldName>', '字段名')
+        .argument('<fieldType>', '字段类型')
+        .argument('[title]', '字段显示名（不传同 fieldName）')
+        .option('--sub-form-id <id>', '在指定明细子表里加字段（明细表 subFormId）')
+        .option('--multiple', '多选（Employee/Department/Browser/下拉Select→SelectMultiple）')
+        .option('--precision <n>', '小数位（Number 缺省 0 / Money 缺省 2 / 百分比缺省 1）')
+        .option('--percent', 'Number 百分比显示（numberType=percentage）')
+        .option('--default <value>', 'Number/Money 默认值')
+        .option('--format <fmt>', '日期精度（Date 默认 yyyy-MM-dd / DateTime 默认 yyyy-MM-dd HH:mm）')
+        .action(async (formId, fieldName, fieldType, title, o) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const ebb = { ebbusinessid: formId };
+            const ck = canon(fieldType);
+            const colName = toColumnName(fieldName);
+            const [fieldId] = await genIds(client, baseUrl, 1);
+            if (!fieldId)
+                throw new Error('生成 fieldId 失败');
+            const jsonObj = {
+                type: ck, title: title || fieldName, fieldId, groupId: '-1', formId, showOrder: '0.00',
+                dataKey: colName, columnName: colName,
+            };
+            if (o.subFormId)
+                jsonObj.subFormId = o.subFormId; // 明细字段带 subFormId；formTableId 一律省略（流程表单无独立 formTableId）
+            if (ck === 'Number' || ck === 'Money') {
+                const isPercent = ck === 'Number' && o.percent === true;
+                const hasDefault = o.default !== undefined && o.default !== null && o.default !== '';
+                Object.assign(jsonObj, {
+                    pointSize: o.precision !== undefined ? o.precision : (isPercent ? '1' : (ck === 'Money' ? '2' : '0')),
+                    isDefault: hasDefault, isDelimiter: ck === 'Money', isCapital: false,
+                    capitalFormat: 'onlyUpperCase', capitalPosition: 'outside', capitalSetting: 'system',
+                    capitalPrecision: 'yuan', isExchangeRates: false,
+                    ...(ck === 'Number' ? { numberType: isPercent ? 'percentage' : 'number', content: hasDefault ? String(o.default) : '' } : {}),
+                    ...(hasDefault ? { stepMode: false, step: 1 } : {}),
+                });
+            }
+            else if (ck === 'TextArea') {
+                Object.assign(jsonObj, { content: '', maxLen: 4000 });
+            }
+            else if (ck === 'Date' || ck === 'DateTime') {
+                const fmt = o.format || (ck === 'DateTime' ? 'yyyy-MM-dd HH:mm' : 'yyyy-MM-dd');
+                Object.assign(jsonObj, { type: 'Date', format: fmt, placeholder: placeholderFromFormat(fmt), timePanelStyle: { type: 'system' }, isDefault: false });
+            }
+            else if (ck === 'Employee' || ck === 'Department' || ck === 'Browser') {
+                jsonObj.isSingle = o.multiple ? false : true;
+            }
+            else if (ck === 'Select') {
+                if (o.multiple) {
+                    jsonObj.type = 'SelectMultiple';
+                    jsonObj.componentKey = 'SelectMultiple';
+                }
+                // 选项需后续单独配（流程表单暂无 field-options 命令）
+            }
+            if (!jsonObj.componentKey)
+                jsonObj.componentKey = jsonObj.type;
+            const r = await client.post(`${baseUrl}${ROUTE}/field/manage/saveFormFieldNew`, { formId, module: MODULE, customParam: {}, jsonObj: JSON.stringify(jsonObj) }, ebb);
+            if (r?.code !== 200 || !r?.status)
+                throw new Error(`加字段失败: ${r?.msg || '未知错误'}`);
+            // 回读 getConfig 确认落库（主表字段查顶层 configs；明细字段查子表 children）
+            const { configs } = await readConfigs(client, baseUrl, formId);
+            const found = o.subFormId
+                ? (configs.find((c) => String(c.id) === String(o.subFormId))?.children || []).find((ch) => String(ch.id) === String(fieldId))
+                : configs.find((c) => String(c.id) === String(fieldId));
+            if (!found) {
+                console.error(`  ⚠ 接口返回成功但 getConfig 未回读到（可能未落库）`);
+                process.exitCode = 1;
+                return;
+            }
+            console.log(opts.json
+                ? JSON.stringify({ success: true, formId, fieldId, fieldName, componentKey: jsonObj.componentKey, subFormId: o.subFormId || undefined }, null, 2)
+                : `字段已加: ${fieldName} (${jsonObj.componentKey}) fieldId=${fieldId}${o.subFormId ? ` (明细 ${o.subFormId})` : ''}${ck === 'Select' ? '  注:选项需单独配' : ''}`);
+        }
+        catch (e) {
+            console.error(`加字段失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    // ---------- wf-form permission ----------
+    // 表单级字段权限：getFieldPermission 读可靠；saveFieldPermission 写在流程表单上平台多返 500（不可靠，
+    // 因流程表单字段权限属流程域——见 scaffold form-field-permission.md 第 139 行：工作流节点字段权限应用对应工作流接口）。
+    // 故本命令只提供 get（读）；写字段权限用 `workflow node field-permission`（节点级，已有）。
+    const permissionCmd = wfForm.command('permission').description('表单级字段权限查询（display/readOnly/required/disableEdit）。写权限用 workflow node field-permission（节点级）');
+    /** 递归找字段（configs 树，含明细 children）。 */
+    function findInTree(configs, ref) {
+        for (const c of configs) {
+            if (String(c.id) === ref || c.name === ref || c.dataKey === ref)
+                return c;
+            if (c.children?.length) {
+                const f = findInTree(c.children, ref);
+                if (f)
+                    return f;
+            }
+        }
+        return null;
+    }
+    permissionCmd.command('get')
+        .description('查看流程表单字段权限（display/readOnly/required/disableEdit）')
+        .argument('<formId>', '流程表单 formId')
+        .action(async (formId) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const meta = await getLayoutMeta(client, baseUrl, formId);
+            const r = await client.post(`${baseUrl}${ROUTE}/view/relate/getFieldPermission`, { module: MODULE, formId, permissionId: formId, showDelete: 0, customParam: {}, layoutId: meta.layoutId }, { ebbusinessid: formId });
+            if (r?.code !== 200 || !r?.status)
+                throw new Error(`getFieldPermission 失败: ${r?.msg}`);
+            const rows = [];
+            const walk = (nodes, depth = 0) => { for (const c of nodes) {
+                rows.push({ ...c, _d: depth });
+                if (c.children?.length)
+                    walk(c.children, depth + 1);
+            } };
+            walk(r?.data?.configs || []);
+            if (opts.json) {
+                console.log(JSON.stringify(rows, null, 2));
+                return;
+            }
+            for (const row of rows) {
+                const ind = '  '.repeat(row._d);
+                const flags = [row.display ? '' : '隐藏', row.readOnly ? '只读' : '', row.required ? '必填' : '', row.disableEdit ? '禁编辑' : ''].filter(Boolean).join('/') || '默认';
+                console.log(`${ind}${String(row.name).padEnd(10)} ${flags}`);
+            }
+        }
+        catch (e) {
+            console.error(`查询字段权限失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    // ---------- wf-form relate ----------
+    wfForm.command('relate')
+        .description('值带出联动：换表内 Employee/Department 字段自动填目标字段（如 换申请人→填邮箱/工号；换所属部门→填部门编号/上级部门）')
+        .argument('<formId>', '流程表单 formId')
+        .argument('<targetField>', '目标字段（被填充），用名称或 fieldId')
+        .requiredOption('--from <field>', '源字段（触发，Employee 或 Department 类型），用名称或 fieldId')
+        .option('--key <key>', '带出属性 key（Employee 源如 email/department/superior；Department 源如 code/name/parent）。默认 Employee=department、Department=name')
+        .option('--title <title>', '属性显示名（默认取属性清单中文名）')
+        .action(async (formId, targetField, cmdOpts) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const ebb = { ebbusinessid: formId };
+            // getConfig 解析字段（主表 + 明细 children）
+            const { configs } = await readConfigs(client, baseUrl, formId);
+            const allFields = [];
+            for (const c of configs) {
+                if (c.system)
+                    continue;
+                if (c.componentKey === 'DataTable' || c.type === 'DetailTable') {
+                    for (const ch of (c.children || []))
+                        allFields.push({ ...ch, isDetail: true });
+                }
+                else
+                    allFields.push({ ...c, isDetail: false });
+            }
+            const findField = (ref) => allFields.find((f) => f.name === ref || String(f.id) === ref || f.dataKey === ref);
+            const target = findField(targetField);
+            const source = findField(cmdOpts.from);
+            if (!target || !source)
+                throw new Error(`找不到字段: target="${targetField}" from="${cmdOpts.from}"。可用: ${allFields.map((f) => f.name).join(', ')}`);
+            const sourceKey = String(source.componentKey || source.type || '');
+            let sourceType;
+            if (/employee|user/i.test(sourceKey))
+                sourceType = 'Employee';
+            else if (/department|dept/i.test(sourceKey))
+                sourceType = 'Department';
+            else
+                throw new Error(`源字段「${source.name}」类型 ${sourceKey} 不支持值带出（仅 Employee/Department）`);
+            // 拉属性清单 → 校验 key/默认 key/title
+            const attrsRes = await client.post(`${baseUrl}${ROUTE}/business/listBusinessField`, { module: 'hrm', scenario: 'BROWSER_DATA_RELATE', browserParam: { module: 'hrm', type: sourceType === 'Employee' ? 'resource' : 'department' } }, ebb);
+            const attrs = Array.isArray(attrsRes?.data) ? attrsRes.data : [];
+            const defaultKey = sourceType === 'Employee' ? 'department' : 'name';
+            const key = cmdOpts.key || defaultKey;
+            let title = cmdOpts.title || '';
+            if (attrs.length) {
+                const attr = attrs.find((a) => a.valueKey === key);
+                if (!attr)
+                    throw new Error(`--key "${key}" 不是 ${sourceType} 可带出属性。可用: ${attrs.map((a) => a.valueKey).join(', ')}`);
+                title = title || attr.name;
+            }
+            else {
+                console.error('  警告: 拉取属性清单失败，key/title 未校验');
+            }
+            // 读目标字段全对象 → 注入 ffRelateField（Employee 源带 module:'hrm'，Department 不带）
+            const fData = await client.post(`${baseUrl}${ROUTE}/field/manage/getFormField`, { module: MODULE, formTableField: { formField: { id: String(target.id), form: { id: formId } } } }, ebb);
+            const jsonObj = { ...(fData?.data || {}) };
+            const relate = {
+                component: { key: jsonObj.type || 'Text' }, title, key, isMultiple: false, fieldId: String(source.id),
+            };
+            if (sourceType === 'Employee')
+                relate.module = 'hrm';
+            jsonObj.ffRelateField = relate;
+            const r = await client.post(`${baseUrl}${ROUTE}/field/manage/saveFormFieldNew`, { formId, module: MODULE, customParam: {}, jsonObj: JSON.stringify(jsonObj) }, ebb);
+            if (r?.code !== 200 || !r?.status)
+                throw new Error(`保存失败: ${r?.msg || '未知错误'}`);
+            console.log(opts.json
+                ? JSON.stringify({ success: true, formId, source: source.name, sourceType, target: target.name, key, title }, null, 2)
+                : `值带出已设置: 换「${source.name}」(${sourceType}) → 自动填「${target.name}」(属性 ${key}/${title})`);
+        }
+        catch (e) {
+            console.error(`设置值带出失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    // ---------- wf-form validate ----------
+    const validateCmd = wfForm.command('validate').description('字段查重校验规则（多字段 AND，重复禁止提交/提醒）');
+    validateCmd.command('list')
+        .description('查询流程表单的查重规则')
+        .argument('<formId>', '流程表单 formId')
+        .action(async (formId) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const res = await client.post(`${baseUrl}${ROUTE}/validate/pageFormDataValidate`, { module: MODULE, formId, pageNo: 1, pageSize: 100 }, { ebbusinessid: formId });
+            const rules = res?.data?.records || [];
+            if (opts.json) {
+                console.log(JSON.stringify(rules, null, 2));
+                return;
+            }
+            if (!rules.length) {
+                console.log('当前流程表单无查重规则');
+                return;
+            }
+            for (const r of rules) {
+                const method = r.treatmentMethod === 'REMINDER' ? '提醒' : '禁止提交';
+                const fields = (r.checkFields || []).map((c) => c.fieldName).join(' + ');
+                console.log(`[${r.id}] ${method} | ${fields} | ${r.helpContent || ''}`);
+            }
+        }
+        catch (e) {
+            console.error(`查询查重规则失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    validateCmd.command('add')
+        .description('新增查重规则（多字段 AND：所有字段值都重复才命中）')
+        .argument('<formId>', '流程表单 formId')
+        .argument('<fields...>', '查重字段名（可多个，如 "请假人" "开始时间"）')
+        .option('--help <text>', '重复时的提示内容', '字段值不允许重复')
+        .option('--remind', '重复时仅提醒允许提交（缺省禁止提交 NOSUBMISSION）')
+        .action(async (formId, fieldNames, cmdOpts) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const ebb = { ebbusinessid: formId };
+            // getConfig 解析字段（主表 subFormId=formId；明细 subFormId=子表 id）
+            const { configs } = await readConfigs(client, baseUrl, formId);
+            const candidates = [];
+            for (const c of configs) {
+                if (c.system)
+                    continue;
+                if (c.componentKey === 'DataTable' || c.type === 'DetailTable') {
+                    for (const ch of (c.children || []))
+                        candidates.push({ fieldName: ch.name, fieldId: String(ch.id), subFormId: String(c.id) });
+                }
+                else
+                    candidates.push({ fieldName: c.name, fieldId: String(c.id), subFormId: formId });
+            }
+            const checkFields = fieldNames.map((n) => {
+                const c = candidates.find((x) => x.fieldName === n || String(x.fieldId) === n);
+                if (!c)
+                    throw new Error(`未找到字段: ${n}，可用: ${candidates.map((x) => x.fieldName).join(', ')}`);
+                return c;
+            });
+            const payload = {
+                module: MODULE, formId,
+                treatmentMethod: cmdOpts.remind ? 'REMINDER' : 'NOSUBMISSION',
+                remindTime: 'SUB_REMIND', taggingColour: '#000000', subFieldCheckType: 'ALL_DATA',
+                helpContent: cmdOpts.help, checkFields,
+            };
+            const res = await client.post(`${baseUrl}${ROUTE}/validate/save`, payload, ebb);
+            if (res?.code !== 200 || !res?.status)
+                throw new Error(`保存失败: ${res?.msg || '未知错误'}`);
+            console.log(opts.json
+                ? JSON.stringify({ success: true, ruleId: res?.data?.id || '', fields: fieldNames, method: cmdOpts.remind ? 'REMINDER' : 'NOSUBMISSION' }, null, 2)
+                : `已保存查重规则: ${fieldNames.join(' + ')}（${cmdOpts.remind ? '提醒' : '禁止提交'}）ruleId=${res?.data?.id || ''}`);
+        }
+        catch (e) {
+            console.error(`新增查重规则失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    validateCmd.command('delete')
+        .description('删除查重规则')
+        .argument('<formId>', '流程表单 formId')
+        .argument('<ruleId>', '规则 ID（wf-form validate list 查看）')
+        .action(async (formId, ruleId) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const res = await client.post(`${baseUrl}${ROUTE}/validate/batchDelete`, { module: MODULE, formId, idList: [ruleId] }, { ebbusinessid: formId });
+            if (res?.code !== 200 || !res?.status)
+                throw new Error(`删除失败: ${res?.msg || '未知错误'}`);
+            console.log(`已删除查重规则 ${ruleId}`);
+        }
+        catch (e) {
+            console.error(`删除查重规则失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    // ---------- wf-form linkage ----------
+    wfForm.command('linkage')
+        .description('显隐联动管理（/api/workflow/core/form/setting/viewlinkage）')
+        .argument('<formId>', '流程表单 formId')
+        .argument('<name>', '联动名称')
+        .requiredOption('--config <json>', '联动配置 JSON：{"conditions":[{"field":"请假天数","operator":"EQUAL","value":"3"}],"actions":[{"prop":"hide","fields":["请假事由"]}]}。prop: hide/show/edit/readonly/required/hideLine；operator: EQUAL/NOT_EQUAL/GREATER/LESS/GREATER_EQUAL/LESS_EQUAL/EMPTY/NOT_EMPTY（默认 EQUAL）')
+        .action(async (formId, name, cmdOpts) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const ebb = { ebbusinessid: formId };
+            let cfg;
+            try {
+                cfg = JSON.parse(cmdOpts.config);
+            }
+            catch {
+                throw new Error('config JSON 解析失败');
+            }
+            if (!Array.isArray(cfg.conditions) || !Array.isArray(cfg.actions) || !cfg.actions.length) {
+                throw new Error('config 需含 conditions[] 和非空 actions[]');
+            }
+            const SUPPORTED = ['hide', 'show', 'edit', 'readonly', 'required', 'hideLine', 'hideRow'];
+            const badProp = cfg.actions.find((a) => !a.prop || !SUPPORTED.includes(String(a.prop)));
+            if (badProp)
+                throw new Error(`action prop 不支持（仅 ${SUPPORTED.join(',')}）`);
+            // getConfig 解析字段名 → fieldId/dataKey/componentKey（主表 + 明细 children）
+            const { configs } = await readConfigs(client, baseUrl, formId);
+            const allFields = [];
+            for (const c of configs) {
+                if (c.system)
+                    continue;
+                if (c.componentKey === 'DataTable' || c.type === 'DetailTable') {
+                    for (const ch of (c.children || []))
+                        allFields.push({ ...ch, isDetail: true, detailId: c.id, detailName: c.name });
+                }
+                else
+                    allFields.push({ ...c, isDetail: false });
+            }
+            const findField = (name) => allFields.find((f) => f.name === name || String(f.id) === name || f.dataKey === name);
+            const formName = configs.find((c) => !c.system)?.name ? '流程表单' : '流程表单';
+            // conditions
+            const conditionDetails = cfg.conditions.map((c) => {
+                const f = findField(c.field);
+                if (!f)
+                    throw new Error(`条件字段未找到: "${c.field}"，可用: ${allFields.map((x) => x.name).join(', ')}`);
+                return {
+                    targetId: String(f.id), detailSymbol: c.operator || 'EQUAL', sourceType: 'CONSTANT',
+                    sourceContent: JSON.stringify(c.options ? { formField: { id: String(f.id) }, dataOptions: c.options } : { formField: { id: String(f.id) }, content: c.value !== undefined ? String(c.value) : '' }),
+                };
+            });
+            // actions
+            const linkageDetails = cfg.actions.map((a) => ({
+                formId, id: '0', linkageObj: 'field', linkageProp: a.prop,
+                linkageShowValue: a.fields.map((fname) => {
+                    const f = findField(fname);
+                    if (!f)
+                        throw new Error(`联动目标字段未找到: "${fname}"，可用: ${allFields.map((x) => x.name).join(', ')}`);
+                    return { dataKey: f.dataKey || '', groupName: '表单字段', address: f.isDetail ? '明细表' : '主表', addressType: f.isDetail ? 'detail' : 'form', groupId: 'formField', name: f.name, descType: f.componentKey || '', id: String(f.id), content: f.name, desc: '' };
+                }),
+                detailOptions: [],
+            }));
+            const payload = {
+                fdEffect: { formId, effectModule: MODULE, effectType: 'form', effectName: '当前表单', optionList: [{ effectValue: formId, effectName: '当前表单' }] },
+                condition: { targetId: formId, targetName: formName, targetModule: MODULE, conditionType: 'FIELD', conditionDetails, formulaId: '', formulaName: '' },
+                linkageDetails,
+                module: MODULE, formId, refId: formId, enableState: '1', linkageName: name, customParam: {},
+            };
+            const r = await client.post(`${baseUrl}${ROUTE}/setting/viewlinkage/add`, payload, ebb);
+            if (r?.code !== 200 || !r?.status)
+                throw new Error(`联动添加失败: ${r?.msg || '未知错误'}`);
+            console.log(opts.json
+                ? JSON.stringify({ success: true, formId, linkageName: name, conditions: cfg.conditions.length, actions: cfg.actions.length }, null, 2)
+                : `联动已添加: ${name}（${cfg.conditions.length} 条件 → ${cfg.actions.length} 动作）`);
+        }
+        catch (e) {
+            console.error(`添加联动失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    // ---------- wf-form formula ----------
+    const formulaCmd = wfForm.command('formula').description('字段函数公式（/api/excel/formula/*，module=workflow）');
+    /** 解析 {主表.字段} / {明细表名.字段} 引用 → FormulaParam（用 getConfig 解析字段）。 */
+    async function buildWfFormulaParams(client, baseUrl, formId, expression) {
+        const errors = [];
+        const parameters = [];
+        const refNames = [];
+        const refRegex = /\{(?:主表|([^.}]+))\.([^}]+)\}/g;
+        const refs = [];
+        let m;
+        while ((m = refRegex.exec(expression)) !== null) {
+            const t = m[1] ? m[1].trim() : '主表';
+            const f = m[2].trim();
+            if (!refs.some(r => r.table === t && r.field === f))
+                refs.push({ table: t, field: f });
+        }
+        if (refs.length === 0) {
+            errors.push('表达式中未找到 {主表.字段名} 或 {明细表名.字段名} 引用');
+            return { parameters, errors, refNames };
+        }
+        const { configs } = await readConfigs(client, baseUrl, formId);
+        const mainFind = (name) => configs.find((c) => String(c.id) === name || c.name === name || c.dataKey === name);
+        for (const ref of refs) {
+            refNames.push(`${ref.table}.${ref.field}`);
+            if (ref.table === '主表') {
+                const f = mainFind(ref.field);
+                if (!f) {
+                    errors.push(`未找到主表字段: "${ref.field}"，可用: ${configs.filter((c) => !c.system).map((x) => x.name).join(', ')}`);
+                    continue;
+                }
+                parameters.push({ dataTemplateId: '', fieldId: String(f.id), formId, module: MODULE, properKey: f.componentKey || 'Text', title: f.name || ref.field, name: f.name || ref.field, appId: '', id: null });
+            }
+            else {
+                const dt = configs.find((c) => (c.componentKey === 'DataTable' || c.type === 'DetailTable') && (c.name === ref.table || String(c.id) === ref.table));
+                if (!dt) {
+                    errors.push(`未找到明细表: "${ref.table}"`);
+                    continue;
+                }
+                const ch = (dt.children || []).find((x) => String(x.id) === ref.field || x.name === ref.field || x.dataKey === ref.field);
+                if (!ch) {
+                    errors.push(`明细表「${ref.table}」中未找到字段: "${ref.field}"`);
+                    continue;
+                }
+                parameters.push({ dataTemplateId: '', fieldId: String(ch.id), formId, module: MODULE, properKey: ch.componentKey || 'Text', sFormId: String(dt.id), sFormName: dt.name, title: ch.name || ref.field, name: ch.name || ref.field, appId: '', id: null });
+            }
+        }
+        return { parameters, errors, refNames };
+    }
+    formulaCmd.command('set')
+        .description('给流程表单字段绑定计算公式')
+        .argument('<formId>', '流程表单 formId')
+        .requiredOption('--expression <expr>', '公式表达式，如 "DAYS({主表.开始时间},{主表.结束时间})"')
+        .requiredOption('--target <fieldId>', '目标字段 ID（公式结果写入此字段）')
+        .option('--name <name>', '公式名称（默认自动生成）')
+        .option('--return-type <type>', '返回类型: Number / String / Date', 'Number')
+        .action(async (formId, cmdOpts) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const ebb = { ebbusinessid: formId };
+            const parsed = await buildWfFormulaParams(client, baseUrl, formId, cmdOpts.expression);
+            if (parsed.errors.length) {
+                for (const e of parsed.errors)
+                    console.error(`  ❌ ${e}`);
+                process.exitCode = 1;
+                return;
+            }
+            const formulaName = cmdOpts.name || `公式_${Date.now()}`;
+            const savePayload = {
+                expressSql: cmdOpts.expression, name: formulaName, parameters: parsed.parameters,
+                returnType: cmdOpts.returnType, validateType: 'normal', referenceType: 'assign',
+                extendParam: JSON.stringify({ exceptIds: cmdOpts.target, createType: 'once' }),
+                formulaId: null, dataSources: [], formulaType: 'normal', mainDataSource: [null],
+                tempVariableList: [], nameAuto: false, module: MODULE, multiFuncSepType: 1,
+            };
+            const saveRes = await client.post(`${baseUrl}/api/excel/formula/save`, savePayload);
+            if (!saveRes?.resultJson?.excute)
+                throw new Error(`公式保存失败: ${saveRes?.resultJson?.error || saveRes?.msg || '未知错误'}`);
+            const expressId = saveRes.resultJson.id;
+            console.error(`  公式已创建: ${expressId} (${saveRes.resultJson.formula})`);
+            // ffExpress 绑字段（saveFormFieldNew 重存带 ffExpress）
+            try {
+                const gf = await client.post(`${baseUrl}${ROUTE}/field/manage/getFormField`, { module: MODULE, formTableField: { formField: { id: cmdOpts.target, form: { id: formId } } } }, ebb);
+                const cur = gf?.data || {};
+                if (cur.fieldId) {
+                    await client.post(`${baseUrl}${ROUTE}/field/manage/saveFormFieldNew`, { formId, module: MODULE, customParam: {}, jsonObj: JSON.stringify({ ...cur, ffExpress: { id: expressId, name: formulaName } }) }, ebb);
+                }
+            }
+            catch { /* 不阻断 */ }
+            // saveSourceForm 注册源
+            await client.post(`${baseUrl}/api/excel/formula/library/saveSourceForm`, { sourceForms: [{ id: formId, module: MODULE }], expressId, filter: { fieldId: cmdOpts.target } });
+            console.log(opts.json
+                ? JSON.stringify({ success: true, expressId, formula: saveRes.resultJson.formula, targetField: cmdOpts.target }, null, 2)
+                : `公式已绑定到字段 ${cmdOpts.target}: ${saveRes.resultJson.formula}`);
+        }
+        catch (e) {
+            console.error(`绑定公式失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    formulaCmd.command('get')
+        .description('查看公式详情')
+        .argument('<formulaId>', '公式 ID (expressId)')
+        .action(async (formulaId) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const res = await client.post(`${baseUrl}/api/excel/formula/detail`, { formulaId });
+            const data = res?.resultJson?.data;
+            if (!data || !res?.resultJson?.excute)
+                throw new Error(`查询失败: ${res?.resultJson?.error || res?.msg || '未找到公式'}`);
+            if (opts.json)
+                console.log(JSON.stringify(data, null, 2));
+            else {
+                console.log(`公式 ID: ${data.id}\n名称: ${data.name}\n表达式: ${data.expressSql || '-'}\n返回类型: ${data.returnType || '-'}`);
+                console.log(`参数 (${(data.parameters || []).length}):`);
+                for (const p of (data.parameters || []))
+                    console.log(`  ${p.fieldId}  ${p.title || p.name}  [${p.properKey}]`);
+            }
+        }
+        catch (e) {
+            console.error(`查询公式失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    formulaCmd.command('list')
+        .description('列出流程表单的所有公式')
+        .argument('<formId>', '流程表单 formId')
+        .action(async (formId) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const searchRes = await client.post(`${baseUrl}/api/excel/formula/library/search`, { sourceForms: [{ id: formId, module: MODULE }] });
+            const all = searchRes?.page?.result || [];
+            const formulas = all.filter((f) => {
+                try {
+                    const p = JSON.parse(f.parameter || '{}');
+                    const vars = JSON.parse(p.formulavars || '[]');
+                    return vars.some((v) => v.formId === formId);
+                }
+                catch {
+                    return false;
+                }
+            });
+            if (opts.json)
+                console.log(JSON.stringify(formulas, null, 2));
+            else {
+                console.log(`共 ${formulas.length} 个公式 (全租户 ${all.length} 个):`);
+                for (const f of formulas) {
+                    let expr = '';
+                    try {
+                        const d = await client.post(`${baseUrl}/api/excel/formula/detail`, { formulaId: f.id });
+                        expr = d?.resultJson?.data?.expressSql || '';
+                    }
+                    catch { }
+                    console.log(`  [${f.id}] ${f.name}  → ${expr || f.formula || '-'}`);
+                }
+            }
+        }
+        catch (e) {
+            console.error(`列出公式失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    formulaCmd.command('functions')
+        .description('查看可用函数列表')
+        .option('--category <name>', '按分类名或中文名过滤')
+        .action(async (cmdOpts) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const res = await client.post(`${baseUrl}/api/excel/formula/funcList`, { extendParam: JSON.stringify({ createType: 'once' }) });
+            const cats = res?.data || [];
+            if (opts.json)
+                console.log(JSON.stringify(cats, null, 2));
+            else
+                for (const cat of cats) {
+                    const cn = cat.chineseName || cat.name || '未分类';
+                    if (cmdOpts.category && !cn.includes(cmdOpts.category) && cn !== cmdOpts.category)
+                        continue;
+                    console.log(`\n📁 ${cn} (${(cat.children || []).length})`);
+                    for (const fn of (cat.children || []))
+                        console.log(`  ${fn.name.padEnd(20)} ${fn.chineseName || ''}  → ${fn.returnType || '?'}`);
+                }
+        }
+        catch (e) {
+            console.error(`查询函数失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    // ---------- wf-form edit-field ----------
+    wfForm.command('edit-field')
+        .description('编辑流程表单已有字段（read-modify-write：getFormField 读全字段 → 改 → saveFormFieldNew 重存）')
+        .argument('<formId>', '流程表单 formId')
+        .argument('<fieldId>', '字段 fieldId')
+        .option('--title <title>', '修改字段标题')
+        .option('--multiple', '设为多选（Employee/Department/Browser isSingle=false；Select→SelectMultiple）')
+        .option('--single', '设为单选（反向）')
+        .action(async (formId, fieldId, o) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const ebb = { ebbusinessid: formId };
+            // 读全字段
+            const fData = await client.post(`${baseUrl}${ROUTE}/field/manage/getFormField`, { module: MODULE, formTableField: { formField: { id: fieldId, form: { id: formId } } } }, ebb);
+            const jsonObj = fData?.data || {};
+            if (!jsonObj.fieldId)
+                throw new Error(`getFormField 未读到字段 fieldId=${fieldId}`);
+            const changes = [];
+            if (o.title !== undefined) {
+                jsonObj.title = o.title;
+                changes.push(`title="${o.title}"`);
+            }
+            if (o.multiple === true || o.single === true) {
+                const multi = o.multiple === true;
+                const t = jsonObj.type;
+                if (t === 'Employee' || t === 'Department' || t === 'Browser') {
+                    jsonObj.isSingle = !multi;
+                    changes.push(`isSingle=${!multi}`);
+                }
+                else if (t === 'Select' || t === 'SelectMultiple') {
+                    jsonObj.type = multi ? 'SelectMultiple' : 'Select';
+                    jsonObj.componentKey = jsonObj.type;
+                    changes.push(`type=${jsonObj.type}`);
+                }
+                else {
+                    throw new Error(`字段类型 ${t} 不支持多选切换（仅 Employee/Department/Browser/Select）`);
+                }
+            }
+            if (changes.length === 0)
+                throw new Error('未指定要修改的属性（--title / --multiple / --single）');
+            const r = await client.post(`${baseUrl}${ROUTE}/field/manage/saveFormFieldNew`, { formId, module: MODULE, customParam: {}, jsonObj: JSON.stringify(jsonObj) }, ebb);
+            if (r?.code !== 200 || !r?.status)
+                throw new Error(`编辑失败: ${r?.msg || '未知错误'}`);
+            // 回读确认
+            const r2 = await client.post(`${baseUrl}${ROUTE}/field/manage/getFormField`, { module: MODULE, formTableField: { formField: { id: fieldId, form: { id: formId } } } }, ebb);
+            const after = r2?.data || {};
+            console.log(opts.json
+                ? JSON.stringify({ success: true, formId, fieldId, title: after.title, type: after.type, isSingle: after.isSingle }, null, 2)
+                : `字段已编辑: ${after.title} (${after.type})${after.isSingle !== undefined ? ` isSingle=${after.isSingle}` : ''}  改了 ${changes.join(', ')}`);
+        }
+        catch (e) {
+            console.error(`编辑字段失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    // ---------- wf-form field-options ----------
+    wfForm.command('field-options')
+        .description('给流程表单 Select/SelectMultiple 字段配选项（read-modify-write：getFormField 读全字段 → 改 options → saveFormFieldNew 重存）')
+        .argument('<formId>', '流程表单 formId')
+        .argument('<fieldId>', 'Select/SelectMultiple 字段 fieldId')
+        .requiredOption('--options <json>', '选项列表 [{"name":"事假"},...] 或 @文件路径')
+        .option('--default <valueKey>', '默认选项 valueKey（序号字符串，如 "0"）')
+        .action(async (formId, fieldId, cmdOpts) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const ebb = { ebbusinessid: formId };
+            // 解析选项
+            let optStr = cmdOpts.options;
+            if (optStr.startsWith('@')) {
+                const { readFileSync, existsSync } = await import('node:fs');
+                if (!existsSync(optStr.slice(1)))
+                    throw new Error('选项文件不存在');
+                optStr = readFileSync(optStr.slice(1), 'utf-8');
+            }
+            let optionDefs;
+            try {
+                optionDefs = JSON.parse(optStr);
+            }
+            catch {
+                throw new Error('选项 JSON 解析失败');
+            }
+            if (!Array.isArray(optionDefs) || optionDefs.length === 0)
+                throw new Error('--options 必须是非空数组');
+            // 读全字段对象（read-modify-write）
+            const fData = await client.post(`${baseUrl}${ROUTE}/field/manage/getFormField`, { module: MODULE, formTableField: { formField: { id: fieldId, form: { id: formId } } } }, ebb);
+            const currentField = fData?.data || {};
+            if (!currentField.fieldId)
+                throw new Error(`getFormField 未读到字段 fieldId=${fieldId}`);
+            if (currentField.type !== 'Select' && currentField.type !== 'SelectMultiple') {
+                throw new Error(`字段类型 ${currentField.type} 不支持配选项（仅 Select/SelectMultiple）`);
+            }
+            // 构造 options（对齐浏览器抓包形状：selectionId 空让平台自动生成雪花，valueKey 用序号字符串）
+            const options = optionDefs.map((o, i) => {
+                const vk = String(o.valueKey ?? i);
+                return {
+                    componentKey: 'Option', name: o.name, order: i,
+                    selectionId: '', defOption: cmdOpts.default === vk,
+                    uid: randomUUID(), other: false, archive: false, isLimit: false,
+                    optionNum: '1000000', score: '0',
+                    styleConfig: { OptionBackground: OPTION_COLORS[i % OPTION_COLORS.length] },
+                    valueKey: vk,
+                };
+            });
+            // 合并重存（保留 currentField 全部属性，只替换 options）
+            const jsonObj = { ...currentField, options };
+            const r = await client.post(`${baseUrl}${ROUTE}/field/manage/saveFormFieldNew`, { formId, module: MODULE, customParam: {}, jsonObj: JSON.stringify(jsonObj) }, ebb);
+            if (r?.code !== 200 || !r?.status)
+                throw new Error(`配选项失败: ${r?.msg || '未知错误'}`);
+            // 回读确认
+            const r2 = await client.post(`${baseUrl}${ROUTE}/field/manage/getFormField`, { module: MODULE, formTableField: { formField: { id: fieldId, form: { id: formId } } } }, ebb);
+            const saved = (r2?.data?.options || []).map((o) => `${o.name}(vk=${o.valueKey}${o.defOption ? ',默认' : ''})`);
+            console.log(opts.json
+                ? JSON.stringify({ success: true, formId, fieldId, options: saved }, null, 2)
+                : `选项已配置: ${currentField.title} → ${saved.join(', ')}`);
+        }
+        catch (e) {
+            console.error(`配选项失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    // ---------- wf-form add-detail-table ----------
+    wfForm.command('add-detail-table')
+        .description('给流程表单加明细子表（saveSubForm 建子表 + 加首字段使其可见；--init 放入布局）')
+        .argument('<formId>', '流程表单 formId')
+        .argument('<name>', '明细表名')
+        .argument('[firstFieldName]', '首字段名（强烈建议传；空子表 getConfig 读不到）')
+        .option('--data-key <k>', '子表物理表名/dataKey（默认 uf_拼音_随机）')
+        .option('--init', '创建后跑 layout init 放入 DetailTable 组件')
+        .option('--first-field-type <t>', '首字段类型（默认 Text）')
+        .action(async (formId, name, firstFieldName, o) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const ebb = { ebbusinessid: formId };
+            const [subFormId] = await genIds(client, baseUrl, 1);
+            if (!subFormId)
+                throw new Error('生成 subFormId 失败');
+            const dataKey = o.dataKey || toSubTableName(name);
+            const subRes = await client.post(`${baseUrl}${ROUTE}/field/manage/saveSubForm`, {
+                physicalTable: true, order: 0, subFormId, type: 'DetailTable',
+                customParam: {}, module: MODULE, dataKey, tableName: dataKey,
+                formTable: { id: formId, form: { id: subFormId, name, order: '0.00' } },
+            }, ebb);
+            if (subRes?.code !== 200 || !subRes?.status)
+                throw new Error(`saveSubForm 失败: ${subRes?.msg}`);
+            console.error(`  子表已建: subFormId=${subFormId}  name=${name}  dataKey=${dataKey}`);
+            let firstFieldId = '';
+            if (firstFieldName) {
+                const [fid] = await genIds(client, baseUrl, 1);
+                firstFieldId = fid;
+                const ftype = canon(o.firstFieldType || 'Text');
+                const fo = {
+                    type: ftype, title: firstFieldName, fieldId: firstFieldId, groupId: '-1', formId, showOrder: '0.00',
+                    dataKey: toSubTableName(firstFieldName).replace(/^uf_/, ''), columnName: toSubTableName(firstFieldName).replace(/^uf_/, ''),
+                    componentKey: ftype, subFormId,
+                };
+                const fRes = await client.post(`${baseUrl}${ROUTE}/field/manage/saveFormFieldNew`, { formId, module: MODULE, customParam: {}, jsonObj: JSON.stringify(fo) }, ebb);
+                if (fRes?.code !== 200 || !fRes?.status)
+                    throw new Error(`加首字段失败: ${fRes?.msg}`);
+                console.error(`  首字段已加: ${firstFieldName} (${firstFieldId})`);
+            }
+            else {
+                console.error('  ⚠ 未传首字段：子表已建但空子表 getConfig 读不到，需手动加字段后才可 init 放置');
+            }
+            let compCount = 0;
+            if (o.init) {
+                if (!firstFieldName)
+                    throw new Error('--init 需配合首字段名（空子表放不了 DetailTable）');
+                const meta = await getLayoutMeta(client, baseUrl, formId);
+                const cfg = await client.post(`${baseUrl}${ROUTE}/view/relate/getConfig`, {
+                    formId, module: MODULE, apiModule: 'workflow/form', layoutId: meta.layoutId,
+                    customParam: { terminal: '', objId: formId }, initMode: 5, groupFieldIds: [],
+                    designerParam: { sourceModule: MODULE },
+                }, ebb);
+                const configs = normalizeDetailTableChildren((cfg?.data?.configs || []).map((c) => {
+                    const isBusiness = !c.system && c.componentKey !== 'DataTable' && c.type !== 'DetailTable';
+                    const out = { ...c, display: c.system ? c.display : true, show: c.system ? c.show : true };
+                    if (isBusiness) {
+                        out.readOnly = false;
+                        out.disableEdit = false;
+                    } // FLOW 默认锁，强制可编辑
+                    return out;
+                }));
+                const styleTemplateId = meta.layoutType === 'FLOW' ? '820000000000000001' : '700000000000000008';
+                const initRes = await client.post(`${baseUrl}${ROUTE}/view/relate/initLayout`, {
+                    formId, module: MODULE, apiModule: 'workflow/form', layoutId: meta.layoutId, generateCollapse: true,
+                    styleTemplateId, styleTemplateType: 1, configs, addLayout: false, ecodeType: ['js', 'css'],
+                    initMode: '1', customParam: { terminal: '', objId: formId },
+                    formLayoutMultiple: { isSys: true, id: meta.layoutMultiId, name: meta.layoutName, terminalType: 'PC', layoutType: meta.layoutType },
+                    designerParam: { onlyLayout: false },
+                }, ebb);
+                if (initRes?.code !== 200 || !initRes?.status)
+                    throw new Error(`initLayout 失败: ${initRes?.msg}`);
+                compCount = initRes?.data?.pageLayouts?.[0]?.comps?.length || initRes?.data?.formLayout?.pageLayouts?.[0]?.comps?.length || 0;
+                console.error(`  布局已 init: 组件 ${compCount} 个（含 DetailTable）`);
+            }
+            console.log(opts.json
+                ? JSON.stringify({ success: true, formId, subFormId, name, dataKey, firstFieldId, initComps: compCount || undefined }, null, 2)
+                : `明细子表已建: ${name}  subFormId=${subFormId}${firstFieldName ? `  首字段=${firstFieldName}` : ''}${o.init ? `  已 init 放入布局` : '  (未 init，跑 wf-form layout init 放置)'}`);
+            if (!opts.json && !o.init) {
+                console.log('  后续加字段: e10-cli wf-form add-field <formId> <字段名> <类型> --sub-form-id ' + subFormId);
+            }
+        }
+        catch (e) {
+            console.error(`加明细子表失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    // ---------- wf-form layout init ----------
+    const layoutCmd = wfForm.command('layout').description('布局管理');
+    layoutCmd.command('init')
+        .description('初始化/重建流程表单布局（initLayout）：按 layoutType 选模板（FLOW 默认）+ 设字段 readOnly/required/singleRow')
+        .argument('<formId>', '流程表单 formId')
+        .option('--style-template <name|id>', '样式模板 id（默认按 layoutType：FLOW=820...01 / EXCEL=700...08）')
+        .option('--read-only', '字段只读')
+        .option('--required', '字段必填')
+        .option('--single-row', '独占一行')
+        .option('--generate-collapse', '生成折叠分组')
+        .action(async (formId, o) => {
+        try {
+            const opts = program.opts();
+            const auth = await AuthSession.fromOptions(opts);
+            if (!auth)
+                throw new Error('无法加载认证');
+            const client = new ApiClient(auth);
+            const baseUrl = auth.getBaseUrl();
+            const ebb = { ebbusinessid: formId };
+            const meta = await getLayoutMeta(client, baseUrl, formId);
+            if (!meta.layoutId)
+                throw new Error('无法获取 layoutId');
+            const cfgRes = await client.post(`${baseUrl}${ROUTE}/view/relate/getConfig`, {
+                formId, module: MODULE, apiModule: 'workflow/form', layoutId: meta.layoutId,
+                customParam: { terminal: '', objId: formId }, initMode: 5, groupFieldIds: [],
+                designerParam: { sourceModule: MODULE },
+            }, ebb);
+            // 流程表单 FLOW 布局 getConfig 默认把业务字段 readOnly=true（锁死），init 时强制可编辑：
+            // 业务字段 readOnly=false / disableEdit=false（除非 --read-only 显式锁）；明细/系统字段保留。
+            const configs = normalizeDetailTableChildren((cfgRes?.data?.configs || []).map((c) => {
+                const isBusiness = !c.system && c.componentKey !== 'DataTable' && c.type !== 'DetailTable';
+                const out = { ...c, display: c.system ? c.display : true, show: c.system ? c.show : true };
+                if (isBusiness) {
+                    out.readOnly = o.readOnly === true;
+                    out.disableEdit = false;
+                    if (o.required !== undefined)
+                        out.required = o.required;
+                    if (o.singleRow !== undefined)
+                        out.singleRow = o.singleRow;
+                }
+                return out;
+            }));
+            const styleTemplateId = o.styleTemplate
+                || (meta.layoutType === 'FLOW' ? '820000000000000001' : '700000000000000008');
+            const initRes = await client.post(`${baseUrl}${ROUTE}/view/relate/initLayout`, {
+                formId, module: MODULE, apiModule: 'workflow/form', layoutId: meta.layoutId,
+                generateCollapse: o.generateCollapse !== false,
+                styleTemplateId: /^\d+$/.test(styleTemplateId) ? styleTemplateId : styleTemplateId, styleTemplateType: 1,
+                configs, addLayout: false, ecodeType: ['js', 'css'], initMode: '1',
+                customParam: { terminal: '', objId: formId },
+                formLayoutMultiple: { isSys: true, id: meta.layoutMultiId, name: meta.layoutName, terminalType: 'PC', layoutType: meta.layoutType },
+                designerParam: { onlyLayout: false },
+            }, ebb);
+            if (initRes?.code !== 200 || !initRes?.status)
+                throw new Error(`initLayout 失败: ${initRes?.msg}`);
+            const comps = initRes?.data?.pageLayouts?.[0]?.comps || initRes?.data?.formLayout?.pageLayouts?.[0]?.comps || [];
+            console.log(opts.json
+                ? JSON.stringify({ success: true, formId, layoutType: meta.layoutType, styleTemplateId, comps: comps.length }, null, 2)
+                : `布局已初始化: 类型=${meta.layoutType} 模板=${styleTemplateId} 组件=${comps.length}`);
+        }
+        catch (e) {
+            console.error(`初始化布局失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
+    return wfForm;
+}
+//# sourceMappingURL=wf-form.js.map