# Round 3 QA Handoff：Moonshine English 默认模型

状态：待 QA
所属子项目：`02-P-NBL`
Round：Round 3
日期：2026-06-03
工作分支：`codex/round3-moonshine-english`
基线 commit：`f66a79670c444010a59b8513c9f61257ebc7d9b6`

## 1. QA 输入文档

- [`prd.md`](prd.md)
- [`engineering-tasks.md`](engineering-tasks.md)
- [`qa-test-plan.md`](qa-test-plan.md)
- [`dev-checklist-current.md`](dev-checklist-current.md)

## 2. 本轮核心断言

QA 需要验证：

- English effective language 默认 current model 是 `moonshine-en`。
- 中文 effective language 默认 current model 仍是 `sensevoice-zh`。
- English 新用户 onboarding 下载 Moonshine。
- 中文新用户 onboarding 下载/使用 SenseVoice。
- 老中文用户升级不触发 Moonshine 下载。
- Moonshine 缺文件不能被判定为可用。
- Moonshine 下载或初始化失败不破坏 SenseVoice、userdict、history。
- 语言切换后 current model 同步，缺模型时进入 onboarding，已安装时重载引擎。

## 3. Moonshine 模型信息

本轮模型：

```text
model id: moonshine-en
package: sherpa-onnx-moonshine-base-en-int8.tar.bz2
backend: moonshine
provider: cpu
```

下载 URL：

```text
https://github.com/k2-fsa/sherpa-onnx/releases/download/asr-models/sherpa-onnx-moonshine-base-en-int8.tar.bz2
```

Required files：

```text
preprocess.onnx
encode.int8.onnx
uncached_decode.int8.onnx
cached_decode.int8.onnx
tokens.txt
```

## 4. 建议 QA 顺序

1. 自动化/半自动检查：
   - `go test ./... -count=1`
   - `npm run build`
   - `git diff --check`
2. English fresh user：
   - 干净 App Support。
   - effective language=`en`。
   - 验证 onboarding 下载 `moonshine-en`。
   - 验证 engine ready 显示 Moonshine。
3. 中文老用户升级：
   - 使用已有 SenseVoice、userdict、history。
   - 验证不下载 Moonshine。
   - 验证中文识别和 replacement。
4. 语言切换：
   - 中文切 English。
   - English 切中文。
   - 验证 current model 同步和缺模型状态。
5. 故障保护：
   - Moonshine 缺文件。
   - Moonshine 下载失败。
   - SenseVoice 回归。

## 5. 研发自查结论

已通过：

- `npm run build`
- `go test ./... -count=1`
- `git diff --check`

日志位于：

- [`logs/npm-run-build-20260603.log`](logs/npm-run-build-20260603.log)
- [`logs/go-test-all-20260603.log`](logs/go-test-all-20260603.log)
- [`logs/git-diff-check-20260603.log`](logs/git-diff-check-20260603.log)

## 6. QA 注意事项

- 目前尚未做正式 `.dmg` 测试包；这是源码开发自查完成后的 QA handoff。
- 如果 QA 通过，后续按发布规则递增 patch 版本、生成新 build 编号、打 `.dmg`、生成 manifest、验证后打 tag。
- `npm ci` 安装依赖时提示 6 个现有 npm audit 风险，本轮没有自动升级依赖，避免扩大变更面。