@coze-arch/cli 0.0.36-alpha.dd2af3 → 0.0.36-alpha.e6ca88

package/README.md

@@ -1,154 +1,105 @@
-# @coze-coding/cli
+# @coze-arch/cli
 
-Coze Coding 的项目模板引擎，提供基于前端技术栈的项目初始化能力。
-
-## 特性
-
-- 🚀 **快速初始化**: 一键创建预配置的项目模板
-- 🤖 **AI 优先设计**: 专为 AI Agent 消费设计，提供清晰的错误信息和自描述能力
-- 📦 **多模板支持**: 支持 React、Next.js、HTML 等多种技术栈
-- 🔧 **类型安全**: 基于 JSON Schema 的参数校验和 TypeScript 类型生成
-- ⚡ **命令代理**: 统一的 dev/build/start 命令，抹平不同技术栈差异
+Coze Coding 的项目模板与本地运行 CLI。发布包名为 `@coze-arch/cli`，命令为
+`coze-dev`。
 
 ## 安装
 
 ```bash
-rush update
-
+npm install -g @coze-arch/cli
+coze-dev --help
 ```
 
-## 使用
-
-### 部署应用
+也可以不全局安装：
 
 ```bash
-coze-dev deploy auth login
-coze-dev deploy code deploy --source-root . --yes --wait
+npx @coze-arch/cli --help
 ```
 
-完整命令、参数和示例见 [部署命令文档](./docs/deploy.md)。部署命令与其它
-`coze-dev` 能力共享 `~/.coze/cli/config.json` 登录态，也支持通过
-`COZE_API_TOKEN` 提供固定运行时凭证。
-
-### 初始化项目
+## 初始化项目
 
 ```bash
-coze-coding init --template react --app-name my-app --use-typescript --use-tailwind
+coze-dev init my-app --template <template> --app-name my-app
+coze-dev init --help
 ```
 
-### 查看可用模板
+`init` 默认会渲染模板、安装依赖、初始化 Git、创建初始提交并启动开发服务。按需使用
+`--skip-install`、`--skip-git`、`--skip-commit`、`--skip-dev` 跳过这些步骤。模板名称和
+参数以 `coze-dev init --help` 的实时输出为准；未声明的参数会以 kebab-case 转为
+camelCase 后传给模板。
 
-```bash
-coze-coding init --help
-```
+## 在项目中运行
 
-### 开发命令
+初始化产物根目录的 `.coze` 是统一命令契约：
 
 ```bash
-# 启动开发服务器
-coze-coding dev
-
-# 构建生产版本
-coze-coding build
-
-# 启动生产服务器
-coze-coding start
+coze-dev dev       # 读取 dev.run
+coze-dev build     # 读取 deploy.build
+coze-dev start     # 读取 deploy.run
+coze-dev validate  # 读取 dev.validate
 ```
 
-## 模板参数
+`dev` 和 `build` 在执行前会尝试应用模板补丁；补丁失败会记录调试信息，但不会阻止主命令。
+子进程日志默认写入 `~/.coze-logs/dev.log`，可用 `--log-file <path>` 覆盖。
 
-每个模板都有自己的参数配置，通过 CLI 参数透传。参数名使用 kebab-case 格式，会自动转换为 camelCase 传入模板配置。
+## Windows 与 WSL
 
-例如：
-- `--app-name` → `appName`
-- `--use-typescript` → `useTypeScript`
-- `--port` → `port`
+原生 Windows（`process.platform === "win32"`）优先使用 `.coze` 中非空的 Windows
+覆盖命令；未配置时回退默认命令。WSL 被识别为 Linux，始终执行默认命令。
 
-## 开发模板
+| CLI 命令或场景 | 默认字段 | Windows 覆盖字段 |
+| --- | --- | --- |
+| `coze-dev dev` | `dev.run` | `dev.run_win` |
+| `coze-dev build` | `deploy.build` | `deploy.build_win` |
+| `coze-dev start` | `deploy.run` | `deploy.run_win` |
+| `coze-dev validate` | `dev.validate` | `dev.validate_win` |
+| `coze-dev deploy` 的本地打包 | `dev.pack` | `dev.pack_win` |
 
-### 模板结构
+已支持 Windows 的内置 Web 与 Phaser 模板将覆盖命令映射到 PowerShell 脚本，例如：
 
-```
-template-name/
-├── template.config.ts        # 模板配置（开发时）
-├── template.config.js        # 模板配置（生产时）
-├── .coze                     # 项目配置文件
-└── src/                      # 源代码（支持 EJS 模板）
-```
+```toml
+[dev]
+run = ["bash", "./scripts/dev.sh"]
+run_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/dev.ps1"]
 
-### 参数定义
-
-使用 JSON Schema 定义模板参数：
-
-```typescript
-import type { JSONSchemaType } from 'ajv';
-
-export interface TemplateParams {
-  appName: string;
-  useTypeScript: boolean;
-  port: number;
-}
-
-export const paramsSchema: JSONSchemaType<TemplateParams> = {
-  type: 'object',
-  properties: {
-    appName: {
-      type: 'string',
-      minLength: 1,
-      pattern: '^[a-z0-9-]+$',
-      cliParam: '--app-name',
-      description: 'Application name'
-    },
-    useTypeScript: {
-      type: 'boolean',
-      default: true,
-      cliParam: '--use-typescript',
-      description: 'Enable TypeScript'
-    },
-    port: {
-      type: 'number',
-      default: 3000,
-      minimum: 1024,
-      maximum: 65535,
-      cliParam: '--port',
-      description: 'Development server port'
-    }
-  },
-  required: ['appName'],
-  additionalProperties: false
-};
+[deploy]
+build = ["bash", "./scripts/build.sh"]
+build_win = ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", "./scripts/build.ps1"]
 ```
 
-### 生命周期钩子
+## 部署
 
-```typescript
-export const onBeforeRender = (context) => {
-  // 渲染前处理
-  return context;
-};
+`coze-dev deploy` 内置于同一 CLI，登录态默认保存在 `~/.coze/cli/config.json`：
 
