@coze-arch/cli 0.1.5 → 0.1.8-alpha.2ee669

package/lib/__templates__/nuxt-vue/scripts/prepare.sh

@@ -1,14 +1,19 @@
 #!/bin/bash
 set -Eeuo pipefail
 
-COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+# Resolve the source project from this script, then let the Web runner choose its local mirror.
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd -P)"
+if [[ "${COZE_WEB_LOCAL_ACTIVE:-}" != "${PROJECT_ROOT}" ]]; then
+  exec node "${SCRIPT_DIR}/local-workspace.cjs" prepare "$@"
+fi
+COZE_WORKSPACE_PATH="${PROJECT_ROOT}"
 
 cd "${COZE_WORKSPACE_PATH}"
 
 echo "Installing dependencies..."
-pnpm install --prefer-frozen-lockfile --prefer-offline
-if command -v coze-dev > /dev/null 2>&1 && coze-dev check-bins --help > /dev/null 2>&1; then
-  coze-dev check-bins --fix
+if [[ "${COZE_WEB_LOCAL_MIRROR:-}" != "1" ]]; then
+  bash "$COZE_WORKSPACE_PATH/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline
 fi
 
 echo "Preparing Nuxt project..."

package/lib/__templates__/nuxt-vue/scripts/validate.sh

@@ -1,10 +1,20 @@
 #!/bin/bash
 set -Eeuo pipefail
 
-COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
+# Resolve the source project from this script, then let the Web runner choose its local mirror.
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+PROJECT_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd -P)"
+if [[ "${COZE_WEB_LOCAL_ACTIVE:-}" != "${PROJECT_ROOT}" ]]; then
+  exec node "${SCRIPT_DIR}/local-workspace.cjs" validate "$@"
+fi
+COZE_WORKSPACE_PATH="${PROJECT_ROOT}"
 
 cd "${COZE_WORKSPACE_PATH}"
 
+if [[ "${COZE_WEB_LOCAL_MIRROR:-}" == "1" ]]; then
+  pnpm exec nuxt prepare
+fi
+
 echo "🔍 Running validate..."
 pnpm validate
 echo "✅ Validate passed!"

package/lib/__templates__/taro/.coze

@@ -8,7 +8,7 @@ build = ["bash", ".cozeproj/scripts/dev_build.sh"]
 build_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/dev_build.ps1"]
 run = ["bash", ".cozeproj/scripts/dev_run.sh"]
 run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/dev_run.ps1"]
-deps = ["git"] # -> apt install git
+deps = ["git", "rsync"] # -> apt install git rsync
 pack = ["bash", ".cozeproj/scripts/pack.sh"]
 pack_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ".cozeproj/scripts/pack.ps1"]
 validate = ["bash", ".cozeproj/scripts/validate.sh"]
@@ -17,4 +17,4 @@ validate_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-
 [deploy]
 build = ["bash", ".cozeproj/scripts/deploy_build.sh"]
 run = ["bash", ".cozeproj/scripts/deploy_run.sh"]
-deps = ["git"] # -> apt install git
+deps = ["git", "rsync"] # -> apt install git rsync

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

@@ -1,6 +1,13 @@
 #!/bin/bash
 set -Eeuo pipefail
 
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+if [[ "${COZE_TARO_LOCAL_ACTIVE:-}" != "${ROOT_DIR}" ]]; then
+    exec node "$ROOT_DIR/.cozeproj/scripts/local-workspace.cjs" build "$@"
+fi
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-${ROOT_DIR}}"
+export COZE_WORKSPACE_PATH
+
 cd "${COZE_WORKSPACE_PATH}"
 if [ -f "./.cozeproj/scripts/init_env.sh" ]; then
     echo "⚙️ Initializing environment..."
@@ -11,7 +18,9 @@ else
 fi
 echo "Installing dependencies..."
 # 安装所有依赖（包含 Taro 核心和 React）
