@coze-arch/cli 0.0.1-alpha.db1c06 → 0.0.1-alpha.dcc485

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

@@ -0,0 +1,115 @@
+import Taro from '@tarojs/taro'
+import { canUseDOM, isH5 } from './platform'
+
+export type Rect = { left: number; top: number; width: number; height: number }
+
+const toNumber = (v: unknown) => {
+    if (typeof v === 'number') return v
+    if (typeof v === 'string') {
+        const n = parseFloat(v)
+        return Number.isFinite(n) ? n : 0
+    }
+    return 0
+}
+
+const normalizeRect = (r: any): Rect | null => {
+    if (!r) return null
+    return {
+        left: toNumber(r.left),
+        top: toNumber(r.top),
+        width: toNumber(r.width),
+        height: toNumber(r.height),
+    }
+}
+
+export const getViewport = () => {
+    if (isH5() && canUseDOM()) {
+        return { width: window.innerWidth, height: window.innerHeight }
+    }
+    try {
+        const info = Taro.getSystemInfoSync()
+        return {
+            width: toNumber(info.windowWidth),
+            height: toNumber(info.windowHeight),
+        }
+    } catch {
+        return { width: 375, height: 667 }
+    }
+}
+
+const getRectH5 = (id: string): Rect | null => {
+    if (!isH5() || !canUseDOM()) return null
+    const el = document.getElementById(id)
+    if (!el) return null
+    const r = el.getBoundingClientRect()
+    return normalizeRect(r)
+}
+
+export const getRectById = (id: string): Promise<Rect | null> => {
+    const h5Rect = getRectH5(id)
+    if (h5Rect) return Promise.resolve(h5Rect)
+    return new Promise(resolve => {
+        const query = Taro.createSelectorQuery()
+        query
+            .select(`#${id}`)
+            .boundingClientRect(res => {
+                const rect = Array.isArray(res) ? res[0] : res
+                resolve(normalizeRect(rect))
+            })
+            .exec()
+    })
+}
+
+export const computePosition = (params: {
+    triggerRect: Rect
+    contentRect: Rect
+    align: 'start' | 'center' | 'end'
+    side: 'top' | 'bottom' | 'left' | 'right'
+    sideOffset: number
+}) => {
+    const { triggerRect, contentRect, align, side, sideOffset } = params
+    const { width: vw, height: vh } = getViewport()
+    const margin = 8
+
+    const crossStart =
+        side === 'left' || side === 'right' ? triggerRect.top : triggerRect.left
+    const crossSize =
+        side === 'left' || side === 'right'
+            ? triggerRect.height
+            : triggerRect.width
+    const contentCrossSize =
+        side === 'left' || side === 'right'
+            ? contentRect.height
+            : contentRect.width
+
+    const cross = (() => {
+        if (align === 'start') return crossStart
+        if (align === 'end') return crossStart + crossSize - contentCrossSize
+        return crossStart + crossSize / 2 - contentCrossSize / 2
+    })()
+
+    let left = 0
+    let top = 0
+
+    if (side === 'bottom' || side === 'top') {
+        left = cross
+        top =
+            side === 'bottom'
+                ? triggerRect.top + triggerRect.height + sideOffset
+                : triggerRect.top - contentRect.height - sideOffset
+    } else {
+        top = cross
+        left =
+            side === 'right'
+                ? triggerRect.left + triggerRect.width + sideOffset
+                : triggerRect.left - contentRect.width - sideOffset
+    }
+
+    const maxLeft = Math.max(margin, vw - contentRect.width - margin)
+    const maxTop = Math.max(margin, vh - contentRect.height - margin)
+
+    left = Math.min(Math.max(left, margin), maxLeft)
+    top = Math.min(Math.max(top, margin), maxTop)
+
+    return { left, top }
+}

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

@@ -0,0 +1,12 @@
+import Taro from "@tarojs/taro"
+
+export const canUseDOM = () => typeof window !== "undefined" && typeof document !== "undefined"
+
+export const isH5 = () => {
+  try {
+    return Taro.getEnv() === Taro.ENV_TYPE.WEB
+  } catch {
+    return canUseDOM()
+  }
+}
+

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

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx"
+import { twMerge } from "tailwind-merge"
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs))
+}

package/lib/__templates__/taro/src/presets/dev-debug.ts

