@coze-arch/cli 0.0.1-beta.6 → 0.0.3

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,51 +1,39 @@
 #!/bin/bash
 set -Eeuo pipefail
 
+<% if (process.env.NODE_ENV === 'test') { %>
+# 测试环境：支持环境变量覆盖端口
+PORT="${PORT:-<%= port %>}"
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
+<% } else { %>
 PORT=<%= port %>
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+DEPLOY_RUN_PORT=<%= port %>
+<% } %>
 
 cd "${COZE_WORKSPACE_PATH}"
 
 kill_port_if_listening() {
     local pids
-
-    # Check if lsof is available (macOS/BSD) or ss (Linux)
-    if command -v lsof >/dev/null 2>&1; then
-        # macOS/BSD using lsof
-        pids=$(lsof -ti:${PORT} 2>/dev/null || true)
-    elif command -v ss >/dev/null 2>&1; then
-        # Linux using ss
-        pids=$(ss -H -lntp 2>/dev/null | awk -v port="${PORT}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | paste -sd' ' - || true)
-    else
-        echo "Warning: neither lsof nor ss found, cannot check port ${PORT}"
-        return
-    fi
-
+    pids=$(ss -H -lntp 2>/dev/null | awk -v port="${DEPLOY_RUN_PORT}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | paste -sd' ' - || true)
     if [[ -z "${pids}" ]]; then
-      echo "Port ${PORT} is free."
+      echo "Port ${DEPLOY_RUN_PORT} is free."
       return
     fi
-
-    echo "Port ${PORT} in use by PIDs: ${pids} (SIGKILL)"
+    echo "Port ${DEPLOY_RUN_PORT} in use by PIDs: ${pids} (SIGKILL)"
     echo "${pids}" | xargs -I {} kill -9 {}
     sleep 1
-
-    # Verify port is cleared
-    if command -v lsof >/dev/null 2>&1; then
-        pids=$(lsof -ti:${PORT} 2>/dev/null || true)
-    elif command -v ss >/dev/null 2>&1; then
-        pids=$(ss -H -lntp 2>/dev/null | awk -v port="${PORT}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | paste -sd' ' - || true)
-    fi
-
+    pids=$(ss -H -lntp 2>/dev/null | awk -v port="${DEPLOY_RUN_PORT}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | paste -sd' ' - || true)
     if [[ -n "${pids}" ]]; then
-      echo "Warning: port ${PORT} still busy after SIGKILL, PIDs: ${pids}"
+      echo "Warning: port ${DEPLOY_RUN_PORT} still busy after SIGKILL, PIDs: ${pids}"
     else
-      echo "Port ${PORT} cleared."
+      echo "Port ${DEPLOY_RUN_PORT} cleared."
     fi
 }
 
 echo "Clearing port ${PORT} before start."
 kill_port_if_listening
-echo "Starting HTTP service on port ${PORT} for dev..."
+echo "Starting express + Vite dev server on port ${PORT}..."
 
-npx vite --port $PORT
+PORT=$PORT npx tsx watch server/server.ts

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

@@ -0,0 +1,9 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+
+cd "${COZE_WORKSPACE_PATH}"
+
+echo "Installing dependencies..."
+pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only

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

@@ -2,14 +2,20 @@
 set -Eeuo pipefail
 
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+<% if (process.env.NODE_ENV === 'test') { %>
+# 测试环境：支持环境变量覆盖端口
+PORT="${PORT:-<%= port %>}"
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
+<% } else { %>
 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 express 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 express 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,65 @@
+// ABOUTME: Express server with Vite integration
+// ABOUTME: Handles API routes and serves frontend in dev/prod modes
+
+import { createServer, type Server } from 'http';
+import express from 'express';
+import router from './routes/index';
+import { setupVite } from './vite';
+
+const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+const port = parseInt(process.env.PORT || '<%= port %>', 10);
+const hostname = process.env.HOSTNAME || 'localhost';
+const app = express();
+// 使用 http.createServer 包装 Express app，以便支持 WebSocket 等协议升级
+const server = createServer(app);
+
+async function startServer(): Promise<Server> {
+  // 请求日志（仅开发环境）
+  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',
+    });
+  });
+
+  server.once('error', err => {
+    console.error('Server error:', err);
+    process.exit(1);
+  });
+
+  server.listen(port, () => {
+    console.log(`\n✨ Server running at http://${hostname}:${port}`);
+    console.log(`📝 Environment: ${isDev ? 'development' : 'production'}\n`);
+  });
+
+  return server;
+}
+
+startServer().catch(err => {
+  console.error('Failed to start server:', err);
+  process.exit(1);
+});

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

@@ -0,0 +1,67 @@
+// ABOUTME: Vite integration for Express server
+// ABOUTME: Handles dev middleware and production static file serving
+
+import type { Application, Request, Response } from 'express';
+import express from 'express';
+import path from 'path';
+import fs from 'fs';
+import { createServer as createViteServer } from 'vite';
+import viteConfig from '../vite.config';
+
+const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+
+/**
+ * 集成 Vite 开发服务器（中间件模式）
+ */
+export async function setupViteMiddleware(app: Application) {
+  const vite = await createViteServer({
+    ...viteConfig,
+    server: {
+      ...viteConfig.server,
+      middlewareMode: 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);
+  }
+
+  // 1. 服务静态文件（如果存在对应文件则直接返回）
+  app.use(express.static(distPath));
+
+  // 2. SPA fallback - 所有未处理的请求返回 index.html
+  // 到达这里的请求说明：
+  //   - 不是 API 请求（已被前面注册的路由处理）
+  //   - 不是静态文件（express.static 未找到对应文件）
+  //   - 需要返回 index.html 让前端路由处理
+  app.use((_req: Request, res: Response) => {
+    res.sendFile(path.join(distPath, 'index.html'));
+  });
+
+  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,57 +7,26 @@ export function initApp(): void {
   }
 
   app.innerHTML = `
-    <div class="flex min-h-screen items-center justify-center bg-white text-black transition-colors duration-300 dark:bg-black dark:text-white">
-      <!-- 主容器 -->
-      <main class="flex min-h-screen w-full max-w-3xl flex-col items-center justify-between px-16 py-32 sm:items-start">
-        <!-- 头部：Logo 和 产品名称 -->
-        <div class="flex items-center gap-3">
+    <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
-            class="dark:invert"
-            src="https://lf3-static.bytednsdoc.com/obj/eden-cn/hkpzboz/coze_logo.png"
+            src="https://lf-coze-web-cdn.coze.cn/obj/eden-cn/lm-lgvj/ljhwZthlaukjlkulzlp/coze-coding/icon/coze-coding.gif"
             alt="扣子编程 Logo"
-            width="40"
-            height="40"
-            style="width: 40px; height: 40px; object-fit: contain;"
+            width={156}
+            height={130}
+            style="width: 156px; height: 130px; object-fit: contain;"
           />
-          <span class="text-xl font-bold tracking-tight text-black dark:text-zinc-50">
-            扣子编程
-          </span>
-        </div>
-
-        <!-- 中间内容区：主标题和副标题 -->
-        <div class="flex flex-col items-center gap-6 text-center sm:items-start sm:text-left">
-          <h1 class="max-w-xl text-4xl font-semibold leading-tight tracking-tight text-black dark:text-zinc-50">
-            扣子编程，你的 AI 开发伙伴已就位
-          </h1>
-          <p class="max-w-2xl text-lg leading-8 text-zinc-600 dark:text-zinc-400">
-            当前是空白入口文件，项目正在开发中，请稍候...
-            <br />
-            开发完成后界面将自动更新。如未自动更新成功，可以手动点击右上角刷新或重启按钮查看效果。
-          </p>
-        </div>
-
-        <!-- 底部按钮区 -->
-        <div class="flex w-full flex-col gap-4 text-base font-medium sm:w-auto sm:flex-row">
-          <!-- 按钮 1：前往首页 -->
-          <a
-            class="flex h-12 w-full min-w-[160px] items-center justify-center gap-2 rounded-full bg-black px-8 text-white transition-colors hover:bg-zinc-800 dark:bg-white dark:text-black dark:hover:bg-zinc-200 md:w-auto"
-            href="https://code.coze.cn/"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            前往首页
-          </a>
-
-          <!-- 按钮 2：查看文档 -->
-          <a
-            class="flex h-12 w-full min-w-[160px] items-center justify-center rounded-full border border-solid border-black/[.08] px-8 transition-colors hover:border-transparent hover:bg-black/[.04] dark:border-white/[.145] dark:hover:bg-[#1a1a1a] md:w-auto"
-            href="https://docs.coze.cn/"
-            target="_blank"
-            rel="noopener noreferrer"
-          >
-            查看文档
-          </a>
+          <div>
+            <div class="flex flex-col items-center gap-2 text-center sm:items-center sm:text-center">
+              <h1 class="max-w-xl text-base font-semibold leading-tight tracking-tight text-foreground dark:text-foreground">
+                应用开发中
+              </h1>
+              <p class="max-w-2xl text-sm-14 leading-8 text-muted-foreground dark:text-muted-foreground">
+                请稍后，页面即将呈现
+              </p>
+            </div>
+          </div>
         </div>
       </main>
     </div>

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

@@ -1,4 +1,8 @@
 
+import { spawn } from 'child_process';
+import { resolve, join, basename } from 'path';
+import { appendFileSync, openSync, closeSync, mkdirSync } from 'fs';
+
 
 
 
@@ -24,17 +28,29 @@ export const paramsSchema = {
       maximum: 65535,
       description: 'Development server port',
     },
+    hmrPort: {
+      type: 'number',
+      default: 6000,
+      minimum: 1024,
+      maximum: 65535,
+      description: 'Development HMR server port',
+    },
   },
   required: [],
   additionalProperties: false,
 };
 
+const description = `Vite（简单项目）：\`coze init \${COZE_WORKSPACE_PATH} --template vite\`
+- 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。`;
+
 const config = {
+  description: description,
   paramsSchema,
 
   defaultParams: {
     port: 5000,
-    appName: 'app',
+    hmrPort: 6000,
+    appName: 'projects',
   },
 
   onBeforeRender: async context => {
@@ -44,13 +60,67 @@ const config = {
     return context;
   },
 
-  onAfterRender: async (context, outputPath) => {
+  onAfterRender: async (_context, outputPath) => {
     console.log(`\nProject created at: ${outputPath}`);
-    console.log(`\nConfiguration:`);
-    console.log(`  - TypeScript: enabled`);
-    console.log(`  - Framework: None (Vanilla JS/TS)`);
-    console.log(`  - Build Tool: Vite`);
-    console.log(`  - Port: ${context.port}`);
+    console.log('\nConfiguration:');
+    console.log('  - Framework: vite');
+    console.log('  - TypeScript: enabled');
+    console.log('  - App Router: enabled');
+    console.log(`  - Port: ${_context.port}`);
+  },
+
+  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';
+    const args = ['update', 'coze-coding-dev-sdk@^0.7.0'];
+    console.log(
+      `\nTriggering: ${cmd} ${args.join(' ')} (running in background)`,
+    );
+
+    try {
+      const projectRoot = resolve(outputPath);
+
+      // 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 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

@@ -1,15 +1,20 @@
 import { defineConfig } from 'vite';
 
 export default defineConfig({
-  port: '<%= port %>',
-  host: '0.0.0.0',
   server: {
+    port: <%= port %>,
+    host: '0.0.0.0',
+    allowedHosts: true,
     hmr: {
       overlay: true,
       path: '/hot/vite-hmr',
-      port: '<%= port %>',
+      port: <%= hmrPort %>,
       clientPort: 443,
       timeout: 30000,
     },
+    watch: {
+      usePolling: true,
+      interval: 100,
+    }
   },
 });