Collect Windows runtime preflight evidence

Ariver

2026-06-30 913b25529de9fb28fe9d212cc13492430db5a7c6

Collect Windows runtime preflight evidence

 CHANGELOG.md

@@ -16,7 +16,7 @@
### Windows 技术预览

- **新增 Windows 预览构建脚本**：`privatevoice.src/scripts/build-windows-preview.sh` 可生成 Windows x64 预览目录和 zip。
- **内置 Windows 真机 QA 采集脚本**：预览包包含 `QA-WINDOWS-PREVIEW.ps1`，用于启动 App、打开 Notepad 目标文件、提示完成一次听写，并收集日志和目标文本证据。
- **内置 Windows 真机 QA 采集脚本**：预览包包含 `QA-WINDOWS-PREVIEW.ps1`，用于采集 WebView2 / 音频端点预检信息、启动 App、打开 Notepad 目标文件、提示完成一次听写，并收集日志和目标文本证据。
- **新增 Windows QA 证据验证脚本**：`privatevoice.src/scripts/verify-windows-qa-evidence.sh` 可检查返回的 `qa-evidence-*.zip` 是否证明启动、引擎、录音、识别和上屏。
- **预览版只开放 SenseVoice**：Windows build 中其他模型仍可见但置灰禁用，避免用户选择尚未验证的模型导致启动或识别失败。
- **打包 sherpa/onnxruntime 运行时 DLL**：预览包包含 `onnxruntime.dll`、`sherpa-onnx-c-api.dll`、`sherpa-onnx-cxx-api.dll`。

 CODEGRAPH.md

@@ -60,7 +60,7 @@
## Known Gaps

- Windows runtime QA must still be performed on Windows 10/11 hardware.
- Run `QA-WINDOWS-PREVIEW.ps1` from the extracted preview package to collect startup, engine, recording, recognition, paste, and Notepad target text evidence.
- Run `QA-WINDOWS-PREVIEW.ps1` from the extracted preview package to collect WebView2/audio preflight, startup, engine, recording, recognition, paste, and Notepad target text evidence.
- After evidence is returned, run `verify-windows-qa-evidence.sh` and require `WINDOWS_QA_EVIDENCE_PASS` before claiming the goal complete.
- The Windows preview zip is unsigned and not an installer.
- SmartScreen / Defender prompts are expected for local testing.

 privatevoice.src/scripts/QA-WINDOWS-PREVIEW.ps1

@@ -63,6 +63,47 @@
    Add-Result $Results "system info collected" $false $_.Exception.Message
}

Write-Step "Collecting Windows runtime preflight"
try {
    $webview2Entries = @()
    $uninstallRoots = @(
        "HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*",
        "HKLM:\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Uninstall\*",
        "HKCU:\SOFTWARE\Microsoft\Windows\CurrentVersion\Uninstall\*"
    )
    foreach ($root in $uninstallRoots) {
        $webview2Entries += Get-ItemProperty $root -ErrorAction SilentlyContinue |
            Where-Object { $_.DisplayName -match "WebView2" } |
            Select-Object DisplayName, DisplayVersion, Publisher, InstallLocation
    }
    if ($webview2Entries.Count -gt 0) {
        $webview2Entries | Format-List | Out-String | Set-Content -Encoding UTF8 (Join-Path $EvidenceDir "webview2-runtime.txt")
    } else {
        "No WebView2 Runtime entry found in standard uninstall registry paths. App startup logs remain authoritative." |
            Set-Content -Encoding UTF8 (Join-Path $EvidenceDir "webview2-runtime.txt")
    }
    Add-Result $Results "WebView2 registry inventory collected" $true "entries=$($webview2Entries.Count)"
} catch {
    Add-Result $Results "WebView2 registry inventory collected" $false $_.Exception.Message
}

try {
    if (Get-Command Get-PnpDevice -ErrorAction SilentlyContinue) {
        Get-PnpDevice -Class AudioEndpoint -ErrorAction SilentlyContinue |
            Select-Object Status, Class, FriendlyName, InstanceId |
            Format-Table -AutoSize | Out-String |
            Set-Content -Encoding UTF8 (Join-Path $EvidenceDir "audio-endpoints.txt")
    } else {
        Get-CimInstance Win32_SoundDevice -ErrorAction SilentlyContinue |
            Select-Object Status, Name, Manufacturer, DeviceID |
            Format-Table -AutoSize | Out-String |
            Set-Content -Encoding UTF8 (Join-Path $EvidenceDir "audio-endpoints.txt")
    }
    Add-Result $Results "audio endpoint inventory collected" $true
} catch {
    Add-Result $Results "audio endpoint inventory collected" $false $_.Exception.Message
}

if (-not $CollectOnly -and -not $NoLaunch) {
    Write-Step "Launching app"
    if (-not (Test-Path $ExePath)) {

 privatevoice.src/scripts/build-windows-preview.sh

@@ -74,7 +74,7 @@
3. Right-click "QA-WINDOWS-PREVIEW.ps1" and choose "Run with PowerShell".
4. If PowerShell blocks scripts, run this command from the extracted folder:
   powershell -ExecutionPolicy Bypass -File .\\QA-WINDOWS-PREVIEW.ps1
5. Follow the on-screen checklist. It will launch the app, open a Notepad target file, ask you to dictate once, and collect logs plus the saved target text.
5. Follow the on-screen checklist. It will collect WebView2/audio preflight data, launch the app, open a Notepad target file, ask you to dictate once, and collect logs plus the saved target text.
6. You can also run "PrivateVoice Dictation.exe" directly after QA.

Known limitations: