fix(auto-test): detailed CDP diagnostics + TCP port probe

- Replace HTTP GET with raw TCP connect for port detection
- Forward Tauri stdout/stderr to console for visibility
- Print WebView2 process args and netstat on timeout
- Set env var on process.env before spawn (Windows inherit)
- Remove detached mode to keep output visible

Author: HelloWorldU

docs/DESIGN.md

@@ -87,7 +87,7 @@
 | bug-fix: 鼓励留痕 | AST `error-handling/missing-logger` (warn) + check-docs-sync（要求 docs/ 变更） | ⚡ 半硬（warn + 分支检查） |
 | new-task: 未验证代码禁止合入 | CI 流水线 + PR 门控 | ✅ 硬约束 |
 | new-task: 审阅通过才能合并 | PR review 机制 | ⚡ 半硬（Mock 模式可跳过） |
-| auto-test: E2E 验证 | Playwright + WebView2 CDP (`WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS` 环境变量启用调试端口) | ✅ 硬约束（UI 改动后必须跑通 smoke test） |
+| auto-test: E2E 验证 | Playwright + WebView2 CDP (`process.env` + TCP 端口探测) | ✅ 硬约束（UI 改动后必须跑通 smoke test） |
 
 ## 关键决策记录
 

scripts/auto-test.ts

@@ -4,20 +4,10 @@
  *
  * 用法:
  *   npx tsx scripts/auto-test.ts
- *
- * 流程:
- *   1. npm run ci（快速验证：typecheck / lint / analyze / check-docs / test / build）
- *   2. 后台启动 Tauri 应用（cargo tauri dev）
- *   3. 等待 WebView2 CDP 端口就绪
- *   4. 运行 Playwright E2E
- *   5. 终止应用进程，输出结果
- *
- * 注意:
- *   - Windows 上需要 PowerShell 执行权限
- *   - Tauri 应用启动约需 15-30 秒（含 Rust 编译）
  */
 
-import { spawn, ChildProcess } from 'child_process'
+import { spawn, ChildProcess, execSync } from 'child_process'
+import { connect } from 'net'
 import { resolve } from 'path'
 
 const ROOT = resolve(__dirname, '..')
