@coze-arch/cli 0.0.1-alpha.5b771d → 0.0.1-alpha.5c81e0

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

@@ -73,31 +73,8 @@ write_log "INFO" "==================== 安装项目依赖 ===================="
 if [ ! -f "package.json" ]; then
   write_log "ERROR" "项目目录下无 package.json，不是合法的 Node.js 项目"
 fi
-# 步骤 2.1/2.2：安装 Expo 项目依赖（按哈希变化执行）
-if [ -f "$CHECK_HASH_SCRIPT" ]; then
-  write_log "INFO" "检测 package.json 哈希是否变化"
-  set +e
-  python "$CHECK_HASH_SCRIPT" --config "package.json" --check
-  rc_node=$?
-  set -e
-  if [ $rc_node -eq 1 ]; then
-    write_log "INFO" "依赖哈希已变化，执行：pnpm install"
-    pnpm install --registry=https://registry.npmmirror.com || write_log "ERROR" "Expo 项目依赖安装失败（pnpm 执行出错）"
-
-    write_log "INFO" "依赖哈希已变化，执行：npm run install-missing"
-    npm run install-missing || write_log "ERROR" "npm run install-missing 执行失败，请检查 package.json 中的脚本配置"
-
-    set +e
-    python "$CHECK_HASH_SCRIPT" --config "package.json" --update
-    set -e
-  else
-    write_log "INFO" "跳过 pnpm install 与 npm run install-missing"
-  fi
-else
-  write_log "WARN" "未找到 check_hash.py，默认执行：pnpm install 与 npm run install-missing"
-  pnpm install --registry=https://registry.npmmirror.com || write_log "ERROR" "Expo 项目依赖安装失败（pnpm 执行出错）"
-  npm run install-missing || write_log "ERROR" "npm run install-missing 执行失败，请检查 package.json 中的脚本配置"
-fi
+# 步骤 2.1/2.2：安装项目依赖
+pnpm install --registry=https://registry.npmmirror.com || write_log "ERROR" "Expo 项目依赖安装失败（pnpm 执行出错）"
 
 write_log "INFO" "检查根目录 post_install.py"
 if [ -f "$ROOT_DIR/post_install.py" ]; then

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

