worsoft-frontend-codegen-local-mcp 0.1.85 → 0.1.88

package/README.md

@@ -15,6 +15,18 @@ This MCP generates Worsoft frontend files from structured JSON metadata.
 
 ## Current Inputs
 
+Preferred input:
+
+- `parseResultPath`
+- `writeToDisk`
+- `overwrite`
+- `writeSupportFiles`
+- `mergeI18nZh`
+
+When `parseResultPath` is provided, MCP reads `parseResult.json` locally and uses `parseResult.mcpPayload` as the generation input. The caller should not expand `mcpPayload` in the model context.
+
+Legacy-compatible low-level inputs:
+
 - `featureTitle`
 - `tableName`
 - `tableComment`
@@ -35,7 +47,28 @@ If the caller accidentally passes the `src` directory, MCP will normalize it bac
 
 ## Recommended MCP Arguments
 
-Single table:
+Preferred:
+
+```json
+{
+  "parseResultPath": "E:/own-worker-platform/trunk/docs/03-modules/.../parseResult.json",
+  "writeToDisk": true,
+  "overwrite": true
+}
+```
+
+If `parseResult.mcpPayload` does not contain `frontendPath`, pass it as a non-semantic runtime argument:
+
+```json
+{
+  "parseResultPath": "E:/own-worker-platform/trunk/docs/03-modules/.../parseResult.json",
+  "frontendPath": "E:/own-worker-platform/trunk/worsoft-ui",
+  "writeToDisk": true,
+  "overwrite": true
+}
+```
+
+Legacy low-level single table:
 
 ```json
 {
@@ -56,7 +89,7 @@ Single table:
 }
 ```
 
-Master-child:
+Legacy low-level master-child:
 
 ```json
 {
@@ -105,6 +138,7 @@ Node:
 
 ```bash
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario single
+node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario parse_result_path
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario single_dialog
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario dict_single
 node plugins/worsoft-codegen-local/smoke_test_mcp.js --scenario master
@@ -134,9 +168,9 @@ Optional overrides:
 - `mergeI18nZh=false`:
   MCP renders `zh-cn.ts` from current metadata only and does not parse the existing file
 
-## Master-Child Contract
+## Legacy Low-Level Master-Child Contract
 
-For `master_child_jump`, MCP does not infer relations.
+For low-level `master_child_jump` calls, MCP does not infer relations. `parseResultPath` callers should let `doc-parse` populate `parseResult.mcpPayload.children`.
 
 The caller must provide explicit `children[]`, and each child must include:
 
@@ -149,9 +183,9 @@ The caller must provide explicit `children[]`, and each child must include:
 
 If these fields are missing, MCP returns a structured validation error.
 
-## Multi-Level Dictionary Contract
+## Legacy Low-Level Multi-Level Dictionary Contract
 
-For `multi_level_dict`, MCP does not infer hierarchy.
+For low-level `multi_level_dict`, MCP does not infer hierarchy. `parseResultPath` callers should let `doc-parse` populate `parseResult.mcpPayload.levels`.
 
 The caller must provide explicit `levels[]`. Each level must include:
 
