@coze-arch/cli 0.0.37 → 0.1.3-alpha.32023e

package/lib/__templates__/nuxt-vue/scripts/build.ps1

@@ -0,0 +1,12 @@
+$ErrorActionPreference = "Stop"
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+Set-Location $workspace
+
+Write-Host "Installing dependencies..."
+& pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
+if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+
+Write-Host "Building the Nuxt.js project..."
+& pnpm nuxt build
+exit $LASTEXITCODE

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

@@ -6,7 +6,7 @@ COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
 cd "${COZE_WORKSPACE_PATH}"
 
 echo "Installing dependencies..."
-pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
+bash "$COZE_WORKSPACE_PATH/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
 
 echo "Building the Nuxt.js project..."
 pnpm nuxt build

package/lib/__templates__/nuxt-vue/scripts/dev.ps1

@@ -0,0 +1,63 @@
+$ErrorActionPreference = "Stop"
+
+function Get-WorkspacePath {
+  if ($env:COZE_WORKSPACE_PATH) {
+    return $env:COZE_WORKSPACE_PATH
+  }
+  return (Get-Location).Path
+}
+
+function Stop-ProcessTree([int] $processId) {
+  if ($processId -gt 0 -and (Get-Process -Id $processId -ErrorAction SilentlyContinue)) {
+    & taskkill.exe /PID $processId /T /F *> $null
+  }
+}
+
+function Stop-ListeningProcess([int] $port) {
+  $connections = Get-NetTCPConnection -LocalPort $port -State Listen -ErrorAction SilentlyContinue
+  $connections | Select-Object -ExpandProperty OwningProcess -Unique | ForEach-Object {
+    Stop-ProcessTree $_
+  }
+}
+
+$workspace = Get-WorkspacePath
+$defaultPort = <%= port %>
+$port = if ($env:DEPLOY_RUN_PORT) { [int] $env:DEPLOY_RUN_PORT } elseif ($env:PORT) { [int] $env:PORT } else { $defaultPort }
+Set-Location $workspace
+Stop-ListeningProcess $port
+
+<% if (process.env.NODE_ENV === 'test') { %>
+$env:PORT = "$port"
+& pnpm nuxt dev
+exit $LASTEXITCODE
+<% } else { %>
+$logDirectory = if ($env:COZE_LOG_DIR) { $env:COZE_LOG_DIR } else { Join-Path $workspace "logs" }
+$logFile = Join-Path $logDirectory "server.log"
+$errorLogFile = Join-Path $logDirectory "server-error.log"
+$pidFile = Join-Path $logDirectory "server.pid"
+New-Item -ItemType Directory -Force -Path $logDirectory | Out-Null
+
+if (Test-Path $pidFile) {
+  Stop-ProcessTree ([int] (Get-Content $pidFile -Raw))
+  Remove-Item $pidFile -Force
+}
+
+$previousPort = $env:PORT
+$env:PORT = "$port"
+try {
+  $process = Start-Process -FilePath $env:ComSpec -ArgumentList @("/d", "/s", "/c", "pnpm nuxt dev") -WorkingDirectory $workspace -RedirectStandardOutput $logFile -RedirectStandardError $errorLogFile -PassThru
+} finally {
+  if ($null -eq $previousPort) { Remove-Item Env:PORT -ErrorAction SilentlyContinue } else { $env:PORT = $previousPort }
+}
+
+$process.Id | Set-Content $pidFile
+Start-Sleep -Seconds 1
+if ($process.HasExited) {
+  Get-Content $errorLogFile -Tail 20 -ErrorAction SilentlyContinue
+  Remove-Item $pidFile -Force -ErrorAction SilentlyContinue
+  exit 1
+}
+
+Write-Host "Nuxt dev server started (PID: $($process.Id))."
+Write-Host "Log file: $logFile"
+<% } %>

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

@@ -14,9 +14,29 @@ DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
 
 cd "${COZE_WORKSPACE_PATH}"
 