-pnpm install
+if [[ "${COZE_TARO_LOCAL_MIRROR:-}" != "1" ]]; then
+    bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline
+fi
 
 echo "Building the Taro project..."
 pnpm build

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

@@ -1,6 +1,10 @@
 #!/bin/bash
 set -Eeuo pipefail
 
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-${ROOT_DIR}}"
+export COZE_WORKSPACE_PATH
+
 start_service() {
     cd "${COZE_WORKSPACE_PATH}/server/dist"
 

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

@@ -1,2 +1,14 @@
 #!/bin/bash
 set -Eeuo pipefail
+
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+if [[ "${COZE_TARO_LOCAL_ACTIVE:-}" != "${ROOT_DIR}" ]]; then
+  exec node "$ROOT_DIR/.cozeproj/scripts/local-workspace.cjs" prepare "$@"
+fi
+COZE_WORKSPACE_PATH="${ROOT_DIR}"
+export COZE_WORKSPACE_PATH
+
+cd "${COZE_WORKSPACE_PATH}"
+if [[ "${COZE_TARO_LOCAL_MIRROR:-}" != "1" ]]; then
+    bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline
+fi

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

@@ -28,7 +28,9 @@ function Start-DevProcess([string] $workingDirectory, [string] $logFile, [hashta
   }
 }
 
-$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+$projectRoot = (Resolve-Path (Join-Path $PSScriptRoot "../..")).Path
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { $projectRoot }
+$env:COZE_WORKSPACE_PATH = $workspace
 $port = if ($env:DEPLOY_RUN_PORT) { [int] $env:DEPLOY_RUN_PORT } elseif ($env:PORT) { [int] $env:PORT } else { <%= port %> }
 $serverPort = if ($env:SERVER_PORT) { [int] $env:SERVER_PORT } else { <%= serverPort %> }
 $logDirectory = if ($env:COZE_LOG_DIR) { $env:COZE_LOG_DIR } else { Join-Path $workspace "logs" }
@@ -43,7 +45,7 @@ if (Test-Path $pidFile) {
 Stop-ListeningProcess $port
 Stop-ListeningProcess $serverPort
 
-$environment = @{ PORT = "$port"; SERVER_PORT = "$serverPort" }
+$environment = @{ COZE_WORKSPACE_PATH = $workspace; PORT = "$port"; SERVER_PORT = "$serverPort" }
 if ($env:COZE_PROJECT_DOMAIN_DEFAULT) {
   $environment.PROJECT_DOMAIN = $env:COZE_PROJECT_DOMAIN_DEFAULT
 }

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

@@ -3,13 +3,17 @@ echo "⚙️ dev_run.sh 开始运行"
 set -Eeuo pipefail
 
 ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+if [[ "${COZE_TARO_LOCAL_ACTIVE:-}" != "${ROOT_DIR}" ]]; then
+    exec node "$ROOT_DIR/.cozeproj/scripts/local-workspace.cjs" dev "$@"
+fi
 COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-${ROOT_DIR}}"
+export COZE_WORKSPACE_PATH
 cd "${COZE_WORKSPACE_PATH}"
 
 # ---------------------------------------------------------
 # 项目级日志目录
 # ---------------------------------------------------------
-LOG_DIR="${COZE_WORKSPACE_PATH}/logs"
+LOG_DIR="${COZE_LOG_DIR:-${COZE_WORKSPACE_PATH}/logs}"
 LOG_FILE="${LOG_DIR}/dev.log"
 PID_FILE="${LOG_DIR}/dev.pid"
 DEV_PID=""
@@ -31,11 +35,15 @@ kill_process_tree() {
 }
 
 # detached 出去的进程没人负责回收，超过这个时长就自己退出，避免端口与内存长期泄露。
-MAX_RUNTIME_SECONDS=1200
+MAX_RUNTIME_SECONDS=3600
+
+timeout_watchdog_enabled() {
+    [[ -z "${COZE_EVAL:-}" && -z "${COZE_PROJECT_TYPE:-}" ]]
+}
 
 # 真正被 detach 的是这层 bash wrapper：它是进程组 leader，组内 watchdog 到点回收整组
 # （wrapper -> pnpm -> taro/nest）；被包的进程自己先退出时也顺手清空进程组，不留残余。
-RUN_WITH_TIMEOUT='
+RUN_WITH_TIMEOUT="$(declare -f timeout_watchdog_enabled)"'
 timeout_seconds=$1
 shift
 
@@ -43,6 +51,7 @@ shift
 child_pid=$!
 
 # 先忽略 TERM，才能在向整组发 TERM（自己也在组里）之后存活下来补一发 KILL。
+if timeout_watchdog_enabled; then
 ( trap "" TERM
   sleep "${timeout_seconds}"
   echo "[dev] 后台进程运行超过 ${timeout_seconds}s，回收进程组 $$。"
@@ -50,6 +59,7 @@ child_pid=$!
   sleep 5
   kill -KILL -- "-$$" 2>/dev/null || true
 ) &
+fi
 
 wait "${child_pid}"
 kill -KILL -- "-$$" 2>/dev/null || true
@@ -112,8 +122,15 @@ process_belongs_to_workspace() {
 
     case "${cwd}" in
         "${COZE_WORKSPACE_PATH}"|"${COZE_WORKSPACE_PATH}"/*) return 0 ;;
-        *) return 1 ;;
     esac
+
+    if [[ -n "${COZE_TARO_SOURCE_PATH:-}" ]]; then
+        case "${cwd}" in
+            "${COZE_TARO_SOURCE_PATH}"|"${COZE_TARO_SOURCE_PATH}"/*) return 0 ;;
+        esac
+    fi
+
+    return 1
 }
 
 process_group_belongs_to_workspace() {
@@ -155,12 +172,24 @@ list_port_pids() {
 
 kill_port_if_listening() {
     local port=$1
+    # 用于错误提示的端口环境变量名称，例如 DEPLOY_RUN_PORT 或 SERVER_PORT。
+    local port_env_name=$2
     local pids
+    local pid
     pids=$(list_port_pids "${port}")
     if [[ -z "${pids}" ]]; then
         echo "Port ${port} is free."
         return
     fi
+
+    # 端口可能由另一个项目占用。必须在杀进程前校验全部 PID，避免清理到一半才发现外部进程。
+    for pid in ${pids}; do
+        if ! process_belongs_to_workspace "${pid}"; then
+            echo "Error: port ${port} is occupied by PID ${pid}, which does not belong to workspace ${COZE_WORKSPACE_PATH}. Refusing to kill it. Set ${port_env_name} to another port and retry." >&2
+            return 1
+        fi
+    done
+
     echo "Port ${port} in use by PIDs: ${pids} (SIGKILL)"
     for pid in ${pids}; do
         kill_process_tree "${pid}"
@@ -168,7 +197,8 @@ kill_port_if_listening() {
     sleep 1
     pids=$(list_port_pids "${port}")
     if [[ -n "${pids}" ]]; then
-        echo "Warning: port ${port} still busy after SIGKILL, PIDs: ${pids}"
+        echo "Error: port ${port} is still occupied after cleaning up this project's processes, PIDs: ${pids}. Check the remaining processes manually or set ${port_env_name} to another port and retry." >&2
+        return 1
     else
         echo "Port ${port} cleared."
     fi
@@ -194,7 +224,9 @@ cleanup_previous_run() {
 # ---------------------------------------------------------
 echo "📦 Installing dependencies..."
 PNPM_BIN="$(command -v pnpm)"
-"${PNPM_BIN}" install
+if [[ "${COZE_TARO_LOCAL_MIRROR:-}" != "1" ]]; then
+    bash "$ROOT_DIR/.cozeproj/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline
+fi
 echo "✅ Dependencies installed successfully!"
 
 # ---------------------------------------------------------
@@ -210,9 +242,9 @@ mkdir -p "${LOG_DIR}"
 cleanup_previous_run
 
 echo "Clearing port ${PORT} (web) before start."
-kill_port_if_listening "${PORT}"
+kill_port_if_listening "${PORT}" "DEPLOY_RUN_PORT"
 echo "Clearing port ${SERVER_PORT} (server) before start."
-kill_port_if_listening "${SERVER_PORT}"
+kill_port_if_listening "${SERVER_PORT}" "SERVER_PORT"
 
 # ---------------------------------------------------------
 # 4. 启动服务
@@ -236,7 +268,7 @@ start_service() {
     DEV_PID="$(spawn_detached \
         "${COZE_WORKSPACE_PATH}" \
         "${LOG_FILE}" \
-        "${PNPM_BIN}" dev)"
+        "$(command -v node)" "$ROOT_DIR/.cozeproj/scripts/local-workspace.cjs" watch "${PNPM_BIN}" dev)"
     if [[ -z "${DEV_PID}" ]]; then
         echo "❌ 无法获取 dev 后台进程 PID"
         return 1
@@ -252,10 +284,52 @@ start_service() {
     fi
 
     echo "📝 Dev process started with PID: ${DEV_PID}"
-    echo "Auto stop after ${MAX_RUNTIME_SECONDS}s."
+    if timeout_watchdog_enabled; then
+        echo "Auto stop after ${MAX_RUNTIME_SECONDS}s."
+    fi
     echo "Log file: ${LOG_FILE}"
     echo "PID file: ${PID_FILE}"
 }
 
+warmup_preview() {
+    local base="http://127.0.0.1:${PORT}"
+    local waited=0
+
+    if ! command -v curl >/dev/null 2>&1; then
+        echo "Warmup skipped: curl is not available."
+        return 0
+    fi
+
+    echo "🔥 Warmup: waiting for web server to accept connections..."
+    while (( waited < 60 )); do
+        if curl -s -o /dev/null --max-time 3 "${base}/"; then
+            break
+        fi
+        sleep 2
+        waited=$(( waited + 2 ))
+    done
+
+    local app_config="${COZE_WORKSPACE_PATH}/src/app.config.ts"
+    local pages=""
+    if [[ -f "${app_config}" ]]; then
+        pages=$(grep -oE "[\"']pages/[^\"']+[\"']" "${app_config}" | tr -d "\"'" | sort -u || true)
+    fi
+
+    local p
+    for p in "/" "/app.config.ts"; do
+        echo "🔥 Warmup ${p}"
+        curl -s -o /dev/null --max-time 300 "${base}${p}" || echo "Warmup ${p} timed out or failed (ignored)."
+    done
+    for p in ${pages}; do
+        echo "🔥 Warmup /${p}.tsx"
+        curl -s -o /dev/null --max-time 300 "${base}/${p}.tsx" || echo "Warmup /${p}.tsx timed out or failed (ignored)."
+    done
+}
+
 echo "Starting HTTP services on port ${PORT} (web) and ${SERVER_PORT} (server)..."
 start_service
+
+if [[ "${COZE_TARO_LOCAL_MIRROR:-}" = "1" && "${COZE_DEV_SKIP_WARMUP:-0}" != "1" ]]; then
+    warmup_preview || true
+    echo "✅ Warmup finished (or timed out). Preview should load fast now."
+fi

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

@@ -1,5 +1,9 @@
 #!/bin/bash
 
+ROOT_DIR="$(cd "$(dirname "$0")/../.." && pwd)"
+COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-${ROOT_DIR}}"
+export COZE_WORKSPACE_PATH
+
 cd "${COZE_WORKSPACE_PATH}"
 
 echo "✅ 初始化完成"