@@ -182,14 +216,7 @@ When the same physical table is split into different logical regions, pass `modu
 - Human guide: `STYLE_TEMPLATE_GUIDE.md`
 - Machine source: `assets/style-catalog.json`
 
-Declared styles:
-
-- `single_table_jump`
-- `single_table_dialog`
-- `master_child_jump`
-- `multi_level_dict`
-- `single_tree_table`
-- `tree_left_list`
+Declared styles are defined by `assets/style-catalog.json`; README intentionally does not duplicate the full enum as a second source.
 
 ## Notes
 

package/assets/templates/ledger_master_child_jump/api.tpl

@@ -2,6 +2,6 @@
 import { createCrudApi } from '/@/api/common/crudFactory';
 {{API_REQUEST_IMPORT}}
 
-// {{FEATURE_TITLE}}主子表台账只读接口：分页查询、详情查询
-export const { fetchList, getObj } = createCrudApi('/{{API_PATH}}');
+// {{FEATURE_TITLE}}主子表台账只读接口：分页查询、详情查询、导出
+export const { fetchList, getObj, exportObj } = createCrudApi('/{{API_PATH}}');
 {{EXTRA_API_FUNCTIONS}}

package/assets/templates/ledger_master_child_jump/index.tpl

@@ -36,7 +36,7 @@
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
 // 列表接口：台账页只消费分页查询能力
-import { fetchList } from '/@/api/{{API_MODULE_PATH}}';
+import { fetchList, exportObj } from '/@/api/{{API_MODULE_PATH}}';
 // 字典数据加载
 import { useDict } from '/@/hooks/dict';
 // 列表页字段元数据能力
@@ -66,8 +66,9 @@ const router = useRouter();
 const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, exportExcel: runExportExcel, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
-  exportUrl: '/{{API_PATH}}/export',
-  exportFileName: '{{FUNCTION_NAME}}.xlsx',
+  exportApi: exportObj,
+  exportFileName: '{{FEATURE_TITLE}}.xlsx',
+  exportColumns: () => tableColumns.value,
 });
 
 // 统一处理台账列表加载后的首行选中，以及刷新后的当前行保持

package/assets/templates/ledger_single_table_jump/api.tpl

@@ -2,6 +2,6 @@
 import { createCrudApi } from '/@/api/common/crudFactory';
 {{API_REQUEST_IMPORT}}
 
-// {{FEATURE_TITLE}}台账只读接口：分页查询、详情查询
-export const { fetchList, getObj } = createCrudApi('/{{API_PATH}}');
+// {{FEATURE_TITLE}}台账只读接口：分页查询、详情查询、导出
+export const { fetchList, getObj, exportObj } = createCrudApi('/{{API_PATH}}');
 {{EXTRA_API_FUNCTIONS}}

package/assets/templates/ledger_single_table_jump/index.tpl

@@ -36,7 +36,7 @@
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
 // 列表接口：台账页只消费分页查询能力
-import { fetchList } from '/@/api/{{API_MODULE_PATH}}';
+import { fetchList, exportObj } from '/@/api/{{API_MODULE_PATH}}';
 // 字典数据加载
 import { useDict } from '/@/hooks/dict';
 // 列表页字段元数据能力
@@ -66,8 +66,9 @@ const router = useRouter();
 const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, exportExcel: runExportExcel, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
-  exportUrl: '/{{API_PATH}}/export',
-  exportFileName: '{{FUNCTION_NAME}}.xlsx',
+  exportApi: exportObj,
+  exportFileName: '{{FEATURE_TITLE}}.xlsx',
+  exportColumns: () => tableColumns.value,
 });
 
 // 统一处理台账列表加载后的首行选中，以及刷新后的当前行保持

package/assets/templates/master_child_jump/index.tpl

@@ -50,7 +50,7 @@
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
 // 列表接口
-import { fetchList, delObjs } from '/@/api/{{API_MODULE_PATH}}';
+import { fetchList, delObjs, exportObj } from '/@/api/{{API_MODULE_PATH}}';
 // 通用消息与确认弹窗
 import { useMessage, useMessageBox } from '/@/hooks/message';
 // 字典数据加载
@@ -91,8 +91,9 @@ const multiple = ref(true);
 const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, exportExcel: runExportExcel, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
-  exportUrl: '/{{API_PATH}}/export',
-  exportFileName: '{{FUNCTION_NAME}}.xlsx',
+  exportApi: exportObj,
+  exportFileName: '{{FEATURE_TITLE}}.xlsx',
+  exportColumns: () => tableColumns.value,
 });
 
 // 统一处理列表加载后的首行选中，以及刷新后的当前行保持

package/assets/templates/single_table_dialog/index.tpl

@@ -44,7 +44,7 @@
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
 // 列表接口
-import { fetchList, delObjs{{DICT_API_IMPORTS}} } from '/@/api/{{API_MODULE_PATH}}';
+import { fetchList, delObjs, exportObj{{DICT_API_IMPORTS}} } from '/@/api/{{API_MODULE_PATH}}';
 // 通用消息与确认弹窗
 import { useMessage, useMessageBox } from '/@/hooks/message';
 // 字典数据加载
@@ -85,8 +85,9 @@ const multiple = ref(true);
 const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, exportExcel: runExportExcel, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
-  exportUrl: '/{{API_PATH}}/export',
-  exportFileName: '{{FUNCTION_NAME}}.xlsx',
+  exportApi: exportObj,
+  exportFileName: '{{FEATURE_TITLE}}.xlsx',
+  exportColumns: () => tableColumns.value,
 });
 
 // 统一处理列表加载后的首行选中，以及刷新后的当前行保持

package/assets/templates/single_table_jump/index.tpl

@@ -51,7 +51,7 @@
 
 <script setup lang="ts" name="system{{CLASS_NAME}}">
 // 列表接口
-import { fetchList, delObjs } from '/@/api/{{API_MODULE_PATH}}';
+import { fetchList, delObjs, exportObj } from '/@/api/{{API_MODULE_PATH}}';
 // 通用消息与确认弹窗
 import { useMessage, useMessageBox } from '/@/hooks/message';
 // 字典数据加载
@@ -92,8 +92,9 @@ const multiple = ref(true);
 const { state, getDataList, currentChangeHandle, sizeChangeHandle, sortChangeHandle, tableStyle, exportExcel: runExportExcel, resetQueryForm } = useSchemaListQuery({
   schema: crudSchema,
   pageList: fetchList,
-  exportUrl: '/{{API_PATH}}/export',
-  exportFileName: '{{FUNCTION_NAME}}.xlsx',
+  exportApi: exportObj,
+  exportFileName: '{{FEATURE_TITLE}}.xlsx',
+  exportColumns: () => tableColumns.value,
 });
 
 // 统一处理列表加载后的首行选中，以及刷新后的当前行保持

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.85';
+const SERVER_VERSION = '0.1.88';
 const PROTOCOL_VERSION = '2024-11-05';
 const TOOL_NAME = 'worsoft_codegen_local_generate_frontend';
 const STYLE_CATALOG_PATH = path.join(__dirname, 'assets', 'style-catalog.json');
@@ -203,15 +203,15 @@ export const createCrudApi = (baseUrl: string, overrides: CrudApiPathOverrides =
       data: obj,
     }),
 
-  exportObj: (query?: object) =>
-    request({
-      url: overrides.export || joinApiPath(baseUrl, 'export'),
-      method: 'get',
-      params: query,
-      responseType: 'blob',
-    }),
-});
-`;
+  exportObj: (query?: object) =>
+    request({
+      url: overrides.export || joinApiPath(baseUrl, 'export'),
+      method: 'post',
+      data: query,
+      responseType: 'blob',
+    }),
+});
+`;
 
 const DEFAULT_CLOSE_CURRENT_PAGE_TEMPLATE = `import type { RouteLocationNormalizedLoaded } from 'vue-router';
 import { useRoute } from 'vue-router';
