worsoft-frontend-codegen-local-mcp 0.1.27 → 0.1.28

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.27';
+const SERVER_VERSION = '0.1.28';
 const PROTOCOL_VERSION = '2024-11-05';
 const TOOL_NAME = 'worsoft_codegen_local_generate_frontend';
 const TEMPLATE_LIBRARY_ROOT = path.resolve(__dirname, '..', 'template');
@@ -774,21 +774,21 @@ function normalizeDefaultValue(value) {
   return normalized;
 }
 
-function parseBooleanLike(value, defaultValue = false) {
-  if (value === undefined || value === null || value === '') {
-    return defaultValue;
-  }
-  if (typeof value === 'boolean') {
-    return value;
-  }
-  const normalized = String(value).trim().toLowerCase();
-  if (['true', '1', 'yes', 'y', 'required', 'shi', 'show', '\u662f', '\u663e\u793a'].includes(normalized)) {
-    return true;
-  }
-  if (['false', '0', 'no', 'n', 'fou', 'hide', '\u5426', '\u9690\u85cf'].includes(normalized)) {
-    return false;
-  }
-  return defaultValue;
+function parseBooleanLike(value, defaultValue = false) {
+  if (value === undefined || value === null || value === '') {
+    return defaultValue;
+  }
+  if (typeof value === 'boolean') {
+    return value;
+  }
+  const normalized = String(value).trim().toLowerCase();
+  if (['true', '1', 'yes', 'y', 'required', 'shi', 'show', '\u662f', '\u663e\u793a'].includes(normalized)) {
+    return true;
+  }
+  if (['false', '0', 'no', 'n', 'fou', 'hide', '\u5426', '\u9690\u85cf'].includes(normalized)) {
+    return false;
+  }
+  return defaultValue;
 }
 
 
@@ -807,19 +807,19 @@ function normalizeApiPath(value) {
     .replace(/\/+$/, '');
 }
 
-function normalizeStructuredSqlType(value) {
-  const normalized = String(value || '').trim();
-  const upper = normalized.replace(/\s+/g, '').toUpperCase();
-
-  if (!upper) return 'VARCHAR';
-  if (['STRING', 'VARCHAR', 'CHAR'].includes(upper) || ['\u6587\u672c', '\u5b57\u7b26\u4e32', '\u5b57\u7b26'].includes(normalized)) return 'VARCHAR';
-  if (['TEXTAREA', 'LONGTEXT', 'TEXT'].includes(upper) || ['\u957f\u6587\u672c', '\u6587\u672c\u57df'].includes(normalized)) return 'TEXT';
-  if (['LONG', 'BIGINT', 'LONGINTEGER'].includes(upper) || ['\u957f\u6574\u6570', '\u957f\u6574\u578b'].includes(normalized)) return 'BIGINT';
-  if (['INT', 'INTEGER', 'SHORT', 'SMALLINT'].includes(upper) || ['\u6574\u6570', '\u6574\u578b'].includes(normalized)) return 'INT';
-  if (['DECIMAL', 'NUMERIC', 'BIGDECIMAL', 'DOUBLE', 'FLOAT'].includes(upper) || ['\u5c0f\u6570', '\u6570\u503c'].includes(normalized)) return 'DECIMAL';
-  if (['LOCALDATE', 'DATE'].includes(upper) || normalized === '\u65e5\u671f') return 'DATE';
-  if (['LOCALDATETIME', 'DATETIME', 'TIMESTAMP'].includes(upper) || ['\u65e5\u671f\u65f6\u95f4', '\u65f6\u95f4\u6233'].includes(normalized)) return 'DATETIME';
-  return upper;
+function normalizeStructuredSqlType(value) {
+  const normalized = String(value || '').trim();
+  const upper = normalized.replace(/\s+/g, '').toUpperCase();
+
+  if (!upper) return 'VARCHAR';
+  if (['STRING', 'VARCHAR', 'CHAR'].includes(upper) || ['\u6587\u672c', '\u5b57\u7b26\u4e32', '\u5b57\u7b26'].includes(normalized)) return 'VARCHAR';
+  if (['TEXTAREA', 'LONGTEXT', 'TEXT'].includes(upper) || ['\u957f\u6587\u672c', '\u6587\u672c\u57df'].includes(normalized)) return 'TEXT';
+  if (['LONG', 'BIGINT', 'LONGINTEGER'].includes(upper) || ['\u957f\u6574\u6570', '\u957f\u6574\u578b'].includes(normalized)) return 'BIGINT';
+  if (['INT', 'INTEGER', 'SHORT', 'SMALLINT'].includes(upper) || ['\u6574\u6570', '\u6574\u578b'].includes(normalized)) return 'INT';
+  if (['DECIMAL', 'NUMERIC', 'BIGDECIMAL', 'DOUBLE', 'FLOAT'].includes(upper) || ['\u5c0f\u6570', '\u6570\u503c'].includes(normalized)) return 'DECIMAL';
+  if (['LOCALDATE', 'DATE'].includes(upper) || normalized === '\u65e5\u671f') return 'DATE';
+  if (['LOCALDATETIME', 'DATETIME', 'TIMESTAMP'].includes(upper) || ['\u65e5\u671f\u65f6\u95f4', '\u65f6\u95f4\u6233'].includes(normalized)) return 'DATETIME';
+  return upper;
 }
 function normalizeStructuredLengthAndScale(lengthValue, scaleValue) {
   const parsed = splitLength(lengthValue);
@@ -1270,7 +1270,7 @@ function renderFormField(field) {
       '          <el-col :span="12" class="mb20">',
       `            <el-form-item label="${label}" prop="${prop}">`,
       `              <el-select v-model="form.${prop}" :placeholder="${selectPlaceholderExpr}" style="width: 100%">`,
-      `                <el-option v-for="item in ${field.dictType}" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
+      `                <el-option v-for="item in ${field.dictType}" :key="item.value" :label="item.label" :value="item.value" />`,
       '              </el-select>',
       '            </el-form-item>',
       '          </el-col>',
@@ -1344,7 +1344,7 @@ function renderChildTableColumn(field, childListName) {
   if (field.formType === 'select' && field.dictType) {
     control = [
       `                  <el-select v-model="row.${field.attrName}" :placeholder="${selectPlaceholderExpr}" style="width: 100%">`,
-      `                    <el-option v-for="item in ${field.dictType}" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
+      `                    <el-option v-for="item in ${field.dictType}" :key="item.value" :label="item.label" :value="item.value" />`,
       '                  </el-select>',
     ].join('\n');
   } else if (field.formType === 'number') {
@@ -1379,6 +1379,13 @@ function renderDefaultLine(field) {
   return `  ${field.attrName}: '',`;
 }
 
+function renderFormRulesV2(fields) {
+  return fields
+    .filter((field) => field.notNull)
+    .map((field) => `  ${field.attrName}: [{ required: true, message: fieldRequiredMessage('${field.attrName}'), trigger: 'blur' }],`)
+    .join('\n');
+}
+
 function renderFormDefaults(model) {
   const lines = [`  ${model.pk.attrName}: '',`];
   for (const field of model.fields.filter((item) => item.fieldName !== model.pk.fieldName && !item.isAudit)) lines.push(renderDefaultLine(field));
@@ -1439,63 +1446,63 @@ function renderDictImportBlock(dictTypes) {
   ].join('\n');
 }
 
-function normalizeWidthLabel(field) {
-  return stripDictAnnotation(field.comment).replace(/\s+/g, '').trim();
-}
-
-function getLabelVisibleLength(label) {
-  return String(label || '').replace(/[()\uFF08\uFF09{}\[\]\-_,.:\uFF1A;\uFF1B\/\\\s]/g, '').length;
-}
-
-function matchesAnyLabel(label, values) {
-  return values.some((value) => label === value);
-}
-
-function includesAnyLabel(label, values) {
-  return values.some((value) => label.includes(value));
-}
-
-function getDefaultOptionFieldWidthV2(field) {
-  const label = normalizeWidthLabel(field);
-  const visibleLength = getLabelVisibleLength(label);
-
-  if (field.formType === 'textarea') return '300';
-
-  if (matchesAnyLabel(label, ['\u72b6\u6001', '\u5355\u636e\u72b6\u6001'])) return '80';
-  if (label === '\u9879\u76ee\u7f16\u53f7') return '80';
-  if (label === '\u7edf\u4e00\u793e\u4f1a\u4fe1\u7528\u4ee3\u7801') return '160';
-  if (matchesAnyLabel(label, ['\u56fd\u5bb6'])) return '100';
-  if (matchesAnyLabel(label, ['\u7701\u4efd', '\u57ce\u5e02'])) return '120';
-  if (matchesAnyLabel(label, ['\u89c4\u6a21'])) return '100';
-  if (matchesAnyLabel(label, ['\u9879\u76ee\u7b80\u79f0', '\u8d44\u8d28\u4f7f\u7528'])) return '200';
-  if (matchesAnyLabel(label, ['\u4e3b\u8ddf\u8e2a\u4eba', '\u8ddf\u8e2a\u5355\u4f4d', '\u7ec4\u7ec7\u673a\u6784\u5168\u8def\u5f84'])) return '200';
-  if (matchesAnyLabel(label, ['\u4e1a\u4e3b\u7b80\u79f0', '\u4f9b\u5e94\u5546\u7b80\u79f0', '\u7269\u8d44\u540d\u79f0', '\u4f5c\u4e1a\u540d\u79f0'])) return '150';
-  if (matchesAnyLabel(label, ['\u89c4\u683c\u578b\u53f7', '\u8ba1\u91cf\u5355\u4f4d'])) return '80';
-  if (matchesAnyLabel(label, ['\u4e1a\u4e3b\u5355\u4f4d', '\u76d1\u7406\u5355\u4f4d', '\u8bbe\u8ba1\u5355\u4f4d', '\u5206\u5305\u5355\u4f4d', '\u4f9b\u5e94\u5546\u540d\u79f0'])) return '250';
-  if (matchesAnyLabel(label, ['\u6750\u6599\u7279\u5f81'])) return '200';
-
-  if (matchesAnyLabel(label, ['\u5408\u540c\u7f16\u53f7', '\u5355\u636e\u7f16\u53f7']) || (label !== '\u9879\u76ee\u7f16\u53f7' && label.endsWith('\u7f16\u7801'))) return '200';
-
-  if (matchesAnyLabel(label, [
-    '\u9879\u76ee\u540d\u79f0',
-    '\u9879\u76ee\u540d\u79f0\u5408\u540c',
-    '\u9879\u76ee\u540d\u79f0\u4e2d\u6587',
-    '\u62db\u6807\u9879\u76ee\u540d\u79f0',
-    '\u5408\u540c\u540d\u79f0',
-    '\u5408\u540c\u540d\u79f0\u5408\u540c',
-    '\u5408\u540c\u540d\u79f0\u4e2d\u6587',
-  ])) return '350';
-
-  if (includesAnyLabel(label, ['\u91d1\u989d'])) return '180';
-  if (includesAnyLabel(label, ['\u6570\u91cf', '\u5355\u4ef7', '\u6570\u989d'])) return '140';
-  if (label.endsWith('\u4eba')) return '90';
-  if (includesAnyLabel(label, ['\u7535\u8bdd'])) return '100';
-
-  if (field.formType === 'datetime') return '150';
-  if (field.formType === 'date') return visibleLength > 7 ? '170' : '90';
-  if (field.formType === 'select') return visibleLength > 5 ? '200' : '100';
-
-  return '100';
+function normalizeWidthLabel(field) {
+  return stripDictAnnotation(field.comment).replace(/\s+/g, '').trim();
+}
+
+function getLabelVisibleLength(label) {
+  return String(label || '').replace(/[()\uFF08\uFF09{}\[\]\-_,.:\uFF1A;\uFF1B\/\\\s]/g, '').length;
+}
+
+function matchesAnyLabel(label, values) {
+  return values.some((value) => label === value);
+}
+
+function includesAnyLabel(label, values) {
+  return values.some((value) => label.includes(value));
+}
+
+function getDefaultOptionFieldWidthV2(field) {
+  const label = normalizeWidthLabel(field);
+  const visibleLength = getLabelVisibleLength(label);
+
+  if (field.formType === 'textarea') return '300';
+
+  if (matchesAnyLabel(label, ['\u72b6\u6001', '\u5355\u636e\u72b6\u6001'])) return '80';
+  if (label === '\u9879\u76ee\u7f16\u53f7') return '80';
+  if (label === '\u7edf\u4e00\u793e\u4f1a\u4fe1\u7528\u4ee3\u7801') return '160';
+  if (matchesAnyLabel(label, ['\u56fd\u5bb6'])) return '100';
+  if (matchesAnyLabel(label, ['\u7701\u4efd', '\u57ce\u5e02'])) return '120';
+  if (matchesAnyLabel(label, ['\u89c4\u6a21'])) return '100';
+  if (matchesAnyLabel(label, ['\u9879\u76ee\u7b80\u79f0', '\u8d44\u8d28\u4f7f\u7528'])) return '200';
+  if (matchesAnyLabel(label, ['\u4e3b\u8ddf\u8e2a\u4eba', '\u8ddf\u8e2a\u5355\u4f4d', '\u7ec4\u7ec7\u673a\u6784\u5168\u8def\u5f84'])) return '200';
+  if (matchesAnyLabel(label, ['\u4e1a\u4e3b\u7b80\u79f0', '\u4f9b\u5e94\u5546\u7b80\u79f0', '\u7269\u8d44\u540d\u79f0', '\u4f5c\u4e1a\u540d\u79f0'])) return '150';
+  if (matchesAnyLabel(label, ['\u89c4\u683c\u578b\u53f7', '\u8ba1\u91cf\u5355\u4f4d'])) return '80';
+  if (matchesAnyLabel(label, ['\u4e1a\u4e3b\u5355\u4f4d', '\u76d1\u7406\u5355\u4f4d', '\u8bbe\u8ba1\u5355\u4f4d', '\u5206\u5305\u5355\u4f4d', '\u4f9b\u5e94\u5546\u540d\u79f0'])) return '250';
+  if (matchesAnyLabel(label, ['\u6750\u6599\u7279\u5f81'])) return '200';
+
+  if (matchesAnyLabel(label, ['\u5408\u540c\u7f16\u53f7', '\u5355\u636e\u7f16\u53f7']) || (label !== '\u9879\u76ee\u7f16\u53f7' && label.endsWith('\u7f16\u7801'))) return '200';
+
+  if (matchesAnyLabel(label, [
+    '\u9879\u76ee\u540d\u79f0',
+    '\u9879\u76ee\u540d\u79f0\u5408\u540c',
+    '\u9879\u76ee\u540d\u79f0\u4e2d\u6587',
+    '\u62db\u6807\u9879\u76ee\u540d\u79f0',
+    '\u5408\u540c\u540d\u79f0',
+    '\u5408\u540c\u540d\u79f0\u5408\u540c',
+    '\u5408\u540c\u540d\u79f0\u4e2d\u6587',
+  ])) return '350';
+
+  if (includesAnyLabel(label, ['\u91d1\u989d'])) return '180';
+  if (includesAnyLabel(label, ['\u6570\u91cf', '\u5355\u4ef7', '\u6570\u989d'])) return '140';
+  if (label.endsWith('\u4eba')) return '90';
+  if (includesAnyLabel(label, ['\u7535\u8bdd'])) return '100';
+
+  if (field.formType === 'datetime') return '150';
+  if (field.formType === 'date') return visibleLength > 7 ? '170' : '90';
+  if (field.formType === 'select') return visibleLength > 5 ? '200' : '100';
+
+  return '100';
 }
 function renderOptionFieldV2(field, labelKey, dictRegistryRefs, indent = '    ') {
   const fallbackLabel = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
@@ -1547,16 +1554,17 @@ function renderDisabledAttrV2(field) {
   return field.readonly ? ' disabled' : '';
 }
 
-function isAttachmentLikeField(field) {
-  const fieldName = String(field?.fieldName || field?.attrName || '').toLowerCase();
-  const comment = String(field?.comment || field?.description || '').toLowerCase();
-  return fieldName.includes('attachment') || comment.includes('\u9644\u4ef6') || comment.includes('\u4e0a\u4f20');
-}
-
-function renderFieldCommentV2(field, indent = '          ') {
-  const label = stripDictAnnotation(field.comment || field.attrName).replace(/-->/g, '').trim() || field.attrName;
-  return indent + '<!-- \u5b57\u6bb5\uFF1A' + label + ' -->';
+function isAttachmentLikeField(field) {
+  const fieldName = String(field?.fieldName || field?.attrName || '').toLowerCase();
+  const comment = String(field?.comment || field?.description || '').toLowerCase();
+  return fieldName.includes('attachment') || comment.includes('\u9644\u4ef6') || comment.includes('\u4e0a\u4f20');
+}
+
+function renderFieldCommentV2(field, indent = '          ') {
+  const label = stripDictAnnotation(field.comment || field.attrName).replace(/-->/g, '').trim() || field.attrName;
+  return indent + '<!-- 字段：' + label + ' -->';
 }
+
 function renderFormFieldV2(field) {
   const prop = field.attrName;
   const labelExpr = `getMasterFieldLabel('${prop}')`;
@@ -1569,7 +1577,7 @@ function renderFormFieldV2(field) {
       `          <el-col :span="12" class="mb20">`,
       `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
       `              <el-select v-model="form.${prop}" :placeholder="selectPlaceholder(${labelExpr})" style="width: 100%"${disabledAttr}>`,
-      `                <el-option v-for="item in getDictOptions(${dictExpr})" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
+      `                <el-option v-for="item in getDictOptions(${dictExpr})" :key="item.value" :label="item.label" :value="item.value" />`,
       '              </el-select>',
       '            </el-form-item>',
       '          </el-col>',
@@ -1625,281 +1633,150 @@ function renderFormFieldV2(field) {
   ].join('\n');
 }
 
-function renderTableColumnV2(field, dictRegistryRefs) {
-  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
-  const parts = [`prop: '${field.attrName}'`, `label: '${label}'`];
+function renderMultiLevelOptionField(field, model, moduleModel, dictRegistryRefs, indent = '      ') {
+  const parts = [
+    `key: '${field.attrName}'`,
+    `labelKey: '${buildMultiLevelFieldLabelKey(model, moduleModel, field)}'`,
+  ];
   const width = getDefaultOptionFieldWidthV2(field);
-
-  if (width !== '120') {
-    parts.push(`width: '${width}'`);
-  }
-
-  if (field.dictType) {
-    parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
-  }
-
-  return `  { ${parts.join(', ')} },`;
-}
-
-function renderChildTableColumnV2(field, childListName) {
-  const rules = field.notNull ? ` :rules="[{ required: true, trigger: 'blur' }]"` : '';
-  const labelExpr = `getChildFieldLabel('${childListName}', '${field.attrName}')`;
-  const dictExpr = `getChildFieldMeta('${childListName}', '${field.attrName}')?.dictType`;
-  const disabledAttr = renderDisabledAttrV2(field);
-
-  let control = `                  <el-input v-model="row.${field.attrName}" :placeholder="inputPlaceholder(${labelExpr})"${renderTextMaxlengthAttrV2(field)}${disabledAttr} />`;
-  if (field.formType === 'select' && field.dictType) {
-    control = [
-      `                  <el-select v-model="row.${field.attrName}" :placeholder="selectPlaceholder(${labelExpr})" style="width: 100%"${disabledAttr}>`,
-      `                    <el-option v-for="item in getDictOptions(${dictExpr})" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
-      '                  </el-select>',
-    ].join('\n');
-  } else if (field.formType === 'number') {
-    const max = field.comment.includes('%') || /\u6BD4\u4F8B/.test(field.comment) ? ' :max="100"' : '';
-    const precision = field.sqlType === 'DECIMAL' && field.scale ? ` :precision="${field.scale}" :step="0.01"` : '';
-    control = `                  <el-input-number v-model="row.${field.attrName}" :min="0"${max}${precision} style="width: 100%"${disabledAttr} />`;
-  } else if (field.formType === 'datetime' || field.formType === 'date') {
-    const pickerType = field.formType === 'datetime' ? 'datetime' : 'date';
-    const formatName = field.formType === 'datetime' ? 'dateTimeStr' : 'dateStr';
-    control = `                  <el-date-picker type="${pickerType}" v-model="row.${field.attrName}" :value-format="${formatName}" :placeholder="inputPlaceholder(${labelExpr})" style="width: 100%"${disabledAttr}></el-date-picker>`;
-  } else if (field.formType === 'textarea') {
-    control = `                  <el-input type="textarea" v-model="row.${field.attrName}" :placeholder="inputPlaceholder(${labelExpr})"${renderTextareaMaxlengthAttrsV2(field)}${disabledAttr} />`;
-  }
-
-  return [
-    renderFieldCommentV2(field, '            '),
-    `            <el-table-column :label="${labelExpr}" prop="${field.attrName}">`,
-    '              <template #default="{ row, $index }">',
-    `                <el-form-item :prop="\`${childListName}.\${$index}.${field.attrName}\`"${rules}>`,
-    control,
-    '                </el-form-item>',
-    '              </template>',
-    '            </el-table-column>',
-  ].join('\n');
-}
-
-function renderChildSectionV2(childModel, childCount) {
-  const deleteExpression = `deleteChild(obj, '${childModel.pk.attrName}')`;
-
-  return [
-    '          <el-col :span="24" class="mb20">',
-    `            <div class="mb10" style="font-weight: 600;">{{ childSectionTitle('${childModel.listName}') }}</div>`,
-    `            <sc-form-table v-model="form.${childModel.listName}" :addTemplate="childTemp${childModel.className}" @delete="(obj) => ${deleteExpression}" :placeholder="t('common.noData')">`,
-    childModel.visibleFields.map((field) => renderChildTableColumnV2(field, childModel.listName)).join('\n'),
-    '            </sc-form-table>',
-    '          </el-col>',
-  ].join('\n');
-}
-
-function renderValidationRule(field) {
-  if (!field.notNull) return null;
-  const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
-  return `  ${field.attrName}: [{ required: true, message: '${label}\u4E0D\u80FD\u4E3A\u7A7A', trigger: 'blur' }],`;
+  if (width) parts.push(`width: '${width}'`);
+  if (field.show === false) parts.push('show: false');
+  if (field.listShow === false) parts.push('listShow: false');
+  if (field.dictType) parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
+  return `${indent}{ ${parts.join(', ')} },`;
 }
 
-function renderFormRules(visibleFields) {
-  const lines = visibleFields.map(renderValidationRule).filter(Boolean);
+function renderMultiLevelModuleDefinition(model, moduleModel, dictRegistryRefs) {
+  const lines = [
+    `  ${moduleModel.key}: {`,
+    `    key: '${moduleModel.key}',`,
+    `    titleKey: '${buildMultiLevelModuleTitleKey(model, moduleModel)}',`,
+    `    apiPath: '${moduleModel.apiPath}',`,
+    `    primaryKey: '${moduleModel.pk.attrName}',`,
+  ];
+  if (moduleModel.queryParentField) lines.push(`    queryParentField: '${moduleModel.queryParentField}',`);
+  if (moduleModel.statusField) lines.push(`    statusField: '${moduleModel.statusField}',`);
+  if (moduleModel.statusDictType) lines.push(`    statusDictType: ${getDictRegistryReference(moduleModel.statusDictType, dictRegistryRefs)},`);
+  lines.push(`    enableApi: '${moduleModel.enableApi.startsWith('/') ? moduleModel.enableApi : '/' + moduleModel.enableApi}',`);
+  lines.push(`    disableApi: '${moduleModel.disableApi.startsWith('/') ? moduleModel.disableApi : '/' + moduleModel.disableApi}',`);
+  lines.push('    fields: [');
+  lines.push(moduleModel.optionFields.map((field) => renderMultiLevelOptionField(field, model, moduleModel, dictRegistryRefs)).join('\n'));
+  lines.push('    ],');
+  lines.push('  },');
   return lines.join('\n');
 }
 
-function renderFormRulesV2(visibleFields) {
-  const lines = visibleFields
-    .filter((field) => field.notNull)
-    .map((field) => `  ${field.attrName}: [{ required: true, message: fieldRequiredMessage('${field.attrName}'), trigger: 'blur' }],`);
-  return lines.join('\n');
+function renderMultiLevelLevelConfig(level) {
+  return `  { levelIndex: ${level.levelIndex}, position: '${level.position}', moduleKeys: [${level.modules.map((moduleModel) => `'${moduleModel.key}'`).join(', ')}] },`;
 }
 
-function toKebabCase(value) {
-  return String(value || '')
-    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')
-    .replace(/_/g, '-')
-    .toLowerCase();
-}
-
-function renderMultiLevelFieldConfig(model, moduleModel, field, dictRegistryRefs, indent = '      ') {
-  const parts = [
-    `key: '${field.attrName}'`,
-    `labelKey: '${buildMultiLevelFieldLabelKey(model, moduleModel, field)}'`,
-  ];
-  const width = getDefaultOptionFieldWidthV2(field);
-  if (width !== '120') parts.push(`width: '${width}'`);
-  if (field.show === false) parts.push('show: false');
-  if (field.listShow === false) parts.push('listShow: false');
-  if (field.dictType) parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
-  return `${indent}{ ${parts.join(', ')} },`;
-}
-
 function renderMultiLevelOptionsTs(model, dictRegistryRefs) {
-  const dictImportBlock = model.dictTypes.length ? "import { DictRegistry } from '/@/enums/dict-registry';\n" : '';
-  const moduleConfigsBody = model.modules
-    .map((moduleModel) => {
-      const dictTypes = [...new Set(moduleModel.optionFields.map((field) => field.dictType).filter(Boolean))];
-        return [
-          `  ${moduleModel.key}: {`,
-          `    key: '${moduleModel.key}',`,
-          `    titleKey: '${buildMultiLevelModuleTitleKey(model, moduleModel)}',`,
-          `    apiPath: '${moduleModel.apiPath}',`,
-          `    primaryKey: '${moduleModel.pk.attrName}',`,
-        ...(moduleModel.queryParentField ? [`    queryParentField: '${moduleModel.queryParentField}',`] : []),
-        ...(moduleModel.statusField ? [`    statusField: '${moduleModel.statusField}',`] : []),
-        ...(moduleModel.statusDictType ? [`    statusDictType: ${getDictRegistryReference(moduleModel.statusDictType, dictRegistryRefs)},`] : []),
-        `    enableApi: '/${moduleModel.enableApi}',`,
-        `    disableApi: '/${moduleModel.disableApi}',`,
-        `    dictTypes: [${dictTypes.map((item) => getDictRegistryReference(item, dictRegistryRefs)).join(', ')}],`,
-        '    fields: [',
-        moduleModel.optionFields.map((field) => renderMultiLevelFieldConfig(model, moduleModel, field, dictRegistryRefs, '      ')).join('\n'),
-        '    ],',
-        '  },',
-      ].join('\n');
-    })
-    .join('\n');
-
-  const levelConfigsBody = model.levels
-    .map(
-      (level) =>
-        `  { levelIndex: ${level.levelIndex}, position: '${level.position}', moduleKeys: [${level.modules.map((moduleModel) => `'${moduleModel.key}'`).join(', ')}] },`
-    )
-    .join('\n');
-
-  return `import type { FieldMeta } from '/@/utils/crudSchema';\n${dictImportBlock}
-export interface MultiLevelDictFieldConfig {
-  key: string;
-  labelKey: string;
-  width?: string;
-  show?: boolean;
-  listShow?: boolean;
-  dictType?: string;
-}
-
-export interface MultiLevelDictModuleDefinition {
-  key: string;
-  titleKey: string;
-  apiPath: string;
-  primaryKey: string;
-  queryParentField?: string;
-  statusField?: string;
-  statusDictType?: string;
-  enableApi: string;
-  disableApi: string;
-  fields: MultiLevelDictFieldConfig[];
-}
-
-export interface MultiLevelDictModuleConfig extends MultiLevelDictModuleDefinition {
-  dictTypes: string[];
-}
-
-export interface MultiLevelDictLevelConfig {
-  levelIndex: number;
-  position: 'left' | 'right' | 'right-top' | 'right-bottom';
-  moduleKeys: string[];
-}
-
-const toFieldMetaMap = (fields: MultiLevelDictFieldConfig[]) =>
-  Object.fromEntries(
-    fields.map((item) => [
-      item.key,
-      {
-        show: item.show ?? true,
-        listShow: item.listShow ?? item.show ?? true,
-        alwaysHide: false,
-        smart: false,
-        labelKey: item.labelKey,
-        width: item.width ?? '120',
-        ...(item.dictType ? { dictType: item.dictType } : {}),
-      } satisfies FieldMeta,
-    ])
-  ) as Record<string, FieldMeta>;
-
-const createModuleConfig = (definition: MultiLevelDictModuleDefinition): MultiLevelDictModuleConfig => ({
-  ...definition,
-  dictTypes: Array.from(
-    new Set([...(definition.fields.map((field) => field.dictType).filter(Boolean) as string[]), definition.statusDictType].filter(Boolean))
-  ),
-});
-
-const moduleDefinitions: Record<string, MultiLevelDictModuleDefinition> = {
-${moduleConfigsBody}
-};
-
-export const moduleConfigs = Object.fromEntries(
-  Object.entries(moduleDefinitions).map(([key, definition]) => [key, createModuleConfig(definition)])
-) as Record<string, MultiLevelDictModuleConfig>;
-
-export const levelConfigs: MultiLevelDictLevelConfig[] = [
-${levelConfigsBody}
-];
-
-export const moduleFieldGroups = Object.fromEntries(
-  Object.entries(moduleConfigs).map(([key, config]) => [key, toFieldMetaMap(config.fields)])
-) as Record<string, Record<string, FieldMeta>>;
-
-export const allDictTypes = Array.from(new Set(Object.values(moduleConfigs).flatMap((config) => config.dictTypes)));
-`;
-  }
+  return [
+    "import type { FieldMeta } from '/@/utils/crudSchema';",
+    "import type { MultiLevelDictFieldConfig, MultiLevelDictLevelConfig, MultiLevelDictModuleConfig, MultiLevelDictModuleDefinition } from '/@/types/multiLevelDict';",
+    "import { DictRegistry } from '/@/enums/dict-registry';",
+    '',
+    'const toFieldMetaMap = (fields: MultiLevelDictFieldConfig[]) =>',
+    '  Object.fromEntries(',
+    '    fields.map((item) => [',
+    '      item.key,',
+    '      {',
+    '        show: item.show ?? true,',
+    '        listShow: item.listShow ?? item.show ?? true,',
+    '        alwaysHide: false,',
+    '        smart: false,',
+    '        labelKey: item.labelKey,',
+    "        width: item.width ?? '120',",
+    "        ...(item.dictType ? { dictType: item.dictType } : {}),",
+    '      } satisfies FieldMeta,',
+    '    ])',
+    '  ) as Record<string, FieldMeta>;',
+    '',
+    'const isString = (value: string | undefined): value is string => Boolean(value);',
+    '',
+    'const createModuleConfig = (definition: MultiLevelDictModuleDefinition): MultiLevelDictModuleConfig => ({',
+    '  ...definition,',
+    '  dictTypes: Array.from(new Set([...definition.fields.map((field) => field.dictType).filter(isString), definition.statusDictType].filter(isString))),',
+    '});',
+    '',
+    'const moduleDefinitions: Record<string, MultiLevelDictModuleDefinition> = {',
+    model.modules.map((moduleModel) => renderMultiLevelModuleDefinition(model, moduleModel, dictRegistryRefs)).join('\n'),
+    '};',
+    '',
+    'export const moduleConfigs = Object.fromEntries(',
+    '  Object.entries(moduleDefinitions).map(([key, definition]) => [key, createModuleConfig(definition)])',
+    ') as Record<string, MultiLevelDictModuleConfig>;',
+    '',
+    'export const levelConfigs: MultiLevelDictLevelConfig[] = [',
+    model.levels.map(renderMultiLevelLevelConfig).join('\n'),
+    '];',
+    '',
+    'export const moduleFieldGroups = Object.fromEntries(',
+    '  Object.entries(moduleConfigs).map(([key, config]) => [key, toFieldMetaMap(config.fields)])',
+    ') as Record<string, Record<string, FieldMeta>>;',
+    '',
+    'export const allDictTypes = Array.from(new Set(Object.values(moduleConfigs).flatMap((config) => config.dictTypes)));',
+    '',
+  ].join('\n');
+}
 
 function renderMultiLevelApiFunctions(moduleModel) {
-  const entityVar = moduleModel.entityName;
-  const className = moduleModel.className;
+  const pkAttr = moduleModel.pk.attrName;
+  const basePath = moduleModel.apiPath.startsWith('/') ? moduleModel.apiPath : '/' + moduleModel.apiPath;
+  const enablePath = moduleModel.enableApi.startsWith('/') ? moduleModel.enableApi : '/' + moduleModel.enableApi;
+  const disablePath = moduleModel.disableApi.startsWith('/') ? moduleModel.disableApi : '/' + moduleModel.disableApi;
   return [
-    `export function fetch${className}List(query: any) {`,
+    `export function fetch${moduleModel.className}List(query?: any) {`,
     '  return request({',
-    `    url: '/${moduleModel.apiPath}/page',`,
+    `    url: '${basePath}/page',`,
     "    method: 'get',",
-    '    params: {',
-    '      current: query?.current,',
-    '      size: query?.size,',
-    `      ${entityVar}: {`,
-    ...(moduleModel.queryParentField
-      ? [`        ...(query?.${moduleModel.queryParentField} !== undefined && query?.${moduleModel.queryParentField} !== null && query?.${moduleModel.queryParentField} !== '' ? { ${moduleModel.queryParentField}: query.${moduleModel.queryParentField} } : {}),`]
-      : []),
-    '      },',
-    '    },',
+    '    params: query,',
     '  });',
     '}',
     '',
-    `export function get${className}Obj(id: string | number) {`,
+    `export function get${moduleModel.className}Obj(id: string | number) {`,
     '  return request({',
-    `    url: '/${moduleModel.apiPath}/getById',`,
+    `    url: '${basePath}/getById',`,
     "    method: 'get',",
-    '    params: { id },',
+    `    params: { ${pkAttr}: id },`,
     '  });',
     '}',
     '',
-    `export function add${className}Obj(obj: any) {`,
+    `export function add${moduleModel.className}Obj(data: any) {`,
     '  return request({',
-    `    url: '/${moduleModel.apiPath}/save',`,
+    `    url: '${basePath}/save',`,
     "    method: 'post',",
-    '    data: obj,',
+    '    data,',
     '  });',
     '}',
     '',
-    `export function put${className}Obj(obj: any) {`,
+    `export function put${moduleModel.className}Obj(data: any) {`,
     '  return request({',
-    `    url: '/${moduleModel.apiPath}/updateById',`,
+    `    url: '${basePath}/updateById',`,
     "    method: 'post',",
-    '    data: obj,',
+    '    data,',
     '  });',
     '}',
     '',
-    `export function del${className}Objs(ids: Array<string | number>) {`,
+    `export function del${moduleModel.className}Objs(data: Array<string | number>) {`,
     '  return request({',
-    `    url: '/${moduleModel.apiPath}/removeByIds',`,
+    `    url: '${basePath}/removeByIds',`,
     "    method: 'post',",
-    '    data: ids,',
+    '    data,',
     '  });',
     '}',
     '',
-    `export function enable${className}(id: string | number) {`,
+    `export function enable${moduleModel.className}(id: string | number) {`,
     '  return request({',
-    `    url: '${moduleModel.enableApi.startsWith('/') ? moduleModel.enableApi : '/' + moduleModel.enableApi}',`,
+    `    url: '${enablePath}',`,
     "    method: 'post',",
     '    params: { id },',
     '  });',
     '}',
     '',
-    `export function disable${className}(id: string | number) {`,
+    `export function disable${moduleModel.className}(id: string | number) {`,
     '  return request({',
-    `    url: '${moduleModel.disableApi.startsWith('/') ? moduleModel.disableApi : '/' + moduleModel.disableApi}',`,
+    `    url: '${disablePath}',`,
     "    method: 'post',",
     '    params: { id },',
     '  });',
@@ -1938,7 +1815,7 @@ function renderMultiLevelFormField(field) {
       '      <el-col :span="12" class="mb20">',
       `        <el-form-item :label="${labelExpr}" prop="${prop}">`,
       `          <el-select v-model="form.${prop}" :placeholder="selectPlaceholder(${labelExpr})" style="width: 100%"${disabledAttr}>`,
-      `            <el-option v-for="item in getDictOptions(getFieldMeta('${prop}')?.dictType)" :key="item.value" :label="item.label" :value="Number(item.value)" />`,
+      `            <el-option v-for="item in getDictOptions(getFieldMeta('${prop}')?.dictType)" :key="item.value" :label="item.label" :value="item.value" />`,
       '          </el-select>',
       '        </el-form-item>',
       '      </el-col>',
@@ -2042,6 +1919,13 @@ ${defaultLines}
 
 const form = reactive(createDefaultFormState());
 
+const setParentFieldValue = (parentId: string | number) => {
+  const parentField = moduleConfig.queryParentField as keyof typeof form | undefined;
+  if (!parentField) return;
+  const currentValue = form[parentField];
+  (form as Record<string, string | number>)[parentField as string] = typeof currentValue === 'number' ? Number(parentId) : String(parentId);
+};
+
 const dataRules = ref({
 ${rules}
 });
@@ -2069,10 +1953,10 @@ const openDialog = async (id?: string | number, parentId?: string | number) => {
   visible.value = true;
   resetFormState();
   if (moduleConfig.queryParentField && parentId !== undefined && parentId !== null && parentId !== '') {
-    form[moduleConfig.queryParentField] = parentId;
+    setParentFieldValue(parentId);
   }
   if (id) {
-    form.${moduleModel.pk.attrName} = id;
+    form.${moduleModel.pk.attrName} = String(id);
     await getData(id);
   }
 };
@@ -2103,7 +1987,6 @@ defineExpose({
 </script>
 `;
 }
-
 function renderMultiLevelPanelVue() {
   return `<template>
   <el-container class="layout-padding-auto layout-padding-view dict-page-body">
@@ -2118,7 +2001,7 @@ function renderMultiLevelPanelVue() {
           v-for="column in columns"
           :key="column.key"
           :prop="column.key"
-          :label="resolveLabel(column.labelKey, column.label)"
+          :label="resolveLabel(column.labelKey, column.key || '')"
           :min-width="column.width || '120'"
           show-overflow-tooltip
         >
@@ -2131,8 +2014,8 @@ function renderMultiLevelPanelVue() {
           <template #default="scope">
             <el-button icon="edit-pen" text type="primary" @click="$emit('edit', scope.row)">{{ t('common.editBtn') }}</el-button>
             <el-button icon="delete" text type="primary" @click="$emit('delete', scope.row)">{{ t('common.delBtn') }}</el-button>
-            <el-button v-if="statusField && !isEnabled(scope.row[statusField])" icon="circle-check" text type="primary" @click="$emit('enable', scope.row)">闂佸憡鍑归崹鎶藉极?/el-button>
-            <el-button v-if="statusField && isEnabled(scope.row[statusField])" icon="remove" text type="primary" @click="$emit('disable', scope.row)">缂備礁鍊烽懗鍫曞极?/el-button>
+            <el-button v-if="statusField && !isEnabled(scope.row[statusField])" icon="circle-check" text type="primary" @click="$emit('enable', scope.row)">闂備礁鎲￠崙褰掑垂閹惰棄鏋?/el-button>
+            <el-button v-if="statusField && isEnabled(scope.row[statusField])" icon="remove" text type="primary" @click="$emit('disable', scope.row)">缂傚倷绀侀崐鐑芥嚄閸洖鏋?/el-button>
           </template>
         </el-table-column>
       </el-table>
@@ -2194,36 +2077,36 @@ const handleCurrentChange = (row: any) => {
 `;
 }
 
-function renderMultiLevelLevelSlot(levelVarName, activeKeyVarName, activeModuleVarName, levelLabel) {
-  return [
-    `        <div class="multi-level-slot" v-if="${levelVarName}">`,
-    '          <el-tabs class="multi-level-tabs" v-if="' + `${levelVarName}.moduleKeys.length > 1` + `" v-model="${activeKeyVarName}">`,
-    `            <el-tab-pane v-for="moduleKey in ${levelVarName}.moduleKeys" :key="moduleKey" :label="resolveModuleTitle(moduleConfigs[moduleKey])" :name="moduleKey" />`,
-    '          </el-tabs>',
-    '          <div class="multi-level-panel" v-if="' + `${activeModuleVarName}` + `">`,
-    `            <LevelPanel`,
-    `              :columns="getListFields(${activeModuleVarName}.key)"`,
-    `              :dict-types="${activeModuleVarName}.dictTypes"`,
-    `              :data-list="moduleStateMap[${activeModuleVarName}.key].dataList"`,
-    `              :loading="moduleStateMap[${activeModuleVarName}.key].loading"`,
-    `              :add-disabled="isAddDisabled(${activeModuleVarName}.key)"`,
-    `              :status-field="${activeModuleVarName}.statusField"`,
-    `              :current-page="moduleStateMap[${activeModuleVarName}.key].currentPage"`,
-    `              :page-size="moduleStateMap[${activeModuleVarName}.key].pageSize"`,
-    `              :total="moduleStateMap[${activeModuleVarName}.key].total"`,
-    `              @add="openCreate(${activeModuleVarName}.key)"`,
-    `              @edit="openEdit(${activeModuleVarName}.key, $event)"`,
-    `              @delete="handleDelete(${activeModuleVarName}.key, $event)"`,
-    `              @enable="handleEnable(${activeModuleVarName}.key, $event)"`,
-    `              @disable="handleDisable(${activeModuleVarName}.key, $event)"`,
-    `              @current-change="handleCurrentPageChange(${activeModuleVarName}.key, $event)"`,
-    `              @size-change="handlePageSizeChange(${activeModuleVarName}.key, $event)"`,
-    `              @select-row="handleSelectRow(${activeModuleVarName}.key, $event)"`,
-    '            />',
-    '          </div>',
-    `        </div>`,
-  ].join('\n');
-}
+function renderMultiLevelLevelSlot(levelVarName, activeKeyVarName, activeModuleVarName) {
+  return [
+    `        <div class="multi-level-slot" v-if="${levelVarName}">`,
+    '          <el-tabs class="multi-level-tabs" v-if="' + `${levelVarName}.moduleKeys.length > 1` + `" v-model="${activeKeyVarName}">`,
+    `            <el-tab-pane v-for="moduleKey in ${levelVarName}.moduleKeys" :key="moduleKey" :label="resolveModuleTitle(moduleConfigs[moduleKey])" :name="moduleKey" />`,
+    '          </el-tabs>',
+    '          <div class="multi-level-panel" v-if="' + `${activeModuleVarName}` + `">`,
+    `            <LevelPanel`,
+    `              :columns="getListFields(${activeModuleVarName}.key)"`,
+    `              :dict-types="${activeModuleVarName}.dictTypes"`,
+    `              :data-list="moduleStateMap[${activeModuleVarName}.key].dataList"`,
+    `              :loading="moduleStateMap[${activeModuleVarName}.key].loading"`,
+    `              :add-disabled="isAddDisabled(${activeModuleVarName}.key)"`,
+    `              :status-field="${activeModuleVarName}.statusField"`,
+    `              :current-page="moduleStateMap[${activeModuleVarName}.key].currentPage"`,
+    `              :page-size="moduleStateMap[${activeModuleVarName}.key].pageSize"`,
+    `              :total="moduleStateMap[${activeModuleVarName}.key].total"`,
+    `              @add="openCreate(${activeModuleVarName}.key)"`,
+    `              @edit="openEdit(${activeModuleVarName}.key, $event)"`,
+    `              @delete="handleDelete(${activeModuleVarName}.key, $event)"`,
+    `              @enable="handleEnable(${activeModuleVarName}.key, $event)"`,
+    `              @disable="handleDisable(${activeModuleVarName}.key, $event)"`,
+    `              @current-change="handleCurrentPageChange(${activeModuleVarName}.key, $event)"`,
+    `              @size-change="handlePageSizeChange(${activeModuleVarName}.key, $event)"`,
+    `              @select-row="handleSelectRow(${activeModuleVarName}.key, $event)"`,
+    '            />',
+    '          </div>',
+    `        </div>`,
+  ].join('\n');
+}
 
 function renderMultiLevelIndexVue(model) {
   const level2 = model.levels.find((level) => level.levelIndex === 2);
@@ -2261,17 +2144,17 @@ function renderMultiLevelIndexVue(model) {
 
   return `<template>
   <div class="layout-padding">
-    <!-- 闂傚倸鍊搁崐鎼佸磹閹间礁纾瑰瀣捣閻棗銆掑锝呬壕濡ょ姷鍋涢ˇ鐢稿垂妤ｅ啫绠涘ù锝呮贡缁嬩礁鈹戦悩鍨毄濠殿喚鏁婚幊婵嬪礈瑜忛悳缁樹繆閵堝懏鍣洪柣鎾寸洴閺屾盯濡烽敐鍛闂佽绻嗛弲婵堟閹烘鐒垫い鎺戝绾惧吋绻涢幋鐐垫噧鐎殿喖鐏濋埞鎴︽晬閸曨偂鍝楀銈嗘肠閸曨収娲告俊銈忕到閸燁垶宕愰悽鍛婂仭婵炲棗绻愰顏嗙棯閻愵剚鍊愰柡灞剧⊕閹棃濡搁妶鍡楁灓婵＄偑鍊戦崹楦挎懌缂備浇娅ｉ弲顐ゅ垝濞嗘垶宕夐柕濞垮劗閸嬫捇鎮欓悜妯锋嫼缂備緡鍨卞ú鏍ㄦ櫠閺屻儲鐓熼柣鏃€娼欓崝婊呯磼閸屾稑娴柡灞芥椤撳ジ宕卞▎蹇撶?{model.featureTitle.replace(/--/g, '')} -->
+    <!-- 闂備礁鎲″濠氬窗閺囥垹绀傛慨妞诲亾鐎规洏鍎遍濂稿炊閸℃瑥浠遍柡?{model.featureTitle.replace(/--/g, '')} -->
     <div class="multi-level-dict-layout">
       <div class="multi-level-left">
-${renderMultiLevelLevelSlot('level1Config', 'activeLevel1Key', 'activeLevel1Module', 'left')}
+${renderMultiLevelLevelSlot('level1Config', 'activeLevel1Key', 'activeLevel1Module')}
       </div>
       <div class="multi-level-right">
         <div class="multi-level-right-top">
-${level2 ? renderMultiLevelLevelSlot('level2Config', 'activeLevel2Key', 'activeLevel2Module', 'right-top') : ''}
+${level2 ? renderMultiLevelLevelSlot('level2Config', 'activeLevel2Key', 'activeLevel2Module') : ''}
         </div>
         <div v-if="level3Config" class="multi-level-right-bottom">
-${level3 ? renderMultiLevelLevelSlot('level3Config', 'activeLevel3Key', 'activeLevel3Module', 'right-bottom') : ''}
+${level3 ? renderMultiLevelLevelSlot('level3Config', 'activeLevel3Key', 'activeLevel3Module') : ''}
         </div>
       </div>
     </div>
@@ -2282,8 +2165,10 @@ ${formComponents}
 
 <script setup lang="ts" name="system${model.className}">
 import { useMessage, useMessageBox } from '/@/hooks/message';
+import { useMultiLevelDictMeta } from '/@/hooks/useMultiLevelDictMeta';
+import { useMultiLevelDictPage } from '/@/hooks/useMultiLevelDictPage';
 import { useI18n } from 'vue-i18n';
-import LevelPanel from '/@/components/DictLevelPanel/index.vue';
+import LevelPanel from '/@/components/DictLevelPanel/index.vue';
 import { levelConfigs, moduleConfigs } from './options';
 import { ${apiImports} } from '/@/api/${model.moduleName}/${model.functionName}';
 
@@ -2295,33 +2180,18 @@ ${apiHandlerMap}
 
 const { t } = useI18n();
 
-const moduleStateMap = reactive(
-  Object.fromEntries(
-    Object.keys(moduleConfigs).map((key) => [
-      key,
-      {
-        dataList: [],
-        loading: false,
-        currentPage: 1,
-        pageSize: 10,
-        total: 0,
-        currentRow: null,
-      },
-    ])
-  ) as Record<string, any>
-);
-
-const level1Config = levelConfigs.find((item) => item.levelIndex === 1) || null;
-const level2Config = levelConfigs.find((item) => item.levelIndex === 2) || null;
-const level3Config = levelConfigs.find((item) => item.levelIndex === 3) || null;
-
-const activeLevel1Key = ref(level1Config?.moduleKeys?.[0] || '');
-const activeLevel2Key = ref(level2Config?.moduleKeys?.[0] || '');
-const activeLevel3Key = ref(level3Config?.moduleKeys?.[0] || '');
-
-const activeLevel1Module = computed(() => (activeLevel1Key.value ? moduleConfigs[activeLevel1Key.value] : null));
-const activeLevel2Module = computed(() => (activeLevel2Key.value ? moduleConfigs[activeLevel2Key.value] : null));
-const activeLevel3Module = computed(() => (activeLevel3Key.value ? moduleConfigs[activeLevel3Key.value] : null));
+const {
+  level1Config,
+  level2Config,
+  level3Config,
+  activeLevel1Key,
+  activeLevel2Key,
+  activeLevel3Key,
+  activeLevel1Module,
+  activeLevel2Module,
+  activeLevel3Module,
+  getModuleLevel,
+} = useMultiLevelDictMeta(levelConfigs, moduleConfigs);
 
 const resolveLabel = (labelKey?: string, fallback = '') => {
   if (!labelKey) return fallback;
@@ -2329,101 +2199,38 @@ const resolveLabel = (labelKey?: string, fallback = '') => {
   return translated === labelKey ? fallback : translated;
 };
 
-const resolveModuleTitle = (moduleConfig: any) => resolveLabel(moduleConfig?.titleKey, moduleConfig?.title || moduleConfig?.key || '');
-
-const getModuleLevel = (moduleKey: string) => levelConfigs.find((level) => level.moduleKeys.includes(moduleKey))?.levelIndex || 1;
-
-const getParentIdForModule = (moduleKey: string) => {
-  const levelIndex = getModuleLevel(moduleKey);
-  if (levelIndex === 2 && activeLevel1Module.value) {
-    const parentRow = moduleStateMap[activeLevel1Module.value.key]?.currentRow;
-    return parentRow?.[activeLevel1Module.value.primaryKey] ?? '';
-  }
-  if (levelIndex === 3 && activeLevel2Module.value) {
-    const parentRow = moduleStateMap[activeLevel2Module.value.key]?.currentRow;
-    return parentRow?.[activeLevel2Module.value.primaryKey] ?? '';
-  }
-  return '';
-};
-
-const getListFields = (moduleKey: string) => (moduleConfigs[moduleKey]?.fields || []).filter((field: any) => field.listShow !== false);
-
-const isAddDisabled = (moduleKey: string) => {
-  const moduleConfig = moduleConfigs[moduleKey];
-  return Boolean(moduleConfig?.queryParentField) && !getParentIdForModule(moduleKey);
-};
-
-const resetDescendantStates = (levelIndex: number) => {
-  levelConfigs
-    .filter((level) => level.levelIndex > levelIndex)
-    .forEach((level) => {
-      level.moduleKeys.forEach((moduleKey) => {
-        Object.assign(moduleStateMap[moduleKey], {
-          dataList: [],
-          total: 0,
-          currentPage: 1,
-          currentRow: null,
-        });
-      });
-    });
-};
-
-const loadModuleData = async (moduleKey: string, resetPage = false) => {
-  const moduleConfig = moduleConfigs[moduleKey];
-  const state = moduleStateMap[moduleKey];
-  if (!moduleConfig || !state) return;
-
-  const parentId = getParentIdForModule(moduleKey);
-  if (moduleConfig.queryParentField && !parentId) {
-    Object.assign(state, { dataList: [], total: 0, currentRow: null });
-    return;
-  }
-
-  if (resetPage) state.currentPage = 1;
-  state.loading = true;
-  try {
-    const query = {
-      current: state.currentPage,
-      size: state.pageSize,
-      ...(moduleConfig.queryParentField && parentId !== '' ? { [moduleConfig.queryParentField]: parentId } : {}),
-    };
-    const { data } = await apiHandlerMap[moduleKey].page(query);
-    const pageData = Array.isArray(data) ? { records: data, total: data.length, current: 1, size: data.length } : data || {};
-    state.dataList = pageData.records || pageData.list || [];
-    state.total = pageData.total || state.dataList.length;
-  } finally {
-    state.loading = false;
-  }
-};
-
-const handleSelectRow = (moduleKey: string, row: any) => {
-  moduleStateMap[moduleKey].currentRow = row;
-  const levelIndex = getModuleLevel(moduleKey);
-  resetDescendantStates(levelIndex);
-  if (levelIndex === 1 && activeLevel2Module.value) loadModuleData(activeLevel2Module.value.key, true);
-  if (levelIndex === 2 && activeLevel3Module.value) loadModuleData(activeLevel3Module.value.key, true);
-};
-
-const handleCurrentPageChange = (moduleKey: string, page: number) => {
-  moduleStateMap[moduleKey].currentPage = page;
-  loadModuleData(moduleKey);
-};
-
-const handlePageSizeChange = (moduleKey: string, pageSize: number) => {
-  moduleStateMap[moduleKey].pageSize = pageSize;
-  moduleStateMap[moduleKey].currentPage = 1;
-  loadModuleData(moduleKey);
-};
+const resolveModuleTitle = (moduleConfig: any) => resolveLabel(moduleConfig?.titleKey, moduleConfig?.key || '');
+
+const {
+  moduleStateMap,
+  getParentIdForModule,
+  getListFields,
+  isAddDisabled,
+  loadModuleData,
+  handleSelectRow,
+  handleCurrentPageChange,
+  handlePageSizeChange,
+  handleFormRefresh,
+} = useMultiLevelDictPage(
+  levelConfigs,
+  moduleConfigs,
+  activeLevel1Key,
+  activeLevel2Key,
+  activeLevel3Key,
+  activeLevel1Module,
+  activeLevel2Module,
+  activeLevel3Module,
+  getModuleLevel,
+  apiHandlerMap
+);
 
 const openCreate = (moduleKey: string) => {
-  const formRef = formRefMap[moduleKey];
-  formRef?.value?.openDialog(undefined, getParentIdForModule(moduleKey));
+  formRefMap[moduleKey]?.value?.openDialog(undefined, getParentIdForModule(moduleKey));
 };
 
 const openEdit = (moduleKey: string, row: any) => {
-  const formRef = formRefMap[moduleKey];
   const primaryKey = moduleConfigs[moduleKey].primaryKey;
-  formRef?.value?.openDialog(row?.[primaryKey], getParentIdForModule(moduleKey));
+  formRefMap[moduleKey]?.value?.openDialog(row?.[primaryKey], getParentIdForModule(moduleKey));
 };
 
 const handleDelete = async (moduleKey: string, row: any) => {
@@ -2448,9 +2255,9 @@ const handleEnable = async (moduleKey: string, row: any) => {
     const primaryKey = moduleConfigs[moduleKey].primaryKey;
     await apiHandlerMap[moduleKey].enable(row?.[primaryKey]);
     await loadModuleData(moduleKey);
-    useMessage().success('闂傚倸鍊搁崐鎼佸磹妞嬪海鐭嗗〒姘ｅ亾妤犵偛顦甸弫鎾绘偐閼碱剦妲遍柣鐔哥矌婢ф鏁幒妤€鍨傞柛宀€鍋為悡娆撴煙椤栨粌顣兼い銉ヮ樀閺岋紕鈧絺鏅濈粣鏃堟煛鐏炵偓绀嬬€规洜鍘ч埞鎴﹀箛椤撳濡囩槐鎾存媴閸濆嫷鈧挾绱撳鍕獢鐎殿喖顭烽幃銏ゅ礂閼测晛濮洪梻浣瑰濞插秹宕戦幘鎰佺唵鐟滄粓宕板Δ鍛?);
+    useMessage().success(t('common.messages.enableSuccess')); 
   } catch (err: any) {
-    useMessage().error(err.msg || '闂傚倸鍊搁崐鎼佸磹妞嬪海鐭嗗〒姘ｅ亾妤犵偛顦甸弫鎾绘偐閼碱剦妲遍柣鐔哥矌婢ф鏁幒妤€鍨傞柛宀€鍋為悡娆撴煙椤栨粌顣兼い銉ヮ樀閺岋紕鈧絺鏅濈粣鏃堟煛鐏炵偓绀嬬€规洜鍘ч埞鎴﹀炊閼告妫х紓鍌氬€风粈浣规櫠鎼淬劌纾婚柕鍫濇媼閸ゆ洟鏌涢锝嗙闂佸崬娲﹂妵鍕箛閸偆绐旈梺鍛婂灣缁瑩骞?);
+    useMessage().error(err.msg || t('common.messages.enableError')); 
   }
 };
 
@@ -2459,54 +2266,15 @@ const handleDisable = async (moduleKey: string, row: any) => {
     const primaryKey = moduleConfigs[moduleKey].primaryKey;
     await apiHandlerMap[moduleKey].disable(row?.[primaryKey]);
     await loadModuleData(moduleKey);
-    useMessage().success('缂傚倸鍊搁崐鎼佸磹閹间礁纾瑰瀣捣閻棗銆掑锝呬壕閻庤娲橀崝娆撳箖濠婂牊鍤嶉柕澶堝劜閻ｉ亶姊绘担绋款棌闁稿鎳庣叅闁哄稁鍘奸崙鐘层€掑锝呬壕闂佸搫鏈ú鐔风暦閻撳簶鏀介柟閭﹀帨閿斿墽纾藉ù锝呮惈椤庢挾绱撳鍕獢鐎殿喖顭烽幃銏ゅ礂閼测晛濮洪梻浣瑰濞插秹宕戦幘鎰佺唵鐟滄粓宕板Δ鍛?);
+    useMessage().success(t('common.messages.disableSuccess')); 
   } catch (err: any) {
-    useMessage().error(err.msg || '缂傚倸鍊搁崐鎼佸磹閹间礁纾瑰瀣捣閻棗銆掑锝呬壕閻庤娲橀崝娆撳箖濠婂牊鍤嶉柕澶堝劜閻ｉ亶姊绘担绋款棌闁稿鎳庣叅闁哄稁鍘奸崙鐘层€掑锝呬壕闂佸搫鏈ú鐔风暦閻撳簶鏀介柛銉ㄥ煐椤ワ絿绱撻崒娆戭槮濠⒀冮叄瀹曟垿濡堕崪浣告闂佸壊鍋呭ú鏍煁閸ャ劊浜滈柟鏉跨仛缁舵岸鏌涢幋婊呯煓闁?);
+    useMessage().error(err.msg || t('common.messages.disableError')); 
   }
 };
-
-const handleFormRefresh = (moduleKey: string) => {
-  loadModuleData(moduleKey);
-};
-
-watch(activeLevel1Key, async (moduleKey) => {
-  if (!moduleKey) return;
-  const level1Module = moduleConfigs[moduleKey];
-  if (!level1Module) return;
-  Object.assign(moduleStateMap[level1Module.key], {
-    currentRow: null,
-    currentPage: 1,
-  });
-  resetDescendantStates(1);
-  await loadModuleData(level1Module.key, true);
-});
-
-watch(activeLevel2Key, (moduleKey) => {
-  if (moduleKey) {
-    if (level3Config) {
-      level3Config.moduleKeys.forEach((key) => {
-        moduleStateMap[key].currentRow = null;
-        moduleStateMap[key].dataList = [];
-        moduleStateMap[key].total = 0;
-      });
-    }
-    loadModuleData(moduleKey, true);
-  }
-});
-
-watch(activeLevel3Key, (moduleKey) => {
-  if (moduleKey) loadModuleData(moduleKey, true);
-});
-
-onMounted(async () => {
-  if (activeLevel1Module.value) {
-    await loadModuleData(activeLevel1Module.value.key, true);
-  }
-});
 </script>
 
-  `;
-}
+`;
+}
 
 function renderMultiLevelMenuSql(model) {
   const menuBaseId = Date.now();
@@ -2521,9 +2289,9 @@ function renderMultiLevelFiles(model, sharedSupport, localeZhSupport) {
   const viewRoot = path.join(model.frontendPath, 'src', 'views', ...model.moduleName.split('/'), model.functionName);
   const apiRoot = path.join(model.frontendPath, 'src', 'api', ...model.moduleName.split('/'));
   const menuRoot = path.join(model.frontendPath, 'menu');
-  const files = [
-    { type: 'list', path: path.join(viewRoot, 'index.vue'), content: renderMultiLevelIndexVue(model) },
-    { type: 'options', path: path.join(viewRoot, 'options.ts'), content: renderMultiLevelOptionsTs(model, dictRegistryRefs) },
+  const files = [
+    { type: 'list', path: path.join(viewRoot, 'index.vue'), content: renderMultiLevelIndexVue(model) },
+    { type: 'options', path: path.join(viewRoot, 'options.ts'), content: renderMultiLevelOptionsTs(model, dictRegistryRefs) },
     { type: 'api', path: path.join(apiRoot, `${model.functionName}.ts`), content: renderMultiLevelApiTs(model) },
     {
       type: 'i18nZh',
@@ -2896,3 +2664,5 @@ start();
 
 
 
+
+

package/package.json

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