@coze-arch/cli 0.0.1-alpha.bd5b49 → 0.0.1-alpha.c199b3

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/.cozeproj/scripts/dev_run.sh

@@ -1,80 +1,151 @@
 #!/bin/bash
-
 echo "⚙️ dev_run.sh 开始运行"
 set -Eeuo pipefail
 
 cd "${COZE_WORKSPACE_PATH}"
 
-echo "📦 Installing dependencies..."
-pnpm install
-echo "✅ Dependencies installed successfully!"
+# ---------------------------------------------------------
+# 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 | paste -sd' ' - || true)
+    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
+        echo "Port ${port} is free."
+        return
     fi
     echo "Port ${port} in use by PIDs: ${pids}"
     for pid in ${pids}; do
-      kill_process_tree "${pid}"
+        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 | paste -sd' ' - || true)
+    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}"
+        echo "Warning: port ${port} still busy after cleanup, PIDs: ${pids}"
     else
-      echo "Port ${port} cleared."
+        echo "Port ${port} cleared."
     fi
 }
 
-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
+# ---------------------------------------------------------
+# 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}"
 
-    # ---------------------------------------------------------
-    # 0. 动态注入环境变量
-    # ---------------------------------------------------------
-    if [ -n "$COZE_PROJECT_DOMAIN_DEFAULT" ]; then
+    # 动态注入环境变量
+    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..."
 
-    # ⚠️ 重要：为了让 Taro 使用平台动态分配的端口
     export PORT=${DEPLOY_RUN_PORT}
-
     rm -f /tmp/coze-logs/dev.log
     mkdir -p /tmp/coze-logs
 
-    exec pnpm dev 2>&1 | tee /tmp/coze-logs/dev.log
-}
+    # 后台启动并记录 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})"
 
-SERVER_PORT=<%= serverPort %>
+    # 前台等待，保证 trap 能正常捕获信号
+    wait "${dev_pid}" || true
+}
 
-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}"
 echo "Starting HTTP services on port ${DEPLOY_RUN_PORT} (web) and ${SERVER_PORT} (server)..."
 start_service

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

@@ -1 +1,24 @@
-pnpm build:weapp
+# 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"

package/lib/__templates__/taro/README.md

@@ -35,7 +35,9 @@
 │       └── app.service.ts    # 应用服务
 ├── src/                      # 前端源码
 │   ├── pages/                # 页面组件
+│   ├── presets/              # 框架预置逻辑（无需读取，如无必要不改动）
 │   ├── utils/                # 工具函数
+│   ├── network.ts            # 封装好的网络请求工具
 │   ├── app.ts                # 应用入口
 │   ├── app.config.ts         # 应用配置
 │   └── app.css               # 全局样式
@@ -103,56 +105,39 @@ pnpm preview:weapp # 构建并生成预览小程序二维码
 pnpm new      # 交互式创建页面/组件
 ```
 
-### 常用 Taro 组件
+### 组件库
 
-引入方式
+#### UI 组件
+
+UI 组件位于 `@/components/ui`，推荐按需引入：
 
 ```typescript
