@coze-arch/cli 0.0.1-alpha.e9ff73 → 0.0.1-alpha.eaa612

package/lib/__templates__/vite/scripts/build-server.js

@@ -0,0 +1,70 @@
+#!/usr/bin/env node
+
+/**
+ * 构建服务器端代码
+ * 自动读取 package.json 的 dependencies，将它们标记为 external
+ */
+
+const { build } = require('esbuild');
+const { readFileSync } = require('fs');
+const { resolve } = require('path');
+
+const projectRoot = resolve(__dirname, '..');
+
+// 读取 package.json
+const packageJsonPath = resolve(projectRoot, 'package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+
+// 获取所有 dependencies（运行时依赖）
+const dependencies = Object.keys(packageJson.dependencies || {});
+
+// 添加 Node.js 内置模块到 external 列表
+const nodeBuiltins = [
+  'fs',
+  'path',
+  'url',
+  'http',
+  'https',
+  'stream',
+  'util',
+  'events',
+  'buffer',
+  'crypto',
+  'os',
+  'net',
+  'tls',
+  'zlib',
+  'querystring',
+  'child_process',
+  'worker_threads',
+];
+
+// vite 只在开发环境通过动态 import 使用，需要标记为 external 避免打包
+const devOnlyPackages = ['vite'];
+
+// 合并所有 external 依赖
+const external = [...dependencies, ...devOnlyPackages, ...nodeBuiltins];
+
+console.log('📦 Building server...');
+console.log(`External dependencies (${external.length}):`, external.join(', '));
+
+// 使用 esbuild 构建
+build({
+  entryPoints: [resolve(projectRoot, 'server/index.ts')],
+  bundle: true,
+  platform: 'node',
+  target: 'node18',
+  format: 'cjs',
+  outdir: resolve(projectRoot, 'dist-server'),
+  external,
+  sourcemap: true,
+  minify: false, // 生产环境可以设置为 true
+  logLevel: 'info',
+})
+  .then(() => {
+    console.log('✅ Server build completed successfully!');
+  })
+  .catch((error) => {
+    console.error('❌ Server build failed:', error);
+    process.exit(1);
+  });

package/lib/__templates__/vite/scripts/build.sh

@@ -8,7 +8,10 @@ cd "${COZE_WORKSPACE_PATH}"
 echo "Installing dependencies..."
 pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
 
-echo "Building the project..."
+echo "Building frontend with Vite..."
 npx vite build
 
+echo "Building server with esbuild..."
+node scripts/build-server.js
+
 echo "Build completed successfully!"

package/lib/__templates__/vite/scripts/dev.sh

@@ -1,9 +1,9 @@
 #!/bin/bash
 set -Eeuo pipefail
 
-PORT=<%= port %>
+PORT="${PORT:-<%= port %>}"
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
-DEPLOY_RUN_PORT=<%= port %>
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
 
 cd "${COZE_WORKSPACE_PATH}"
 
@@ -27,6 +27,6 @@ kill_port_if_listening() {
 
 echo "Clearing port ${PORT} before start."
 kill_port_if_listening
-echo "Starting HTTP service on port ${PORT} for dev..."
+echo "Starting Koa + Vite dev server on port ${PORT}..."
 
-npx vite --port $PORT
+PORT=$PORT npx tsx watch server/index.ts

package/lib/__templates__/vite/scripts/start.sh

@@ -2,14 +2,14 @@
 set -Eeuo pipefail
 
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
-PORT=<%= port %>
-DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-$PORT}"
+PORT="${PORT:-<%= port %>}"
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
 
 start_service() {
     cd "${COZE_WORKSPACE_PATH}"
-    echo "Starting HTTP service on port ${DEPLOY_RUN_PORT} for deploy..."
-    npx vite preview --port $DEPLOY_RUN_PORT
+    echo "Starting Koa production server on port ${DEPLOY_RUN_PORT}..."
+    PORT=$DEPLOY_RUN_PORT node dist-server/index.js
 }
 
-echo "Starting HTTP service on port ${DEPLOY_RUN_PORT} for deploy..."
+echo "Starting Koa production server on port ${DEPLOY_RUN_PORT}..."
 start_service

package/lib/__templates__/vite/server/index.ts

@@ -0,0 +1,57 @@
+import Koa from 'koa';
+import bodyParser from 'koa-bodyparser';
+import router from './routes/index';
+import { setupVite } from './vite';
+
+const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+
+async function createServer() {
+  const app = new Koa();
+
+  // 全局错误处理
+  app.use(async (ctx, next) => {
+    try {
+      await next();
+    } catch (err) {
+      console.error('Server error:', err);
+      const status =
+        err instanceof Error && 'status' in err
+          ? (err as { status?: number }).status || 500
+          : 500;
+      ctx.status = status;
+      ctx.body = {
+        error: err instanceof Error ? err.message : 'Internal server error',
+      };
+    }
+  });
+
+  // 请求日志（仅开发环境）
+  if (isDev) {
+    app.use(async (ctx, next) => {
+      const start = Date.now();
+      await next();
+      const ms = Date.now() - start;
+      console.log(`${ctx.method} ${ctx.url} - ${ms}ms`);
+    });
+  }
+
+  // 添加请求体解析
+  app.use(bodyParser());
+
+  // 注册 API 路由
+  app.use(router.routes()).use(router.allowedMethods());
+
+  // 集成 Vite（开发模式）或静态文件服务（生产模式）
+  await setupVite(app);
+
+  const port = process.env.PORT || <%= port %>;
+  app.listen(port, () => {
+    console.log(`\n✨ Server running at http://localhost:${port}`);
+    console.log(`📝 Environment: ${isDev ? 'development' : 'production'}\n`);
+  });
+}
+
+createServer().catch((err) => {
+  console.error('Failed to start server:', err);
+  process.exit(1);
+});

package/lib/__templates__/vite/server/routes/index.ts

@@ -0,0 +1,31 @@
+import Router from '@koa/router';
+
+const router = new Router();
+
+// API 路由示例
+router.get('/api/hello', async ctx => {
+  ctx.body = {
+    message: 'Hello from Koa + Vite!',
+    timestamp: new Date().toISOString(),
+  };
+});
+
+router.post('/api/data', async ctx => {
+  const requestData = ctx.request.body;
+  ctx.body = {
+    success: true,
+    data: requestData,
+    receivedAt: new Date().toISOString(),
+  };
+});
+
+// 健康检查接口
+router.get('/api/health', async ctx => {
+  ctx.body = {
+    status: 'ok',
+    env: process.env.COZE_PROJECT_ENV,
+    timestamp: new Date().toISOString(),
+  };
+});
+
+export default router;

package/lib/__templates__/vite/server/vite.ts

@@ -0,0 +1,79 @@
+import type Koa from 'koa';
+import serve from 'koa-static';
+import path from 'path';
+import fs from 'fs';
+
+const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+
+/**
+ * 集成 Vite 开发服务器（中间件模式）
+ * 使用动态 import 避免在生产构建时打包 vite
+ */
+export async function setupViteMiddleware(app: Koa) {
+  // 动态导入 vite，只在开发环境运行时加载
+  const { createServer: createViteServer } = await import('vite');
+
+  const vite = await createViteServer({
+    server: {
+      middlewareMode: true,
+      hmr: {
+        port: process.env.HMR_PORT ? parseInt(process.env.HMR_PORT) : undefined,
+        overlay: true,
+      },
+    },
+    appType: 'spa',
+  });
+
+  // 将 Vite middleware 转换为 Koa middleware
+  app.use(async ctx => {
+    await new Promise<void>((resolve, reject) => {
+      vite.middlewares(ctx.req, ctx.res, (err?: Error) => {
+        if (err) {
+          reject(err);
+        } else {
+          resolve();
+        }
+      });
+    });
+  });
+
+  console.log('🚀 Vite dev server initialized');
+}
+
+/**
+ * 设置生产环境静态文件服务
+ */
+export function setupStaticServer(app: Koa) {
+  // 在 CommonJS 编译后，__dirname 会自动可用
+  // 在 TypeScript 中，我们使用相对于当前文件的路径
+  const distPath = path.resolve(process.cwd(), 'dist');
+
+  if (!fs.existsSync(distPath)) {
+    console.error('❌ dist folder not found. Please run "pnpm build" first.');
+    process.exit(1);
+  }
+
+  // 服务静态文件
+  app.use(serve(distPath));
+
+  // SPA fallback - 所有非 API 请求返回 index.html
+  app.use(async ctx => {
+    if (!ctx.path.startsWith('/api')) {
+      ctx.type = 'html';
+      ctx.body = fs.createReadStream(path.join(distPath, 'index.html'));
+    }
+  });
+
+  console.log('📦 Serving static files from dist/');
+}
+
+/**
+ * 根据环境设置 Vite
+ */
+export async function setupVite(app: Koa) {
+  if (isDev) {
+    await setupViteMiddleware(app);
+  } else {
+    setupStaticServer(app);
+  }
+}

package/lib/__templates__/vite/tsconfig.json

@@ -3,14 +3,15 @@
     "target": "ES2020",
     "lib": ["ES2020", "DOM", "DOM.Iterable"],
     "module": "ESNext",
-    "moduleResolution": "bundler",
+    "moduleResolution": "node",
     "strict": true,
     "esModuleInterop": true,
     "skipLibCheck": true,
     "forceConsistentCasingInFileNames": true,
     "resolveJsonModule": true,
     "isolatedModules": true,
-    "noEmit": true
+    "noEmit": true,
+    "types": ["node"]
   },