@@ -260,9 +260,13 @@ export const DictSemanticValues = {
 } as const;
 `;
 
-const TOOL_SCHEMA = {
-  type: 'object',
-  properties: {
+const TOOL_SCHEMA = {
+  type: 'object',
+  properties: {
+    parseResultPath: {
+      type: 'string',
+      description: 'Recommended local parseResult.json path. When provided, MCP reads parseResult.mcpPayload locally and uses it as generation input. Direct low-level arguments are legacy compatibility only.',
+    },
     featureTitle: { type: 'string', description: 'Feature title from pre-parsed structured metadata.' },
     billCode: { type: 'string', description: 'Stable menu bill_code generated from the Chinese menu title initials.' },
     tableName: { type: 'string', description: 'Canonical main table name from PRD-aligned structured metadata.' },
@@ -273,10 +277,10 @@ const TOOL_SCHEMA = {
       enum: ['business', 'dict', 'ledger', 'non_standard'],
       description: 'Structured page type from parseResult. MCP consumes this value but does not derive it. Dict pages are restricted to dialog-based templates. Ledger pages are read-only jump-based templates.',
     },
-    style: { type: 'string', enum: Object.keys(STYLE_CATALOG), description: 'Final style id from parseResult or translated mcpPayload. MCP validates it but does not infer it.' },
+    style: { type: 'string', enum: Object.keys(STYLE_CATALOG), description: 'Legacy low-level final style id from parseResult.mcpPayload. MCP validates it but does not infer it.' },
     fields: {
       type: 'array',
-      description: 'Structured main-table field metadata already translated by the caller. MCP only consumes these low-level generation parameters.',
+      description: 'Legacy low-level structured main-table field metadata. Prefer parseResultPath so MCP reads parseResult.mcpPayload locally.',
       items: {
         type: 'object',
         properties: {
@@ -290,7 +294,7 @@ const TOOL_SCHEMA = {
                   show: { type: ['boolean', 'string'], description: 'Whether the field is shown on the page.' },
                   listShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the list page.' },
                   formShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the form page.' },
-                  formOrder: { type: ['number', 'string'], description: 'Generation-only form field order from PRD detail/form table. This is not emitted to options.ts.' },
+                  formOrder: { type: ['number', 'string'], description: 'Generation-only 1-based form field order from PRD detail/form table. This is not emitted to options.ts.' },
                   smart: { type: ['boolean', 'string'], description: 'Whether the field participates in smart keyword search. This must come from PRD, not inferred from type.' },
           queryType: { type: ['string', 'number'], description: 'Structured query type for list filtering, for example 20 for date ranges or 30 for dictionary filters.' },
           dictType: { type: 'string', description: 'Dictionary type code from structured metadata.' },
@@ -333,7 +337,7 @@ const TOOL_SCHEMA = {
                         show: { type: ['boolean', 'string'], description: 'Whether the field is shown on the page.' },
                         listShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the list page.' },
                         formShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the form page.' },
-                        formOrder: { type: ['number', 'string'], description: 'Generation-only form field order from PRD detail/form table. This is not emitted to options.ts.' },
+                        formOrder: { type: ['number', 'string'], description: 'Generation-only 1-based form field order from PRD detail/form table. This is not emitted to options.ts.' },
                         smart: { type: ['boolean', 'string'], description: 'Whether the field participates in smart keyword search. This must come from PRD, not inferred from type.' },
                 queryType: { type: ['string', 'number'], description: 'Structured query type for list filtering, for example 20 for date ranges or 30 for dictionary filters.' },
                 dictType: { type: 'string', description: 'Dictionary type code from structured metadata.' },
@@ -394,7 +398,7 @@ const TOOL_SCHEMA = {
                               show: { type: ['boolean', 'string'], description: 'Whether the field is shown on the page.' },
                               listShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the list page.' },
                               formShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the form page.' },
-                              formOrder: { type: ['number', 'string'], description: 'Generation-only form field order from PRD detail/form table. This is not emitted to options.ts.' },
+                              formOrder: { type: ['number', 'string'], description: 'Generation-only 1-based form field order from PRD detail/form table. This is not emitted to options.ts.' },
                               smart: { type: ['boolean', 'string'], description: 'Whether the field participates in smart keyword search. This must come from PRD, not inferred from type.' },
                       queryType: { type: ['string', 'number'], description: 'Structured query type for list filtering, for example 20 for date ranges or 30 for dictionary filters.' },
                       dictType: { type: 'string', description: 'Dictionary type code from structured metadata.' },
@@ -465,9 +469,9 @@ const TOOL_SCHEMA = {
       description: 'Whether to merge generated zh-cn content into an existing i18n file. If false, MCP renders zh-cn.ts from current metadata only.'
     },
   },
-  required: ['tableName', 'style', 'frontendPath'],
-  additionalProperties: false,
-};
+  required: [],
+  additionalProperties: false,
+};
 
 function loadStyleCatalog() {
   return JSON.parse(fs.readFileSync(STYLE_CATALOG_PATH, 'utf8'));
@@ -1370,9 +1374,9 @@ function normalizeStructuredLengthAndScale(lengthValue, scaleValue) {
 function parseOptionalOrder(value, label) {
   if (value === undefined || value === null || value === '') return undefined;
   const order = Number.parseInt(String(value), 10);
-  if (Number.isNaN(order) || order < 0) {
-    throw new Error(`${label} must be a non-negative integer when provided, or empty when unspecified`);
-  }
+  if (Number.isNaN(order) || order < 1) {
+    throw new Error(`${label} must be a positive integer starting from 1 when provided, or empty when unspecified`);
+  }
   return order;
 }
 
@@ -1659,7 +1663,7 @@ function normalizePageTypeInput(pageType) {
   throw new Error(`Unsupported pageType: ${normalized}. Allowed values are dict, business, ledger, non_standard.`);
 }
 
-function rejectSemanticStageInputs(input) {
+function rejectSemanticStageInputs(input) {
   const forbiddenKeys = [
     'parseResult',
     'prdFile',
@@ -1670,10 +1674,86 @@ function rejectSemanticStageInputs(input) {
     'fieldUiMeta',
   ];
   const present = forbiddenKeys.filter((key) => Object.prototype.hasOwnProperty.call(input, key));
-  if (present.length) {
-    throw new Error(`worsoft_codegen_local_generate_frontend only accepts translated low-level generation parameters. Unsupported semantic-stage keys: ${present.join(', ')}`);
-  }
-}
+  if (present.length) {
+    throw new Error(`worsoft_codegen_local_generate_frontend only accepts translated low-level generation parameters. Unsupported semantic-stage keys: ${present.join(', ')}`);
+  }
+}
+
+function readJsonFile(filePath, label) {
+  if (!filePath || typeof filePath !== 'string') {
+    throw new Error(`${label} must be a non-empty string`);
+  }
+  const resolvedPath = path.resolve(filePath);
+  if (!fs.existsSync(resolvedPath)) {
+    throw new Error(`${label} not found: ${resolvedPath}`);
+  }
+  try {
+    return { path: resolvedPath, value: JSON.parse(fs.readFileSync(resolvedPath, 'utf8')) };
+  } catch (error) {
+    throw new Error(`${label} is not valid JSON: ${resolvedPath}. ${error.message}`);
+  }
+}
+
+function copyIfPresent(target, source, keys) {
+  if (!source || typeof source !== 'object') return;
+  for (const key of keys) {
+    if (target[key] === undefined && source[key] !== undefined && source[key] !== null && source[key] !== '') {
+      target[key] = source[key];
+    }
+  }
+}
+
+function assertParseResultPayloadConsistency(parseResult, mcpPayload, parseResultPath) {
+  const keys = ['pageType', 'style', 'targetViewDir', 'targetApiModule', 'targetI18nKey', 'billCode'];
+  for (const key of keys) {
+    if (parseResult[key] === undefined || parseResult[key] === null || parseResult[key] === '') continue;
+    if (mcpPayload[key] === undefined || mcpPayload[key] === null || mcpPayload[key] === '') continue;
+    if (String(parseResult[key]) !== String(mcpPayload[key])) {
+      throw new Error(`parseResult.mcpPayload.${key} does not match parseResult.${key} in ${parseResultPath}`);
+    }
+  }
+}
+
+function resolveGenerationInput(input) {
+  if (!input.parseResultPath) {
+    return { generationInput: input, parseResultPath: '' };
+  }
+
+  const parsed = readJsonFile(input.parseResultPath, 'parseResultPath');
+  const parseResult = parsed.value;
+  if (!parseResult || typeof parseResult !== 'object' || Array.isArray(parseResult)) {
+    throw new Error(`parseResultPath must contain a JSON object: ${parsed.path}`);
+  }
+  if (!parseResult.mcpPayload || typeof parseResult.mcpPayload !== 'object' || Array.isArray(parseResult.mcpPayload)) {
+    throw new Error(`parseResult.mcpPayload missing in ${parsed.path}`);
+  }
+
+  const generationInput = { ...parseResult.mcpPayload };
+  copyIfPresent(generationInput, parseResult, [
+    'featureTitle',
+    'billCode',
+    'tableName',
+    'tableComment',
+    'apiPath',
+    'pageType',
+    'style',
+    'targetViewDir',
+    'targetApiModule',
+    'targetI18nKey',
+    'frontendPath',
+    'moduleName',
+  ]);
+  assertParseResultPayloadConsistency(parseResult, generationInput, parsed.path);
+
+  for (const key of ['frontendPath', 'moduleName', 'writeToDisk', 'overwrite', 'writeSupportFiles', 'mergeI18nZh']) {
+    if (Object.prototype.hasOwnProperty.call(input, key)) {
+      generationInput[key] = input[key];
+    }
+  }
+
+  generationInput.parseResultPath = parsed.path;
+  return { generationInput, parseResultPath: parsed.path };
+}
 
 function validatePageTypeAndStyle(pageType, style) {
   if (!pageType) return;
@@ -2670,15 +2750,15 @@ function renderMultiLevelApiFunctions(moduleModel) {
     '  });',
       '}',
       '',
-      `// 导出${title}`,
-      `export function export${moduleModel.className}Obj(query?: any) {`,
-    '  return request({',
-    `    url: '${basePath}/export',`,
-    "    method: 'get',",
-    '    params: query,',
-    "    responseType: 'blob',",
-    '  });',
-      '}',
+      `// 导出${title}`,
+      `export function export${moduleModel.className}Obj(query?: any) {`,
+    '  return request({',
+    `    url: '${basePath}/export',`,
+    "    method: 'post',",
+    '    data: query,',
+    "    responseType: 'blob',",
+    '  });',
+      '}',
       '',
       `// 启用${title}`,
       `export function enable${moduleModel.className}(id: string | number) {`,
