@coze-arch/cli 0.0.36-alpha.2c0689 → 0.0.36-alpha.4e6503

package/lib/__templates__/taro/server/src/main.ts

@@ -12,12 +12,6 @@ function parsePort(): number {
       return port;
     }
   }
-
-  const envPort = parseInt(process.env.SERVER_PORT || '', 10);
-  if (!isNaN(envPort) && envPort > 0 && envPort < 65536) {
-    return envPort;
-  }
-
   return <%= serverPort %>;
 }
 
@@ -44,12 +38,12 @@ async function bootstrap() {
     console.log(`Server running on http://localhost:${port}`);
   } catch (err) {
     if (err.code === 'EADDRINUSE') {
-      console.error(`❌ 端口 ${port} 被占用，请设置其他 SERVER_PORT 后重试。`);
+      console.error(`❌ 端口 \({port} 被占用! 请运行 'npx kill-port \){port}' 然后重试。`);
       process.exit(1);
     } else {
       throw err;
     }
   }
-  console.log(`Application is running on: http://localhost:${port}`);
+  console.log(`Application is running on: http://localhost:<%= serverPort %>`);
 }
 bootstrap();

package/lib/__templates__/templates.json

@@ -16,17 +16,10 @@
           },
           "port": {
             "type": "number",
-            "default": 5000,
+            "default": 8081,
             "minimum": 1024,
             "maximum": 65535,
             "description": "Metro bundler port"
-          },
-          "serverPort": {
-            "type": "number",
-            "default": 9091,
-            "minimum": 1024,
-            "maximum": 65535,
-            "description": "Express backend server port"
           }
         },
         "required": [],
@@ -101,49 +94,6 @@
         "additionalProperties": false
       }
     },
