# Round 3：Moonshine English 默认模型

状态：v0.1 启动稿
所属子项目：`02-P-NBL`
Round：Round 3
基线版本：`v2.1.20-build20260603.1145`
基线 commit：`f66a79670c444010a59b8513c9f61257ebc7d9b6`
工作分支：`codex/round3-moonshine-english`
日期：2026-06-03

## 1. 本轮目标

Round 3 的目标是让 English 语言版本真正进入英文离线识别路径：

```text
English effective language -> moonshine-en -> sherpa-onnx Moonshine v1 -> English offline recognition
```

中文路径保持不变：

```text
Chinese effective language -> sensevoice-zh -> SenseVoice
```

## 2. 本轮文档

- [`prd.md`](prd.md)：产品需求和验收边界
- [`engineering-tasks.md`](engineering-tasks.md)：研发任务拆解
- [`qa-test-plan.md`](qa-test-plan.md)：QA 测试计划
- [`todo-list.md`](todo-list.md)：本轮执行 Todo

## 3. 关键技术修正

总分期计划里的 Moonshine 文件名和 sherpa 配置字段需要修正。

当前项目使用 `github.com/k2-fsa/sherpa-onnx-go-macos v1.12.24`，该版本的 Moonshine 配置是 v1 四文件：

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

对应 Go 字段：

```go
config.ModelConfig.Moonshine.Preprocessor
config.ModelConfig.Moonshine.Encoder
config.ModelConfig.Moonshine.UncachedDecoder
config.ModelConfig.Moonshine.CachedDecoder
config.ModelConfig.Tokens
```

不要按旧文档里的 `encoder_model.ort` / `decoder_model_merged.ort` / `MergedDecoder` 实现 Round 3。

## 4. 资料依据

- sherpa-onnx Moonshine v1 模型文档：<https://k2-fsa.github.io/sherpa/onnx/moonshine/models.html>
- sherpa-onnx Moonshine Go API 示例入口：<https://k2-fsa.github.io/sherpa/onnx/moonshine/go.html>
- k2-fsa GitHub release asset：<https://github.com/k2-fsa/sherpa-onnx/releases/tag/asr-models>