From b00e64de94d7560484c8da9723761084e368ca56 Mon Sep 17 00:00:00 2001
From: Ariver <shanghai3168@gmail.com>
Date: Wed, 01 Jul 2026 23:29:06 +0800
Subject: [PATCH] Record project documentation updates

---
 privatevoice.src/scripts/build-windows-preview.sh |   11 ++++++++---
 1 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/privatevoice.src/scripts/build-windows-preview.sh b/privatevoice.src/scripts/build-windows-preview.sh
index b12d503..680afe1 100755
--- a/privatevoice.src/scripts/build-windows-preview.sh
+++ b/privatevoice.src/scripts/build-windows-preview.sh
@@ -55,6 +55,8 @@
 cp "$SHERPA_DLL_DIR/onnxruntime.dll" "$OUT_DIR/"
 cp "$SHERPA_DLL_DIR/sherpa-onnx-c-api.dll" "$OUT_DIR/"
 cp "$SHERPA_DLL_DIR/sherpa-onnx-cxx-api.dll" "$OUT_DIR/"
+cp "$ROOT_DIR/scripts/QA-WINDOWS-PREVIEW.ps1" "$OUT_DIR/"
+cp "$ROOT_DIR/scripts/RUN-WINDOWS-QA.cmd" "$OUT_DIR/"
 
 cat >"$OUT_DIR/README-WINDOWS-PREVIEW.txt" <<EOF
 PrivateVoice Dictation Windows Preview
@@ -70,14 +72,17 @@
 How to run:
 1. Extract the whole folder.
 2. Keep the EXE and DLL files in the same directory.
-3. Run "PrivateVoice Dictation.exe".
-4. Download/install the SenseVoice model if prompted.
-5. Use the configured hotkey and verify text input in Notepad or a browser text field.
+3. Double-click "RUN-WINDOWS-QA.cmd".
+4. If Windows blocks the command file, right-click "QA-WINDOWS-PREVIEW.ps1" and choose "Run with PowerShell", or run this command from the extracted folder:
+   powershell -ExecutionPolicy Bypass -File .\\QA-WINDOWS-PREVIEW.ps1
+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:
 - 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 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