@@ -37,46 +27,94 @@ function log(stage: string, message: string) {
 
 function run(cmd: string, args: string[], cwd: string): Promise<void> {
   return new Promise((resolve, reject) => {
-    const child = spawn(cmd, args, {
-      cwd,
-      stdio: 'inherit',
-      shell: true,
-    })
+    const child = spawn(cmd, args, { cwd, stdio: 'inherit', shell: true })
     child.on('close', (code) => {
       if (code === 0) resolve()
       else reject(new Error(`命令退出码: ${code}`))
     })
   })
 }
 
-function spawnDetached(cmd: string, args: string[], cwd: string): ChildProcess {
-  return spawn(cmd, args, {
-    cwd,
-    detached: true,
-    stdio: 'ignore',
-    shell: true,
+/** TCP 层探测端口是否可连 */
+function tcpConnect(port: number, timeout: number): Promise<void> {
+  return new Promise((resolve, reject) => {
+    const socket = connect(port, '127.0.0.1')
+    const timer = setTimeout(() => {
+      socket.destroy()
+      reject(new Error('timeout'))
+    }, timeout)
+    socket.on('connect', () => {
+      clearTimeout(timer)
+      socket.destroy()
+      resolve()
+    })
+    socket.on('error', (err) => {
+      clearTimeout(timer)
+      socket.destroy()
+      reject(err)
+    })
   })
 }
 
+/** 检查 WebView2 进程是否带 CDP 参数 */
+function diagnoseWebView2(): string {
+  try {
+    const out = execSync(
+      'wmic process where "name like \'%msedgewebview2%\'" get CommandLine /format:csv 2>nul',
+      { encoding: 'utf-8', shell: 'cmd.exe' }
+    )
+    return out || '(无 WebView2 进程)'
+  } catch (e) {
+    return `诊断失败: ${e instanceof Error ? e.message : String(e)}`
+  }
+}
+
+/** 检查端口监听状态 */
+function diagnosePort(port: number): string {
+  try {
+    const out = execSync(`netstat -an | findstr "${port}"`, { encoding: 'utf-8', shell: 'cmd.exe' })
+    return out || '(端口未监听)'
+  } catch {
+    return '(端口未监听)'
+  }
+}
+
 async function waitForCdp(port: number, timeoutMs: number): Promise<void> {
   const deadline = Date.now() + timeoutMs
-  const http = await import('http')
+  let lastErr = ''
+  let checkCount = 0
+
   while (Date.now() < deadline) {
+    checkCount++
     try {
-      await new Promise<void>((resolve, reject) => {
-        const req = http.get(`http://localhost:${port}/json`, (res) => {
-          if (res.statusCode === 200) resolve()
-          else reject(new Error(`status ${res.statusCode}`))
-        })
-        req.on('error', reject)
-        req.setTimeout(1000, () => reject(new Error('timeout')))
-      })
+      await tcpConnect(port, 2000)
+      log('CDP', `端口 ${port} TCP 可连（尝试 ${checkCount} 次）`)
       return
-    } catch {
-      await new Promise((r) => setTimeout(r, 1000))
+    } catch (e) {
+      lastErr = e instanceof Error ? e.message : String(e)
+    }
+
+    // 每 5 秒打印一次诊断
+    if (checkCount % 5 === 0) {
+      log('CDP', `仍在等待端口 ${port}... (${Math.round((Date.now() - (deadline - timeoutMs)) / 1000)}s)`)
+      log('DIAG', '端口状态: ' + diagnosePort(port).trim().replace(/\n/g, ', '))
     }
+
+    await new Promise((r) => setTimeout(r, 1000))
   }
-  throw new Error(`CDP 端口 ${port} 在 ${timeoutMs}ms 内未就绪`)
+
+  // 最终诊断
+  log('DIAG', '=== 最终诊断 ===')
+  log('DIAG', '端口状态: ' + diagnosePort(port).trim().replace(/\n/g, ', '))
+  log('DIAG', 'WebView2 进程: ' + diagnoseWebView2().trim().replace(/\n/g, ', ').slice(0, 500))
+
+  throw new Error(
+    `CDP 端口 ${port} 在 ${timeoutMs}ms 内未就绪。` +
+    `最后错误: ${lastErr}。` +
+    `可能原因: (1) WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS 未生效 ` +
+    `(2) WebView2 运行时版本过旧 ` +
+    `(3) 端口被占用`
+  )
 }
 
 async function main() {
@@ -89,21 +127,20 @@ async function main() {
     await run('npm', ['run', 'ci'], SWARM)
     log('CI', `${COLORS.green}通过${COLORS.reset}`)
 
-    // 2. 启动 Tauri 应用
-    log('TAURI', '后台启动 Tauri 应用...')
-    // Windows: WebView2 CDP port must be set via env var, not additionalBrowserArgs
+    // 2. 启动 Tauri 应用（不 detached，保留输出用于调试）
+    log('TAURI', '启动 Tauri 应用...')
+    process.env.WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS = '--remote-debugging-port=9222'
     tauriProcess = spawn('npx', ['tauri', 'dev'], {
       cwd: SWARM,
-      detached: true,
-      stdio: 'ignore',
+      stdio: 'pipe',
       shell: true,
-      env: {
-        ...process.env,
-        WEBVIEW2_ADDITIONAL_BROWSER_ARGUMENTS: '--remote-debugging-port=9222',
-      },
     })
     log('TAURI', `PID: ${tauriProcess.pid}`)
 
+    // 把 stdout/stderr 转发出来，方便看启动进度
+    tauriProcess.stdout?.on('data', (d) => process.stdout.write(d))
+    tauriProcess.stderr?.on('data', (d) => process.stderr.write(d))
+
     // 3. 等待 CDP 就绪
     log('CDP', '等待 WebView2 调试端口 (9222)...')
     await waitForCdp(9222, 60000)
@@ -121,10 +158,13 @@ async function main() {
     if (tauriProcess && tauriProcess.pid) {
       log('CLEANUP', `终止 Tauri 进程 ${tauriProcess.pid}...`)
       try {
-        process.kill(-tauriProcess.pid, 'SIGTERM')
+        spawn('taskkill', ['/PID', String(tauriProcess.pid), '/T', '/F'], {
+          shell: true,
+          stdio: 'ignore',
+          detached: true,
+        })
       } catch {
-        // Windows 上 process group kill 可能失败，尝试 taskkill
-        spawn('taskkill', ['/PID', String(tauriProcess.pid), '/T', '/F'], { shell: true })
+        // ignore
       }
     }
   }