-import { Text } from '@tarojs/components'
-```
-- 基础组件
-  - Text
-  - Icon
-  - Progress
-  - RichText
-- 表单组件
-  - Button
-  - Checkbox
-  - CheckboxGroup
-  - Editor
-  - Form
-  - Input
-  - Label
-  - Picker
-  - PickerView
-  - PickerViewColumn
-  - Radio
-  - RadioGroup
-  - Slider
-  - Switch
-  - Textarea
-- 导航组件
-  - FunctionalPageNavigator
-  - NavigationBar
-  - Navigator
-  - TabItem
-  - Tabs
-- 媒体组件
-  - Camera
-  - Image
-  - Video
-- 视图容器
-  - ScrollView
-  - Swiper
-  - SwiperItem
-  - View
+import { Button } from '@/components/ui/button'
+import { Card, CardContent } from '@/components/ui/card'
+```
+
+UI 组件列表:
+
+Accordion,Alert,AlertDialog,AspectRatio,Avatar,Badge,Breadcrumb,Button,ButtonGroup,Calendar,Card,Carousel,Checkbox,CodeBlock,Collapsible,Command,ContextMenu,Dialog,Drawer,DropdownMenu,Field,HoverCard,Input,InputGroup,InputOTP,Label,Menubar,NavigationMenu,Pagination,Popover,Portal,Progress,RadioGroup,Resizable,ScrollArea,Select,Separator,Sheet,Skeleton,Slider,Sonner,Switch,Table,Tabs,Textarea,Toast,Toggle,ToggleGroup,Tooltip
+
+#### Taro 原生组件
+
+可以使用的 Taro 组件（UI 未覆盖）
+
+```typescript
+import { View, Text, Icon, Image } from '@tarojs/components'
+```
+
+Taro 原生组件列表：
+
+Text,Icon,RichText,CheckboxGroup,Editor,Form,Picker,PickerView,PickerViewColumn,Radio,FunctionalPageNavigator,NavigationBar,Navigator,TabItem,Camera,Image,Video,ScrollView,Swiper,SwiperItem,View
 
 ### 路径别名
 
 项目配置了 `@/*` 路径别名指向 `src/*`：
 
 ```typescript
-import { SomeComponent } from '@/components/SomeComponent'
+import { SomeComponent } from '@/components/some-component'
 import { useUserStore } from '@/stores/user'
 ```
 
@@ -162,9 +147,18 @@ import { useUserStore } from '@/stores/user'
 
 ```tsx
 // src/pages/example/index.tsx
-import { View, Text } from '@tarojs/components'
+import { View } from '@tarojs/components'
 import { useLoad, useDidShow } from '@tarojs/taro'
 import type { FC } from 'react'
+import { Button } from '@/components/ui/button'
+import {
+  Card,
+  CardContent,
+  CardDescription,
+  CardFooter,
+  CardHeader,
+  CardTitle,
+} from '@/components/ui/card'
 import './index.css'
 
 const ExamplePage: FC = () => {
@@ -177,8 +171,25 @@ const ExamplePage: FC = () => {
   })
 
   return (
-    <View className="flex flex-col items-center p-4">
-      <Text className="text-lg font-bold">Hello Taro!</Text>
+    <View className="p-4">
+      <Card>
+        <CardHeader>
+          <CardTitle>Hello Taro!</CardTitle>
+          <CardDescription>
+            页面布局用 Taro 基础组件，交互与视觉优先用项目内置 UI 组件。
+          </CardDescription>
+        </CardHeader>
+        <CardContent>
+          <View className="text-sm text-muted-foreground">
+            组件位于 src/components/ui，推荐按需从 @/components/ui/* 引入。
+          </View>
+        </CardContent>
+        <CardFooter className="justify-end">
+          <Button size="sm" onClick={() => console.log('clicked')}>
+            点击
+          </Button>
+        </CardFooter>
+      </Card>
     </View>
   )
 }
@@ -404,6 +415,8 @@ CLI 参数：
 
 在 `app.config.ts` 中使用生成的图标：
 
+> IMPORTANT：iconPath 和 selectedIconPath 必须以 `./` 开头，否则图标无法渲染
+
 ```typescript
 export default defineAppConfig({
   tabBar: {
@@ -441,10 +454,13 @@ IMPORTANT：必须使用 tailwindcss 实现样式，只有在必要情况下才
 > 项目已集成 Tailwind CSS 4.x + weapp-tailwindcss，支持跨端原子化样式：
 
 ```tsx
+import { View, Text } from '@tarojs/components'
+import { Button } from '@/components/ui/button'
+
 <View className="flex flex-col items-center justify-center min-h-screen bg-gray-100">
   <Text className="text-2xl font-bold text-blue-600 mb-4">标题</Text>
   <View className="w-full px-4">
-    <Button className="w-full bg-blue-500 text-white rounded-lg py-3">
+    <Button className="w-full" size="lg">
       按钮
     </Button>
   </View>