@coze-arch/cli 0.0.1-alpha.d49256 → 0.0.1-alpha.d4acfb

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

package/lib/__templates__/taro/config/index.ts

@@ -1,22 +1,75 @@
+import fs from 'node:fs';
 import path from 'node:path';
-import dotenv from 'dotenv';
 
 import tailwindcss from '@tailwindcss/postcss';
 import { UnifiedViteWeappTailwindcssPlugin } from 'weapp-tailwindcss/vite';
 import { defineConfig, type UserConfigExport } from '@tarojs/cli';
 import type { PluginItem } from '@tarojs/taro/types/compile/config/project';
-
-// 加载环境变量
-dotenv.config({ path: path.resolve(__dirname, '../.env.local') });
-
+import dotenv from 'dotenv';
 import devConfig from './dev';
 import prodConfig from './prod';
 import pkg from '../package.json';
 
+dotenv.config({ path: path.resolve(__dirname, '../.env.local') });
+
+const generateTTProjectConfig = () => {
+  const config = {
+    miniprogramRoot: './',
+    projectname: '<%= appName %>',
+    appid: process.env.TARO_APP_TT_APPID || '',
+    setting: {
+      urlCheck: false,
+      es6: false,
+      postcss: false,
+      minified: false,
+    },
+  };
+  const outputDir = path.resolve(__dirname, '../dist-tt');
+  if (!fs.existsSync(outputDir)) {
+    fs.mkdirSync(outputDir, { recursive: true });
+  }
+  fs.writeFileSync(
+    path.resolve(outputDir, 'project.config.json'),
+    JSON.stringify(config, null, 2),
+  );
+};
+
 // https://taro-docs.jd.com/docs/next/config#defineconfig-辅助函数
 export default defineConfig<'vite'>(async (merge, _env) => {
-  const isWeChatApp = process.env.TARO_ENV === 'weapp';
-  const outputRoot = isWeChatApp ? 'dist' : 'dist-web';
+  const outputRootMap: Record<string, string> = {
+    weapp: 'dist',
+    tt: 'dist-tt',
+    h5: 'dist-web',
+  };
+  const outputRoot = outputRootMap[process.env.TARO_ENV || ''] || 'dist-web';
+
+  const buildMiniCIPluginConfig = () => {
+    const hasWeappConfig = !!process.env.TARO_APP_WEAPP_APPID
+    const hasTTConfig = !!process.env.TARO_APP_TT_EMAIL
+    if (!hasWeappConfig && !hasTTConfig) {
+        return []
+    }
+    const miniCIConfig: Record<string, any> = {
+        version: pkg.version,
+        desc: pkg.description,
+    }
+    if (hasWeappConfig) {
+        miniCIConfig.weapp = {
+            appid: process.env.TARO_APP_WEAPP_APPID,
+            privateKeyPath: 'key/private.appid.key',
+        }
+    }
+    if (hasTTConfig) {
+        miniCIConfig.tt = {
+            email: process.env.TARO_APP_TT_EMAIL,
+            password: process.env.TARO_APP_TT_PASSWORD,
+            setting: {
+                skipDomainCheck: true,
+            },
+        }
+    }
+    return [['@tarojs/plugin-mini-ci', miniCIConfig]] as PluginItem[]
+  }
 
   const baseConfig: UserConfigExport<'vite'> = {
     projectName: '<%= appName %>',
@@ -33,24 +86,7 @@ export default defineConfig<'vite'>(async (merge, _env) => {
     },
     sourceRoot: 'src',
     outputRoot,
-    plugins: [
-      '@tarojs/plugin-generator',
-      ...(process.env.TARO_APP_WEAPP_APPID
-        ? ([
-            [
-              '@tarojs/plugin-mini-ci',
-              {
-                version: pkg.version,
-                desc: pkg.description,
-                weapp: {
-                  appid: process.env.TARO_APP_WEAPP_APPID,
-                  privateKeyPath: 'key/private.appid.key',
-                },
-              },
-            ],
-          ] as PluginItem[])
-        : []),
-    ],
+            plugins: ['@tarojs/plugin-generator', ...buildMiniCIPluginConfig()],
     defineConstants: {
       PROJECT_DOMAIN: JSON.stringify(
         process.env.PROJECT_DOMAIN ||
@@ -63,6 +99,13 @@ export default defineConfig<'vite'>(async (merge, _env) => {
       patterns: [],
       options: {},
     },
+    ...(process.env.TARO_ENV === 'tt' && {
+      tt: {
+        appid: process.env.TARO_APP_TT_APPID,
+        projectName: '<%= appName %>',
+      },
+    }),
+    jsMinimizer: 'esbuild',
     framework: 'react',
     compiler: {
       type: 'vite',
@@ -97,11 +140,18 @@ export default defineConfig<'vite'>(async (merge, _env) => {
         },
         UnifiedViteWeappTailwindcssPlugin({
           rem2rpx: true,
-          cssEntries: [
-            // 你 @import "tailwindcss"; 那个文件的绝对路径
-            path.resolve(__dirname, '../src/app.css'),
-          ],
+          cssEntries: [path.resolve(__dirname, '../src/app.css')],
         }),
+        ...(process.env.TARO_ENV === 'tt'
+          ? [
+              {
+                name: 'generate-tt-project-config',
+                closeBundle() {
+                  generateTTProjectConfig();
+                },
+              },
+            ]
+          : []),
       ],
     },
     mini: {
@@ -123,15 +173,15 @@ export default defineConfig<'vite'>(async (merge, _env) => {
       publicPath: '/',
       staticDirectory: 'static',
       devServer: {
-          port: <%= port %>,
-          host: '0.0.0.0',
-          open: false,
-          proxy: {
-            '/api': {
-              target: 'http://localhost:<%= serverPort %>',
-              changeOrigin: true,
-            },
+        port: <%= port %>,
+        host: '0.0.0.0',
+        open: false,
+        proxy: {
+          '/api': {
+            target: 'http://localhost:<%= serverPort %>',
+            changeOrigin: true,
           },
+        },
       },
       miniCssExtractPluginOption: {
         ignoreOrder: true,

package/lib/__templates__/taro/config/prod.ts

@@ -1,10 +1,9 @@
-import type { UserConfigExport } from "@tarojs/cli"
+import type { UserConfigExport } from '@tarojs/cli';
 
 export default {
   mini: {},
   h5: {
-    // 确保产物为 es5
-    legacy: true,
+    legacy: false,
     /**
      * WebpackChain 插件配置
      * @docs https://github.com/neutrinojs/webpack-chain
@@ -31,5 +30,5 @@ export default {
     //       postProcess: (context) => ({ ...context, outputPath: path.join(staticDir, 'index.html') })
     //     }))
     // }
-  }
-} satisfies UserConfigExport<'vite'>
+  },
+} satisfies UserConfigExport<'vite'>;

package/lib/__templates__/taro/eslint.config.mjs

@@ -16,6 +16,7 @@ export default [
       'react/jsx-uses-react': 'off',
       'react/react-in-jsx-scope': 'off',
       'jsx-quotes': ['error', 'prefer-double'],
+      'react-hooks/exhaustive-deps': 'off',
     },
   },
   {
@@ -28,7 +29,13 @@ export default [
           selector:
             "MemberExpression[object.name='process'][property.name='env']",
           message:
-            '请勿在 src 目录下直接使用 process.env\n如需获取 URL 请求前缀，请使用已经注入全局的 PROJECT_DOMAIN()',
+            '请勿在 src 目录下直接使用 process.env\n如需获取 URL 请求前缀，请使用已经注入全局的 PROJECT_DOMAIN',
+        },
+        {
+          selector:
+            ":matches(ExportNamedDeclaration, ExportDefaultDeclaration) :matches([id.name='Network'], [declaration.id.name='Network'])",
+          message:
+            "禁止自行定义 Network，项目已提供 src/network.ts，请直接使用: import { Network } from '@/network'",
         },
       ],
       'no-restricted-properties': [
@@ -36,17 +43,33 @@ export default [
         {
           object: 'Taro',
           property: 'request',
-          message: '请使用 Network.request 替代 Taro.request',
+          message:
+            "请使用 Network.request 替代 Taro.request，导入方式: import { Network } from '@/network'",
         },
         {
           object: 'Taro',
           property: 'uploadFile',
-          message: '请使用 Network.uploadFile 替代 Taro.uploadFile',
+          message:
+            "请使用 Network.uploadFile 替代 Taro.uploadFile，导入方式: import { Network } from '@/network'",
         },
         {
           object: 'Taro',
           property: 'downloadFile',
-          message: '请使用 Network.downloadFile 替代 Taro.downloadFile',
+          message:
+            "请使用 Network.downloadFile 替代 Taro.downloadFile，导入方式: import { Network } from '@/network'",
+        },
+      ],
+    },
+  },
+  {
+    files: ['src/pages/index/index.tsx'],
+    rules: {
+      'no-restricted-syntax': [
+        'error',
+        {
+          selector: 'JSXText[value=/应用开发中/]',
+          message:
+            '检测到首页 (src/pages/index/index) 仍为默认占位页面，这会导致用户无法进入新增页面，请根据用户需求开发实际的首页功能和界面。如果已经开发了新的首页，也需要删除旧首页，并更新 src/app.config.ts 文件',
         },
       ],
     },

package/lib/__templates__/taro/package.json

@@ -4,22 +4,27 @@
   "private": true,
   "description": "Coze Mini Program Application",
   "scripts": {
-    "build": "pnpm exec concurrently -n lint,tsc,web,weapp,server -c red,blue,green,yellow,magenta \"pnpm lint:build\" \"pnpm tsc\" \"pnpm build:web\" \"pnpm build:weapp\" \"pnpm build:server\"",
+    "build": "pnpm exec concurrently --kill-others-on-fail --kill-signal SIGKILL -n lint,tsc,web,weapp,tt,server -c red,blue,green,yellow,cyan,magenta \"pnpm lint:build\" \"pnpm tsc\" \"pnpm build:web\" \"pnpm build:weapp\" \"pnpm build:tt\" \"pnpm build:server\"",
     "build:server": "pnpm --filter server build",
+    "build:tt": "taro build --type tt",
     "build:weapp": "taro build --type weapp",
     "build:web": "taro build --type h5",
-    "dev": "pnpm exec concurrently -n web,server -c blue,green \"pnpm dev:web\" \"pnpm dev:server\"",
+    "dev": "pnpm exec concurrently --kill-others --kill-signal SIGKILL -n web,server -c blue,green \"pnpm dev:web\" \"pnpm dev:server\"",
     "dev:server": "pnpm --filter server dev",
+    "dev:tt": "taro build --type tt --watch",
     "dev:weapp": "taro build --type weapp --watch",
     "dev:web": "taro build --type h5 --watch",
     "preinstall": "npx only-allow pnpm",
     "postinstall": "weapp-tw patch",
+    "kill:all": "pkill -9 -f 'concurrently' 2>/dev/null || true; pkill -9 -f 'nest start' 2>/dev/null || true; pkill -9 -f 'taro build' 2>/dev/null || true; pkill -9 -f 'node.*dev' 2>/dev/null || true; echo 'All dev processes cleaned'",
     "lint": "eslint \"src/**/*.{js,jsx,ts,tsx}\"",
     "lint:build": "eslint \"src/**/*.{js,jsx,ts,tsx}\" --max-warnings=0",
     "lint:fix": "eslint \"src/**/*.{js,jsx,ts,tsx}\" --fix",
     "new": "taro new",
+    "preview:tt": "taro build --type tt --preview",
     "preview:weapp": "taro build --type weapp --preview",
-    "tsc": "npx tsc --noEmit --skipLibCheck"
+    "tsc": "npx tsc --noEmit --skipLibCheck",
+    "validate": "pnpm exec concurrently --kill-others-on-fail --kill-signal SIGKILL -n lint,tsc -c red,blue \"pnpm lint:build\" \"pnpm tsc\""
   },
   "lint-staged": {
     "src/**/*.{js,jsx,ts,tsx}": [
@@ -37,13 +42,14 @@
     "@tarojs/helper": "4.1.9",
     "@tarojs/plugin-framework-react": "4.1.9",
     "@tarojs/plugin-platform-h5": "4.1.9",
+    "@tarojs/plugin-platform-tt": "4.1.9",
     "@tarojs/plugin-platform-weapp": "4.1.9",
     "@tarojs/react": "4.1.9",
     "@tarojs/runtime": "4.1.9",
     "@tarojs/shared": "4.1.9",
     "@tarojs/taro": "4.1.9",
     "drizzle-kit": "^0.31.8",
-    "lucide-react": "^0.511.0",
+    "lucide-react-taro": "^1.2.0",
     "react": "^18.0.0",
     "react-dom": "^18.0.0",
     "zustand": "^5.0.9"
@@ -78,6 +84,7 @@
     "stylelint-config-standard": "^38.0.0",
     "tailwindcss": "^4.1.18",
     "terser": "^5.30.4",
+    "tt-ide-cli": "^0.1.31",
     "typescript": "^5.4.5",
     "vite": "^4.2.0",
     "weapp-tailwindcss": "^4.9.2"
@@ -86,6 +93,11 @@
   "engines": {
     "pnpm": ">=9.0.0"
   },
+  "pnpm": {
+    "patchedDependencies": {
+      "@tarojs/plugin-mini-ci@4.1.9": "patches/@tarojs__plugin-mini-ci@4.1.9.patch"
+    }
+  },
   "templateInfo": {
     "name": "default",
     "typescript": true,

package/lib/__templates__/taro/patches/@tarojs__plugin-mini-ci@4.1.9.patch

@@ -0,0 +1,30 @@
+diff --git a/dist/TTCI.js b/dist/TTCI.js
+index e5fe6a5f9a0ca8670ffa2b7e14cdfd8d49d0d792..6f24020a3388ea8fc7d1cbc41c1df104a8c37cb8 100644
+--- a/dist/TTCI.js
++++ b/dist/TTCI.js
+@@ -63,7 +63,10 @@ class TTCI extends BaseCi_1.default {
+                     output: previewQrcodePath,
+                 },
+                 copyToClipboard: true,
+-                cache: true
++                cache: true,
++                ideConfig: {
++                    skipDomainCheck: this.pluginOpts.tt && this.pluginOpts.tt.setting && this.pluginOpts.tt.setting.skipDomainCheck
++                }
+             });
+             console.log(chalk.green(`开发版上传成功 ${new Date().toLocaleString()}\n`));
+             const qrContent = previewResult.shortUrl;
+diff --git a/dist/index.js b/dist/index.js
+index bb245e34a477bcd738b18fdd754b252a456efe4f..588fe56131be52de2d798ee959ef257b4fa53313 100644
+--- a/dist/index.js
++++ b/dist/index.js
+@@ -43,7 +43,8 @@ exports.default = (ctx, _pluginOpts) => {
+             /** 字节跳动小程序上传配置 */
+             tt: joi.object({
+                 email: joi.string().required(),
+-                password: joi.string().required()
++                password: joi.string().required(),
++                setting: joi.object()
+             }),
+             /** 阿里小程序上传配置 */
+             alipay: joi.alternatives().try(joi.object({