@lark-apaas/fullstack-cli 1.1.6-alpha.8 → 1.1.6-alpha.9

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-cli",
-  "version": "1.1.6-alpha.8",
+  "version": "1.1.6-alpha.9",
   "description": "CLI tool for fullstack template management",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,9 @@
     "bin"
   ],
   "scripts": {
-    "build": "tsc",
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -30,13 +32,20 @@
   },
   "dependencies": {
     "@lark-apaas/devtool-kits": "^1.2.10",
+    "@lark-apaas/http-client": "0.1.2",
     "@vercel/nft": "^0.30.3",
-    "cac": "^6.7.14",
+    "commander": "^13.0.0",
     "dotenv": "^16.0.0",
-    "drizzle-kit": "0.31.5"
+    "drizzle-kit": "0.31.5",
+    "zod-to-json-schema": "^3.24.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.9.2",
+    "vitest": "^2.1.8"
+  },
+  "peerDependencies": {
     "typescript": "^5.9.2"
   }
 }

package/templates/nest-cli.json

@@ -0,0 +1,25 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "server",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "tsConfigPath": "tsconfig.node.json",
+    "assets": [
+      {
+        "include": "capabilities/**/*.json",
+        "outDir": "dist/server",
+        "watchAssets": true
+      }
+    ],
+    "plugins": [
+      {
+        "name": "@nestjs/swagger",
+        "options": {
+          "introspectComments": true,
+          "classValidatorShim": true
+        }
+      }
+    ]
+  }
+}

package/templates/scripts/build.sh

@@ -19,21 +19,28 @@ print_time() {
 }
 
 # ==================== 步骤 0 ====================
-echo "📝 [0/4] 更新 openapi 代码"
+echo "🗑️  [0/5] 安装插件"
 STEP_START=$(node -e "console.log(Date.now())")
-npm run gen:openapi
+npx fullstack-cli action-plugin init
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 1 ====================
-echo "🗑️  [1/4] 清理 dist 目录"
+echo "📝 [1/5] 更新 openapi 代码"
 STEP_START=$(node -e "console.log(Date.now())")
-rm -rf "$ROOT_DIR/dist"
+npm run gen:openapi
 print_time $STEP_START
 echo ""
 
 # ==================== 步骤 2 ====================
-echo "🔨 [2/4] 并行构建 server 和 client"
+echo "🗑️  [2/5] 清理 dist 目录"
+STEP_START=$(node -e "console.log(Date.now())")
+rm -rf "$ROOT_DIR/dist"
+print_time $STEP_START
+echo ""
+
+# ==================== 步骤 3 ====================
+echo "🔨 [3/5] 并行构建 server 和 client"
 STEP_START=$(node -e "console.log(Date.now())")
 
 # 并行构建
@@ -70,8 +77,8 @@ echo "   ✅ Client 构建完成"
 print_time $STEP_START
 echo ""
 
-# ==================== 步骤 3 ====================
-echo "📦 [3/4] 准备 server 依赖产物"
+# ==================== 步骤 4 ====================
+echo "📦 [4/5] 准备 server 依赖产物"
 STEP_START=$(node -e "console.log(Date.now())")
 
 mkdir -p "$OUT_DIR/dist/client"
@@ -89,8 +96,8 @@ rm -rf "$ROOT_DIR/dist/tsconfig.node.tsbuildinfo"
 print_time $STEP_START
 echo ""
 
-# ==================== 步骤 4 ====================
-echo "✂️  [4/4] 智能依赖裁剪"
+# ==================== 步骤 5 ====================
+echo "✂️  [5/5] 智能依赖裁剪"
 STEP_START=$(node -e "console.log(Date.now())")
 
 # 分析实际依赖、复制并裁剪 node_modules、生成精简的 package.json

package/templates/scripts/dev.sh

@@ -36,6 +36,15 @@ split_logs() {
 LOG_DIR=${LOG_DIR:-logs}
 mkdir -p "${LOG_DIR}"
 
+# Initialize action plugins before starting dev servers (non-blocking)
+echo "🔌 Initializing action plugins..."
+if npx fullstack-cli action-plugin init; then
+  echo "✅ Action plugins initialized"
+else
+  echo "⚠️  Action plugin initialization failed, continuing anyway..."
+fi
+echo ""
+
 concurrently -p "[{time}] [{name}]" -t "yyyy-MM-dd HH:mm:ss" -n "server,client" -c "blue,green" \
   "npm run dev:server" \
   "npm run dev:client" 2>&1 | split_logs "${LOG_DIR}"

package/templates/scripts/prune-smart.js

@@ -178,9 +178,41 @@ async function smartPrune() {
     }
   }
 
