worsoft-frontend-codegen-local-mcp 0.1.62 → 0.1.65

package/assets/templates/master_child_jump/form.tpl

@@ -1,9 +1,13 @@
 <template>
+  <!-- 页面布局：{{FEATURE_TITLE}}主子表表单页 -->
   <div class="layout-padding-auto layout-padding-view">
+    <!-- 表单卡片：承载标题、操作按钮、主表字段和子表明细 -->
     <el-card shadow="never" class="w100">
       <template #header>
+        <!-- 表单页头：根据新增、编辑、详情模式展示标题和按钮 -->
         <div style="display: flex; justify-content: space-between; align-items: center;">
           <span style="font-size: 16px; font-weight: bold;">{{ form.{{PK_ATTR}} ? (detail ? t('common.viewBtn') : t('common.editBtn')) : t('common.addBtn') }}</span>
+          <!-- 编辑模式操作按钮：保存、流转、提交、取消 -->
           <div v-if="!detail">
             <el-button @click="onSubmit('save')" :disabled="loading" icon="document">{{ commonActionLabel('save') }}</el-button>
             <el-button @click="onSubmit('flow')" :disabled="loading" plain type="success" icon="position">{{ commonActionLabel('flow') }}</el-button>
@@ -11,15 +15,19 @@
             <el-divider direction="vertical" />
             <el-button @click="handleBack" icon="close">{{ t('common.cancelButtonText') }}</el-button>
           </div>
+          <!-- 详情模式操作按钮：返回列表页 -->
           <div v-else>
             <el-button @click="handleBack" icon="back">{{ commonActionLabel('back') }}</el-button>
           </div>
         </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">
 {{CHILD_SECTIONS}}
         </el-row>

package/assets/templates/master_child_jump/index.tpl

@@ -1,7 +1,9 @@
 <!-- 功能名称：{{FEATURE_TITLE}} -->
 <template>
+  <!-- 页面布局：{{FEATURE_TITLE}}列表页 -->
   <div class="layout-padding">
     <div class="layout-padding-auto layout-padding-view flex h-full flex-col">
+      <!-- 列表工具栏：搜索、新增、导入、批量删除、导出、刷新 -->
       <SchemaListToolbar
         v-bind="toolbarProps"
         @update:keyword="state.queryForm.smartVal = $event"
@@ -15,6 +17,7 @@
         @refresh="handleToolbarRefresh"
       />
 
+      <!-- 列表表格：展示{{FEATURE_TITLE}}列表数据、分页、排序和行操作 -->
       <SchemaListTable
         v-bind="tableProps"
         row-id-key="{{PK_ATTR}}"
@@ -23,16 +26,23 @@
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
       >
+        <!-- 行操作按钮：查看、编辑、提交、流转、删除 -->
         <template #actions="{ row }">
+          <!-- 查看{{FEATURE_TITLE}}详情 -->
           <el-button text type="primary" icon="view" v-auth="'{{PERMISSION_PREFIX}}_view'" @click="handleDetail(row.{{PK_ATTR}})">{{ t('common.viewBtn') }}</el-button>
+          <!-- 编辑{{FEATURE_TITLE}}：业务单据编辑态控制按需生效 -->
           <el-button{{BUSINESS_EDIT_IF}} icon="edit-pen" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_edit'" @click="handleEdit(row.{{PK_ATTR}})">{{ t('common.editBtn') }}</el-button>
+          <!-- 提交{{FEATURE_TITLE}} -->
           <el-button text type="primary" icon="check" @click="handleQuickAction(row, 'submit')">{{ commonActionLabel('submit') }}</el-button>
+          <!-- 流转{{FEATURE_TITLE}} -->
           <el-button text type="success" icon="position" @click="handleQuickAction(row, 'flow')">{{ commonActionLabel('flow') }}</el-button>
