@coze-arch/cli 0.0.1-alpha.f9be02 → 0.0.1-alpha.ff64d9

package/lib/__templates__/expo/.coze

@@ -9,4 +9,4 @@ run = ["bash", ".cozeproj/scripts/dev_run.sh"]
 [deploy]
 build = ["bash", ".cozeproj/scripts/prod_build.sh"]
 run = ["bash", ".cozeproj/scripts/prod_run.sh"]
-build_app_dir = "."
+build_app_dir = "./client"

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

@@ -2,108 +2,45 @@
 if [ -z "${BASH_VERSION:-}" ]; then exec /usr/bin/env bash "$0" "$@"; fi
 set -euo pipefail
 ROOT_DIR="$(pwd)"
-PREVIEW_DIR="${COZE_PREVIEW_DIR:-$ROOT_DIR}"
-LOG_DIR="${COZE_LOG_DIR:-$ROOT_DIR/logs}"
-LOG_FILE="$LOG_DIR/app.log"
-mkdir -p "$LOG_DIR"
+PREVIEW_DIR="${COZE_PREVIEW_DIR:-/source/preview}"
 
 # ==================== 配置项 ====================
 SERVER_DIR="app"
 EXPO_DIR="expo"
 CHECK_HASH_SCRIPT="$ROOT_DIR/check_hash.py"
-# ==================== 工具函数 ====================
-info() {
-  echo -e "\033[32m[INFO] $1\033[0m"
-}
-warn() {
-  echo -e "\033[33m[WARN] $1\033[0m"
-}
-error() {
-  echo -e "\033[31m[ERROR] $1\033[0m"
-  exit 1
-}
+
 check_command() {
   if ! command -v "$1" &> /dev/null; then
-    error "命令 $1 未找到，请先安装"
+    echo "error:命令 $1 未找到，请先安装"
   fi
 }
