# Round 2 QA 报告：语言检测与语言版本设置

状态：功能性 QA PASS，可进入下一步交付门禁
日期：2026-06-03
测试人：Codex

## 1. 测试对象

| 项目 | 内容 |
|---|---|
| worktree | `/Users/ar/Projects/VoiceSnap-2.1.1-Round2` |
| branch | `codex/round2-language-settings` |
| 实现基线 commit | `516375d` |
| 最终测试包 commit | 以 `RELEASE_MANIFEST.md` 为准 |
| version | `2.1.20` |
| build | `20260603.1145` |
| 本地 App | `privatevoice.src/build/local/arm64/PrivateVoice Input.app` |
| 本地 DMG | 最终路径以 `RELEASE_MANIFEST.md` 为准 |
| DMG SHA256 | 最终 SHA256 以 `RELEASE_MANIFEST.md` 为准 |

## 2. 自动化与构建结果

| 项目 | 结果 | 证据 |
|---|---|---|
| `npm run build` | PASS | `logs/npm-run-build-20260603.log` |
| `go test ./... -count=1` | PASS | `logs/go-test-all-20260603.log` |
| 本地 App 构建与签名 | PASS | `logs/qa-runtime/build-local-round2-20260603.014931.log` |
| 本地 DMG verify | PASS | `logs/qa-runtime/build-local-round2-20260603.014931.log` |

说明：前端构建仍有既有 Svelte a11y warning，来源为旧组件 `UpdateDialog.svelte`、`ToggleSwitch.svelte`，本轮未新增阻断。

## 3. 真机测试结果

| ID | 场景 | 结果 | 证据 |
|---|---|---|---|
| R2-QA-001 | 老配置升级，无 `LanguageMode` / `LanguageID` | PASS | baseline config 无语言字段；Round 2 App 正常启动 |
| R2-QA-002 | 中文系统 auto | PASS | `config.json` 默认 `LanguageMode=auto`、`LanguageID=zh-CN` |
| R2-QA-003 | English 系统 auto | PASS by automated test | `go test ./...` 覆盖 detector normalize |
| R2-QA-004 | 其他系统语言 auto fallback | PASS by automated test | `go test ./...` 覆盖 fallback 到 English |
| R2-QA-005 | 手动中文 | PASS | `round2-screen-20260603.014931-zh-manual.png`；配置写入 `manual/zh-CN` |
| R2-QA-006 | 手动 English | PASS | `round2-screen-20260603.014931-english6.png`；配置写入 `manual/en` |
| R2-QA-007 | 切回自动 | PASS | `round2-screen-20260603.014931-chinese.png`；配置写入 `auto/zh-CN` |
| R2-QA-008 | 重启持久化 | PASS | 重启后配置仍为 `manual/zh-CN` |
| R2-QA-009 | 非法 LanguageMode fallback | PASS by automated test | `go test ./...` |
| R2-QA-010 | 非法 LanguageID fallback | PASS by automated test | `go test ./...` |
| R2-QA-011 | 语言切换不改模型 | PASS | `SelectedModelID` 始终为 `sensevoice-zh` |
| R2-QA-012 | 已有模型时语言切换不下载模型 | PASS | 真实用户模型 hash 不变；日志未出现因语言切换触发下载 |
| R2-QA-013 | 语言切换不删模型 | PASS | `model.int8.onnx`、`tokens.txt` hash 与 baseline 一致 |
| R2-QA-014 | 词库保留 | PASS | `userdict.json` hash 与 baseline 一致；replacement 数量 149 |
| R2-QA-015 | 历史保留 | PASS | `history.json` hash 与 baseline 一致；entries 数量 1708 |
| R2-QA-016 | 热键保留 | PASS | config 热键字段未丢失；断网真实语音输入已用 `R-Alt` 触发成功 |
| R2-QA-017 | 断网已有模型识别 | PASS | `logs/qa-runtime/offline-voice-final-20260603.014931.log`；断网期间识别并写入 history |
| R2-QA-018 | UI 不暴露新模型 | PASS | 设置页只显示现有 SenseVoice 引擎 |
| R2-QA-019 | English UI 文案 | PASS | `round2-screen-20260603.014931-english6.png` |
| R2-QA-020 | 中文 UI 文案 | PASS | `round2-screen-20260603.014931-zh-manual.png` |

## 4. 数据完整性

测试前已备份真实用户数据：

`/Users/ar/Projects/VoiceSnap-2.1.1-Round2/QA-backups/round2-pre-qa-20260603.014931`

语言切换阶段完成后，以下文件与 baseline SHA256 完全一致：

- `userdict.json`
- `history.json`
- `models/sensevoice/model.int8.onnx`
- `models/sensevoice/tokens.txt`

`config.json` 有预期变化：新增/写入 `LanguageMode`、`LanguageID`、`SelectedModelID`。

断网真实语音输入复测后，`history.json` 出现预期变化：新增一条识别记录。

## 5. 新用户测试

使用临时 HOME 启动本地 App，未挪动真实 App Support：

`logs/qa-runtime/new-user-home-20260603.014931`

结果：

- 新用户默认配置为 `LanguageMode=auto`、`LanguageID=zh-CN`、`SelectedModelID=sensevoice-zh`。
- 干净用户首次启动会自动下载 SenseVoice；下载发生在临时 QA 目录，不影响真实用户模型目录。
- 下载完成后 ASR engine ready。

## 6. 断网启动检查

证据：`logs/qa-runtime/offline-start-check-20260603.014931.log`

结果：

- Wi-Fi 从 On 切到 Off。
- `curl https://www.apple.com` 返回 `Could not resolve host`，确认断网。
- 断网状态下重启本地 App。
- App 使用已有真实 SenseVoice 模型启动，日志显示 `ASR engine ready: SenseVoice · CoreML (Apple Neural Engine)`。
- Wi-Fi 已恢复为 On。

## 7. 断网真实语音输入复测

证据：`logs/qa-runtime/offline-voice-final-20260603.014931.log`

结果：

- Wi-Fi 从 On 切到 Off。
- 断网探测返回 `Could not resolve host: www.apple.com`。
- 用户在断网窗口内按住 `R-Alt` 说测试句。
- 日志显示 2026-06-03 11:40:36 开始录音，2026-06-03 11:40:41 停止录音并完成识别。
- 识别文本：`这是 mac 电脑用 SenseVoice 做离线识别。`
- `history.json` 条目数从 1710 增加到 1711。
- `history.json` 最新条目 `entries[0]` 为：`这是 mac 电脑用 SenseVoice 做离线识别。`
- Wi-Fi 已恢复为 On，并通过联网探测。

## 8. 阻断项

无。

## 9. 当前结论

Round 2 的语言设置、i18n 切换、持久化、新用户默认值、老用户数据保护、模型不破坏、断网启动均通过。

Round 2 功能性 QA PASS。