From ac31349b32d89b2798cd20224fcdede91d6bfe05 Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Tue, 30 Jun 2026 03:30:51 +0800
Subject: [PATCH] Capture Windows QA target text
---
privatevoice.src/scripts/QA-WINDOWS-PREVIEW.ps1 | 33 +++++++++++++++++++++++++++++----
privatevoice.src/scripts/build-windows-preview.sh | 4 ++--
CHANGELOG.md | 2 +-
CODEGRAPH.md | 2 +-
4 files changed, 33 insertions(+), 8 deletions(-)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index fc88668..1fd7ae3 100755
--- a/CHANGELOG.md
+++ b/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、提示完成一次听写，并收集日志证据。
+- **内置 Windows 真机 QA 采集脚本**：预览包包含 `QA-WINDOWS-PREVIEW.ps1`，用于启动 App、打开 Notepad 目标文件、提示完成一次听写，并收集日志和目标文本证据。
- **预览版只开放 SenseVoice**：Windows build 中其他模型仍可见但置灰禁用，避免用户选择尚未验证的模型导致启动或识别失败。
- **打包 sherpa/onnxruntime 运行时 DLL**：预览包包含 `onnxruntime.dll`、`sherpa-onnx-c-api.dll`、`sherpa-onnx-cxx-api.dll`。
- **交付边界**：该产物是 Windows 技术预览，不是已签名安装器，也未完成 Windows 10/11 真机 QA。
diff --git a/CODEGRAPH.md b/CODEGRAPH.md
index f30d7da..2bbef54 100644
--- a/CODEGRAPH.md
+++ b/CODEGRAPH.md
@@ -58,6 +58,6 @@
## 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, and paste evidence.
+- Run `QA-WINDOWS-PREVIEW.ps1` from the extracted preview package to collect startup, engine, recording, recognition, paste, and Notepad target text evidence.
- The Windows preview zip is unsigned and not an installer.
- SmartScreen / Defender prompts are expected for local testing.
diff --git a/privatevoice.src/scripts/QA-WINDOWS-PREVIEW.ps1 b/privatevoice.src/scripts/QA-WINDOWS-PREVIEW.ps1
index cf43713..b9c1581 100644
--- a/privatevoice.src/scripts/QA-WINDOWS-PREVIEW.ps1
+++ b/privatevoice.src/scripts/QA-WINDOWS-PREVIEW.ps1
@@ -38,6 +38,7 @@
$LogPath = Join-Path $AppDataDir "app.log"
$Timestamp = Get-Date -Format "yyyyMMdd-HHmmss"
$EvidenceDir = Join-Path $PackageDir "qa-evidence-$Timestamp"
+$TargetPath = Join-Path $EvidenceDir "qa-target.txt"
$Results = [System.Collections.Generic.List[string]]::new()
New-Item -ItemType Directory -Path $EvidenceDir -Force | Out-Null
@@ -84,12 +85,36 @@
if (-not $CollectOnly) {
Write-Step "Manual runtime check"
+ @(
+ "PrivateVoice Windows Preview QA Target",
+ "Click after the marker below, dictate one short Chinese sentence, then press Ctrl+S in Notepad.",
+ "DICTATION_RESULT:"
+ ) | Set-Content -Encoding UTF8 $TargetPath
+ try {
+ Start-Process -FilePath "notepad.exe" -ArgumentList "`"$TargetPath`"" | Out-Null
+ Add-Result $Results "Notepad target launched" $true $TargetPath
+ } catch {
+ Add-Result $Results "Notepad target launched" $false $_.Exception.Message
+ }
Write-Host "1. Keep this PowerShell window open." -ForegroundColor White
Write-Host "2. In PrivateVoice, make sure the SenseVoice model is installed and the engine is ready." -ForegroundColor White
- Write-Host "3. Open Notepad or a browser text field." -ForegroundColor White
- Write-Host "4. Use the configured hotkey and speak: 这是 Windows 预览版测试。" -ForegroundColor White
- Write-Host "5. Confirm whether the text appears in the target input field." -ForegroundColor White
- Read-Host "Press Enter after you complete one dictation attempt"
+ Write-Host "3. Use the Notepad window opened by this script as the target input field." -ForegroundColor White
+ Write-Host "4. Click after DICTATION_RESULT:, use the configured hotkey, and speak one short Chinese sentence." -ForegroundColor White
+ Write-Host "5. Confirm the recognized text appears in Notepad, press Ctrl+S in Notepad, then return here." -ForegroundColor White
+ Read-Host "Press Enter after you save the Notepad target file"
+}
+
+if (Test-Path $TargetPath) {
+ Copy-Item $TargetPath (Join-Path $EvidenceDir "qa-target-captured.txt") -Force
+ $targetText = Get-Content $TargetPath -Raw -ErrorAction SilentlyContinue
+ $marker = "DICTATION_RESULT:"
+ $markerIndex = $targetText.IndexOf($marker)
+ $dictationText = ""
+ if ($markerIndex -ge 0) {
+ $dictationText = $targetText.Substring($markerIndex + $marker.Length).Trim()
+ }
+ $dictationText | Set-Content -Encoding UTF8 (Join-Path $EvidenceDir "qa-target-dictation-text.txt")
+ Add-Result $Results "target file saved with dictation text" ($dictationText.Length -gt 0) "chars=$($dictationText.Length)"
}
Write-Step "Collecting logs"
diff --git a/privatevoice.src/scripts/build-windows-preview.sh b/privatevoice.src/scripts/build-windows-preview.sh
index 467fad8..4549ac9 100755
--- a/privatevoice.src/scripts/build-windows-preview.sh
+++ b/privatevoice.src/scripts/build-windows-preview.sh
@@ -74,14 +74,14 @@
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, ask you to dictate once, and collect logs.
+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.
6. You can also run "PrivateVoice Dictation.exe" directly after QA.
Known limitations:
- This is not a signed Windows installer.
- Real Windows audio, hotkey, paste, tray, and WebView2 behavior still need QA on Windows 10/11.
- If Windows Defender or SmartScreen blocks it, allow it only for local testing.
-- The QA evidence zip may contain app logs with recognized text. Review before sharing if needed.
+- The QA evidence zip may contain app logs and the saved Notepad target text. Review before sharing if needed.
EOF
(cd "$OUT_ROOT" && zip -qr "$(basename "$ZIP_PATH")" "$(basename "$OUT_DIR")")
--
Gitblit v1.9.3