weaver-e10-builder 1.1.9 → 1.2.3

package/dist/commands/wf-form.js

@@ -2,6 +2,9 @@ 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 { getRichType, resolveBrowserConfig, richIdUnits, BROWSER_TYPE_CATALOG } from '../services/rich-types.js';
+import { dropFieldComponents, prepareLayoutForSave } from '../services/form-field-drop.js';
+import { BROWSER_BEAN_SEARCH, pickBrowserBean, browserBeanCandidates, toBrowserType } from '../services/browser.js';
 import { randomUUID } from 'node:crypto';
 /** 流程表单选项配色（对齐浏览器抓包 styleConfig.OptionBackground，循环取用）。 */
 const OPTION_COLORS = ['#FFBD4F', '#FF716E', '#3BD8C3', '#5B8FF9', '#5AD8A6', '#F6BD16', '#E86452', '#6DC8EC', '#945FB9', '#FF99C3'];
@@ -30,9 +33,11 @@ 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',
+        // 平台的浏览按钮类型名是 RelateBrowser（不是 Browser）——写错会被拒「程序异常」
+        employee: 'Employee', department: 'Department', browser: 'RelateBrowser',
+        relatebrowser: 'RelateBrowser', 浏览: 'RelateBrowser',
         file: 'FileComponent', filecomponent: 'FileComponent', upload: 'FileComponent', 附件: 'FileComponent',
-        ebuilder: 'Ebuilder', eb: 'Ebuilder', flow: 'Flow',
+        ebuilder: 'EBuilder', eb: 'EBuilder', flow: 'Flow',
     };
     return m[ck.toLowerCase()] || ck;
 }
