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

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

@@ -0,0 +1,220 @@
+/**
+ * H5 端特殊样式注入
+ * 如无必要，请勿修改本文件
+ */
+
+const H5_BASE_STYLES = `
+/* 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;
+}
+
+/* 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;
+}
+
+.taro_page {
+  overflow: auto;
+}
+
+::-webkit-scrollbar {
+  width: 4px;
+  height: 4px;
+}
+
+::-webkit-scrollbar-track {
+  background: transparent;
+}
+
+::-webkit-scrollbar-thumb {
+  background: rgba(0, 0, 0, 0.2);
+  border-radius: 2px;
+}
+
+::-webkit-scrollbar-thumb:hover {
+  background: rgba(0, 0, 0, 0.3);
+}
+
+/* H5 导航栏页面自动添加顶部间距 */
+body.h5-navbar-visible .taro_page {
+  padding-top: 44px;
+}
+
+body.h5-navbar-visible .toaster[data-position^="top"] {
+  top: 44px !important;
+}
+
+/* Sheet 组件在 H5 导航栏下的位置修正 */
+body.h5-navbar-visible .sheet-content:not([data-side="bottom"]) {
+    top: 44px !important;
+}
+
+/*
+ * H5 端 rem 适配：与小程序 rpx 缩放一致
+ * 375px 屏幕：1rem = 16px，小程序 32rpx = 16px
+ */
+html {
+    font-size: 4vw !important;
+}
+
+/* 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-input-core.taro-otp-hidden-input input {
+    color: transparent;
+    caret-color: transparent;
+    -webkit-text-fill-color: transparent;
+}
+
+/* 全局按钮样式重置 */
+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;
+}
+
+taro-textarea-core > textarea,
+.taro-textarea,
+textarea.taro-textarea {
+    resize: none !important;
+}
+`;
+
+const PC_WIDESCREEN_STYLES = `
+/* PC 宽屏适配 - 基础布局 */
+@media (min-width: 769px) {
+  html {
+    font-size: 15px !important;
+  }
+
+  body {
+    background-color: #f3f4f6 !important;
+    display: flex !important;
+    justify-content: center !important;
+    align-items: center !important;
+    min-height: 100vh !important;
+  }
+}
+`;
+
+const PC_WIDESCREEN_PHONE_FRAME = `
+/* PC 宽屏适配 - 手机框样式（有 TabBar 页面） */
+@media (min-width: 769px) {
+  .taro-tabbar__container {
+    width: 375px !important;
+    max-width: 375px !important;
+    height: calc(100vh - 40px) !important;
+    max-height: 900px !important;
+    background-color: #fff !important;
+    transform: translateX(0) !important;
+    box-shadow: 0 0 20px rgba(0, 0, 0, 0.1) !important;
+    border-radius: 20px !important;
+    overflow: hidden !important;
+    position: relative !important;
+  }
+
+  .taro-tabbar__panel {
+    height: 100% !important;
+    overflow: auto !important;
+  }
+}
+
+/* PC 宽屏适配 - Toast 定位到手机框范围内 */
+@media (min-width: 769px) {
+  body .toaster {
+    left: 50% !important;
+    right: auto !important;
+    width: 375px !important;
+    max-width: 375px !important;
+    transform: translateX(-50%) !important;
+    box-sizing: border-box !important;
+  }
+}
+
+/* PC 宽屏适配 - 手机框样式（无 TabBar 页面，通过 JS 添加 no-tabbar 类） */
+@media (min-width: 769px) {
+  body.no-tabbar #app {
+    width: 375px !important;
+    max-width: 375px !important;
+    height: calc(100vh - 40px) !important;
+    max-height: 900px !important;
+    background-color: #fff !important;
+    box-shadow: 0 0 20px rgba(0, 0, 0, 0.1) !important;
+    border-radius: 20px !important;
+    overflow: hidden !important;
+    position: relative !important;
+    transform: translateX(0) !important;
+  }
+
+  body.no-tabbar #app .taro_router {
+    height: 100% !important;
+    overflow: auto !important;
+  }
+}
+`;
+
+function injectStyles() {
+  const style = document.createElement('style');
+  style.innerHTML =
+    H5_BASE_STYLES + PC_WIDESCREEN_STYLES + PC_WIDESCREEN_PHONE_FRAME;
+  document.head.appendChild(style);
+}
+
+function setupTabbarDetection() {
+  const checkTabbar = () => {
+    const hasTabbar = !!document.querySelector('.taro-tabbar__container');
+    document.body.classList.toggle('no-tabbar', !hasTabbar);
+  };
+
+  checkTabbar();
+
+  const observer = new MutationObserver(checkTabbar);
+  observer.observe(document.body, { childList: true, subtree: true });
+}
+
+export function injectH5Styles() {
+  if (TARO_ENV !== 'h5') return;
+
+  injectStyles();
+  setupTabbarDetection();
+}

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