-    {
-      "name": "phaser",
-      "description": "Phaser（2D 游戏）：`coze-dev init ${COZE_WORKSPACE_PATH} --template phaser`\n- 适用：基于 Phaser 3、Vite 和 TypeScript 的 2D Web 游戏。",
-      "location": "./phaser",
-      "paramsSchema": {
-        "type": "object",
-        "properties": {
-          "appName": {
-            "type": "string",
-            "minLength": 1,
-            "pattern": "^[a-z0-9-]+$",
-            "description": "Application name (lowercase, alphanumeric and hyphens only)"
-          },
-          "port": {
-            "type": "number",
-            "default": 5000,
-            "minimum": 1024,
-            "maximum": 65535,
-            "description": "Development and preview server port"
-          }
-        },
-        "required": [],
-        "additionalProperties": false
-      }
-    },
-    {
-      "name": "phaser-static",
-      "description": "Phaser Static（纯静态 2D 游戏）：coze-dev init ${COZE_WORKSPACE_PATH} --template phaser-static\n- 适用：浏览器原生 JavaScript ESM 的 Phaser 3 游戏。\n- Phaser 与 Phaser Bridge 从 CDN 加载；无需 npm、Vite 或 TypeScript。",
-      "location": "./phaser-static",
-      "paramsSchema": {
-        "type": "object",
-        "properties": {
-          "appName": {
-            "type": "string",
-            "minLength": 1,
-            "pattern": "^[a-z0-9-]+$",
-            "description": "Application name (lowercase, alphanumeric and hyphens only)"
-          }
-        },
-        "required": [],
-        "additionalProperties": false
-      }
-    },
     {
       "name": "pi-agent",
       "description": "Pi Agent：`coze-dev init ${COZE_WORKSPACE_PATH} --template pi-agent`\n- 适用：基于 pi-agent-core 的 AI Agent 应用\n- 支持飞书、微信等多渠道接入\n- 内置 Dashboard 管理面板\n- 使用 TypeScript + Express + Vite",

package/lib/__templates__/vite/package.json

@@ -22,7 +22,7 @@
     "@types/express": "^5.0.0",
     "@types/node": "^22.10.5",
     "autoprefixer": "^10.4.20",
-    "coze-coding-dev-sdk": "^0.7.25-beta.8",
+    "coze-coding-dev-sdk": "^0.7.16",
     "esbuild": "^0.24.2",
     "eslint": "^9",
     "eslint-plugin-import": "^2.32.0",

package/lib/__templates__/vite/pnpm-lock.yaml

@@ -32,8 +32,8 @@ importers:
         specifier: ^10.4.20
         version: 10.4.23(postcss@8.5.6)
       coze-coding-dev-sdk:
-        specifier: ^0.7.25-beta.8
-        version: 0.7.25-beta.8(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0)
+        specifier: ^0.7.16
+        version: 0.7.16(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0)
       esbuild:
         specifier: ^0.27.2
         version: 0.27.2
@@ -910,8 +910,8 @@ packages:
       typescript:
         optional: true
 
-  coze-coding-dev-sdk@0.7.25-beta.8:
-    resolution: {integrity: sha512-RSKlXCO0W/OPDjx9D9JICn2cGeOJw3iG+y0Pr1AhAf7YdAjjNbBZoG7qfg0Zg2SqgaVN2qSLQFmKPbhNq9ZWSg==}
+  coze-coding-dev-sdk@0.7.16:
+    resolution: {integrity: sha512-B7gRPBa+sfrZL8ur0+F/92SOgZgFaWD/fOnCN2DjthnHSdmCYhAJWCfqzG2oO2vwTiYCXkKUuTBZ3MJLMj886g==}
     engines: {node: '>=18.0.0'}
     hasBin: true
 
@@ -3281,7 +3281,7 @@ snapshots:
     optionalDependencies:
       typescript: 5.9.3
 
-  coze-coding-dev-sdk@0.7.25-beta.8(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0):
+  coze-coding-dev-sdk@0.7.16(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__/vite/scripts/build.ps1

@@ -4,7 +4,7 @@ $workspace = if ($env:COZE_WORKSPACE_PATH) { $env:COZE_WORKSPACE_PATH } else { (
 Set-Location $workspace
 
 Write-Host "Installing dependencies..."
-& pnpm install --prefer-frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
+& pnpm install --frozen-lockfile --prefer-offline --loglevel debug --reporter=append-only
 if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
 
 Write-Host "Building frontend with Vite..."

package/lib/__templates__/vite/scripts/dev.ps1

@@ -7,9 +7,9 @@ function Get-WorkspacePath {
   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-ProcessTree([int] $targetProcessId) {
+  if ($targetProcessId -gt 0 -and (Get-Process -Id $targetProcessId -ErrorAction SilentlyContinue)) {
+    & taskkill.exe /PID $targetProcessId /T /F *> $null
   }
 }
 
@@ -20,11 +20,40 @@ function Stop-ListeningProcess([int] $port) {
   }
 }
 
+function Test-PortListening([int] $port) {
+  return $null -ne (Get-NetTCPConnection -LocalPort $port -State Listen -ErrorAction SilentlyContinue | Select-Object -First 1)
+}
+
+function Wait-PortState([int] $port, [bool] $listening, [int] $timeoutSeconds) {
+  $deadline = (Get-Date).AddSeconds($timeoutSeconds)
+  do {
+    if ((Test-PortListening $port) -eq $listening) {
+      return $true
+    }
+    Start-Sleep -Milliseconds 250
+  } while ((Get-Date) -lt $deadline)
+  return $false
+}
+
+function Get-Port {
+  $rawPort = if ($env:DEPLOY_RUN_PORT) { $env:DEPLOY_RUN_PORT } elseif ($env:PORT) { $env:PORT } else { "<%= port %>" }
+  $parsedPort = 0
+  if (-not [int]::TryParse($rawPort, [ref] $parsedPort) -or $parsedPort -lt 1 -or $parsedPort -gt 65535) {
+    throw "Invalid port '$rawPort'. Expected an integer between 1 and 65535."
+  }
+  return $parsedPort
+}
+
 $workspace = Get-WorkspacePath
-$defaultPort = <%= port %>
-$port = if ($env:DEPLOY_RUN_PORT) { [int] $env:DEPLOY_RUN_PORT } elseif ($env:PORT) { [int] $env:PORT } else { $defaultPort }
+if (-not (Test-Path -LiteralPath $workspace -PathType Container)) {
+  throw "Workspace directory does not exist: $workspace"
+}
+$port = Get-Port
 Set-Location $workspace
 Stop-ListeningProcess $port
+if (-not (Wait-PortState $port $false 10)) {
+  throw "Port $port is still in use after stopping the previous process."
+}
 
 <% if (process.env.NODE_ENV === 'test') { %>
 $env:PORT = "$port"
@@ -38,7 +67,10 @@ $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))
+  $previousPid = 0
+  if ([int]::TryParse((Get-Content $pidFile -Raw).Trim(), [ref] $previousPid)) {
+    Stop-ProcessTree $previousPid
+  }
   Remove-Item $pidFile -Force
 }
 
@@ -51,13 +83,37 @@ try {
 }
 
 $process.Id | Set-Content $pidFile
-Start-Sleep -Seconds 1
-if ($process.HasExited) {
+$processStartTime = $process.StartTime.ToUniversalTime().Ticks
+if (-not (Wait-PortState $port $true 30)) {
   Get-Content $errorLogFile -Tail 20 -ErrorAction SilentlyContinue
+  Stop-ProcessTree $process.Id
   Remove-Item $pidFile -Force -ErrorAction SilentlyContinue
-  exit 1
+  throw "Dev server did not listen on port $port within 30 seconds."
+}
+
+# 后台服务最长运行 20 分钟。回收前校验启动时间，避免 PID 复用后误杀无关进程。
+$pidFileBase64 = [Convert]::ToBase64String([Text.Encoding]::Unicode.GetBytes($pidFile))
+$watchdogScript = @'
+$targetProcessId = __PROCESS_ID__
+$expectedStartTime = __START_TIME__
+$pidFile = [Text.Encoding]::Unicode.GetString([Convert]::FromBase64String('__PID_FILE__'))
+Start-Sleep -Seconds 1200
+$target = Get-Process -Id $targetProcessId -ErrorAction SilentlyContinue
+if ($target -and $target.StartTime.ToUniversalTime().Ticks -eq $expectedStartTime) {
+  & taskkill.exe /PID $targetProcessId /T /F *> $null
+}
+$recordedPid = 0
+if ((Test-Path -LiteralPath $pidFile) -and [int]::TryParse((Get-Content -LiteralPath $pidFile -Raw).Trim(), [ref] $recordedPid) -and $recordedPid -eq $targetProcessId) {
+  Remove-Item -LiteralPath $pidFile -Force -ErrorAction SilentlyContinue
 }
+'@
+$watchdogScript = $watchdogScript.Replace('__PROCESS_ID__', "$($process.Id)").Replace('__START_TIME__', "$processStartTime").Replace('__PID_FILE__', $pidFileBase64)
+$encodedWatchdog = [Convert]::ToBase64String([Text.Encoding]::Unicode.GetBytes($watchdogScript))
+Start-Process -FilePath "powershell.exe" -WindowStyle Hidden -ArgumentList @(
+  "-NoProfile", "-ExecutionPolicy", "Bypass", "-EncodedCommand", $encodedWatchdog
+) | Out-Null
 
 Write-Host "Dev server started (PID: $($process.Id))."
+Write-Host "Auto stop after 1200 seconds."
 Write-Host "Log file: $logFile"
 <% } %>

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

@@ -32,89 +32,8 @@ 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 express + Vite dev server on port ${DEPLOY_RUN_PORT}..."
-
-# 测试环境保持服务为前台进程，便于 e2e 收集输出并停止进程。
-exec env PORT="${DEPLOY_RUN_PORT}" pnpm tsx watch server/server.ts
-<% } else { %>
-LOG_DIR="${COZE_LOG_DIR:-${COZE_WORKSPACE_PATH}/logs}"
-LOG_FILE="${LOG_DIR}/server.log"
-PID_FILE="${LOG_DIR}/server.pid"
-
-# 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');
-
-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
-}
-
-# 监听端口的是孙进程（pnpm -> tsx -> node），只清端口会漏掉上层 pnpm/tsx，
-# 所以先按上次记录的 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 express + Vite 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)" tsx watch server/server.ts)"
-echo "${server_pid}" > "${PID_FILE}"
-
-sleep 1
-if [[ -z "${server_pid}" ]] || ! kill -0 "${server_pid}" 2>/dev/null; then
-  echo "Dev server failed to start. See ${LOG_FILE}." >&2
-  tail -n 20 "${LOG_FILE}" >&2 || true
-  rm -f "${PID_FILE}"
-  exit 1
-fi
-
-echo "Dev server started (PID: ${server_pid})."
-echo "Log file: ${LOG_FILE}"
-echo "PID file: ${PID_FILE}"
-<% } %>
+PORT=${DEPLOY_RUN_PORT} pnpm tsx watch server/server.ts

