@coze-arch/cli 0.0.36-alpha.1dcb49 → 0.0.36-alpha.3ab612

package/lib/__templates__/taro/README.md

@@ -63,8 +63,8 @@ pnpm install
 pnpm dev
 ```
 
-- 前端地址：http://localhost:5000
-- 后端地址：http://localhost:3000
+- 前端地址：http://localhost:<%= port %>
+- 后端地址：http://localhost:<%= serverPort %>
 
 单独启动：
 
@@ -560,7 +560,7 @@ async function getLocation(): Promise<Taro.getLocation.SuccessCallbackResult> {
 ### 开发命令
 
 ```sh
-pnpm dev:server // 启动开发服务 (热重载, 默认端口 3000)
+pnpm dev:server // 启动开发服务 (热重载, 默认端口 <%= serverPort %>，可用 SERVER_PORT 环境变量覆盖)
 pnpm build:server // 构建生产版本
 ```
 
@@ -586,7 +586,7 @@ npx nest g service modules/order
 
 ```sh
 ## 服务端口
-PORT=3000
+SERVER_PORT=<%= serverPort %>
 
 ## 微信小程序配置
 WX_APP_ID=你的AppID

package/lib/__templates__/taro/config/index.ts

@@ -12,6 +12,14 @@ import pkg from '../package.json';
 
 dotenv.config({ path: path.resolve(__dirname, '../.env.local') });
 
+const resolvePort = (value: string | undefined, fallback: number): number => {
+  const port = Number(value);
+  return Number.isInteger(port) && port > 0 && port < 65536 ? port : fallback;
+};
+
+const h5Port = resolvePort(process.env.PORT, <%= port %>);
+const serverPort = resolvePort(process.env.SERVER_PORT, <%= serverPort %>);
+
 const generateTTProjectConfig = (outputRoot: string) => {
   const config = {
     miniprogramRoot: './',
@@ -182,12 +190,12 @@ export default defineConfig<'vite'>(async (merge, _env) => {
         mode: 'hash',
       },
       devServer: {
-        port: <%= port %>,
+        port: h5Port,
         host: '0.0.0.0',
         open: false,
         proxy: {
           '/api': {
-            target: 'http://localhost:<%= serverPort %>',
+            target: `http://localhost:${serverPort}`,
             changeOrigin: true,
           },
         },

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.8
+        version: 0.7.25-beta.8(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.8:
+    resolution: {integrity: sha512-RSKlXCO0W/OPDjx9D9JICn2cGeOJw3iG+y0Pr1AhAf7YdAjjNbBZoG7qfg0Zg2SqgaVN2qSLQFmKPbhNq9ZWSg==}
     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.8(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.8",
     "dotenv": "^17.2.3",
     "drizzle-kit": "^0.31.8",
     "drizzle-orm": "^0.45.1",

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

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

package/lib/__templates__/templates.json

@@ -16,10 +16,17 @@
           },
           "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": [],
@@ -119,6 +126,24 @@
         "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/.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__/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.16",
+    "coze-coding-dev-sdk": "^0.7.25-beta.8",
     "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.16
-        version: 0.7.16(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0)
+        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)
       esbuild:
         specifier: ^0.27.2
         version: 0.27.2
@@ -910,8 +910,8 @@ packages:
       typescript:
         optional: true
 
-  coze-coding-dev-sdk@0.7.16:
-    resolution: {integrity: sha512-B7gRPBa+sfrZL8ur0+F/92SOgZgFaWD/fOnCN2DjthnHSdmCYhAJWCfqzG2oO2vwTiYCXkKUuTBZ3MJLMj886g==}
+  coze-coding-dev-sdk@0.7.25-beta.8:
+    resolution: {integrity: sha512-RSKlXCO0W/OPDjx9D9JICn2cGeOJw3iG+y0Pr1AhAf7YdAjjNbBZoG7qfg0Zg2SqgaVN2qSLQFmKPbhNq9ZWSg==}
     engines: {node: '>=18.0.0'}
     hasBin: true
 
@@ -3281,7 +3281,7 @@ snapshots:
     optionalDependencies:
       typescript: 5.9.3
 
-  coze-coding-dev-sdk@0.7.16(openai@6.16.0(ws@8.19.0)(zod@4.3.5))(ws@8.19.0):
+  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):
     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

@@ -0,0 +1,16 @@
+$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 frontend with Vite..."
+& pnpm vite build
+if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+
+Write-Host "Bundling server with tsup..."
+& pnpm tsup server/server.ts --format cjs --platform node --target node20 --outDir dist-server --no-splitting --no-minify --external vite
+exit $LASTEXITCODE

package/lib/__templates__/vite/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 tsx watch server/server.ts
+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 tsx watch server/server.ts") -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 "Dev server started (PID: $($process.Id))."
+Write-Host "Log file: $logFile"
+<% } %>

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

@@ -32,8 +32,89 @@ 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}..."
 
-PORT=${DEPLOY_RUN_PORT} pnpm tsx watch server/server.ts
+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}"
+<% } %>

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

@@ -0,0 +1,18 @@
+$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
+}
+
+if (Get-Command coze-dev -ErrorAction SilentlyContinue) {
+  & coze-dev check-bins --help *> $null
+  if ($LASTEXITCODE -eq 0) {
+    & coze-dev check-bins --fix
+    exit $LASTEXITCODE
+  }
+}

package/lib/__templates__/vite/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 express production server on port $port..."
+$env:PORT = "$port"
+& node dist-server/server.js
+exit $LASTEXITCODE

package/lib/__templates__/vite/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__/vite/template.config.js

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