-  console.log(`📦 实际需要 ${requiredPackages.size} 个 npm 包\n`);
+  console.log(`📦 静态分析需要 ${requiredPackages.size} 个 npm 包`);
 
-  // 4. 选择性复制包（只复制需要的）
+  // 4. 处理 actionPlugins（动态加载的插件，无法被静态分析追踪）
+  const originalPackage = JSON.parse(fs.readFileSync(ROOT_PACKAGE_JSON, 'utf8'));
+  const actionPlugins = originalPackage.actionPlugins || {};
+  const actionPluginNames = Object.keys(actionPlugins);
+
+  if (actionPluginNames.length > 0) {
+    console.log(`🔌 发现 ${actionPluginNames.length} 个 Action 插件，添加到依赖列表...`);
+
+    for (const pluginName of actionPluginNames) {
+      requiredPackages.add(pluginName);
+
+      // 检查插件的 peerDependencies，也添加进去
+      const pluginPkgPath = path.join(ROOT_NODE_MODULES, pluginName, 'package.json');
+      if (fs.existsSync(pluginPkgPath)) {
+        try {
+          const pluginPkg = JSON.parse(fs.readFileSync(pluginPkgPath, 'utf8'));
+          if (pluginPkg.peerDependencies) {
+            for (const peerDep of Object.keys(pluginPkg.peerDependencies)) {
+              requiredPackages.add(peerDep);
+            }
+          }
+        } catch {
+          // 忽略解析错误
+        }
+      }
+    }
+
+    console.log(`   ✅ 插件: ${actionPluginNames.join(', ')}`);
+  }
+
+  console.log(`📦 总共需要 ${requiredPackages.size} 个 npm 包\n`);
+
+  // 5. 选择性复制包（只复制需要的）
   console.log('📋 选择性复制 node_modules（仅复制需要的包）...');
   const copyStart = Date.now();
 
