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

package/lib/__templates__/nuxt-vue/postcss.config.mjs

@@ -0,0 +1,8 @@
+const config = {
+  plugins: {
+    tailwindcss: {},
+    autoprefixer: {},
+  },
+};
+
+export default config;

package/lib/__templates__/nuxt-vue/public/robots.txt

@@ -0,0 +1,2 @@
+User-Agent: *
+Disallow:

package/lib/__templates__/nuxt-vue/scripts/build.sh

@@ -0,0 +1,14 @@
+#!/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
+
+echo "Building the Nuxt.js project..."
+npx nuxt build
+
+echo "Build completed successfully!"

package/lib/__templates__/nuxt-vue/scripts/dev.sh

@@ -0,0 +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
+    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 ${DEPLOY_RUN_PORT} is free."
+      return
+    fi
+    echo "Port ${DEPLOY_RUN_PORT} in use by PIDs: ${pids} (SIGKILL)"
+    echo "${pids}" | xargs -I {} kill -9 {}
+    sleep 1
+    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 ${DEPLOY_RUN_PORT} still busy after SIGKILL, PIDs: ${pids}"
+    else
+      echo "Port ${DEPLOY_RUN_PORT} cleared."
+    fi
+}
+
+echo "Clearing port ${PORT} before start."
+kill_port_if_listening
+echo "Starting Nuxt dev server on port ${PORT}..."
+
+PORT=$PORT npx nuxt dev

package/lib/__templates__/nuxt-vue/scripts/prepare.sh

@@ -0,0 +1,14 @@
+#!/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
+
+echo "Preparing Nuxt project..."
+pnpm exec nuxt prepare
+
+echo "Preparation completed successfully!"

package/lib/__templates__/nuxt-vue/scripts/start.sh

@@ -0,0 +1,21 @@
+#!/bin/bash
+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 Nuxt.js service on port ${DEPLOY_RUN_PORT} for production..."
+    PORT=${DEPLOY_RUN_PORT} node .output/server/index.mjs
+}
+
+echo "Starting Nuxt.js service on port ${DEPLOY_RUN_PORT} for production..."
+start_service

package/lib/__templates__/nuxt-vue/server/api/hello.ts

@@ -0,0 +1,10 @@
+/**
+ * Hello API 示例
+ * 访问: http://localhost:<%= port %>/api/hello
+ */
+export default defineEventHandler(() => {
+  return {
+    message: 'Hello from Nuxt API',
+    timestamp: new Date().toISOString(),
+  };
+});

package/lib/__templates__/nuxt-vue/server/middleware/logger.ts

@@ -0,0 +1,10 @@
+/**
+ * 请求日志中间件（仅开发环境）
+ */
+export default defineEventHandler((event) => {
+  const isDev = process.env.COZE_PROJECT_ENV !== 'PROD';
+
+  if (isDev) {
+    console.log(`${event.method} ${event.path}`);
+  }
+});

package/lib/__templates__/nuxt-vue/server/routes/health.ts

@@ -0,0 +1,10 @@
+/**
+ * 健康检查路由
+ * 访问: http://localhost:<%= port %>/health
+ */
+export default defineEventHandler(() => {
+  return {
+    status: 'ok',
+    timestamp: new Date().toISOString(),
+  };
+});

package/lib/__templates__/nuxt-vue/tailwind.config.js

@@ -0,0 +1,13 @@
+/** @type {import('tailwindcss').Config} */
+export default {
+  content: [
+    './app/**/*.{js,ts,jsx,tsx,vue}',
+    './pages/**/*.{js,ts,jsx,tsx,vue}',
+    './components/**/*.{js,ts,jsx,tsx,vue}',
+  ],
+  darkMode: 'media',
+  theme: {
+    extend: {},
+  },
+  plugins: [],
+};

package/lib/__templates__/nuxt-vue/template.config.js