@@ -130,13 +130,18 @@ wait_port_connectable() {
 
 start_expo() {
   local offline="${1:-0}"
+
+  pushd ./client
+
   if [ "$offline" = "1" ]; then
-    EXPO_OFFLINE=1 EXPO_NO_DOCTOR=1 EXPO_PUBLIC_BACKEND_BASE_URL="$EXPO_PUBLIC_BACKEND_BASE_URL" EXPO_PACKAGER_PROXY_URL="$EXPO_PACKAGER_PROXY_URL" nohup npx expo start --port "$EXPO_PORT" > logs/expo.log 2>&1 &
+    EXPO_OFFLINE=1 EXPO_NO_DOCTOR=1 EXPO_PUBLIC_BACKEND_BASE_URL="$EXPO_PUBLIC_BACKEND_BASE_URL" EXPO_PACKAGER_PROXY_URL="$EXPO_PACKAGER_PROXY_URL" nohup npx expo start --clear --port "$EXPO_PORT" > ../logs/expo.log 2>&1 &
   else
-    EXPO_NO_DOCTOR=1 EXPO_PUBLIC_BACKEND_BASE_URL="$EXPO_PUBLIC_BACKEND_BASE_URL" EXPO_PACKAGER_PROXY_URL="$EXPO_PACKAGER_PROXY_URL" nohup npx expo start --port "$EXPO_PORT" > logs/expo.log 2>&1 &
+    EXPO_NO_DOCTOR=1 EXPO_PUBLIC_BACKEND_BASE_URL="$EXPO_PUBLIC_BACKEND_BASE_URL" EXPO_PACKAGER_PROXY_URL="$EXPO_PACKAGER_PROXY_URL" nohup npx expo start --clear --port "$EXPO_PORT" > ../logs/expo.log 2>&1 &
   fi
   EXPO_PID=$!
   echo "$EXPO_PID"
+
+  popd
 }
 
 detect_expo_fetch_failed() {
@@ -181,8 +186,8 @@ ensure_port EXPO_PORT "$EXPO_PORT"
 
 # ==================== 启动 Server 服务 ====================
 write_log "INFO" "==================== 启动 server 服务 ===================="
-write_log "INFO" "正在执行：npm run server"
-PORT="$SERVER_PORT" nohup npm run server > logs/app.log 2>&1 &
+write_log "INFO" "正在执行：npm run dev"
+PORT="$SERVER_PORT" nohup npm run dev --prefix ./server > logs/app.log 2>&1 &
 SERVER_PID=$!
 if [ -z "${SERVER_PID}" ]; then
   write_log "ERROR" "无法获取 server 后台进程 PID"
@@ -190,8 +195,7 @@ fi
 write_log "INFO" "server 服务已启动，进程 ID：${SERVER_PID:-unknown}"
 
 write_log "INFO" "==================== 启动 Expo 项目 ===================="
-write_log "INFO" "正在执行：npx expo start --port ${EXPO_PORT}"
-write_log "INFO" "开始启动 Expo 服务"
+write_log "INFO" "开始启动 Expo 服务，端口 ${EXPO_PORT}"
 EXPO_PID=$(start_expo 0)
 if detect_expo_fetch_failed 8; then
   write_log "WARN" "Expo 启动检测到网络错误：TypeError: fetch failed，启用离线模式重试"

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

@@ -40,8 +40,8 @@ fi
 info "==================== 依赖安装完成！====================\n"
 
 info "==================== dist打包 ===================="
-info "开始执行：pnpm run server:build"
-(cd "$ROOT_DIR" && pnpm run server:build) || error "dist打包失败"
+info "开始执行：npm run build --prefix server"
+(cd "$ROOT_DIR" && npm run build --prefix ./server) || error "dist打包失败"
 info "==================== dist打包完成！====================\n"
 
 info "下一步：执行 ./prod_run.sh 启动服务"

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

@@ -2,8 +2,7 @@
 # 产物部署使用
 set -euo pipefail
 
-ROOT_DIR="$(cd "$(dirname "$0")" && pwd)"
-
+ROOT_DIR="$(pwd)"
 
 HOST="${HOST:-0.0.0.0}"
 PORT="${PORT:-5000}"
@@ -30,6 +29,6 @@ check_command() {
 check_command "pnpm"
 check_command "npm"
 
-info "开始执行：pnpm run server:prod"
-(cd "$ROOT_DIR" && PORT="$PORT" pnpm run server:prod) || error "服务启动失败"
+info "开始执行：npm run start"
+(cd "$ROOT_DIR" && PORT="$PORT" npm run start --prefix ./server) || error "服务启动失败"
 info "服务启动完成！\n"

package/lib/__templates__/expo/README.md

@@ -1,13 +1,72 @@
-# Expo App Template
+# Expo App + Express.js
+
+## 目录结构规范（严格遵循）
+
+当前仓库是一个 monorepo（基于 pnpm 的 workspace）
+
+- Expo 代码在 client 目录，Express.js 代码在 server 目录
+- 本模板默认无 Tab Bar，可按需改造
+
+目录结构说明
+
+├── server/                     # 服务端代码根目录 (Express.js)
+|   ├── src/
+│   │   └── index.ts            # Express 入口文件
+|   └── package.json            # 服务端 package.json
+├── client/                     # React Native 前端代码
+│   ├── app/                    # Expo Router 路由目录（仅路由配置）
+│   │   ├── _layout.tsx         # 根布局文件（必需）
+│   │   ├── home.tsx            # 首页
+│   │   └── index.tsx           # re-export home.tsx
+│   ├── screens/                # 页面实现目录（与 app/ 路由对应）
+│   │   └── home/
+│   │       ├── index.tsx       # 页面组件实现
+│   │       └── styles.ts       # 页面样式
+│   ├── components/             # 可复用组件
+│   │   └── Screen.tsx          # 页面容器组件（必用）
+│   ├── hooks/                  # 自定义 Hooks
+│   ├── contexts/               # React Context 代码
+│   ├── assets/                 # 静态资源
+|   └── package.json            # Expo 应用 package.json
+├── package.json
+├── .cozeproj                   # 预置脚手架脚本（禁止修改）
+└── .coze                       # 配置文件（禁止修改）
+
 ## 安装依赖
+
+### 命令
+
 ```bash
-pnpm install
+pnpm i
 ```
-## 启动 Metro 服务
-```bash
-npx expo start
+
+### 新增依赖约束
+
+如果需要新增依赖，需在 client 和 server 各自的目录添加（原因：隔离前后端的依赖），禁止在根目录直接安装依赖
+
+### 新增依赖标准流程
+
+- 编辑 `client/package.json` 或 `server/package.json`
+- 在根目录执行 `pnpm i`
+
+## Expo 开发规范
+
+### 路径别名
+
+Expo 配置了 `@/` 路径别名指向 `client/` 目录：
+
+```tsx
+// 正确
+import { Screen } from '@/components/Screen';
+
+// 避免相对路径
+import { Screen } from '../../../components/Screen';
 ```
-## 启动 Node 服务器
+
+## 本地开发
+
+运行 coze dev 可以同时启动前端和后端服务，如果端口已占用，该命令会先杀掉占用端口的进程再启动，也可以用来重启前端和后端服务
+
 ```bash
-npm run server
+coze dev
 ```

package/lib/__templates__/expo/_gitignore

@@ -8,4 +8,4 @@ expo/expo-env.d.ts
 expo-env.d.ts
 .DS_Store
 logs/
-tsconfig.tsbuildinfo
+*.tsbuildinfo

package/lib/__templates__/expo/_npmrc

@@ -8,15 +8,13 @@ network-concurrency=16
 fetch-retries=3
 fetch-timeout=60000
 
-# 严格使用 peer dependencies
+# peerDependencies
 strict-peer-dependencies=false
-
-# 自动生成 lockfile
 auto-install-peers=true
 
 # lockfile 配置
 lockfile=true
 prefer-frozen-lockfile=true
 
-# 如果 lockfile 存在但过期，更新而不是失败
+# semver 选择最高版本
 resolution-mode=highest

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

@@ -24,7 +24,7 @@ export default function RootLayout() {
                 // 隐藏自带的头部
                 headerShown: false
             }}>
-              <Stack.Screen name="(tabs)" options={{ title: "" }} />
+              <Stack.Screen name="index" options={{ title: "" }} />
             </Stack>
             <Toast />
         </GestureHandlerRootView>

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

@@ -0,0 +1 @@
+export { default } from '@/screens/home'

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

@@ -0,0 +1 @@
+export { default } from './home'

package/lib/__templates__/expo/client/app.config.ts

@@ -0,0 +1,71 @@
+import { ExpoConfig, ConfigContext } from 'expo/config';
+
+export default ({ config }: ConfigContext): ExpoConfig => {
+  return {
+    ...config,
+      "name": "${app_name}",
+      "slug": "${slug}",
+      "version": "1.0.0",
+      "orientation": "portrait",
+      "icon": "./assets/images/icon.png",
+      "scheme": "myapp",
+      "userInterfaceStyle": "automatic",
+      "newArchEnabled": true,
+      "ios": {
+        "supportsTablet": true
+      },
+      "android": {
+        "adaptiveIcon": {
+          "foregroundImage": "./assets/images/adaptive-icon.png",
+          "backgroundColor": "#ffffff"
+        }
+      },
+      "web": {
+        "bundler": "metro",
+        "output": "single",
+        "favicon": "./assets/images/favicon.png"
+      },
+      "plugins": [
+        process.env.EXPO_PUBLIC_BACKEND_BASE_URL ? [
+          "expo-router",
+          {
+            "origin": process.env.EXPO_PUBLIC_BACKEND_BASE_URL
+          }
+        ] : 'expo-router',
+        [
+          "expo-splash-screen",
+          {
+            "image": "./assets/images/splash-icon.png",
+            "imageWidth": 200,
+            "resizeMode": "contain",
+            "backgroundColor": "#ffffff"
+          }
+        ],
+        [
+          "expo-image-picker",
+          {
+            "photosPermission": "允许${app_name}访问您的相册，以便您上传或保存图片。",
+            "cameraPermission": "允许${app_name}使用您的相机，以便您直接拍摄照片上传。",
+            "microphonePermission": "允许${app_name}访问您的麦克风，以便您拍摄带有声音的视频。"
+          }
+        ],
+        [
+          "expo-location",
+          {
+            "locationWhenInUsePermission": "${app_name}需要访问您的位置以提供周边服务及导航功能。"
+          }
+        ],
+        [
+          "expo-camera",
+          {
+            "cameraPermission": "${app_name}需要访问相机以拍摄照片和视频。",
+            "microphonePermission": "${app_name}需要访问麦克风以录制视频声音。",
+            "recordAudioAndroid": true
+          }
+        ]
+      ],
+      "experiments": {
+        "typedRoutes": true
+      }
+  }
+}

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

@@ -0,0 +1,92 @@
+{
+  "name": "expo-app",
+  "description": "<%= appName %>",
+  "main": "expo-router/entry",
+  "private": true,
+  "scripts": {
+    "check-deps": "npx depcheck",
+    "postinstall": "npm run install-missing",
+    "install-missing": "node ./scripts/install-missing-deps.js",
+    "lint": "expo lint",
+    "start": "expo start --web --clear",
+    "test": "jest --watchAll"
+  },
+  "jest": {
+    "preset": "jest-expo"
+  },
+  "dependencies": {
+    "@expo/metro-runtime": "^6.1.2",
+    "@expo/vector-icons": "^15.0.0",
+    "@react-native-async-storage/async-storage": "^2.2.0",
+    "@react-native-community/datetimepicker": "^8.5.0",
+    "@react-native-community/slider": "^5.0.1",
+    "@react-native-masked-view/masked-view": "^0.3.2",
+    "@react-native-picker/picker": "^2.11.0",
+    "@react-navigation/bottom-tabs": "^7.2.0",
+    "@react-navigation/native": "^7.0.14",
+    "dayjs": "^1.11.19",
+    "expo": "^54.0.7",
+    "expo-auth-session": "^7.0.9",
+    "expo-av": "~16.0.6",
+    "expo-blur": "~15.0.6",
+    "expo-camera": "~17.0.10",
+    "expo-constants": "~18.0.8",
+    "expo-crypto": "^15.0.7",
+    "expo-font": "~14.0.7",
+    "expo-haptics": "~15.0.6",
+    "expo-image-picker": "~17.0.7",
+    "expo-linear-gradient": "~15.0.6",
+    "expo-linking": "~8.0.7",
+    "expo-location": "~19.0.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",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
+    "react-native": "0.81.5",
+    "react-native-chart-kit": "^6.12.0",
+    "react-native-gesture-handler": "~2.28.0",
+    "react-native-keyboard-aware-scroll-view": "^0.9.5",
+    "react-native-modal-datetime-picker": "18.0.0",
+    "react-native-reanimated": "~4.1.0",
+    "react-native-safe-area-context": "~5.6.0",
+    "react-native-screens": "~4.16.0",
+    "react-native-svg": "15.15.0",
+    "react-native-toast-message": "^2.3.3",
+    "react-native-web": "^0.21.2",
+    "react-native-webview": "~13.15.0",
+    "react-native-worklets": "0.5.1",
+    "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",
+    "chalk": "^4.1.2",
+    "depcheck": "^1.4.7",
+    "esbuild": "0.27.2",
+    "eslint": "^9.39.2",
+    "eslint-formatter-compact": "^9.0.1",
+    "eslint-import-resolver-typescript": "^4.4.4",
+    "eslint-plugin-import": "^2.32.0",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-regexp": "^2.10.0",
+    "globals": "^16.1.0",
+    "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"
+  }
+}

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

@@ -14,7 +14,6 @@ import { Screen } from '@/components/Screen';
 
 import { styles } from './styles';
 
-
 export default function HomeScreen() {
   const insets = useSafeAreaInsets();
   const { theme, isDark } = useTheme();

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

@@ -0,0 +1,24 @@
+{
+  "extends": "expo/tsconfig.base",
+  "compilerOptions": {
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "baseUrl": ".",
+    "strict": true,
+    "noEmit": true,
+    "paths": {
+      "@/*": ["./*"]
+    }
+  },
+  "include": ["**/*.ts", "**/*.tsx", ".expo/types/**/*.ts", "expo-env.d.ts"],
+  "exclude": [
+    "node_modules",
+    "**/*.spec.ts",
+    "**/*.test.ts",
+    "**/*.spec.tsx",
+    "**/*.test.tsx",
+    "dist",
+    "build",
+    ".expo"
+  ]
+}

package/lib/__templates__/expo/package.json

@@ -1,114 +1,15 @@
 {
-  "name": "<%= appName %>",
-  "version": "1.0.0",
+  "name": "expo-express-monorepo",
   "private": true,
-  "main": "client/index.js",
+  "version": "0.0.0",
   "scripts": {
-    "build": "bash .cozeproj/scripts/deploy_build.sh",
-    "check-deps": "npx depcheck",
-    "dev": "bash .cozeproj/scripts/deploy_run.sh",
-    "preinstall": "npx only-allow pnpm",
-    "postinstall": "node ./client/scripts/install-missing-deps.js",
-    "install-missing": "node ./client/scripts/install-missing-deps.js",
-    "lint": "expo lint",
-    "server": "NODE_ENV=development tsx ./src/index.ts",
-    "server:build": "pnpm exec esbuild src/index.ts --platform=node --packages=external --bundle --format=esm --outdir=src_dist",
-    "server:prod": "NODE_ENV=production PORT=${PORT:-5000} node src_dist/index.js",
-    "start": "expo start --web",
-    "test": "jest --watchAll"
-  },
-  "jest": {
-    "preset": "jest-expo"
-  },
-  "dependencies": {
-    "@aws-sdk/client-s3": "^3.958.0",
-    "@aws-sdk/lib-storage": "^3.958.0",
-    "@expo/metro-runtime": "^6.1.2",
-    "@expo/vector-icons": "^15.0.0",
-    "@react-native-async-storage/async-storage": "^2.2.0",
-    "@react-native-community/datetimepicker": "^8.5.0",
-    "@react-native-community/slider": "^5.0.1",
-    "@react-native-masked-view/masked-view": "^0.3.2",
-    "@react-native-picker/picker": "^2.11.0",
-    "@react-navigation/bottom-tabs": "^7.2.0",
-    "@react-navigation/native": "^7.0.14",
-    "ajv": "^8.17.1",
-    "ajv-formats": "^3.0.1",
-    "babel-plugin-module-resolver": "^5.0.2",
-    "babel-preset-expo": "^54.0.9",
-    "connect": "^3.7.0",
-    "coze-coding-dev-sdk": "^0.5.5",
-    "dayjs": "^1.11.19",
-    "drizzle-kit": "^0.31.8",
-    "drizzle-orm": "^0.45.1",
-    "drizzle-zod": "^0.8.3",
-    "expo": "^54.0.7",
-    "expo-auth-session": "^7.0.9",
-    "expo-av": "~16.0.6",
-    "expo-blur": "~15.0.6",
-    "expo-camera": "~17.0.10",
-    "expo-constants": "~18.0.8",
-    "expo-crypto": "^15.0.7",
-    "expo-font": "~14.0.7",
-    "expo-haptics": "~15.0.6",
-    "expo-image-picker": "~17.0.7",
-    "expo-linear-gradient": "~15.0.6",
-    "expo-linking": "~8.0.7",
-    "expo-location": "~19.0.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",
-    "express": "^4.22.1",
-    "http-proxy-middleware": "^3.0.5",
-    "multer": "^2.0.2",
-    "pg": "^8.16.3",
-    "react": "19.1.0",
-    "react-dom": "19.1.0",
-    "react-native": "0.81.5",
-    "react-native-chart-kit": "^6.12.0",
-    "react-native-gesture-handler": "~2.28.0",
-    "react-native-keyboard-aware-scroll-view": "^0.9.5",
-    "react-native-modal-datetime-picker": "18.0.0",
-    "react-native-reanimated": "~4.1.0",
-    "react-native-safe-area-context": "~5.6.0",
-    "react-native-screens": "~4.16.0",
-    "react-native-svg": "15.15.0",
-    "react-native-toast-message": "^2.3.3",
-    "react-native-web": "^0.21.2",
-    "react-native-webview": "~13.15.0",
-    "react-native-worklets": "0.5.1",
-    "zod": "^4.2.1"
-  },
-  "devDependencies": {
-    "@babel/core": "^7.25.2",
-    "@eslint/js": "^9.27.0",
-    "@types/express": "^5.0.6",
-    "@types/jest": "^29.5.12",
-    "@types/multer": "^2.0.0",
-    "@types/pg": "^8.16.0",
-    "@types/react": "~19.1.0",
-    "@types/react-test-renderer": "19.1.0",
-    "chalk": "^4.1.2",
-    "depcheck": "^1.4.7",
-    "esbuild": "0.27.2",
-    "eslint": "^9.39.2",
-    "eslint-formatter-compact": "^9.0.1",
-    "eslint-import-resolver-typescript": "^4.4.4",
-    "eslint-plugin-import": "^2.32.0",
-    "eslint-plugin-react": "^7.37.5",
-    "eslint-plugin-react-hooks": "^7.0.1",
-    "eslint-plugin-regexp": "^2.10.0",
-    "globals": "^16.1.0",
-    "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"
+    "dev": "bash .cozeproj/scripts/dev_run.sh",
+    "build": "bash .cozeproj/scripts/prod_build.sh",
+    "start": "bash .cozeproj/scripts/prod_run.sh",
+    "preinstall": "npx only-allow pnpm"
   },
+  "dependencies": {},
+  "devDependencies": {},
   "packageManager": "pnpm@9.0.0",
   "engines": {
     "pnpm": ">=9.0.0"