@@ -61,32 +66,33 @@ async function readConfigs(client, baseUrl, formId) {
  *  getConfig 的 configs 不带已保存的 singleRow（设计视图默认 false）；field-prop/group/layout init
  *  重排前若不从运行时合并回来，独占一行字段会被 initLayout 冲掉（实测：group initLayout 后 客户地址 singleRow 丢失）。 */
 async function fetchRuntimeSingleRows(client, baseUrl, formId) {
-    try {
-        const res = await client.post(`${baseUrl}${ROUTE}/builder/getFormLayout`, {
-            formId, module: MODULE, customParam: {}, formTableIdList: [],
-            designerParam: { onlyLayout: false, convert: false }, form: { id: formId },
-        }, { ebbusinessid: formId });
-        const pls = res?.data?.formLayout?.pageLayouts || res?.data?.pageLayouts || [];
-        const comps = pls[0]?.comps || [];
-        const set = new Set();
-        const walk = (arr) => {
-            for (const x of arr) {
-                const cfg = x.config || x;
-                const fid = cfg.fieldId || cfg.id || x.id;
-                if (fid && cfg.singleRow === true)
-                    set.add(String(fid));
-                if (x.components?.length)
-                    walk(x.components);
-                if (x.children?.length)
-                    walk(x.children);
-            }
-        };
-        walk(comps);
-        return set;
-    }
-    catch {
-        return new Set();
+    // 读失败**必须抛错**：这里返回空 Set 等于「运行时一个 singleRow 都没有」，
+    // 后面的 initLayout 就会把用户已配的「独占一行」整批冲掉（历史上出过这个事故）。
+    // 宁可整条命令失败，也不静默丢配置。
+    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 pls = res?.data?.formLayout?.pageLayouts || res?.data?.pageLayouts || [];
+    const comps = pls[0]?.comps || [];
+    const set = new Set();
+    const walk = (arr) => {
+        for (const x of arr) {
+            const cfg = x.config || x;
+            const fid = cfg.fieldId || cfg.id || x.id;
+            if (fid && cfg.singleRow === true)
+                set.add(String(fid));
+            if (x.components?.length)
+                walk(x.components);
+            if (x.children?.length)
+                walk(x.children);
+        }
+    };
+    walk(comps);
+    return set;
 }
 /** 将运行时已保存的 singleRow 合并回 getConfig configs（递归含 Collapse children），保留独占一行不被重排冲掉。 */
 function mergeRuntimeSingleRow(configs, srSet) {
@@ -145,21 +151,30 @@ function applyLoneSingleRows(configs) {
 // getFieldGroupPage 返回全部主表字段，字段 formField.group 带 groupId+groupName；
 // refFieldId = groupId - 1（平台先分配 layout config 再分配 formFieldGroup，顺序相连）。
 // 用于 field-prop / layout init 重跑 initLayout 时保留 Collapse 折叠分组。
-async function fetchFormGroups(client, baseUrl, formId) {
-    try {
-        const r = await client.post(`${baseUrl}${ROUTE}/field/manage/getFieldGroupPage`, { pageNo: 1, pageSize: 100, module: MODULE, formFieldSearchEntity: { formId }, customParam: {} }, { ebbusinessid: formId });
+/** 读该表单的全部字段分组条目（翻页取全；**读失败抛错**，不静默当成「没有分组」）。 */
+async function fetchFormGroupEntries(client, baseUrl, formId) {
+    const PAGE = 100;
+    const out = [];
+    for (let pageNo = 1;; pageNo++) {
+        const r = await client.post(`${baseUrl}${ROUTE}/field/manage/getFieldGroupPage`, { pageNo, pageSize: PAGE, module: MODULE, formFieldSearchEntity: { formId }, customParam: {} }, { ebbusinessid: formId });
+        if (r?.code !== 200 || !r?.status) {
+            throw new Error(`读取字段分组失败（getFieldGroupPage 第 ${pageNo} 页）: ${r?.msg || '未知错误'}`);
+        }
         const list = r?.data?.pageDatas?.result || [];
-        const seen = new Set();
         for (const f of list) {
             const g = f?.formField?.group;
             if (g?.id)
-                seen.add(String(g.id));
+                out.push(g);
         }
-        return [...seen].map((id) => String(BigInt(id) - 1n));
-    }
-    catch {
-        return [];
+        if (list.length < PAGE)
+            break;
     }
+    return out;
+}
+/** 字段分组的 refFieldId 列表（= groupId - 1）。 */
+async function fetchFormGroups(client, baseUrl, formId) {
+    const groups = await fetchFormGroupEntries(client, baseUrl, formId);
+    return [...new Set(groups.map((g) => String(g.id)))].map((id) => String(BigInt(id) - 1n));
 }
 /** 初始化/重建流程表单布局（initLayout）：getConfig 读 → 强制业务字段 readOnly=false（防 FLOW 模板默认锁死）
  *  → 合并运行时 singleRow → applyLoneSingleRows（落单/孤字段独占整行）→ initLayout 落库运行时布局。
@@ -177,6 +192,10 @@ export async function initWorkflowFormLayout(client, baseUrl, formId, o = {}, ho
         customParam: { terminal: '', objId: formId }, initMode: 5, groupFieldIds: groupIds,
         designerParam: { sourceModule: MODULE },
     }, ebb);
+    // 读失败必须中止：下面会把 configs 原样 initLayout 落库，空 configs 等于把表单布局清空。
+    if (cfgRes?.code !== 200 || !cfgRes?.status) {
+        throw new Error(`读取表单布局失败（getConfig）: ${cfgRes?.msg || '未知错误'}；已中止，未改动布局`);
+    }
     // 流程表单 FLOW 布局 getConfig 默认把业务字段 readOnly=true（锁死），init 时强制可编辑：
     // 业务字段 readOnly=false / disableEdit=false（除非 --read-only 显式锁）；明细/系统字段/Collapse 分组容器保留。
     const configs = normalizeDetailTableChildren((cfgRes?.data?.configs || []).map((c) => {
@@ -205,7 +224,7 @@ export async function initWorkflowFormLayout(client, baseUrl, formId, o = {}, ho
     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,
+        styleTemplateId, styleTemplateType: 1,
         configs: finalConfigs, addLayout: false, ecodeType: ['js', 'css'], initMode: '1',
         groupFieldIds: groupIds,
         customParam: { terminal: '', objId: formId },
@@ -221,8 +240,140 @@ async function genIds(client, baseUrl, n) {
     const r = await client.post(`${baseUrl}/api/form/local/generatorIds?size=${n}`, {});
     return (r?.data?.generatorIds || []).map(String);
 }
+/**
+ * wf-form 分支链**自己处理**的类型。
+ *
+ * 这些分支写的是流程表单专属结构（浏览按钮的 browserType、员工的 defaultExtend、
+ * EBuilder 的 sformId 族…），**不能被 rich-types 的通用模板覆盖**，所以下面查表时跳过它们。
+ */
+export const WF_FORM_HANDLED = new Set([
+    'Number', 'Money', 'TextArea', 'Date', 'DateTime',
+    'Employee', 'Department', 'RelateBrowser', 'Select', 'EBuilder', 'Flow',
+]);
+/**
+ * 构建字段 jsonObj（add-field / add-fields 共用）。返回未带 fieldId 的模板，调用方填 fieldId。
+ *
+ * `client`/`baseUrl` 只在需要额外 ID 的类型（Matrix）上用到，其余类型传 `null` 即可 ——
+ * 导出是为了让回归测试能直接断言「同一个类型名，流程表单和 eb 表建出来的 componentKey 必须一致」。
+ */
+export async function buildFieldJsonObj(client, baseUrl, fieldName, fieldType, title, o, formId, fieldId) {
+    const ck = canon(fieldType);
+    const colName = toColumnName(fieldName);
+    const jsonObj = {
+        type: ck, title: title || fieldName, fieldId, groupId: '-1', formId, showOrder: '0.00',
+        dataKey: colName, columnName: colName,
+    };
+    if (o.singleRow === true)
+        jsonObj.singleRow = true;
+    if (o.subFormId)
+        jsonObj.subFormId = o.subFormId;
+    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');
+        // 对齐浏览器 workflow 模块 saveFormFieldNew 新字段实测结构：
+        // earlyDate/lateDate + earlyType/lateType=currentDay + isSystemDate:false；
+        // 非默认字段不发 hasDisplayFormat/minuteStep/defaultExtend（平台服务端自算 hasDisplayFormat）。
+        Object.assign(jsonObj, {
+            type: 'Date', format: fmt, placeholder: placeholderFromFormat(fmt),
+            earlyDate: false, lateDate: false, earlyType: 'currentDay', lateType: 'currentDay',
+            isSystemDate: false, timePanelStyle: { type: 'system' }, isDefault: false,
+        });
+        if (o.defaultCurrent) {
+            jsonObj.isDefault = true;
+            jsonObj.defaultExtend = { date: { type: 'current' }, time: { customValue: '00:00', type: 'custom' } };
+        }
+    }
+    else if (ck === 'Employee' || ck === 'Department') {
+        jsonObj.isSingle = o.multiple ? false : true;
+        if (o.defaultCurrent && ck === 'Employee') {
+            jsonObj.defaultExtend = { type: 'current', relation: 'current', virtualId: '1' };
+        }
+    }
+    else if (ck === 'RelateBrowser') {
+        // 浏览按钮必须带**浏览数据源**，只发 type 会被平台拒「程序异常」。
+        // 结构见平台工作流表单字段规范：{ type:'RelateBrowser', isSingle, browserType:{module,name,id,type} }
+        const resolved = resolveBrowserConfig({ browserType: o.browserType, browserFormSource: o.browserFormSource });
+        Object.assign(jsonObj, {
+            isSingle: o.multiple ? false : true,
+            browserType: resolved.browserType,
+            viewDataDetail: true,
+            includeChild: false,
+            displayType: 'space',
+            isAddForRelation: true,
+            pcDisplaySelectedCount: { type: 'default' },
+            mobileDisplaySelectedCount: { type: 'default' },
+        });
+    }
+    else if (ck === 'Select') {
+        if (o.multiple) {
+            jsonObj.type = 'SelectMultiple';
+            jsonObj.componentKey = 'SelectMultiple';
+        }
+    }
+    else if (ck === 'EBuilder' || ck === 'Flow') {
+        // EBuilder 关联字段（浏览器抓包 saveFormFieldNew 实测格式）：type=EBuilder(大写EB)，
+        // 标准字段元数据（isAllFormData/hasDisplayFormat/openRelateView/dataCount/currentLevel/columnType/
+        // columnTypeSwitch/singleEdit/typeLen）+ displayType=space + isAddForRelation=false + sformId/dataTitle/formName
+        // + content/formEntity/filterQueryParams/filterParams（抓包含，filterParams 可能承载字段层筛选）。
+        Object.assign(jsonObj, {
+            // 平台真值：type=EBuilder(大写EB)、componentKey=Ebuilder(小写b)——canon 归一成 EBuilder 后
+            // 若不在此显式指定 componentKey，下方兜底 componentKey=jsonObj.type 会写成 'EBuilder'（错）。
+            componentKey: 'Ebuilder',
+            isAllFormData: false, viewDataDetail: true, quickAddParams: [],
+            hasDisplayFormat: false, openRelateView: false,
+            dataCount: 0, currentLevel: '1', columnType: 'TEXT', columnTypeSwitch: false,
+            singleEdit: true, typeLen: 16, isAddForRelation: false, displayType: 'space',
+            sformId: o.sformId || '', dataTitle: o.dataTitle || 'name',
+            relateViewData: [], formName: o.formName || '', relateField: null,
+            content: [], formEntity: {}, filterQueryParams: '{}', filterParams: '{}',
+            virtualForm: false, appId: o.appId || '', virtualTable: false,
+        });
+    }
+    // 富组件映射：CLI 类型名 ≠ 平台 componentKey 的那批（Time→TimeComponent、Score→Raty、
+    // Signature→SignatureComponent、Project→Mainline…共 25 个）必须查表。
+    // 原先这里只有 `componentKey = 类型名` 的兜底 —— Time 恰好被平台按 type 归一对了，
+    // Score 就写成平台不认的 `score`，而且完全不带富组件附加配置（format/minuteStep/…）。
+    // 已在分支链里处理的类型跳过，避免通用模板覆盖流程表单专属结构。
+    const rich = WF_FORM_HANDLED.has(ck) ? undefined : getRichType(ck);
+    if (rich) {
+        jsonObj.type = rich.platformType;
+        jsonObj.componentKey = rich.platformComponentKey;
+        if (rich.build) {
+            const extra = richIdUnits(ck, {}) - 1;
+            let extraIds = [];
+            if (extra > 0) {
+                if (!client || !baseUrl)
+                    throw new Error('该字段类型需要额外 ID，构建时必须提供 client');
+                const extraRes = await client.post(`${baseUrl}/api/workflow/core/form/generatorIds?size=${extra}`, {});
+                extraIds = (extraRes?.data?.generatorIds || []).map(String);
+            }
+            Object.assign(jsonObj, await rich.build({
+                def: { multiple: o.multiple, browserType: o.browserType, browserFormSource: o.browserFormSource, format: o.format },
+                fieldId, formId, formTableId: '', dataKey: colName, columnName: colName,
+                showOrder: '0.00', extraIds,
+            }));
+        }
+    }
+    if (!jsonObj.componentKey)
+        jsonObj.componentKey = jsonObj.type;
+    return jsonObj;
+}
 export function registerWorkflowFormCommands(program) {
-    const wfForm = program.command('wf-form').description('流程表单（工作流程表单）管理：read / add-field / add-detail-table / layout init');
+    const wfForm = program.command('wf-form').description('流程表单（工作流程表单）管理：read / add-field / edit-field / delete-field / add-detail-table / layout init');
     // ---------- wf-form read ----------
     wfForm.command('read')
         .description('读取流程表单字段（getConfig）')
@@ -255,89 +406,30 @@ export function registerWorkflowFormCommands(program) {
             process.exitCode = 1;
         }
     });
-    /** 构建字段 jsonObj（add-field / add-fields 共用）。返回未带 fieldId 的模板，调用方填 fieldId。 */
-    function buildFieldJsonObj(fieldName, fieldType, title, o, formId, fieldId) {
-        const ck = canon(fieldType);
-        const colName = toColumnName(fieldName);
-        const jsonObj = {
-            type: ck, title: title || fieldName, fieldId, groupId: '-1', formId, showOrder: '0.00',
-            dataKey: colName, columnName: colName,
-        };
-        if (o.singleRow === true)
-            jsonObj.singleRow = true;
-        if (o.subFormId)
-            jsonObj.subFormId = o.subFormId;
-        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 } : {}),
-            });
+    /**
+     * `--browser-name` → 查平台检索接口拿到浏览数据源对象。
+     * **精确匹配**，查不到就报错并列候选，不猜相近的顶上。
+     */
+    async function resolveBrowserByName(client, baseUrl, name, ebb) {
+        const r = await client.get(`${baseUrl}${BROWSER_BEAN_SEARCH}?searchValue=${encodeURIComponent(name)}`, ebb);
+        const bean = pickBrowserBean(r, name);
+        if (!bean) {
+            const cands = browserBeanCandidates(r);
+            throw new Error(`未找到名为「${name}」的浏览数据源。` +
+                (cands.length ? `检索到的相近项：${cands.map((c) => c.name).join('、')}` : '（检索无结果）') +
+                '。请核对名称，或用 --browser-type 指定系统浏览。');
         }
-        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');
-            // 对齐浏览器 workflow 模块 saveFormFieldNew 新字段实测结构：
-            // earlyDate/lateDate + earlyType/lateType=currentDay + isSystemDate:false；
-            // 非默认字段不发 hasDisplayFormat/minuteStep/defaultExtend（平台服务端自算 hasDisplayFormat）。
-            Object.assign(jsonObj, {
-                type: 'Date', format: fmt, placeholder: placeholderFromFormat(fmt),
-                earlyDate: false, lateDate: false, earlyType: 'currentDay', lateType: 'currentDay',
-                isSystemDate: false, timePanelStyle: { type: 'system' }, isDefault: false,
-            });
-            if (o.defaultCurrent) {
-                jsonObj.isDefault = true;
-                jsonObj.defaultExtend = { date: { type: 'current' }, time: { customValue: '00:00', type: 'custom' } };
-            }
-        }
-        else if (ck === 'Employee' || ck === 'Department' || ck === 'Browser') {
-            jsonObj.isSingle = o.multiple ? false : true;
-            if (o.defaultCurrent && ck === 'Employee') {
-                jsonObj.defaultExtend = { type: 'current', relation: 'current', virtualId: '1' };
-            }
-        }
-        else if (ck === 'Select') {
-            if (o.multiple) {
-                jsonObj.type = 'SelectMultiple';
-                jsonObj.componentKey = 'SelectMultiple';
-            }
-        }
-        else if (ck === 'EBuilder' || ck === 'Flow') {
-            // EBuilder 关联字段（浏览器抓包 saveFormFieldNew 实测格式）：type=EBuilder(大写EB)，
-            // 标准字段元数据（isAllFormData/hasDisplayFormat/openRelateView/dataCount/currentLevel/columnType/
-            // columnTypeSwitch/singleEdit/typeLen）+ displayType=space + isAddForRelation=false + sformId/dataTitle/formName
-            // + content/formEntity/filterQueryParams/filterParams（抓包含，filterParams 可能承载字段层筛选）。
-            Object.assign(jsonObj, {
-                isAllFormData: false, viewDataDetail: true, quickAddParams: [],
-                hasDisplayFormat: false, openRelateView: false,
-                dataCount: 0, currentLevel: '1', columnType: 'TEXT', columnTypeSwitch: false,
-                singleEdit: true, typeLen: 16, isAddForRelation: false, displayType: 'space',
-                sformId: o.sformId || '', dataTitle: o.dataTitle || 'name',
-                relateViewData: [], formName: o.formName || '', relateField: null,
-                content: [], formEntity: {}, filterQueryParams: '{}', filterParams: '{}',
-                virtualForm: false, appId: o.appId || '', virtualTable: false,
-            });
-        }
-        if (!jsonObj.componentKey)
-            jsonObj.componentKey = jsonObj.type;
-        return jsonObj;
+        return toBrowserType(bean);
     }
     // ---------- wf-form add-field ----------
     wfForm.command('add-field')
