@coze-arch/cli 0.0.36-alpha.a7a716 → 0.0.36-alpha.dd2af3

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`，它会自己翻到底。
@@ -119,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__/expo/pnpm-lock.yaml

@@ -269,8 +269,8 @@ importers:
         specifier: ^2.8.5
         version: 2.8.6
       coze-coding-dev-sdk:
-        specifier: ^0.7.24
-        version: 0.7.24(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0)
+        specifier: ^0.7.25-beta.4
+        version: 0.7.25-beta.4(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0)
       dayjs:
         specifier: ^1.11.20
         version: 1.11.20
@@ -2643,8 +2643,8 @@ packages:
     resolution: {integrity: sha512-AdmX6xUzdNASswsFtmwSt7Vj8po9IuqXm0UXz7QKPuEUmPB4XyjGfaAr2PSuELMwkRMVH1EpIkX5bTZGRB3eCA==}
     engines: {node: '>=10'}
 
-  coze-coding-dev-sdk@0.7.24:
-    resolution: {integrity: sha512-oL9Tg5PwxP6iMixonzzMO4aBjOKWcFUMVM+iz5dPyaqQkG84HP1y9DqK5DJVmtdfJuYdAW7pzOatDqLvgvZiXg==}
+  coze-coding-dev-sdk@0.7.25-beta.4:
+    resolution: {integrity: sha512-+PCoJ8yhsAIlx3YT898bCkB2gx5EMBunJMP7/kI/Jq/8dj7SDU9EUBZ2Z8ZJocSaPBT9T6dVvFHBsDLZh4FN/Q==}
     engines: {node: '>=18.0.0'}
     hasBin: true
 
@@ -9088,7 +9088,7 @@ snapshots:
       path-type: 4.0.0
       yaml: 1.10.2
 
-  coze-coding-dev-sdk@0.7.24(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0):
+  coze-coding-dev-sdk@0.7.25-beta.4(openai@6.16.0(ws@8.19.0)(zod@4.3.6))(ws@8.19.0):
     dependencies:
       '@langchain/core': 1.1.17(openai@6.16.0(ws@8.19.0)(zod@4.3.6))
       '@langchain/openai': 1.2.3(@langchain/core@1.1.17(openai@6.16.0(ws@8.19.0)(zod@4.3.6)))(ws@8.19.0)

package/lib/__templates__/expo/server/package.json

@@ -12,7 +12,7 @@
   "dependencies": {
     "@supabase/supabase-js": "2.95.3",
     "cors": "^2.8.5",
-    "coze-coding-dev-sdk": "^0.7.24",
+    "coze-coding-dev-sdk": "^0.7.25-beta.4",
     "dayjs": "^1.11.20",
     "dotenv": "^17.2.3",
     "drizzle-orm": "^0.45.1",

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__/phaser/vite.config.ts

@@ -4,7 +4,7 @@ import { defineConfig, type Plugin } from "vite";
 import serveStatic from "serve-static";
 
 const DEV_PHASER_BRIDGE_URL =
-  "https://unpkg.byted-static.com/latest/coze-game/phaser-bridge/dist/index.js";
+  "https://lf-coze-web-cdn.coze.cn/obj/eden-cn/lm-lgvj/ljhwZthlaukjlkulzlp/coze-game/js/phaser-bridge.min.js";
 
 function injectDevPhaserBridge(): Plugin {
   return {

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__/taro/pnpm-lock.yaml

@@ -204,8 +204,8 @@ importers:
         specifier: 2.95.3
         version: 2.95.3
       coze-coding-dev-sdk:
-        specifier: ^0.7.24
-        version: 0.7.24(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0)
+        specifier: ^0.7.25-beta.4
+        version: 0.7.25-beta.4(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0)
       dotenv:
         specifier: ^17.2.3
         version: 17.2.3
@@ -5416,8 +5416,8 @@ packages:
       typescript:
         optional: true
 
-  coze-coding-dev-sdk@0.7.24:
-    resolution: {integrity: sha512-oL9Tg5PwxP6iMixonzzMO4aBjOKWcFUMVM+iz5dPyaqQkG84HP1y9DqK5DJVmtdfJuYdAW7pzOatDqLvgvZiXg==}
+  coze-coding-dev-sdk@0.7.25-beta.4:
+    resolution: {integrity: sha512-+PCoJ8yhsAIlx3YT898bCkB2gx5EMBunJMP7/kI/Jq/8dj7SDU9EUBZ2Z8ZJocSaPBT9T6dVvFHBsDLZh4FN/Q==}
     engines: {node: '>=18.0.0'}
     hasBin: true
 
@@ -17159,7 +17159,7 @@ snapshots:
     optionalDependencies:
       typescript: 5.9.3
 
-  coze-coding-dev-sdk@0.7.24(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0):
+  coze-coding-dev-sdk@0.7.25-beta.4(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0):
     dependencies:
       '@langchain/core': 1.1.16(openai@6.16.0(ws@8.19.0)(zod@4.3.5))
       '@langchain/openai': 1.2.3(@langchain/core@1.1.16(openai@6.16.0(ws@8.19.0)(zod@4.3.5)))(ws@8.19.0)

package/lib/__templates__/taro/server/package.json

@@ -17,7 +17,7 @@
     "@nestjs/core": "^10.4.15",
     "@nestjs/platform-express": "^10.4.15",
     "@supabase/supabase-js": "2.95.3",
-    "coze-coding-dev-sdk": "^0.7.24",
+    "coze-coding-dev-sdk": "^0.7.25-beta.4",
     "dotenv": "^17.2.3",
     "drizzle-kit": "^0.31.8",
     "drizzle-orm": "^0.45.1",