worsoft-frontend-codegen-local-mcp 0.1.77 → 0.1.79

package/assets/templates/master_child_jump/api.tpl

@@ -2,6 +2,6 @@
 import { createCrudApi } from '/@/api/common/crudFactory';
 {{API_REQUEST_IMPORT}}
 
-// {{FEATURE_TITLE}} 通用列表、新增、详情、删除、更新接口
-export const { fetchList, addObj, getObj, delObjs, putObj } = createCrudApi('/{{API_PATH}}');
+// {{FEATURE_TITLE}} 通用列表、新增、详情、删除、更新、导出接口
+export const { fetchList, addObj, getObj, delObjs, putObj, exportObj } = createCrudApi('/{{API_PATH}}');
 {{EXTRA_API_FUNCTIONS}}

package/assets/templates/single_table_dialog/api.tpl

@@ -2,8 +2,8 @@
 import { createCrudApi } from '/@/api/common/crudFactory';
 {{API_REQUEST_IMPORT}}
 
-// {{FEATURE_TITLE}} 通用列表、新增、详情、删除、更新接口
-export const { fetchList, addObj, getObj, delObjs, putObj } = createCrudApi('/{{API_PATH}}');
+// {{FEATURE_TITLE}} 通用列表、新增、详情、删除、更新、导出接口
+export const { fetchList, addObj, getObj, delObjs, putObj, exportObj } = createCrudApi('/{{API_PATH}}');
 
 {{DICT_API_FUNCTIONS}}
 {{EXTRA_API_FUNCTIONS}}

package/assets/templates/single_table_jump/api.tpl

@@ -2,6 +2,6 @@
 import { createCrudApi } from '/@/api/common/crudFactory';
 {{API_REQUEST_IMPORT}}
 
-// {{FEATURE_TITLE}} 通用列表、新增、详情、删除、更新接口
-export const { fetchList, addObj, getObj, delObjs, putObj } = createCrudApi('/{{API_PATH}}');
+// {{FEATURE_TITLE}} 通用列表、新增、详情、删除、更新、导出接口
+export const { fetchList, addObj, getObj, delObjs, putObj, exportObj } = createCrudApi('/{{API_PATH}}');
 {{EXTRA_API_FUNCTIONS}}

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.77';
+const SERVER_VERSION = '0.1.79';
 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');
@@ -151,13 +151,14 @@ export function createCrudSchema(
 
 const DEFAULT_CRUD_FACTORY_TEMPLATE = `import request from '/@/utils/request';
 
-export interface CrudApiPathOverrides {
-  page?: string;
-  save?: string;
-  detail?: string;
-  remove?: string;
-  update?: string;
-}
+export interface CrudApiPathOverrides {
+  page?: string;
+  save?: string;
+  detail?: string;
+  remove?: string;
+  update?: string;
+  export?: string;
+}
 
 const joinApiPath = (baseUrl: string, suffix: string) => {
   const normalizedBase = String(baseUrl || '').replace(/\\/+$/, '');
@@ -165,8 +166,8 @@ const joinApiPath = (baseUrl: string, suffix: string) => {
   return normalizedSuffix ? \`\${normalizedBase}/\${normalizedSuffix}\` : normalizedBase;
 };
 
-// 生成标准业务功能 CRUD 接口：分页、新增、详情、删除、更新。
-export const createCrudApi = (baseUrl: string, overrides: CrudApiPathOverrides = {}) => ({
+// 生成标准业务功能 CRUD 接口：分页、新增、详情、删除、更新、导出。
+export const createCrudApi = (baseUrl: string, overrides: CrudApiPathOverrides = {}) => ({
   fetchList: (query?: object) =>
     request({
       url: overrides.page || joinApiPath(baseUrl, 'page'),
@@ -195,14 +196,22 @@ export const createCrudApi = (baseUrl: string, overrides: CrudApiPathOverrides =
       data: ids,
     }),
 
-  putObj: (obj?: object) =>
-    request({
-      url: overrides.update || joinApiPath(baseUrl, 'updateById'),
-      method: 'post',
-      data: obj,
-    }),
-});
-`;
+  putObj: (obj?: object) =>
+    request({
+      url: overrides.update || joinApiPath(baseUrl, 'updateById'),
+      method: 'post',
+      data: obj,
+    }),
+
+  exportObj: (query?: object) =>
+    request({
+      url: overrides.export || joinApiPath(baseUrl, 'export'),
+      method: 'get',
+      params: query,
+      responseType: 'blob',
+    }),
+});
+`;
 
 const DEFAULT_CLOSE_CURRENT_PAGE_TEMPLATE = `import type { RouteLocationNormalizedLoaded } from 'vue-router';
 import { useRoute } from 'vue-router';
@@ -925,20 +934,29 @@ function ensureCrudSchemaSupportFile(frontendPath) {
   };
 }
 