+          <!-- 删除{{FEATURE_TITLE}} -->
           <el-button icon="delete" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_del'" @click="handleDelete([row.{{PK_ATTR}}])">{{ t('common.delBtn') }}</el-button>
         </template>
       </SchemaListTable>
     </div>
 
+    <!-- Excel 导入组件：导入{{FEATURE_TITLE}}列表数据 -->
     <upload-excel ref="excelUploadRef" :title="t('common.importBtn')" url="/{{API_PATH}}/import" temp-url="/admin/sys-file/local/file/{{FUNCTION_NAME}}.xlsx" @refreshDataList="getDataList" />
   </div>
 </template>

package/assets/templates/single_table_dialog/form.tpl

@@ -1,10 +1,14 @@
 <template>
+  <!-- 表单弹窗：新增或编辑{{FEATURE_TITLE}}数据 -->
   <el-dialog v-model="visible" :title="form.{{PK_ATTR}} ? t('common.editBtn') : t('common.addBtn')" :close-on-click-modal="false" draggable>
+    <!-- 弹窗表单：按 PRD 表单显隐和顺序渲染字段 -->
     <el-form ref="dataFormRef" :model="form" :rules="dataRules" label-width="100px" v-loading="loading">
+      <!-- 主表字段区：字段级注释由 MCP 根据字段名称生成 -->
       <el-row :gutter="24">
 {{FORM_FIELDS}}
       </el-row>
     </el-form>
+    <!-- 弹窗底部操作按钮：取消和确认提交 -->
     <template #footer>
       <span class="dialog-footer">
         <el-button @click="visible = false">{{ t('common.cancelButtonText') }}</el-button>

package/assets/templates/single_table_dialog/index.tpl

@@ -1,7 +1,9 @@
 <!-- 功能名称：{{FEATURE_TITLE}} -->
 <template>
+  <!-- 页面布局：{{FEATURE_TITLE}}列表页 -->
   <div class="layout-padding">
     <div class="layout-padding-auto layout-padding-view flex h-full flex-col">
+      <!-- 列表工具栏：搜索、新增、导入、批量删除、导出、刷新 -->
       <SchemaListToolbar
         v-bind="toolbarProps"
         @update:keyword="state.queryForm.smartVal = $event"
@@ -15,6 +17,7 @@
         @refresh="handleToolbarRefresh"
       />
 
+      <!-- 列表表格：展示{{FEATURE_TITLE}}列表数据、分页、排序和行操作 -->
       <SchemaListTable
         v-bind="tableProps"
         row-id-key="{{PK_ATTR}}"
@@ -24,13 +27,16 @@
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
       >
+        <!-- 行操作按钮：编辑、删除、启用、禁用 -->
         <template #actions="{ row }">
 {{LIST_ACTIONS}}
         </template>
       </SchemaListTable>
     </div>
 
+    <!-- 表单弹窗组件：新增和编辑{{FEATURE_TITLE}}数据 -->
     <form-dialog ref="formDialogRef" @refresh="getDataList(false)" />
+    <!-- Excel 导入组件：导入{{FEATURE_TITLE}}列表数据 -->
     <upload-excel ref="excelUploadRef" :title="t('common.importBtn')" url="/{{API_PATH}}/import" temp-url="/admin/sys-file/local/file/{{FUNCTION_NAME}}.xlsx" @refreshDataList="getDataList" />
   </div>
 </template>

package/assets/templates/single_table_jump/form.tpl

@@ -1,9 +1,13 @@
 <template>
+  <!-- 页面布局：{{FEATURE_TITLE}}表单页 -->
   <div class="layout-padding-auto layout-padding-view">
+    <!-- 表单卡片：承载标题、操作按钮和主表字段 -->
     <el-card shadow="never" class="w100">
       <template #header>
+        <!-- 表单页头：根据新增、编辑、详情模式展示标题和按钮 -->
         <div style="display: flex; justify-content: space-between; align-items: center;">
           <span style="font-size: 16px; font-weight: bold;">{{ form.{{PK_ATTR}} ? (detail ? t('common.viewBtn') : t('common.editBtn')) : t('common.addBtn') }}</span>