-        .description('给流程表单加字段（Text/TextArea/Number/Money/Date/DateTime/Select/Employee/Department/Browser/EBuilder/Flow）')
+        .description('给流程表单加字段（Text/TextArea/Number/Money/Date/DateTime/Select/Employee/Department/浏览按钮/EBuilder/Flow）')
         .argument('<formId>', '流程表单 formId')
         .argument('<fieldName>', '字段名')
         .argument('<fieldType>', '字段类型')
         .argument('[title]', '字段显示名（不传同 fieldName）')
         .option('--sub-form-id <id>', '在指定明细子表里加字段（明细表 subFormId）')
-        .option('--multiple', '多选（Employee/Department/Browser/下拉Select→SelectMultiple）')
+        .option('--multiple', '多选（Employee/Department/浏览按钮/下拉Select→SelectMultiple）')
         .option('--precision <n>', '小数位（Number 缺省 0 / Money 缺省 2 / 百分比缺省 1）')
         .option('--percent', 'Number 百分比显示（numberType=percentage）')
         .option('--default <value>', 'Number/Money 默认值')
@@ -348,6 +440,9 @@ export function registerWorkflowFormCommands(program) {
         .option('--app-id <appId>', '目标表单所属应用 appId（EBuilder 建议传，不传 formName 自动解析需要）')
         .option('--data-title <field>', 'EBuilder 关联显示字段（默认 name；目标表含"名称"的字段或 fieldId）')
         .option('--form-name <name>', '目标表单名称（不传自动解析）')
+        .option('--browser-type <kind>', `浏览按钮的数据源：${Object.keys(BROWSER_TYPE_CATALOG).join(' / ')} / form（缺省 workflow=工作流）`)
+        .option('--browser-form-source <src>', '--browser-type form 时的来源：business(默认) / ebuilder')
+        .option('--browser-name <name>', '按名字指定浏览数据源（含自定义浏览框，如 "CLM-合同类型"）；优先于 --browser-type')
         .option('--no-init', '跳过末尾自动 layout init（默认加完自动重排布局，对齐 add-fields 批量）')
         .action(async (formId, fieldName, fieldType, title, o) => {
         try {
@@ -379,7 +474,14 @@ export function registerWorkflowFormCommands(program) {
                 if (!o.formName)
                     o.formName = o.sformId; // 兜底
             }
-            const jsonObj = buildFieldJsonObj(fieldName, fieldType, title, o, formId, fieldId);
+            // 按名字查浏览数据源（含自定义浏览框）——查不到就停下报错，不用近似项顶替
+            if (o.browserName) {
+                if (ck !== 'RelateBrowser') {
+                    throw new Error('--browser-name 只对浏览按钮类型有效（字段类型传 Browser）');
+                }
+                o.browserType = await resolveBrowserByName(client, baseUrl, o.browserName, ebb);
+            }
+            const jsonObj = await buildFieldJsonObj(client, baseUrl, fieldName, fieldType, title, o, formId, fieldId);
             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 || '未知错误'}`);
@@ -622,8 +724,18 @@ export function registerWorkflowFormCommands(program) {
                 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 || [];
+            // 翻页取全：固定 pageSize 会在规则数超过一页时静默漏显示
+            const PAGE = 100;
+            const rules = [];
+            for (let pageNo = 1;; pageNo++) {
+                const res = await client.post(`${baseUrl}${ROUTE}/validate/pageFormDataValidate`, { module: MODULE, formId, pageNo, pageSize: PAGE }, { ebbusinessid: formId });
+                if (res?.code !== 200 || !res?.status)
+                    throw new Error(res?.msg || '未知错误');
+                const page = res?.data?.records || [];
+                rules.push(...page);
+                if (page.length < PAGE)
+                    break;
+            }
             if (opts.json) {
                 console.log(JSON.stringify(rules, null, 2));
                 return;
@@ -760,7 +872,10 @@ export function registerWorkflowFormCommands(program) {
                     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 ? '流程表单' : '流程表单';
+            // 条件载荷里的 targetName 只是展示用，平台按 targetId 定位。
+            // 这里曾写 `configs.find(c => !c.system)?.name ? '流程表单' : '流程表单'`——两个分支同值等于没写，
+            // 且 configs 是**布局字段**数组、取到的是字段名而非表单名，照字面"修好"反而会把字段名当表单名发出去。
+            const formName = '流程表单';
             // conditions
             const conditionDetails = cfg.conditions.map((c) => {
                 const f = findField(c.field);
@@ -1046,7 +1161,7 @@ export function registerWorkflowFormCommands(program) {
                     continue;
                 }
                 const fieldId = ids[i];
-                const jsonObj = buildFieldJsonObj(d.name, d.type, d.title, d, formId, fieldId);
+                const jsonObj = await buildFieldJsonObj(client, baseUrl, d.name, d.type, d.title, d, formId, fieldId);
                 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) {
                     added++;
@@ -1079,6 +1194,71 @@ export function registerWorkflowFormCommands(program) {
         }
     });
     // ---------- wf-form edit-field ----------
+    // ---------- wf-form delete-field ----------
+    // 流程表单删字段。平台默认拒绝删「仍被布局引用」的字段，需先从布局里摘掉组件再删
+    // （与 eb 侧 `form delete-field --force` 同一套套路，只是走 workflow 模块的端点）。
+    // 摘组件那段（含「一个字段 = 本体 + 标题标签，靠 associatedId 配对」的坑）在
+    // services/form-field-drop.ts，与 eb 侧共用。
+    wfForm.command('delete-field')
+        .description('删除流程表单字段（可批量）。仍被布局引用的字段删不掉，加 --force 让 CLI 先从布局摘掉组件再删')
+        .argument('<formId>', '流程表单 formId')
+        .argument('<fieldIds...>', '要删除的字段 fieldId')
+        .option('--force', '被布局引用时，先从布局摘掉这些组件再删')
+        .action(async (formId, fieldIds, 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 del = (ids) => client.post(`${baseUrl}${ROUTE}/field/manage/batchDeleteFormField`, { module: MODULE, formId, ids }, ebb);
+            let res = await del(fieldIds);
+            if (cmdOpts.force && (res?.code !== 200 || !res?.status)) {
+                const layoutRes = await client.post(`${baseUrl}${ROUTE}/builder/getFormLayout`, {
+                    formId, module: MODULE, customParam: {}, formTableIdList: [],
+                    designerParam: { onlyLayout: false, convert: false }, form: { id: formId },
+                }, ebb);
+                if (layoutRes?.code !== 200 || !layoutRes?.status) {
+                    throw new Error(`读取布局失败，未继续删除: ${layoutRes?.msg || '未知错误'}`);
+                }
+                const snapshot = layoutRes.data || {};
+                const pageLayouts = snapshot.formLayout?.pageLayouts;
+                if (!Array.isArray(pageLayouts)) {
+                    throw new Error('布局数据格式异常（无 formLayout.pageLayouts），未继续删除');
+                }
+                const removed = dropFieldComponents(pageLayouts, fieldIds);
+                if (!removed) {
+                    throw new Error('布局里没找到这些字段的组件，无法自动移除；请到设计器里手动删除');
+                }
+                const formLayout = prepareLayoutForSave(snapshot.formLayout, formId);
+                const saveRes = await client.post(`${baseUrl}${ROUTE}/builder/saveFormAndLayout`, {
+                    module: MODULE, customParam: {},
+                    designerParam: { onlyLayout: false, convert: false },
+                    form: JSON.parse(JSON.stringify(snapshot.form || {})), formLayout,
+                }, ebb);
+                if (saveRes?.code !== 200 || !saveRes?.status) {
+                    throw new Error(`从布局移除失败，未继续删除: ${saveRes?.msg || '未知错误'}`);
+                }
+                console.error(`  已从布局移除 ${removed} 个组件`);
+                res = await del(fieldIds);
+            }
+            if (res?.code !== 200 || !res?.status) {
+                console.error(`删除失败: ${res?.msg || '未知错误'}`);
+                console.error('  提示: 仍被表单布局引用的字段平台不允许删除，加 --force 让 CLI 先从布局摘掉再删');
+                process.exitCode = 1;
+                return;
+            }
+            console.log(opts.json
+                ? JSON.stringify({ success: true, formId, deleted: fieldIds })
+                : `字段已删除: ${fieldIds.join(', ')}`);
+        }
+        catch (e) {
+            console.error(`删除字段失败: ${e.message}`);
+            process.exitCode = 1;
+        }
+    });
     wfForm.command('edit-field')
         .description('编辑流程表单已有字段（read-modify-write：getFormField 读全字段 → 改 → saveFormFieldNew 重存）')
         .argument('<formId>', '流程表单 formId')
@@ -1111,7 +1291,7 @@ export function registerWorkflowFormCommands(program) {
             if (o.multiple === true || o.single === true) {
                 const multi = o.multiple === true;
                 const t = jsonObj.type;
-                if (t === 'Employee' || t === 'Department' || t === 'Browser') {
+                if (t === 'Employee' || t === 'Department' || t === 'RelateBrowser') {
                     jsonObj.isSingle = !multi;
                     changes.push(`isSingle=${!multi}`);
                 }
@@ -1121,7 +1301,7 @@ export function registerWorkflowFormCommands(program) {
                     changes.push(`type=${jsonObj.type}`);
                 }
                 else {
-                    throw new Error(`字段类型 ${t} 不支持多选切换（仅 Employee/Department/Browser/Select）`);
+                    throw new Error(`字段类型 ${t} 不支持多选切换（仅 Employee/Department/浏览按钮/Select）`);
                 }
             }
             // EB关联带出（ffRelateField）：选关联记录后自动带出目标表字段值
@@ -1513,16 +1693,12 @@ export function registerWorkflowFormCommands(program) {
             const resolveField = (ref) => fieldByName.get(String(ref)) || fieldByName.get(String(ref)) || null;
             // ① 建全部分组（saveFieldGroup，去重：同名复用避免重跑建重复分组——saveFieldGroup 不幂等）
             const existingByName = new Map();
-            try {
-                const gr = await client.post(`${baseUrl}${ROUTE}/field/manage/getFieldGroupPage`, { pageNo: 1, pageSize: 100, module: MODULE, formFieldSearchEntity: { formId }, customParam: {} }, ebb);
-                for (const f of (gr?.data?.pageDatas?.result || [])) {
-                    const g = f?.formField?.group;
-                    if (g?.id && g?.groupName && !existingByName.has(g.groupName)) {
-                        existingByName.set(g.groupName, { groupId: String(g.id), refFieldId: String(BigInt(g.id) - 1n) });
-                    }
+            // 读失败不再吞：按「无现有」继续会重复建同名分组（saveFieldGroup 不幂等）
+            for (const g of await fetchFormGroupEntries(client, baseUrl, formId)) {
+                if (g?.id && g?.groupName && !existingByName.has(g.groupName)) {
+                    existingByName.set(g.groupName, { groupId: String(g.id), refFieldId: String(BigInt(g.id) - 1n) });
                 }
             }
-            catch { /* 忽略，按无现有处理 */ }
             const created = [];
             for (const [gname, fieldRefs] of entries) {
                 let groupId = '', refFieldId = '';