@@ -0,0 +1,18 @@
+import { useLaunch } from '@tarojs/taro';
+import { PropsWithChildren } from 'react';
+import { injectH5Styles } from './h5-styles';
+import { devDebug } from './dev-debug';
+import { H5Container } from './h5-container';
+
+export const Preset = ({ children }: PropsWithChildren) => {
+  useLaunch(() => {
+    devDebug();
+    injectH5Styles();
+  });
+
+  if (TARO_ENV === 'h5') {
+    return <H5Container>{children}</H5Container>;
+  }
+
+  return <>{children}</>;
+};

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
+  }
+}
+
+

package/lib/__templates__/templates.json

@@ -3,59 +3,196 @@
   "templates": [
     {
       "name": "expo",
-      "description": "expo template",
+      "description": "Expo template for React Native applications",
       "location": "./expo",
       "paramsSchema": {
-        "appName": {
-          "type": "string",
-          "description": "Application name (lowercase, alphanumeric and hyphens only)",
-          "pattern": "^[a-z0-9-]+$"
+        "type": "object",
+        "properties": {
+          "appName": {
+            "type": "string",
+            "minLength": 1,
+            "pattern": "^[a-z0-9-]+$",
+            "description": "Application name (lowercase, alphanumeric and hyphens only)"
+          },
+          "port": {
+            "type": "number",
+            "default": 8081,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Metro bundler port"
+          }
         },
-        "port": {
-          "type": "number",
-          "description": "Metro bundler port",
-          "default": 8081,
-          "minimum": 1024,
-          "maximum": 65535
-        }
+        "required": [],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "native-static",
+      "description": "Native Static（纯静态）：`coze init ${COZE_WORKSPACE_PATH} --template native-static`\n- 适用：纯静态 HTML/CSS/JS 项目、静态网站\n- 使用 Python http.server 作为开发服务器\n- 不需要 Node.js 环境，适合简单静态内容",
+      "location": "./native-static",
+      "paramsSchema": {
+        "type": "object",
+        "properties": {},
+        "required": [],
+        "additionalProperties": false
       }
     },
     {
       "name": "nextjs",
-      "description": "nextjs template",
+      "description": "Next.js（复杂项目）：`coze init ${COZE_WORKSPACE_PATH} --template nextjs`\n- 适用：全栈应用、复杂多页面等复杂项目\n- 使用默认nextjs项目规范\n    - **目录规范**： 默认开启src目录（打开--src-dir选项）：项目文件（如 app 目录、pages 目录、components 等）初始化到 src/ 目录下。\n    - **项目理解加速**：初始可以依赖项目下 `package.json` 文件理解项目类型，如果没有或无法理解退化成阅读其他文件。\n    - **UI设计与组件规范**：Next.js项目**必须默认**采用 shadcn/ui 风格和规范，`shadcn/ui`组件默认完整的预装在`src/components/ui/`目录下",
       "location": "./nextjs",
       "paramsSchema": {
-        "appName": {
-          "type": "string",
-          "description": "Application name (lowercase, alphanumeric and hyphens only)",
-          "pattern": "^[a-z0-9-]+$"
+        "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 Next.js dev server)"
+          }
+        },
+        "required": [],
+        "additionalProperties": false
+      }
+    },
+    {
+      "name": "nuxt-vue",
+      "description": "Nuxt.js（服务端 + Vue）：`coze init ${COZE_WORKSPACE_PATH} --template nuxt-vue`\n- 适用：全栈应用、需要服务端接口能力的 Vue 项目\n- 特点：\n    - **服务端能力**：内置服务端 API 路由，可直接创建后端接口\n    - **Vue 3**：基于最新的 Vue 3 Composition API\n    - **Vite**：使用 Vite 作为构建工具，开发体验极佳\n    - **TypeScript**：完整的 TypeScript 支持\n    - **文件路由**：基于文件系统的自动路由\n    - **项目理解加速**：可依赖项目下 `package.json` 和 `nuxt.config.ts` 理解项目配置",
+      "location": "./nuxt-vue",
+      "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
+      }
+    },
+    {
+      "name": "taro",
+      "description": "Taro（小程序 + H5）：`coze init ${COZE_WORKSPACE_PATH} --template taro`\n- 适用：微信小程序、H5 跨端应用\n- 前后端分离架构：Taro 4 + NestJS\n- 支持微信小程序和 H5 双端构建\n- 使用 TailwindCSS + weapp-tailwindcss 实现跨端样式",
+      "location": "./taro",
+      "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
+      }
+    },
+    {
+      "name": "test-only",
+      "description": "Test template showcasing all template hooks and features",
+      "location": "./test-only",
+      "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"
+          },
+          "includeTests": {
+            "type": "boolean",
+            "default": true,
+            "nullable": true,
+            "description": "Include test files"
+          },
+          "addCopyright": {
+            "type": "boolean",
+            "default": false,
+            "nullable": true,
+            "description": "Add copyright header to source files"
+          }
         },
