@coze-arch/cli 0.0.1-alpha.d5effa → 0.0.1-alpha.de5a13

package/lib/__templates__/taro/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+packages:
+  - 'server'

package/lib/__templates__/taro/project.config.json

@@ -0,0 +1,15 @@
+{
+  "miniprogramRoot": "./dist",
+  "projectname": "<%= appName %>",
+  "description": "test",
+  "appid": "touristappid",
+  "setting": {
+    "urlCheck": true,
+    "es6": false,
+    "enhance": false,
+    "compileHotReLoad": false,
+    "postcss": false,
+    "minified": false
+  },
+  "compileType": "miniprogram"
+}

package/lib/__templates__/taro/server/nest-cli.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "https://json.schemastore.org/nest-cli",
+  "collection": "@nestjs/schematics",
+  "sourceRoot": "src",
+  "compilerOptions": {
+    "deleteOutDir": true,
+    "exclude": ["node_modules", "dist", ".git", "../dist", "../src"]
+  },
+  "webpack": true
+}

package/lib/__templates__/taro/server/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "server",
+  "version": "1.0.0",
+  "private": true,
+  "description": "NestJS server application",
+  "scripts": {
+    "build": "nest build",
+    "dev": "nest start --watch",
+    "start": "nest start",
+    "start:debug": "nest start --debug --watch",
+    "start:prod": "node dist/main"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.958.0",
+    "@aws-sdk/lib-storage": "^3.958.0",
+    "@nestjs/common": "^10.4.15",
+    "@nestjs/core": "^10.4.15",
+    "@nestjs/platform-express": "^10.4.15",
+    "better-sqlite3": "^11.9.1",
+    "coze-coding-dev-sdk": "^0.7.15",
+    "drizzle-kit": "^0.31.8",
+    "drizzle-orm": "^0.45.1",
+    "drizzle-zod": "^0.8.3",
+    "express": "5.2.1",
+    "pg": "^8.16.3",
+    "rxjs": "^7.8.1",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^10.4.9",
+    "@nestjs/schematics": "^10.2.3",
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/express": "5.0.6",
+    "@types/node": "^22.10.2",
+    "drizzle-kit": "^0.31.8",
+    "typescript": "^5.7.2"
+  }
+}

package/lib/__templates__/taro/server/src/app.controller.ts

@@ -0,0 +1,23 @@
+import { Controller, Get } from '@nestjs/common';
+import { AppService } from '@/app.service';
+
+@Controller()
+export class AppController {
+  constructor(private readonly appService: AppService) {}
+
+  @Get('hello')
+  getHello(): { status: string; data: string } {
+    return {
+      status: 'success',
+      data: this.appService.getHello()
+    };
+  }
+
+  @Get('health')
+  getHealth(): { status: string; data: string } {
+    return {
+      status: 'success',
+      data: new Date().toISOString(),
+    };
+  }
+}

package/lib/__templates__/taro/server/src/app.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { AppController } from '@/app.controller';
+import { AppService } from '@/app.service';
+
+@Module({
+  imports: [],
+  controllers: [AppController],
+  providers: [AppService],
+})
+export class AppModule {}

package/lib/__templates__/taro/server/src/app.service.ts

@@ -0,0 +1,8 @@
+import { Injectable } from '@nestjs/common';
+
+@Injectable()
+export class AppService {
+  getHello(): string {
+    return 'Hello, welcome to coze coding mini-program server!';
+  }
+}

package/lib/__templates__/taro/server/src/interceptors/http-status.interceptor.ts

@@ -0,0 +1,23 @@
+import {
+  Injectable,
+  NestInterceptor,
+  ExecutionContext,
+  CallHandler,
+} from '@nestjs/common';
+import { Observable } from 'rxjs';
+import { map } from 'rxjs/operators';
+
+@Injectable()
+export class HttpStatusInterceptor implements NestInterceptor {
+  intercept(context: ExecutionContext, next: CallHandler): Observable<any> {
+    const request = context.switchToHttp().getRequest();
+    const response = context.switchToHttp().getResponse();
+
+    // 如果是 POST 请求且状态码为 201，改为 200
+    if (request.method === 'POST' && response.statusCode === 201) {
+      response.status(200);
+    }
+
+    return next.handle();
+  }
+}

package/lib/__templates__/taro/server/src/main.ts

