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

package/assets/templates/master_child_jump/api.tpl

@@ -1,48 +1,7 @@
-// 请求工具
-import request from '/@/utils/request';
+// 通用 CRUD 接口工厂
+import { createCrudApi } from '/@/api/common/crudFactory';
+{{API_REQUEST_IMPORT}}
 
-// 查询分页列表
-export function fetchList(query?: object) {
-  return request({
-    url: '/{{API_PATH}}/page',
-    method: 'get',
-    params: query,
-  });
-}
-
-// 新增数据
-export function addObj(obj?: object) {
-  return request({
-    url: '/{{API_PATH}}/save',
-    method: 'post',
-    data: obj,
-  });
-}
-
-// 查询详情数据
-export function getObj(obj?: object) {
-  return request({
-    url: '/{{API_PATH}}/getById',
-    method: 'get',
-    params: obj,
-  });
-}
-
-// 删除数据
-export function delObjs(ids?: object) {
-  return request({
-    url: '/{{API_PATH}}/removeByIds',
-    method: 'post',
-    data: ids,
-  });
-}
-
-// 更新数据
-export function putObj(obj?: object) {
-  return request({
-    url: '/{{API_PATH}}/updateById',
-    method: 'post',
-    data: obj,
-  });
-}
+// {{FEATURE_TITLE}} 通用列表、新增、详情、删除、更新接口
+export const { fetchList, addObj, getObj, delObjs, putObj } = createCrudApi('/{{API_PATH}}');
 {{EXTRA_API_FUNCTIONS}}

package/assets/templates/master_child_jump/menu.sql.tpl

@@ -5,6 +5,10 @@
 insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
 values ({{MENU_BASE_ID}}, '-1', '/{{MENU_ROUTE_PATH}}/index', '', '0', 'icon-bangzhushouji', '0', null, '8', null, '{{TABLE_COMMENT}}管理', 1);
 
