# Round 4 代码复审记录：Parakeet English 高级模型

状态：未发现研发自测阻断问题，待 QA 真机验证
日期：2026-06-03

## 1. 复审结论

本轮代码满足 Round 4 PRD 的研发交付边界，可以进入 QA。

## 2. 已重点复核

- English 默认模型保持为 `moonshine-en`。
- `parakeet-en` 只挂在 English 的 `UpgradeModelIDs` 下。
- 中文语言 profile 未加入 Parakeet。
- 模型选择 API 会校验目标模型是否属于当前语言。
- 手动选择 Parakeet 后，如果当前有效语言变为中文，resolver 会回落到中文默认 SenseVoice。
- 未安装模型不能直接选择。
- Parakeet 下载失败不会写入 `SelectedModelID`。
- Parakeet required files 缺失时不会被判定为可用模型。
- Nemo transducer config 设置了 encoder、decoder、joiner、tokens、model type。

## 3. 残余风险

- Parakeet 的真实 sherpa-onnx 初始化必须依赖真机下载后的模型文件验证，单元测试只能验证 config wiring。
- 已安装但文件内容损坏的 Parakeet 仍可能在引擎初始化阶段失败；当前行为是显示引擎错误，QA 需要确认用户可以切回 Moonshine。
- Parakeet 约 478 MiB 下载包，首次下载耗时和失败恢复需要真实网络测试。

## 4. 代码范围

- `privatevoice.src/internal/model/*`
- `privatevoice.src/internal/modelselection/*`
- `privatevoice.src/internal/engine/*`
- `privatevoice.src/services/engine_service.go`
- `privatevoice.src/services/config_service.go`
- `privatevoice.src/frontend/src/components/settings/GeneralPage.svelte`
- `privatevoice.src/frontend/src/lib/i18n/en.json`
- `privatevoice.src/frontend/src/lib/i18n/zh.json`

## 5. QA 预检发现与处理

- 发现：Parakeet 下载过程中如果 App 中途退出，`.downloads/parakeet-en` 会保留大体积 partial。
- 处理：`DownloadProfile` 现在会在同模型新下载开始前清理旧 partial。
- 发现：Parakeet 下载时设置页 Engine 显示 Loading，但实际 Moonshine 仍可用。
- 处理：前端只在已安装模型切换或下载完成后进入 Loading，下载过程中保留当前引擎状态。