@coze-arch/cli 0.0.1-alpha.e58008 → 0.0.1-alpha.e70f72

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 "Bundling server with tsup..."
+npx tsup server/server.ts --format cjs --platform node --target node20 --outDir dist-server --no-splitting --no-minify --external vite
+
 echo "Build completed successfully!"

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

@@ -1,9 +1,10 @@
 #!/bin/bash
 set -Eeuo pipefail
 
-PORT=<%= port %>
+# 优先使用 COZE_E2E_PORT（E2E 测试专用），否则使用默认值
+PORT="${COZE_E2E_PORT:-<%= port %>}"
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
-DEPLOY_RUN_PORT=<%= port %>
+DEPLOY_RUN_PORT="${COZE_E2E_PORT:-<%= port %>}"
 
 cd "${COZE_WORKSPACE_PATH}"
 
@@ -27,6 +28,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/server.ts

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

@@ -7,9 +7,9 @@ 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/server.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/routes/index.ts

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

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

@@ -0,0 +1,55 @@
+// ABOUTME: Express server with Vite integration
+// ABOUTME: Handles API routes and serves frontend in dev/prod modes
+
+import express from 'express';
+import router from './routes/index';
+import { setupVite } from './vite';
+
+const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+
+async function createServer() {
+  const app = express();
+
+  // 请求日志（仅开发环境）
+  if (isDev) {
+    app.use((req, res, next) => {
+      const start = Date.now();
+      res.on('finish', () => {
+        const ms = Date.now() - start;
+        console.log(`${req.method} ${req.url} - ${ms}ms`);
+      });
+      next();
+    });
+  }
+
+  // 添加请求体解析
+  app.use(express.json());
+  app.use(express.urlencoded({ extended: true }));
+
+  // 注册 API 路由
+  app.use(router);
+
+  // 集成 Vite（开发模式）或静态文件服务（生产模式）
+  await setupVite(app);
+
+  // 全局错误处理
+  app.use((err: Error, req: express.Request, res: express.Response) => {
+    console.error('Server error:', err);
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const status = 'status' in err ? (err as any).status || 500 : 500;
+    res.status(status).json({
+      error: err.message || 'Internal server error',
+    });
+  });
+
+  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/vite.ts

@@ -0,0 +1,71 @@
+// ABOUTME: Vite integration for Express server
+// ABOUTME: Handles dev middleware and production static file serving
+
+import type { Application } from 'express';
+import express from 'express';
+import path from 'path';
+import fs from 'fs';
+
+const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+
+/**
+ * 集成 Vite 开发服务器（中间件模式）
+ * 使用动态 import 避免在生产构建时打包 vite
+ */
+export async function setupViteMiddleware(app: Application) {
+  // 动态导入 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
+  app.use(vite.middlewares);
+
+  console.log('🚀 Vite dev server initialized');
+}
+
+/**
+ * 设置生产环境静态文件服务
+ */
+export function setupStaticServer(app: Application) {
+  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(express.static(distPath));
+
+  // SPA fallback - 所有非 API 请求返回 index.html
+  app.use((req, res, next) => {
+    if (!req.path.startsWith('/api')) {
+      res.sendFile(path.join(distPath, 'index.html'));
+    } else {
+      next();
+    }
+  });
+
+  console.log('📦 Serving static files from dist/');
+}
+
+/**
+ * 根据环境设置 Vite
+ */
+export async function setupVite(app: Application) {
+  if (isDev) {
+    await setupViteMiddleware(app);
+  } else {
+    setupStaticServer(app);
+  }
+}

package/lib/__templates__/vite/src/main.ts

@@ -7,8 +7,7 @@ export function initApp(): void {
   }
 
   app.innerHTML = `
-    <div class="flex h-full items-center justify-center bg-background text-foreground transition-colors duration-300 dark:bg-background dark:text-foreground overflow-hidden">
-      {/* 主容器 */}
+    <div class="flex h-full items-center justify-center bg-background text-foreground transition-colors duration-300 dark:bg-background dark:text-foreground overflow-hidden min-h-screen">
       <main class="flex w-full h-full max-w-3xl flex-col items-center justify-center px-16 py-32 sm:items-center">
         <div class="flex flex-col items-center justify-between gap-4">
           <img
@@ -16,6 +15,7 @@ export function initApp(): void {
             alt="扣子编程 Logo"
             width={156}
             height={130}
+            style="width: 156px; height: 130px; object-fit: contain;"
           />
           <div>
             <div class="flex flex-col items-center gap-2 text-center sm:items-center sm:text-center">

package/lib/__templates__/vite/template.config.js

@@ -1,6 +1,7 @@
 
-
-import { resolve } from 'path';
+import { spawn } from 'child_process';
+import { resolve, join, basename } from 'path';
+import { appendFileSync, openSync, closeSync, mkdirSync } from 'fs';
 
 
 
@@ -59,32 +60,66 @@ const config = {
     return context;
   },
 
-  onAfterRender: async (context, outputPath) => {
+  onAfterRender: async (_context, outputPath) => {
     console.log(`\nProject created at: ${outputPath}`);
     console.log('\nConfiguration:');
     console.log('  - Framework: vite');
     console.log('  - TypeScript: enabled');
     console.log('  - App Router: enabled');
-    console.log(`  - Port: ${context.port}`);
+    console.log(`  - Port: ${_context.port}`);
+  },
 
-    // Skip pnpm add in test environment to avoid monorepo workspace issues
+  onComplete: async (_context, outputPath) => {
+    // Skip pnpm update in test environment to avoid monorepo workspace issues
     if (process.env.NODE_ENV === 'test') {
       console.log('⊘ Skipping dependency update in test environment');
       return;
     }
 
-    const cmd = `pnpm add coze-coding-dev-sdk@"^0.7.0"`;
-    console.log(`${cmd}`);
+    const cmd = 'pnpm';
+    const args = ['update', 'coze-coding-dev-sdk@^0.7.0'];
+    console.log(
+      `\nTriggering: ${cmd} ${args.join(' ')} (running in background)`,
+    );
+
     try {
       const projectRoot = resolve(outputPath);
-      // execSync(cmd, {
-      //   cwd: projectRoot,
-      //   stdio: 'inherit',
-      // });
-      console.log('✓ coze-coding-dev-sdk updated successfully');
+
+      // Determine log directory
+      const logDir = process.env.COZE_LOG_DIR || resolve(__dirname, '../.log');
+      mkdirSync(logDir, { recursive: true });
+
+      // Use project name in log file to avoid conflicts
+      const projectName = basename(projectRoot);
+      const logFile = join(logDir, `${projectName}-init.log`);
+
+      // Write log header
+      const timestamp = new Date().toISOString();
+      appendFileSync(
+        logFile,
+        `\n=== [${timestamp}] ${cmd} ${args.join(' ')} ===\n`,
+      );
+
+      // Open log file for appending
+      const logFd = openSync(logFile, 'a');
+
+      // Spawn in detached mode
+      const child = spawn(cmd, args, {
+        cwd: projectRoot,
+        detached: true,
+        stdio: ['ignore', logFd, logFd],
+      });
+
+      child.unref();
+      closeSync(logFd);
+
+      console.log(
+        '✓ coze-coding-dev-sdk update triggered (running in background)',
+      );
+      console.log(`  Log file: ${logFile}`);
     } catch (error) {
-      console.error('✗ Failed to update coze-coding-dev-sdk:', error);
-      throw error;
+      console.error('✗ Failed to trigger coze-coding-dev-sdk update:', error);
+      console.log('  You can manually run: pnpm update coze-coding-dev-sdk');
     }
   },
 };

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/__templates__/vite/vite.config.ts

@@ -4,6 +4,7 @@ export default defineConfig({
   server: {
     port: <%= port %>,
     host: '0.0.0.0',
+    allowedHosts: true,
     hmr: {
       overlay: true,
       path: '/hot/vite-hmr',