@@ -0,0 +1,49 @@
+import { NestFactory } from '@nestjs/core';
+import { AppModule } from '@/app.module';
+import * as express from 'express';
+import { HttpStatusInterceptor } from '@/interceptors/http-status.interceptor';
+
+function parsePort(): number {
+  const args = process.argv.slice(2);
+  const portIndex = args.indexOf('-p');
+  if (portIndex !== -1 && args[portIndex + 1]) {
+    const port = parseInt(args[portIndex + 1], 10);
+    if (!isNaN(port) && port > 0 && port < 65536) {
+      return port;
+    }
+  }
+  return <%= serverPort %>;
+}
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+
+  app.enableCors({
+    origin: true,
+    credentials: true,
+  });
+  app.setGlobalPrefix('api');
+  app.use(express.json({ limit: '50mb' }));
+  app.use(express.urlencoded({ limit: '50mb', extended: true }));
+
+  // 全局拦截器：统一将 POST 请求的 201 状态码改为 200
+  app.useGlobalInterceptors(new HttpStatusInterceptor());
+  // 1. 开启优雅关闭 Hooks (关键!)
+  app.enableShutdownHooks();
+
+  // 2. 解析端口
+  const port = parsePort();
+  try {
+    await app.listen(port);
+    console.log(`Server running on http://localhost:${port}`);
+  } catch (err) {
+    if (err.code === 'EADDRINUSE') {
+      console.error(`❌ 端口 \({port} 被占用! 请运行 'npx kill-port \){port}' 然后重试。`);
+      process.exit(1);
+    } else {
+      throw err;
+    }
+  }
+  console.log(`Application is running on: http://localhost:<%= serverPort %>`);
+}
+bootstrap();

package/lib/__templates__/taro/server/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "module": "commonjs",
+    "declaration": true,
+    "removeComments": true,
+    "emitDecoratorMetadata": true,
+    "experimentalDecorators": true,
+    "allowSyntheticDefaultImports": true,
+    "target": "ES2021",
+    "sourceMap": true,
+    "outDir": "./dist",
+    "baseUrl": "./",
+    "incremental": true,
+    "skipLibCheck": true,
+    "strictNullChecks": true,
+    "noImplicitAny": false,
+    "strictBindCallApply": false,
+    "forceConsistentCasingInFileNames": false,
+    "noFallthroughCasesInSwitch": false,
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  }
+}

package/lib/__templates__/taro/src/app.config.ts

@@ -0,0 +1,11 @@
+export default defineAppConfig({
+  pages: [
+    'pages/index/index'
+  ],
+  window: {
+    backgroundTextStyle: 'light',
+    navigationBarBackgroundColor: '#fff',
+    navigationBarTitleText: 'WeChat',
+    navigationBarTextStyle: 'black'
+  }
+})

package/lib/__templates__/taro/src/app.css

@@ -0,0 +1,63 @@
+@import url('tailwindcss');
+
+/*
+ * H5 端 rem 适配：与小程序 rpx 缩放一致
+ * 375px 屏幕：1rem = 16px，小程序 32rpx = 16px
+ */
+html {
+  font-size: 4vw !important;
+}
+
+/* 小程序页面容器高度设置，确保垂直居中生效 */
+/* stylelint-disable-next-line selector-type-no-unknown */
+page {
+  height: 100%;
+}
+
+/* H5 端组件默认样式修复 */
+taro-view-core {
+  display: block;
+}
+
+taro-text-core {
+  display: inline;
+}
+
+taro-input-core {
+  display: block;
+  width: 100%;
+}
+
+taro-input-core input {
+  width: 100%;
+  background: transparent;
+  border: none;
+  outline: none;
+}
+
+/* 全局按钮样式重置 */
+taro-button-core,
+button {
+  margin: 0 !important;
+  padding: 0 !important;
+  line-height: inherit;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+}
+
+taro-button-core::after,
+button::after {
+  border: none;
+}
+
+/* Vite 错误覆盖层无法选择文本的问题 */
+vite-error-overlay {
+  /* stylelint-disable-next-line property-no-vendor-prefix */
+  -webkit-user-select: text !important;
+}
+
+vite-error-overlay::part(window) {
+  max-width: 90vw;
+  padding: 10px;
+}

package/lib/__templates__/taro/src/app.ts

@@ -0,0 +1,14 @@
+import { PropsWithChildren } from 'react';
+import { useLaunch } from '@tarojs/taro';
+import { injectH5Styles } from '@/utils/h5-styles';
+import { enableWxDebugIfNeeded } from '@/utils/wx-debug';
+import '@/app.css';
+
+export default ({ children }: PropsWithChildren<any>) => {
+  useLaunch(() => {
+    enableWxDebugIfNeeded();
+    injectH5Styles();
+  });
+
+  return children;
+};

package/lib/__templates__/taro/src/index.html