+list_port_pids() {
+    local port=$1
+    local pids=""
+    local has_tool=0
+
+    if command -v ss >/dev/null 2>&1; then
+      has_tool=1
+      pids=$(ss -H -lntp 2>/dev/null | awk -v port="${port}" '$4 ~ ":"port"$"' | grep -o 'pid=[0-9]*' | cut -d= -f2 | sort -u | paste -sd' ' - || true)
+    fi
+    if [[ -z "${pids}" ]] && command -v lsof >/dev/null 2>&1; then
+      has_tool=1
+      pids=$(lsof -t -iTCP:"${port}" -sTCP:LISTEN 2>/dev/null | sort -u | paste -sd' ' - || true)
+    fi
+    if [[ "${has_tool}" -eq 0 ]]; then
+      echo "Warning: neither ss nor lsof available, cannot inspect port ${port}." >&2
+    fi
+
+    echo "${pids}"
+}
+
 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)
+    pids=$(list_port_pids "${DEPLOY_RUN_PORT}")
     if [[ -z "${pids}" ]]; then
       echo "Port ${DEPLOY_RUN_PORT} is free."
       return
@@ -24,7 +44,7 @@ kill_port_if_listening() {
     echo "Port ${DEPLOY_RUN_PORT} in use by PIDs: ${pids} (SIGKILL)"
     echo "${pids}" | xargs -I {} kill -9 {}
     sleep 1
-    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)
+    pids=$(list_port_pids "${DEPLOY_RUN_PORT}")
     if [[ -n "${pids}" ]]; then
       echo "Warning: port ${DEPLOY_RUN_PORT} still busy after SIGKILL, PIDs: ${pids}"
     else
@@ -32,8 +52,217 @@ kill_port_if_listening() {
     fi
 }
 
