@coze-arch/cli 0.0.36-alpha.844e20 → 0.0.36-alpha.98d71c

package/docs/deploy.md

@@ -54,7 +54,7 @@ coze-dev deploy code deploy logs|log-count|count|build-log|config
 coze-dev deploy code domain list [--unit-type dev|prod]
 coze-dev deploy code domain add <domain>
 coze-dev deploy code domain set-prefix <prefix> --app-id <app_id> --yes
-coze-dev deploy code mini-program status|bind|submit-code|unbind
+coze-dev deploy code mini-program status|bind|submit-code|unbind|auth|preview
 ```
 
 `code app list` 是真分页：一次只返回一页（`--page-size` 默认 20、上限 100），`has_more` 为真时用返回的 `next_page_token` 取下一页；要一次拿到名下全部应用用 `--all`，它会自己翻到底。
@@ -101,21 +101,17 @@ V2 接口的所有参数均通过 POST JSON body 发送，不会放入 URL。确
 `scripts/package-project.py` 仍随源码和 npm 包保留，仅作为 Python 参考备份与行为对照，
 生产打包链路不会调用 Python。
 
-服务和小程序部署会读取源码根目录的 `.env` 并加密上传；`COZE_` 前缀为平台保留，CLI
-会过滤这类变量，避免覆盖部署运行时由平台注入的配置。
+环境变量以当前线上成功版本的 Secret 快照为准，CLI 不再读取源码根目录的 `.env`。
+更新服务或小程序时，CLI 会读取线上快照中的用户变量并重新加密上传；首次部署没有线上
+快照，因此使用空的用户变量集合。平台系统变量由 Secret 服务管理，不作为用户变量上传。
 
-本地环境变量可通过以下命令管理，默认操作当前目录的 `.env`，也可通过
-`--source-root` 指定项目目录；这些命令不会请求部署服务：
+通过 `app_id` 查看当前线上版本的环境变量及快照状态：
 
 ```bash
 coze-dev deploy code env list
-coze-dev deploy code env set API_KEY "secret value"
-coze-dev deploy code env delete API_KEY
-coze-dev deploy code env list --source-root ./projects/example
+coze-dev deploy code env list --app-id 7672644451805691910
 ```
 
-`env set` 和 `env delete` 不允许操作 `COZE_` 前缀的保留变量。
-
 小程序部署可重复指定渠道：微信为 `10000127`，抖音为 `10000126`：
 
 ```bash
@@ -123,6 +119,13 @@ coze-dev deploy code deploy --source-root . --application-type mini_program \
   --connector-id 10000127 --yes --wait
 ```
 
+小程序预览先完成授权，再执行 preview。preview 会打包微信的 dist/ 或抖音的 dist-tt/ 并上传。Project ID 可通过参数传入或从 .coze 自动读取。
+
+```bash
+coze-dev deploy code mini-program auth --platform wechat --mini-app-id wx123 --source-root .
+coze-dev deploy code mini-program preview --platform wechat --mini-app-id wx123 --source-root .
+```
+
 绑定小程序 AppID 时，默认从源码目录 `.coze [project]` 读取该目录的 `project_id`：
 
 ```bash

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

@@ -1,17 +1,20 @@
+#!/usr/bin/env bash
+
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
 PREVIEW_DIR="/source/preview"
 LOG_DIR="${COZE_LOG_DIR:-$ROOT_DIR/logs}"
 LOG_CLIENT_FILE="$LOG_DIR/client.log"
+LOG_SERVER_FILE="$LOG_DIR/server.log"
 mkdir -p "$LOG_DIR"
 
 # ==================== 配置项 ====================
 # Server 服务配置
 SERVER_HOST="0.0.0.0"
-SERVER_PORT="9091"
+SERVER_PORT="${SERVER_PORT:-9091}"
 # Expo 项目配置
 EXPO_HOST="0.0.0.0"
 EXPO_DIR="expo"