@@ -0,0 +1,39 @@
+<!DOCTYPE html>
+<html>
+
+<head>
+  <meta content="text/html; charset=utf-8" http-equiv="Content-Type">
+  <meta content="width=device-width,initial-scale=1,user-scalable=no" name="viewport">
+  <meta name="apple-mobile-web-app-capable" content="yes">
+  <meta name="apple-touch-fullscreen" content="yes">
+  <meta name="format-detection" content="telephone=no,address=no">
+  <meta name="apple-mobile-web-app-status-bar-style" content="white">
+  <meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1">
+  <title><%= appName %></title>
+  <script><%%= htmlWebpackPlugin.options.script %></script>
+</head>
+
+<body>
+  <div id="app">
+    <svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="lab(2.86037 0.455312 0.568903)"
+      stroke-width="2" stroke-linecap="round" stroke-linejoin="round" style="
+        position: fixed;
+        inset: 0;
+        margin: auto;
+        width: 24px;
+        height: 24px;
+        animation: __app-loading-spin 1s linear infinite;
+      ">
+      <path d="M21 12a9 9 0 1 1-6.219-8.56" />
+    </svg>
+    <style>
+      @keyframes __app-loading-spin {
+        to {
+          transform: rotate(360deg);
+        }
+      }
+    </style>
+  </div>
+</body>
+
+</html>

package/lib/__templates__/taro/src/network.ts

@@ -0,0 +1,39 @@
+import Taro from '@tarojs/taro'
+
+/**
+ * 网络请求模块
+ * 封装 Taro.request、Taro.uploadFile、Taro.downloadFile，自动添加项目域名前缀
+ * 如果请求的 url 以 http:// 或 https:// 开头，则不会添加域名前缀
+ *
+ * IMPORTANT: 项目已经全局注入 PROJECT_DOMAIN
+ * IMPORTANT: 除非你需要添加全局参数，如给所有请求加上 header，否则不能修改此文件
+ */
+export namespace Network {
+    const createUrl = (url: string): string => {
+        if (url.startsWith('http://') || url.startsWith('https://')) {
+            return url
+        }
+        return `${PROJECT_DOMAIN}${url}`
+    }
+
+    export const request: typeof Taro.request = option => {
+        return Taro.request({
+            ...option,
+            url: createUrl(option.url),
+        })
+    }
+
+    export const uploadFile: typeof Taro.uploadFile = option => {
+        return Taro.uploadFile({
+            ...option,
+            url: createUrl(option.url),
+        })
+    }
+
+    export const downloadFile: typeof Taro.downloadFile = option => {
+        return Taro.downloadFile({
+            ...option,
+            url: createUrl(option.url),
+        })
+    }
+}

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

@@ -0,0 +1,3 @@
+export default definePageConfig({
+  navigationBarTitleText: '首页'
+})

package/lib/__templates__/taro/src/pages/index/index.css

@@ -0,0 +1 @@
+/* 优先使用 tailwindcss，如无必要请不要使用css */

package/lib/__templates__/taro/src/pages/index/index.tsx

@@ -0,0 +1,33 @@
+import { View, Text, Image } from '@tarojs/components';
+import { useLoad } from '@tarojs/taro';
+import { Network } from '@/network';
+import './index.css';
+
+/**
+ * 默认首页，直接覆盖本页内容
+ */
+const IndexPage = () => {
+  useLoad(async () => {
+    const res = await Network.request({ url: '/api/hello' });
+    console.log(res.data);
+  });
+
+  return (
+    <View className="w-full h-full flex flex-col justify-center items-center gap-1">
+      <Image
+        className="w-32 h-28"
+        src="https://lf-coze-web-cdn.coze.cn/obj/eden-cn/lm-lgvj/ljhwZthlaukjlkulzlp/coze-coding/icon/coze-coding.gif"
+      />
+      <View className="self-stretch flex flex-col justify-start items-start gap-2">
+        <Text className="self-stretch text-center justify-start text-base-accent-foreground text-base font-bold">
+          应用开发中
+        </Text>
+        <Text className="self-stretch text-center justify-start text-base-muted-foreground text-sm font-normal">
+          请稍候，界面即将呈现
+        </Text>
+      </View>
+    </View>
+  );
+};
+
+export default IndexPage;

package/lib/__templates__/taro/src/utils/h5-styles.ts

@@ -0,0 +1,22 @@
+/**
+ * H5 端特殊样式注入
+ * 如无必要，请勿修改本文件
+ */
+export function injectH5Styles() {
+  if (TARO_ENV !== 'h5') return
+
+  const style = document.createElement('style')
+  style.innerHTML = `
+/* H5 端隐藏 TabBar 空图标（只隐藏没有 src 的图标） */
+.weui-tabbar__icon:not([src]),
+.weui-tabbar__icon[src=''] {
+  display: none !important;
+}
+
+.weui-tabbar__item:has(.weui-tabbar__icon:not([src])) .weui-tabbar__label,
+.weui-tabbar__item:has(.weui-tabbar__icon[src='']) .weui-tabbar__label {
+  margin-top: 0 !important;
+}
+  `
+  document.head.appendChild(style)
+}

package/lib/__templates__/taro/src/utils/wx-debug.ts

