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

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/form.tpl

@@ -22,15 +22,11 @@
         </div>
       </template>
       <!-- 主子表表单：按 PRD 表单显隐和顺序渲染字段 -->
-      <el-form ref="dataFormRef" :model="form" :rules="dataRules" :disabled="detail" v-loading="loading">
-        <!-- 主表字段区：字段级注释由 MCP 根据字段名称生成 -->
-        <el-row :gutter="24">
-{{FORM_FIELDS}}
-        </el-row>
-        <!-- 子表明细区：按 children 配置渲染多个子表 -->
-        <el-row :gutter="24">
+      <el-form ref="dataFormRef" :model="form" :rules="dataRules" :disabled="detail" v-loading="loading" label-width="120px">
+        <el-collapse v-model="activeCollapseNames">
+{{FORM_COLLAPSE_SECTIONS}}
 {{CHILD_SECTIONS}}
-        </el-row>
+        </el-collapse>
       </el-form>
     </el-card>
   </div>
@@ -72,6 +68,7 @@ const pageI18nKey = '{{I18N_NAMESPACE}}';
 
 // 表单引用
 const dataFormRef = ref();
+const activeCollapseNames = ref({{ACTIVE_COLLAPSE_NAMES}});
 // 页面加载状态
 const loading = ref(false);
 // 是否详情模式

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/form.tpl

@@ -22,11 +22,10 @@
         </div>
       </template>
       <!-- 主表表单：按 PRD 表单显隐和顺序渲染字段 -->
-      <el-form ref="dataFormRef" :model="form" :rules="dataRules" :disabled="detail" v-loading="loading">
-        <!-- 主表字段区：字段级注释由 MCP 根据字段名称生成 -->
-        <el-row :gutter="24">
-{{FORM_FIELDS}}
-        </el-row>
+      <el-form ref="dataFormRef" :model="form" :rules="dataRules" :disabled="detail" v-loading="loading" label-width="120px">
+        <el-collapse v-model="activeCollapseNames">
+{{FORM_COLLAPSE_SECTIONS}}
+        </el-collapse>
       </el-form>
     </el-card>
   </div>
@@ -63,6 +62,7 @@ const { closeCurrentPage } = useCloseCurrentPage();
 
 // 表单引用
 const dataFormRef = ref();
+const activeCollapseNames = ref({{ACTIVE_COLLAPSE_NAMES}});
 // 页面加载状态
 const loading = ref(false);
 // 是否详情模式

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.89';
 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'));
@@ -1224,13 +1228,19 @@ function readUtf8File(filePath) {
   return stripBom(fs.readFileSync(filePath, 'utf8'));
 }
 
