@coze-arch/cli 0.0.1-alpha.8f2811 → 0.0.1-alpha.904498

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

@@ -1,7 +1,7 @@
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
 PREVIEW_DIR="${COZE_PREVIEW_DIR:-/source/preview}"
 LOG_DIR="${COZE_LOG_DIR:-$ROOT_DIR/logs}"
-LOG_CLIENT_FILE="$LOG_DIR/client.log"
+LOG_FILE="$LOG_DIR/app.log"
 mkdir -p "$LOG_DIR"
 
 # ==================== 配置项 ====================
@@ -89,17 +89,14 @@ ensure_port() {
 pipe_to_log() {
   local source="${1:-CLIENT}"
   local raw_log="${2:-}"
-  local line clean_line timestamp
+  local line timestamp ts msg record
   while IFS= read -r line || [ -n "$line" ]; do
-    clean_line=$(printf '%s' "$line" | sed 's/\x1b\[[0-9;]*[mA-Za-z]//g')
-    if echo "$clean_line" | grep -qE '(^(Web|iOS|Android) node_modules/.*expo-router.*entry\.js.*%|^(Web|iOS|Android) Bundled [0-9]+ms node_modules/.*expo-router.*entry\.js|Logs will appear in the browser)'; then
-      continue
-    fi
     if [ -n "$raw_log" ]; then
-      timestamp=$(date '+%Y-%m-%d %H:%M:%S')
-      echo "[$timestamp] $clean_line" >> "$raw_log"
+      echo "$line" >> "$raw_log"
     fi
-    printf '[%s] %s\n' "$source" "$clean_line"
+    line=$(echo "[$source] $line" | sed 's/\x1b\[[0-9;]*[a-zA-Z]//g; s/\x1b\[[0-9;]*m//g')
+    msg="${line}"
+    echo "$msg"
   done
 }
 
@@ -119,10 +116,10 @@ start_expo() {
 
   if [ "$offline" = "1" ]; then
     ( EXPO_OFFLINE=1 EXPO_NO_DEPENDENCY_VALIDATION=1 EXPO_PUBLIC_BACKEND_BASE_URL="$EXPO_PUBLIC_BACKEND_BASE_URL" EXPO_PACKAGER_PROXY_URL="$EXPO_PACKAGER_PROXY_URL" EXPO_PUBLIC_COZE_PROJECT_ID="$EXPO_PUBLIC_COZE_PROJECT_ID" \
-      nohup npx expo start --clear --port "$EXPO_PORT" 2>&1 | pipe_to_log "CLIENT" "$LOG_CLIENT_FILE" ) &
+      nohup npx expo start --clear --port "$EXPO_PORT" 2>&1 | pipe_to_log "CLIENT" "$ROOT_DIR/logs/client.log" ) &
   else
     ( EXPO_NO_DEPENDENCY_VALIDATION=1 EXPO_PUBLIC_BACKEND_BASE_URL="$EXPO_PUBLIC_BACKEND_BASE_URL" EXPO_PACKAGER_PROXY_URL="$EXPO_PACKAGER_PROXY_URL" EXPO_PUBLIC_COZE_PROJECT_ID="$EXPO_PUBLIC_COZE_PROJECT_ID" \
-      nohup npx expo start --clear --port "$EXPO_PORT" 2>&1 | pipe_to_log "CLIENT" "$LOG_CLIENT_FILE" ) &
+      nohup npx expo start --clear --port "$EXPO_PORT" 2>&1 | pipe_to_log "CLIENT" "$ROOT_DIR/logs/client.log" ) &
   fi
   EXPO_PID=$!
   disown $EXPO_PID 2>/dev/null || true
