@coze-arch/cli 0.0.37 → 0.0.39-alpha.bdff32

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

@@ -1,18 +1,27 @@
+#!/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:-<%= serverPort %>}"
 # Expo 项目配置
 EXPO_HOST="0.0.0.0"
 EXPO_DIR="expo"
-EXPO_PORT="5000"
-WEB_URL="${COZE_PROJECT_DOMAIN_DEFAULT:-http://127.0.0.1:${SERVER_PORT}}"
+# DEPLOY_RUN_PORT 是平台注入的对外端口，EXPO_PORT 保留为本地覆盖项。
+EXPO_PORT="${DEPLOY_RUN_PORT:-${EXPO_PORT:-<%= port %>}}"
+COZE_HARDWARE_DID="${COZE_HARDWARE_DID:-}"
+if [ -n "${EXPO_PORT:-}" ] && [ -n "${COZE_HARDWARE_DID}" ]; then
+  WEB_URL="${COZE_PROJECT_DOMAIN_DEFAULT:-https://preview-${COZE_HARDWARE_DID}-${EXPO_PORT}.dev.coze.site}"
+else
+  WEB_URL="${COZE_PROJECT_DOMAIN_DEFAULT:-http://127.0.0.1:${SERVER_PORT}}"
+fi
 ASSUME_YES="1"
 EXPO_PUBLIC_BACKEND_BASE_URL="${EXPO_PUBLIC_BACKEND_BASE_URL:-$WEB_URL}"
 EXPO_PUBLIC_COZE_PROJECT_ID="${COZE_PROJECT_ID:-}"
@@ -22,6 +31,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 +122,94 @@ wait_port_connectable() {
   return 1
 }
 
