worsoft-frontend-codegen-local-mcp 0.1.22 → 0.1.24

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.22';
+const SERVER_VERSION = '0.1.24';
 const PROTOCOL_VERSION = '2024-11-05';
 const TOOL_NAME = 'worsoft_codegen_local_generate_frontend';
 const TEMPLATE_LIBRARY_ROOT = path.resolve(__dirname, '..', 'template');
@@ -16,25 +16,27 @@ const DEFAULT_DICT_REGISTRY_KEYS = {
   trade_standard_type: 'TRADE_STANDARD_TYPE',
   trade_score_standard: 'TRADE_SCORE_STANDARD',
 };
-const DEFAULT_CRUD_SCHEMA_TEMPLATE = `export interface FieldMeta {
-  show: boolean;
-  alwaysHide: boolean;
-  smart: boolean;
-  labelKey: string;
+const DEFAULT_CRUD_SCHEMA_TEMPLATE = `export interface FieldMeta {
+  show: boolean;
+  listShow: boolean;
+  alwaysHide: boolean;
+  smart: boolean;
+  labelKey: string;
   label?: string;
   width: string;
   dictType?: string;
 }
 
-export interface FieldConfig {
-  key: string;
-  labelKey?: string;
-  label?: string;
-  width?: string;
-  show?: boolean;
-  alwaysHide?: boolean;
-  smart?: boolean;
-  dictType?: string;
+export interface FieldConfig {
+  key: string;
+  labelKey?: string;
+  label?: string;
+  width?: string;
+  show?: boolean;
+  listShow?: boolean;
+  alwaysHide?: boolean;
+  smart?: boolean;
+  dictType?: string;
 }
 
 export interface CrudSchemaDefinition {
@@ -52,11 +54,12 @@ export interface CrudSchema {
 
 const DEFAULT_WIDTH = '120';
 
-export const field = (labelKey: string, width = DEFAULT_WIDTH): FieldMeta => ({
-  show: true,
-  alwaysHide: false,
-  smart: false,
-  labelKey,
+export const field = (labelKey: string, width = DEFAULT_WIDTH): FieldMeta => ({
+  show: true,
+  listShow: true,
+  alwaysHide: false,
+  smart: false,
+  labelKey,
   width,
 });
 
@@ -79,10 +82,11 @@ export const collectDictTypes = (...groups: Array<Record<string, FieldMeta>>) =>
     )
   );
 
-const normalizeField = (item: FieldConfig): FieldMeta => ({
-  show: item.show ?? true,
-  alwaysHide: item.alwaysHide ?? false,
-  smart: item.smart ?? false,
+const normalizeField = (item: FieldConfig): FieldMeta => ({
+  show: item.show ?? true,
+  listShow: item.listShow ?? item.show ?? true,
+  alwaysHide: item.alwaysHide ?? false,
+  smart: item.smart ?? false,
   labelKey: item.labelKey ?? item.label ?? item.key,
   ...(item.label ? { label: item.label } : {}),
   width: item.width ?? DEFAULT_WIDTH,
@@ -145,6 +149,7 @@ const TOOL_SCHEMA = {
           required: { type: ['boolean', 'string'], description: 'Whether the field is required.' },
           readonly: { type: ['boolean', 'string'], description: 'Whether the field is readonly on the page.' },
           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.' },
           dictType: { type: 'string', description: 'Dictionary type code from the API document.' },
           defaultValue: { type: ['string', 'number', 'boolean'], description: 'Optional default value.' },
           description: { type: 'string', description: 'Field description or notes.' },
@@ -181,6 +186,7 @@ const TOOL_SCHEMA = {
                 required: { type: ['boolean', 'string'], description: 'Whether the field is required.' },
                 readonly: { type: ['boolean', 'string'], description: 'Whether the field is readonly on the page.' },
                 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.' },
                 dictType: { type: 'string', description: 'Dictionary type code from the API document.' },
                 defaultValue: { type: ['string', 'number', 'boolean'], description: 'Optional default value.' },
                 description: { type: 'string', description: 'Field description or notes.' },
@@ -428,20 +434,20 @@ function buildChildSectionTitleKey(model, childModel) {
   return `${buildI18nNamespace(model)}.children.${childModel.listName}.title`;
 }
 
-function buildLocaleLeaf(model) {
-  const leaf = {
-    title: model.tableComment,
-    fields: Object.fromEntries(model.visibleFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
-  };
+function buildLocaleLeaf(model) {
+  const leaf = {
+    title: model.tableComment,
+    fields: Object.fromEntries(model.optionFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
+  };
 
   if (model.children.length) {
     leaf.children = Object.fromEntries(
       model.children.map((childModel) => [
         childModel.listName,
-        {
-          title: childModel.tableComment,
-          fields: Object.fromEntries(childModel.visibleFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
-        },
+        {
+          title: childModel.tableComment,
+          fields: Object.fromEntries(childModel.optionFields.map((field) => [field.attrName, stripDictAnnotation(field.comment)])),
+        },
       ])
     );
   }
@@ -778,6 +784,7 @@ function normalizeStructuredField(inputField, index, contextLabel) {
     defaultValue: normalizeDefaultValue(inputField.defaultValue),
     readonly: parseBooleanLike(inputField.readonly, false),
     show: parseBooleanLike(inputField.show, true),
+    listShow: parseBooleanLike(inputField.listShow, parseBooleanLike(inputField.show, true)),
     sourceKind: normalizeStructuredSourceKind(inputField.sourceKind),
     primary: parseBooleanLike(inputField.primary, fieldName === 'id'),
   };
@@ -903,9 +910,10 @@ function buildChildModels(safeArgs, mainFields, mainPk) {
     });
     const mainRelationField = ensureFieldExists(mainFields, relation.mainField, safeArgs.tableName, 'Main relation');
     const childRelationField = ensureFieldExists(childFields, relation.childField, relation.childTableName, 'Child relation');
-    const childVisibleFields = childFields.filter(
-      (field) => field.fieldName !== childPk.fieldName && !field.isAudit && field.fieldName !== relation.childField && field.show !== false
+    const childOptionFields = childFields.filter(
+      (field) => field.fieldName !== childPk.fieldName && !field.isAudit && field.fieldName !== relation.childField
     );
+    const childVisibleFields = childOptionFields.filter((field) => field.show !== false);
     const payloadField = relation.payloadField;
     const listName = payloadField;
 
@@ -919,6 +927,7 @@ function buildChildModels(safeArgs, mainFields, mainPk) {
       payloadFieldSource: 'arguments',
       pk: childPk,
       fields: childFields,
+      optionFields: childOptionFields,
       visibleFields: childVisibleFields,
       mainField: mainRelationField,
       childField: childRelationField,
@@ -932,11 +941,13 @@ function buildModel(safeArgs) {
   const fields = normalizeFields({
     fields: safeArgs.fields,
   });
-  const visibleFields = fields.filter((field) => field.fieldName !== pkField.fieldName && !field.isAudit && field.show !== false);
-  const gridFields = visibleFields.slice(0, 8);
+  const optionFields = fields.filter((field) => field.fieldName !== pkField.fieldName && !field.isAudit);
+  const visibleFields = optionFields.filter((field) => field.show !== false);
+  const listFields = optionFields.filter((field) => field.listShow !== false);
+  const gridFields = listFields.slice(0, 8);
   const children = buildChildModels(safeArgs, fields, pkField);
-  const childDictTypes = children.flatMap((child) => child.visibleFields.map((field) => field.dictType).filter(Boolean));
-  const dictTypes = [...new Set([...visibleFields.map((field) => field.dictType).filter(Boolean), ...childDictTypes])];
+  const childDictTypes = children.flatMap((child) => child.optionFields.map((field) => field.dictType).filter(Boolean));
+  const dictTypes = [...new Set([...optionFields.map((field) => field.dictType).filter(Boolean), ...childDictTypes])];
 
   const functionName = toCamelCase(safeArgs.tableName);
   const apiPath = safeArgs.apiPath || functionName;
@@ -950,7 +961,9 @@ function buildModel(safeArgs) {
     moduleName: normalizeModulePathForFeature(safeArgs.moduleName, functionName, apiPath),
     pk: pkField,
     fields,
+    optionFields,
     visibleFields,
+    listFields,
     gridFields,
     dictTypes,
     frontendPath: path.resolve(safeArgs.frontendPath),
@@ -1211,27 +1224,34 @@ function getDefaultOptionFieldWidthV2(field) {
   return '100';
 }
 
-function renderOptionFieldV2(field, labelKey, dictRegistryRefs, indent = '    ') {
-  const parts = [`key: '${field.attrName}'`, `labelKey: '${labelKey}'`];
+function renderOptionFieldV2(field, labelKey, dictRegistryRefs, indent = '    ') {
+  const fallbackLabel = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
+  const parts = [`key: '${field.attrName}'`, `labelKey: '${labelKey}'`, `label: '${fallbackLabel}'`];
   const width = getDefaultOptionFieldWidthV2(field);
 
   if (width !== '120') {
     parts.push(`width: '${width}'`);
   }
 
-  if (field.dictType) {
-    parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
-  }
-
-  return `${indent}{ ${parts.join(', ')} },`;
-}
+  if (field.dictType) {
+    parts.push(`dictType: ${getDictRegistryReference(field.dictType, dictRegistryRefs)}`);
+  }
+  if (field.show === false) {
+    parts.push('show: false');
+  }
+  if (field.listShow === false) {
+    parts.push('listShow: false');
+  }
+
+  return `${indent}{ ${parts.join(', ')} },`;
+}
 
 function renderChildOptionGroupV2(model, childModel, dictRegistryRefs) {
   return [
     `    ${childModel.listName}: [`,
-    childModel.visibleFields
-      .map((field) => renderOptionFieldV2(field, buildChildFieldLabelKey(model, childModel, field), dictRegistryRefs, '      '))
-      .join('\n'),
+    childModel.optionFields
+      .map((field) => renderOptionFieldV2(field, buildChildFieldLabelKey(model, childModel, field), dictRegistryRefs, '      '))
+      .join('\n'),
     '    ],',
   ].join('\n');
 }
@@ -1249,21 +1269,32 @@ function renderTextareaMaxlengthAttrsV2(field) {
   if (!field.length) return '';
   return ` :maxlength="${field.length}" show-word-limit`;
 }
-
+
+function renderDisabledAttrV2(field) {
+  return field.readonly ? ' disabled' : '';
+}
+
+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}')`;
   const dictExpr = `getMasterFieldMeta('${prop}')?.dictType`;
+  const disabledAttr = renderDisabledAttrV2(field);
 
   if (field.formType === 'select') {
     return [
+      renderFieldCommentV2(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%">`,
+      `              <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-select>',
-      '            </el-form-item>',
-      '          </el-col>',
+      '              </el-select>',
+      '            </el-form-item>',
+      '          </el-col>',
     ].join('\n');
   }
 
@@ -1271,46 +1302,50 @@ function renderFormFieldV2(field) {
     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="inputPlaceholder(${labelExpr})" style="width: 100%" />`,
+      `              <el-input-number v-model="form.${prop}" :min="0"${max}${precision} :placeholder="inputPlaceholder(${labelExpr})" style="width: 100%"${disabledAttr} />`,
       '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
+      '          </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 [
+      renderFieldCommentV2(field),
       `          <el-col :span="12" class="mb20">`,
       `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
-      `              <el-date-picker type="${pickerType}" :placeholder="inputPlaceholder(${labelExpr})" v-model="form.${prop}" :value-format="${formatName}" style="width: 100%"></el-date-picker>`,
+      `              <el-date-picker type="${pickerType}" :placeholder="inputPlaceholder(${labelExpr})" v-model="form.${prop}" :value-format="${formatName}" style="width: 100%"${disabledAttr}></el-date-picker>`,
       '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
+      '          </el-col>',
+    ].join('\n');
+  }
+
   if (field.formType === 'textarea') {
     const textareaAttrs = renderTextareaMaxlengthAttrsV2(field);
     return [
+      renderFieldCommentV2(field),
       `          <el-col :span="24" class="mb20">`,
       `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
-      `              <el-input type="textarea" v-model="form.${prop}" :placeholder="inputPlaceholder(${labelExpr})"${textareaAttrs} />`,
+      `              <el-input type="textarea" v-model="form.${prop}" :placeholder="inputPlaceholder(${labelExpr})"${textareaAttrs}${disabledAttr} />`,
       '            </el-form-item>',
-      '          </el-col>',
-    ].join('\n');
-  }
-
+      '          </el-col>',
+    ].join('\n');
+  }
+
   const maxlengthAttr = renderInputMaxlengthAttr(field);
   return [
+    renderFieldCommentV2(field),
     `          <el-col :span="12" class="mb20">`,
     `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
-    `              <el-input v-model="form.${prop}" :placeholder="inputPlaceholder(${labelExpr})"${maxlengthAttr} />`,
+    `              <el-input v-model="form.${prop}" :placeholder="inputPlaceholder(${labelExpr})"${maxlengthAttr}${disabledAttr} />`,
     '            </el-form-item>',
-    '          </el-col>',
-  ].join('\n');
-}
+    '          </el-col>',
+  ].join('\n');
+}
 
 function renderTableColumnV2(field, dictRegistryRefs) {
   const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
@@ -1328,34 +1363,36 @@ function renderTableColumnV2(field, 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`;
-
-  let control = `                  <el-input v-model="row.${field.attrName}" :placeholder="inputPlaceholder(${labelExpr})"${renderTextMaxlengthAttrV2(field)} />`;
-  if (field.formType === 'select' && field.dictType) {
-    control = [
-      `                  <el-select v-model="row.${field.attrName}" :placeholder="selectPlaceholder(${labelExpr})" style="width: 100%">`,
-      `                    <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%" />`;
-  } 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%"></el-date-picker>`;
-  } else if (field.formType === 'textarea') {
-    control = `                  <el-input type="textarea" v-model="row.${field.attrName}" :placeholder="inputPlaceholder(${labelExpr})"${renderTextareaMaxlengthAttrsV2(field)} />`;
-  }
-
-  return [
-    `            <el-table-column :label="${labelExpr}" prop="${field.attrName}">`,
-    '              <template #default="{ row, $index }">',
-    `                <el-form-item :prop="\`${childListName}.\${$index}.${field.attrName}\`"${rules}>`,
+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>',
@@ -1426,7 +1463,7 @@ function buildReplacements(model, sharedSupport) {
       TABLE_COLUMNS: model.gridFields.map((field) => renderTableColumnV2(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.visibleFields.map((field) => renderOptionFieldV2(field, buildFieldLabelKey(model, field), dictRegistryRefs)).join('\n'),
+      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'),
       FORM_RULES: renderFormRulesV2(model.visibleFields),
       CHILD_FORM_LIST_DEFAULTS: renderChildFormListDefaults(model.children),
@@ -1565,7 +1602,8 @@ function buildManifest(model, safeArgs, stylePreset, sharedTemplates, files, not
     summary: {
       totalFields: model.fields.length,
       visibleFields: model.visibleFields.length,
-      dictFields: model.visibleFields.filter((field) => field.dictType).map((field) => field.attrName),
+      listVisibleFields: model.listFields.length,
+      dictFields: model.optionFields.filter((field) => field.dictType).map((field) => field.attrName),
       skippedAuditFields: model.fields.filter((field) => field.isAudit).map((field) => field.fieldName),
       childCount: model.children.length,
       childTables: model.children.map((childModel) => childModel.tableName),

package/package.json

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