-function normalizeDictType(value) {
-  const normalized = String(value || '').trim();
-  if (!normalized || normalized === '-' || normalized === '/') {
-    return null;
-  }
-  return normalized.replace(/^['"`]+|['"`]+$/g, '');
-}
+function normalizeDictType(value) {
+  const normalized = String(value || '').trim();
+  if (!normalized || normalized === '-' || normalized === '/') {
+    return null;
+  }
+  return normalized.replace(/^['"`]+|['"`]+$/g, '');
+}
+
+function normalizeDictTypeFromSourceLabel(value) {
+  const normalized = normalizeDictType(value);
+  if (!normalized) return null;
+  return /^[a-z][a-z0-9_]*$/.test(normalized) ? normalized : null;
+}
 
 function stripDictAnnotation(label) {
   const text = String(label || '').trim();
@@ -1370,9 +1380,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;
 }
 
@@ -1429,29 +1439,33 @@ function normalizeStructuredField(inputField, index, contextLabel) {
     throw new Error(contextLabel + '[' + index + '] is missing required field: type');
   }
 
-  const { length, scale } = normalizeStructuredLengthAndScale(inputField.length ?? inputField.maxLength, inputField.scale);
-  const explicitFormType = normalizeStructuredFormType(inputField.formType || inputField.componentType);
-  const formType = explicitFormType;
-  const explicitQueryType =
-    inputField.queryType === undefined || inputField.queryType === null || inputField.queryType === ''
-      ? undefined
+  const { length, scale } = normalizeStructuredLengthAndScale(inputField.length ?? inputField.maxLength, inputField.scale);
+  const explicitFormType = normalizeStructuredFormType(inputField.formType || inputField.componentType);
+  const formType = explicitFormType;
+  const dictType = normalizeDictType(inputField.dictType) || normalizeDictTypeFromSourceLabel(inputField.sourceDictLabel);
+  const explicitQueryType =
+    inputField.queryType === undefined || inputField.queryType === null || inputField.queryType === ''
+      ? undefined
       : Number.parseInt(String(inputField.queryType), 10);
   const show = parseBooleanLike(inputField.show, true);
-  const listShow = parseBooleanLike(inputField.listShow, show);
-  const formShow = parseBooleanLike(inputField.formShow, show);
-  const formOrder = parseOptionalOrder(inputField.formOrder, contextLabel + '[' + index + '].formOrder');
-
-  return {
+  const listShow = parseBooleanLike(inputField.listShow, show);
+  const formShow = parseBooleanLike(inputField.formShow, show);
+  const formOrder = parseOptionalOrder(inputField.formOrder, contextLabel + '[' + index + '].formOrder');
+  if (formShow === false && formOrder !== undefined) {
+    throw new Error(`${contextLabel}[${index}].formOrder must be empty when formShow=false`);
+  }
+
+  return {
     fieldName,
     attrName: toCamelCase(fieldName),
     sqlType: type,
     length,
     scale,
     comment: label,
-    label,
-    description: String(inputField.description || '').trim(),
-    formType,
-    dictType: normalizeDictType(inputField.dictType),
+    label,
+    description: String(inputField.description || '').trim(),
+    formType,
+    dictType,
     notNull: parseBooleanLike(inputField.required, false),
     defaultValue: normalizeDefaultValue(inputField.defaultValue),
     readonly: parseBooleanLike(inputField.readonly, false),
@@ -1461,13 +1475,13 @@ function normalizeStructuredField(inputField, index, contextLabel) {
     formOrder,
     width: normalizeOptionWidth(inputField.width),
     smart: parseBooleanLike(inputField.smart, false),
-    queryType: Number.isNaN(explicitQueryType)
-      ? undefined
-      : explicitQueryType !== undefined
-        ? explicitQueryType
-        : normalizeDictType(inputField.dictType) && listShow
-          ? 30
-          : undefined,
+    queryType: Number.isNaN(explicitQueryType)
+      ? undefined
+      : explicitQueryType !== undefined
+        ? explicitQueryType
+        : dictType && listShow
+          ? 30
+          : undefined,
     sourceKind: normalizeStructuredSourceKind(inputField.sourceKind),
     primary: parseBooleanLike(inputField.primary, fieldName === 'id'),
   };
@@ -1659,7 +1673,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 +1684,154 @@ 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 collectPayloadFieldGroups(mcpPayload) {
+  const groups = [];
+  if (Array.isArray(mcpPayload.fields)) {
+    groups.push({ path: 'mcpPayload.fields', fields: mcpPayload.fields });
+  }
+  if (Array.isArray(mcpPayload.children)) {
+    mcpPayload.children.forEach((child, childIndex) => {
+      if (Array.isArray(child.fields)) {
+        groups.push({ path: `mcpPayload.children[${childIndex}].fields`, fields: child.fields });
+      }
+    });
+  }
+  if (Array.isArray(mcpPayload.levels)) {
+    mcpPayload.levels.forEach((level, levelIndex) => {
+      if (!Array.isArray(level.modules)) return;
+      level.modules.forEach((module, moduleIndex) => {
+        if (Array.isArray(module.fields)) {
+          groups.push({ path: `mcpPayload.levels[${levelIndex}].modules[${moduleIndex}].fields`, fields: module.fields });
+        }
+      });
+    });
+  }
+  return groups;
+}
+
+function normalizeFieldSet(values) {
+  if (!Array.isArray(values)) return new Set();
+  return new Set(
+    values
+      .map((item) => (typeof item === 'string' ? item : item && (item.fieldName || item.name)))
+      .filter(Boolean)
+      .map((item) => String(item).trim())
+  );
+}
+
+function assertVisibilityMatrixConsistency(parseResult, mcpPayload, parseResultPath) {
+  if (!parseResult.visibilityMatrix || typeof parseResult.visibilityMatrix !== 'object') return;
+  const matrixGroups = Array.isArray(parseResult.visibilityMatrix.groups) ? parseResult.visibilityMatrix.groups : [];
+  const fallbackVisibleFields = normalizeFieldSet(parseResult.visibilityMatrix.visibleFormFields);
+  const fallbackHiddenFields = normalizeFieldSet(parseResult.visibilityMatrix.explicitHiddenFormFields || parseResult.visibilityMatrix.hiddenFormFields);
+  if (!matrixGroups.length && !fallbackVisibleFields.size && !fallbackHiddenFields.size) return;
+
+  const issues = [];
+  for (const group of collectPayloadFieldGroups(mcpPayload)) {
+    const matrixGroup = matrixGroups.find((item) => item && item.path === group.path);
+    const visibleFields = matrixGroup ? normalizeFieldSet(matrixGroup.visibleFormFields) : fallbackVisibleFields;
+    const hiddenFields = matrixGroup ? normalizeFieldSet(matrixGroup.explicitHiddenFormFields || matrixGroup.hiddenFormFields) : fallbackHiddenFields;
+    if (!visibleFields.size && !hiddenFields.size) continue;
+
+    for (const field of group.fields) {
+      if (!field || typeof field !== 'object' || !field.fieldName) continue;
+      const fieldName = String(field.fieldName);
+      const expectedFormShow = visibleFields.has(fieldName) && !hiddenFields.has(fieldName);
+      if (Boolean(field.formShow) !== expectedFormShow) {
+        issues.push(`${group.path}.${fieldName}.formShow expected ${expectedFormShow} from visibilityMatrix, got ${field.formShow}`);
+      }
+      if (!expectedFormShow && field.formOrder !== undefined && field.formOrder !== null && field.formOrder !== '') {
+        issues.push(`${group.path}.${fieldName}.formOrder must be empty when visibilityMatrix marks it hidden`);
+      }
+    }
+  }
+
+  if (issues.length) {
+    throw new Error(`parseResult visibilityMatrix conflicts with mcpPayload in ${parseResultPath}: ${issues.join('; ')}`);
+  }
+}
+
+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);
+  assertVisibilityMatrixConsistency(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;
@@ -2264,23 +2422,24 @@ function renderChildSection(childModel, childCount) {
   const deleteExpression = `deleteChild(obj, '${childModel.pk.attrName}')`;
 
   return [
-    '          <el-col :span="24" class="mb20">',
-    `            <!-- 子表区域：${sanitizeHtmlComment(childModel.comment || childModel.tableName)} -->`,
-    '            <div class="mb10" style="display:flex;justify-content:space-between;align-items:center;">',
-    `              <span style="font-weight: 600;">{{ childSectionTitle('${childModel.listName}') }}</span>`,
-    '              <div style="display:flex;align-items:center;gap:8px;">',
+    `        <el-collapse-item :title="childSectionTitle('${childModel.listName}')" name="child-${childModel.listName}">`,
+    '          <el-row :gutter="24">',
+    '            <el-col :span="24" class="mb20">',
+    `              <!-- 子表区域：${sanitizeHtmlComment(childModel.comment || childModel.tableName)} -->`,
+    '              <div class="mb10" style="display:flex;justify-content:flex-end;align-items:center;gap:8px;">',
     `                <el-button icon="Plus" type="primary" :disabled="detail" @click="handleAddChild('${childModel.listName}')">{{ t('common.addBtn') }}</el-button>`,
     `                <el-button icon="Delete" type="danger" plain :disabled="detail || !getSelectedChildRows('${childModel.listName}').length" @click="handleDeleteSelectedChild('${childModel.listName}', '${childModel.pk.attrName}')">{{ t('common.delBtn') }}</el-button>`,
     '              </div>',
-    '            </div>',
-    '            <!-- 子表编辑表格：新增/删除按钮外置，表格内部隐藏新增、删除和序号控制列 -->',
-    `            <sc-form-table :ref="(el) => setChildTableRef('${childModel.listName}', el)" v-model="form.${childModel.listName}" :addTemplate="childTemp${childModel.className}" hide-index hide-add hide-delete @delete="(obj) => ${deleteExpression}" :placeholder="t('common.noData')" @selection-change="(rows) => handleChildSelectionChange('${childModel.listName}', rows)">`,
-    '            <el-table-column type="selection" width="55" :selectable="() => !detail" />',
+    '              <!-- 子表编辑表格：新增/删除按钮外置，表格内部隐藏新增、删除和序号控制列 -->',
+    `              <sc-form-table :ref="(el) => setChildTableRef('${childModel.listName}', el)" v-model="form.${childModel.listName}" :addTemplate="childTemp${childModel.className}" hide-index hide-add hide-delete @delete="(obj) => ${deleteExpression}" :placeholder="t('common.noData')" @selection-change="(rows) => handleChildSelectionChange('${childModel.listName}', rows)">`,
+    '              <el-table-column type="selection" width="55" :selectable="() => !detail" />',
     childModel.visibleFields.map((field) => renderChildTableColumn(field, childModel.listName)).join('\n'),
-    '            </sc-form-table>',
-    '          </el-col>',
-  ].join('\n');
-}
+    '              </sc-form-table>',
+    '            </el-col>',
+    '          </el-row>',
+    '        </el-collapse-item>',
+  ].join('\n');
+}
 
 function renderChildFormListDefaults(children) {
   if (!children.length) return '';
@@ -2405,7 +2564,7 @@ function renderFieldCommentV2(field, indent = '          ') {
   return indent + '<!-- ' + label + ' -->';
 }
 
-function renderFormFieldV2(field) {
+function renderFormFieldV2(field) {
   const prop = field.attrName;
   const labelExpr = `getMasterFieldLabel('${prop}')`;
   const dictExpr = `getMasterFieldMeta('${prop}')?.dictType`;
@@ -2504,10 +2663,58 @@ function renderFormFieldV2(field) {
     `              <el-input v-model="form.${prop}" :placeholder="formInputPlaceholder(${labelExpr}, ${disabledBool})"${maxlengthAttr}${disabledAttr} />`,
     '            </el-form-item>',
     '          </el-col>',
-  ].join('\n');
-}
-
-function renderMultiLevelOptionField(field, model, moduleModel, dictRegistryRefs, indent = '      ') {
+  ].join('\n');
+}
+
+const FILL_REPORT_FIELD_NAMES = new Set(['createBy', 'createTime', 'finishedTime']);
+const FILL_REPORT_FIELD_ORDER = ['createBy', 'createTime', 'finishedTime'];
+
+function isFillReportField(field) {
+  return FILL_REPORT_FIELD_NAMES.has(String(field?.attrName || field?.fieldName || ''));
+}
+
+function renderBusinessFormCollapseItem(title, name, fields) {
+  return [
+    `        <el-collapse-item title="${title}" name="${name}">`,
+    '          <el-row :gutter="24">',
+    fields.map(renderFormFieldV2).join('\n'),
+    '          </el-row>',
+    '        </el-collapse-item>',
+  ].join('\n');
+}
+
+function splitBusinessFormFields(fields) {
+  const fillReportFields = fields
+    .filter(isFillReportField)
+    .sort((left, right) => FILL_REPORT_FIELD_ORDER.indexOf(left.attrName) - FILL_REPORT_FIELD_ORDER.indexOf(right.attrName));
+  if (!fillReportFields.length) {
+    return { basicFields: fields, fillReportFields: [] };
+  }
+  return {
+    basicFields: fields.filter((field) => !isFillReportField(field)),
+    fillReportFields,
+  };
+}
+
+function renderBusinessFormCollapseSections(model) {
+  const fields = model.pageType === 'ledger' ? model.visibleFields.map(asReadonlyField) : model.visibleFields;
+  const { basicFields, fillReportFields } = splitBusinessFormFields(fields);
+  const sections = [renderBusinessFormCollapseItem('基本信息', '0', basicFields)];
+  if (fillReportFields.length) {
+    sections.push(renderBusinessFormCollapseItem('填报信息', '1', fillReportFields));
+  }
+  return sections.join('\n');
+}
+
+function renderActiveCollapseNames(model) {
+  const fields = model.pageType === 'ledger' ? model.visibleFields.map(asReadonlyField) : model.visibleFields;
+  const names = ['0'];
+  if (fields.some(isFillReportField)) names.push('1');
+  model.children.forEach((childModel) => names.push(`child-${childModel.listName}`));
+  return `[${names.map((name) => `'${name}'`).join(', ')}]`;
+}
+
+function renderMultiLevelOptionField(field, model, moduleModel, dictRegistryRefs, indent = '      ') {
   const parts = [
     `key: '${field.attrName}'`,
     `labelKey: '${buildMultiLevelFieldLabelKey(model, moduleModel, field)}'`,
@@ -2670,15 +2877,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) {`,
@@ -4170,10 +4377,12 @@ function buildReplacements(model, sharedSupport) {
       BUSINESS_FORM_KEEP_ALIVE_COLUMN: model.pageType === 'business' ? ', keep_alive' : '',
       BUSINESS_FORM_KEEP_ALIVE_VALUE: model.pageType === 'business' ? ", '1'" : '',
       BILL_CODE: deriveBillCode(model),
-      GENERATED_AT: new Date().toISOString(),
-      FORM_FIELDS: (model.pageType === 'ledger' ? model.visibleFields.map(asReadonlyField) : model.visibleFields).map(renderFormFieldV2).join('\n'),
-      TABLE_COLUMNS: model.gridFields.map((field) => renderTableColumn(field, dictRegistryRefs)).join('\n'),
-      FORM_DEFAULTS: renderFormDefaults(model),
+      GENERATED_AT: new Date().toISOString(),
+      FORM_FIELDS: (model.pageType === 'ledger' ? model.visibleFields.map(asReadonlyField) : model.visibleFields).map(renderFormFieldV2).join('\n'),
+      FORM_COLLAPSE_SECTIONS: renderBusinessFormCollapseSections(model),
+      ACTIVE_COLLAPSE_NAMES: renderActiveCollapseNames(model),
+      TABLE_COLUMNS: model.gridFields.map((field) => renderTableColumn(field, dictRegistryRefs)).join('\n'),
+      FORM_DEFAULTS: renderFormDefaults(model),
       DICT_REGISTRY_IMPORT_BLOCK: model.dictTypes.length ? "import { DictRegistry } from '/@/enums/dict-registry';" : '',
       MASTER_OPTION_FIELDS: model.optionFields.map((field) => renderOptionFieldV2(field, buildFieldLabelKey(model, field), dictRegistryRefs)).join('\n'),
       CHILD_OPTION_GROUPS: model.children.map((childModel) => renderChildOptionGroupV2(model, childModel, dictRegistryRefs)).join('\n'),
@@ -4231,20 +4440,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 +4465,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.89",
   "description": "Worsoft frontend local-template code generation MCP server.",
   "license": "UNLICENSED",
   "author": "worsoft <sw@worsoft.vip>",