@@ -0,0 +1,23 @@
+import Taro from '@tarojs/taro'
+
+/**
+ * 微信小程序调试工具
+ * 在开发版/体验版自动开启调试模式
+ */
+export function enableWxDebugIfNeeded() {
+  // 仅在微信小程序环境执行
+  if (Taro.getEnv() === Taro.ENV_TYPE.WEAPP) {
+    try {
+      const accountInfo = Taro.getAccountInfoSync()
+      const envVersion = accountInfo.miniProgram.envVersion
+      console.log('[Debug] envVersion:', envVersion)
+
+      // 开发版/体验版自动开启调试
+      if (envVersion !== 'release') {
+        Taro.setEnableDebug({ enableDebug: true })
+      }
+    } catch (error) {
+      console.error('[Debug] 开启调试模式失败:', error)
+    }
+  }
+}

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

@@ -0,0 +1,4 @@
+/** @type {import('stylelint').Config} */
+export default {
+  extends: "stylelint-config-standard",
+};

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

@@ -0,0 +1,68 @@
+
+
+
+
+
+
+
+
+
+const description = `Taro（小程序 + H5）：\`coze init \${COZE_WORKSPACE_PATH} --template taro\`
+- 适用：微信小程序、H5 跨端应用
+- 前后端分离架构：Taro 4 + NestJS
+- 支持微信小程序和 H5 双端构建
+- 使用 TailwindCSS + weapp-tailwindcss 实现跨端样式`;
+
+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: 'H5 development server port',
+    },
+    serverPort: {
+      type: 'number',
+      default: 3000,
+      minimum: 1024,
+      maximum: 65535,
+      description: 'NestJS backend server port',
+    },
+  },
+  required: [],
+  additionalProperties: false,
+};
+
+const config = {
+  description: description,
+  paramsSchema,
+  defaultParams: {
+    port: 5000,
+    serverPort: 3000,
+    appName: 'coze-mini-program',
+  },
+  onBeforeRender: async context => {
+    console.log(`Creating Taro project: ${context.appName}`);
+    return context;
+  },
+  onAfterRender: async (context, outputPath) => {
+    console.log(`\nProject created at: ${outputPath}`);
+    console.log('\nConfiguration:');
+    console.log('  - Framework: Taro 4 + NestJS');
+    console.log('  - TypeScript: enabled');
+    console.log('  - Platforms: H5, WeChat Mini Program');
+    console.log(`  - H5 Port: ${context.port}`);
+    console.log(`  - Server Port: ${context.serverPort}`);
+  },
+};
+
+export default config;

package/lib/__templates__/taro/tsconfig.json

@@ -0,0 +1,29 @@
+{
+  "compilerOptions": {
+    "target": "es2017",
+    "module": "ESNext",
+    "removeComments": false,
+    "preserveConstEnums": true,
+    "moduleResolution": "bundler",
+    "experimentalDecorators": true,
+    "noImplicitAny": false,
+    "allowSyntheticDefaultImports": true,
+    "outDir": "lib",
+    "noUnusedLocals": true,
+    "noUnusedParameters": true,
+    "strictNullChecks": true,
+    "sourceMap": true,
+    "rootDir": ".",
+    "jsx": "react-jsx",
+    "allowJs": true,
+    "resolveJsonModule": true,
+    "typeRoots": [
+      "node_modules/@types"
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": ["./src", "./types", "./config"],
+  "compileOnSave": false
+}

package/lib/__templates__/taro/types/global.d.ts

@@ -0,0 +1,32 @@
+/// <reference types="@tarojs/taro" />
+
+declare const PROJECT_DOMAIN: string | undefined;
+declare const TARO_ENV: "weapp" | "h5" | undefined;
+
+declare module '*.png';
+declare module '*.gif';
+declare module '*.jpg';
+declare module '*.jpeg';
+declare module '*.svg';
+declare module '*.css';
+declare module '*.less';
+declare module '*.scss';
+declare module '*.sass';
+declare module '*.styl';
+
+declare namespace NodeJS {
+  interface ProcessEnv {
+    /** NODE 内置环境变量, 会影响到最终构建生成产物 */
+    NODE_ENV: 'development' | 'production',
+    /** 当前构建的平台 */
+    TARO_ENV: 'weapp' | 'swan' | 'alipay' | 'h5' | 'rn' | 'tt' | 'qq' | 'jd' | 'harmony' | 'jdrn'
+    /**
+     * 当前构建的小程序 appid
+     * @description 若不同环境有不同的小程序，可通过在 env 文件中配置环境变量`TARO_APP_ID`来方便快速切换 appid， 而不必手动去修改 dist/project.config.json 文件
+     * @see https://taro-docs.jd.com/docs/next/env-mode-config#特殊环境变量-taro_app_id
+     */
+    TARO_APP_ID: string
+  }
+}
+
+