+          <!-- 编辑模式操作按钮：保存、流转、提交、取消 -->
           <div v-if="!detail">
             <el-button @click="onSubmit('save')" :disabled="loading" icon="document">{{ commonActionLabel('save') }}</el-button>
             <el-button @click="onSubmit('flow')" :disabled="loading" plain type="success" icon="position">{{ commonActionLabel('flow') }}</el-button>
@@ -11,12 +15,15 @@
             <el-divider direction="vertical" />
             <el-button @click="handleBack" icon="close">{{ t('common.cancelButtonText') }}</el-button>
           </div>
+          <!-- 详情模式操作按钮：返回列表页 -->
           <div v-else>
             <el-button @click="handleBack" icon="back">{{ commonActionLabel('back') }}</el-button>
           </div>
         </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>

package/assets/templates/single_table_jump/index.tpl

@@ -1,7 +1,9 @@
 <!-- 功能名称：{{FEATURE_TITLE}} -->
 <template>
+  <!-- 页面布局：{{FEATURE_TITLE}}列表页 -->
   <div class="layout-padding">
     <div class="layout-padding-auto layout-padding-view flex h-full flex-col">
+      <!-- 列表工具栏：搜索、新增、导入、批量删除、导出、刷新 -->
       <SchemaListToolbar
         v-bind="toolbarProps"
         @update:keyword="state.queryForm.smartVal = $event"
@@ -15,6 +17,7 @@
         @refresh="handleToolbarRefresh"
       />
 
+      <!-- 列表表格：展示{{FEATURE_TITLE}}列表数据、分页、排序和行操作 -->
       <SchemaListTable
         v-bind="tableProps"
         row-id-key="{{PK_ATTR}}"
@@ -24,14 +27,19 @@
         @size-change="handleTableSizeChange"
         @current-change="handleTableCurrentChange"
       >
+        <!-- 行操作按钮：查看、编辑、删除 -->
         <template #actions="{ row }">
+          <!-- 查看{{FEATURE_TITLE}}详情 -->
           <el-button text type="primary" icon="view" v-auth="'{{PERMISSION_PREFIX}}_view'" @click="handleDetail(row.{{PK_ATTR}})">{{ t('common.viewBtn') }}</el-button>
+          <!-- 编辑{{FEATURE_TITLE}}：业务单据编辑态控制按需生效 -->
           <el-button{{BUSINESS_EDIT_IF}} icon="edit-pen" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_edit'" @click="handleEdit(row.{{PK_ATTR}})">{{ t('common.editBtn') }}</el-button>
+          <!-- 删除{{FEATURE_TITLE}} -->
           <el-button icon="delete" text type="primary" v-auth="'{{PERMISSION_PREFIX}}_del'" @click="handleDelete([row.{{PK_ATTR}}])">{{ t('common.delBtn') }}</el-button>
         </template>
       </SchemaListTable>
     </div>
 
+    <!-- Excel 导入组件：导入{{FEATURE_TITLE}}列表数据 -->
     <upload-excel ref="excelUploadRef" :title="t('common.importBtn')" url="/{{API_PATH}}/import" temp-url="/admin/sys-file/local/file/{{FUNCTION_NAME}}.xlsx" @refreshDataList="getDataList" />
   </div>
 </template>

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.62';
+const SERVER_VERSION = '0.1.65';
 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');
@@ -983,7 +983,7 @@ function normalizeStructuredFormType(value) {
   if (!normalized) return '';
   if (normalized === 'date') return 'date';
   if (normalized === 'datetime') return 'datetime';
-  if (normalized === 'microme-operator') return 'number';
+  if (normalized === 'microme-operator') return 'microme-operator';
   if (normalized === 'upload') {
     return 'upload';
   }
@@ -1441,16 +1441,22 @@ function rejectSemanticStageInputs(input) {
   }
 }
 
