worsoft-frontend-codegen-local-mcp 0.1.60 → 0.1.64

package/assets/templates/master_child_jump/index.tpl

@@ -1,3 +1,4 @@
+<!-- 功能名称：{{FEATURE_TITLE}} -->
 <template>
   <div class="layout-padding">
     <div class="layout-padding-auto layout-padding-view flex h-full flex-col">

package/assets/templates/single_table_dialog/index.tpl

@@ -1,3 +1,4 @@
+<!-- 功能名称：{{FEATURE_TITLE}} -->
 <template>
   <div class="layout-padding">
     <div class="layout-padding-auto layout-padding-view flex h-full flex-col">

package/assets/templates/single_table_jump/index.tpl

@@ -1,3 +1,4 @@
+<!-- 功能名称：{{FEATURE_TITLE}} -->
 <template>
   <div class="layout-padding">
     <div class="layout-padding-auto layout-padding-view flex h-full flex-col">

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.60';
+const SERVER_VERSION = '0.1.64';
 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');
@@ -178,6 +178,7 @@ const TOOL_SCHEMA = {
                   show: { type: ['boolean', 'string'], description: 'Whether the field is shown on the page.' },
                   listShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the list page.' },
                   formShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the form page.' },
+                  formOrder: { type: ['number', 'string'], description: 'Generation-only form field order from PRD detail/form table. This is not emitted to options.ts.' },
                   smart: { type: ['boolean', 'string'], description: 'Whether the field participates in smart keyword search. This must come from PRD, not inferred from type.' },
           queryType: { type: ['string', 'number'], description: 'Structured query type for list filtering, for example 20 for date ranges or 30 for dictionary filters.' },
           dictType: { type: 'string', description: 'Dictionary type code from structured metadata.' },
@@ -220,6 +221,7 @@ const TOOL_SCHEMA = {
                         show: { type: ['boolean', 'string'], description: 'Whether the field is shown on the page.' },
                         listShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the list page.' },
                         formShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the form page.' },
+                        formOrder: { type: ['number', 'string'], description: 'Generation-only form field order from PRD detail/form table. This is not emitted to options.ts.' },
                         smart: { type: ['boolean', 'string'], description: 'Whether the field participates in smart keyword search. This must come from PRD, not inferred from type.' },
                 queryType: { type: ['string', 'number'], description: 'Structured query type for list filtering, for example 20 for date ranges or 30 for dictionary filters.' },
                 dictType: { type: 'string', description: 'Dictionary type code from structured metadata.' },
@@ -278,6 +280,7 @@ const TOOL_SCHEMA = {
                               show: { type: ['boolean', 'string'], description: 'Whether the field is shown on the page.' },
                               listShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the list page.' },
                               formShow: { type: ['boolean', 'string'], description: 'Whether the field is shown on the form page.' },
+                              formOrder: { type: ['number', 'string'], description: 'Generation-only form field order from PRD detail/form table. This is not emitted to options.ts.' },
                               smart: { type: ['boolean', 'string'], description: 'Whether the field participates in smart keyword search. This must come from PRD, not inferred from type.' },
                       queryType: { type: ['string', 'number'], description: 'Structured query type for list filtering, for example 20 for date ranges or 30 for dictionary filters.' },
                       dictType: { type: 'string', description: 'Dictionary type code from structured metadata.' },
@@ -980,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';
   }
@@ -1139,16 +1142,50 @@ function normalizeStructuredSqlType(value) {
   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);
-  const normalizedScale = scaleValue === undefined || scaleValue === null || scaleValue === '' ? parsed.scale : String(scaleValue).trim();
-  return {
-    length: parsed.length,
-    scale: normalizedScale || '',
-  };
-}
-
-function normalizeStructuredField(inputField, index, contextLabel) {
+function normalizeStructuredLengthAndScale(lengthValue, scaleValue) {
+  const parsed = splitLength(lengthValue);
+  const normalizedScale = scaleValue === undefined || scaleValue === null || scaleValue === '' ? parsed.scale : String(scaleValue).trim();
+  return {
+    length: parsed.length,
+    scale: normalizedScale || '',
+  };
+}
+
+function parseOptionalOrder(value, label) {
+  if (value === undefined || value === null || value === '') return undefined;
+  const order = Number.parseInt(String(value), 10);
+  if (Number.isNaN(order) || order < 0) {
+    throw new Error(`${label} must be a non-negative integer when provided`);
+  }
+  return order;
+}
+
+function sortFieldsForForm(fields) {
+  const seenOrders = new Map();
+  fields.forEach((field) => {
+    if (field.formOrder === undefined) return;
+    const existing = seenOrders.get(field.formOrder);
+    if (existing) {
+      throw new Error(`Duplicate formOrder ${field.formOrder} on fields ${existing} and ${field.fieldName}`);
+    }
+    seenOrders.set(field.formOrder, field.fieldName);
+  });
+  return fields
+    .map((field, index) => ({ field, index }))
+    .sort((left, right) => {
+      const leftOrder = left.field.formOrder;
+      const rightOrder = right.field.formOrder;
+      if (leftOrder !== undefined && rightOrder !== undefined && leftOrder !== rightOrder) {
+        return leftOrder - rightOrder;
+      }
+      if (leftOrder !== undefined && rightOrder === undefined) return -1;
+      if (leftOrder === undefined && rightOrder !== undefined) return 1;
+      return left.index - right.index;
+    })
+    .map((item) => item.field);
+}
+
+function normalizeStructuredField(inputField, index, contextLabel) {
   if (!inputField || typeof inputField !== 'object') {
     throw new Error(contextLabel + '[' + index + '] must be an object');
   }
@@ -1177,6 +1214,7 @@ function normalizeStructuredField(inputField, index, contextLabel) {
   const show = parseBooleanLike(inputField.show, true);
   const listShow = parseBooleanLike(inputField.listShow, show);
   const formShow = parseBooleanLike(inputField.formShow, show);
+  const formOrder = parseOptionalOrder(inputField.formOrder, contextLabel + '[' + index + '].formOrder');
 
   return {
     fieldName,
@@ -1195,6 +1233,7 @@ function normalizeStructuredField(inputField, index, contextLabel) {
     show,
     listShow,
     formShow,
+    formOrder,
     smart: parseBooleanLike(inputField.smart, false),
     queryType: Number.isNaN(explicitQueryType)
       ? undefined
@@ -1402,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);
@@ -1519,7 +1564,7 @@ function buildMultiLevelModule(moduleInput, levelIndex) {
     ? ensureFieldExists(fields, moduleInput.primaryKey, moduleInput.tableName, 'Primary key')
     : findPrimaryKeyFromStructuredFields(fields);
   const optionFields = fields.filter((field) => field.fieldName !== normalizedPk.fieldName && !field.isAudit);
-  const visibleFields = optionFields.filter((field) => field.formShow !== false);
+  const visibleFields = sortFieldsForForm(optionFields.filter((field) => field.formShow !== false));
   const listFields = optionFields.filter((field) => field.listShow !== false);
   const statusField = detectStatusField(fields, moduleInput.statusField);
   const apiPath = moduleInput.apiPath || toCamelCase(moduleInput.tableName);
@@ -1642,7 +1687,7 @@ function buildChildModels(safeArgs, mainFields, mainPk) {
     const childOptionFields = childFields.filter(
       (field) => field.fieldName !== childPk.fieldName && !field.isAudit && field.fieldName !== relation.childField
     );
-    const childVisibleFields = childOptionFields.filter((field) => field.formShow !== false);
+    const childVisibleFields = sortFieldsForForm(childOptionFields.filter((field) => field.formShow !== false));
     const payloadField = relation.payloadField;
     const listName = payloadField;
 
@@ -1675,7 +1720,7 @@ function buildModel(safeArgs) {
     fields: safeArgs.fields,
   });
   const optionFields = fields.filter((field) => field.fieldName !== pkField.fieldName && !field.isAudit);
-  const visibleFields = optionFields.filter((field) => field.formShow !== false);
+  const visibleFields = sortFieldsForForm(optionFields.filter((field) => field.formShow !== false));
   const listFields = optionFields.filter((field) => field.listShow !== false);
   const gridFields = listFields.slice(0, 8);
   const statusField = detectStatusField(fields, safeArgs.statusField);
@@ -1747,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 [
@@ -1824,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 [
@@ -1853,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}: '',`;
 }
 
@@ -2049,6 +2106,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();
@@ -2091,20 +2156,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 [
@@ -2416,7 +2503,7 @@ function renderMultiLevelFormVue(model, moduleModel) {
     `  tenantId: Session.getTenant(),`,
   ].join('\n');
   const rules = renderFormRulesV2(moduleModel.visibleFields);
-  return `<template>
+  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">
@@ -2677,10 +2764,10 @@ function renderMultiLevelIndexVue(model) {
     )
     .join('\n');
 
-  return `<template>
-  <div class="layout-padding">
-    <!-- \u529f\u80fd\u540d\u79f0\uFF1A${model.featureTitle.replace(/--/g, '')} -->
-    <div class="multi-level-dict-layout">
+  return `<!-- 功能名称：${sanitizeHtmlComment(model.featureTitle)} -->
+<template>
+  <div class="layout-padding">
+    <div class="multi-level-dict-layout">
       <div class="multi-level-left">
 ${renderMultiLevelSchemaListSlot('level1Config', 'activeLevel1Key', 'activeLevel1Module')}
       </div>
@@ -3068,6 +3155,10 @@ function sanitizeComment(value) {
   return String(value || '').replace(/\*\//g, '* /').replace(/\r?\n/g, ' ').trim();
 }
 
+function sanitizeHtmlComment(value) {
+  return String(value || '').replace(/--/g, '').replace(/\r?\n/g, ' ').trim();
+}
+
 function renderExtraApiFunctions(model) {
   if (!Array.isArray(model.extraApis) || !model.extraApis.length) return '';
   return model.extraApis

package/package.json

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