feat(diagnostic): 阶段 0A 输入链路被动探测与线程归属复现

2026-10-05 01:10:02 +08:00
parent c0eca1d4bd
commit c218c25310
12 changed files with 2417 additions and 11 deletions
@@ -0,0 +1,76 @@
+param(
+    [Parameter(Mandatory = $true)]
+    [ValidateSet('MicrosoftPinyin', 'Sogou')]
+    [string]$ImeName,
+    [switch]$InputLanguageOnly
+)
+
+$ErrorActionPreference = 'Stop'
+$root = Split-Path -Parent $PSScriptRoot
+$msbuild = if ($env:STELLARX_MSBUILD) { $env:STELLARX_MSBUILD } else { 'D:\vs2022\MSBuild\Current\Bin\MSBuild.exe' }
+$project = Join-Path $root 'tests\StellarX.UiFixture.vcxproj'
+$fixture = Join-Path $root 'build\x64\Debug\StellarX.UiFixture.exe'
+if (-not (Test-Path -LiteralPath $msbuild)) { throw "MSBuild not found: $msbuild" }
+
+$pathKeyCount = @(
+    [Environment]::GetEnvironmentVariables([EnvironmentVariableTarget]::Process).Keys |
+        Where-Object { [string]$_ -ieq 'Path' }
+).Count
+if ($pathKeyCount -gt 1) {
+    # Codex 等宿主可能注入同时存在的 PATH/Path；MSBuild 启动 CL 时会因重复键失败。
+    # cmd 的 set 精确删除第一份 PATH 后仍保留 Path，只影响这个构建子进程。
+    $buildCommand = 'set "PATH=" & "' + $msbuild + '" "' + $project +
+        '" /m /t:Build /p:Configuration=Debug /p:Platform=x64 /p:StellarXInputProbe=true /v:minimal'
+    & $env:ComSpec /d /c $buildCommand
+}
+else {
+    & $msbuild $project /m /t:Build /p:Configuration=Debug /p:Platform=x64 /p:StellarXInputProbe=true /v:minimal
+}
+if ($LASTEXITCODE -ne 0) { throw 'Input probe fixture build failed' }
+
+$stamp = Get-Date -Format 'yyyyMMdd-HHmmss-fff'
+$runDir = Join-Path $root "TestResults\InputProbe\manual-$stamp-$ImeName"
+$fixtureDir = Join-Path $runDir 'fixture'
+New-Item -ItemType Directory -Force -Path $runDir | Out-Null
+New-Item -ItemType Directory -Force -Path $fixtureDir | Out-Null
+
+Write-Host "Manual IME probe: $ImeName"
+if ($InputLanguageOnly) {
+    Write-Host 'Input-language-only checklist:'
+    Write-Host '  1. Click the EasyX window so it owns keyboard focus'
+    Write-Host '  2. Use Win+Space to select a different language/keyboard layout, for example English (US)'
+    Write-Host '     Switching only between two Chinese IMEs stays in the same HKL and may not emit request/change'
+    Write-Host '  3. Type A, then use Win+Space to return to the original input method/layout'
+}
+else {
+    Write-Host 'Use only these non-sensitive strings:'
+    Write-Host '  1. zhongwentest -> choose a Chinese candidate and commit'
+    Write-Host '  2. haha -> commit the same Chinese character twice'
+    Write-Host '  3. ceshi -> press Escape before committing'
+    Write-Host '  4. Type a candidate sequence and select it with a number key'
+    Write-Host '  5. Use Win+Space to select a different language/keyboard layout (for example English (US)), then type A'
+}
+Write-Host 'Close the EasyX window when finished. The script will then print a privacy-safe summary.'
+
+$launchCommand = 'set "STELLARX_INPUT_PROBE=1" & set "STELLARX_INPUT_PROBE_DIR=' + $runDir +
+    '" & "' + $fixture + '" input-probe "' + $fixtureDir + '"'
+& $env:ComSpec /d /c $launchCommand
+$exitCode = $LASTEXITCODE
+$summary = & (Join-Path $PSScriptRoot 'analyze-input-probe.ps1') -Path $runDir
+
+# EX_SHOWCONSOLE 下由脚本托管的 EasyX 进程在原生标题栏关闭时，部分控制台宿主会把
+# 正常窗口关闭映射为 STATUS_CONTROL_C_EXIT。必须先验证探测日志完整性和关闭证据，
+# 不能无条件忽略这个非零退出码，否则真实崩溃也可能被误报为成功。
+$controlCExit = -1073741510 # 0xC000013A
+$validNativeClose = $summary.sequenceStrict -and
+    $summary.closeObserved -and
+    $summary.textRawWParamLeaks -eq 0
+$summary | Format-List
+Write-Host "Result directory: $runDir"
+if ($exitCode -ne 0 -and -not ($exitCode -eq $controlCExit -and $validNativeClose)) {
+    throw "Input probe fixture exited with code $exitCode"
+}
+
+if ($exitCode -eq $controlCExit) {
+    Write-Host 'Fixture exit code: 0xC000013A (accepted after validating native-close probe records).'
+}