weaver-e10-builder 1.5.1 → 1.5.2

package/dist/commands/form.js

@@ -3,7 +3,7 @@ import { AuthSession } from '../core/auth.js';
 import { ApiClient } from '../core/client.js';
 import { toColumnName, toTableName, resolveFieldKeys } from '../utils/column-name.js';
 import { createCustomPhysicalForm, addInitialFieldsToCustomPhysicalForm, placeholderFromFormat, reapplyGroupLayout, queryFormStorageSetting } from '../services/form-create.js';
-import { FormSubDetailService, resolveDetailTable } from '../services/form-sub-detail.js';
+import { FormSubDetailService } from '../services/form-sub-detail.js';
 import { RICH_TYPE_MAP, getRichType, richIdUnits, BROWSER_KINDS } from '../services/rich-types.js';
 import { dropFieldComponents, prepareLayoutForSave } from '../services/form-field-drop.js';
 import { describeEditBaseFailure, resolveEditBase as resolveEditBasePure } from '../services/form-edit-base.js';
@@ -11,7 +11,11 @@ import { applyFieldPatches, platformFieldShape } from '../services/form-field-pa
 import { ensureDisplayColumns } from '../services/form-ebuilder-columns.js';
 import { insertFieldIntoLayout, patchFieldLayout } from '../services/form-layout-insert.js';
 import { buildLinkageAddPayload, addLinkage, resolveEffect, readLinkageConfig } from '../services/form-linkage-condition.js';
-import { createMultilangLabel } from '../services/form-i18n-label.js';
+// 字段 jsonObj 的构造器（含 SYSTEM_FIELD_IDS / defaultEBuilderDataTitle）——
+// 原先内联在下面 add-field 的 action 里，为了给「按物理表加字段」第二个入口复用而抽出去。
+// 本文件仍有别处用这两个符号，所以在这里回导。
+import { SYSTEM_FIELD_IDS, defaultEBuilderDataTitle, buildFieldJsonObject } from '../services/form-field-build.js';
+import { listFormTables, readFieldRecords, mapFieldsToTables } from '../services/form-physical-table.js';
 import { buildFormulaParameters, defaultReturnType } from '../services/formula-detail.js';
 import { registerOptionTemplateCommand } from './form-option-template.js';
 /**
@@ -87,12 +91,6 @@ function assertFieldOptions(fieldName, options) {
         }
     });
 }
-const SYSTEM_FIELD_IDS = new Set([
-    'name', 'creator', 'create_time', 'update_time', 'id',
-    'updater', 'data_status', 'flow_status', 'current_step',
-    'batchpubtags', 'batchmytags', 'operate', 'data_read_status',
-    'flow_system_number',
-]);
 /** 系统字段的中文名 → 物理字段 id（form read 实测的平台自带字段）。建表时字段与此完全重名 → 跳过新建、直接复用系统字段。 */
 const SYSTEM_FIELD_NAME_TO_ID = {
     '标题': 'name',
@@ -117,14 +115,6 @@ const SYSTEM_FIELD_CFG_ID = {
     '最后更新人': 'updater',
     '数据状态': 'dataStatus',
 };
-// EBuilder dataTitle（关联字段标题栏）默认解析：优先字段名含「名称」的业务字段，无则第一个业务字段。
-// 需求：默认选带"名称"二字的字段（如 客户名称/类型名称），没有就默认选第一个。
-function defaultEBuilderDataTitle(fields) {
-    const isBiz = (id) => /^\d{15,}$/.test(id) && !SYSTEM_FIELD_IDS.has(id);
-    const biz = (fields || []).filter((f) => isBiz(String(f.fieldId ?? '')));
-    const byName = biz.find((f) => String(f.fieldName ?? f.title ?? '').includes('名称'));
-    return byName?.fieldId || biz[0]?.fieldId || 'name';
-}
 /**
  * 只读地看一眼 `getFields` 眼里这个字段长什么样 —— **仅用于把错误信息说清楚，绝不作为写回基底**。
  *
@@ -284,6 +274,22 @@ export function registerFormCommands(program) {
             }
             catch { /* 布局属性补读失败不影响主流程 */ }
         }
