# R221-3 QA Evidence

## 结论

- 任务 ID：`R221-3`
- Review Gate ID：`R221-2-GATE-20260703.0335`
- QA 结论：`PASS`
- 时间：`2026-07-03 05:10:25 +0800`
- 范围：验证恢复后的当前源码与 `2.2.2 build 20260703.0335` 候选构建路径。
- 不做范围：不修改源码、不创建 tag、不生成正式发布包、不把本地 QA evidence 当作发布候选。

QA 允许 PMO 解锁 `R221-4` 发布冻结流程。该结论不等于 Windows 正式版通过、不等于 Windows 真机 QA 通过、不等于 Monterey 兼容通过、不等于 notarized 官网正式发布通过。

## 环境

- 项目根：`/Users/ar/Projects/PrivateVoice`
- Git 根：`/Users/ar/Projects/PrivateVoice/03-O`
- 源码根：`/Users/ar/Projects/PrivateVoice/03-O/C1.source/privatevoice.src`
- 分支：`codex/x-asr-experiment-2.1.29`
- HEAD：`abb469859662c285fac758c042812e0da943728f`
- macOS：`26.1 (25B78)`
- Go：`go version go1.26.4 darwin/arm64`
- Node：`v23.11.1`
- npm：`10.9.2`

## 工作区核对

- `git status --short --branch`：当前分支 ahead 1，存在 R221 待审源码 / 文档 diff。
- `git diff --cached --name-status`：无输出，当前无 staged diff。
- `git diff --stat`：43 files changed，包含 R221 恢复源码、版本元数据、前端生命周期清理、Windows preview 脚本、CODEGRAPH / 管理文档等。
- 新增源码文件已在 diff 范围：`cmd/benchmark-recognition/main.go`、`scripts/benchmark-recognition.sh`、`services/diagnostics_service.go`。

## 标准源码门禁

| 项 | 命令 | 结果 | 备注 |
| --- | --- | --- | --- |
| 空白检查 | `git diff --check` | PASS | 无输出 |
| gofmt 状态 | `git diff --name-only -- C1.source/privatevoice.src | grep -E '\.go$' | xargs gofmt -l` | PASS | 无输出，表示当前变更 Go 文件格式干净 |
| Go 测试 | `go test ./...` | PASS with warning | 复现 macOS 链接 warning，未导致测试失败 |
| 前端构建 | `npm --prefix frontend run build` | PASS with warning | 复现既有 Svelte a11y warning：`UpdateDialog.svelte`、`ToggleSwitch.svelte` |

## 核心路径核对

| 路径 | Evidence | 结论 |
| --- | --- | --- |
| 核心语音输入 / 录音 / 识别流水线 | `go test ./...`；`go test ./internal/model ./internal/modelselection ./internal/language ./internal/engine ./internal/audio ./services`；`go test . -run 'TestSlowRecognitionReason|TestRecognize|TestHotkey|TestLiveCaption|TestWaitForHotkeyRelease|TestReload|TestOverlay|TestVersion'` | 自动化层 PASS；未在本机做真实麦克风、全局热键、粘贴上屏手动测试 |
| 设置 / 热键配置 | 前端 build PASS；diff 核对 `GeneralPage.svelte`、`HotkeysPage.svelte` 增加 `onDestroy` 和 `clearHotkeyCapture()` | 代码级生命周期清理路径通过；未做真实窗口交互测试 |
| 语言 / 模型选择 | `go test ./internal/model ./internal/modelselection ./internal/language ./internal/engine ./internal/audio ./services` PASS；`go test ./internal/model -run 'Test.*Yue|Test.*Cantonese|Test.*Language'` PASS | 自动化层覆盖语言 / 模型解析 |
| 粤语 `yue-HK` | `rg` 核对 `CantoneseLanguageID = "yue-HK"`、`SenseVoiceYueModelID = "sensevoice-yue-2025-09-09"`、`LanguageParam: "yue"`；`internal/engine` 测试 PASS | 粤语注册与 SenseVoice `yue` 参数路径通过 |
| 前端生命周期风险 | diff 核对 `App.svelte` 释放 Wails event off hooks 和 `hashchange`；`LanguagePage.svelte` 释放模型下载事件；`PermissionsPage.svelte` 释放 interval / timeout；`SettingsWindow.svelte` 释放 store subscription | 生命周期清理路径通过构建与代码核对；未做长时间打开 / 反复开关窗口的视觉 smoke |