@@ -0,0 +1,87 @@
+
+
+
+
+
+
+
+
+
+const description = `Nuxt.js（服务端 + Vue）：\`coze init \${COZE_WORKSPACE_PATH} --template nuxt-vue\`
+- 适用：全栈应用、需要服务端接口能力的 Vue 项目
+- 特点：
+    - **服务端能力**：内置服务端 API 路由，可直接创建后端接口
+    - **Vue 3**：基于最新的 Vue 3 Composition API
+    - **Vite**：使用 Vite 作为构建工具，开发体验极佳
+    - **TypeScript**：完整的 TypeScript 支持
+    - **文件路由**：基于文件系统的自动路由
+    - **项目理解加速**：可依赖项目下 \`package.json\` 和 \`nuxt.config.ts\` 理解项目配置`;
+
+export const paramsSchema = {
+  type: 'object',
+  properties: {
+    appName: {
+      type: 'string',
+      minLength: 1,
+      pattern: '^[a-z0-9-]+$',
+      description:
+        'Application name (lowercase, alphanumeric and hyphens only)',
+    },
+    port: {
+      type: 'number',
+      default: 5000,
+      minimum: 1024,
+      maximum: 65535,
+      description: 'Development server port (for Nuxt dev server)',
+    },
+    hmrPort: {
+      type: 'number',
+      default: 6000,
+      minimum: 1024,
+      maximum: 65535,
+      description: 'Hot Module Replacement (HMR) port',
+    },
+  },
+  required: [],
+  additionalProperties: false,
+};
+
+const config = {
+  description: description,
+  paramsSchema,
+
+  // 显式定义默认参数，确保在渲染时可用
+  defaultParams: {
+    port: 5000,
+    hmrPort: 6000,
+    appName: 'nuxt-vue',
+  },
+
+  onBeforeRender: async context => {
+    console.log(`Creating Nuxt.js project: ${context.appName}`);
+    return context;
+  },
+
+  onAfterRender: async (_context, outputPath) => {
+    console.log(`\nProject created at: ${outputPath}`);
+    console.log('\nConfiguration:');
+    console.log('  - Framework: Nuxt.js');
+    console.log('  - TypeScript: enabled');
+    console.log('  - Vue: 3.x');
+    console.log('  - Build Tool: Vite');
+    console.log(`  - Port: ${_context.port}`);
+  },
+
+  onComplete: async (_context, _outputPath) => {
+    // Skip additional setup in test environment
+    if (process.env.NODE_ENV === 'test') {
+      console.log('⊘ Skipping additional setup in test environment');
+      return;
+    }
+
+    console.log('\n✓ Nuxt.js project setup completed!');
+    console.log('  You can now start the development server');
+  },
+};
+
+export default config;

package/lib/__templates__/nuxt-vue/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  // https://nuxt.com/docs/guide/concepts/typescript
+  "files": [],
+  "references": [
+    {
+      "path": "./.nuxt/tsconfig.app.json"
+    },
+    {
+      "path": "./.nuxt/tsconfig.server.json"
+    },
+    {
+      "path": "./.nuxt/tsconfig.shared.json"
+    },
+    {
+      "path": "./.nuxt/tsconfig.node.json"
+    }
+  ]
+}

package/lib/__templates__/taro/.coze

@@ -0,0 +1,14 @@
+[project]
+entrypoint = "server.js"
+requires = ["nodejs-24"]
+
+[dev]
+build = ["bash", ".cozeproj/scripts/dev_build.sh"]
+run = ["bash", ".cozeproj/scripts/dev_run.sh"]
+deps = ["git"] # -> apt install git
+pack = ["bash", ".cozeproj/scripts/pack.sh"]
+
+[deploy]
+build = ["bash", ".cozeproj/scripts/deploy_build.sh"]
+run = ["bash", ".cozeproj/scripts/deploy_run.sh"]
+deps = ["git"] # -> apt install git

package/lib/__templates__/taro/.cozeproj/scripts/deploy_build.sh

@@ -0,0 +1,19 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+cd "${COZE_WORKSPACE_PATH}"
+if [ -f "./.cozeproj/scripts/init_env.sh" ]; then
+    echo "⚙️ Initializing environment..."
+    # 使用 bash 执行，确保即使没有 x 权限也能跑
+    bash ./.cozeproj/scripts/init_env.sh
+else
+    echo "⚠️ Warning: init_env.sh not found, skipping environment init."
+fi
+echo "Installing dependencies..."
+# 安装所有依赖（包含 Taro 核心和 React）
+pnpm install
+
+echo "Building the Taro project..."
+pnpm build
+
+echo "Build completed successfully! Assets are in /dist"