-start_expo() {
-  local offline="${1:-0}"
+# detached 出去的进程没人负责回收，超过这个时长就自己退出，避免端口与内存长期泄露。
+MAX_RUNTIME_SECONDS=1200
+
+# 真正被 detach 的是这层 bash wrapper：它是进程组 leader，组内 watchdog 到点回收整组
+# （wrapper -> pnpm -> expo/node）；被包的进程自己先退出时也顺手清空进程组，不留残余。
+RUN_WITH_TIMEOUT='
+timeout_seconds=$1
+shift
+
+"$@" &
+child_pid=$!
+
+# 先忽略 TERM，才能在向整组发 TERM（自己也在组里）之后存活下来补一发 KILL。
+( trap "" TERM
+  sleep "${timeout_seconds}"
+  echo "[dev] 后台进程运行超过 ${timeout_seconds}s，回收进程组 $$。"
+  kill -TERM -- "-$$" 2>/dev/null || true
+  sleep 5
+  kill -KILL -- "-$$" 2>/dev/null || true
+) &
+
+wait "${child_pid}"
+kill -KILL -- "-$$" 2>/dev/null || true
+'
+
+# coze-daemon 会在 runtime shell 退出时清理原进程组。
+# 通过 Node detached spawn 创建独立 session/进程组，并将 stdio 直接写入日志。
+# 返回的 PID 是 wrapper 的，同时也是整个进程组的 PGID，后续按组回收。
+spawn_detached() {
+  local cwd="$1"
+  local log_file="$2"
+  shift 2
+
+  node - "$cwd" "$log_file" \
+    /bin/bash -c "${RUN_WITH_TIMEOUT}" detached-runner "${MAX_RUNTIME_SECONDS}" "$@" <<'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 +250,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 +259,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 +272,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 服务
@@ -202,6 +290,7 @@ if [ -z "${EXPO_PID}" ]; then
 fi
 
 echo "所有服务已启动。Server PID: ${SERVER_PID}, Expo PID: ${EXPO_PID}"
+echo "两个服务均在 ${MAX_RUNTIME_SECONDS}s 后自动退出。"
 
 echo "检查 Server 服务端口：$SERVER_HOST:$SERVER_PORT"
 if wait_port_connectable "$SERVER_HOST" "$SERVER_PORT" 10 2; then

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

@@ -0,0 +1,15 @@
+$ErrorActionPreference = "Stop"
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+Set-Location $workspace
+
+& pnpm install --registry=https://registry.npmmirror.com
+if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+
+Push-Location (Join-Path $workspace "server")
+try {
+  & pnpm run build
+  exit $LASTEXITCODE
+} finally {
+  Pop-Location
+}

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

@@ -0,0 +1,10 @@
+$ErrorActionPreference = "Stop"
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+$port = if ($env:DEPLOY_RUN_PORT) { $env:DEPLOY_RUN_PORT } elseif ($env:PORT) { $env:PORT } else { <%= port %> }
+
+Set-Location (Join-Path $workspace "server")
+$env:NODE_ENV = "production"
+$env:PORT = "$port"
+& node dist/index.js
+exit $LASTEXITCODE

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

@@ -5,7 +5,7 @@ set -euo pipefail
 ROOT_DIR="$(pwd)"
 
 HOST="${HOST:-0.0.0.0}"
-PORT="${PORT:-5000}"
+PORT="${DEPLOY_RUN_PORT:-${PORT:-<%= port %>}}"
 
 # ==================== 工具函数 ====================
 info() {

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

@@ -4,7 +4,7 @@ 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"
-SERVER_PORT="${SERVER_PORT:-9091}"
+SERVER_PORT="${SERVER_PORT:-<%= serverPort %>}"
 
 mkdir -p "$LOG_DIR"
 

package/lib/__templates__/expo/.cozeproj/scripts/validate.ps1

@@ -0,0 +1,7 @@
+$ErrorActionPreference = "Stop"
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+Set-Location $workspace
+
+& pnpm validate
+exit $LASTEXITCODE

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

@@ -32,7 +32,9 @@ config.resolver.blockList = [
   /.*node_modules\/\.pnpm\/.*_tmp_\d+.*/,
 ];
 
-const BACKEND_TARGET = 'http://localhost:9091';
+const DEFAULT_BACKEND_PORT = '<%= serverPort %>';
+const BACKEND_PORT = process.env.SERVER_PORT || DEFAULT_BACKEND_PORT;
+const BACKEND_TARGET = `http://localhost:${BACKEND_PORT}`;
 
 const apiProxy = createProxyMiddleware({
   target: BACKEND_TARGET,

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
+        version: 0.7.25(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:
+    resolution: {integrity: sha512-5683ngikMdsRW0slGTE2OAZ1Fyj0lhkC4fGNOwsqKc35e68/gtg9KmmtK9CK9SZ+5/oIn/4wLoHXFB0gHJtO2A==}
     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(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

@@ -6,13 +6,13 @@
     "build": "node build.js",
     "dev": "bash ../.cozeproj/scripts/server_dev_run.sh",
     "preinstall": "npx only-allow pnpm",
-    "start": "NODE_ENV=production PORT=${PORT:-5000} node dist/index.js",
+    "start": "NODE_ENV=production PORT=${PORT:-<%= port %>} node dist/index.js",
     "lint": "tsc --noEmit"
   },
   "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",
     "dayjs": "^1.11.20",
     "dotenv": "^17.2.3",
     "drizzle-orm": "^0.45.1",

package/lib/__templates__/expo/server/src/index.ts

@@ -2,7 +2,7 @@ import express from "express";
 import cors from "cors";
 
 const app = express();
-const port = process.env.PORT || 9091;
+const port = process.env.PORT || <%= serverPort %>;
 
 // Middleware
 app.use(cors());

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

@@ -6,6 +6,7 @@
 
 
 
+
 export const paramsSchema = {
   type: 'object',
   properties: {
@@ -18,11 +19,18 @@ export const paramsSchema = {
     },
     port: {
       type: 'number',
-      default: 8081,
+      default: 5000,
       minimum: 1024,
       maximum: 65535,
       description: 'Metro bundler port',
     },
+    serverPort: {
+      type: 'number',
+      default: 9091,
+      minimum: 1024,
+      maximum: 65535,
+      description: 'Express backend server port',
+    },
   },
   required: [],
   additionalProperties: false,
@@ -32,7 +40,8 @@ const config = {
   description: 'Expo template for React Native applications',
   paramsSchema,
   defaultParams: {
-    port: 9090,
+    port: 5000,
+    serverPort: 9091,
     appName: 'my-expo-app',
   },
   onBeforeRender: async context => {

package/lib/__templates__/native-static/.coze

@@ -5,8 +5,10 @@ project_type = "web"
 
 [dev]
 build = []
-run = [ "sh", "-c", "python -m http.server ${DEPLOY_RUN_PORT} --bind 0.0.0.0" ]
+run = ["python3", "-m", "http.server", "${DEPLOY_RUN_PORT}", "--bind", "0.0.0.0"]
+run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/serve.ps1"]
 
 [deploy]
 build = []
-run = [ "sh", "-c", "python -m http.server ${DEPLOY_RUN_PORT} --bind 0.0.0.0" ]
+run = ["python3", "-m", "http.server", "${DEPLOY_RUN_PORT}", "--bind", "0.0.0.0"]
+run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/serve.ps1"]

package/lib/__templates__/native-static/scripts/serve.ps1

@@ -0,0 +1,7 @@
+$ErrorActionPreference = "Stop"
+
+$port = if ($env:DEPLOY_RUN_PORT) { $env:DEPLOY_RUN_PORT } else { "8000" }
+
+Write-Host "Starting static server on port $port..."
+& python -m http.server $port --bind 0.0.0.0
+exit $LASTEXITCODE

package/lib/__templates__/nextjs/.coze

@@ -4,11 +4,16 @@ project_type = "web"
 
 [dev]
 build = ["bash", "./scripts/prepare.sh"]
+build_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/prepare.ps1"]
 run = ["bash", "./scripts/dev.sh"]
+run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/dev.ps1"]
 validate = ["bash", "./scripts/validate.sh"]
+validate_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/validate.ps1"]
 deps = ["git"] # -> apt install git
 
 [deploy]
 build = ["bash","./scripts/build.sh"]
+build_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/build.ps1"]
 run = ["bash","./scripts/start.sh"]
+run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/start.ps1"]
 deps = ["git"] # -> apt install git

package/lib/__templates__/nextjs/package.json

@@ -47,7 +47,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
-    "coze-coding-dev-sdk": "^0.7.16",
+    "coze-coding-dev-sdk": "^0.7.25",
     "date-fns": "^4.1.0",
     "dotenv": "^17.2.3",
     "drizzle-kit": "^0.31.8",
@@ -56,7 +56,7 @@
     "embla-carousel-react": "^8.6.0",
     "input-otp": "^1.4.2",
     "lucide-react": "^0.468.0",
-    "next": "16.1.1",
+    "next": "16.3.3",
     "next-themes": "^0.4.6",
     "pg": "^8.16.3",
     "react": "19.2.3",
@@ -95,5 +95,10 @@
   "packageManager": "pnpm@9.0.0",
   "engines": {
     "pnpm": ">=9.0.0"
+  },
+  "pnpm": {
+    "overrides": {
+      "sharp": "0.35.3"
+    }
   }
 }