-EXPO_PORT="5000"
+EXPO_PORT="${EXPO_PORT:-5000}"
 WEB_URL="${COZE_PROJECT_DOMAIN_DEFAULT:-http://127.0.0.1:${SERVER_PORT}}"
 ASSUME_YES="1"
 EXPO_PUBLIC_BACKEND_BASE_URL="${EXPO_PUBLIC_BACKEND_BASE_URL:-$WEB_URL}"
@@ -22,6 +25,7 @@ export EXPO_PUBLIC_BACKEND_BASE_URL EXPO_PACKAGER_PROXY_URL EXPO_PUBLIC_COZE_PRO
 # 运行时变量（为避免 set -u 的未绑定错误，预置为空）
 SERVER_PID=""
 EXPO_PID=""
+PNPM_BIN=""
 
 # ==================== 工具函数 ====================
 check_command() {
@@ -112,22 +116,67 @@ wait_port_connectable() {
   return 1
 }
 
-start_expo() {
-  local offline="${1:-0}"
+# coze-daemon 会在 runtime shell 退出时清理原进程组。
+# 通过 Node detached spawn 创建独立 session/进程组，并将 stdio 直接写入日志。
+spawn_detached() {
+  local cwd="$1"
+  local log_file="$2"
+  shift 2
+
+  node - "$cwd" "$log_file" "$@" <<'NODE'
+const fs = require('node:fs');
+const { spawn } = require('node:child_process');
 
-  pushd "$ROOT_DIR/client"
+const [cwd, logFile, command, ...args] = process.argv.slice(2);
+if (!cwd || !logFile || !command) {
+  throw new Error('spawn_detached 缺少 cwd、log_file 或 command');
+}
+
+const logFd = fs.openSync(logFile, 'a');
+try {
+  const child = spawn(command, args, {
+    cwd,
+    detached: true,
+    env: process.env,
+    stdio: ['ignore', logFd, logFd],
+  });
+  child.unref();
+  process.stdout.write(String(child.pid));
+} finally {
+  fs.closeSync(logFd);
+}
+NODE
+}
 
+stop_detached() {
+  local pid="${1:-}"
+  if [ -z "$pid" ]; then
+    return
+  fi
+
+  kill -TERM -- "-$pid" 2>/dev/null || kill -TERM "$pid" 2>/dev/null || true
+  sleep 1
+  kill -KILL -- "-$pid" 2>/dev/null || true
+}
+
+start_expo() {
+  local offline="${1:-0}"
+  local -a expo_env
+  expo_env=(
+    "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"
+  )
   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" ) &
-  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" ) &
+    expo_env+=("EXPO_OFFLINE=1")
   fi
-  EXPO_PID=$!
-  disown $EXPO_PID 2>/dev/null || true
 
-  popd
+  EXPO_PID="$(spawn_detached \
+    "$ROOT_DIR/client" \
+    "$LOG_CLIENT_FILE" \
+    /usr/bin/env "${expo_env[@]}" \
+    "$PNPM_BIN" exec expo start --clear --port "$EXPO_PORT")"
 }
 
 detect_expo_fetch_failed() {
@@ -168,6 +217,8 @@ check_command "npm"
 check_command "pnpm"
 check_command "lsof"
 check_command "bash"
+check_command "node"
+PNPM_BIN="$(command -v pnpm)"
 
 # 端口占用预检查与处理
 ensure_port SERVER_PORT "$SERVER_PORT"
@@ -175,9 +226,12 @@ ensure_port EXPO_PORT "$EXPO_PORT"
 
 echo "==================== 启动 server 服务 ===================="
 echo "正在执行：pnpm run dev (server)"
-( pushd "$ROOT_DIR/server" > /dev/null && SERVER_PORT="$SERVER_PORT" nohup pnpm run dev; popd > /dev/null ) &
-SERVER_PID=$!
-disown $SERVER_PID 2>/dev/null || true
+: > "$LOG_SERVER_FILE"
+export SERVER_PORT
+SERVER_PID="$(spawn_detached \
+  "$ROOT_DIR/server" \
+  /dev/null \
+  "$PNPM_BIN" run dev)"
 if [ -z "${SERVER_PID}" ]; then
   echo "无法获取 server 后台进程 PID"
 fi
@@ -185,11 +239,12 @@ echo "server 服务已启动，进程 ID：${SERVER_PID:-unknown}"
 
 echo "==================== 启动 Expo 项目 ===================="
 echo "开始启动 Expo 服务，端口 ${EXPO_PORT}"
+: > "$LOG_CLIENT_FILE"
 start_expo 0
 if detect_expo_fetch_failed 8; then
   echo "Expo 启动检测到网络错误：TypeError: fetch failed，启用离线模式重试"
-  if [ -n "${EXPO_PID}" ]; then kill -9 "$EXPO_PID" 2>/dev/null || true; fi
-  : > "$ROOT_DIR/logs/client.log"
+  stop_detached "$EXPO_PID"
+  : > "$LOG_CLIENT_FILE"
   start_expo 1
 fi
 # 输出以下环境变量，确保 Expo 项目能正确连接到 Server 服务

package/lib/__templates__/nextjs/scripts/dev.sh

@@ -14,6 +14,9 @@ DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
 
 cd "${COZE_WORKSPACE_PATH}"
 
+LOG_DIR="${COZE_LOG_DIR:-${COZE_WORKSPACE_PATH}/logs}"
+LOG_SERVER_FILE="${LOG_DIR}/server.log"
+
 kill_port_if_listening() {
     local pids
     pids=$(ss -H -lntp 2>/dev/null | awk -v port="${DEPLOY_RUN_PORT}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | paste -sd' ' - || true)
@@ -36,4 +39,10 @@ echo "Clearing port ${DEPLOY_RUN_PORT} before start."
 kill_port_if_listening
 echo "Starting HTTP service on port ${DEPLOY_RUN_PORT} for dev..."
 
-PORT=${DEPLOY_RUN_PORT} pnpm tsx watch src/server.ts
+mkdir -p "${LOG_DIR}"
+: > "${LOG_SERVER_FILE}"
+
+# 保持服务为前台进程，让外层 coze-dev dev 的 PID 在整个服务生命周期内有效。
+# 同时通过 tee 将同一份输出写入 logs/server.log。
+exec env PORT="${DEPLOY_RUN_PORT}" pnpm tsx watch src/server.ts \
+  > >(tee -a "${LOG_SERVER_FILE}") 2>&1

package/lib/__templates__/nextjs/template.config.js

@@ -3,6 +3,7 @@
 import { spawn } from 'child_process';
 import { resolve, join, basename } from 'path';
 import { appendFileSync, openSync, closeSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
 
 
 
@@ -74,7 +75,8 @@ const config = {
       const projectRoot = resolve(outputPath);
 
       // Determine log directory
-      const logDir = process.env.COZE_LOG_DIR || resolve(__dirname, '../.log');
+      const cozeHome = process.env.COZE_HOME || join(homedir(), '.coze');
+      const logDir = process.env.COZE_LOG_DIR || join(cozeHome, 'logs');
       mkdirSync(logDir, { recursive: true });
 
       // Use project name in log file to avoid conflicts

package/lib/__templates__/phaser/_gitignore

@@ -8,6 +8,7 @@ coverage/
 
 *.log
 *.tsbuildinfo
+logs/
 .vite/
 .cache/
 node-compile-cache/

package/lib/__templates__/phaser/scripts/dev.sh

@@ -2,10 +2,81 @@
 set -Eeuo pipefail
 
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
-PORT="${DEPLOY_RUN_PORT:-${PORT:-<%= port %>}}"
+PORT="${PORT:-<%= port %>}"
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
 cd "${COZE_WORKSPACE_PATH}"
 
-COZE_PHASER_GAME_ENV=DEV pnpm vite \
-  --port "${PORT}" \
+get_listening_pids() {
+  local port="$1"
+
+  if command -v lsof >/dev/null 2>&1; then
+    lsof -tiTCP:"${port}" -sTCP:LISTEN 2>/dev/null || true
+  elif command -v ss >/dev/null 2>&1; then
+    ss -H -lntp 2>/dev/null \
+      | awk -v port="${port}" '$4 ~ ":"port"$"' \
+      | grep -o 'pid=[0-9]*' \
+      | cut -d= -f2 \
+      | sort -u || true
+  else
+    echo "Warning: neither lsof nor ss found, cannot check port ${port}." >&2
+  fi
+}
+
+kill_port_if_listening() {
+  local port="$1"
+  local pids
+
+  pids="$(get_listening_pids "${port}")"
+  if [[ -z "${pids}" ]]; then
+    echo "Port ${port} is free."
+    return
+  fi
+
+  echo "Port ${port} is in use by PIDs: ${pids//$'\n'/ } (SIGKILL)"
+  echo "${pids}" | xargs kill -9 2>/dev/null || true
+  sleep 1
+
+  pids="$(get_listening_pids "${port}")"
+  if [[ -n "${pids}" ]]; then
+    echo "Failed to clear port ${port}; remaining PIDs: ${pids//$'\n'/ }." >&2
+    return 1
+  fi
+
+  echo "Port ${port} cleared."
+}
+
+echo "Clearing port ${DEPLOY_RUN_PORT} before start."
+kill_port_if_listening "${DEPLOY_RUN_PORT}"
+
+<% if (process.env.NODE_ENV === 'test') { %>
+# Keep the process attached in tests so the test runner can collect logs and stop it.
+exec env COZE_PHASER_GAME_ENV=DEV pnpm vite \
+  --port "${DEPLOY_RUN_PORT}" \
   --host 127.0.0.1 \
   --strictPort
+<% } else { %>
+LOG_DIR="${COZE_WORKSPACE_PATH}/logs"
+LOG_FILE="${LOG_DIR}/phaser-dev.log"
+PID_FILE="${LOG_DIR}/phaser-dev.pid"
+mkdir -p "${LOG_DIR}"
+
+echo "Starting Phaser dev server on port ${DEPLOY_RUN_PORT}..."
+server_pid="$(COZE_PHASER_GAME_ENV=DEV node scripts/spawn-detached.cjs \
+  "${LOG_FILE}" pnpm vite \
+  --port "${DEPLOY_RUN_PORT}" \
+  --host 127.0.0.1 \
+  --strictPort)"
+echo "${server_pid}" > "${PID_FILE}"
+
+sleep 1
+if ! kill -0 "${server_pid}" 2>/dev/null; then
+  echo "Phaser dev server failed to start. See ${LOG_FILE}." >&2
+  tail -n 20 "${LOG_FILE}" >&2 || true
+  rm -f "${PID_FILE}"
+  exit 1
+fi
+
+echo "Phaser dev server started (PID: ${server_pid})."
+echo "Log file: ${LOG_FILE}"
+echo "PID file: ${PID_FILE}"
+<% } %>

package/lib/__templates__/phaser/scripts/spawn-detached.cjs

@@ -0,0 +1,29 @@
+const fs = require('node:fs');
+const { spawn } = require('node:child_process');
+
+const [logFile, command, ...args] = process.argv.slice(2);
+
+if (!logFile || !command) {
+  process.stderr.write(
+    'Usage: node scripts/spawn-detached.cjs <log-file> <command> [...args]\n',
+  );
+  process.exit(1);
+}
+
+const logFd = fs.openSync(logFile, 'a');
+const child = spawn(command, args, {
+  cwd: process.cwd(),
+  detached: process.platform !== 'win32',
+  env: process.env,
+  stdio: ['ignore', logFd, logFd],
+});
+
+fs.closeSync(logFd);
+child.unref();
+
+if (!child.pid) {
+  process.stderr.write('Failed to start detached process.\n');
+  process.exit(1);
+}
+
+process.stdout.write(String(child.pid));

package/lib/__templates__/phaser/scripts/start.sh

@@ -2,10 +2,81 @@
 set -Eeuo pipefail
 
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
-PORT="${DEPLOY_RUN_PORT:-${PORT:-<%= port %>}}"
+PORT="${PORT:-<%= port %>}"
+DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
 cd "${COZE_WORKSPACE_PATH}"
 
-COZE_PHASER_GAME_ENV=PROD pnpm vite preview \
-  --port "${PORT}" \
+get_listening_pids() {
+  local port="$1"
+
+  if command -v lsof >/dev/null 2>&1; then
+    lsof -tiTCP:"${port}" -sTCP:LISTEN 2>/dev/null || true
+  elif command -v ss >/dev/null 2>&1; then
+    ss -H -lntp 2>/dev/null \
+      | awk -v port="${port}" '$4 ~ ":"port"$"' \
+      | grep -o 'pid=[0-9]*' \
+      | cut -d= -f2 \
+      | sort -u || true
+  else
+    echo "Warning: neither lsof nor ss found, cannot check port ${port}." >&2
+  fi
+}
+
+kill_port_if_listening() {
+  local port="$1"
+  local pids
+
+  pids="$(get_listening_pids "${port}")"
+  if [[ -z "${pids}" ]]; then
+    echo "Port ${port} is free."
+    return
+  fi
+
+  echo "Port ${port} is in use by PIDs: ${pids//$'\n'/ } (SIGKILL)"
+  echo "${pids}" | xargs kill -9 2>/dev/null || true
+  sleep 1
+
+  pids="$(get_listening_pids "${port}")"
+  if [[ -n "${pids}" ]]; then
+    echo "Failed to clear port ${port}; remaining PIDs: ${pids//$'\n'/ }." >&2
+    return 1
+  fi
+
+  echo "Port ${port} cleared."
+}
+
+echo "Clearing port ${DEPLOY_RUN_PORT} before start."
+kill_port_if_listening "${DEPLOY_RUN_PORT}"
+
+<% if (process.env.NODE_ENV === 'test') { %>
+# Keep the process attached in tests so the test runner can collect logs and stop it.
+exec env COZE_PHASER_GAME_ENV=PROD pnpm vite preview \
+  --port "${DEPLOY_RUN_PORT}" \
   --host 127.0.0.1 \
   --strictPort
+<% } else { %>
+LOG_DIR="${COZE_WORKSPACE_PATH}/logs"
+LOG_FILE="${LOG_DIR}/phaser-start.log"
+PID_FILE="${LOG_DIR}/phaser-start.pid"
+mkdir -p "${LOG_DIR}"
+
+echo "Starting Phaser production server on port ${DEPLOY_RUN_PORT}..."
+server_pid="$(COZE_PHASER_GAME_ENV=PROD node scripts/spawn-detached.cjs \
+  "${LOG_FILE}" pnpm vite preview \
+  --port "${DEPLOY_RUN_PORT}" \
+  --host 127.0.0.1 \
+  --strictPort)"
+echo "${server_pid}" > "${PID_FILE}"
+
+sleep 1
+if ! kill -0 "${server_pid}" 2>/dev/null; then
+  echo "Phaser production server failed to start. See ${LOG_FILE}." >&2
+  tail -n 20 "${LOG_FILE}" >&2 || true
+  rm -f "${PID_FILE}"
+  exit 1
+fi
+
+echo "Phaser production server started (PID: ${server_pid})."
+echo "Log file: ${LOG_FILE}"
+echo "PID file: ${PID_FILE}"
+<% } %>

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

@@ -8,6 +8,9 @@ cd "${COZE_WORKSPACE_PATH}"
 # PID 文件，用于追踪上一次启动的进程树
 # ---------------------------------------------------------
 PID_FILE="/tmp/coze-dev-run.pid"
+LOG_DIR="/tmp/coze-logs"
+LOG_FILE="${LOG_DIR}/dev.log"
+DEV_PID=""
 
 # ---------------------------------------------------------
 # 工具函数
@@ -89,7 +92,8 @@ cleanup_previous_run() {
 # 2. 安装依赖
 # ---------------------------------------------------------
 echo "📦 Installing dependencies..."
-pnpm install
+PNPM_BIN="$(command -v pnpm)"
+"${PNPM_BIN}" install
 echo "✅ Dependencies installed successfully!"
 
 # ---------------------------------------------------------
@@ -108,11 +112,14 @@ kill_port_if_listening "${SERVER_PORT}"
 # 4. 退出时自动清理子进程（信号 trap）
 # ---------------------------------------------------------
 cleanup_on_exit() {
-    echo "🛑 dev_run.sh exiting, cleaning up child processes..."
-    # 杀掉当前脚本的所有子进程
-    kill -- -$$ 2>/dev/null || true
+    local exit_code=$?
+    trap - EXIT INT TERM HUP
+    if [[ -n "${DEV_PID}" ]] && kill -0 "${DEV_PID}" 2>/dev/null; then
+        echo "🛑 dev_run.sh exiting, cleaning up child processes..."
+        kill_process_tree "${DEV_PID}"
+    fi
     rm -f "${PID_FILE}"
-    exit 0
+    exit "${exit_code}"
 }
 trap cleanup_on_exit EXIT INT TERM HUP
 
@@ -134,17 +141,16 @@ start_service() {
     echo "Starting Taro H5 Dev Server and NestJS Server..."
 
     export PORT=${DEPLOY_RUN_PORT}
-    rm -f /tmp/coze-logs/dev.log
-    mkdir -p /tmp/coze-logs
+    mkdir -p "${LOG_DIR}"
+    : > "${LOG_FILE}"
 
-    # 后台启动并记录 PID
-    pnpm dev 2>&1 | tee /tmp/coze-logs/dev.log &
-    local dev_pid=$!
-    echo "${dev_pid}" > "${PID_FILE}"
-    echo "📝 Dev process started with PID: ${dev_pid} (saved to ${PID_FILE})"
+    # 后台启动以便记录真实 pnpm PID，但脚本持续 wait，保持外层 CLI 生命周期有效。
+    "${PNPM_BIN}" dev > >(tee -a "${LOG_FILE}") 2>&1 &
+    DEV_PID=$!
+    echo "${DEV_PID}" > "${PID_FILE}"
+    echo "📝 Dev process started with PID: ${DEV_PID} (saved to ${PID_FILE})"
 
-    # 前台等待，保证 trap 能正常捕获信号
-    wait "${dev_pid}" || true
+    wait "${DEV_PID}"
 }
 
 echo "Starting HTTP services on port ${DEPLOY_RUN_PORT} (web) and ${SERVER_PORT} (server)..."

package/lib/__templates__/vite/template.config.js

@@ -2,6 +2,7 @@
 import { spawn } from 'child_process';
 import { resolve, join, basename } from 'path';
 import { appendFileSync, openSync, closeSync, mkdirSync } from 'fs';
+import { homedir } from 'os';
 
 
 
@@ -81,7 +82,8 @@ const config = {
       const projectRoot = resolve(outputPath);
 
       // Determine log directory
-      const logDir = process.env.COZE_LOG_DIR || resolve(__dirname, '../.log');
+      const cozeHome = process.env.COZE_HOME || join(homedir(), '.coze');
+      const logDir = process.env.COZE_LOG_DIR || join(cozeHome, 'logs');
       mkdirSync(logDir, { recursive: true });
 
       // Use project name in log file to avoid conflicts