+<% if (process.env.NODE_ENV === 'test') { %>
 echo "Clearing port ${DEPLOY_RUN_PORT} before start."
 kill_port_if_listening
 echo "Starting Nuxt dev server on port ${DEPLOY_RUN_PORT}..."
 
-PORT=${DEPLOY_RUN_PORT} pnpm nuxt dev
+# 测试环境保持服务为前台进程，便于 e2e 收集输出并停止进程。
+exec env PORT="${DEPLOY_RUN_PORT}" pnpm nuxt dev
+<% } else { %>
+LOG_DIR="${COZE_LOG_DIR:-${COZE_WORKSPACE_PATH}/logs}"
+LOG_FILE="${LOG_DIR}/server.log"
+PID_FILE="${LOG_DIR}/server.pid"
+
+# detached 出去的进程没人负责回收，超过这个时长就自己退出，避免端口与内存长期泄露。
+MAX_RUNTIME_SECONDS=1200
+
+# 真正被 detach 的是这层 bash wrapper：它是进程组 leader，组内 watchdog 到点回收整组
+# （wrapper -> pnpm -> nuxt -> 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');
+
+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
+}
+
+READY_RETRIES=10
+READY_PROBE_HOSTS=("127.0.0.1" "::1")
+LOG_TAIL_LINES=40
+
+dump_log() {
+  echo "---- tail -n ${LOG_TAIL_LINES} ${LOG_FILE} ----" >&2
+  tail -n "${LOG_TAIL_LINES}" "${LOG_FILE}" >&2 || true
+  echo "---- end of ${LOG_FILE} ----" >&2
+}
+
+# 仅用于无 ss/lsof 时的兜底探测。服务可能只 bind IPv4 loopback、只 bind IPv6 loopback，
+# 或 bind 双栈通配地址，逐个 loopback 试连即可覆盖。
+port_connectable() {
+  local port=$1
+  local host
+  for host in "${READY_PROBE_HOSTS[@]}"; do
+    if command -v nc >/dev/null 2>&1; then
+      if nc -z -w 1 "${host}" "${port}" >/dev/null 2>&1; then
+        return 0
+      fi
+    elif (exec 3<>"/dev/tcp/${host}/${port}") >/dev/null 2>&1; then
+      return 0
+    fi
+  done
+  return 1
+}
+
+port_probe_available() {
+  command -v ss >/dev/null 2>&1 || command -v lsof >/dev/null 2>&1
+}
+
+# 端口监听者是否属于本进程组：spawn detached 后 PID == PGID，子孙进程继承该 PGID。
+#   0 = 是；1 = 不是（无人监听，或监听者不属于本进程组）；2 = 无探测工具，无法判断
+port_listened_by_pgid() {
+  local port=$1 pgid=$2
+  local listener owner
+
+  if ! port_probe_available; then
+    return 2
+  fi
+
+  for listener in $(list_port_pids "${port}" 2>/dev/null); do
+    owner=$(ps -o pgid= -p "${listener}" 2>/dev/null | tr -d ' ')
+    if [[ "${owner}" == "${pgid}" ]]; then
+      return 0
+    fi
+  done
+  return 1
+}
+
+wait_for_ready() {
+  local pid=$1 port=$2
+  local attempt=0 owned
+
+  if ! port_probe_available; then
+    echo "Warning: 缺少 ss 与 lsof，无法确认端口监听者归属，仅按 loopback 可连接性判断就绪。" >&2
+  fi
+
+  while [[ "${attempt}" -lt "${READY_RETRIES}" ]]; do
+    if ! kill -0 "${pid}" 2>/dev/null; then
+      echo "Dev server 进程在启动过程中退出。" >&2
+      return 1
+    fi
+
+    if port_listened_by_pgid "${port}" "${pid}"; then
+      owned=0
+    else
+      owned=$?
+    fi
+    if [[ "${owned}" -eq 0 ]]; then
+      return 0
+    fi
+    if [[ "${owned}" -eq 2 ]] && port_connectable "${port}"; then
+      return 0
+    fi
+
+    sleep 1
+    attempt=$((attempt + 1))
+  done
+
+  return 2
+}
+
+# 监听端口的是孙进程（pnpm -> nuxt -> node），只清端口会漏掉上层 pnpm/nuxt，
+# 所以先按上次记录的 PID 把整个进程组回收掉。
+if [[ -f "${PID_FILE}" ]]; then
+  stop_detached "$(cat "${PID_FILE}" 2>/dev/null || true)"
+  rm -f "${PID_FILE}"
+fi
+
+echo "Clearing port ${DEPLOY_RUN_PORT} before start."
+kill_port_if_listening
+echo "Starting Nuxt dev server on port ${DEPLOY_RUN_PORT}..."
+
+mkdir -p "${LOG_DIR}"
+: > "${LOG_FILE}"
+
+export PORT="${DEPLOY_RUN_PORT}"
+server_pid="$(spawn_detached "${COZE_WORKSPACE_PATH}" "${LOG_FILE}" \
+  "$(command -v pnpm)" nuxt dev)"
+if [[ -z "${server_pid}" ]]; then
+  echo "Dev server failed to start: 未获取到后台进程 PID。" >&2
+  dump_log
+  exit 1
+fi
+echo "${server_pid}" > "${PID_FILE}"
+
+if wait_for_ready "${server_pid}" "${DEPLOY_RUN_PORT}"; then
+  ready_status=0
+else
+  ready_status=$?
+fi
+
+if [[ "${ready_status}" -ne 0 ]]; then
+  if [[ "${ready_status}" -eq 2 ]]; then
+    # 进程还活着但迟迟没监听端口：多半是编译/运行时报错后 nuxt watch 驻留，日志里有真正原因。
+    echo "Dev server 在 ${READY_RETRIES} 次探测（每次 1s）内未就绪于端口 ${DEPLOY_RUN_PORT}（进程 ${server_pid} 仍在运行，已回收）。" >&2
+  else
+    echo "Dev server failed to start. See ${LOG_FILE}." >&2
+  fi
+  # 先 dump 再回收，避免 kill 的输出混进日志尾部；exit 1 意味着不留下任何后台进程。
+  dump_log
+  stop_detached "${server_pid}"
+  rm -f "${PID_FILE}"
+  exit 1
+fi
+
+echo "Dev server started (PID: ${server_pid}), listening on port ${DEPLOY_RUN_PORT}."
+echo "Auto stop after ${MAX_RUNTIME_SECONDS}s."
+echo "Log file: ${LOG_FILE}"
+echo "PID file: ${PID_FILE}"
+<% } %>

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