@@ -4231,20 +4311,22 @@ function renderFiles(model, stylePreset, sharedSupport, localeZhSupport) {
   return files;
 }
 
-function ensureArguments(input) {
-  if (!input || typeof input !== 'object') throw new Error('Arguments must be an object');
-  rejectSemanticStageInputs(input);
-  for (const key of TOOL_SCHEMA.required) {
-    if (input[key] === undefined || input[key] === null || input[key] === '') throw new Error(key + ' is required');
-  }
-
-  const style = String(input.style);
-  const pageType = normalizePageTypeInput(input.pageType);
-  getStylePreset(style);
-  validatePageTypeAndStyle(pageType, style);
-  const isLevelStyle = isLevelBasedStyle(style);
-  const fields = isLevelStyle ? [] : normalizeStructuredFieldArray(input.fields, 'fields');
-  const levels = isLevelStyle ? normalizeLevelsInput(input.levels) : [];
+function ensureArguments(input) {
+  if (!input || typeof input !== 'object') throw new Error('Arguments must be an object');
+  rejectSemanticStageInputs(input);
+  const resolved = resolveGenerationInput(input);
+  const generationInput = resolved.generationInput;
+  for (const key of ['tableName', 'style', 'frontendPath']) {
+    if (generationInput[key] === undefined || generationInput[key] === null || generationInput[key] === '') throw new Error(key + ' is required');
+  }
+
+  const style = String(generationInput.style);
+  const pageType = normalizePageTypeInput(generationInput.pageType);
+  getStylePreset(style);
+  validatePageTypeAndStyle(pageType, style);
+  const isLevelStyle = isLevelBasedStyle(style);
+  const fields = isLevelStyle ? [] : normalizeStructuredFieldArray(generationInput.fields, 'fields');
+  const levels = isLevelStyle ? normalizeLevelsInput(generationInput.levels) : [];
 
   if (isLevelStyle && !levels.length) {
     throw new Error(`${style} requires levels[]`);
@@ -4254,29 +4336,30 @@ function ensureArguments(input) {
     throw new Error('fields must be a non-empty array');
   }
 
-  return {
-    featureTitle: input.featureTitle ? String(input.featureTitle) : '',
-    billCode: input.billCode ? String(input.billCode).trim() : '',
-    tableName: String(input.tableName),
-    tableComment: input.tableComment ? String(input.tableComment) : '',
-    apiPath: normalizeApiPath(input.apiPath),
-    pageType,
-    style,
-    fields,
-    levels,
-    children: normalizeChildrenInput(input.children),
-    frontendPath: String(input.frontendPath),
-    moduleName: input.moduleName ? String(input.moduleName) : 'admin/test',
-    targetViewDir: input.targetViewDir ? String(input.targetViewDir) : '',
-    targetApiModule: input.targetApiModule ? String(input.targetApiModule) : '',
-    targetI18nKey: input.targetI18nKey ? String(input.targetI18nKey) : '',
-    extraApis: input.extraApis === undefined ? [] : input.extraApis,
-    writeToDisk: input.writeToDisk === undefined ? true : Boolean(input.writeToDisk),
-    overwrite: input.overwrite === undefined ? true : Boolean(input.overwrite),
-    writeSupportFiles: input.writeSupportFiles === undefined ? true : Boolean(input.writeSupportFiles),
-    mergeI18nZh: input.mergeI18nZh === undefined ? true : Boolean(input.mergeI18nZh),
-  };
-}
+  return {
+    parseResultPath: resolved.parseResultPath,
+    featureTitle: generationInput.featureTitle ? String(generationInput.featureTitle) : '',
+    billCode: generationInput.billCode ? String(generationInput.billCode).trim() : '',
+    tableName: String(generationInput.tableName),
+    tableComment: generationInput.tableComment ? String(generationInput.tableComment) : '',
+    apiPath: normalizeApiPath(generationInput.apiPath),
+    pageType,
+    style,
+    fields,
+    levels,
+    children: normalizeChildrenInput(generationInput.children),
+    frontendPath: String(generationInput.frontendPath),
+    moduleName: generationInput.moduleName ? String(generationInput.moduleName) : 'admin/test',
+    targetViewDir: generationInput.targetViewDir ? String(generationInput.targetViewDir) : '',
+    targetApiModule: generationInput.targetApiModule ? String(generationInput.targetApiModule) : '',
+    targetI18nKey: generationInput.targetI18nKey ? String(generationInput.targetI18nKey) : '',
+    extraApis: generationInput.extraApis === undefined ? [] : generationInput.extraApis,
+    writeToDisk: generationInput.writeToDisk === undefined ? true : Boolean(generationInput.writeToDisk),
+    overwrite: generationInput.overwrite === undefined ? true : Boolean(generationInput.overwrite),
+    writeSupportFiles: generationInput.writeSupportFiles === undefined ? true : Boolean(generationInput.writeSupportFiles),
+    mergeI18nZh: generationInput.mergeI18nZh === undefined ? true : Boolean(generationInput.mergeI18nZh),
+  };
+}
 
 function maybeWriteFiles(files, writeToDisk, overwrite) {
   if (!writeToDisk) return;

package/package.json

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