feat(scripts): 默认单终端启动并保留多窗口选项

将 start.ps1 默认改为单终端模式，后端后台启动并在前端退出后自动回收，降低本地启动时多窗口干扰；同时提供 -MultiWindow 参数兼容原双窗口习惯，并在更新日志中记录行为变更与回归关注点。

Made-with: Cursor

Author: jeja2023

CHANGELOG.md

@@ -2,6 +2,17 @@
 
 所有重要变更记录在此文件中。
 
+## [0.0.6] - 2026-04-18
+
+### 变更
+- 启动脚本 `start.ps1` 调整为默认单终端模式：后端改为后台进程启动、前端在当前终端前台运行；结束前端后会自动回收后端进程。
+- 增加 `-MultiWindow` 参数用于按需恢复双窗口启动（后端窗口 + 前端窗口），兼容多终端日志分离场景。
+- 单终端模式新增运行日志落盘：后端标准输出/错误分别写入 `.run/backend.out.log` 与 `.run/backend.err.log`，便于排查启动异常。
+
+### 影响范围与回归关注点
+- 本地启动默认行为发生变化：执行 `.\start.ps1` 不再弹出两个 PowerShell 窗口；如需旧行为请使用 `.\start.ps1 -MultiWindow`。
+- 建议回归验证：`Ctrl+C` 结束前端后，确认后端进程被自动停止；后端启动失败时确认日志文件可用于定位问题。
+
 ## [0.0.5] - 2026-04-18
 
 ### 变更

start.ps1

@@ -1,6 +1,7 @@
 param(
     [switch]$SkipInstall,
-    [switch]$VerboseCheck
+    [switch]$VerboseCheck,
+    [switch]$MultiWindow
 )
 
 $ErrorActionPreference = "Stop"
@@ -82,15 +83,59 @@ function Stop-BackendProcessOnPort([int]$Port) {
 
 Stop-BackendProcessOnPort -Port 5000
 
-Write-Host "Starting backend window..." -ForegroundColor Green
-Write-Check "backend command: dotnet run --project $backendProject"
-Start-Process -FilePath "powershell.exe" -WorkingDirectory $repoRoot -ArgumentList "-NoExit", "-Command", "dotnet run --project '$backendProject'" | Out-Null
+if (-not $MultiWindow) {
+    Write-Host "Starting backend in current terminal mode..." -ForegroundColor Green
+    Write-Check "backend command: dotnet run --project $backendProject"
 
-Write-Host "Starting frontend window..." -ForegroundColor Green
-Write-Check "frontend command: npm run -w platform-admin dev"
-Start-Process -FilePath "powershell.exe" -WorkingDirectory $frontendDir -ArgumentList "-NoExit", "-Command", "npm run -w platform-admin dev" | Out-Null
+    $runDir = Join-Path $repoRoot ".run"
+    if (-not (Test-Path -LiteralPath $runDir)) {
+        New-Item -ItemType Directory -Path $runDir | Out-Null
+    }
+
+    $backendStdOut = Join-Path $runDir "backend.out.log"
+    $backendStdErr = Join-Path $runDir "backend.err.log"
+
+    $backendProc = Start-Process -FilePath "dotnet" `
+        -WorkingDirectory $repoRoot `
+        -ArgumentList @("run", "--project", $backendProject) `
+        -RedirectStandardOutput $backendStdOut `
+        -RedirectStandardError $backendStdErr `
+        -PassThru
+
+    Start-Sleep -Seconds 2
+    if ($backendProc.HasExited) {
+        throw "Backend failed to start. Check logs: $backendStdOut / $backendStdErr"
+    }
+
+    Write-Host "Backend started (PID: $($backendProc.Id)). Logs: $backendStdOut" -ForegroundColor DarkGray
+    Write-Host "Starting frontend in current terminal..." -ForegroundColor Green
+    Write-Check "frontend command: npm run -w platform-admin dev"
+
+    try {
+        Set-Location -LiteralPath $frontendDir
+        npm run -w platform-admin dev
+    }
+    finally {
+        Set-Location -LiteralPath $repoRoot
+        if (-not $backendProc.HasExited) {
+            Write-Host "Stopping backend process (PID: $($backendProc.Id))..." -ForegroundColor Yellow
+            Stop-Process -Id $backendProc.Id -Force
+        }
+    }
+}
+else {
+    Write-Host "Starting backend window..." -ForegroundColor Green
+    Write-Check "backend command: dotnet run --project $backendProject"
+    Start-Process -FilePath "powershell.exe" -WorkingDirectory $repoRoot -ArgumentList "-NoExit", "-Command", "dotnet run --project '$backendProject'" | Out-Null
+
+    Write-Host "Starting frontend window..." -ForegroundColor Green
+    Write-Check "frontend command: npm run -w platform-admin dev"
+    Start-Process -FilePath "powershell.exe" -WorkingDirectory $frontendDir -ArgumentList "-NoExit", "-Command", "npm run -w platform-admin dev" | Out-Null
+
+    Write-Host "Started backend + frontend." -ForegroundColor Green
+}
 
-Write-Host "Started backend + frontend." -ForegroundColor Green
 Write-Host "Fast mode: & .\start.ps1 -SkipInstall" -ForegroundColor DarkGray
+Write-Host "Multi-window mode: & .\start.ps1 -MultiWindow" -ForegroundColor DarkGray
 Write-Host "Frontend dev (no module sync): cd frontend; npm run dev:fast" -ForegroundColor DarkGray
 Write-Host "Debug mode: & .\start.ps1 -VerboseCheck" -ForegroundColor DarkGray