@@ -0,0 +1,142 @@
+#!/usr/bin/env bash
+# Install dependencies on local disk and expose them to the source tree by symlink.
+set -euo pipefail
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd -P)"
+if [ "$(basename "$(dirname "$SCRIPT_DIR")")" = ".cozeproj" ]; then
+  PROJECT_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd -P)"
+else
+  PROJECT_ROOT="$(cd "$SCRIPT_DIR/.." && pwd -P)"
+fi
+
+command -v pnpm >/dev/null 2>&1 || {
+  echo "[node_modules] pnpm is required" >&2
+  exit 1
+}
+
+DRIVE_ROOT="${COZE_DRIVE_ROOT:-/Coze/Drive}"
+if [ -d "$DRIVE_ROOT" ]; then
+  DRIVE_ROOT="$(cd "$DRIVE_ROOT" && pwd -P)"
+else
+  DRIVE_ROOT="${DRIVE_ROOT%/}"
+fi
+case "$PROJECT_ROOT" in
+  "$DRIVE_ROOT"|"$DRIVE_ROOT"/*) ;;
+  *)
+    (cd "$PROJECT_ROOT" && pnpm install "$@")
+    exit 0
+    ;;
+esac
+
+COZE_ROOT="${COZE_DIR_PATH:-${HOME}/Coze/tmp}"
+PROJECT_ID="$(basename "$PROJECT_ROOT")-$(printf '%s' "$PROJECT_ROOT" | cksum | awk '{print $1}')"
+mkdir -p "$COZE_ROOT/nm"
+COZE_ROOT="$(cd "$COZE_ROOT" && pwd -P)"
+WORK_DIR="$COZE_ROOT/nm/$PROJECT_ID"
+mkdir -p "$WORK_DIR"
+case "$WORK_DIR" in
+  "$DRIVE_ROOT"|"$DRIVE_ROOT"/*)
+    echo "[node_modules] local dependency directory must not be on Coze Drive: $WORK_DIR" >&2
+    exit 1
+    ;;
+esac
+
+# Mirror the project with symlinks. node_modules stays real in WORK_DIR;
+# workspace directories stay real too, so pnpm never writes them to Drive.
+mirror_root() {
+  local entry name
+  while IFS= read -r -d '' entry; do
+    name="$(basename "$entry")"
+    case "$name" in
+      node_modules|pnpm-lock.yaml) continue ;;
+      client|server)
+        [ -f "$PROJECT_ROOT/$name/package.json" ] && continue
+        ;;
+    esac
+    rm -rf "$entry"
+  done < <(find "$WORK_DIR" -mindepth 1 -maxdepth 1 -print0)
+
+  while IFS= read -r -d '' entry; do
+    name="$(basename "$entry")"
+    case "$name" in
+      node_modules|pnpm-lock.yaml) continue ;;
+      client|server)
+        [ -f "$entry/package.json" ] && continue
+        ;;
+    esac
+    ln -s "$entry" "$WORK_DIR/$name"
+  done < <(find "$PROJECT_ROOT" -mindepth 1 -maxdepth 1 -print0)
+}
+
+mirror_workspace() {
+  local workspace="$1" source_dir="$PROJECT_ROOT/$1" work_dir="$WORK_DIR/$1"
+  local entry name
+  if [ -L "$work_dir" ] || { [ -e "$work_dir" ] && [ ! -d "$work_dir" ]; }; then
+    rm -rf "$work_dir"
+  fi
+  mkdir -p "$work_dir"
+
+  while IFS= read -r -d '' entry; do
+    [ "$(basename "$entry")" = "node_modules" ] || rm -rf "$entry"
+  done < <(find "$work_dir" -mindepth 1 -maxdepth 1 -print0)
+
+  while IFS= read -r -d '' entry; do
+    name="$(basename "$entry")"
+    [ "$name" = "node_modules" ] || ln -s "$entry" "$work_dir/$name"
+  done < <(find "$source_dir" -mindepth 1 -maxdepth 1 -print0)
+}
+
+mirror_root
+for workspace in client server; do
+  if [ -f "$PROJECT_ROOT/$workspace/package.json" ]; then
+    mirror_workspace "$workspace"
+  fi
+done
+
+# pnpm refuses to update a symlinked lockfile, so install against a local copy.
+rm -rf "$WORK_DIR/pnpm-lock.yaml"
+if [ -f "$PROJECT_ROOT/pnpm-lock.yaml" ]; then
+  cp "$PROJECT_ROOT/pnpm-lock.yaml" "$WORK_DIR/pnpm-lock.yaml"
+fi
+
+echo "[node_modules] Installing dependencies in $WORK_DIR"
+if ! (cd "$WORK_DIR" && pnpm install "$@"); then
+  rm -f "$WORK_DIR/pnpm-lock.yaml"
+  exit 1
+fi
+
+if [ -f "$WORK_DIR/pnpm-lock.yaml" ]; then
+  temporary_lockfile="$(mktemp "$PROJECT_ROOT/.pnpm-lock.yaml.XXXXXX")"
+  cp "$WORK_DIR/pnpm-lock.yaml" "$temporary_lockfile"
+  chmod 0644 "$temporary_lockfile"
+  mv -f "$temporary_lockfile" "$PROJECT_ROOT/pnpm-lock.yaml"
+fi
+
+link_node_modules() {
+  local source_dir="$1" target_dir="$2"
+  local current=""
+  mkdir -p "$target_dir"
+  if [ -L "$source_dir/node_modules" ]; then
+    current="$(readlink "$source_dir/node_modules")"
+    case "$current" in
+      "$COZE_ROOT"/nm/*/node_modules|"$COZE_ROOT"/nm/*/*/node_modules) ;;
+      *)
+        echo "[node_modules] refusing to replace unmanaged symlink: $source_dir/node_modules" >&2
+        exit 1
+        ;;
+    esac
+    rm "$source_dir/node_modules"
+  elif [ -e "$source_dir/node_modules" ]; then
+    rm -rf "$source_dir/node_modules"
+  fi
+  ln -s "$target_dir" "$source_dir/node_modules"
+}
+
+link_node_modules "$PROJECT_ROOT" "$WORK_DIR/node_modules"
+for workspace in client server; do
+  if [ -f "$PROJECT_ROOT/$workspace/package.json" ]; then
+    link_node_modules "$PROJECT_ROOT/$workspace" "$WORK_DIR/$workspace/node_modules"
+  fi
+done
+
+echo "[node_modules] Dependencies ready"

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