package/lib/__templates__/vite/scripts/start.ps1

@@ -1,8 +1,14 @@
 $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 }
+if (-not (Test-Path -LiteralPath $workspace -PathType Container)) {
+  throw "Workspace directory does not exist: $workspace"
+}
+$rawPort = if ($env:DEPLOY_RUN_PORT) { $env:DEPLOY_RUN_PORT } elseif ($env:PORT) { $env:PORT } else { "<%= port %>" }
+$port = 0
+if (-not [int]::TryParse($rawPort, [ref] $port) -or $port -lt 1 -or $port -gt 65535) {
+  throw "Invalid port '$rawPort'. Expected an integer between 1 and 65535."
+}
 Set-Location $workspace
 
 Write-Host "Starting express production server on port $port..."

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

@@ -2,7 +2,6 @@
 import { spawn } from 'child_process';
 import { resolve, join, basename } from 'path';
 import { appendFileSync, openSync, closeSync, mkdirSync } from 'fs';
-import { homedir } from 'os';
 
 
 
@@ -73,7 +72,7 @@ const config = {
     }
 
     const cmd = 'pnpm';
-    const args = ['update', 'coze-coding-dev-sdk@^0.7.25-beta.8'];
+    const args = ['update', 'coze-coding-dev-sdk@^0.7.0'];
     console.log(
       `\nTriggering: ${cmd} ${args.join(' ')} (running in background)`,
     );
@@ -82,8 +81,7 @@ const config = {
       const projectRoot = resolve(outputPath);
 
       // Determine log directory
-      const cozeHome = process.env.COZE_HOME || join(homedir(), '.coze');
-      const logDir = process.env.COZE_LOG_DIR || join(cozeHome, 'logs');
+      const logDir = process.env.COZE_LOG_DIR || resolve(__dirname, '../.log');
       mkdirSync(logDir, { recursive: true });
 
       // Use project name in log file to avoid conflicts