-write_log() {
-  local level="${1:-INFO}"
-  local msg="${2:-}"
-  node -e '
-const fs=require("fs");
-const path=process.argv[1];
-const level=(process.argv[2]||"").toUpperCase();
-let msg=String(process.argv[3]||"");
-const ts=Date.now();
-const dt=new Date();
-const parts=new Intl.DateTimeFormat("en-GB",{timeZone:"Asia/Shanghai",year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",hour12:false}).formatToParts(dt);
-const o={};
-for(const p of parts){o[p.type]=p.value}
-const dt_str=`${o.year}-${o.month}-${o.day} ${o.hour}:${o.minute}:${o.second}`;
-msg=msg.replace(/\\n/g,"\n");
-msg=`${dt_str} [${level}] ${msg}`;
-const record=JSON.stringify({level, message: msg, timestamp: ts},null,0);
-const fd=fs.openSync(path,"a");
-fs.writeSync(fd, record+"\n", null, "utf8");
-fs.fsyncSync(fd);
-fs.closeSync(fd);
-' "$LOG_FILE" "$level" "$msg"
-}
 
-# ==================== 前置检查 ====================
-write_log "INFO" "==================== 开始构建 ===================="
+echo "==================== 开始构建 ===================="
 
-write_log "INFO" "检查根目录 pre_install.py"
+echo "检查根目录 pre_install.py"
 if [ -f "$PREVIEW_DIR/pre_install.py" ]; then
-  write_log "INFO" "执行：python $PREVIEW_DIR/pre_install.py"
-  python "$PREVIEW_DIR/pre_install.py" || write_log "ERROR" "pre_install.py 执行失败"
+  echo "执行：python $PREVIEW_DIR/pre_install.py"
+  python "$PREVIEW_DIR/pre_install.py" || echo "pre_install.py 执行失败"
 fi
 
-write_log "INFO" "开始执行构建脚本（build_dev.sh）..."
-write_log "INFO" "正在检查依赖命令是否存在..."
+echo "开始执行构建脚本（build_dev.sh）..."
+echo "正在检查依赖命令是否存在..."
 # 检查核心命令
-# check_command "pip"
-# check_command "python"
 check_command "pnpm"
 check_command "npm"
 
-# ==================== 步骤 1：安装项目依赖 ====================
-write_log "INFO" "==================== 安装项目依赖 ===================="
+echo "==================== 安装项目依赖 ===================="
 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 中的脚本配置"
+  echo "项目目录下无 package.json，不是合法的 Node.js 项目"
 fi
+# 步骤 2.1/2.2：安装项目依赖
+pnpm install --registry=https://registry.npmmirror.com || echo "Expo 项目依赖安装失败（pnpm 执行出错）"
 
-write_log "INFO" "检查根目录 post_install.py"
-if [ -f "$ROOT_DIR/post_install.py" ]; then
-  write_log "INFO" "执行：python $ROOT_DIR/post_install.py"
-  python "$ROOT_DIR/post_install.py" || write_log "ERROR" "post_install.py 执行失败"
+echo "检查根目录 post_install.py"
+if [ -f "$PREVIEW_DIR/post_install.py" ]; then
+  echo "执行：python $PREVIEW_DIR/post_install.py"
+  python "$PREVIEW_DIR/post_install.py" || echo "post_install.py 执行失败"
 fi
 
-write_log "INFO" "==================== 依赖安装完成！====================\n"
-write_log "INFO" "下一步：执行 ./deploy_run.sh 启动服务"
+echo "==================== 依赖安装完成！====================\n"
+echo "下一步：执行 ./deploy_run.sh 启动服务"

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

@@ -1,5 +1,5 @@
 ROOT_DIR="$(cd "$(dirname "$0")" && pwd)"
-PREVIEW_DIR="${COZE_PREVIEW_DIR:-$ROOT_DIR}"
+PREVIEW_DIR="${COZE_PREVIEW_DIR:-/source/preview}"
 LOG_DIR="${COZE_LOG_DIR:-$ROOT_DIR/logs}"
 LOG_FILE="$LOG_DIR/app.log"
 mkdir -p "$LOG_DIR"
@@ -23,19 +23,9 @@ export EXPO_PUBLIC_BACKEND_BASE_URL EXPO_PACKAGER_PROXY_URL
 SERVER_PID=""
 EXPO_PID=""
 # ==================== 工具函数 ====================
-info() {
-  echo -e "\033[32m[INFO] $1\033[0m"
-}
-warn() {
-  echo -e "\033[33m[WARN] $1\033[0m"
-}
-error() {
-  echo -e "\033[31m[ERROR] $1\033[0m"
-  exit 1
-}
 check_command() {
   if ! command -v "$1" &> /dev/null; then
-    error "命令 $1 未找到，请先安装"
+    echo "error:命令 $1 未找到，请先安装"
   fi
 }
 while [ $# -gt 0 ]; do
@@ -64,10 +54,10 @@ ensure_port() {
   local var_name=$1
   local port_val=$2
   if is_port_free "$port_val"; then
-    info "端口未占用：$port_val"
+    echo "端口未占用：$port_val"
     eval "$var_name=$port_val"
   else
-    warn "端口已占用：$port_val"
+    echo "端口已占用：$port_val"
     local choice
     if [ "$ASSUME_YES" = "1" ]; then choice="Y"; else read -r -p "是否关闭该端口的进程？[Y/n] " choice || choice="Y"; fi
     if [ -z "$choice" ] || [ "$choice" = "y" ] || [ "$choice" = "Y" ]; then
@@ -75,15 +65,15 @@ ensure_port() {
         local pids
         pids=$(lsof -t -i tcp:"$port_val" -sTCP:LISTEN 2>/dev/null || true)
         if [ -n "$pids" ]; then
-          info "正在关闭进程：$pids"
-          kill -9 $pids 2>/dev/null || warn "关闭进程失败：$pids"
+          echo "正在关闭进程：$pids"
+          kill -9 $pids 2>/dev/null || echo "关闭进程失败：$pids"
           eval "$var_name=$port_val"
         else
-          warn "未获取到占用该端口的进程"
+          echo "未获取到占用该端口的进程"
           eval "$var_name=$port_val"
         fi
       else
-        warn "缺少 lsof，无法自动关闭进程"
+        echo "缺少 lsof，无法自动关闭进程"
         eval "$var_name=$port_val"
       fi
     else
@@ -95,28 +85,18 @@ ensure_port() {
   fi
 }
 
-write_log() {
-  local level="${1:-INFO}"
-  local msg="${2:-}"
-  node -e '
-const fs=require("fs");
-const path=process.argv[1];
-const level=(process.argv[2]||"").toUpperCase();
-let msg=String(process.argv[3]||"");
-const ts=Date.now();
-msg=msg.replace(/\\n/g,"\n");
-const dt=new Date();
-const parts=new Intl.DateTimeFormat("en-GB",{timeZone:"Asia/Shanghai",year:"numeric",month:"2-digit",day:"2-digit",hour:"2-digit",minute:"2-digit",second:"2-digit",hour12:false}).formatToParts(dt);
-const o={};
-for(const p of parts){o[p.type]=p.value}
-const dt_str=`${o.year}-${o.month}-${o.day} ${o.hour}:${o.minute}:${o.second}`;
-msg=`${dt_str} [${level}] ${msg}`;
-const record=JSON.stringify({level, message: msg, timestamp: ts},null,0);
-const fd=fs.openSync(path,"a");
-fs.writeSync(fd, record+"\n", null, "utf8");
-fs.fsyncSync(fd);
-fs.closeSync(fd);
-' "$LOG_FILE" "$level" "$msg"
+pipe_to_log() {
+  local source="${1:-CLIENT}"
+  local raw_log="${2:-}"
+  local line timestamp ts msg record
+  while IFS= read -r line || [ -n "$line" ]; do
+    if [ -n "$raw_log" ]; then
+      echo "$line" >> "$raw_log"
+    fi
+    line=$(echo "[$source] $line" | sed 's/\x1b\[[0-9;]*[a-zA-Z]//g; s/\x1b\[[0-9;]*m//g')
+    msg="${line}"
+    echo "$msg"
+  done
 }
 
 wait_port_connectable() {
@@ -134,12 +114,14 @@ start_expo() {
   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" 2>&1 | pipe_to_log "CLIENT" "../logs/client.log" ) &
   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" 2>&1 | pipe_to_log "CLIENT" "../logs/client.log" ) &
   fi
   EXPO_PID=$!
-  echo "$EXPO_PID"
+  disown $EXPO_PID 2>/dev/null || true
 
   popd
 }
@@ -147,7 +129,7 @@ start_expo() {
 detect_expo_fetch_failed() {
   local timeout="${1:-8}"
   local waited=0
-  local log_file="logs/expo.log"
+  local log_file="logs/client.log"
   while [ "$waited" -lt "$timeout" ]; do
     if [ -f "$log_file" ] && grep -q "TypeError: fetch failed" "$log_file" 2>/dev/null; then
       return 0
@@ -162,78 +144,77 @@ detect_expo_fetch_failed() {
 # 关掉nginx进程
 ps -ef | grep nginx | grep -v grep | awk '{print $2}' | xargs -r kill -9
 
-write_log "INFO" "检查根目录 pre_install.py"
+echo "检查根目录 pre_install.py"
 if [ -f "$PREVIEW_DIR/pre_install.py" ]; then
-  write_log "INFO" "执行：python $PREVIEW_DIR/pre_install.py"
-  python "$PREVIEW_DIR/pre_install.py" || write_log "ERROR" "pre_install.py 执行失败"
+  echo "执行：python $PREVIEW_DIR/pre_install.py"
+  python "$PREVIEW_DIR/pre_install.py" || echo "pre_install.py 执行失败"
 fi
 
-write_log "INFO" "==================== 开始启动 ===================="
-write_log "INFO" "开始执行服务启动脚本（start_dev.sh）..."
-write_log "INFO" "正在检查依赖命令和目录是否存在..."
+echo "==================== 开始启动 ===================="
+echo "开始执行服务启动脚本（start_dev.sh）..."
+echo "正在检查依赖命令和目录是否存在..."
 # 检查核心命令
-# check_command "python"
 check_command "npm"
 check_command "pnpm"
 check_command "lsof"
 check_command "bash"
 
-info "准备日志目录：logs"
+echo "准备日志目录：logs"
 mkdir -p logs
 # 端口占用预检查与处理
 ensure_port SERVER_PORT "$SERVER_PORT"
 ensure_port EXPO_PORT "$EXPO_PORT"
 
-# ==================== 启动 Server 服务 ====================
-write_log "INFO" "==================== 启动 server 服务 ===================="
-write_log "INFO" "正在执行：npm run dev"
-PORT="$SERVER_PORT" nohup npm run dev --prefix ./server > logs/app.log 2>&1 &
+echo "==================== 启动 server 服务 ===================="
+echo "正在执行：pnpm run dev"
+( SERVER_PORT="$SERVER_PORT" nohup pnpm run dev --prefix ./server ) &
 SERVER_PID=$!
+disown $SERVER_PID 2>/dev/null || true
 if [ -z "${SERVER_PID}" ]; then
-  write_log "ERROR" "无法获取 server 后台进程 PID"
+  echo "无法获取 server 后台进程 PID"
 fi
-write_log "INFO" "server 服务已启动，进程 ID：${SERVER_PID:-unknown}"
+echo "server 服务已启动，进程 ID：${SERVER_PID:-unknown}"
 
-write_log "INFO" "==================== 启动 Expo 项目 ===================="
-write_log "INFO" "开始启动 Expo 服务，端口 ${EXPO_PORT}"
-EXPO_PID=$(start_expo 0)
+echo "==================== 启动 Expo 项目 ===================="
+echo "开始启动 Expo 服务，端口 ${EXPO_PORT}"
+start_expo 0
 if detect_expo_fetch_failed 8; then
-  write_log "WARN" "Expo 启动检测到网络错误：TypeError: fetch failed，启用离线模式重试"
+  echo "Expo 启动检测到网络错误：TypeError: fetch failed，启用离线模式重试"
   if [ -n "${EXPO_PID}" ]; then kill -9 "$EXPO_PID" 2>/dev/null || true; fi
-  : > logs/expo.log
-  EXPO_PID=$(start_expo 1)
+  : > logs/client.log
+  start_expo 1
 fi
 # 输出以下环境变量，确保 Expo 项目能正确连接到 Server 服务
-write_log "INFO" "Expo 环境变量配置："
-write_log "INFO" "EXPO_PUBLIC_BACKEND_BASE_URL=${EXPO_PUBLIC_BACKEND_BASE_URL}"
-write_log "INFO" "EXPO_PACKAGER_PROXY_URL=${EXPO_PACKAGER_PROXY_URL}"
+echo "Expo 环境变量配置："
+echo "EXPO_PUBLIC_BACKEND_BASE_URL=${EXPO_PUBLIC_BACKEND_BASE_URL}"
+echo "EXPO_PACKAGER_PROXY_URL=${EXPO_PACKAGER_PROXY_URL}"
 if [ -z "${EXPO_PID}" ]; then
-  write_log "ERROR" "无法获取 Expo 后台进程 PID"
+  echo "无法获取 Expo 后台进程 PID"
 fi
 
-write_log "INFO" "所有服务已启动。Server PID: ${SERVER_PID}, Expo PID: ${EXPO_PID}"
+echo "所有服务已启动。Server PID: ${SERVER_PID}, Expo PID: ${EXPO_PID}"
 
-write_log "INFO" "检查 Server 服务端口：$SERVER_HOST:$SERVER_PORT"
+echo "检查 Server 服务端口：$SERVER_HOST:$SERVER_PORT"
 if wait_port_connectable "$SERVER_HOST" "$SERVER_PORT" 10 2; then
-  write_log "INFO" "端口可连接：$SERVER_HOST:$SERVER_PORT"
+  echo "端口可连接：$SERVER_HOST:$SERVER_PORT"
 else
-  write_log "WARN" "端口不可连接：$SERVER_HOST:$SERVER_PORT 10 次）"
+  echo "端口不可连接：$SERVER_HOST:$SERVER_PORT 10 次）"
 fi
 
-write_log "INFO" "检查 Expo 服务端口：$EXPO_HOST:$EXPO_PORT"
+echo "检查 Expo 服务端口：$EXPO_HOST:$EXPO_PORT"
 if wait_port_connectable "$EXPO_HOST" "$EXPO_PORT" 10 2; then
-  write_log "INFO" "端口可连接：$EXPO_HOST:$EXPO_PORT"
+  echo "端口可连接：$EXPO_HOST:$EXPO_PORT"
 else
-  write_log "WARN" "端口不可连接：$EXPO_HOST:$EXPO_PORT（已尝试 10 次）"
+  echo "端口不可连接：$EXPO_HOST:$EXPO_PORT（已尝试 10 次）"
 fi
 
-write_log "INFO" "服务端口检查完成"
+echo "服务端口检查完成"
 
-write_log "INFO" "检查根目录 post_run.py"
+echo "检查根目录 post_run.py"
 if [ -f "$ROOT_DIR/post_run.py" ]; then
-  write_log "INFO" "启动检查中"
-  python "$ROOT_DIR/post_run.py" --port "$EXPO_PORT" || write_log "ERROR" "post_run.py 执行失败"
-  write_log "INFO" "启动检查结束"
+  echo "启动检查中"
+  python "$ROOT_DIR/post_run.py" --port "$EXPO_PORT" || echo "post_run.py 执行失败"
+  echo "启动检查结束"
 fi
 
-write_log "INFO" "==================== 服务启动完成 ===================="
+echo "==================== 服务启动完成 ===================="

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

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

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

@@ -29,6 +29,6 @@ check_command() {
 check_command "pnpm"
 check_command "npm"
 
-info "开始执行：npm run start"
-(cd "$ROOT_DIR" && PORT="$PORT" npm run start --prefix ./server) || error "服务启动失败"
+info "开始执行：pnpm run start"
+(cd "$ROOT_DIR" && PORT="$PORT" pnpm run start --prefix ./server) || error "服务启动失败"
 info "服务启动完成！\n"

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

@@ -0,0 +1,45 @@
+#!/bin/bash
+
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+SERVER_DIR="$ROOT_DIR/server"
+LOG_DIR="$ROOT_DIR/logs"
+LOG_FILE="$LOG_DIR/server.log"
+SERVER_PORT="${SERVER_PORT:-9091}"
+
+mkdir -p "$LOG_DIR"
+
+pipe_to_log() {
+  local source="${1:-SERVER}"
+  local raw_log="${2:-}"
+  local line
+  while IFS= read -r line || [ -n "$line" ]; do
+    if [ -n "$raw_log" ]; then
+      echo "$line" >> "$raw_log"
+    fi
+    line=$(echo "[$source] $line" | sed 's/\x1b\[[0-9;]*[a-zA-Z]//g; s/\x1b\[[0-9;]*m//g')
+    echo "$line"
+  done
+}
+
+kill_old_server() {
+  if command -v lsof &> /dev/null; then
+    local pids
+    pids=$(lsof -t -i tcp:"$SERVER_PORT" -sTCP:LISTEN 2>/dev/null || true)
+    if [ -n "$pids" ]; then
+      echo "正在关闭旧的 server 进程：$pids"
+      kill -9 $pids 2>/dev/null || echo "关闭进程失败：$pids"
+      sleep 1
+    fi
+  fi
+}
+
+echo "==================== Server Dev Run ===================="
+echo "Server 目录：$SERVER_DIR"
+echo "Server 端口：$SERVER_PORT"
+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_FILE"

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/client/app/_layout.tsx

@@ -0,0 +1,33 @@
+import { useEffect } from 'react';
+import { GestureHandlerRootView } from 'react-native-gesture-handler';
+import { Stack } from 'expo-router';
+import { StatusBar } from 'expo-status-bar';
+import { LogBox } from 'react-native';
+import Toast from 'react-native-toast-message';
+import { AuthProvider } from "@/contexts/AuthContext";
+
+LogBox.ignoreLogs([
+  "TurboModuleRegistry.getEnforcing(...): 'RNMapsAirModule' could not be found",
+  // 添加其它想暂时忽略的错误或警告信息
+]);
+
+export default function RootLayout() {
+  return (
+    <AuthProvider>
+      <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/app/demo.tsx

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

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

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