@@ -0,0 +1,12 @@
+$ErrorActionPreference = "Stop"
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+Set-Location $workspace
+
+Write-Host "Installing dependencies..."
+& pnpm install --prefer-frozen-lockfile --prefer-offline
+if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+
+Write-Host "Preparing Nuxt..."
+& pnpm exec nuxt prepare
+exit $LASTEXITCODE

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

@@ -6,10 +6,7 @@ COZE_WORKSPACE_PATH="${COZE_WORKSPACE_PATH:-$(pwd)}"
 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
-fi
+bash "$COZE_WORKSPACE_PATH/scripts/prepare-node-modules.sh" --prefer-frozen-lockfile --prefer-offline
 
 echo "Preparing Nuxt project..."
 pnpm exec nuxt prepare

package/lib/__templates__/nuxt-vue/scripts/start.ps1

@@ -0,0 +1,11 @@
+$ErrorActionPreference = "Stop"
+
+$workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (Get-Location).Path }
+$defaultPort = <%= port %>
+$port = if ($env:DEPLOY_RUN_PORT) { $env:DEPLOY_RUN_PORT } elseif ($env:PORT) { $env:PORT } else { $defaultPort }
+Set-Location $workspace
+
+Write-Host "Starting Nuxt.js service on port $port for production..."
+$env:PORT = "$port"
+& node .output/server/index.mjs
+exit $LASTEXITCODE

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

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

