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

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,32 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+# 优先使用 COZE_E2E_PORT（E2E 测试专用），否则使用默认值
+PORT="${COZE_E2E_PORT:-<%= port %>}"
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+DEPLOY_RUN_PORT="${COZE_E2E_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,15 @@
+#!/bin/bash
+set -Eeuo pipefail
+
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+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/deploy_build.sh

@@ -2,10 +2,10 @@
 set -Eeuo pipefail
 
 cd "${COZE_WORKSPACE_PATH}"
-if [ -f "./.cozeproj/init_env.sh" ]; then
+if [ -f "./.cozeproj/scripts/init_env.sh" ]; then
     echo "⚙️ Initializing environment..."
     # 使用 bash 执行，确保即使没有 x 权限也能跑
-    bash ./.cozeproj/init_env.sh
+    bash ./.cozeproj/scripts/init_env.sh
 else
     echo "⚠️ Warning: init_env.sh not found, skipping environment init."
 fi

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

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

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

@@ -1,17 +1,2 @@
 #!/bin/bash
 set -Eeuo pipefail
-
-cd "${COZE_WORKSPACE_PATH}"
-if [ -f "./.cozeproj/init_env.sh" ]; then
-    echo "⚙️ Initializing environment..."
-    # 使用 bash 执行，确保即使没有 x 权限也能跑
-    bash ./.cozeproj/init_env.sh
-else
-    echo "⚠️ Warning: init_env.sh not found, skipping environment init."
-fi
-
-echo "Installing dependencies..."
-pnpm install --offline --frozen-lockfile --reporter=silent || \
-pnpm install --reporter=silent
-
-echo "Dependencies installed successfully!"

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

@@ -1,58 +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 | 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} (SIGKILL)"
-    echo "${pids}" | xargs -I {} kill -9 {}
+    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 | 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 SIGKILL, PIDs: ${pids}"
+        echo "Warning: port ${port} still busy after cleanup, PIDs: ${pids}"
     else
-      echo "Port ${port} cleared."
+        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}"
 
-    # ---------------------------------------------------------
-    # 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
-}
+    # 后台启动并记录 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
+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

@@ -10,7 +10,7 @@
 - **样式**: TailwindCSS 4.1.18
 - **Tailwind 适配层**: weapp-tailwindcss 4.9.2
 - **状态管理**: Zustand 5.0.9
-- **图标库**: lucide-react 0.511.0
+- **图标库**: lucide-react-taro latest
 - **工程化**: Vite 4.2.0
 - **包管理**: pnpm
 - **运行时**: Node.js >= 18
@@ -28,14 +28,16 @@
 │   ├── dev.ts                # 开发环境配置
 │   └── prod.ts               # 生产环境配置
 ├── server/                   # NestJS 后端服务
-│   └── src/  
+│   └── src/
 │       ├── main.ts           # 服务入口
 │       ├── app.module.ts     # 根模块
 │       ├── app.controller.ts # 应用控制器
 │       └── app.service.ts    # 应用服务
 ├── src/                      # 前端源码
 │   ├── pages/                # 页面组件
+│   ├── presets/              # 框架预置逻辑（无需读取，如无必要不改动）
 │   ├── utils/                # 工具函数
+│   ├── network.ts            # 封装好的网络请求工具
 │   ├── app.ts                # 应用入口
 │   ├── app.config.ts         # 应用配置
 │   └── app.css               # 全局样式
@@ -237,8 +239,8 @@ Network 是对 Taro.request、Taro.uploadFile、Taro.downloadFile 的封装，
 import { Network } from '@/network'
 
 // GET 请求