@@ -133,9 +130,9 @@ start_expo() {
 detect_expo_fetch_failed() {
   local timeout="${1:-8}"
   local waited=0
-  local log_file="$LOG_CLIENT_FILE"
+  local log_file="$ROOT_DIR/logs/client.log"
   while [ "$waited" -lt "$timeout" ]; do
-    if [ -f "$log_file" ] && tail -n 100 "$log_file" 2>/dev/null | grep -q "TypeError: fetch failed"; then
+    if [ -f "$log_file" ] && grep -q "TypeError: fetch failed" "$log_file" 2>/dev/null; then
       return 0
     fi
     sleep 1
@@ -169,6 +166,8 @@ check_command "pnpm"
 check_command "lsof"
 check_command "bash"
 
+echo "准备日志目录：$ROOT_DIR/logs"
+mkdir -p "$ROOT_DIR/logs"
 # 端口占用预检查与处理
 ensure_port SERVER_PORT "$SERVER_PORT"
 ensure_port EXPO_PORT "$EXPO_PORT"

package/lib/__templates__/expo/.cozeproj/scripts/server_dev_run.sh

@@ -2,8 +2,8 @@
 
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
 SERVER_DIR="$ROOT_DIR/server"
-LOG_DIR="${COZE_LOG_DIR:-$ROOT_DIR/logs}"
-LOG_SERVER_FILE="$LOG_DIR/server.log"
+LOG_DIR="$ROOT_DIR/logs"
+LOG_FILE="$LOG_DIR/server.log"
 SERVER_PORT="${SERVER_PORT:-9091}"
 
 mkdir -p "$LOG_DIR"
@@ -11,14 +11,13 @@ mkdir -p "$LOG_DIR"
 pipe_to_log() {
   local source="${1:-SERVER}"
   local raw_log="${2:-}"
-  local line clean_line timestamp
+  local line
   while IFS= read -r line || [ -n "$line" ]; do
-    clean_line=$(printf '%s' "$line" | sed 's/\x1b\[[0-9;]*[mA-Za-z]//g')
     if [ -n "$raw_log" ]; then
-      timestamp=$(date '+%Y-%m-%d %H:%M:%S')
-      echo "[$timestamp] $clean_line" >> "$raw_log"
+      echo "$line" >> "$raw_log"
     fi
-    printf '[%s] %s\n' "$source" "$clean_line"
+    line=$(echo "[$source] $line" | sed 's/\x1b\[[0-9;]*[a-zA-Z]//g; s/\x1b\[[0-9;]*m//g')
+    echo "$line"
   done
 }
 
@@ -37,10 +36,10 @@ kill_old_server() {
 echo "==================== Server Dev Run ===================="
 echo "Server 目录：$SERVER_DIR"
 echo "Server 端口：$SERVER_PORT"
-echo "日志文件：$LOG_SERVER_FILE"
+echo "日志文件：$LOG_FILE"
 
 kill_old_server
 
 echo "启动 server 服务..."
 cd "$SERVER_DIR"
-NODE_ENV=development PORT="$SERVER_PORT" npx tsx ./src/index.ts 2>&1 | pipe_to_log "SERVER" "$LOG_SERVER_FILE"
+NODE_ENV=development PORT="$SERVER_PORT" npx tsx ./src/index.ts 2>&1 | pipe_to_log "SERVER" "$LOG_FILE"

package/lib/__templates__/expo/README.md

@@ -1,6 +1,6 @@
 # Expo App + Express.js
 
-## 目录结构规范（严格遵循）
+## 目录结构规范
 
 当前仓库是一个 monorepo（基于 pnpm 的 workspace）
 
@@ -16,17 +16,14 @@
 ├── client/                     # React Native 前端代码
 │   ├── app/                    # Expo Router 路由目录（仅路由配置）
 │   │   ├── _layout.tsx         # 根布局文件（必需，务必阅读）
-│   │   ├── home.tsx            # 首页
-│   │   └── index.tsx           # re-export home.tsx
+│   │   └── index.tsx           # 首页
 │   ├── screens/                # 页面实现目录（与 app/ 路由对应）
-│   │   └── demo/               # demo 示例页面
-│   │       ├── index.tsx       # 页面组件实现
-│   │       └── styles.ts       # 页面样式
+│   │   └── demo/
+│   │       └── index.tsx       # demo 示例页面（默认首页，不需要可以删除，记得同时更新路由文件）
 │   ├── components/             # 可复用组件
 │   │   └── Screen.tsx          # 页面容器组件（必用）
 │   ├── hooks/                  # 自定义 Hooks
 │   ├── contexts/               # React Context 代码
-│   ├── constants/              # 常量定义（如主题配置）
 │   ├── utils/                  # 工具函数
 │   ├── assets/                 # 静态资源
 |   └── package.json            # Expo 应用 package.json
@@ -34,6 +31,15 @@
 ├── .cozeproj                   # 预置脚手架脚本（禁止修改）
 └── .coze                       # 配置文件（禁止修改）
 
+## 技术选型（严格遵循）
+
+- 前端：Expo + React Native + TailwindCSS
+- 后端：Express.js
+
+本项目通过 uniwind 实现了 react-native 对 TailwindCSS v4 的支持，在编写样式时应使用 TailwindCSS 写法
+
+在开始开发前，先查看 client/global.css 了解必要的信息
+
 ## 安装依赖
 
 ### 命令
@@ -42,15 +48,6 @@
 pnpm i
 ```
 
-### 新增依赖约束
-
-如果需要新增依赖，需在 client 和 server 各自的目录添加（原因：隔离前后端的依赖），禁止在根目录直接安装依赖
-
-### 新增依赖标准流程
-
-- 编辑 `client/package.json` 或 `server/package.json`
-- 在根目录执行 `pnpm i`
-
 ## Expo 开发规范
 
 ### 路径别名

package/lib/__templates__/expo/client/app/+not-found.tsx

@@ -1,30 +1,15 @@
-import { View, Text, StyleSheet } from 'react-native';
+import { View, Text } from 'react-native';
 import { Link } from 'expo-router';
-import { useTheme } from '@/hooks/useTheme';
-import { Spacing } from '@/constants/theme';
 
 export default function NotFoundScreen() {
-  const { theme } = useTheme();
-
   return (
-    <View style={[styles.container, { backgroundColor: theme.backgroundRoot }]}>
-      <Text>
+    <View className="flex-1 justify-center items-center bg-background">
+      <Text className="text-foreground">
         页面不存在
       </Text>
-      <Link href="/" style={[styles.gohome]}>
+      <Link href="/" className="text-accent mt-6">
         返回首页
       </Link>
     </View>
   );
 }
-
-const styles = StyleSheet.create({
-  container: {
-    flex: 1,
-    justifyContent: 'center',
-    alignItems: 'center',
-  },
-  gohome: {
-    marginTop: Spacing['2xl'],
-  },
-});

package/lib/__templates__/expo/client/app/_layout.tsx

@@ -5,7 +5,8 @@ import { StatusBar } from 'expo-status-bar';
 import { LogBox } from 'react-native';
 import Toast from 'react-native-toast-message';
 import { AuthProvider } from "@/contexts/AuthContext";
-import { ColorSchemeProvider } from '@/hooks/useColorScheme';
+
+import '../global.css';
 
 LogBox.ignoreLogs([
   "TurboModuleRegistry.getEnforcing(...): 'RNMapsAirModule' could not be found",
@@ -15,22 +16,20 @@ LogBox.ignoreLogs([
 export default function RootLayout() {
   return (
     <AuthProvider>
-      <ColorSchemeProvider>
-        <GestureHandlerRootView style={{ flex: 1 }}>
-          <StatusBar style="dark"></StatusBar>
-          <Stack screenOptions={{
-            // 设置所有页面的切换动画为从右侧滑入，适用于iOS 和 Android
-            animation: 'slide_from_right',
-            gestureEnabled: true,
-            gestureDirection: 'horizontal',
-            // 隐藏自带的头部
-            headerShown: false
-          }}>
-            <Stack.Screen name="index" options={{ title: "" }} />
-          </Stack>
-          <Toast />
-        </GestureHandlerRootView>
-      </ColorSchemeProvider>
+      <GestureHandlerRootView style={{ flex: 1 }}>
+        <StatusBar style="dark"></StatusBar>
+        <Stack screenOptions={{
+          // 设置所有页面的切换动画为从右侧滑入，适用于iOS 和 Android
+          animation: 'slide_from_right',
+          gestureEnabled: true,
+          gestureDirection: 'horizontal',
+          // 隐藏自带的头部
+          headerShown: false
+        }}>
+          <Stack.Screen name="index" options={{ title: "" }} />
+        </Stack>
+        <Toast />
+      </GestureHandlerRootView>
     </AuthProvider>
   );
 }

package/lib/__templates__/expo/client/global.css

@@ -0,0 +1,78 @@
+@import 'tailwindcss';
+@import 'uniwind';
+
+@import './styles';
+
+:root,
+.light,
+.default,
+[data-theme="light"],
+[data-theme="default"] {
+  /* Theme Colors (Light Mode) */
+  --accent: oklch(55.00% 0.2500 254.00);
+  --accent-foreground: oklch(99.11% 0 0);
+  --background: oklch(97.02% 0.0040 254.00);
+  --border: oklch(90.00% 0.0040 254.00);
+  --danger: oklch(65.32% 0.2347 25.76);
+  --danger-foreground: oklch(99.11% 0 0);
+  --default: oklch(94.00% 0.0040 254.00);
+  --default-foreground: oklch(21.03% 0.0059 254.00);
+  --field-background: oklch(100.00% 0.0020 254.00);
+  --field-foreground: oklch(21.03% 0.0059 254.00);
+  --field-placeholder: oklch(55.17% 0.0081 254.00);
+  --focus: oklch(55.00% 0.2500 254.00);
+  --foreground: oklch(21.03% 0.0059 254.00);
+  --muted: oklch(55.17% 0.0081 254.00);
+  --overlay: oklch(100.00% 0.0012 254.00);
+  --overlay-foreground: oklch(21.03% 0.0059 254.00);
+  --scrollbar: oklch(87.10% 0.0040 254.00);
+  --segment: oklch(100.00% 0.0040 254.00);
+  --segment-foreground: oklch(21.03% 0.0059 254.00);
+  --separator: oklch(92.00% 0.0040 254.00);
+  --success: oklch(73.29% 0.1951 150.83);
+  --success-foreground: oklch(21.03% 0.0059 150.83);
+  --surface: oklch(100.00% 0.0020 254.00);
+  --surface-foreground: oklch(21.03% 0.0059 254.00);
+  --warning: oklch(78.19% 0.1598 72.35);
+  --warning-foreground: oklch(21.03% 0.0059 72.35);
+
+  /* Border Radius */
+  --radius: 0.75rem;
+  --field-radius: 0.5rem;
+
+  /* Font Family */
+  /* Make sure to load Google Sans font in your app */
+  --font-sans: var(--font-google-sans);
+}
+
+.dark,
+[data-theme="dark"] {
+  color-scheme: dark;
+  /* Theme Colors (Dark Mode) */
+  --accent: oklch(55.00% 0.2500 254.00);
+  --accent-foreground: oklch(99.11% 0 0);
+  --background: oklch(12.00% 0.0040 254.00);
+  --border: oklch(28.00% 0.0040 254.00);
+  --danger: oklch(59.40% 0.1983 24.65);
+  --danger-foreground: oklch(99.11% 0 0);
+  --default: oklch(27.40% 0.0040 254.00);
+  --default-foreground: oklch(99.11% 0 0);
+  --field-background: oklch(21.03% 0.0081 254.00);
+  --field-foreground: oklch(99.11% 0.0000 0.00);
+  --field-placeholder: oklch(70.50% 0.0081 254.00);
+  --focus: oklch(55.00% 0.2500 254.00);
+  --foreground: oklch(99.11% 0.0000 0.00);
+  --muted: oklch(70.50% 0.0081 254.00);
+  --overlay: oklch(21.03% 0.0081 254.00);
+  --overlay-foreground: oklch(99.11% 0.0000 0.00);
+  --scrollbar: oklch(70.50% 0.0040 254.00);
+  --segment: oklch(39.64% 0.0040 254.00);
+  --segment-foreground: oklch(99.11% 0.0000 0.00);
+  --separator: oklch(25.00% 0.0040 254.00);
+  --success: oklch(73.29% 0.1951 150.83);
+  --success-foreground: oklch(21.03% 0.0059 150.83);
+  --surface: oklch(21.03% 0.0081 254.00);
+  --surface-foreground: oklch(99.11% 0.0000 0.00);
+  --warning: oklch(82.03% 0.1399 76.36);
+  --warning-foreground: oklch(21.03% 0.0059 76.36);
+}

package/lib/__templates__/expo/client/metro.config.js

@@ -1,6 +1,7 @@
 const { getDefaultConfig } = require('expo/metro-config');
 const { createProxyMiddleware } = require('http-proxy-middleware');
 const connect = require('connect');
+const { withUniwindConfig } = require('uniwind/metro');
 
 const config = getDefaultConfig(__dirname);
 
@@ -118,4 +119,10 @@ config.server = {
   },
 };
 
-module.exports = config;
+module.exports = withUniwindConfig(config, {
+  // relative path to your global.css file (from previous step)
+  cssEntryFile: './global.css',
+  // (optional) path where we gonna auto-generate typings
+  // defaults to project's root
+  dtsFile: './uniwind-types.d.ts'
+});

package/lib/__templates__/expo/client/package.json

@@ -35,18 +35,18 @@
     "expo-file-system": "~19.0.21",
     "expo-font": "~14.0.7",
     "expo-haptics": "~15.0.6",
+    "expo-image": "^3.0.11",
     "expo-image-picker": "~17.0.7",
     "expo-linear-gradient": "~15.0.6",
     "expo-linking": "~8.0.7",
     "expo-location": "~19.0.7",
-    "expo-image": "^3.0.11",
-    "js-base64": "^3.7.7",
     "expo-router": "~6.0.0",
     "expo-splash-screen": "~31.0.8",
     "expo-status-bar": "~3.0.7",
     "expo-symbols": "~1.0.6",
     "expo-system-ui": "~6.0.9",
     "expo-web-browser": "~15.0.10",
+    "js-base64": "^3.7.7",
     "react": "19.1.0",
     "react-dom": "19.1.0",
     "react-native": "0.81.5",
@@ -62,17 +62,20 @@
     "react-native-web": "^0.21.2",
     "react-native-webview": "~13.15.0",
     "react-native-worklets": "0.5.1",
+    "tailwindcss": "^4.1.18",
+    "uniwind": "^1.2.7",
     "zod": "^4.2.1"
   },
   "devDependencies": {
     "@babel/core": "^7.25.2",
-    "babel-plugin-module-resolver": "^5.0.2",
-    "babel-preset-expo": "^54.0.9",
     "@eslint/js": "^9.27.0",
     "@types/jest": "^29.5.12",
     "@types/react": "~19.1.0",
     "@types/react-test-renderer": "19.1.0",
+    "babel-plugin-module-resolver": "^5.0.2",
+    "babel-preset-expo": "^54.0.9",
     "chalk": "^4.1.2",
+    "connect": "^3.7.0",
     "depcheck": "^1.4.7",
     "esbuild": "0.27.2",
     "eslint": "^9.39.2",
@@ -83,13 +86,12 @@
     "eslint-plugin-react-hooks": "^7.0.1",
     "eslint-plugin-regexp": "^2.10.0",
     "globals": "^16.1.0",
+    "http-proxy-middleware": "^3.0.5",
     "jest": "^29.2.1",
     "jest-expo": "~54.0.10",
     "react-test-renderer": "19.1.0",
     "tsx": "^4.21.0",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.32.1",
-    "connect": "^3.7.0",
-    "http-proxy-middleware": "^3.0.5"
+    "typescript-eslint": "^8.32.1"
   }
 }

package/lib/__templates__/expo/client/screens/demo/index.tsx

@@ -1,24 +1,18 @@
 import { View, Text } from 'react-native';
 import { Image } from 'expo-image';
 
-import { useTheme } from '@/hooks/useTheme';
 import { Screen } from '@/components/Screen';
-import { styles } from './styles';
 
 export default function DemoPage() {
-  const { theme, isDark } = useTheme();
-
   return (
-    <Screen backgroundColor={theme.backgroundRoot} statusBarStyle={isDark ? 'light' : 'dark'}>
-      <View
-        style={styles.container}
-      >
+    <Screen backgroundColor="var(--background)" statusBarStyle="auto">
+      <View className="absolute top-0 left-0 w-full h-full flex flex-col items-center justify-center">
         <Image
-          style={styles.logo}
-          source="https://lf-coze-web-cdn.coze.cn/obj/eden-cn/lm-lgvj/ljhwZthlaukjlkulzlp/coze-coding/icon/coze-coding.gif"
-        ></Image>
-        <Text style={{...styles.title, color: theme.textPrimary}}>应用开发中</Text>
-        <Text style={{...styles.description, color: theme.textSecondary}}>请稍候，界面即将呈现</Text>
+          className="w-[130px] h-[109px]"
+          source="https://lf-coze-web-cdn.coze.cn/obj/eden-cn/lm-lgvj/ljhwZthlaukjlkulzlp/coze-coding/expo/coze-loading.gif"
+        />
+        <Text className="text-base font-bold text-foreground">APP 开发中</Text>
+        <Text className="text-sm mt-2 text-muted">即将为您呈现应用界面</Text>
       </View>
     </Screen>
   );