@@ -0,0 +1,23 @@
+import Taro from '@tarojs/taro';
+
+/**
+ * 小程序调试工具
+ * 在开发版/体验版自动开启调试模式
+ * 支持微信小程序和抖音小程序
+ */
+export function devDebug() {
+  const env = Taro.getEnv();
+  if (env === Taro.ENV_TYPE.WEAPP || env === Taro.ENV_TYPE.TT) {
+    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/src/presets/h5-container.tsx

@@ -0,0 +1,15 @@
+import { PropsWithChildren } from 'react';
+import { H5NavBar } from './h5-navbar';
+
+export const H5Container = ({ children }: PropsWithChildren) => {
+  if (TARO_ENV !== 'h5') {
+    return <>{children}</>;
+  }
+
+  return (
+    <>
+      <H5NavBar />
+      {children}
+    </>
+  );
+};

package/lib/__templates__/taro/src/presets/h5-navbar.tsx

@@ -1,6 +1,6 @@
 import { View, Text } from '@tarojs/components';
 import Taro, { useDidShow, usePageScroll } from '@tarojs/taro';
-import { useState, useEffect, PropsWithChildren, useCallback } from 'react';
+import { useState, useEffect, useCallback } from 'react';
 import { ChevronLeft, House } from 'lucide-react-taro';
 
 interface NavConfig {
@@ -37,6 +37,11 @@ const DEFAULT_NAV_STATE: NavState = {
   leftIcon: LeftIcon.None,
 };
 
+const getGlobalWindowConfig = (): Partial<NavConfig> => {
+  const app = Taro.getApp();
+  return app?.config?.window || {};
+};
+
 const getTabBarPages = (): Set<string> => {
   const tabBar = Taro.getApp()?.config?.tabBar;
   return new Set(
@@ -44,16 +49,26 @@ const getTabBarPages = (): Set<string> => {
   );
 };
 
+const getHomePage = (): string => {
+  const app = Taro.getApp();
+  return app?.config?.pages?.[0] || 'pages/index/index';
+};
+
+const cleanPath = (path: string): string => path.replace(/^\//, '');
+
 const computeLeftIcon = (
   route: string,
   tabBarPages: Set<string>,
   historyLength: number,
+  homePage: string,
 ): LeftIcon => {
   if (!route) return LeftIcon.None;
 
-  const isHomePage =
-    route === 'pages/index/index' || route === '/pages/index/index';
-  const isTabBarPage = tabBarPages.has(route);
+  const cleanRoute = cleanPath(route);
+  const cleanHomePage = cleanPath(homePage);
+  const isHomePage = cleanRoute === cleanHomePage;
+  const isTabBarPage =
+    tabBarPages.has(cleanRoute) || tabBarPages.has(`/${cleanRoute}`);
   const hasHistory = historyLength > 1;
 
   if (isTabBarPage || isHomePage) return LeftIcon.None;
@@ -61,29 +76,60 @@ const computeLeftIcon = (
   return LeftIcon.Home;
 };
 
-export const H5NavBar = ({ children }: PropsWithChildren) => {
+export const H5NavBar = () => {
   const [navState, setNavState] = useState<NavState>(DEFAULT_NAV_STATE);
   const [scrollOpacity, setScrollOpacity] = useState(0);
 
   const updateNavState = useCallback(() => {
     const pages = Taro.getCurrentPages();
+    if (pages.length === 0) {
+      setNavState(prev => ({ ...prev, visible: false }));
+      return;
+    }
+
     const currentPage = pages[pages.length - 1];
     const route = currentPage?.route || '';
-    const config: NavConfig = (currentPage as any)?.config || {};
+    if (!route) return;
+
+    const pageConfig: NavConfig = (currentPage as any)?.config || {};
+    const globalConfig = getGlobalWindowConfig();
     const tabBarPages = getTabBarPages();
+    const homePage = getHomePage();
+
+    const cleanRoute = cleanPath(route);
+    const cleanHomePage = cleanPath(homePage);
+
+    const isHomePage = cleanRoute === cleanHomePage;
+    const isTabBarPage =
+      tabBarPages.has(cleanRoute) || tabBarPages.has(`/${cleanRoute}`);
 
-    const isSinglePageApp = tabBarPages.size <= 1 && pages.length <= 1;
+    const shouldHideNav =
+      tabBarPages.size <= 1 &&
+      pages.length <= 1 &&
+      (isHomePage || isTabBarPage);
 
     setNavState({
-      visible: !isSinglePageApp,
-      title: config.navigationBarTitleText || '',
-      bgColor: config.navigationBarBackgroundColor || '#ffffff',
-      textStyle: config.navigationBarTextStyle || 'black',
-      navStyle: config.navigationStyle || 'default',
-      transparent: config.transparentTitle || 'none',
-      leftIcon: isSinglePageApp
+      visible: !shouldHideNav,
+      title:
+        document.title ||
+        pageConfig.navigationBarTitleText ||
+        globalConfig.navigationBarTitleText ||
+        '',
+      bgColor:
+        pageConfig.navigationBarBackgroundColor ||
+        globalConfig.navigationBarBackgroundColor ||
+        '#ffffff',
+      textStyle:
+        pageConfig.navigationBarTextStyle ||
+        globalConfig.navigationBarTextStyle ||
+        'black',
+      navStyle:
+        pageConfig.navigationStyle || globalConfig.navigationStyle || 'default',
+      transparent:
+        pageConfig.transparentTitle || globalConfig.transparentTitle || 'none',
+      leftIcon: shouldHideNav
         ? LeftIcon.None
-        : computeLeftIcon(route, tabBarPages, pages.length),
+        : computeLeftIcon(cleanRoute, tabBarPages, pages.length, cleanHomePage),
     });
   }, []);
 
@@ -100,23 +146,42 @@ export const H5NavBar = ({ children }: PropsWithChildren) => {
   useEffect(() => {
     if (TARO_ENV !== 'h5') return;
 
-    const titleEl = document.querySelector('title') || document.head;
-    const observer = new MutationObserver(() => updateNavState());
-    observer.observe(titleEl, {
+    let timer: NodeJS.Timeout | null = null;
+    const observer = new MutationObserver(() => {
+      if (timer) clearTimeout(timer);
+      timer = setTimeout(() => {
+        updateNavState();
+      }, 50);
+    });
+
+    observer.observe(document.head, {
       subtree: true,
       childList: true,
       characterData: true,
     });
 
-    return () => observer.disconnect();
+    updateNavState();
+
+    return () => {
+      observer.disconnect();
+      if (timer) clearTimeout(timer);
+    };
   }, [updateNavState]);
 
-  if (
-    TARO_ENV !== 'h5' ||
-    navState.navStyle === 'custom' ||
-    !navState.visible
-  ) {
-    return <>{children}</>;
+  const shouldRender =
+    TARO_ENV === 'h5' && navState.visible && navState.navStyle !== 'custom';
+
+  useEffect(() => {
+    if (TARO_ENV !== 'h5') return;
+    if (shouldRender) {
+      document.body.classList.add('h5-navbar-visible');
+    } else {
+      document.body.classList.remove('h5-navbar-visible');
+    }
+  }, [shouldRender]);
+
+  if (!shouldRender) {
+    return <></>;
   }
 
   const iconColor = navState.textStyle === 'white' ? '#fff' : '#333';
@@ -134,12 +199,15 @@ export const H5NavBar = ({ children }: PropsWithChildren) => {
   };
 
   const handleBack = () => Taro.navigateBack();
-  const handleGoHome = () => Taro.switchTab({ url: '/pages/index/index' });
+  const handleGoHome = () => {
+    const homePage = getHomePage();
+    Taro.reLaunch({ url: `/${homePage}` });
+  };
 
   return (
-    <View className="flex flex-col h-full">
+    <>
       <View
-        className={`fixed top-0 left-0 right-0 h-11 flex items-center justify-center z-1000 ${navState.transparent === 'none' ? 'border-b border-gray-200' : ''}`}
+        className="fixed top-0 left-0 right-0 h-11 flex items-center justify-center z-1000"
         style={getBgStyle()}
       >
         {navState.leftIcon === LeftIcon.Back && (
@@ -165,7 +233,6 @@ export const H5NavBar = ({ children }: PropsWithChildren) => {
         </Text>
       </View>
       <View className="h-11 shrink-0" />
-      <View className="pb-11 h-full">{children}</View>
-    </View>
+    </>
   );
 };

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

@@ -2,11 +2,8 @@
  * H5 端特殊样式注入
  * 如无必要，请勿修改本文件
  */
-export function injectH5Styles() {
-  if (TARO_ENV !== 'h5') return;
 
-  const style = document.createElement('style');
-  style.innerHTML = `
+const H5_BASE_STYLES = `
 /* H5 端隐藏 TabBar 空图标（只隐藏没有 src 的图标） */
 .weui-tabbar__icon:not([src]),
 .weui-tabbar__icon[src=''] {
@@ -28,6 +25,196 @@ 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

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

package/lib/__templates__/templates.json

@@ -62,6 +62,38 @@
         "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 实现跨端样式",

package/lib/__templates__/vite/AGENTS.md

@@ -0,0 +1,41 @@
+# 项目上下文
+
+## 技术栈
+
+- **核心**: Vite 7, TypeScript, Express
+- **UI**: Tailwind CSS
+
+## 目录结构
+
+```
+├── scripts/            # 构建与启动脚本
+│   ├── build.sh        # 构建脚本
+│   ├── dev.sh          # 开发环境启动脚本
+│   ├── prepare.sh      # 预处理脚本
+│   └── start.sh        # 生产环境启动脚本
+├── server/             # 服务端逻辑
+│   ├── routes/         # API 路由
+│   ├── server.ts       # Express 服务入口
+│   └── vite.ts         # Vite 中间件集成
+├── src/                # 前端源码
+│   ├── index.css       # 全局样式
+│   ├── index.ts        # 客户端入口
+│   └── main.ts         # 主逻辑
+├── index.html          # 入口 HTML
+├── package.json        # 项目依赖管理
+├── tsconfig.json       # TypeScript 配置
+└── vite.config.ts      # Vite 配置
+```
+
+## 包管理规范
+
+**仅允许使用 pnpm** 作为包管理器，**严禁使用 npm 或 yarn**。
+**常用命令**：
+- 安装依赖：`pnpm add <package>`
+- 安装开发依赖：`pnpm add -D <package>`
+- 安装所有依赖：`pnpm install`
+- 移除依赖：`pnpm remove <package>`
+
+## 开发规范
+
+- 使用 Tailwind CSS 进行样式开发