-const data = await Network.request({ 
-  url: '/api/hello' 
+const data = await Network.request({
+  url: '/api/hello'
 })
 
 // POST 请求
@@ -267,8 +269,8 @@ await Network.downloadFile({
 import Taro from '@tarojs/taro'
 
 // ❌ 会导致自动域名拼接无法生效，除非是特殊指定域名
-const data = await Network.request({ 
-  url: 'http://localhost/api/hello' 
+const data = await Network.request({
+  url: 'http://localhost/api/hello'
 })
 
 // ❌ 不要直接使用 Taro.request
@@ -344,23 +346,29 @@ const router = useRouter()
 const { id } = router.params
 ```
 
-### 图标使用 (lucide-react)
+### 图标使用 (lucide-react-taro)
+
+**IMPORTANT: 禁止使用 lucide-react，必须使用 lucide-react-taro 替代。**
 
-项目集成了 [lucide-react](https://lucide.dev/) 图标库，提供丰富的 SVG 图标：
+lucide-react-taro 是 Lucide 图标库的 Taro 适配版本，专为小程序环境优化，API 与 lucide-react 一致：
 
 ```tsx
 import { View } from '@tarojs/components'
-import { Home, Settings, User, Search, Heart, Star } from 'lucide-react'
+import { House, Settings, User, Search, Camera, Zap } from 'lucide-react-taro'
 
 const IconDemo = () => {
   return (
     <View className="flex gap-4">
-      <Home size={24} color="#333" />
-      <Settings size={24} className="text-blue-500" />
-      <User size={20} strokeWidth={1.5} />
-      <Search size={24} />
-      <Heart size={24} fill="red" color="red" />
-      <Star size={24} className="text-yellow-500" />
+      {/* 基本用法 */}
+      <House />
+      {/* 自定义尺寸和颜色 */}
+      <Settings size={32} color="#1890ff" />
+      {/* 自定义描边宽度 */}
+      <User size={24} strokeWidth={1.5} />
+      {/* 绝对描边宽度（描边不随 size 缩放） */}
+      <Camera size={48} strokeWidth={2} absoluteStrokeWidth />
+      {/* 组合使用 */}
+      <Zap size={32} color="#ff6b00" strokeWidth={1.5} className="my-icon" />
     </View>
   )
 }
@@ -368,12 +376,68 @@ const IconDemo = () => {
 
 常用属性：
 - `size` - 图标大小（默认 24）
-- `color` - 图标颜色
+- `color` - 图标颜色（默认 currentColor，小程序中建议显式设置）
 - `strokeWidth` - 线条粗细（默认 2）
-- `className` - 支持 Tailwind 类名
+- `absoluteStrokeWidth` - 绝对描边宽度，启用后描边不随 size 缩放
+- `className` / `style` - 自定义样式
 
 更多图标请访问：https://lucide.dev/icons
 
+### TabBar 图标生成 (CLI 工具)
+
+**IMPORTANT: 微信小程序的 TabBar 不支持 base64 或 SVG 图片，必须使用本地 PNG 文件。**
+
+lucide-react-taro 提供了 CLI 工具来生成 TabBar 所需的 PNG 图标：
+
+```bash
+# 生成带选中状态的图标
+npx taro-lucide-tabbar House Settings User -c "#999999" -a "#1890ff"
+
+# 指定输出目录和尺寸
+npx taro-lucide-tabbar House Settings User -c "#999999" -a "#1890ff" -o ./src/assets/tabbar -s 81
+```
+
+CLI 参数：
+- `--color, -c` (默认 #000000): 图标颜色
+- `--active-color, -a`: 选中状态颜色
+- `--size, -s` (默认 81): 图标尺寸
+- `--output, -o` (默认 ./tabbar-icons): 输出目录
+- `--stroke-width` (默认 2): 描边宽度
+
+在 `app.config.ts` 中使用生成的图标：
+
+> IMPORTANT：iconPath 和 selectedIconPath 必须以 `./` 开头，否则图标无法渲染
+
+```typescript
+export default defineAppConfig({
+  tabBar: {
+    color: '#999999',
+    selectedColor: '#1890ff',
+    backgroundColor: '#ffffff',
+    borderStyle: 'black',
+    list: [
+      {
+        pagePath: 'pages/index/index',
+        text: '首页',
+        iconPath: './assets/tabbar/house.png',
+        selectedIconPath: './assets/tabbar/house-active.png',
+      },
+      {
+        pagePath: 'pages/settings/index',
+        text: '设置',
+        iconPath: './assets/tabbar/settings.png',
+        selectedIconPath: './assets/tabbar/settings-active.png',
+      },
+      {
+        pagePath: 'pages/user/index',
+        text: '用户',
+        iconPath: './assets/tabbar/user.png',
+        selectedIconPath: './assets/tabbar/user-active.png',
+      },
+    ],
+  },
+})
+
 ### Tailwind CSS 样式开发
 
 IMPORTANT：必须使用 tailwindcss 实现样式，只有在必要情况下才能 fallback 到 css / less