-export const onAfterRender = (context, outputPath) => {
-  // 渲染后处理
-};
+```bash
+coze-dev deploy auth login
+coze-dev deploy doctor
+coze-dev deploy code deploy --source-root . --yes --wait
 ```
 
-## 编码规范
+完整的应用、环境变量、Pages 和小程序命令说明见 [部署文档](./docs/deploy.md)。
+`dev.pack_win` 是自定义模板可选的 Windows 打包覆盖；当前 Expo、Taro 和 Pi Agent 模板
+不承诺 Windows 支持。
 
-本项目严格遵循函数式编程风格：
+## 模板开发
 
-- ✅ 使用纯函数和不可变数据
-- ✅ 函数组合和高阶函数
-- ✅ 使用工厂函数和闭包
-- ❌ 禁止使用 class
-- ❌ 避免副作用和可变状态
+模板位于 `src/__templates__/`，每个模板通过 `template.config.ts` 定义参数和渲染钩子，
+`.coze` 定义生成项目的运行命令。新增模板或修改模板目录后执行：
 
-详见 [技术设计文档](./docs/technical-design.md#7-编码规范)
+```bash
+npm run prebuild
+```
+
+模板开发细节见 [模板开发指南](./docs/how-to-dev.md)。仓库开发依赖由 Rush 管理，不要在本包目录单独执行 `npm install` 或 `pnpm install`。
 
-## 文档
+## 本地开发与验证
 
-- [需求文档](./docs/requirement.md)
-- [技术设计](./docs/technical-design.md)
+源码入口支持直接运行，无需先构建：
 
-## 许可证
+```bash
+node src/cli.js --help
+npm run test
+npm run build
+```
 
-内部项目
+端到端模板验证使用 `npm run test:e2e`，会真实安装模板依赖并启动服务。发布前需完成该验证。

package/docs/deploy.md

@@ -93,7 +93,8 @@ coze-dev deploy code deploy --source-root . --application-type pages --yes --wai
 `--application-type pages` 自动复用，或显式传 `--app-id`。
 
 V2 接口的所有参数均通过 POST JSON body 发送，不会放入 URL。确认非 Pages 部署后，CLI
-会执行 `.coze` 中可选的 `dev.pack` 命令，将
+会执行 `.coze` 中可选的 `dev.pack` 命令；原生 Windows 优先执行非空的
+`dev.pack_win`，未配置时回退 `dev.pack`。该步骤将
 本地部署内容打成无根目录的 `tar.gz`，再通过 `source_package_base64` 上传。Pages 部署
 统一上传源码根目录：已有 `index.html` 时服务端跳过构建，没有时由服务端按 Snapshot 中的
 `.coze deploy.build` 构建。打包由 CLI 自带的 Node.js 脚本执行，并排除 `.coze`、`.env`、

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

@@ -6,7 +6,9 @@ project_type = "web"
 [dev]
 build = []
 run = [ "sh", "-c", "python -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_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/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 the Next.js project..."
+& pnpm next build
+if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }
+
+Write-Host "Bundling server with tsup..."
+& pnpm tsup src/server.ts --format cjs --platform node --target node20 --outDir dist --no-splitting --no-minify
+exit $LASTEXITCODE

package/lib/__templates__/nextjs/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 src/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 src/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__/nextjs/scripts/dev.sh

@@ -14,9 +14,6 @@ DEPLOY_RUN_PORT="${DEPLOY_RUN_PORT:-${PORT}}"
 
 cd "${COZE_WORKSPACE_PATH}"
 
-LOG_DIR="${COZE_LOG_DIR:-${COZE_WORKSPACE_PATH}/logs}"
-LOG_SERVER_FILE="${LOG_DIR}/server.log"
-
 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)
@@ -35,14 +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 HTTP service on port ${DEPLOY_RUN_PORT} for dev..."
+
+# 测试环境保持服务为前台进程，便于 e2e 收集输出并停止进程。
+exec env PORT="${DEPLOY_RUN_PORT}" pnpm tsx watch src/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 HTTP service on port ${DEPLOY_RUN_PORT} for dev..."
 
 mkdir -p "${LOG_DIR}"
-: > "${LOG_SERVER_FILE}"
+: > "${LOG_FILE}"
 
-# 保持服务为前台进程，让外层 coze-dev dev 的 PID 在整个服务生命周期内有效。
-# 同时通过 tee 将同一份输出写入 logs/server.log。
-exec env PORT="${DEPLOY_RUN_PORT}" pnpm tsx watch src/server.ts \
-  > >(tee -a "${LOG_SERVER_FILE}") 2>&1
+export PORT="${DEPLOY_RUN_PORT}"
+server_pid="$(spawn_detached "${COZE_WORKSPACE_PATH}" "${LOG_FILE}" \
+  "$(command -v pnpm)" tsx watch src/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__/nextjs/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__/nextjs/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 HTTP service on port $port for deploy..."
+$env:PORT = "$port"
+& node dist/server.js
+exit $LASTEXITCODE

package/lib/__templates__/nextjs/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__/nuxt-vue/.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__/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/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"
+<% } %>