-        "port": {
-          "type": "number",
-          "description": "Development server port (for Next.js dev server)",
-          "default": 5000,
-          "minimum": 1024,
-          "maximum": 65535
-        }
+        "required": [],
+        "additionalProperties": false
       }
     },
     {
       "name": "vite",
-      "description": "vite template",
+      "description": "Vite（简单项目）：`coze init ${COZE_WORKSPACE_PATH} --template vite`\n- 适用：轻量级 SPA、纯前端交互、仪表盘等轻量级项目。",
       "location": "./vite",
       "paramsSchema": {
-        "appName": {
-          "type": "string",
-          "description": "Application name (lowercase, alphanumeric and hyphens only)",
-          "pattern": "^[a-z0-9-]+$"
+        "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"
+          },
+          "hmrPort": {
+            "type": "number",
+            "default": 6000,
+            "minimum": 1024,
+            "maximum": 65535,
+            "description": "Development HMR server port"
+          }
         },
-        "port": {
-          "type": "number",
-          "description": "Development server port",
-          "default": 5000,
-          "minimum": 1024,
-          "maximum": 65535
-        }
+        "required": [],
+        "additionalProperties": false
       }
     }
   ]

package/lib/__templates__/vite/.coze

@@ -2,10 +2,11 @@
 requires = ["nodejs-24"]
 
 [dev]
-run = ["npm", "run", "dev"]
+build = ["bash", "./scripts/prepare.sh"]
+run = ["bash", "./scripts/dev.sh"]
 deps = ["git"] # -> apt install git
 
 [deploy]
-build = ["npm", "run", "build"]
-run = ["npm", "run", "start"]
+build = ["bash","./scripts/build.sh"]
+run = ["bash","./scripts/start.sh"]
 deps = ["git"] # -> apt install git