package/lib/__templates__/taro/.cozeproj/scripts/deploy_run.sh

@@ -0,0 +1,14 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+start_service() {
+    cd "${COZE_WORKSPACE_PATH}/server/dist"
+
+    local port="${DEPLOY_RUN_PORT:-3000}"
+    echo "Starting Static File Server on port ${port} for deploy..."
+
+    node ./main.js -p "${port}"
+}
+
+echo "Starting HTTP service for deploy..."
+start_service

package/lib/__templates__/taro/.cozeproj/scripts/dev_build.sh

@@ -0,0 +1,2 @@
+#!/bin/bash
+set -Eeuo pipefail

package/lib/__templates__/taro/.cozeproj/scripts/dev_run.sh

@@ -0,0 +1,151 @@
+#!/bin/bash
+echo "⚙️ dev_run.sh 开始运行"
+set -Eeuo pipefail
+
+cd "${COZE_WORKSPACE_PATH}"
+
+# ---------------------------------------------------------
+# PID 文件，用于追踪上一次启动的进程树
+# ---------------------------------------------------------
+PID_FILE="/tmp/coze-dev-run.pid"
+
+# ---------------------------------------------------------
+# 工具函数
+# ---------------------------------------------------------
+kill_process_tree() {
+    local pid=$1
+    local children
+    children=$(pgrep -P "${pid}" 2>/dev/null || true)
+    for child in ${children}; do
+        kill_process_tree "${child}"
+    done
+    if kill -0 "${pid}" 2>/dev/null; then
+        echo "Killing PID ${pid}"
+        kill -9 "${pid}" 2>/dev/null || true
+    fi
+}
+
+kill_port_if_listening() {
+    local port=$1
+    local pids
+    pids=$(ss -H -lntp 2>/dev/null | awk -v port="${port}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | sort -u | paste -sd' ' - || true)
+    if [[ -z "${pids}" ]]; then
+        echo "Port ${port} is free."
+        return
+    fi
+    echo "Port ${port} in use by PIDs: ${pids}"
+    for pid in ${pids}; do
+        kill_process_tree "${pid}"
+    done
+    sleep 1
+    pids=$(ss -H -lntp 2>/dev/null | awk -v port="${port}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | sort -u | paste -sd' ' - || true)
+    if [[ -n "${pids}" ]]; then
+        echo "Warning: port ${port} still busy after cleanup, PIDs: ${pids}"
+    else
+        echo "Port ${port} cleared."
+    fi
+}
+
+# ---------------------------------------------------------
+# 1. 清理上一次运行残留的整棵进程树
+# ---------------------------------------------------------
+cleanup_previous_run() {
+    # 1a. 通过 PID 文件清理上次的进程树
+    if [[ -f "${PID_FILE}" ]]; then
+        local old_pid
+        old_pid=$(cat "${PID_FILE}" 2>/dev/null || true)
+        if [[ -n "${old_pid}" ]] && kill -0 "${old_pid}" 2>/dev/null; then
+            echo "🧹 Killing previous dev process tree (root PID: ${old_pid})..."
+            kill_process_tree "${old_pid}"
+        fi
+        rm -f "${PID_FILE}"
+    fi
+
+    # 1b. 兜底：按特征匹配清理所有残留的相关进程（排除自身）
+    echo "🧹 Cleaning up any orphaned dev processes..."
+    local patterns=(
+        "pnpm dev"
+        "concurrently.*dev:web.*dev:server"
+        "nest start --watch"
+        "taro build --type h5 --watch"
+        "node --enable-source-maps.*/workspace/projects/server/dist/main"
+        "esbuild --service.*--ping"
+    )
+    for pattern in "${patterns[@]}"; do
+        local pids
+        pids=$(pgrep -f "${pattern}" 2>/dev/null || true)
+        for pid in ${pids}; do
+            # 不杀自己和自己的父进程链
+            if [[ "${pid}" != "$$" ]] && [[ "${pid}" != "${PPID}" ]]; then
+                echo "  Killing orphan PID ${pid} matching '${pattern}'"
+                kill -9 "${pid}" 2>/dev/null || true
+            fi
+        done
+    done
+    sleep 1
+}
+
+# ---------------------------------------------------------
+# 2. 安装依赖
+# ---------------------------------------------------------
+echo "📦 Installing dependencies..."
+pnpm install
+echo "✅ Dependencies installed successfully!"
+
+# ---------------------------------------------------------
+# 3. 清理旧进程 + 端口
+# ---------------------------------------------------------
+SERVER_PORT=3000
+
+cleanup_previous_run
+
+echo "Clearing port ${DEPLOY_RUN_PORT} (web) before start."
+kill_port_if_listening "${DEPLOY_RUN_PORT}"
+echo "Clearing port ${SERVER_PORT} (server) before start."
+kill_port_if_listening "${SERVER_PORT}"
+
+# ---------------------------------------------------------
+# 4. 退出时自动清理子进程（信号 trap）
+# ---------------------------------------------------------
+cleanup_on_exit() {
+    echo "🛑 dev_run.sh exiting, cleaning up child processes..."
+    # 杀掉当前脚本的所有子进程
+    kill -- -$$ 2>/dev/null || true
+    rm -f "${PID_FILE}"
+    exit 0
+}
+trap cleanup_on_exit EXIT INT TERM HUP
+
+# ---------------------------------------------------------
+# 5. 启动服务
+# ---------------------------------------------------------
+start_service() {
+    cd "${COZE_WORKSPACE_PATH}"
+
+    # 动态注入环境变量
+    if [ -n "${COZE_PROJECT_DOMAIN_DEFAULT:-}" ]; then
+        export PROJECT_DOMAIN="$COZE_PROJECT_DOMAIN_DEFAULT"
+        echo "✅ 环境变量已动态注入: PROJECT_DOMAIN=$PROJECT_DOMAIN"
+    else
+        echo "⚠️  警告: COZE_PROJECT_DOMAIN_DEFAULT 未设置，使用 .env.local 中的配置"
+    fi
+
+    # 启动 Taro H5 和 NestJS Server
+    echo "Starting Taro H5 Dev Server and NestJS Server..."
+
+    export PORT=${DEPLOY_RUN_PORT}
+    rm -f /tmp/coze-logs/dev.log
+    mkdir -p /tmp/coze-logs
+
+    # 后台启动并记录 PID
+    pnpm dev 2>&1 | tee /tmp/coze-logs/dev.log &
+    local dev_pid=$!
+    echo "${dev_pid}" > "${PID_FILE}"
+    echo "📝 Dev process started with PID: ${dev_pid} (saved to ${PID_FILE})"
+
+    # 前台等待，保证 trap 能正常捕获信号
+    wait "${dev_pid}" || true
+}
+
+echo "Starting HTTP services on port ${DEPLOY_RUN_PORT} (web) and ${SERVER_PORT} (server)..."
+start_service

package/lib/__templates__/taro/.cozeproj/scripts/init_env.sh

@@ -0,0 +1,5 @@
+#!/bin/bash
+
+cd "${COZE_WORKSPACE_PATH}"
+
+echo "✅ 初始化完成"

package/lib/__templates__/taro/.cozeproj/scripts/pack.sh

@@ -0,0 +1,24 @@
+# build_weapp.sh - 通过 PID 文件精确杀掉自己上次的构建进程
+export OUTPUT_ROOT=dist
+PID_FILE="/tmp/coze-build_weapp.pid"
+
+# 杀掉上次的构建进程组
+if [ -f "$PID_FILE" ]; then
+    OLD_PID=$(cat "$PID_FILE")
+    if kill -0 "$OLD_PID" 2>/dev/null; then
+        echo "正在终止上次的构建进程组 (PID: $OLD_PID)..."
+        # 关键：kill 负数 PID = 杀掉整个进程组
+        kill -9 -"$OLD_PID" 2>/dev/null
+        sleep 1
+    fi
+    rm -f "$PID_FILE"
+fi
+
+# 用 setsid 创建新的进程组，方便下次整组杀掉
+setsid pnpm build:weapp &
+echo $! > "$PID_FILE"
+
+echo "构建已启动 (PID: $(cat $PID_FILE))"
+
+wait $!
+rm -f "$PID_FILE"