+-- Form route SQL for jump-based pages. Hidden from sidebar, used by list page add/edit/view navigation.
+insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, visible, del_flag, create_time, sort_order, update_time, name, tenant_id)
+values ({{MENU_BASE_ID_PLUS_6}}, {{MENU_BASE_ID}}, '/{{MENU_ROUTE_PATH}}/form', '', '0', 'icon-biaodan', '0', '0', null, '9', null, '{{TABLE_COMMENT}}表单', 1);
+
 insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
 values ({{MENU_BASE_ID_PLUS_1}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_view', '1', null, '1', '0', null, '0', null, '{{TABLE_COMMENT}}查看', 1);
 
@@ -18,4 +22,4 @@ insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del
 values ({{MENU_BASE_ID_PLUS_4}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_del', '1', null, '1', '0', null, '3', null, '{{TABLE_COMMENT}}删除', 1);
 
 insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_5}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_export', '1', null, '1', '0', null, '4', null, '导入导出', 1);
+values ({{MENU_BASE_ID_PLUS_5}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_export', '1', null, '1', '0', null, '4', null, '导入导出', 1);

package/assets/templates/single_table_dialog/api.tpl

@@ -1,50 +1,9 @@
-// 请求工具
-import request from '/@/utils/request';
+// 通用 CRUD 接口工厂
+import { createCrudApi } from '/@/api/common/crudFactory';
+{{API_REQUEST_IMPORT}}
 
-// 查询分页列表
-export function fetchList(query?: object) {
-  return request({
-    url: '/{{API_PATH}}/page',
-    method: 'get',
-    params: query,
-  });
-}
-
-// 新增数据
-export function addObj(obj?: object) {
-  return request({
-    url: '/{{API_PATH}}',
-    method: 'post',
-    data: obj,
-  });
-}
-
-// 查询详情数据
-export function getObj(obj?: object) {
-  return request({
-    url: '/{{API_PATH}}/details',
-    method: 'get',
-    params: obj,
-  });
-}
-
-// 删除数据
-export function delObjs(ids?: object) {
-  return request({
-    url: '/{{API_PATH}}',
-    method: 'delete',
-    data: ids,
-  });
-}
-
-// 更新数据
-export function putObj(obj?: object) {
-  return request({
-    url: '/{{API_PATH}}',
-    method: 'put',
-    data: obj,
-  });
-}
+// {{FEATURE_TITLE}} 通用列表、新增、详情、删除、更新接口
+export const { fetchList, addObj, getObj, delObjs, putObj } = createCrudApi('/{{API_PATH}}');
 
 {{DICT_API_FUNCTIONS}}
 {{EXTRA_API_FUNCTIONS}}

package/assets/templates/single_table_jump/api.tpl

@@ -1,48 +1,7 @@
-// 请求工具
-import request from '/@/utils/request';
+// 通用 CRUD 接口工厂
+import { createCrudApi } from '/@/api/common/crudFactory';
+{{API_REQUEST_IMPORT}}
 
-// 查询分页列表
-export function fetchList(query?: object) {
-  return request({
-    url: '/{{API_PATH}}/page',
-    method: 'get',
-    params: query,
-  });
-}
-
-// 新增数据
-export function addObj(obj?: object) {
-  return request({
-    url: '/{{API_PATH}}',
-    method: 'post',
-    data: obj,
-  });
-}
-
-// 查询详情数据
-export function getObj(obj?: object) {
-  return request({
-    url: '/{{API_PATH}}/details',
-    method: 'get',
-    params: obj,
-  });
-}
-
-// 删除数据
-export function delObjs(ids?: object) {
-  return request({
-    url: '/{{API_PATH}}',
-    method: 'delete',
-    data: ids,
-  });
-}
-
-// 更新数据
-export function putObj(obj?: object) {
-  return request({
-    url: '/{{API_PATH}}',
-    method: 'put',
-    data: obj,
-  });
-}
+// {{FEATURE_TITLE}} 通用列表、新增、详情、删除、更新接口
+export const { fetchList, addObj, getObj, delObjs, putObj } = createCrudApi('/{{API_PATH}}');
 {{EXTRA_API_FUNCTIONS}}

package/assets/templates/single_table_jump/menu.sql.tpl

@@ -5,6 +5,10 @@
 insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
 values ({{MENU_BASE_ID}}, '-1', '/{{MENU_ROUTE_PATH}}/index', '', '0', 'icon-bangzhushouji', '0', null, '8', null, '{{TABLE_COMMENT}}管理', 1);
 
+-- Form route SQL for jump-based pages. Hidden from sidebar, used by list page add/edit/view navigation.
+insert into sys_menu (menu_id, parent_id, path, permission, menu_type, icon, visible, del_flag, create_time, sort_order, update_time, name, tenant_id)
+values ({{MENU_BASE_ID_PLUS_6}}, {{MENU_BASE_ID}}, '/{{MENU_ROUTE_PATH}}/form', '', '0', 'icon-biaodan', '0', '0', null, '9', null, '{{TABLE_COMMENT}}表单', 1);
+
 insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
 values ({{MENU_BASE_ID_PLUS_1}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_view', '1', null, '1', '0', null, '0', null, '{{TABLE_COMMENT}}查看', 1);
 
@@ -18,4 +22,4 @@ insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del
 values ({{MENU_BASE_ID_PLUS_4}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_del', '1', null, '1', '0', null, '3', null, '{{TABLE_COMMENT}}删除', 1);
 
 insert into sys_menu (menu_id, parent_id, permission, menu_type, path, icon, del_flag, create_time, sort_order, update_time, name, tenant_id)
-values ({{MENU_BASE_ID_PLUS_5}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_export', '1', null, '1', '0', null, '4', null, '导入导出', 1);
+values ({{MENU_BASE_ID_PLUS_5}}, {{MENU_BASE_ID}}, '{{PERMISSION_PREFIX}}_export', '1', null, '1', '0', null, '4', null, '导入导出', 1);

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.65';
+const SERVER_VERSION = '0.1.66';
 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');
@@ -146,10 +146,65 @@ export function createCrudSchema(
   }
 
   return buildSchema(masterOrDefinition as Record<string, FieldMeta>, children);
-}
-`;
-
-const TOOL_SCHEMA = {
+}
+`;
+
+const DEFAULT_CRUD_FACTORY_TEMPLATE = `import request from '/@/utils/request';
+
+export interface CrudApiPathOverrides {
+  page?: string;
+  save?: string;
+  detail?: string;
+  remove?: string;
+  update?: string;
+}
+
+const joinApiPath = (baseUrl: string, suffix: string) => {
+  const normalizedBase = String(baseUrl || '').replace(/\\/+$/, '');
+  const normalizedSuffix = String(suffix || '').replace(/^\\/+/, '');
+  return normalizedSuffix ? \`\${normalizedBase}/\${normalizedSuffix}\` : normalizedBase;
+};
+
+// 生成标准业务功能 CRUD 接口：分页、新增、详情、删除、更新。
+export const createCrudApi = (baseUrl: string, overrides: CrudApiPathOverrides = {}) => ({
+  fetchList: (query?: object) =>
+    request({
+      url: overrides.page || joinApiPath(baseUrl, 'page'),
+      method: 'get',
+      params: query,
+    }),
+
+  addObj: (obj?: object) =>
+    request({
+      url: overrides.save || joinApiPath(baseUrl, 'save'),
+      method: 'post',
+      data: obj,
+    }),
+
+  getObj: (obj?: object) =>
+    request({
+      url: overrides.detail || joinApiPath(baseUrl, 'getById'),
+      method: 'get',
+      params: obj,
+    }),
+
+  delObjs: (ids?: object) =>
+    request({
+      url: overrides.remove || joinApiPath(baseUrl, 'removeByIds'),
+      method: 'post',
+      data: ids,
+    }),
+
+  putObj: (obj?: object) =>
+    request({
+      url: overrides.update || joinApiPath(baseUrl, 'updateById'),
+      method: 'post',
+      data: obj,
+    }),
+});
+`;
+
+const TOOL_SCHEMA = {
   type: 'object',
   properties: {
     featureTitle: { type: 'string', description: 'Feature title from pre-parsed structured metadata.' },
@@ -340,11 +395,11 @@ const TOOL_SCHEMA = {
     },
     writeToDisk: { type: 'boolean', default: true, description: 'Whether to write generated files.' },
     overwrite: { type: 'boolean', default: true, description: 'Whether to overwrite existing files. If false, existing files are skipped.' },
-    writeSupportFiles: {
-      type: 'boolean',
-      default: true,
-      description: 'Whether to write project support files such as src/enums/dict-registry.ts and src/utils/crudSchema.ts.'
-    },
+    writeSupportFiles: {
+      type: 'boolean',
+      default: true,
+      description: 'Whether to write project support files such as src/enums/dict-registry.ts, src/utils/crudSchema.ts and src/api/common/crudFactory.ts.'
+    },
     mergeI18nZh: {
       type: 'boolean',
       default: true,
@@ -835,7 +890,7 @@ function prepareDictRegistry(frontendPath, dictTypes) {
   };
 }
 
-function ensureCrudSchemaSupportFile(frontendPath) {
+function ensureCrudSchemaSupportFile(frontendPath) {
   const schemaPath = path.join(frontendPath, 'src', 'utils', 'crudSchema.ts');
   const exists = fs.existsSync(schemaPath);
   const currentContent = exists ? readUtf8File(schemaPath) : '';
@@ -852,12 +907,27 @@ function ensureCrudSchemaSupportFile(frontendPath) {
     exists,
     isCompatible: hasCoreShape && supportsLabelKey,
     needsWrite: !exists || shouldUpgradeLegacy,
-  };
-}
-
-function ensureDirectory(filePath) {
-  fs.mkdirSync(path.dirname(filePath), { recursive: true });
-}
+  };
+}
+
+function ensureCrudFactorySupportFile(frontendPath) {
+  const factoryPath = path.join(frontendPath, 'src', 'api', 'common', 'crudFactory.ts');
+  const exists = fs.existsSync(factoryPath);
+  const currentContent = exists ? readUtf8File(factoryPath) : '';
+  const isCompatible = !exists || currentContent.includes('export const createCrudApi');
+
+  return {
+    path: factoryPath,
+    content: DEFAULT_CRUD_FACTORY_TEMPLATE,
+    exists,
+    isCompatible,
+    needsWrite: !exists,
+  };
+}
+
+function ensureDirectory(filePath) {
+  fs.mkdirSync(path.dirname(filePath), { recursive: true });
+}
 
 function writeSupportFile(filePath, content) {
   ensureDirectory(filePath);
@@ -880,30 +950,52 @@ function prepareSharedSupport(frontendPath, dictTypes, writeSupportFiles) {
   const normalizedDictTypes = [...new Set((dictTypes || []).filter(Boolean))];
   const dictRegistry = writeSupportFiles ? prepareDictRegistry(frontendPath, normalizedDictTypes) : buildVirtualDictRegistry(normalizedDictTypes);
   const crudSchemaPath = path.join(frontendPath, 'src', 'utils', 'crudSchema.ts');
-  const crudSchema = writeSupportFiles
-    ? ensureCrudSchemaSupportFile(frontendPath)
-    : {
-        path: crudSchemaPath,
+  const crudSchema = writeSupportFiles
+    ? ensureCrudSchemaSupportFile(frontendPath)
+    : {
+        path: crudSchemaPath,
         content: DEFAULT_CRUD_SCHEMA_TEMPLATE,
         exists: fs.existsSync(crudSchemaPath),
         isCompatible: true,
-        needsWrite: false,
-        writeEnabled: false,
-      };
-  return {
-    dictRegistry,
-    crudSchema,
-    writeEnabled: Boolean(writeSupportFiles),
-  };
-}
+        needsWrite: false,
+        writeEnabled: false,
+      };
+  const crudFactoryPath = path.join(frontendPath, 'src', 'api', 'common', 'crudFactory.ts');
+  const crudFactory = writeSupportFiles
+    ? ensureCrudFactorySupportFile(frontendPath)
+    : {
+        path: crudFactoryPath,
+        content: DEFAULT_CRUD_FACTORY_TEMPLATE,
+        exists: fs.existsSync(crudFactoryPath),
+        isCompatible: true,
+        needsWrite: false,
+        writeEnabled: false,
+      };
+  return {
+    dictRegistry,
+    crudSchema,
+    crudFactory,
+    writeEnabled: Boolean(writeSupportFiles),
+  };
+}
 
 function maybeWriteSharedSupport(sharedSupport, writeToDisk) {
   if (!writeToDisk || !sharedSupport.writeEnabled) return;
 
-  if (sharedSupport.crudSchema.needsWrite) {
-    writeSupportFile(sharedSupport.crudSchema.path, sharedSupport.crudSchema.content);
-  }
-
+  if (sharedSupport.crudSchema.needsWrite) {
+    writeSupportFile(sharedSupport.crudSchema.path, sharedSupport.crudSchema.content);
+  }
+
+  if (sharedSupport.crudFactory.needsWrite) {
+    if (!sharedSupport.crudFactory.isCompatible) {
+      throw new Error(
+        'Detected an existing src/api/common/crudFactory.ts that MCP could not merge safely. ' +
+          'Please align the createCrudApi export manually before enabling writeSupportFiles.'
+      );
+    }
+    writeSupportFile(sharedSupport.crudFactory.path, sharedSupport.crudFactory.content);
+  }
+
   if (sharedSupport.dictRegistry.needsWrite) {
     if (!sharedSupport.dictRegistry.isCompatible) {
       throw new Error(
@@ -918,11 +1010,11 @@ function maybeWriteSharedSupport(sharedSupport, writeToDisk) {
 function buildSupportNote(sharedSupport, localeZhSupport) {
   const notes = [];
 
-  if (!sharedSupport.writeEnabled) {
-    notes.push(
-      'Shared support file writing is disabled. Generated code still references src/utils/crudSchema.ts and may reference src/enums/dict-registry.ts, so those helpers must already exist in the target project.'
-    );
-  }
+  if (!sharedSupport.writeEnabled) {
+    notes.push(
+      'Shared support file writing is disabled. Generated code still references src/utils/crudSchema.ts, src/api/common/crudFactory.ts and may reference src/enums/dict-registry.ts, so those helpers must already exist in the target project.'
+    );
+  }
 
   if (sharedSupport.crudSchema.exists && !sharedSupport.crudSchema.isCompatible) {
     notes.push(
@@ -931,6 +1023,13 @@ function buildSupportNote(sharedSupport, localeZhSupport) {
     );
   }
 
+  if (sharedSupport.crudFactory.exists && !sharedSupport.crudFactory.isCompatible) {
+    notes.push(
+      'Detected an existing src/api/common/crudFactory.ts that does not export createCrudApi. ' +
+        'MCP preserved the existing file and did not overwrite it. Generated API modules now depend on that file being manually aligned.'
+    );
+  }
+
   if (sharedSupport.dictRegistry.exists && !sharedSupport.dictRegistry.isCompatible) {
     notes.push(
       'Detected an existing src/enums/dict-registry.ts that MCP could not merge safely. ' +
@@ -3226,6 +3325,38 @@ function renderExtraApiFunctions(model) {
     .join('\n');
 }
 
+function renderApiRequestImport(model) {
+  const hasExtraApis = Array.isArray(model.extraApis) && model.extraApis.length > 0;
+  const hasDictStatusApis = model.pageType === 'dict' && !!model.statusField;
+  return hasExtraApis || hasDictStatusApis ? "import request from '/@/utils/request';" : '';
+}
+
+function renderExtraApiFunctionsV2(model) {
+  if (!Array.isArray(model.extraApis) || !model.extraApis.length) return '';
+  return model.extraApis
+    .map((api) => {
+      const requestField = api.requestType === 'data' ? 'data' : 'params';
+      const lines = ['', `// 额外接口：${sanitizeComment(api.description)}`];
+      if (api.usedBy) {
+        lines.push(`// 使用场景：${sanitizeComment(api.usedBy)}`);
+      }
+      if (api.source) {
+        lines.push(`// 来源说明：${sanitizeComment(api.source)}`);
+      }
+      lines.push(
+        `export function ${api.functionName}(payload?: any) {`,
+        '  return request({',
+        `    url: '${api.url}',`,
+        `    method: '${api.method}',`,
+        `    ${requestField}: payload,`,
+        '  });',
+        '}'
+      );
+      return lines.join('\n');
+    })
+    .join('\n');
+}
+
 function buildReplacements(model, sharedSupport) {
   const menuBaseId = Date.now();
   const apiModulePath = model.targetApiModule || `${model.moduleName}/${model.functionName}`;
@@ -3256,16 +3387,18 @@ function buildReplacements(model, sharedSupport) {
     BUSINESS_STATUS_IMPORTS: renderBusinessStatusImports(model),
     BUSINESS_EDIT_IF: hasBusinessBillStateEditControl(model) ? ' v-if="showEditAction(row)"' : '',
     BUSINESS_STATUS_HELPERS: renderBusinessStatusHelpers(model),
-    EXTRA_API_FUNCTIONS: renderExtraApiFunctions(model),
+    API_REQUEST_IMPORT: renderApiRequestImport(model),
+    EXTRA_API_FUNCTIONS: renderExtraApiFunctionsV2(model),
     CUSTOM_QUERY_FIELDS_EXPR: model.pageType === 'dict' ? '[]' : 'queryableDictOptions.value',
     SHOW_RIGHT_TOOLS: model.pageType === 'dict' ? 'false' : 'true',
     MENU_BASE_ID: menuBaseId,
     MENU_BASE_ID_PLUS_1: menuBaseId + 1,
     MENU_BASE_ID_PLUS_2: menuBaseId + 2,
-    MENU_BASE_ID_PLUS_3: menuBaseId + 3,
-      MENU_BASE_ID_PLUS_4: menuBaseId + 4,
-      MENU_BASE_ID_PLUS_5: menuBaseId + 5,
-      GENERATED_AT: new Date().toISOString(),
+    MENU_BASE_ID_PLUS_3: menuBaseId + 3,
+      MENU_BASE_ID_PLUS_4: menuBaseId + 4,
+      MENU_BASE_ID_PLUS_5: menuBaseId + 5,
+      MENU_BASE_ID_PLUS_6: menuBaseId + 6,
+      GENERATED_AT: new Date().toISOString(),
       FORM_FIELDS: model.visibleFields.map(renderFormFieldV2).join('\n'),
       TABLE_COLUMNS: model.gridFields.map((field) => renderTableColumn(field, dictRegistryRefs)).join('\n'),
       FORM_DEFAULTS: renderFormDefaults(model),

package/package.json

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