-  "include": ["src"]
+  "include": ["src", "server"]
 }

package/lib/cli.js

@@ -1722,38 +1722,6 @@ const collectFilesToRender = async (options
 
   return filesToWrite;
 };
-
-/**
- * 检测文件冲突
- *
- * @param outputPath - 输出目录路径
- * @param filesToWrite - 将要写入的文件路径列表
- * @returns 冲突的文件路径列表
- */
-const detectFileConflicts = (
-  outputPath,
-  filesToWrite,
-) => {
-  logger.verbose('\nChecking for file conflicts...');
-
-  const conflicts = [];
-
-  for (const file of filesToWrite) {
-    const fullPath = path.join(outputPath, file);
-    if (fs.existsSync(fullPath)) {
-      conflicts.push(file);
-      logger.verbose(`  ⚠ Conflict detected: ${file}`);
-    }
-  }
-
-  if (conflicts.length === 0) {
-    logger.verbose('  ✓ No conflicts detected');
-  } else {
-    logger.verbose(`  ⚠ ${conflicts.length} conflicts detected`);
-  }
-
-  return conflicts;
-};
 // end_aigc
 
 // ABOUTME: Main file processing orchestration for template rendering
@@ -1822,7 +1790,7 @@ const processTemplateFiles = async (options
 
 
 ) => {
-  const { templatePath, outputPath, context, templateConfig, force } = options;
+  const { templatePath, outputPath, context, templateConfig} = options;
   logger.verbose('Processing template files:');
   logger.verbose(`  - Template path: ${templatePath}`);
   logger.verbose(`  - Output path: ${outputPath}`);
@@ -1854,7 +1822,7 @@ const processTemplateFiles = async (options
   }
 
   // 阶段 2: Dry-run - 收集所有将要写入的文件
-  const filesToWrite = await collectFilesToRender({
+  await collectFilesToRender({
     files,
     templatePath,
     context,
@@ -1862,20 +1830,7 @@ const processTemplateFiles = async (options
   });
 
   // 阶段 3: 冲突检测（force 为 true 时跳过）
-  if (!force) {
-    const conflicts = detectFileConflicts(outputPath, filesToWrite);
-
-    if (conflicts.length > 0) {
-      // 有冲突，抛出详细的错误信息
-      const conflictList = conflicts.map(f => `  - ${f}`).join('\n');
-      throw new Error(
-        `File conflicts detected in output directory: ${outputPath}\n\n` +
-          `The following files already exist and would be overwritten:\n${conflictList}\n\n` +
-          'Please remove these files or use a different output directory.\n' +
-          'Or use --force to overwrite existing files.',
-      );
-    }
-  } else {
+  {
     logger.verbose(
       '  - Force mode enabled, skipping conflict detection. Existing files will be overwritten.',
     );
@@ -2020,7 +1975,7 @@ const prepareOutputDirectory = (outputPath) => {
 const execute = async (
   options,
 ) => {
-  const { templateName, outputPath, command, force } = options;
+  const { templateName, outputPath, command} = options;
 
   // 1. 加载模板
   const { templatePath } = await loadTemplateMetadata(templateName);
@@ -2044,9 +1999,7 @@ const execute = async (
     templatePath,
     outputPath: absoluteOutputPath,
     context,
-    templateConfig,
-    force,
-  });
+    templateConfig});
 
   // 7. 执行 onAfterRender 钩子
   await executeAfterRenderHook(templateConfig, context, absoluteOutputPath);
@@ -2097,7 +2050,40 @@ const runPnpmInstall = (projectPath) => {
 };
 
 /**
- * 初始化 git 仓库并创建初始提交
+ * 运行 git 命令的辅助函数
+ */
+const runGitCommand = (command, projectPath) => {
+  logger.info(`Executing: ${command}`);
+
+  const result = shelljs.exec(command, {
+    cwd: projectPath,
+    silent: true,
+  });
+
+  // 输出命令的结果
+  if (result.stdout) {
+    process.stdout.write(result.stdout);
+  }
+
+  if (result.stderr) {
+    process.stderr.write(result.stderr);
+  }
+
+  if (result.code !== 0) {
+    const errorMessage = [
+      `${command} failed with exit code ${result.code}`,
+      result.stderr ? `\nStderr:\n${result.stderr}` : '',
+      result.stdout ? `\nStdout:\n${result.stdout}` : '',
+    ]
+      .filter(Boolean)
+      .join('');
+
+    throw new Error(errorMessage);
+  }
+};
+
+/**
+ * 初始化 git 仓库
  * 如果目录中已存在 .git,则跳过初始化
  */
 const runGitInit = (projectPath) => {
@@ -2110,46 +2096,9 @@ const runGitInit = (projectPath) => {
     return;
   }
 
-  const runGitCommand = (command) => {
-    logger.info(`Executing: ${command}`);
-
-    const result = shelljs.exec(command, {
-      cwd: projectPath,
-      silent: true,
-    });
-
-    // 输出命令的结果
-    if (result.stdout) {
-      process.stdout.write(result.stdout);
-    }
-
-    if (result.stderr) {
-      process.stderr.write(result.stderr);
-    }
-
-    if (result.code !== 0) {
-      const errorMessage = [
-        `${command} failed with exit code ${result.code}`,
-        result.stderr ? `\nStderr:\n${result.stderr}` : '',
-        result.stdout ? `\nStdout:\n${result.stdout}` : '',
-      ]
-        .filter(Boolean)
-        .join('');
-
-      throw new Error(errorMessage);
-    }
-  };
-
   try {
     logger.info('\nInitializing git repository...');
-    runGitCommand('git init');
-
-    logger.info('Adding files to git...');
-    runGitCommand('git add .');
-
-    logger.info('Creating initial commit...');
-    runGitCommand('git commit -m "chore: initial commit"');
-
+    runGitCommand('git init', projectPath);
     logger.success('Git repository initialized successfully!');
   } catch (error) {
     // Git 初始化失败不应该导致整个流程失败
@@ -2160,6 +2109,35 @@ const runGitInit = (projectPath) => {
   }
 };
 
+/**
+ * 提交初始化生成的所有文件
+ */
+const commitChanges = (projectPath) => {
+  // 检查是否存在 .git 目录
+  const gitDir = path.join(projectPath, '.git');
+  if (!fs.existsSync(gitDir)) {
+    logger.warn(
+      '\n⚠️  Git repository does not exist, skipping commit. Run git init first.',
+    );
+    return;
+  }
+
+  try {
+    logger.info('\nCommitting initialized files...');
+    runGitCommand('git add --all', projectPath);
+    runGitCommand('git commit -m "chore: init env"', projectPath);
+    logger.success('Changes committed successfully!');
+  } catch (error) {
+    // Commit 失败不应该导致整个流程失败
+    logger.warn(
+      `Git commit failed: ${error instanceof Error ? error.message : String(error)}`,
+    );
+    logger.info(
+      'You can manually commit later with: git add --all && git commit -m "chore: init env"',
+    );
+  }
+};
+
 /**
  * 运行开发服务器(后台模式)
  * 启动后台子进程运行开发服务器，父进程可以直接退出
@@ -2202,6 +2180,7 @@ const executeInit = async (
 
 
 
+
 ,
   command,
 ) => {
@@ -2213,6 +2192,7 @@ const executeInit = async (
       output: outputPath,
       skipInstall,
       skipGit,
+      skipCommit,
       skipDev,
       force,
     } = options;
@@ -2258,6 +2238,12 @@ const executeInit = async (
       timer.logPhase('Git initialization');
     }
 
+    // 如果没有跳过 commit，则提交初始化生成的文件
+    if (!skipCommit) {
+      commitChanges(absoluteOutputPath);
+      timer.logPhase('Git commit');
+    }
+
     // 如果没有跳过 dev，则启动开发服务器
     if (!skipDev) {
       runDev(absoluteOutputPath);
@@ -2270,9 +2256,10 @@ const executeInit = async (
         logger.info('  pnpm install');
       }
       if (skipGit) {
-        logger.info(
-          '  git init && git add . && git commit -m "initial commit"',
-        );
+        logger.info('  git init');
+      }
+      if (skipCommit) {
+        logger.info('  git add --all && git commit -m "chore: init env"');
       }
       logger.info('  coze dev');
     }
@@ -2299,17 +2286,19 @@ const registerCommand$1 = program => {
     .option('-o, --output <path>', 'Output directory', process.cwd())
     .option('--skip-install', 'Skip automatic pnpm install', false)
     .option('--skip-git', 'Skip automatic git initialization', false)
-    .option('--skip-dev', 'Skip automatic dev server start', false)
     .option(
-      '--force',
-      'Force overwrite existing files without checking conflicts',
-      true,
+      '--skip-commit',
+      'Skip automatic git commit after initialization',
+      false,
     )
+    .option('--skip-dev', 'Skip automatic dev server start', false)
     .allowUnknownOption() // 允许透传参数
     .action(async (directory, options, command) => {
       // 位置参数优先级高于 --output 选项
       const outputPath = _nullishCoalesce(directory, () => ( options.output));
-      await executeInit({ ...options, output: outputPath }, command);
+      // Always use force mode - overwrite existing files without conflict check
+      const force = true;
+      await executeInit({ ...options, output: outputPath, force }, command);
     });
 };
 
@@ -2609,7 +2598,7 @@ const registerCommand = program => {
     });
 };
 
-var version = "0.0.1-alpha.e9ff73";
+var version = "0.0.1-alpha.eaa612";
 var packageJson = {
 	version: version};
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coze-arch/cli",
-  "version": "0.0.1-alpha.e9ff73",
+  "version": "0.0.1-alpha.eaa612",
   "private": false,
   "description": "coze coding devtools cli",
   "license": "MIT",
@@ -50,6 +50,7 @@
     "@coze-arch/vitest-config": "workspace:*",
     "@coze-coding/lambda": "workspace:*",
     "@inquirer/prompts": "^3.2.0",
+    "@playwright/test": "~1.55.0",
     "@types/ejs": "^3.1.5",
     "@types/iarna__toml": "^2.0.5",
     "@types/js-yaml": "^4.0.9",
@@ -60,8 +61,10 @@
     "@vitest/coverage-v8": "~4.0.16",
     "json-schema-to-typescript": "^15.0.3",
     "minimatch": "^10.0.1",
+    "playwright": "~1.55.0",
     "rollup": "^4.41.1",
     "sucrase": "^3.35.0",
+    "tree-kill": "^1.2.2",
     "tsx": "^4.20.6",
     "vite-tsconfig-paths": "^4.2.1",
     "vitest": "~4.0.16"

package/lib/__templates__/nuxt-app/.nuxt/app.config.mjs

@@ -1,21 +0,0 @@
-
-import { defuFn } from 'defu'
-
-const inlineConfig = {
-  "nuxt": {}
-}
-
-/** client **/
-import { _replaceAppConfig } from '#app/config'
-
-// Vite - webpack is handled directly in #app/config
-if (import.meta.dev && !import.meta.nitro && import.meta.hot) {
-  import.meta.hot.accept((newModule) => {
-    _replaceAppConfig(newModule.default)
-  })
-}
-/** client-end **/
-
-
-
-export default /*@__PURE__*/ defuFn(inlineConfig)