| | |
|---|
| | | ## Project |
|---|
| | | |
|---|
| | | - Product: Wails v3 / Go desktop dictation app. |
|---|
| | | - Current branch purpose: Windows technical preview based on `v2.1.38-build20260629.2014-diagnostic`. |
|---|
| | | - Current branch purpose: cross-platform local package handoff based on `v2.1.40-build20260702.0143`. |
|---|
| | | - Protected macOS behavior: existing macOS App Store / local DMG build lines are not changed by this branch. |
|---|
| | | |
|---|
| | | ## Core Entrypoints |
|---|
| | |
|---|
| | | - Windows preview supports `SenseVoice` only. |
|---|
| | | - Non-SenseVoice models remain visible in settings but are disabled through `model.IsModelSupportedInCurrentBuild`. |
|---|
| | | - Windows unsupported reason: `windows_preview_unsupported`. |
|---|
| | | - Windows overlay remains native Win32/GDI+, with a larger translucent spectrum-style capsule indicator for recording states. |
|---|
| | | - Build script: `privatevoice.src/scripts/build-windows-preview.sh`. |
|---|
| | | - Evidence verifier: `privatevoice.src/scripts/verify-windows-qa-evidence.sh`. |
|---|
| | | - Runtime package includes: |
|---|
| | |
|---|
| | | - `onnxruntime.dll` |
|---|
| | | - `sherpa-onnx-c-api.dll` |
|---|
| | | - `sherpa-onnx-cxx-api.dll` |
|---|
| | | - `RUN-WINDOWS-QA.cmd` |
|---|
| | | - `QA-WINDOWS-PREVIEW.ps1` |
|---|
| | | - `README-WINDOWS-PREVIEW.txt` |
|---|
| | | |
|---|
| | | ## macOS Local Package Scope |
|---|
| | | |
|---|
| | | - Local DMG script: `privatevoice.src/scripts/build-local-macos.sh`. |
|---|
| | | - Universal DMG script: `privatevoice.src/scripts/build-local-macos-universal.sh`. |
|---|
| | | - Local macOS package set for this branch: |
|---|
| | | - `arm64` DMG for Apple Silicon. |
|---|
| | | - `x86_64` DMG for Intel Mac. |
|---|
| | | - `universal` DMG for Intel + Apple Silicon. |
|---|
| | | - Mainline macOS local packages keep `LSMinimumSystemVersion=14.0` and the default Qwen3-capable dependency line. |
|---|
| | | - Monterey-compatible packages remain a separate build line through `privatevoice.src/scripts/build-local-macos-monterey.sh`. |
|---|
| | | |
|---|
| | | ## Standard Verification Commands |
|---|
| | | |
|---|
| | |
|---|
| | | go test ./... |
|---|
| | | GOOS=windows GOARCH=amd64 CGO_ENABLED=1 CC=x86_64-w64-mingw32-gcc CXX=x86_64-w64-mingw32-g++ go test -exec=/usr/bin/true ./... |
|---|
| | | ./scripts/build-windows-preview.sh |
|---|
| | | ./scripts/build-local-macos.sh arm64 |
|---|
| | | ./scripts/build-local-macos.sh x86_64 |
|---|
| | | ./scripts/build-local-macos-universal.sh |
|---|
| | | ./scripts/verify-windows-qa-evidence.sh /path/to/qa-evidence-YYYYMMDD-HHMMSS.zip |
|---|
| | | ``` |
|---|
| | | |
|---|
| | | ## 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 WebView2/audio preflight, startup, engine, recording, recognition, paste, and Notepad target text evidence. |
|---|
| | | - Run `RUN-WINDOWS-QA.cmd` 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. |
|---|
