worsoft-frontend-codegen-local-mcp 0.1.16 → 0.1.18

package/assets/templates/master_child_jump/api.tpl

@@ -10,7 +10,7 @@ export function fetchList(query?: object) {
 
 export function addObj(obj?: object) {
   return request({
-    url: '/{{API_PATH}}',
+    url: '/{{API_PATH}}/save',
     method: 'post',
     data: obj,
   });
@@ -18,7 +18,7 @@ export function addObj(obj?: object) {
 
 export function getObj(obj?: object) {
   return request({
-    url: '/{{API_PATH}}/details',
+    url: '/{{API_PATH}}/getById',
     method: 'get',
     params: obj,
   });
@@ -26,24 +26,16 @@ export function getObj(obj?: object) {
 
 export function delObjs(ids?: object) {
   return request({
-    url: '/{{API_PATH}}',
-    method: 'delete',
+    url: '/{{API_PATH}}/removeByIds',
+    method: 'post',
     data: ids,
   });
 }
 
 export function putObj(obj?: object) {
   return request({
-    url: '/{{API_PATH}}',
-    method: 'put',
+    url: '/{{API_PATH}}/updateById',
+    method: 'post',
     data: obj,
   });
 }
-
-export function delChildObj(ids?: object, childTableName?: string) {
-  return request({
-    url: '/{{API_PATH}}/child',
-    method: 'delete',
-    data: childTableName ? { ids, childTableName } : ids,
-  });
-}

package/assets/templates/master_child_jump/form.tpl

@@ -31,7 +31,7 @@
 <script setup lang="ts" name="{{CLASS_NAME}}Form">
 import mittBus from '/@/utils/mitt';
 import { useMessage } from '/@/hooks/message';
-import { getObj, addObj, putObj, delChildObj } from '/@/api/{{API_MODULE_PATH}}';
+import { getObj, addObj, putObj } from '/@/api/{{API_MODULE_PATH}}';
 import { useDict } from '/@/hooks/dict';
 import { useCrudPageMeta } from '/@/hooks/useCrudPageMeta';
 import { useI18n } from 'vue-i18n';
@@ -49,36 +49,30 @@ const dataFormRef = ref();
 const loading = ref(false);
 const detail = ref(false);
 
-// 主表字段的双语、字典和校验提示统一由公共 hook 提供
-const getChildFieldMeta = (groupName: string, prop: string) => childFieldGroups[groupName]?.[prop];
-const resolveLabel = (labelKey?: string, fallback = '') => {
-  if (!labelKey) return fallback;
-  const translated = t(labelKey);
-  return translated === labelKey ? fallback : translated;
-};
-const getChildFieldLabel = (groupName: string, prop: string) => {
-  const config = getChildFieldMeta(groupName, prop);
-  return resolveLabel(config?.labelKey, config?.label || prop);
-};
+// 主表和子表字段的双语、字典和校验提示统一由公共 hook 提供
 const {
   getFieldMeta: getMasterFieldMeta,
   getFieldLabel: getMasterFieldLabel,
+  getChildFieldLabel,
   getDictOptions,
   inputPlaceholder,
   selectPlaceholder,
   fieldRequiredMessage,
   commonActionLabel,
-} = useCrudPageMeta(dataMasterEntity, dictRefs);
+} = useCrudPageMeta(dataMasterEntity, dictRefs, childFieldGroups);
 
 // 子表分组标题从功能级词条中读取
 const childSectionTitle = (groupName: string) => t(`${pageI18nKey}.children.${groupName}.title`);
 
-// 表单数据模型，包含主表字段和多个子表列表
-const form = reactive({
+// 统一维护表单默认值，初始化和重置都复用这一份
+const createDefaultFormState = () => ({
 {{FORM_DEFAULTS}}
 {{CHILD_FORM_LIST_DEFAULTS}}
 });
 
+// 表单数据模型，包含主表字段和多个子表列表
+const form = reactive(createDefaultFormState());
+
 // 各子表新增行时使用的临时对象
 {{CHILD_TEMP_DECLARATIONS}}
 
@@ -92,7 +86,7 @@ const get{{CLASS_NAME}}Data = async (id: string) => {
   try {
     loading.value = true;
     const { data } = await getObj({ {{PK_ATTR}}: id });
-    Object.assign(form, data[0] || {});
+    Object.assign(form, Array.isArray(data) ? data[0] || {} : data || {});
   } catch (error) {
     useMessage().error(t('common.messages.fetchError'));
   } finally {
@@ -102,10 +96,7 @@ const get{{CLASS_NAME}}Data = async (id: string) => {
 
 // 回到初始表单状态，供新增和页面切换时复用
 const resetFormState = () => {
-  Object.assign(form, {
-{{FORM_DEFAULTS}}
-{{CHILD_FORM_LIST_DEFAULTS}}
-  });
+  Object.assign(form, createDefaultFormState());
   nextTick(() => {
     dataFormRef.value?.resetFields();
 {{CHILD_RESET_LISTS}}
@@ -162,16 +153,9 @@ const onSubmit = async (actionType?: string) => {
   }
 };
 
-// 删除子表行，已落库的数据先调用后端删除
-const deleteChild = async (obj: Record<string, any>, childPkAttr: string, childTableName?: string) => {
-  if (obj[childPkAttr]) {
-    try {
-      await delChildObj([obj[childPkAttr]], childTableName);
-      useMessage().success(t('common.delSuccessText'));
-    } catch (err: any) {
-      useMessage().error(err.msg || t('common.delBtn'));
-    }
-  }
+// 子表删除只处理前端行状态，统一随主表保存时提交
+const deleteChild = (_obj: Record<string, any>, _childPkAttr: string) => {
+  return true;
 };
 
 onMounted(() => {

package/assets/templates/single_table_dialog/form.tpl

@@ -41,10 +41,12 @@ const {
 } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
 // 表单数据模型
-const form = reactive({
+const createDefaultFormState = () => ({
 {{FORM_DEFAULTS}}
 });
 
+const form = reactive(createDefaultFormState());
+
 // 表单校验规则，仅保留当前需求中明确必填的字段
 const dataRules = ref({
 {{FORM_RULES}}
@@ -55,7 +57,7 @@ const get{{CLASS_NAME}}Data = async (id: string) => {
   try {
     loading.value = true;
     const { data } = await getObj({ {{PK_ATTR}}: id });
-    Object.assign(form, data[0] || {});
+    Object.assign(form, Array.isArray(data) ? data[0] || {} : data || {});
   } catch (error) {
     useMessage().error(t('common.messages.fetchError'));
   } finally {
@@ -65,9 +67,7 @@ const get{{CLASS_NAME}}Data = async (id: string) => {
 
 // 回到初始表单状态，供新增和弹窗切换时复用
 const resetFormState = () => {
-  Object.assign(form, {
-{{FORM_DEFAULTS}}
-  });
+  Object.assign(form, createDefaultFormState());
   nextTick(() => {
     dataFormRef.value?.resetFields();
   });

package/assets/templates/single_table_jump/form.tpl

@@ -55,10 +55,12 @@ const {
 } = useCrudPageMeta(dataMasterEntity, dictRefs);
 
 // 表单数据模型
-const form = reactive({
+const createDefaultFormState = () => ({
 {{FORM_DEFAULTS}}
 });
 
+const form = reactive(createDefaultFormState());
+
 // 表单校验规则，仅保留当前需求中明确必填的字段
 const dataRules = ref({
 {{FORM_RULES}}
@@ -69,7 +71,7 @@ const get{{CLASS_NAME}}Data = async (id: string) => {
   try {
     loading.value = true;
     const { data } = await getObj({ {{PK_ATTR}}: id });
-    Object.assign(form, data[0] || {});
+    Object.assign(form, Array.isArray(data) ? data[0] || {} : data || {});
   } catch (error) {
     useMessage().error(t('common.messages.fetchError'));
   } finally {
@@ -79,9 +81,7 @@ const get{{CLASS_NAME}}Data = async (id: string) => {
 
 // 回到初始表单状态，供新增和页面切换时复用
 const resetFormState = () => {
-  Object.assign(form, {
-{{FORM_DEFAULTS}}
-  });
+  Object.assign(form, createDefaultFormState());
   nextTick(() => {
     dataFormRef.value?.resetFields();
   });

package/mcp_server.js

@@ -5,7 +5,7 @@ const fs = require('fs');
 const path = require('path');
 
 const SERVER_NAME = 'worsoft-codegen-local';
-const SERVER_VERSION = '0.1.16';
+const SERVER_VERSION = '0.1.18';
 const PROTOCOL_VERSION = '2024-11-05';
 const TOOL_NAME = 'worsoft_codegen_local_generate_frontend';
 const TEMPLATE_LIBRARY_ROOT = path.resolve(__dirname, '..', 'template');
@@ -130,25 +130,27 @@ const TOOL_SCHEMA = {
     designFile: { type: 'string', description: 'Absolute or relative Markdown design file path. Defaults to ../sql/SQL 设计说明.md when omitted.' },
     tableName: { type: 'string', description: 'Target main table name from the design file.' },
     style: { type: 'string', enum: Object.keys(STYLE_CATALOG), description: 'Style id from assets/style-catalog.json.' },
-    children: {
-      type: 'array',
-      description: 'Optional direct child-table relations for master_child_jump. When provided, MCP renders all listed direct child tables on the same main form.',
-      items: {
-        type: 'object',
-        properties: {
-          childTableName: { type: 'string', description: 'Child table name.' },
-          mainField: { type: 'string', description: 'Main table relation field.' },
-          childField: { type: 'string', description: 'Child table relation field.' },
-          relationType: { type: 'string', description: 'Optional relation type label, for example 1:N.' },
-        },
-        required: ['childTableName', 'mainField', 'childField'],
-        additionalProperties: false,
-      },
-    },
-    childTableName: { type: 'string', description: 'Child table name. Required when style=master_child_jump.' },
-    mainField: { type: 'string', description: 'Main table relation field. Required when style=master_child_jump.' },
-    childField: { type: 'string', description: 'Child table relation field. Required when style=master_child_jump.' },
-    relationType: { type: 'string', description: 'Optional relation type label, for example 1:N.' },
+    children: {
+      type: 'array',
+      description: 'Optional direct child-table relations for master_child_jump. When provided, MCP renders all listed direct child tables on the same main form.',
+      items: {
+        type: 'object',
+        properties: {
+          childTableName: { type: 'string', description: 'Child table name.' },
+          mainField: { type: 'string', description: 'Main table relation field.' },
+          childField: { type: 'string', description: 'Child table relation field.' },
+          payloadField: { type: 'string', description: 'Optional backend payload list field name from the API document, for example certificateList.' },
+          relationType: { type: 'string', description: 'Optional relation type label, for example 1:N.' },
+        },
+        required: ['childTableName', 'mainField', 'childField'],
+        additionalProperties: false,
+      },
+    },
+    childTableName: { type: 'string', description: 'Child table name. Required when style=master_child_jump.' },
+    mainField: { type: 'string', description: 'Main table relation field. Required when style=master_child_jump.' },
+    childField: { type: 'string', description: 'Child table relation field. Required when style=master_child_jump.' },
+    childPayloadField: { type: 'string', description: 'Optional backend payload list field name for the legacy single-child mode, for example certificateList.' },
+    relationType: { type: 'string', description: 'Optional relation type label, for example 1:N.' },
     frontendPath: { type: 'string', description: 'Absolute frontend output root path.' },
     moduleName: { type: 'string', description: 'Relative frontend module path, for example admin/test.' },
     writeToDisk: { type: 'boolean', default: true, description: 'Whether to write generated files.' },
@@ -870,14 +872,18 @@ function resolveSourcePath(inputPath) {
   throw new Error('Source file does not exist: ' + resolvedPath);
 }
 
-function formatRelationCandidate(relation) {
-  return {
-    childTableName: relation.childTableName,
-    mainField: relation.mainField,
-    childField: relation.childField,
-    relationType: relation.relationType || '',
-  };
-}
+function formatRelationCandidate(relation) {
+  const candidate = {
+    childTableName: relation.childTableName,
+    mainField: relation.mainField,
+    childField: relation.childField,
+    relationType: relation.relationType || '',
+  };
+  if (relation.payloadField) {
+    candidate.payloadField = relation.payloadField;
+  }
+  return candidate;
+}
 
 function getRelationCandidates(designDoc, tableName) {
   return designDoc.relations
@@ -899,14 +905,15 @@ function buildRetryArguments(safeArgs, sourceFile, childTableName) {
     retryArguments.designFile = sourceFile;
   }
 
-  if (safeArgs.children && safeArgs.children.length) {
-    retryArguments.children = safeArgs.children.map((relation) => ({
-      childTableName: relation.childTableName,
-      mainField: relation.mainField,
-      childField: relation.childField,
-      relationType: relation.relationType || '',
-    }));
-  }
+  if (safeArgs.children && safeArgs.children.length) {
+    retryArguments.children = safeArgs.children.map((relation) => ({
+      childTableName: relation.childTableName,
+      mainField: relation.mainField,
+      childField: relation.childField,
+      ...(relation.payloadField ? { payloadField: relation.payloadField } : {}),
+      relationType: relation.relationType || '',
+    }));
+  }
 
   if (childTableName) {
     retryArguments.childTableName = childTableName;
@@ -916,9 +923,13 @@ function buildRetryArguments(safeArgs, sourceFile, childTableName) {
     retryArguments.mainField = safeArgs.mainField;
   }
 
-  if (safeArgs.childField) {
-    retryArguments.childField = safeArgs.childField;
-  }
+  if (safeArgs.childField) {
+    retryArguments.childField = safeArgs.childField;
+  }
+
+  if (safeArgs.childPayloadField) {
+    retryArguments.childPayloadField = safeArgs.childPayloadField;
+  }
 
   if (safeArgs.relationType) {
     retryArguments.relationType = safeArgs.relationType;
@@ -970,7 +981,7 @@ function loadSourceDocument(safeArgs) {
   };
 }
 
-function normalizeChildrenInput(inputChildren) {
+function normalizeChildrenInput(inputChildren) {
   if (inputChildren === undefined || inputChildren === null) {
     return [];
   }
@@ -981,28 +992,30 @@ function normalizeChildrenInput(inputChildren) {
     if (!item || typeof item !== 'object') {
       throw new Error('children[' + index + '] must be an object');
     }
-    const childTableName = item.childTableName ? String(item.childTableName) : '';
-    const mainField = item.mainField ? String(item.mainField) : '';
-    const childField = item.childField ? String(item.childField) : '';
-    const relationType = item.relationType ? String(item.relationType) : '';
-    const missingFields = ['childTableName', 'mainField', 'childField'].filter((field) => !({ childTableName, mainField, childField })[field]);
-    if (missingFields.length) {
-      throw new Error('children[' + index + '] is missing required fields: ' + missingFields.join(', '));
-    }
-    return { childTableName, mainField, childField, relationType };
-  });
-}
+    const childTableName = item.childTableName ? String(item.childTableName) : '';
+    const mainField = item.mainField ? String(item.mainField) : '';
+    const childField = item.childField ? String(item.childField) : '';
+    const payloadField = item.payloadField ? String(item.payloadField) : '';
+    const relationType = item.relationType ? String(item.relationType) : '';
+    const missingFields = ['childTableName', 'mainField', 'childField'].filter((field) => !({ childTableName, mainField, childField })[field]);
+    if (missingFields.length) {
+      throw new Error('children[' + index + '] is missing required fields: ' + missingFields.join(', '));
+    }
+    return { childTableName, mainField, childField, payloadField, relationType };
+  });
+}
 
 function resolveMarkdownChildRelations(sourceDocument, safeArgs) {
   if (safeArgs.children && safeArgs.children.length) {
     return safeArgs.children.map((relation) => ({
       mainTableName: safeArgs.tableName,
-      childTableName: relation.childTableName,
-      mainField: relation.mainField,
-      childField: relation.childField,
-      relationType: relation.relationType || '',
-    }));
-  }
+      childTableName: relation.childTableName,
+      mainField: relation.mainField,
+      childField: relation.childField,
+      payloadField: relation.payloadField || '',
+      relationType: relation.relationType || '',
+    }));
+  }
 
   const missingFields = ['childTableName', 'mainField', 'childField'].filter((field) => !safeArgs[field]);
   if (missingFields.length) {
@@ -1020,31 +1033,34 @@ function resolveMarkdownChildRelations(sourceDocument, safeArgs) {
         example: {
           ...buildRetryArguments(safeArgs, sourceDocument.path, safeArgs.childTableName || '<child_table_name>'),
           children: [
-            {
-              childTableName: safeArgs.childTableName || '<child_table_name>',
-              mainField: safeArgs.mainField || '<main_field>',
-              childField: safeArgs.childField || '<child_field>',
-              relationType: safeArgs.relationType || '1:N',
-            },
-          ],
-          mainField: safeArgs.mainField || '<main_field>',
-          childField: safeArgs.childField || '<child_field>',
-        },
-      },
-    };
+            {
+              childTableName: safeArgs.childTableName || '<child_table_name>',
+              mainField: safeArgs.mainField || '<main_field>',
+              childField: safeArgs.childField || '<child_field>',
+              ...(safeArgs.childPayloadField ? { payloadField: safeArgs.childPayloadField } : {}),
+              relationType: safeArgs.relationType || '1:N',
+            },
+          ],
+          mainField: safeArgs.mainField || '<main_field>',
+          childField: safeArgs.childField || '<child_field>',
+          ...(safeArgs.childPayloadField ? { childPayloadField: safeArgs.childPayloadField } : {}),
+        },
+      },
+    };
     throw error;
   }
 
   return [
     {
       mainTableName: safeArgs.tableName,
-      childTableName: safeArgs.childTableName,
-      mainField: safeArgs.mainField,
-      childField: safeArgs.childField,
-      relationType: safeArgs.relationType || '',
-    },
-  ];
-}
+      childTableName: safeArgs.childTableName,
+      mainField: safeArgs.mainField,
+      childField: safeArgs.childField,
+      payloadField: safeArgs.childPayloadField || '',
+      relationType: safeArgs.relationType || '',
+    },
+  ];
+}
 
 function getStylePreset(styleId) {
   const preset = STYLE_CATALOG[styleId];
@@ -1075,28 +1091,33 @@ function ensureFieldExists(fields, fieldName, tableName, role) {
   return field;
 }
 
-function buildChildModels(sourceDocument, safeArgs, mainParsed) {
-  if (safeArgs.style !== 'master_child_jump') return [];
-
-  const relations = resolveMarkdownChildRelations(sourceDocument, safeArgs);
-  return relations.map((relation) => {
+function buildChildModels(sourceDocument, safeArgs, mainParsed) {
+  if (safeArgs.style !== 'master_child_jump') return [];
+
+  const relations = resolveMarkdownChildRelations(sourceDocument, safeArgs);
+  return relations.map((relation) => {
     const childParsed = parseTableFromMarkdownDesign(sourceDocument.designDoc, relation.childTableName);
     const childFields = normalizeFields(childParsed);
     const mainRelationField = ensureFieldExists(mainParsed.fields, relation.mainField, safeArgs.tableName, 'Main relation');
     const childRelationField = ensureFieldExists(childParsed.fields, relation.childField, relation.childTableName, 'Child relation');
-    const childVisibleFields = childFields.filter(
-      (field) => field.fieldName !== childParsed.pkField.fieldName && !field.isAudit && field.fieldName !== relation.childField
-    );
-
-    return {
-      tableName: relation.childTableName,
-      tableComment: childParsed.tableComment,
-      className: toPascalCase(relation.childTableName),
-      functionName: toCamelCase(relation.childTableName),
-      listName: toCamelCase(relation.childTableName) + 'List',
-      pk: childParsed.pkField,
-      fields: childFields,
-      visibleFields: childVisibleFields,
+    const childVisibleFields = childFields.filter(
+      (field) => field.fieldName !== childParsed.pkField.fieldName && !field.isAudit && field.fieldName !== relation.childField
+    );
+    const payloadField =
+      relation.payloadField || (relations.length === 1 && safeArgs.childPayloadField ? safeArgs.childPayloadField : '') || '';
+    const listName = payloadField || toCamelCase(relation.childTableName) + 'List';
+
+    return {
+      tableName: relation.childTableName,
+      tableComment: childParsed.tableComment,
+      className: toPascalCase(relation.childTableName),
+      functionName: toCamelCase(relation.childTableName),
+      listName,
+      payloadField,
+      payloadFieldSource: payloadField ? 'arguments' : 'derived',
+      pk: childParsed.pkField,
+      fields: childFields,
+      visibleFields: childVisibleFields,
       mainField: mainRelationField,
       childField: childRelationField,
       relationType: relation.relationType,
@@ -1285,12 +1306,9 @@ function renderChildTempDeclaration(childModel) {
   ].join('\n');
 }
 
-function renderChildSection(childModel, childCount) {
-  const title = childModel.tableComment.replace(/'/g, "\\'");
-  const deleteExpression =
-    childCount > 1
-      ? `deleteChild(obj, '${childModel.pk.attrName}', '${childModel.tableName}')`
-      : `deleteChild(obj, '${childModel.pk.attrName}')`;
+function renderChildSection(childModel, childCount) {
+  const title = childModel.tableComment.replace(/'/g, "\\'");
+  const deleteExpression = `deleteChild(obj, '${childModel.pk.attrName}')`;
 
   return [
     '          <el-col :span="24" class="mb20">',
@@ -1541,11 +1559,8 @@ function renderChildTableColumnV2(field, childListName) {
   ].join('\n');
 }
 
-function renderChildSectionV2(childModel, childCount) {
-  const deleteExpression =
-    childCount > 1
-      ? `deleteChild(obj, '${childModel.pk.attrName}', '${childModel.tableName}')`
-      : `deleteChild(obj, '${childModel.pk.attrName}')`;
+function renderChildSectionV2(childModel, childCount) {
+  const deleteExpression = `deleteChild(obj, '${childModel.pk.attrName}')`;
 
   return [
     '          <el-col :span="24" class="mb20">',
@@ -1666,11 +1681,12 @@ function ensureArguments(input) {
     designFile: input.designFile ? String(input.designFile) : null,
     tableName: String(input.tableName),
     style,
-    children: normalizeChildrenInput(input.children),
-    childTableName: input.childTableName ? String(input.childTableName) : null,
-    mainField: input.mainField ? String(input.mainField) : null,
-    childField: input.childField ? String(input.childField) : null,
-    relationType: input.relationType ? String(input.relationType) : '',
+    children: normalizeChildrenInput(input.children),
+    childTableName: input.childTableName ? String(input.childTableName) : null,
+    mainField: input.mainField ? String(input.mainField) : null,
+    childField: input.childField ? String(input.childField) : null,
+    childPayloadField: input.childPayloadField ? String(input.childPayloadField) : null,
+    relationType: input.relationType ? String(input.relationType) : '',
     frontendPath: String(input.frontendPath),
     moduleName: input.moduleName ? String(input.moduleName) : 'admin/test',
     writeToDisk: input.writeToDisk === undefined ? true : Boolean(input.writeToDisk),
@@ -1700,14 +1716,16 @@ function maybeWriteFiles(files, writeToDisk, overwrite) {
 }
 
 function buildManifest(model, safeArgs, stylePreset, sharedTemplates, files, note) {
-  const relations = model.children.map((childModel) => ({
-    childTableName: childModel.tableName,
-    childTableComment: childModel.tableComment,
-    mainField: childModel.mainField.fieldName,
-    childField: childModel.childField.fieldName,
-    childListName: childModel.listName,
-    relationType: childModel.relationType || '',
-  }));
+  const relations = model.children.map((childModel) => ({
+    childTableName: childModel.tableName,
+    childTableComment: childModel.tableComment,
+    mainField: childModel.mainField.fieldName,
+    childField: childModel.childField.fieldName,
+    childListName: childModel.listName,
+    payloadField: childModel.payloadField || '',
+    payloadFieldSource: childModel.payloadFieldSource || 'derived',
+    relationType: childModel.relationType || '',
+  }));
   const selectedList = relations.map((relation) => formatRelationCandidate(relation));
 
   return {
@@ -1743,18 +1761,31 @@ function buildManifest(model, safeArgs, stylePreset, sharedTemplates, files, not
           },
         }
       : null,
-    summary: {
-      totalFields: model.fields.length,
-      visibleFields: model.visibleFields.length,
-      dictFields: model.visibleFields.filter((field) => field.dictType).map((field) => field.attrName),
-      skippedAuditFields: model.fields.filter((field) => field.isAudit).map((field) => field.fieldName),
-      childCount: model.children.length,
-      childTables: model.children.map((childModel) => childModel.tableName),
-      childVisibleFields: model.children.reduce((sum, childModel) => sum + childModel.visibleFields.length, 0),
-    },
-    note,
-  };
-}
+    summary: {
+      totalFields: model.fields.length,
+      visibleFields: model.visibleFields.length,
+      dictFields: model.visibleFields.filter((field) => field.dictType).map((field) => field.attrName),
+      skippedAuditFields: model.fields.filter((field) => field.isAudit).map((field) => field.fieldName),
+      childCount: model.children.length,
+      childTables: model.children.map((childModel) => childModel.tableName),
+      childPayloadFields: model.children.map((childModel) => ({ childTableName: childModel.tableName, payloadField: childModel.payloadField || childModel.listName })),
+      childVisibleFields: model.children.reduce((sum, childModel) => sum + childModel.visibleFields.length, 0),
+    },
+    structureValidation: model.children.length
+      ? {
+          source: 'arguments',
+          children: model.children.map((childModel) => ({
+            childTableName: childModel.tableName,
+            childListName: childModel.listName,
+            payloadField: childModel.payloadField || '',
+            payloadFieldSource: childModel.payloadFieldSource || 'derived',
+            matchesExplicitPayloadField: Boolean(childModel.payloadField),
+          })),
+        }
+      : null,
+    note,
+  };
+}
 
 async function handleToolCall(argumentsObject) {
   const safeArgs = ensureArguments(argumentsObject);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "worsoft-frontend-codegen-local-mcp",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "Worsoft frontend local-template code generation MCP server.",
   "license": "UNLICENSED",
   "author": "worsoft <sw@worsoft.vip>",