## Windows Preview 适配回归

| 项 | 命令 / 证据 | 结果 |
| --- | --- | --- |
| Windows cross smoke | `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 ./...` | NOT COVERED：本机缺 `x86_64-w64-mingw32-gcc`，命令失败于工具链，不是源码测试失败 |
| 编译器检查 | `command -v x86_64-w64-mingw32-gcc` | 未找到 |
| Windows build 脚本语法 | `bash -n scripts/build-windows-preview.sh` | PASS |
| Windows evidence verifier 语法 | `bash -n scripts/verify-windows-qa-evidence.sh` | PASS |
| 版本 / build | `scripts/build-windows-preview.sh` 内 `APP_VERSION="2.2.2"`、`APP_BUILD="20260703.0335"` | PASS |
| preview 口径 | `README-WINDOWS-PREVIEW.txt` 模板声明 unsigned preview、不是安装器、需 Windows 10/11 QA | PASS |
| evidence 要求 | `verify-windows-qa-evidence.sh` 要求 `qa-results.tsv`、`app.log`、`qa-target-dictation-text.txt`、`system-info.txt`，成功时输出 `WINDOWS_QA_EVIDENCE_PASS` | PASS |

QA 判断：Windows preview 构建路径与 evidence 规则可进入 `R221-4` 发布冻结环节，但发布 / 环境窗口必须补齐 MinGW 工具链并实际生成 / 验证 Windows preview ZIP。不能把 Windows preview 说成正式 Windows 版。

## 版本与构建路径

- `app.go`：`appVersion = "2.2.2"`，`appBuild = "20260703.0335"`。
- `build/config.yml`：`version: "2.2.2"`。
- `build/darwin/Info.plist`：`CFBundleShortVersionString = 2.2.2`，`CFBundleVersion = 20260703.0335`，`LSMinimumSystemVersion = 14.0`。
- `frontend/package.json` / `package-lock.json`：`2.2.2`。
- `scripts/build-windows-preview.sh`：`2.2.2 / 20260703.0335`。
- `CHANGELOG.md`：已有 `v2.2.2 (2026-07-03)`，明确恢复 `2.2.1` 内容但正式候选升为 `2.2.2`。
- `bash -n scripts/build-local-macos.sh`、`bash -n scripts/build-local-macos-universal.sh`、`bash -n scripts/build-release-macos.sh`：PASS。

## macOS Warning / Monterey 判断

`go test ./...` 输出 macOS 链接 warning：

- Go / CLT 临时 object 标记为 macOS 26.0，高于链接目标 macOS 11.0。
- `@rpath/libonnxruntime.1.24.4.dylib` 最低 macOS 14.0。

QA 判断：

- 不阻塞当前主线 `2.2.2`，因为当前 mainline macOS 包口径为 `LSMinimumSystemVersion = 14.0`，且 Go 测试已通过。
- 不得据此声称 Monterey 兼容。若 Owner 需要覆盖 macOS 12 / Monterey，必须单独升级 Monterey QA / 构建任务，至少验证 `build-local-macos-monterey.sh`、对应依赖最低系统和真机安装启动。

## 未覆盖风险

- 未做真实麦克风录音、全局热键、Notepad / 输入框粘贴、overlay 视觉稳定性、菜单栏 / Dock 图标策略的手动 smoke。
- 未做 Windows 10/11 真机 QA，未收回 `WINDOWS_QA_EVIDENCE_PASS` evidence zip。
- 未跑 Windows cross smoke，原因是本机缺 `x86_64-w64-mingw32-gcc`。
- 未做 Monterey 验证。
- 未做 notarization、Developer ID 官网发布链路、下载页 / 授权 / 更新 / 回滚链路验证。

这些风险不阻塞 `R221-4` 进入发布冻结流程，但必须在对应发布 / 平台任务中继续关闭；其中 Windows ZIP 生成必须先补齐 MinGW 工具链。