weaver-e10-builder 1.5.2 → 1.5.3

package/dist/commands/form.js

@@ -2,95 +2,34 @@ import { writeFileSync, existsSync, readFileSync } from 'fs';
 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 } from '../services/form-sub-detail.js';
-import { RICH_TYPE_MAP, getRichType, richIdUnits, BROWSER_KINDS } from '../services/rich-types.js';
+import { createCustomPhysicalForm, applyInitialFieldsToNewForm, placeholderFromFormat, reapplyGroupLayout, queryFormStorageSetting } from '../services/form-create.js';
+import { 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';
 import { applyFieldPatches, platformFieldShape } from '../services/form-field-patch.js';
 import { ensureDisplayColumns } from '../services/form-ebuilder-columns.js';
-import { insertFieldIntoLayout, patchFieldLayout } from '../services/form-layout-insert.js';
+import { insertFieldIntoLayout, patchFieldLayout, NO_FIELD_TYPE_TEMPLATE } from '../services/form-layout-insert.js';
+import { fetchFieldTypeTemplates, findTemplateByType } from '../services/form-field-template.js';
 import { buildLinkageAddPayload, addLinkage, resolveEffect, readLinkageConfig } from '../services/form-linkage-condition.js';
 // 字段 jsonObj 的构造器（含 SYSTEM_FIELD_IDS / defaultEBuilderDataTitle）——
 // 原先内联在下面 add-field 的 action 里，为了给「按物理表加字段」第二个入口复用而抽出去。
 // 本文件仍有别处用这两个符号，所以在这里回导。
 import { SYSTEM_FIELD_IDS, defaultEBuilderDataTitle, buildFieldJsonObject } from '../services/form-field-build.js';
+// objId → 表单记录/formId。obj/getList 不含三方表单（专项应用），所以内部带了 getInfoById 兜底。
+import { resolveFormRecord, resolveFormId, appendThirdPartyForms, resolveObjIdByFormId } from '../services/form-id.js';
+// 字段类型归一 / 校验：与「专项建表」共用同一份（原为本文件内联）。
+import { FIELD_TYPE_CHOICES, canonComponentKey, assertFieldType, normalizeFieldDef } from '../services/form-field-validate.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';
 /**
- * componentKey 大小写归一：用户/示例常写 "Textarea"/"Ebuilder" 等小写变体，但代码各处
- * `=== 'TextArea'`、storageFieldType 按 canonical 大小写匹配。不归一会导致 type 存成小写
- * "Textarea"（FLOW 渲染器按 type 查组件查不到 → 多行文本在流式布局下渲染异常）、TextArea
- * 分支（content/maxLen）漏跑。建表 create 和加字段 add-field 都用。
- */
-const CK_CANON = {
-    textarea: 'TextArea', ebuilder: 'EBuilder', datetime: 'DateTime',
-    idcard: 'IDCard', mobile: 'Mobile', email: 'Email', phone: 'Phone',
-    employee: 'Employee', department: 'Department', subcompany: 'SubCompany', location: 'Location',
-    switch: 'Switch', select: 'Select', checkbox: 'CheckBox', radiobox: 'RadioBox',
-    money: 'Money', number: 'Number', date: 'Date', text: 'Text',
-    daterange: 'DateRange', detailtable: 'DetailTable', city: 'City',
-};
-function canonComponentKey(ck) {
-    return CK_CANON[String(ck).toLowerCase()] || ck;
-}
-/**
- * 代码里另有分支/别名、不在 CK_CANON 与 RICH_TYPE_MAP 两处的字段类型。
- * **宁宽勿窄**：多列一个只是照旧送服务器，漏一个会把合法类型误杀，所以这里尽量收全。
- * 新增字段类型时记得同步。
- */
-const EXTRA_FIELD_TYPES = [
-    'Flow', 'SelectMultiple', 'DateInterval', 'ColorPicker', 'DataTable',
-    'DocFolder', 'DocFloder', 'Fold', 'Placeholder', 'Sharer', 'FileComponent',
-    'EbuilderAppTag', 'Attachment', 'Image', 'Signature', 'RichText', 'RelateBrowser',
-    // EInvoice 电子发票：下方 add-field 有专属构建分支（isSingle/invoiceType），此前漏登记 →
-    // 被 assertFieldType 挡成死代码。AudioRecord/VideoRecord 语音视频：极简 jsonObj，平台原样透传
-    // （见 rich-types.ts 的说明），无需富组件模板。
-    'EInvoice', 'AudioRecord', 'VideoRecord',
-];
-/** 可用的字段类型 = 基础组件（CK_CANON 的值）∪ 富组件（RICH_TYPE_MAP 的键）∪ 上述补充。
- * 导出仅为让测试能盯住"平台支持的合法类型不许漏登记"（漏了会被 assertFieldType 误杀）。 */
-export const FIELD_TYPE_CHOICES = [...new Set([
-        ...Object.values(CK_CANON),
-        ...Object.keys(RICH_TYPE_MAP),
-        ...EXTRA_FIELD_TYPES,
-    ])].sort();
-/**
- * 校验字段类型名。不校验的话错类型会**直送服务器**，换回一段
- * `Cannot invoke "ComponentType.name()" because ... getComponentKey() is null`——
- * 既看不出哪错了，也看不出该填什么。这里先拦下来并列出可选值。
- */
-function assertFieldType(fieldType, where = '') {
-    if (FIELD_TYPE_CHOICES.includes(fieldType))
-        return;
-    console.error(`${where}不支持的字段类型: ${fieldType}`);
-    console.error(`  可选: ${FIELD_TYPE_CHOICES.join(' / ')}`);
-    process.exit(1);
-}
-/**
- * 校验选项定义。**键名必须是 `name` / `valueKey`**——写成 `{value,label}` 这类
- * 不会被拦下，而是静默存成「没有名字的选项」（平台侧 fieldOptionName 为空），
- * 之后 `form data add` 按选项名写数据会直接失效，且读回也看不出哪里错了。
+ * 字段类型归一 / 校验 / 校验清单已抽到 `services/form-field-validate.ts` ——
+ * 「标准建表」与「专项建表」两个入口共用同一份，避免两处真相。
+ *
+ * `FIELD_TYPE_CHOICES` 在这里**原样 re-export**：
+ * `form-add-physical-field.ts` 与 `test/form-field-types.test.ts` 仍从本模块取它。
  */
-function assertFieldOptions(fieldName, options) {
-    options.forEach((o, i) => {
-        if (typeof o === 'string')
-            return; // 字符串简写，归一化时会补成 {name}
-        const where = `字段「${fieldName}」第 ${i + 1} 个选项`;
-        if (typeof o?.name !== 'string' || !o.name.trim()) {
-            const got = o && typeof o === 'object' ? Object.keys(o).join(' / ') : String(o);
-            console.error(`${where}缺少 name（收到键：${got || '(无)'}）`);
-            console.error('  正确写法: {"name":"待入职","valueKey":"1"}（valueKey 省略则由平台生成）');
-            process.exit(1);
-        }
-        const vk = o.valueKey;
-        if (vk !== undefined && vk !== null && String(vk) !== '' && !/^\d+$/.test(String(vk))) {
-            console.error(`${where}的 valueKey「${vk}」必须是数字（平台规范，下游按数字引用）`);
-            process.exit(1);
-        }
-    });
-}
+export { FIELD_TYPE_CHOICES };
 /** 系统字段的中文名 → 物理字段 id（form read 实测的平台自带字段）。建表时字段与此完全重名 → 跳过新建、直接复用系统字段。 */
 const SYSTEM_FIELD_NAME_TO_ID = {
     '标题': 'name',
@@ -139,11 +78,21 @@ async function peekViaGetFields(client, baseUrl, objId, fieldId, auth) {
  * 单独抽出来是为了让「读不到 → 中止」这条路清晰：**失败要能被调用方看见**，
  * 不能吞掉之后改走别的接口重建一个定义。
  */
-async function fetchFieldPageRecords(client, baseUrl, appId, formId) {
+/**
+ * 读表单的字段记录。
+ *
+ * ⚠ **主表与明细表是两套结果，不带 `subFormId` 时只返主表字段。**
+ * 明细字段必须显式带 `subFormId` 才查得到 —— 少了这个参数，刚建好的明细字段会「查不到」，
+ * 表现为「字段已建立，但读回字段定义失败」。
+ */
+async function fetchFieldPageRecords(client, baseUrl, appId, formId, subFormId) {
     const r = await client.post(`${baseUrl}/api/ebuilder/form/form/field/manage/getFormFieldPage?apid=${appId}`, {
         pageNo: 1, pageSize: 500, module: 'ebuilderform',
         customParam: { appId },
-        formFieldSearchEntity: { isDelete: 0, status: 'enable', formId },
+        formFieldSearchEntity: {
+            isDelete: 0, status: 'enable', formId,
+            ...(subFormId ? { subFormId: String(subFormId) } : {}),
+        },
     }, { ebbusinessid: formId });
     return r?.data?.pageDatas?.result || r?.data?.data?.records || r?.data?.data || [];
 }
@@ -194,8 +143,7 @@ export function registerFormCommands(program) {
         if (cmdOpts?.appId) {
             try {
                 // Get formId from appId
-                const listData = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${cmdOpts.appId}?apid=${cmdOpts.appId}`, { ebbusinessid: cmdOpts.appId });
-                const formInfo = (listData?.data || []).find((f) => f.id === objId);
+                const formInfo = await resolveFormRecord(client, baseUrl, cmdOpts.appId, objId);
                 formId = formInfo?.formId || '';
                 if (formId) {
                     // Fetch options for Select/RadioBox/CheckBox fields (skip system fields with string IDs)
@@ -342,6 +290,8 @@ export function registerFormCommands(program) {
             process.exit(1);
         }
         const forms = data.data || [];
+        // obj/getList 不含三方表单（专项应用）—— 补上。标准应用没有三方表单，等于空转。
+        await appendThirdPartyForms(client, baseUrl, appId, forms);
         if (cmdOpts?.out) {
             writeFileSync(cmdOpts.out, JSON.stringify(forms, null, 2), 'utf-8');
             console.error(`已写入: ${cmdOpts.out}`);
@@ -405,22 +355,8 @@ export function registerFormCommands(program) {
         // componentKey 大小写归一（canonComponentKey）：用户/示例常写 "Textarea"/"Ebuilder" 等，
         // 但 storageFieldType 与各 `=== 'TextArea'` 分支按 canonical 大小写匹配，不归一会导致 type 存成
         // 小写 "Textarea"（FLOW 渲染异常）、TextArea 分支（content/maxLen）漏跑。
-        // 归一化 + 就地校验（类型名/选项键名）。顶层与明细子字段共用，避免两边校验不一致。
-        const normalizeFieldDef = (raw) => {
-            const out = { ...raw };
-            if (!out.componentKey && out.fieldType)
-                out.componentKey = out.fieldType;
-            if (out.componentKey)
-                out.componentKey = canonComponentKey(out.componentKey);
-            const label = out.fieldName || out.title || '(未命名)';
-            assertFieldType(out.componentKey || '', `字段「${label}」`);
-            if (Array.isArray(out.options) && !out.fieldOptions) {
-                out.fieldOptions = out.options.map((o) => typeof o === 'string' ? { name: o } : o);
-            }
-            if (Array.isArray(out.fieldOptions))
-                assertFieldOptions(label, out.fieldOptions);
-            return out;
-        };
+        // 归一化 + 就地校验（类型名/选项键名）见 services/form-field-validate.ts 的 normalizeFieldDef ——
+        // 顶层与明细子字段共用它，且与「专项建表」共用同一份实现。
         fieldDefs = fieldDefs.map((f) => {
             const out = normalizeFieldDef(f);
             // DetailTable 子字段同样归一化：之前只转顶层，子表 Select 用 options 简写时
@@ -638,42 +574,10 @@ export function registerFormCommands(program) {
             else {
                 console.error(`  数据库表名: ${result.tableName}`);
             }
-            // Create fields and layout
-            const fieldDefsForStandard = fieldDefs.map(f => ({
-                componentKey: f.componentKey, fieldName: f.fieldName,
-                required: f.required, readOnly: f.readOnly, unique: f.unique,
-                hidden: f.hidden, formFields: f.formFields,
-                enableSubDetail: f.enableSubDetail, defaultExpandRow: f.defaultExpandRow,
-                subDetailConfig: f.subDetailConfig,
-                precision: f.precision, pointSize: f.pointSize,
-                percent: f.percent, defaultValue: f.defaultValue,
-                group: f.group, multiple: f.multiple,
-                singleRow: f.singleRow,
-                // 文本最大长度（Text 缺省 100、TextArea 缺省 4000）+ 日期精度 format（Date/DateTime）需透传，
-                // 否则 fields.json 标注的 maxLen/format 被丢（bug：长度默认 100 不生效、日期精度丢失）。
-                maxLen: f.maxLen, format: f.format,
-                // 字段编码 dataKey / 数据库列名 columnName —— 两者是两个东西，可分别指定。
-                // 这里是**白名单透传**，漏一项就会静默丢（maxLen/format 历史上就漏过）。
-                dataKey: f.dataKey, columnName: f.columnName,
-            }));
-            const fieldResult = await addInitialFieldsToCustomPhysicalForm(client, baseUrl, appId, objId, formId, fieldDefsForStandard, auth.tenantKey, layoutType, systemOverrides);
-            fieldGroups = fieldResult.fieldGroups || [];
-            console.error(`  字段+布局已写入: ${fieldDefsForStandard.length} 个字段`);
-            const detailTables = fieldResult.detailTables || [];
-            for (const dt of detailTables) {
-                console.error(`  明细表: ${dt.definition.fieldName}  subFormId: ${dt.subFormId}`);
-            }
-            const subDetailService = new FormSubDetailService(client, baseUrl, appId, objId, formId);
-            for (const dt of detailTables) {
-                const def = dt.definition;
-                if (def.enableSubDetail && Array.isArray(def.subDetailConfig) && def.subDetailConfig.length > 0) {
-                    await subDetailService.set(def.fieldName, def.subDetailConfig, Boolean(def.defaultExpandRow));
-                    console.error(`  二级明细已配置: ${def.fieldName} → ${def.subDetailConfig.map((x) => x.subForm).join(', ')}`);
-                }
-                else if (def.enableSubDetail) {
-                    throw new Error(`明细表 ${def.fieldName} 已声明 enableSubDetail，但 subDetailConfig 为空`);
-                }
-            }
+            // Create fields and layout —— 白名单映射 + 明细/二级明细那一整步已抽到
+            // services/form-create.ts 的 applyInitialFieldsToNewForm，「专项建表」共用同一条链。
+            const fieldResult = await applyInitialFieldsToNewForm(client, baseUrl, appId, objId, formId, fieldDefs, { tenantKey: auth.tenantKey, layoutType, systemOverrides });
+            fieldGroups = fieldResult.fieldGroups;
         }
         catch (e) {
             console.error(`创建失败: ${e.message}`);
@@ -717,8 +621,7 @@ export function registerFormCommands(program) {
         let resolvedFormId = formId || '';
         const resolveFormId = async () => {
             if (!resolvedFormId) {
-                const formList = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
-                const formInfo = (formList?.data || []).find((f) => f.id === objId);
+                const formInfo = await resolveFormRecord(client, baseUrl, appId, objId);
                 resolvedFormId = formInfo?.formId || '';
             }
             return resolvedFormId;
@@ -738,6 +641,8 @@ export function registerFormCommands(program) {
             // Resolve target form names and field IDs from sformId
             const formList = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
             const allForms = formList?.data || [];
+            // 目标表可能是三方表单（专项应用），它不在 getList 里 —— 补上
+            await appendThirdPartyForms(client, baseUrl, appId, allForms);
             const formNameById = new Map();
             for (const fm of allForms) {
                 formNameById.set(fm.id, fm.formName || fm.name || fm.id);
@@ -772,8 +677,7 @@ export function registerFormCommands(program) {
             };
             await resolveFormId();
             if (!resolvedFormId) {
-                const formList = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
-                const formInfo = (formList?.data || []).find((f) => f.id === objId);
+                const formInfo = await resolveFormRecord(client, baseUrl, appId, objId);
                 resolvedFormId = formInfo?.formId || '';
             }
             // Use getFormFieldPage to get full field info including columnName
@@ -988,6 +892,8 @@ export function registerFormCommands(program) {
             try {
                 const formList = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
                 allForms = formList?.data || [];
+                // 目标可能是三方表单（专项应用），它不在 getList 里 —— 补上
+                await appendThirdPartyForms(client, baseUrl, appId, allForms);
             }
             catch { /* 查不到则 formName 用 sformId */ }
             // 读已建字段（拿 fieldId）
@@ -1879,8 +1785,7 @@ export function registerFormCommands(program) {
             process.exit(1);
         }
         // Get formId from appId
-        const listData = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
-        const formInfo = (listData?.data || []).find((f) => f.id === objId);
+        const formInfo = await resolveFormRecord(client, baseUrl, appId, objId);
         const formId = formInfo?.formId || '';
         if (!formId) {
             console.error('无法获取 formId，请确认 appId 和 objId 正确');
@@ -1925,8 +1830,7 @@ export function registerFormCommands(program) {
         const client = new ApiClient(auth);
         const baseUrl = auth.getBaseUrl();
         // objId → formId
-        const listData = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
-        const formInfo = (listData?.data || []).find((f) => String(f.id) === String(objId));
+        const formInfo = await resolveFormRecord(client, baseUrl, appId, objId);
         const formId = formInfo?.formId || '';
         if (!formId) {
             console.error('无法获取 formId，请确认 objId 正确');
@@ -1973,8 +1877,7 @@ export function registerFormCommands(program) {
         const client = new ApiClient(auth);
         const baseUrl = auth.getBaseUrl();
         // Get formId
-        const formList = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
-        const formInfo = (formList?.data || []).find((f) => f.id === objId);
+        const formInfo = await resolveFormRecord(client, baseUrl, appId, objId);
         const formId = formInfo?.formId || '';
         const formTableId = formInfo?.formTableId || '';
         if (!formId) {
@@ -2003,13 +1906,33 @@ export function registerFormCommands(program) {
             console.error('--options 必须是非空数组');
             process.exit(1);
         }
-        // Get current field info for title, dataKey etc.
-        let currentField = {};
+        // 读**现状**（title / dataKey / type / labelObj …）—— 这是「读现状 → 改 → 写回」的底。
+        //
+        // ⚠ 这里**不许降级成 `{}`**。以前读失败只在 catch 里吞掉、`currentField` 变成空对象，
+        // 于是 title 写成空串，平台回「字段标题不能为空」—— 报的是标题，真因是**读没成功**，
+        // 用户怎么去补 title 都没用。宁可中止：拿不到现状就写，等于拿一份空对象覆盖整个字段。
+        let currentField = null;
+        let readErr = '';
         try {
             const fData = await client.post(`${baseUrl}/api/ebuilder/form/form/field/manage/getFormField`, { module: 'ebuilderform', formTableField: { formField: { id: fieldId, form: { id: formId } } } }, { ebbusinessid: formId });
-            currentField = fData?.data || {};
+            if (fData?.code === 200 && fData?.status !== false && fData?.data)
+                currentField = fData.data;
+            else
+                readErr = fData?.msg || `code=${fData?.code}`;
+        }
+        catch (e) {
+            readErr = e.message;
+        }
+        if (!currentField || !Object.keys(currentField).length) {
+            console.error(`读取字段现状失败（${readErr || '接口未返回字段'}），已中止、未改动任何东西。`);
+            console.error('  本命令是「读现状 → 改 → 写回」，读不到现状就写会把字段的其余属性清空。');
+            process.exit(1);
+        }
+        if (!String(currentField.title ?? '').trim()) {
+            console.error(`读回的字段没有 title（fieldId=${fieldId}），已中止、未改动任何东西。`);
+            console.error('  标题在平台里存的是多语言标签 id（labelObj.title）；请先用 `form read` 确认这个字段的状态。');
+            process.exit(1);
         }
-        catch { /* best effort */ }
         // Build options with defOption
         const { randomUUID } = await import('crypto');
         // valueKey=用户自定义选项值，必须是纯数字（平台规范+下游引用按数字处理），非数字直接报错；
@@ -2061,7 +1984,7 @@ export function registerFormCommands(program) {
             hideScore: true,
             groupId: currentField.groupId || '-1',
             hasDisplayFormat: currentField.hasDisplayFormat ?? false,
-            title: currentField.title || '',
+            title: currentField.title,
             dataCount: currentField.dataCount || 1,
             dataKey: currentField.dataKey || '',
             systemField: currentField.systemField ?? true,
@@ -2139,8 +2062,7 @@ export function registerFormCommands(program) {
         const client = new ApiClient(auth);
         const baseUrl = auth.getBaseUrl();
         // Get formId from objId
-        const formList = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
-        const formInfo = (formList?.data || []).find((f) => f.id === objId);
+        const formInfo = await resolveFormRecord(client, baseUrl, appId, objId);
         const formId = formInfo?.formId || '';
         const formTableId = formInfo?.formTableId || '';
         if (!formId) {
@@ -2208,11 +2130,13 @@ export function registerFormCommands(program) {
             // 把错误讲清楚，让用户自己决定要不要 --reinit。
             if (!cmdOpts.reinit) {
                 try {
-                    const fieldDef = (await fetchFieldPageRecords(client, baseUrl, appId, formId))
+                    // ⚠ 明细字段**必须带 subFormId** 才查得到（不带只返主表字段）——
+                    //    少了它，刚建好的明细字段会「查不到」，报成「读回字段定义失败」。
+                    const fieldDef = (await fetchFieldPageRecords(client, baseUrl, appId, formId, cmdOpts.subFormId))
                         .find((f) => String(f.fieldId) === String(fieldId));
                     if (!fieldDef)
                         throw new Error('字段已建立，但读回字段定义失败');
-                    const placed = await insertFieldIntoLayout(client, baseUrl, formId, {
+                    const insertArgs = {
                         fieldId, labelFieldId, title: title || fieldName, fieldDef,
                         subFormId: cmdOpts.subFormId,
                         // 对齐 initLayout 那条路对新字段的默认：可编辑、显示。
@@ -2222,12 +2146,38 @@ export function registerFormCommands(program) {
                             required: cmdOpts.required === true,
                             ...(cmdOpts.singleRow === true ? { singleRow: true } : {}),
                         },
-                    });
+                    };
+                    let placed;
+                    try {
+                        placed = await insertFieldIntoLayout(client, baseUrl, formId, insertArgs);
+                    }
+                    catch (e) {
+                        // 本表还没有这个类型 → 去要一份**平台按该字段生成的模板**再试一次。
+                        // 只在真缺模板时才多打这一次接口，正常路径零开销。
+                        if (e?.code !== NO_FIELD_TYPE_TEMPLATE)
+                            throw e;
+                        const templates = await fetchFieldTypeTemplates(client, baseUrl, appId, formId);
+                        // 主表字段按 fieldId 命中；明细表字段拿不到（接口不返回明细），
+                        // 退而借**主表同类型**的那一份 —— 模板是按类型而不是按作用域的
+                        // （`config.flow` 是空对象、没有 `excel`），作用域由插入方自己写。
+                        const tpl = templates.get(String(fieldId))?.comp
+                            ?? findTemplateByType(templates, String(fieldDef.componentKey ?? fieldType))?.comp;
+                        if (!tpl)
+                            throw e;
+                        console.error('  本表还没有这个类型，改用平台给的字段模板合成组件...');
+                        placed = await insertFieldIntoLayout(client, baseUrl, formId, { ...insertArgs, fieldTypeTemplate: tpl });
+                    }
                     console.error(`  布局已更新: excel[${placed.row},${placed.col}]（增量插入，未重建）`);
+                    // 网格补格这类「改成功了但不干净」的情况要让人看见，不能闷掉。
+                    for (const w of placed.warnings)
+                        console.error(`  ⚠ ${w}`);
                 }
                 catch (e) {
                     console.error(`  布局更新失败: ${e.message}`);
-                    console.error('  字段本身已建立，但没进布局。按上面那条修好重跑本命令即可（重跑不会重复建字段）。');
+                    // ⚠ 别写「重跑不会重复建字段」——字段已经建出来了，重跑这条命令会再次去建同一个
+                    //    字段，撞库列重名而失败。要说清是「先删掉再重跑」。
+                    console.error('  字段本身已建立，但没进布局。要重试请先 `form delete-field` 删掉这个字段再跑，');
+                    console.error('  或直接按上面那条修好布局（字段不用重建）。');
                 }
             }
             else {
@@ -2352,8 +2302,11 @@ export function registerFormCommands(program) {
         // Get formId — try getList first, fall back to searching by fieldId
         let formId = '';
         let resolvedObjId = objId;
+        // 这份列表下面还要再用一次（formId → objId 的反查），所以保留不动；
+        // formInfo 走共用解析 —— obj/getList 命不中时按 id 直取，覆盖三方表单。
         const formList = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
-        const formInfo = (formList?.data || []).find((f) => String(f.id) === String(objId));
+        const formInfo = (formList?.data || []).find((f) => String(f.id) === String(objId))
+            || await resolveFormRecord(client, baseUrl, appId, objId);
         formId = formInfo?.formId || '';
         // If not found in getList (e.g. workflow sub-table objId), search by fieldId
         if (!formId) {
@@ -2370,6 +2323,12 @@ export function registerFormCommands(program) {
                 const matchForm = (formList?.data || []).find((f) => f.formId === formId);
                 if (matchForm)
                     resolvedObjId = matchForm.id;
+                else {
+                    // 三方表单不在 getList 里 —— 按 formId 反查补一次
+                    const byFormId = await resolveObjIdByFormId(client, baseUrl, appId, formId);
+                    if (byFormId)
+                        resolvedObjId = byFormId;
+                }
             }
         }
         if (!formId) {
@@ -2586,8 +2545,7 @@ export function registerFormCommands(program) {
                 let formName = editOpts.formName || fallbackFormName || '';
                 if (!formName) {
                     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));
+                        const tf = await resolveFormRecord(client, baseUrl, appId, sformId);
                         formName = tf?.formName || tf?.name || sformId;
                     }
                     catch {
@@ -2783,8 +2741,7 @@ export function registerFormCommands(program) {
             process.exit(1);
         const client = new ApiClient(auth);
         const baseUrl = auth.getBaseUrl();
-        const formList = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${appId}?apid=${appId}`, { ebbusinessid: appId });
-        const formInfo = (formList?.data || []).find((f) => String(f.id) === String(objId));
+        const formInfo = await resolveFormRecord(client, baseUrl, appId, objId);
         const formId = formInfo?.formId || '';
         if (!formId) {
             console.error('无法获取 formId，请确认 objId 和 appId 正确');
@@ -2892,9 +2849,8 @@ export function registerFormCommands(program) {
         // eb 表 layout/field-manage 接口认 formId（≠objId）：从应用表单列表按 objId 解析 formId
         let formId = '';
         try {
-            const listRes = await client.get(`${baseUrl}/api/bs/ebuilder/form/obj/getList/${encodeURIComponent(appId)}?apid=${encodeURIComponent(appId)}`);
-            const hit = (listRes?.data || []).find((f) => String(f.id) === String(objId));
-            formId = hit?.formId || '';
+            // 原实现这条请求没带 ebbusinessid 头；走共用解析后会带上（与其余 12 处一致）。
+            formId = await resolveFormId(client, baseUrl, appId, objId);
         }
         catch { /* 忽略，下面报错 */ }
         if (!formId)