+        // 所属物理表（设计器「字段管理」的主表/其他）—— getFields 不带这个信息，
+        // 得用 getFormAGroupList（表清单）+ getFormFieldPage（字段记录上的 formTableId）拼出来。
+        if (formId && cmdOpts?.appId) {
+            try {
+                const scope = { formId, appId: cmdOpts.appId, objId };
+                const tables = await listFormTables(client, baseUrl, cmdOpts.appId, scope);
+                const records = await readFieldRecords(client, baseUrl, cmdOpts.appId, scope);
+                const byField = mapFieldsToTables(records, tables);
+                for (const f of allFields) {
+                    const t = byField[String(f.fieldId)];
+                    if (t)
+                        f.formTable = { id: t.formTableId, name: t.name, type: t.tableType, tableName: t.tableName };
+                }
+            }
+            catch { /* 物理表归属读不到不影响主流程 */ }
+        }
         if (cmdOpts?.out) {
             // Write JSON to file with UTF-8 encoding, bypassing terminal encoding
             writeFileSync(cmdOpts.out, JSON.stringify(allFields, null, 2), 'utf-8');
@@ -294,10 +300,13 @@ export function registerFormCommands(program) {
         }
         else {
             console.log(`表单 ${objId} 共 ${fields.length} 个主表字段${subFields.length ? ` + ${subFields.length} 个明细表字段` : ''}:`);
+            // 主表那排 chip 上写的是表单名，逐行重复没信息量，显示成「主表」；附属物理表用它的真名
+            const tableLabel = (f) => (f.formTable ? (f.formTable.type === 'MAIN' ? '主表' : f.formTable.name) : '');
             for (const f of fields) {
                 if (SYSTEM_FIELD_IDS.has(f.fieldId))
                     continue;
-                console.log(`  [${f.fieldKey || f.fieldType}] ${f.fieldName}  (fieldId: ${f.fieldId || f.id})`);
+                const t = tableLabel(f);
+                console.log(`  [${f.fieldKey || f.fieldType}] ${f.fieldName}  (fieldId: ${f.fieldId || f.id})${t ? `  · 物理表: ${t}` : ''}`);
                 if (f.options)
                     console.log(`    选项: ${JSON.stringify(f.options)}`);
                 if (f.optionTemplate)
@@ -2160,402 +2169,16 @@ export function registerFormCommands(program) {
             columnName: cmdOpts.columnName,
         });
         const colName = keys.dataKey; // 布局 comp 等仍按字段编码引用
-        // Build jsonObj based on field type
-        const jsonObj = {
-            type: fieldType,
-            title: title || fieldName,
-            formTableId, fieldId, groupId: '-1', formId,
-            showOrder: '0.00',
-            dataKey: keys.dataKey,
-            columnName: keys.columnName,
-        };
-        // 明细表字段：--sub-form-id 时 jsonObj 带 subFormId —— **字段落点由它决定**。
-        // 必须用 resolveDetailTable 而不是直接查 getEbField：后者列不出空明细表，
-        // 用户把明细字段删光后就再也加不回去（详见 services/form-sub-detail.ts）。
-        if (cmdOpts.subFormId) {
-            const sub = await resolveDetailTable(client, baseUrl, appId, objId, formId, cmdOpts.subFormId);
-            if (!sub) {
-                console.error(`未找到明细表 subFormId=${cmdOpts.subFormId}（getEbField 与 querySubForms 均无此表，请确认 id）`);
-                process.exit(1);
-            }
-            Object.assign(jsonObj, { subFormId: cmdOpts.subFormId });
-            // 空表拿不到物理表 id，保持主表的值不动：实测带主表 formTableId 一样落进明细表。
-            if (sub.formTableId)
-                jsonObj.formTableId = sub.formTableId;
-        }
-        // 富组件：映射到平台真实 type/componentKey + 附加配置（对齐 batch/save/formField 抓包）。
-        // 之前 jsonObj 只有 type 没有 componentKey → 平台 FormFieldDto.getComponentKey() 为 null → NPE。
-        const rich = getRichType(fieldType);
-        if (rich) {
-            jsonObj.type = rich.platformType;
-            jsonObj.componentKey = rich.platformComponentKey;
-            if (rich.build) {
-                const extra = richIdUnits(fieldType, {}) - 1;
-                let extraIds = [];
-                if (extra > 0) {
-                    const extraRes = await client.post(`${baseUrl}/api/form/local/generatorIds?size=${extra}&apid=${appId}`, {});
-                    extraIds = (extraRes?.data?.generatorIds || []).map(String);
-                }
-                const extraCfg = await rich.build({
-                    def: {
-                        multiple: cmdOpts.multiple,
-                        browserType: cmdOpts.browserType,
-                        browserFormSource: cmdOpts.browserFormSource,
-                    }, fieldId, formId, formTableId, dataKey: keys.dataKey, columnName: keys.columnName,
-                    showOrder: '0.00', extraIds,
-                });
-                Object.assign(jsonObj, extraCfg);
-            }
-        }
-        // 非富组件也补 componentKey（平台要求，否则 FormFieldDto.getComponentKey() 为 null → NPE）。
-        // 富组件已在上方设置 platformComponentKey；此处 fallback 到类型名（平台对常见类型有归一容错）。
-        if (!jsonObj.componentKey)
-            jsonObj.componentKey = fieldType;
-        // Number/Money decimal precision: --precision 指定，缺省 Number=0 整数、Money=2、百分比=1
-        // 百分比：--percent → numberType=percentage；默认值：--default → content+isDefault
-        // 实测：设默认值必须连 isDelimiter/stepMode/step/isCapital 一起，否则平台丢默认（只设 content+isDefault 不落库）
-        if (fieldType === 'Number' || fieldType === 'Money') {
-            const defaultPrec = fieldType === 'Money' ? '2' : '0';
-            const isPercent = fieldType === 'Number' && cmdOpts.percent === true;
-            // 注意：commander 把 --default 映射到 opts.default（非 defaultValue）
-            const hasDefault = cmdOpts.default !== undefined && cmdOpts.default !== null && cmdOpts.default !== '';
-            // 千分位：Money 默认开（--no-delimiter 关闭）、Number 默认关（--delimiter 开启）
-            const isDelim = fieldType === 'Money' ? cmdOpts.delimiter !== false : cmdOpts.delimiter === true;
-            const isCap = cmdOpts.capital === true;
-            const patch = {
-                pointSize: cmdOpts.precision !== undefined ? cmdOpts.precision : (isPercent ? '1' : defaultPrec),
-                isDefault: hasDefault,
-                isDelimiter: isDelim,
-                isCapital: isCap,
-                capitalFormat: 'onlyUpperCase',
-                capitalPosition: 'outside',
-                capitalSetting: 'system',
-                capitalPrecision: 'yuan',
-                isExchangeRates: false,
-            };
-            if (fieldType === 'Number')
-                patch.numberType = isPercent ? 'percentage' : 'number';
-            // content 始终带（无默认值时空串）——浏览器抓包 Number 字段 getFormField 恒有 content:""，
-            // 缺 content 在 FLOW 渲染异常（与多行文本同因）。
-            if (fieldType === 'Number')
-                patch.content = hasDefault ? String(cmdOpts.default) : '';
-            if (hasDefault) {
-                patch.stepMode = false;
-                patch.step = 1;
-            }
-            Object.assign(jsonObj, patch);
-        }
-        if (fieldType === 'TextArea') {
-            // 多行文本：对齐浏览器抓包——content 恒 ""（无默认值时空串）、maxLen=4000。
-            // 缺 content 在 FLOW 渲染异常；maxLen 不发则前端最大长度回显异常。
-            Object.assign(jsonObj, { content: '', maxLen: 4000 });
-        }
-        if (fieldType === 'EInvoice') {
-            Object.assign(jsonObj, {
-                isSingle: false,
-                invoiceType: 1,
-            });
-            delete jsonObj.maxLen;
-            delete jsonObj.unique;
-            delete jsonObj.scan;
-            delete jsonObj.readonlyTransLink;
-        }
-        else if (fieldType === 'Date' || fieldType === 'DateTime') {
-            // 日期：默认精度 年月日（yyyy-MM-dd，对齐浏览器抓包）；DateTime：默认带时:分（yyyy-MM-dd HH:mm 不含秒）。
-            // 默认值不填（isDefault:false）；--format 覆盖精度。
-            const isDt = fieldType === 'DateTime';
-            const fmt = cmdOpts.format || (isDt ? 'yyyy-MM-dd HH:mm' : 'yyyy-MM-dd');
-            Object.assign(jsonObj, {
-                type: 'Date',
-                format: fmt,
-                placeholder: placeholderFromFormat(fmt),
-                timePanelStyle: { type: 'system' },
-                isDefault: false,
-            });
-            // 日期限制：--min-field 最早不得早于 / --max-field 最晚不得晚于另一字段（对齐抓包 min.dateField）。
-            // 目标字段 fieldId 从 getFields mainFields 按字段名解析。
-            if (cmdOpts.minField || cmdOpts.maxField) {
-                try {
-                    const tfd = await client.post(`${baseUrl}/api/ebuilder/form/dataset/v1/getFields`, {
-                        objId, userid: auth.userId, tenantKey: auth.tenantKey,
-                    });
-                    const tfields = tfd?.data?.mainFields || [];
-                    const minTarget = cmdOpts.minField ? tfields.find((f) => f.fieldName === cmdOpts.minField)?.fieldId : '';
-                    const maxTarget = cmdOpts.maxField ? tfields.find((f) => f.fieldName === cmdOpts.maxField)?.fieldId : '';
-                    if (minTarget) {
-                        jsonObj.min = { type: 'dateField', checkValue: String(minTarget) };
-                        jsonObj.earlyDate = true;
-                    }
-                    if (maxTarget) {
-                        jsonObj.max = { type: 'dateField', checkValue: String(maxTarget) };
-                        jsonObj.lateDate = true;
-                    }
-                }
-                catch { /* 解析失败则不加限制 */ }
-            }
-            delete jsonObj.maxLen;
-            delete jsonObj.unique;
-            delete jsonObj.scan;
-            delete jsonObj.readonlyTransLink;
-        }
-        else if (fieldType === 'SubCompany') {
-            Object.assign(jsonObj, {
-                componentKey: 'Subcompany', isSingle: cmdOpts.multiple ? false : true,
-                displayType: 'space', defaultExtend: { type: 'custom', relation: 'current' },
-                viewDataDetail: true, showDimension: true,
-                pcDisplaySelectedCount: { type: 'default' },
-                mobileDisplaySelectedCount: { type: 'default' },
-            });
-            delete jsonObj.maxLen;
-            delete jsonObj.unique;
-            delete jsonObj.scan;
-            delete jsonObj.readonlyTransLink;
-        }
-        else if (fieldType === 'City') {
-            // 城市/地区选择（对齐浏览器 payload：region 模式 + 系统级联层级 + 字母索引）
-            Object.assign(jsonObj, {
-                isSingle: false,
-                levelSetting: 'system',
-                isDefault: false,
-                useLetterIndex: true,
-                mode: 'region',
-            });
-            delete jsonObj.maxLen;
-            delete jsonObj.unique;
-            delete jsonObj.scan;
-            delete jsonObj.readonlyTransLink;
-        }
-        else if (fieldType === 'EBuilder') {
-            if (!sformId) {
-                console.error('EBuilder 类型必须指定 --sform-id（目标表单 objId）');
-                process.exit(1);
-            }
-            // Resolve formName from target form if not provided
-            let resolvedFormName = formName;
-            if (!resolvedFormName) {
-                try {
-                    const tlist = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
-                    const tf = (tlist?.data || []).find((f) => String(f.id) === String(sformId));
-                    resolvedFormName = tf?.formName || tf?.name || sformId;
-                }
-                catch {
-                    resolvedFormName = sformId;
-                }
-            }
-            // Resolve dataTitle：纯数字 fieldId 直接用；'name'/字段名 → 查目标表字段。
-            // 未传 --data-title 时按 name 处理：默认优先字段名含「名称」的业务字段（如 客户名称/类型名称），无则第一个业务字段。
-            let resolvedDataTitle = dataTitle || 'name';
-            if (!/^\d{15,}$/.test(resolvedDataTitle)) {
-                try {
-                    const tfd = await client.post(`${baseUrl}/api/ebuilder/form/dataset/v1/getFields`, {
-                        objId: sformId, userid: auth.userId, tenantKey: auth.tenantKey,
-                    });
-                    const tfields = tfd?.data?.mainFields || [];
-                    if (resolvedDataTitle === 'name') {
-                        resolvedDataTitle = defaultEBuilderDataTitle(tfields);
-                    }
-                    else {
-                        const m = tfields.find((f) => f.fieldName === resolvedDataTitle)
-                            || tfields.find((f) => String(f.fieldName || '').includes(resolvedDataTitle));
-                        resolvedDataTitle = m?.fieldId || resolvedDataTitle;
-                    }
-                }
-                catch { /* 解析失败保留原值 */ }
-            }
-            Object.assign(jsonObj, {
-                sformId,
-                dataTitle: resolvedDataTitle || 'name',
-                formName: resolvedFormName,
-                virtualForm: false,
-                displayType: 'line',
-                isAddForRelation: true,
-                isSingle: cmdOpts.multiple ? false : true, // 默认单选；--multiple 多选
-                viewDataDetail: true,
-                pcDisplaySelectedCount: { type: 'default' },
-                mobileDisplaySelectedCount: { type: 'default' },
-                quickAddParams: [],
-                relateViewData: [],
-                relateField: null,
-                appId,
-                virtualTable: false,
-            });
-        }
-        else if (fieldType === 'Flow') {
-            // 浏览-流程字段（对齐浏览器 payload：type=Flow + relateExt.module=workflow）
-            if (!sformId) {
-                console.error('Flow 类型必须指定 --sform-id（目标流程绑定的表单 objId）');
-                process.exit(1);
-            }
-            let resolvedFormName = formName;
-            if (!resolvedFormName) {
-                try {
-                    const tlist = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
-                    const tf = (tlist?.data || []).find((f) => String(f.id) === String(sformId));
-                    resolvedFormName = tf?.formName || tf?.name || sformId;
-                }
-                catch {
-                    resolvedFormName = sformId;
-                }
-            }
-            Object.assign(jsonObj, {
-                isAddForRelation: true,
-                sformId,
-                formName: resolvedFormName,
-                conditionOperate: 'and',
-                filterParams: '{}',
-                filterQueryParams: '{}',
-                columnFields: [],
-                displayType: 'line',
-                viewDataDetail: true,
-                pcDisplaySelectedCount: { type: 'default' },
-                mobileDisplaySelectedCount: { type: 'default' },
-                relateExt: { module: 'workflow' },
-                relateField: null,
-                quickAddParams: [],
-            });
-        }
-        else if (isDateRange) {
-            // 日期区间：补 start/end 两个 DateComponent + rangeInterval（对齐浏览器 payload）
-            const format = cmdOpts.format || 'yyyy-MM-dd';
-            const rangeTitle = title || fieldName;
-            const start = {
-                componentKey: 'DateComponent', content: '', describe: '', earlyDate: 'false',
-                format, isDefault: 'false', lateDate: 'false',
-                placeholder: placeholderFromFormat(format),
-                position: '', relateMultiple: 'false', required: 'false', size: 'medium',
-                title: `${rangeTitle}(开始时间)`, fieldId: startId,
-                min: { type: 'currentHour' }, max: { type: 'currentHour' },
-            };
-            const end = { ...start, title: `${rangeTitle}(结束时间)`, fieldId: endId };
-            Object.assign(jsonObj, {
-                isDefault: false,
-                start, end,
-                hasDisplayFormat: true,
-                rangeInterval: { limitType: 'max', timeUnit: 'day' },
-            });
-        }
-        else if (fieldType === 'IDCard') {
-            // 身份证号：平台原生简单字段，浏览器抓包 payload 极简（type/title/formTableId/dataKey/
-            // columnName/fieldId/formId/showOrder/groupId 即全部）——无 componentKey、无文本长度配置。
-            delete jsonObj.componentKey;
-            delete jsonObj.maxLen;
-            delete jsonObj.unique;
-            delete jsonObj.scan;
-            delete jsonObj.readonlyTransLink;
-        }
-        else {
-            // 文本最大长度：--max-len 指定，缺省 Text=100、TextArea=4000（对齐浏览器抓包；TextArea 在上面分支已设 content:""）
-            const defaultMaxLen = fieldType === 'TextArea' ? 4000 : 100;
-            const maxLen = cmdOpts.maxLen !== undefined ? Number(cmdOpts.maxLen) : defaultMaxLen;
-            Object.assign(jsonObj, {
-                maxLen: Number.isFinite(maxLen) && maxLen > 0 ? maxLen : defaultMaxLen,
-                unique: false, scan: false,
-                readonlyTransLink: false,
-            });
-        }
-        // 人员/部门多选：默认单选，--multiple 改多选（isSingle:false）。EBuilder 已在上文分支设过。
-        if (fieldType === 'Employee' || fieldType === 'Department') {
-            jsonObj.isSingle = cmdOpts.multiple ? false : true;
-        }
-        // 下拉多选是独立类型 SelectMultiple（非 Select + 开关）。浏览器抓包：type:"SelectMultiple"，
-        // 无 componentKey/maxLen/unique/scan（else 分支给 Select 加的 junk 要清掉），options 单独配。
-        if (fieldType === 'Select' && cmdOpts.multiple) {
-            jsonObj.type = 'SelectMultiple';
-            jsonObj.componentKey = 'SelectMultiple';
-            delete jsonObj.maxLen;
-            delete jsonObj.unique;
-            delete jsonObj.scan;
-            delete jsonObj.readonlyTransLink;
-        }
-        // Select 绑定选项预设模板：--option-template（ID 或名称）。
-        // 浏览器抓包（2026-09-09）：jsonObj 带 templateId+templateName+publicTemplate:false+options:[]（选项不内联），
-        // 平台渲染时按模板拉选项。模板管理见 `form option-template`。
-        if (fieldType === 'Select' && cmdOpts.optionTemplate) {
-            // 先清 else 分支给文本类加的 junk + options 占位（模板字段不发选项）
-            delete jsonObj.maxLen;
-            delete jsonObj.unique;
-            delete jsonObj.scan;
-            delete jsonObj.readonlyTransLink;
-            const tplIdOrName = cmdOpts.optionTemplate;
-            // 解析模板：纯数字按 ID 直查详情；否则在 custom+system 列表按名称精确匹配
-            let tplId = '';
-            let tplName = '';
-            const readTpl = async (id) => {
-                const r = await client.post(`${baseUrl}/api/form/datasources/queryDataSourcesByTemplateValueKey`, { templateId: id });
-                return r?.formDataTemplate?.id ? r.formDataTemplate : null;
-            };
-            if (/^\d+$/.test(tplIdOrName)) {
-                const t = await readTpl(tplIdOrName);
-                if (!t) {
-                    console.error(`选项模板 ${tplIdOrName} 不存在`);
-                    process.exit(1);
-                }
-                tplId = String(t.id);
-                tplName = String(t.name);
-            }
-            else {
-                for (const type of ['custom', 'system']) {
-                    const list = await client.post(`${baseUrl}/api/form/datasources/queryDataList`, { pageNo: 1, pageSize: 100, name: tplIdOrName, type });
-                    const hit = (list?.templatePage?.result || []).find((r) => r.name === tplIdOrName);
-                    if (hit) {
-                        tplId = String(hit.id);
-                        tplName = String(hit.name);
-                        break;
-                    }
-                }
-                if (!tplId) {
-                    console.error(`未找到名为「${tplIdOrName}」的选项模板（custom+system 均已查）`);
-                    process.exit(1);
-                }
-            }
-            Object.assign(jsonObj, {
-                hideScore: true,
-                optionBackgroundStyle: 'default',
-                options: [],
-                templateScore: {},
-                currentLevel: '1',
-                templateId: tplId,
-                templateName: tplName,
-                publicTemplate: false,
-                parentId: [],
-            });
-            if (cmdOpts.multiple) {
-                console.error('提示：模板下拉当前按单选（currentLevel=1）绑定；多选+模板组合未验证');
-            }
-        }
-        // 默认值 / 数据库字段名 / 描述：与 edit-field 共用同一套补丁规则。
-        // 放在最后 —— 前面各类型分支会写 content（如 TextArea 恒置 ''），先打补丁会被冲掉。
-        const patch = applyFieldPatches(jsonObj, {
-            defaultValue: cmdOpts.default,
-            dataKey: cmdOpts.dataKey,
-            columnName: cmdOpts.columnName,
-            desc: cmdOpts.desc,
+        // 字段 jsonObj 的构造抽到 services/form-field-build.ts —— 与「按物理表加字段」共用同一份。
+        // 原先这约 340 行内联在这里，多一个入口就会变成两处真相。
+        const jsonObj = await buildFieldJsonObject({
+            client, baseUrl, appId, objId,
+            userId: auth.userId, tenantKey: auth.tenantKey,
+            fieldType, fieldName, title, formId, formTableId,
+            fieldId, startId, endId,
+            dataKey: keys.dataKey, columnName: keys.columnName,
+            opts: cmdOpts,
         });
-        if (patch.errors.length > 0) {
-            for (const e of patch.errors)
-                console.error(`  ❌ ${e}`);
-            console.error('  已中止，未做任何改动。');
-            process.exit(1);
-        }
-        for (const w of patch.warnings)
-            console.error(`  ⚠ ${w}`);
-        // 必填**只存在于布局 comp 里**（`config.required`）—— 字段记录没有这个键。所以下面那句
-        // 只是形式上的补齐，真正生效的是布局落点：增量插入的 `overrides.required`，
-        // 或 --reinit 时 configs 里那条 newFieldConfig。两处都写全了用户才看不出差别。
-        if (cmdOpts.required === true)
-            jsonObj.required = true;
-        // 字段标题在平台里存的是**多语言标签 id**（字段记录的 `labelObj.title`），不是文本本身。
-        // 不建标签也能显示（设计器退回读 `title`），但只要有谁引用了标签而这个标签不存在，
-        // 标题就会**静默变空** —— 平台既不校验也不报错。所以顺手建一个真的，不留自造 id 的口子。
-        // 建失败只告警：字段本身才是主操作，不该被标签服务拖垮。
-        try {
-            const titleLabelId = await createMultilangLabel(client, baseUrl, title || fieldName, 'ebuilderform');
-            jsonObj.labelObj = { ...(jsonObj.labelObj || {}), title: titleLabelId };
-            jsonObj.titleLabelId = titleLabelId;
-        }
-        catch (e) {
-            console.error(`  ⚠ 标题的多语言标签未建立（字段不受影响，设计器会退回用 title 显示）: ${e.message}`);
-        }
         const payload = {
             formId, module: 'ebuilderform',
             customParam: { appId, objId },