-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 ensureCrudFactorySupportFile(frontendPath) {
+  const factoryPath = path.join(frontendPath, 'src', 'api', 'common', 'crudFactory.ts');
+  const exists = fs.existsSync(factoryPath);
+  const currentContent = exists ? readUtf8File(factoryPath) : '';
+  const hasCoreShape =
+    currentContent.includes('export const createCrudApi') &&
+    currentContent.includes('fetchList') &&
+    currentContent.includes('addObj') &&
+    currentContent.includes('getObj') &&
+    currentContent.includes('delObjs') &&
+    currentContent.includes('putObj');
+  const supportsExportObj = currentContent.includes('exportObj');
+  const shouldUpgradeLegacy = exists && hasCoreShape && !supportsExportObj;
+  const isCompatible = !exists || (hasCoreShape && supportsExportObj) || shouldUpgradeLegacy;
+
+  return {
+    path: factoryPath,
+    content: DEFAULT_CRUD_FACTORY_TEMPLATE,
+    exists,
+    isCompatible,
+    needsWrite: !exists || shouldUpgradeLegacy,
+  };
+}
 
 function ensureCloseCurrentPageSupportFile(frontendPath) {
   const hookPath = path.join(frontendPath, 'src', 'hooks', 'useCloseCurrentPage.ts');
@@ -1057,11 +1075,11 @@ function maybeWriteSharedSupport(sharedSupport, writeToDisk) {
 
   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.'
-      );
-    }
+      throw new Error(
+        'Detected an existing src/api/common/crudFactory.ts that MCP could not merge safely. ' +
+          'Please align the createCrudApi/exportObj helper shape manually before enabling writeSupportFiles.'
+      );
+    }
     writeSupportFile(sharedSupport.crudFactory.path, sharedSupport.crudFactory.content);
   }
 
@@ -1112,12 +1130,12 @@ 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.crudFactory.exists && !sharedSupport.crudFactory.isCompatible) {
+    notes.push(
+      'Detected an existing src/api/common/crudFactory.ts that does not match the expected createCrudApi/exportObj helper shape. ' +
+        '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(
@@ -1350,9 +1368,8 @@ 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 positive integer when provided, or 0/empty when unspecified`);
-  }
-  if (order === 0) return undefined;
+    throw new Error(`${label} must be a non-negative integer when provided, or empty when unspecified`);
+  }
   return order;
 }
 
@@ -2510,14 +2527,15 @@ function renderMultiLevelOptionsTs(model, dictRegistryRefs) {
     ].join('\n');
   }
 
-function renderMultiLevelApiFunctions(moduleModel) {
-  const pkAttr = moduleModel.pk.attrName;
-  const basePath = buildApiRoutePath(moduleModel.moduleName, moduleModel.apiPath);
-  const enablePath = buildApiRoutePath(moduleModel.moduleName, moduleModel.enableApi);
-  const disablePath = buildApiRoutePath(moduleModel.moduleName, moduleModel.disableApi);
-    return [
-      `// 查询${moduleModel.title}分页列表`,
-      `export function fetch${moduleModel.className}List(query?: any) {`,
+function renderMultiLevelApiFunctions(moduleModel) {
+  const pkAttr = moduleModel.pk.attrName;
+  const basePath = buildApiRoutePath(moduleModel.moduleName, moduleModel.apiPath);
+  const enablePath = buildApiRoutePath(moduleModel.moduleName, moduleModel.enableApi);
+  const disablePath = buildApiRoutePath(moduleModel.moduleName, moduleModel.disableApi);
+  const title = moduleModel.tableComment || moduleModel.tableName || moduleModel.className;
+    return [
+      `// 查询${title}分页列表`,
+      `export function fetch${moduleModel.className}List(query?: any) {`,
     '  return request({',
     `    url: '${basePath}/page',`,
     "    method: 'get',",
@@ -2525,7 +2543,7 @@ function renderMultiLevelApiFunctions(moduleModel) {
     '  });',
       '}',
       '',
-      `// 查询${moduleModel.title}详情`,
+      `// 查询${title}详情`,
       `export function get${moduleModel.className}Obj(id: string | number) {`,
     '  return request({',
     `    url: '${basePath}/getById',`,
@@ -2534,7 +2552,7 @@ function renderMultiLevelApiFunctions(moduleModel) {
     '  });',
       '}',
       '',
-      `// 新增${moduleModel.title}`,
+      `// 新增${title}`,
       `export function add${moduleModel.className}Obj(data: any) {`,
     '  return request({',
     `    url: '${basePath}/save',`,
@@ -2543,7 +2561,7 @@ function renderMultiLevelApiFunctions(moduleModel) {
     '  });',
       '}',
       '',
-      `// 更新${moduleModel.title}`,
+      `// 更新${title}`,
       `export function put${moduleModel.className}Obj(data: any) {`,
     '  return request({',
     `    url: '${basePath}/updateById',`,
@@ -2552,17 +2570,27 @@ function renderMultiLevelApiFunctions(moduleModel) {
     '  });',
       '}',
       '',
-      `// 删除${moduleModel.title}`,
-      `export function del${moduleModel.className}Objs(data: Array<string | number>) {`,
-    '  return request({',
-    `    url: '${basePath}/removeByIds',`,
-    "    method: 'post',",
-    '    data,',
-    '  });',
-      '}',
-      '',
-      `// 启用${moduleModel.title}`,
-      `export function enable${moduleModel.className}(id: string | number) {`,
+      `// 删除${title}`,
+      `export function del${moduleModel.className}Objs(data: Array<string | number>) {`,
+    '  return request({',
+    `    url: '${basePath}/removeByIds',`,
+    "    method: 'post',",
+    '    data,',
+    '  });',
+      '}',
+      '',
+      `// 导出${title}`,
+      `export function export${moduleModel.className}Obj(query?: any) {`,
+    '  return request({',
+    `    url: '${basePath}/export',`,
+    "    method: 'get',",
+    '    params: query,',
+    "    responseType: 'blob',",
+    '  });',
+      '}',
+      '',
+      `// 启用${title}`,
+      `export function enable${moduleModel.className}(id: string | number) {`,
     '  return request({',
     `    url: '${enablePath}',`,
     "    method: 'post',",
@@ -2570,7 +2598,7 @@ function renderMultiLevelApiFunctions(moduleModel) {
     '  });',
       '}',
       '',
-      `// 禁用${moduleModel.title}`,
+      `// 禁用${title}`,
       `export function disable${moduleModel.className}(id: string | number) {`,
     '  return request({',
     `    url: '${disablePath}',`,

package/package.json

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