-function validatePageTypeAndStyle(pageType, style) {
-  if (!pageType) return;
-  if (pageType === 'non_standard') {
-    throw new Error('non_standard pages are not supported by worsoft_codegen_local_generate_frontend');
-  }
-  if (pageType !== 'dict') return;
-  if (style === 'single_table_jump' || style === 'master_child_jump') {
-    throw new Error(`Dict pages must use dialog-based styles. pageType=dict does not support style=${style}`);
-  }
-}
+function validatePageTypeAndStyle(pageType, style) {
+  if (!pageType) return;
+  if (pageType === 'non_standard') {
+    throw new Error('non_standard pages are not supported by worsoft_codegen_local_generate_frontend');
+  }
+  if (pageType === 'business') {
+    if (style === 'single_table_dialog') {
+      throw new Error('Business pages must use jump-based styles. pageType=business does not support style=single_table_dialog; use single_table_jump for single-table business pages or master_child_jump for master-child business pages.');
+    }
+    return;
+  }
+  if (pageType !== 'dict') return;
+  if (style === 'single_table_jump' || style === 'master_child_jump') {
+    throw new Error(`Dict pages must use dialog-based styles. pageType=dict does not support style=${style}`);
+  }
+}
 
 function hasRuntimeSupport(stylePreset) {
   return Boolean(stylePreset.runtime && stylePreset.runtime.supported && stylePreset.runtime.templateDir);
@@ -1786,19 +1792,29 @@ function renderFormField(field) {
     ].join('\n');
   }
 
-  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"` : '';
-    return [
-      '          <el-col :span="12" class="mb20">',
+  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"` : '';
+    return [
+      '          <el-col :span="12" class="mb20">',
       `            <el-form-item label="${label}" prop="${prop}">`,
       `              <el-input-number v-model="form.${prop}" :min="0"${max}${precision} :placeholder="${inputPlaceholderExpr}" style="width: 100%" />`,
       '            </el-form-item>',
       '          </el-col>',
-    ].join('\n');
-  }
-
-  if (field.formType === 'datetime' || field.formType === 'date') {
+    ].join('\n');
+  }
+
+  if (field.formType === 'microme-operator') {
+    return [
+      '          <el-col :span="12" class="mb20">',
+      `            <el-form-item label="${label}" prop="${prop}">`,
+      `              <MicromeOperator v-model="form.${prop}"${renderMicromeFormatAttr(field)} :placeholder="${inputPlaceholderExpr}" />`,
+      '            </el-form-item>',
+      '          </el-col>',
+    ].join('\n');
+  }
+
+  if (field.formType === 'datetime' || field.formType === 'date') {
     const pickerType = field.formType === 'datetime' ? 'datetime' : 'date';
     const formatName = field.formType === 'datetime' ? 'dateTimeStr' : 'dateStr';
     return [
@@ -1863,6 +1879,8 @@ function renderChildTableColumn(field, childListName) {
     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} :placeholder="${inputPlaceholderExpr}" style="width: 100%"${disabledAttr} />`;
+  } else if (field.formType === 'microme-operator') {
+    control = `                  <MicromeOperator v-model="row.${field.attrName}"${renderMicromeFormatAttr(field)} :placeholder="${inputPlaceholderExpr}"${disabledAttr} />`;
   }
 
   return [
@@ -1892,7 +1910,7 @@ function renderDefaultLine(field) {
   if (field.attrName === 'billDate') return `  ${field.attrName}: moment(new Date()).format('YYYY-MM-DD'),`;
   if (field.attrName === 'billStateId' || field.fieldName === 'bill_state_id') return `  ${field.attrName}: '0',`;
   if (field.attrName === 'createTime') return `  ${field.attrName}: moment(new Date()).format('YYYY-MM-DD HH:mm:ss'),`;
-  if (field.formType === 'number') return `  ${field.attrName}: 0,`;
+  if (field.formType === 'number' || field.formType === 'microme-operator') return `  ${field.attrName}: 0,`;
   return `  ${field.attrName}: '',`;
 }
 
@@ -1938,10 +1956,12 @@ function renderChildSection(childModel, childCount) {
 
   return [
     '          <el-col :span="24" class="mb20">',
+    `            <!-- 子表区域：${sanitizeHtmlComment(childModel.comment || childModel.tableName)} -->`,
     `            <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) => renderChildTableColumn(field, childModel.listName)).join('\n'),
