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

package/assets/templates/master_child_jump/form.tpl

@@ -24,8 +24,9 @@
       <!-- 主子表表单：按 PRD 表单显隐和顺序渲染字段 -->
       <el-form ref="dataFormRef" :model="form" :rules="dataRules" :disabled="detail" v-loading="loading" label-width="120px">
         <el-collapse v-model="activeCollapseNames">
-{{FORM_COLLAPSE_SECTIONS}}
+{{FORM_COLLAPSE_SECTIONS_BEFORE_CHILDREN}}
 {{CHILD_SECTIONS}}
+{{FORM_COLLAPSE_SECTIONS_AFTER_CHILDREN}}
         </el-collapse>
       </el-form>
     </el-card>

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.89';
+const SERVER_VERSION = '0.1.91';
 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');
@@ -2208,13 +2208,35 @@ function buildModel(safeArgs) {
   };
 }
 
-function renderTemplate(templateText, replacements) {
-  let output = templateText;
-  for (const [key, value] of Object.entries(replacements)) {
-    output = output.split('{{' + key + '}}').join(String(value));
-  }
-  return output;
-}
+function renderTemplate(templateText, replacements) {
+  let output = templateText;
+  for (const [key, value] of Object.entries(replacements)) {
+    output = output.split('{{' + key + '}}').join(String(value));
+  }
+  return output;
+}
+
+function findUnresolvedTemplatePlaceholders(content) {
+  const matches = String(content || '').match(/\{\{[A-Z][A-Z0-9_]*\}\}/g) || [];
+  return [...new Set(matches)];
+}
+
+function assertNoUnresolvedTemplatePlaceholders(files) {
+  const issues = files
+    .map((file) => ({
+      type: file.type,
+      path: file.path,
+      placeholders: findUnresolvedTemplatePlaceholders(file.content),
+    }))
+    .filter((item) => item.placeholders.length);
+
+  if (issues.length) {
+    const detail = issues
+      .map((item) => `${item.type}:${path.basename(item.path)} -> ${item.placeholders.join(', ')}`)
+      .join('; ');
+    throw new Error(`MCP template rendering left unresolved placeholders: ${detail}`);
+  }
+}
 
 function renderFormField(field) {
   const label = stripDictAnnotation(field.comment).replace(/'/g, "\\'");
@@ -2545,19 +2567,68 @@ 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();
-  return fieldName.includes('attachment') || comment.includes('\u9644\u4ef6') || comment.includes('\u4e0a\u4f20');
-}
+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}"`;
+}
+
+const FORM_LAYOUT_DOMAIN_GROUPS = [
+  { key: 'contract', title: '合同信息', words: ['contract', 'sign', 'supplier', 'owner', 'customer', 'tax', 'term'] },
+  { key: 'pay', title: '支付信息', words: ['pay', 'payable', 'paid', 'payment', 'advance', 'offset'] },
+  { key: 'receive', title: '收款信息', words: ['receivable', 'receive', 'income', 'collect'] },
+  { key: 'settle', title: '结算信息', words: ['settle', 'finsettle', 'accountingperiod'] },
+  { key: 'warranty', title: '保证金/质保金信息', words: ['deposit', 'warranty', 'guarantee', 'return'] },
+  { key: 'clause', title: '条款信息', words: ['breach', 'argue', 'clause', 'substance', 'content'] },
+  { key: 'change', title: '变更信息', words: ['change', 'adjust', 'before', 'after'] },
+  { key: 'claim', title: '索赔/扣款/折扣信息', words: ['claim', 'reply', 'deduct', 'discount'] },
+  { key: 'work', title: '人员工作信息', words: ['pos', 'dept', 'ogn', 'induction', 'job', 'labor', 'retired', 'restart'] },
+  { key: 'borrow', title: '借用/领用/使用信息', words: ['borrow', 'lend', 'use', 'requisition', 'admin'] },
+  { key: 'document', title: '公文信息', words: ['document', 'reference', 'urgency', 'level', 'drafter', 'tomain', 'tocopy', 'tosubmit', 'year', 'no', 'proofread'] },
+];
+
+function getFormLayoutFieldText(field) {
+  return [
+    field?.attrName,
+    field?.fieldName,
+    field?.comment,
+    field?.label,
+    field?.description,
+    field?.formType,
+    field?.sqlType,
+  ].filter(Boolean).join(' ').toLowerCase();
+}
+
+function includesAnyLayoutWord(text, words) {
+  const normalized = String(text || '').toLowerCase();
+  return words.some((word) => normalized.includes(String(word).toLowerCase()));
+}
+
+function isAttachmentLikeField(field) {
+  const text = getFormLayoutFieldText(field);
+  return field?.formType === 'upload'
+    || includesAnyLayoutWord(text, ['attachment', 'file', 'upload', 'photo', 'sign'])
+    || /附件|上传|图片|签名/.test(text);
+}
+
+function computeFormFieldSpan(field) {
+  const prop = String(field?.attrName || field?.fieldName || '');
+  const propLower = prop.toLowerCase();
+  const text = getFormLayoutFieldText(field);
+
+  if (['upload', 'textarea', 'richtext'].includes(field?.formType)) return 24;
+  if (isAttachmentLikeField(field)) return 24;
+  if (includesAnyLayoutWord(text, ['remark', 'remarks', 'reason', 'opinion', 'content', 'address', 'explain', 'description', 'substance', 'clause', 'breach', 'argue'])) return 24;
+  if (/备注|原因|意见|内容|地址|说明|条款|违约|争议/.test(text)) return 24;
+  if (propLower.includes('keywords')) return 18;
+  if (prop === 'projectName') return 12;
+  if (includesAnyLayoutWord(propLower, ['fullname', 'orgname', 'deptname', 'ognname', 'companyname', 'suppliername', 'customername', 'unitname'])) return 12;
+  if (/项目名称|完整名称|组织名称|部门名称|单位名称|供应商名称|客户名称/.test(text)) return 12;
+
+  return 6;
+}
 
 function renderFieldCommentV2(field, indent = '          ') {
   const label = stripDictAnnotation(field.comment || field.attrName).replace(/-->/g, '').trim() || field.attrName;
@@ -2565,27 +2636,28 @@ function renderFieldCommentV2(field, indent = '          ') {
 }
 
 function renderFormFieldV2(field) {
-  const prop = field.attrName;
-  const labelExpr = `getMasterFieldLabel('${prop}')`;
-  const dictExpr = `getMasterFieldMeta('${prop}')?.dictType`;
-  const disabledAttr = renderDisabledAttrV2(field);
-  const disabledBool = renderDisabledBoolV2(field);
-
-  if (field.formType === 'upload') {
-    return [
-      renderFieldCommentV2(field),
-      `          <el-col :span="24" class="mb20">`,
-      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
-      `              <UploadFile v-model="form.${prop}"${disabledAttr} />`,
+  const prop = field.attrName;
+  const labelExpr = `getMasterFieldLabel('${prop}')`;
+  const dictExpr = `getMasterFieldMeta('${prop}')?.dictType`;
+  const disabledAttr = renderDisabledAttrV2(field);
+  const disabledBool = renderDisabledBoolV2(field);
+  const span = computeFormFieldSpan(field);
+
+  if (field.formType === 'upload') {
+    return [
+      renderFieldCommentV2(field),
+      `          <el-col :span="${span}" class="mb20">`,
+      `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
+      `              <UploadFile v-model="form.${prop}"${disabledAttr} />`,
       '            </el-form-item>',
       '          </el-col>',
     ].join('\n');
   }
 
-  if (field.formType === 'select') {
-    return [
-      renderFieldCommentV2(field),
-      `          <el-col :span="12" class="mb20">`,
+  if (field.formType === 'select') {
+    return [
+      renderFieldCommentV2(field),
+      `          <el-col :span="${span}" class="mb20">`,
       `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
       `              <el-select v-model="form.${prop}" :placeholder="formSelectPlaceholder(${labelExpr}, ${disabledBool})" style="width: 100%"${disabledAttr}>`,
       `                <el-option v-for="item in getDictOptions(${dictExpr})" :key="item.value" :label="item.label" :value="item.value" />`,
@@ -2595,12 +2667,12 @@ function renderFormFieldV2(field) {
     ].join('\n');
   }
 
-  if (field.formType === 'number') {
+  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">`,
+    return [
+      renderFieldCommentV2(field),
+      `          <el-col :span="${span}" 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>',
@@ -2608,10 +2680,10 @@ function renderFormFieldV2(field) {
     ].join('\n');
   }
 
-  if (field.formType === 'microme-operator') {
-    return [
-      renderFieldCommentV2(field),
-      `          <el-col :span="12" class="mb20">`,
+  if (field.formType === 'microme-operator') {
+    return [
+      renderFieldCommentV2(field),
+      `          <el-col :span="${span}" class="mb20">`,
       `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
       `              <MicromeOperator v-model="form.${prop}"${renderMicromeFormatAttr(field)} :placeholder="formInputPlaceholder(${labelExpr}, ${disabledBool})"${disabledAttr} />`,
       '            </el-form-item>',
@@ -2619,23 +2691,12 @@ function renderFormFieldV2(field) {
     ].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') {
+  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">`,
+    return [
+      renderFieldCommentV2(field),
+      `          <el-col :span="${span}" class="mb20">`,
       `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
       `              <el-date-picker type="${pickerType}" :placeholder="formInputPlaceholder(${labelExpr}, ${disabledBool})" v-model="form.${prop}" :value-format="${formatName}" style="width: 100%"${disabledAttr}></el-date-picker>`,
       '            </el-form-item>',
@@ -2643,11 +2704,11 @@ function renderFormFieldV2(field) {
     ].join('\n');
   }
 
-  if (field.formType === 'textarea') {
+  if (field.formType === 'textarea') {
     const textareaAttrs = renderTextareaMaxlengthAttrsV2(field);
-    return [
-      renderFieldCommentV2(field),
-      `          <el-col :span="24" class="mb20">`,
+    return [
+      renderFieldCommentV2(field),
+      `          <el-col :span="${span}" class="mb20">`,
       `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
       `              <el-input type="textarea" v-model="form.${prop}" :placeholder="formInputPlaceholder(${labelExpr}, ${disabledBool})"${textareaAttrs}${disabledAttr} />`,
       '            </el-form-item>',
@@ -2656,9 +2717,9 @@ function renderFormFieldV2(field) {
   }
 
   const maxlengthAttr = renderInputMaxlengthAttr(field);
-  return [
-    renderFieldCommentV2(field),
-    `          <el-col :span="12" class="mb20">`,
+  return [
+    renderFieldCommentV2(field),
+    `          <el-col :span="${span}" class="mb20">`,
     `            <el-form-item :label="${labelExpr}" prop="${prop}">`,
     `              <el-input v-model="form.${prop}" :placeholder="formInputPlaceholder(${labelExpr}, ${disabledBool})"${maxlengthAttr}${disabledAttr} />`,
     '            </el-form-item>',
@@ -2666,8 +2727,8 @@ function renderFormFieldV2(field) {
   ].join('\n');
 }
 
-const FILL_REPORT_FIELD_NAMES = new Set(['createBy', 'createTime', 'finishedTime']);
-const FILL_REPORT_FIELD_ORDER = ['createBy', 'createTime', 'finishedTime'];
+const FILL_REPORT_FIELD_NAMES = new Set(['createBy', 'createUser', 'createTime', 'finishedTime']);
+const FILL_REPORT_FIELD_ORDER = ['createBy', 'createUser', 'createTime', 'finishedTime'];
 
 function isFillReportField(field) {
   return FILL_REPORT_FIELD_NAMES.has(String(field?.attrName || field?.fieldName || ''));
@@ -2683,34 +2744,102 @@ function renderBusinessFormCollapseItem(title, name, fields) {
   ].join('\n');
 }
 
-function splitBusinessFormFields(fields) {
-  const fillReportFields = fields
-    .filter(isFillReportField)
-    .sort((left, right) => FILL_REPORT_FIELD_ORDER.indexOf(left.attrName) - FILL_REPORT_FIELD_ORDER.indexOf(right.attrName));
-  if (!fillReportFields.length) {
-    return { basicFields: fields, fillReportFields: [] };
-  }
-  return {
-    basicFields: fields.filter((field) => !isFillReportField(field)),
-    fillReportFields,
-  };
+function getFormFieldOriginalIndex(fields, field) {
+  return fields.indexOf(field);
+}
+
+function classifyBusinessFormDomain(field) {
+  const text = getFormLayoutFieldText(field).replace(/[_\-\s]/g, '');
+  const group = FORM_LAYOUT_DOMAIN_GROUPS.find((item) => item.words.some((word) => text.includes(String(word).toLowerCase())));
+  return group?.key || 'basic';
 }
 
-function renderBusinessFormCollapseSections(model) {
+function createBusinessFormLayoutSections(model) {
   const fields = model.pageType === 'ledger' ? model.visibleFields.map(asReadonlyField) : model.visibleFields;
-  const { basicFields, fillReportFields } = splitBusinessFormFields(fields);
-  const sections = [renderBusinessFormCollapseItem('基本信息', '0', basicFields)];
+  const basicFields = [];
+  const attachmentFields = [];
+  const fillReportFields = [];
+  const domainBuckets = new Map();
+
+  fields.forEach((field) => {
+    if (isFillReportField(field)) {
+      fillReportFields.push(field);
+      return;
+    }
+    if (isAttachmentLikeField(field)) {
+      attachmentFields.push(field);
+      return;
+    }
+    const domain = classifyBusinessFormDomain(field);
+    if (domain === 'basic') {
+      basicFields.push(field);
+      return;
+    }
+    if (!domainBuckets.has(domain)) domainBuckets.set(domain, []);
+    domainBuckets.get(domain).push(field);
+  });
+
+  const beforeChildren = [{ title: '基本信息', fields: basicFields }];
+
+  FORM_LAYOUT_DOMAIN_GROUPS.forEach((group) => {
+    const bucket = domainBuckets.get(group.key) || [];
+    if (bucket.length >= 3) {
+      beforeChildren.push({ title: group.title, fields: bucket });
+    } else {
+      beforeChildren[0].fields.push(...bucket);
+    }
+  });
+
+  const afterChildren = [];
+  if (attachmentFields.length >= 2) {
+    afterChildren.push({ title: '附件信息', fields: attachmentFields });
+  } else {
+    beforeChildren[0].fields.push(...attachmentFields);
+  }
+
+  beforeChildren.concat(afterChildren).forEach((section) => {
+    section.fields.sort((left, right) => getFormFieldOriginalIndex(fields, left) - getFormFieldOriginalIndex(fields, right));
+  });
+
   if (fillReportFields.length) {
-    sections.push(renderBusinessFormCollapseItem('填报信息', '1', fillReportFields));
+    afterChildren.push({
+      title: '填报信息',
+      fields: fillReportFields.sort((left, right) => FILL_REPORT_FIELD_ORDER.indexOf(left.attrName) - FILL_REPORT_FIELD_ORDER.indexOf(right.attrName)),
+    });
   }
-  return sections.join('\n');
+
+  let nameIndex = 0;
+  beforeChildren.filter((section) => section.fields.length).forEach((section) => {
+    section.name = String(nameIndex++);
+  });
+  afterChildren.filter((section) => section.fields.length).forEach((section) => {
+    section.name = String(nameIndex++);
+  });
+
+  return {
+    beforeChildren: beforeChildren.filter((section) => section.fields.length),
+    afterChildren: afterChildren.filter((section) => section.fields.length),
+  };
+}
+
+function renderBusinessFormCollapseSections(model, placement = 'all') {
+  const layout = createBusinessFormLayoutSections(model);
+  const sections =
+    placement === 'beforeChildren'
+      ? layout.beforeChildren
+      : placement === 'afterChildren'
+        ? layout.afterChildren
+        : [...layout.beforeChildren, ...layout.afterChildren];
+  return sections.map((section) => renderBusinessFormCollapseItem(section.title, section.name, section.fields)).join('\n');
 }
 
 function renderActiveCollapseNames(model) {
-  const fields = model.pageType === 'ledger' ? model.visibleFields.map(asReadonlyField) : model.visibleFields;
-  const names = ['0'];
-  if (fields.some(isFillReportField)) names.push('1');
-  model.children.forEach((childModel) => names.push(`child-${childModel.listName}`));
+  const layout = createBusinessFormLayoutSections(model);
+  const names = [
+    ...layout.beforeChildren.map((section) => section.name),
+    ...model.children.map((childModel) => `child-${childModel.listName}`),
+    ...layout.afterChildren.map((section) => section.name),
+  ];
   return `[${names.map((name) => `'${name}'`).join(', ')}]`;
 }
 
@@ -4380,6 +4509,8 @@ function buildReplacements(model, sharedSupport) {
       GENERATED_AT: new Date().toISOString(),
       FORM_FIELDS: (model.pageType === 'ledger' ? model.visibleFields.map(asReadonlyField) : model.visibleFields).map(renderFormFieldV2).join('\n'),
       FORM_COLLAPSE_SECTIONS: renderBusinessFormCollapseSections(model),
+      FORM_COLLAPSE_SECTIONS_BEFORE_CHILDREN: renderBusinessFormCollapseSections(model, 'beforeChildren'),
+      FORM_COLLAPSE_SECTIONS_AFTER_CHILDREN: renderBusinessFormCollapseSections(model, 'afterChildren'),
       ACTIVE_COLLAPSE_NAMES: renderActiveCollapseNames(model),
       TABLE_COLUMNS: model.gridFields.map((field) => renderTableColumn(field, dictRegistryRefs)).join('\n'),
       FORM_DEFAULTS: renderFormDefaults(model),
@@ -4434,11 +4565,12 @@ function renderFiles(model, stylePreset, sharedSupport, localeZhSupport) {
     },
   ];
 
-  if (menuSqlTemplate) {
-    files.push({ type: 'menuSql', path: path.join(menuRoot, `${model.functionName}_menu.sql`), content: renderTemplate(menuSqlTemplate, replacements) });
-  }
-  return files;
-}
+  if (menuSqlTemplate) {
+    files.push({ type: 'menuSql', path: path.join(menuRoot, `${model.functionName}_menu.sql`), content: renderTemplate(menuSqlTemplate, replacements) });
+  }
+  assertNoUnresolvedTemplatePlaceholders(files);
+  return files;
+}
 
 function ensureArguments(input) {
   if (!input || typeof input !== 'object') throw new Error('Arguments must be an object');

package/package.json

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