package/lib/__templates__/phaser/.coze

@@ -0,0 +1,18 @@
+[project]
+requires = ["nodejs-24"]
+project_type = "game"
+game_type = "phaser"
+
+[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"]
+
+[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"]

package/lib/__templates__/phaser/README.md

@@ -0,0 +1,45 @@
+# <%= appName %>
+
+这是一个基于 Phaser、Vite 和 TypeScript 的 2D 游戏项目，由扣子编程 CLI 创建。
+
+## 快速开始
+
+```bash
+coze-dev dev
+```
+
+开发服务器默认运行在 [http://127.0.0.1:<%= port %>](http://127.0.0.1:<%= port %>)。
+
+```bash
+coze-dev validate  # TypeScript 类型检查
+coze-dev build     # 生产构建
+coze-dev start     # 预览生产构建
+```
+
+## 文件结构
+
+```text
+├── assets/                     # 图片、序列帧、视频和音频
+├── debug-runtime/              # 调试 Flow
+├── src/assets.ts               # 素材 key 与路径
+├── src/main.ts                 # 游戏入口
+├── src/scene/BootScene.ts      # 启动与全量加载
+├── src/utils/asset-loader.ts   # 批量和单素材加载
+├── src/types.ts                # 类型定义
+└── vite.config.ts              # Bridge 注入与素材目录映射
+```
+
+- 素材按类型放在 `assets/`，并登记到 `src/assets.ts` 对应的分类表。
+- 序列帧只登记文件夹；Loader 从 `manifest.json` 读取帧数和帧率。
+- `BootScene` 加载游戏素材；运行时可用 `loadAsset(this, key)` 单独加载。
+- 开发和生产都使用稳定的 `assets/...` 路径，生产构建原样复制素材目录。
+
+`IMAGES`、`IMAGE_SEQUENCES`、`VIDEOS` 和 `AUDIOS` 是四个素材分类表。
+
+## 可视化编辑标识
+
+用 `markEditable` 标记可在编辑器中调整的对象；第三个参数可选，仅用于编辑器展示名称：
+
+```ts
+markEditable('ui.start-button', button, { label: '开始按钮' });
+```

package/lib/__templates__/phaser/_gitignore

@@ -0,0 +1,23 @@
+node_modules/
+dist/
+coverage/
+
+.env
+.env.*
+!.env.example
+
+*.log
+*.tsbuildinfo
+logs/
+.vite/
+.cache/
+node-compile-cache/
+
+.DS_Store
+._*
+.idea/
+.vscode/
+
+.coze-logs/
+.codegraph/
+.preview/

package/lib/__templates__/phaser/_npmrc

@@ -0,0 +1,14 @@
+loglevel=error
+registry=https://registry.npmmirror.com
+
+strictStorePkgContentCheck=false
+verifyStoreIntegrity=false
+network-concurrency=16
+fetch-retries=3
+fetch-timeout=60000
+strict-peer-dependencies=false
+auto-install-peers=true
+lockfile=true
+prefer-frozen-lockfile=true
+resolution-mode=highest
+update-notifier=false