-    '            </sc-form-table>',
+    '            </sc-form-table>',
     '          </el-col>',
   ].join('\n');
 }
@@ -2088,6 +2108,14 @@ function renderDisabledBoolV2(field) {
   return field.readonly ? 'true' : 'false';
 }
 
+function renderMicromeFormatAttr(field) {
+  const length = Number.parseInt(String(field.length || ''), 10);
+  const scale = Number.parseInt(String(field.scale || ''), 10);
+  if (!length || Number.isNaN(length) || Number.isNaN(scale) || scale < 0) return '';
+  const integerLength = Math.max(length - scale, 1);
+  return ` format="${integerLength}-${scale}"`;
+}
+
 function isAttachmentLikeField(field) {
   const fieldName = String(field?.fieldName || field?.attrName || '').toLowerCase();
   const comment = String(field?.comment || field?.description || '').toLowerCase();
@@ -2130,20 +2158,42 @@ function renderFormFieldV2(field) {
     ].join('\n');
   }
 
-  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"` : '';
-    return [
-      renderFieldCommentV2(field),
+  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"` : '';
+    return [
+      renderFieldCommentV2(field),
       `          <el-col :span="12" class="mb20">`,
       `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
       `              <el-input-number v-model="form.${prop}" :min="0"${max}${precision} :placeholder="formInputPlaceholder(${labelExpr}, ${disabledBool})" style="width: 100%"${disabledAttr} />`,
       '            </el-form-item>',
       '          </el-col>',
-    ].join('\n');
-  }
-
-  if (field.formType === 'datetime' || field.formType === 'date') {
+    ].join('\n');
+  }
+
+  if (field.formType === 'microme-operator') {
+    return [
+      renderFieldCommentV2(field),
+      `          <el-col :span="12" class="mb20">`,
+      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
+      `              <MicromeOperator v-model="form.${prop}"${renderMicromeFormatAttr(field)} :placeholder="formInputPlaceholder(${labelExpr}, ${disabledBool})"${disabledAttr} />`,
+      '            </el-form-item>',
+      '          </el-col>',
+    ].join('\n');
+  }
+
+  if (field.formType === 'microme-operator') {
+    return [
+      renderFieldCommentV2(field),
+      '      <el-col :span="12" class="mb20">',
+      `        <el-form-item :label="${labelExpr}" prop="${prop}">`,
+      `          <MicromeOperator v-model="form.${prop}"${renderMicromeFormatAttr(field)} :placeholder="formInputPlaceholder(${labelExpr}, ${disabledBool})"${disabledAttr} />`,
+      '        </el-form-item>',
+      '      </el-col>',
+    ].join('\n');
+  }
+
+  if (field.formType === 'datetime' || field.formType === 'date') {
     const pickerType = field.formType === 'datetime' ? 'datetime' : 'date';
     const formatName = field.formType === 'datetime' ? 'dateTimeStr' : 'dateStr';
     return [
@@ -2456,14 +2506,18 @@ function renderMultiLevelFormVue(model, moduleModel) {
   ].join('\n');
   const rules = renderFormRulesV2(moduleModel.visibleFields);
   return `<template>
-  <el-dialog v-model="visible" :title="form.${moduleModel.pk.attrName} ? t('common.editBtn') : t('common.addBtn')" :close-on-click-modal="false" draggable>
-    <el-form ref="dataFormRef" :model="form" :rules="dataRules" label-width="100px" v-loading="loading">
-      <el-row :gutter="24">
-${moduleModel.visibleFields.map(renderMultiLevelFormField).join('\n')}
-      </el-row>
-    </el-form>
-    <template #footer>
-      <span class="dialog-footer">
+  <!-- 表单弹窗：新增或编辑${sanitizeHtmlComment(moduleModel.comment || moduleModel.tableName)}数据 -->
+  <el-dialog v-model="visible" :title="form.${moduleModel.pk.attrName} ? t('common.editBtn') : t('common.addBtn')" :close-on-click-modal="false" draggable>
+    <!-- 弹窗表单：按 PRD 表单显隐和顺序渲染字段 -->
+    <el-form ref="dataFormRef" :model="form" :rules="dataRules" label-width="100px" v-loading="loading">
+      <!-- 字典字段区：字段级注释由 MCP 根据字段名称生成 -->
+      <el-row :gutter="24">
+${moduleModel.visibleFields.map(renderMultiLevelFormField).join('\n')}
+      </el-row>
+    </el-form>
+    <!-- 弹窗底部操作按钮：取消和确认提交 -->
+    <template #footer>
+      <span class="dialog-footer">
         <el-button @click="visible = false">{{ t('common.cancelButtonText') }}</el-button>
         <el-button type="primary" @click="onSubmit" :disabled="loading">{{ t('common.confirmButtonText') }}</el-button>
       </span>
@@ -2594,11 +2648,14 @@ ${moduleModel.visibleFields.map(renderMultiLevelFormField).join('\n')}
 function renderMultiLevelSchemaListSlot(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}` + `">`,
     '            <div class="layout-padding-auto layout-padding-view flex h-full flex-col">',
+    '              <!-- 当前层级工具栏：搜索、新增和重置 -->',
     `              <SchemaListToolbar`,
     `                v-bind="getPanelToolbarProps(${activeModuleVarName}.key)"`,
     `                @update:keyword="handlePanelKeywordChange(${activeModuleVarName}.key, $event)"`,
@@ -2606,16 +2663,22 @@ function renderMultiLevelSchemaListSlot(levelVarName, activeKeyVarName, activeMo
     `                @query="handlePanelQuery(${activeModuleVarName}.key)"`,
     `                @reset="handlePanelReset(${activeModuleVarName}.key)"`,
     `              />`,
+    '              <!-- 当前层级表格：展示字典数据、分页和行操作 -->',
     `              <SchemaListTable`,
     `                v-bind="getPanelTableProps(${activeModuleVarName}.key)"`,
     `                @row-current-change="handlePanelCurrentChange(${activeModuleVarName}.key, $event.row)"`,
     `                @current-change="handleCurrentPageChange(${activeModuleVarName}.key, $event.current)"`,
     `                @size-change="handlePageSizeChange(${activeModuleVarName}.key, $event.size)"`,
     `              >`,
+    '                <!-- 行操作按钮：编辑、删除、启用、禁用 -->',
     `                <template #actions="{ row }">`,
+    '                  <!-- 编辑当前字典数据 -->',
     `                  <el-button v-if="showModuleAction(${activeModuleVarName}.key, 'edit', row)" icon="edit-pen" text type="primary" @click="openEdit(${activeModuleVarName}.key, row)">{{ t('common.editBtn') }}</el-button>`,
+    '                  <!-- 删除当前字典数据 -->',
     `                  <el-button v-if="showModuleAction(${activeModuleVarName}.key, 'delete', row)" icon="delete" text type="primary" @click="handleDelete(${activeModuleVarName}.key, row)">{{ t('common.delBtn') }}</el-button>`,
+    '                  <!-- 启用当前字典数据 -->',
     `                  <el-button v-if="showModuleAction(${activeModuleVarName}.key, 'enable', row)" icon="circle-check" text type="primary" @click="handleEnable(${activeModuleVarName}.key, row)">闁告凹鍨抽弫?/el-button>`,
+    '                  <!-- 禁用当前字典数据 -->',
     `                  <el-button v-if="showModuleAction(${activeModuleVarName}.key, 'disable', row)" icon="remove" text type="primary" @click="handleDisable(${activeModuleVarName}.key, row)">缂佸倷鑳堕弫?/el-button>`,
     `                </template>`,
     `              </SchemaListTable>`,
@@ -2628,14 +2691,18 @@ function renderMultiLevelSchemaListSlot(levelVarName, activeKeyVarName, activeMo
 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}` + `">`,
     '            <div class="layout-padding-auto layout-padding-view flex h-full flex-col">',
+    '              <!-- 当前层级新增按钮：受父级状态约束控制 -->',
     '              <div class="mb8" style="width: 100%">',
     `                <el-button icon="folder-add" type="primary" class="ml10" :disabled="isAddDisabled(${activeModuleVarName}.key)" @click="openCreate(${activeModuleVarName}.key)">{{ t('common.addBtn') }}</el-button>`,
     '              </div>',
+    '              <!-- 当前层级表格：展示字典数据并处理行选中联动 -->',
     '              <el-table',
     `                :data="moduleStateMap[${activeModuleVarName}.key].dataList"`,
     `                v-loading="moduleStateMap[${activeModuleVarName}.key].loading"`,
@@ -2644,7 +2711,9 @@ function renderMultiLevelLevelSlot(levelVarName, activeKeyVarName, activeModuleV
     '                highlight-current-row',
     `                @current-change="handlePanelCurrentChange(${activeModuleVarName}.key, $event)"`,
     '              >',
+    '                <!-- 序号列 -->',
     `                <el-table-column type="index" :label="t('common.serial')" width="60" />`,
+    '                <!-- 字典业务字段列 -->',
     `                <el-table-column`,
     `                  v-for="column in getListFields(${activeModuleVarName}.key)"`,
     '                  :key="column.key"',
@@ -2658,15 +2727,21 @@ function renderMultiLevelLevelSlot(levelVarName, activeKeyVarName, activeModuleV
     '                    <span v-else>{{ scope.row[column.key] }}</span>',
     '                  </template>',
     '                </el-table-column>',
+    '                <!-- 行操作按钮：编辑、删除、启用、禁用 -->',
     `                <el-table-column :label="t('common.action')" width="260">`,
     '                  <template #default="{ row }">',
+    '                    <!-- 编辑当前字典数据 -->',
     `                    <el-button v-if="showModuleAction(${activeModuleVarName}.key, 'edit', row)" icon="edit-pen" text type="primary" @click="openEdit(${activeModuleVarName}.key, row)">{{ t('common.editBtn') }}</el-button>`,
+    '                    <!-- 删除当前字典数据 -->',
     `                    <el-button v-if="showModuleAction(${activeModuleVarName}.key, 'delete', row)" icon="delete" text type="primary" @click="handleDelete(${activeModuleVarName}.key, row)">{{ t('common.delBtn') }}</el-button>`,
+    '                    <!-- 启用当前字典数据 -->',
     `                    <el-button v-if="showModuleAction(${activeModuleVarName}.key, 'enable', row)" icon="circle-check" text type="primary" @click="handleEnable(${activeModuleVarName}.key, row)">{{ t('common.actions.enable') }}</el-button>`,
+    '                    <!-- 禁用当前字典数据 -->',
     `                    <el-button v-if="showModuleAction(${activeModuleVarName}.key, 'disable', row)" icon="remove" text type="primary" @click="handleDisable(${activeModuleVarName}.key, row)">{{ t('common.actions.disable') }}</el-button>`,
     '                  </template>',
     '                </el-table-column>',
     '              </el-table>',
+    '              <!-- 当前层级分页组件 -->',
     '              <div class="mt-2.5 flex shrink-0 justify-end">',
     '                <pagination',
     `                  :current-page="moduleStateMap[${activeModuleVarName}.key].currentPage"`,
@@ -2718,24 +2793,31 @@ function renderMultiLevelIndexVue(model) {
 
   return `<!-- 功能名称：${sanitizeHtmlComment(model.featureTitle)} -->
 <template>
+  <!-- 页面布局：${sanitizeHtmlComment(model.featureTitle)}多层字典列表页 -->
   <div class="layout-padding">
+    <!-- 多层字典主布局：左侧一级字典，右侧二级和三级字典联动 -->
     <div class="multi-level-dict-layout">
-      <div class="multi-level-left">
+      <!-- 一级字典区域 -->
+      <div class="multi-level-left">
 ${renderMultiLevelSchemaListSlot('level1Config', 'activeLevel1Key', 'activeLevel1Module')}
-      </div>
-      <div class="multi-level-right">
-        <div class="multi-level-right-top">
+      </div>
+      <!-- 二级和三级字典区域 -->
+      <div class="multi-level-right">
+        <!-- 二级字典区域 -->
+        <div class="multi-level-right-top">
 ${level2 ? renderMultiLevelSchemaListSlot('level2Config', 'activeLevel2Key', 'activeLevel2Module') : ''}
-        </div>
-        <div v-if="level3Config" class="multi-level-right-bottom">
+        </div>
+        <!-- 三级字典区域 -->
+        <div v-if="level3Config" class="multi-level-right-bottom">
 ${level3 ? renderMultiLevelSchemaListSlot('level3Config', 'activeLevel3Key', 'activeLevel3Module') : ''}
-        </div>
-      </div>
-    </div>
-
-${formComponents}
-  </div>
-</template>
+        </div>
+      </div>
+    </div>
+
+    <!-- 多层字典表单弹窗：按模块异步挂载 -->
+${formComponents}
+  </div>
+</template>
 
   <script setup lang="ts" name="system${model.className}">
   // 通用消息与确认弹窗
@@ -3007,11 +3089,15 @@ function renderSingleTableDialogActions(model, permissionPrefix) {
   const pkAttr = model.pk.attrName;
   const isDictWithStatus = model.pageType === 'dict' && model.statusField;
   const lines = [
+    `          <!-- 编辑${sanitizeHtmlComment(model.featureTitle)} -->`,
     `          <el-button${isDictWithStatus ? ` v-if="showDictAction('edit', row)"` : ''} icon="edit-pen" text type="primary" v-auth="'${permissionPrefix}_edit'" @click="formDialogRef.openDialog(row.${pkAttr})">{{ t('common.editBtn') }}</el-button>`,
+    `          <!-- 删除${sanitizeHtmlComment(model.featureTitle)} -->`,
     `          <el-button${isDictWithStatus ? ` v-if="showDictAction('delete', row)"` : ''} icon="delete" text type="primary" v-auth="'${permissionPrefix}_del'" @click="handleDelete([row.${pkAttr}])">{{ t('common.delBtn') }}</el-button>`,
   ];
   if (isDictWithStatus) {
+    lines.push(`          <!-- 启用${sanitizeHtmlComment(model.featureTitle)} -->`);
     lines.push(`          <el-button v-if="showDictAction('enable', row)" icon="circle-check" text type="primary" @click="handleEnable(row.${pkAttr})">{{ t('common.actions.enable') }}</el-button>`);
+    lines.push(`          <!-- 禁用${sanitizeHtmlComment(model.featureTitle)} -->`);
     lines.push(`          <el-button v-if="showDictAction('disable', row)" icon="remove" text type="primary" @click="handleDisable(row.${pkAttr})">{{ t('common.actions.disable') }}</el-button>`);
   }
   return lines.join('\n');

package/package.json

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