@@ -192,16 +224,15 @@ async function smartPrune() {
   console.log(`   成功: ${copiedCount.success} 个包，失败: ${copiedCount.failed} 个`);
   console.log(`   硬链接: ${fileStats.hardLinks} 个文件，复制: ${fileStats.copies} 个文件\n`);
 
-  // 5. 读取原始 package.json 并生成精简版本
-  const originalPackage = JSON.parse(fs.readFileSync(ROOT_PACKAGE_JSON, 'utf8'));
-
+  // 6. 生成精简版 package.json
   // 优化：直接构建 dependencies，避免多次对象展开
   const prunedDependencies = {};
   const allDeps = originalPackage.dependencies || {};
   const allDevDeps = originalPackage.devDependencies || {};
 
   for (const pkg of requiredPackages) {
-    const version = allDeps[pkg] || allDevDeps[pkg];
+    // 优先从 dependencies/devDependencies 获取版本，其次从 actionPlugins 获取
+    const version = allDeps[pkg] || allDevDeps[pkg] || actionPlugins[pkg];
     if (version) {
       prunedDependencies[pkg] = version;
     }
@@ -222,11 +253,14 @@ async function smartPrune() {
 
   const totalElapsed = Date.now() - totalStartTime;
 
-  // 6. 输出统计信息
+  // 7. 输出统计信息
   console.log('='.repeat(60));
   console.log('📊 智能裁剪统计:');
   console.log('='.repeat(60));
   console.log(`  需要的包数量:   ${requiredPackages.size}`);
+  if (actionPluginNames.length > 0) {
+    console.log(`  Action 插件:    ${actionPluginNames.length} 个`);
+  }
   console.log(`  成功复制:       ${copiedCount.success} 个包`);
   console.log(`  失败:           ${copiedCount.failed} 个包`);
   console.log(`  硬链接文件:     ${fileStats.hardLinks} 个`);

package/dist/commands/gen-db-schema.d.ts

@@ -1,20 +0,0 @@
-/**
- * 生成数据库 schema
- *
- * 命令行选项：
- * - --output <path>: schema 输出路径，默认 'server/database/schema.ts'
- * - --schema-filter <schemas>: schema 过滤器，逗号分隔
- * - --tables-filter <tables>: 表过滤器，逗号分隔，默认 '*'
- *
- * 环境变量配置：
- * - SUDA_DATABASE_URL: 数据库连接 URL（必需）
- * - DB_SCHEMA_OUTPUT: schema 输出路径（命令行选项优先）
- * - DRIZZLE_SCHEMA_FILTER: schema 过滤器（命令行选项优先）
- * - DRIZZLE_TABLES_FILTER: 表过滤器（命令行选项优先）
- */
-export declare function run(options?: {
-    enableNestModuleGenerate?: boolean;
-    output?: string;
-    schemaFilter?: string;
-    tablesFilter?: string;
-}): Promise<void>;

package/dist/commands/gen-db-schema.js

@@ -1,115 +0,0 @@
-import path from 'node:path';
-import fs from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { spawnSync } from 'node:child_process';
-import { createRequire } from 'node:module';
-// 加载 .env 配置
-import { config as loadEnv } from 'dotenv';
-// 创建 require 函数来加载 CommonJS 模块
-const require = createRequire(import.meta.url);
-/**
- * 生成数据库 schema
- *
- * 命令行选项：
- * - --output <path>: schema 输出路径，默认 'server/database/schema.ts'
- * - --schema-filter <schemas>: schema 过滤器，逗号分隔
- * - --tables-filter <tables>: 表过滤器，逗号分隔，默认 '*'
- *
- * 环境变量配置：
- * - SUDA_DATABASE_URL: 数据库连接 URL（必需）
- * - DB_SCHEMA_OUTPUT: schema 输出路径（命令行选项优先）
- * - DRIZZLE_SCHEMA_FILTER: schema 过滤器（命令行选项优先）
- * - DRIZZLE_TABLES_FILTER: 表过滤器（命令行选项优先）
- */
-export async function run(options = {}) {
-    // 加载用户项目的 .env 文件
-    let exitCode = 0;
-    const envPath = path.resolve(process.cwd(), '.env');
-    if (fs.existsSync(envPath)) {
-        loadEnv({ path: envPath });
-        console.log('[gen-db-schema] ✓ Loaded .env file');
-    }
-    const databaseUrl = process.env.SUDA_DATABASE_URL;
-    if (!databaseUrl) {
-        console.error('[gen-db-schema] Error: SUDA_DATABASE_URL environment variable is required');
-        process.exit(1);
-    }
-    // 命令行选项优先于环境变量
-    const outputPath = options.output || process.env.DB_SCHEMA_OUTPUT || 'server/database/schema.ts';
-    const OUT_DIR = path.resolve(process.cwd(), 'server/database/.introspect');
-    const SCHEMA_FILE = path.resolve(process.cwd(), outputPath);
-    console.log('[gen-db-schema] Starting...');
-    // 获取当前文件所在目录（ESM 方式）
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = path.dirname(__filename);
-    // 使用 CLI 内部的 drizzle 配置
-    const cliRoot = path.resolve(__dirname, '../');
-    const configPath = path.join(cliRoot, 'config', 'drizzle.config.js');
-    if (!fs.existsSync(configPath)) {
-        console.error('[gen-db-schema] Error: drizzle config not found in CLI package');
-        process.exit(1);
-    }
-    try {
-        // 通过环境变量传递绝对路径给配置文件
-        const env = {
-            ...process.env,
-            __DRIZZLE_OUT_DIR__: OUT_DIR,
-            __DRIZZLE_SCHEMA_PATH__: SCHEMA_FILE,
-        };
-        // 执行 drizzle-kit introspect
-        const args = process.argv.slice(3).filter((arg) => !arg.startsWith('--enable-nest-module-generate'));
-        const spawnArgs = ['--yes', 'drizzle-kit', 'introspect', '--config', configPath, ...args];
-        const result = spawnSync('npx', spawnArgs, { stdio: 'inherit', env });
-        if (result.error) {
-            console.error('[gen-db-schema] Execution failed:', result.error);
-            throw result.error;
-        }
-        if ((result.status ?? 0) !== 0) {
-            throw new Error(`drizzle-kit introspect failed with status ${result.status}`);
-        }
-        // 复制生成的 schema
-        const generatedSchema = path.join(OUT_DIR, 'schema.ts');
-        if (!fs.existsSync(generatedSchema)) {
-            console.error('[gen-db-schema] schema.ts not generated');
-            throw new Error('drizzle-kit introspect failed to generate schema.ts');
-        }
-        fs.mkdirSync(path.dirname(SCHEMA_FILE), { recursive: true });
-        fs.copyFileSync(generatedSchema, SCHEMA_FILE);
-        console.log(`[gen-db-schema] ✓ Copied to ${outputPath}`);
-        // 后处理 schema（使用 CommonJS require 方式加载）
-        const { postprocessDrizzleSchema } = require('@lark-apaas/devtool-kits');
-        const stats = postprocessDrizzleSchema(SCHEMA_FILE);
-        if (stats?.unmatchedUnknown?.length) {
-            console.warn('[gen-db-schema] Unmatched custom types detected:', stats.unmatchedUnknown);
-        }
-        console.log('[gen-db-schema] ✓ Postprocessed schema');
-        try {
-            if (options.enableNestModuleGenerate) {
-                const { parseAndGenerateNestResourceTemplate } = require('@lark-apaas/devtool-kits');
-                const tsConfigFilePath = path.resolve(process.cwd(), 'tsconfig.json');
-                const schemaFilePath = SCHEMA_FILE;
-                await parseAndGenerateNestResourceTemplate({
-                    tsConfigFilePath,
-                    schemaFilePath,
-                    moduleOutputDir: path.resolve(process.cwd(), 'server/modules'),
-                });
-                console.log('[gen-db-schema] ✓ Generate NestJS Module Boilerplate Successfully');
-            }
-        }
-        catch (error) {
-            console.warn('[gen-db-schema] Generate NestJS Module Boilerplate failed:', error instanceof Error ? error.message : String(error));
-        }
-        console.log('[gen-db-schema] ✓ Complete');
-    }
-    catch (err) {
-        console.error('[gen-db-schema] Failed:', err instanceof Error ? err.message : String(err));
-        exitCode = 1;
-    }
-    finally {
-        // 清理临时文件
-        if (fs.existsSync(OUT_DIR)) {
-            fs.rmSync(OUT_DIR, { recursive: true, force: true });
-        }
-        process.exit(exitCode);
-    }
-}

package/dist/commands/sync.d.ts

@@ -1,6 +0,0 @@
-/**
- * 同步模板文件到用户项目
- */
-export declare function run(options: {
-    disableGenOpenapi?: boolean;
-}): Promise<void>;

package/dist/commands/sync.js

@@ -1,204 +0,0 @@
-import path from 'node:path';
-import fs from 'node:fs';
-import { fileURLToPath } from 'node:url';
-import { genSyncConfig } from '../config/sync.js';
-/**
- * 同步模板文件到用户项目
- */
-export async function run(options) {
-    // 检测是否在用户项目中（通过 INIT_CWD 判断）
-    const userProjectRoot = process.env.INIT_CWD || process.cwd();
-    // 获取插件根目录
-    const __filename = fileURLToPath(import.meta.url);
-    const __dirname = path.dirname(__filename);
-    const pluginRoot = path.resolve(__dirname, '../..');
-    // 只有在插件自己的开发目录中才跳过（避免在开发插件时触发 sync）
-    if (userProjectRoot === pluginRoot) {
-        console.log('[fullstack-cli] Skip syncing (installing plugin itself)');
-        process.exit(0);
-    }
-    // 检查是否存在 package.json，确保是有效的项目
-    const userPackageJson = path.join(userProjectRoot, 'package.json');
-    if (!fs.existsSync(userPackageJson)) {
-        console.log('[fullstack-cli] Skip syncing (not a valid npm project)');
-        process.exit(0);
-    }
-    try {
-        console.log('[fullstack-cli] Starting sync...');
-        // 使用配置
-        const config = genSyncConfig({
-            disableGenOpenapi: options.disableGenOpenapi ?? false,
-        });
-        if (!config || !config.sync) {
-            console.warn('[fullstack-cli] No sync configuration found');
-            process.exit(0);
-        }
-        // 执行同步规则
-        for (const rule of config.sync) {
-            await syncRule(rule, pluginRoot, userProjectRoot);
-        }
-        // 设置权限
-        if (config.permissions) {
-            setPermissions(config.permissions, userProjectRoot);
-        }
-        console.log('[fullstack-cli] Sync completed successfully ✅');
-    }
-    catch (error) {
-        const message = error instanceof Error ? error.message : String(error);
-        console.error('[fullstack-cli] Failed to sync:', message);
-        process.exit(1);
-    }
-}
-/**
- * 执行单个同步规则
- */
-async function syncRule(rule, pluginRoot, userProjectRoot) {
-    // 处理删除操作（只需要 to 路径）
-    if (rule.type === 'delete-file' || rule.type === 'delete-directory') {
-        const destPath = path.join(userProjectRoot, rule.to);
-        if (rule.type === 'delete-file') {
-            deleteFile(destPath);
-        }
-        else {
-            deleteDirectory(destPath);
-        }
-        return;
-    }
-    // TypeScript 类型窄化：使用 'from' in rule 确保类型安全
-    if (!('from' in rule)) {
-        return;
-    }
-    // 处理需要源文件的操作（CopyRule 和 AppendRule）
-    const srcPath = path.join(pluginRoot, rule.from);
-    const destPath = path.join(userProjectRoot, rule.to);
-    if (!fs.existsSync(srcPath)) {
-        console.warn(`[fullstack-cli] Source not found: ${rule.from}`);
-        return;
-    }
-    switch (rule.type) {
-        case 'directory':
-            syncDirectory(srcPath, destPath, rule.overwrite ?? true);
-            break;
-        case 'file':
-            syncFile(srcPath, destPath, rule.overwrite ?? true);
-            break;
-        case 'append':
-            appendToFile(srcPath, destPath);
-            break;
-    }
-}
-/**
- * 同步单个文件
- */
-function syncFile(src, dest, overwrite = true) {
-    // 确保目标目录存在
-    const destDir = path.dirname(dest);
-    if (!fs.existsSync(destDir)) {
-        fs.mkdirSync(destDir, { recursive: true });
-    }
-    // 检查目标文件是否存在
-    if (fs.existsSync(dest) && !overwrite) {
-        console.log(`[fullstack-cli] ○ ${path.basename(dest)} (skipped, already exists)`);
-        return;
-    }
-    // 复制文件
-    fs.copyFileSync(src, dest);
-    console.log(`[fullstack-cli] ✓ ${path.basename(dest)}`);
-}
-/**
- * 同步整个目录
- */
-function syncDirectory(src, dest, overwrite = true) {
-    // 确保目标目录存在
-    if (!fs.existsSync(dest)) {
-        fs.mkdirSync(dest, { recursive: true });
-    }
-    // 读取源目录所有文件
-    const files = fs.readdirSync(src);
-    let count = 0;
-    files.forEach(file => {
-        const srcFile = path.join(src, file);
-        const destFile = path.join(dest, file);
-        const stats = fs.statSync(srcFile);
-        if (stats.isDirectory()) {
-            // 递归处理子目录
-            syncDirectory(srcFile, destFile, overwrite);
-        }
-        else {
-            // 复制文件
-            if (overwrite || !fs.existsSync(destFile)) {
-                fs.copyFileSync(srcFile, destFile);
-                console.log(`[fullstack-cli] ✓ ${path.relative(dest, destFile)}`);
-                count++;
-            }
-        }
-    });
-    if (count > 0) {
-        console.log(`[fullstack-cli] Synced ${count} files to ${path.basename(dest)}/`);
-    }
-}
-/**
- * 追加内容到文件
- */
-function appendToFile(src, dest) {
-    const content = fs.readFileSync(src, 'utf-8');
-    // 读取目标文件内容（如果存在）
-    let existingContent = '';
-    if (fs.existsSync(dest)) {
-        existingContent = fs.readFileSync(dest, 'utf-8');
-    }
-    // 检查是否已包含相同内容（避免重复追加）
-    if (existingContent.includes(content.trim())) {
-        console.log(`[fullstack-cli] ○ ${path.basename(dest)} (already contains content)`);
-        return;
-    }
-    // 追加内容
-    fs.appendFileSync(dest, content);
-    console.log(`[fullstack-cli] ✓ ${path.basename(dest)} (appended)`);
-}
-/**
- * 设置文件权限
- */
-function setPermissions(permissions, projectRoot) {
-    for (const [pattern, mode] of Object.entries(permissions)) {
-        // 简单实现：只支持 **/*.sh 这种模式
-        if (pattern === '**/*.sh') {
-            const scriptsDir = path.join(projectRoot, 'scripts');
-            if (fs.existsSync(scriptsDir)) {
-                const files = fs.readdirSync(scriptsDir);
-                files.forEach(file => {
-                    if (file.endsWith('.sh')) {
-                        const filePath = path.join(scriptsDir, file);
-                        fs.chmodSync(filePath, mode);
-                    }
-                });
-            }
-        }
-    }
-}
-/**
- * 删除单个文件
- * @param filePath 要删除的文件路径
- */
-function deleteFile(filePath) {
-    if (fs.existsSync(filePath)) {
-        fs.unlinkSync(filePath);
-        console.log(`[fullstack-cli] ✓ ${path.basename(filePath)} (deleted)`);
-    }
-    else {
-        console.log(`[fullstack-cli] ○ ${path.basename(filePath)} (not found)`);
-    }
-}
-/**
- * 删除整个目录
- * @param dirPath 要删除的目录路径
- */
-function deleteDirectory(dirPath) {
-    if (fs.existsSync(dirPath)) {
-        fs.rmSync(dirPath, { recursive: true });
-        console.log(`[fullstack-cli] ✓ ${path.basename(dirPath)} (deleted)`);
-    }
-    else {
-        console.log(`[fullstack-cli] ○ ${path.basename(dirPath)} (not found)`);
-    }
-}

package/dist/config/sync.d.ts

@@ -1,43 +0,0 @@
-/**
- * fullstack-cli 派生配置
- * 定义哪些文件/目录需要同步到用户项目
- */
-/** 复制目录或文件规则 */
-type CopyRule = {
-    /** 源文件/目录路径（相对于插件根目录） */
-    from: string;
-    /** 目标文件/目录路径（相对于用户项目根目录） */
-    to: string;
-    /** 同步类型 */
-    type: 'directory' | 'file';
-    /** 是否覆盖已存在的文件 */
-    overwrite?: boolean;
-};
-/** 追加内容规则 */
-type AppendRule = {
-    /** 源文件路径（相对于插件根目录） */
-    from: string;
-    /** 目标文件路径（相对于用户项目根目录） */
-    to: string;
-    /** 同步类型 */
-    type: 'append';
-};
-/** 删除文件或目录规则 */
-type DeleteRule = {
-    /** 目标文件/目录路径（相对于用户项目根目录） */
-    to: string;
-    /** 同步类型 */
-    type: 'delete-file' | 'delete-directory';
-};
-/** 同步规则联合类型 */
-export type SyncRule = CopyRule | AppendRule | DeleteRule;
-export interface SyncConfig {
-    /** 派生规则 */
-    sync: SyncRule[];
-    /** 文件权限设置 */
-    permissions?: Record<string, number>;
-}
-export declare function genSyncConfig(perms?: {
-    disableGenOpenapi?: boolean;
-}): SyncConfig;
-export {};

package/dist/config/sync.js

@@ -1,48 +0,0 @@
-/**
- * fullstack-cli 派生配置
- * 定义哪些文件/目录需要同步到用户项目
- */
-const syncConfig = {
-    // 派生规则
-    sync: [
-        // 1. 派生 scripts 目录（总是覆盖）
-        {
-            from: 'templates/scripts',
-            to: 'scripts',
-            type: 'directory',
-            overwrite: true,
-        },
-        // // 2. 追加内容到 .gitignore
-        // {
-        //   from: 'templates/.gitignore.append',
-        //   to: '.gitignore',
-        //   type: 'append',
-        // },
-        // 3. 派生 server/type.ts 文件（总是覆盖）
-        // {
-        //   from: 'templates/server/global.d.ts',
-        //   to: 'server/types/global.d.ts',
-        //   type: 'file',
-        // },
-        {
-            type: 'delete-directory',
-            to: '.swc', // 删除 .swc 目录（如果存在）
-        },
-    ],
-    // 文件权限设置
-    permissions: {
-    // 所有 .sh 文件设置为可执行
-    // '**/*.sh': 0o755,
-    },
-};
-export function genSyncConfig(perms = {}) {
-    if (!perms.disableGenOpenapi) {
-        syncConfig.sync.push({
-            from: 'templates/helper/gen-openapi.ts',
-            to: 'scripts/gen-openapi.ts',
-            type: 'file',
-            overwrite: true,
-        });
-    }
-    return syncConfig;
-}