[音频 Transport]：完成本机音频抽象与回放测试通道，包含内存 Transport、文件回放、可选 sounddevice 适配和环形缓冲

2026-06-17 18:15:14 +08:00
parent 86ad0c86f2
commit 90ba2bf3b0
4 changed files with 299 additions and 5 deletions
@@ -10,11 +10,11 @@

 ## 2. 音频 Transport

- [ ] 2.1 实现 `AudioTransport` 协议和本机音频错误对象；前置条件：核心模型已提交；验收标准：协议包含输入启动、帧读取、PCM 播放、停止、健康检查；测试要点：协议和错误码可导入；优先级：P0；预计：45 分钟。
- [ ] 2.2 实现内存/文件回放 Transport；前置条件：AudioTransport 协议已定义；验收标准：测试可注入音频帧并捕获播放结果，不依赖真实麦克风；测试要点：回放帧顺序、超时和播放队列通过单元测试；优先级：P0；预计：60 分钟。
- [ ] 2.3 实现可选本机 Transport 适配层；前置条件：Transport 协议已定义；验收标准：未安装音频依赖或无设备时返回结构化错误，不影响测试模式；测试要点：无依赖环境下导入不崩溃；优先级：P1；预计：60 分钟。
- [ ] 2.4 实现音频环形缓冲和格式校验；前置条件：音频模型和 Transport 已定义；验收标准：保留最近音频帧并校验采样率、声道、时间戳；测试要点：缓冲容量、顺序和非法帧测试通过；优先级：P0；预计：60 分钟。
- [ ] 2.5 完成“音频 Transport”模块提交；前置条件：2.1 至 2.4 已完成；验收标准：先通过相关测试、compileall 和 OpenSpec strict 校验，再立即执行 Git commit；测试要点：提交信息使用“`[音频 Transport]：完成[具体功能描述]，包含[关键变更]`”格式；优先级：P0；预计：20 分钟。
+- [x] 2.1 实现 `AudioTransport` 协议和本机音频错误对象；前置条件：核心模型已提交；验收标准：协议包含输入启动、帧读取、PCM 播放、停止、健康检查；测试要点：协议和错误码可导入；优先级：P0；预计：45 分钟。
+- [x] 2.2 实现内存/文件回放 Transport；前置条件：AudioTransport 协议已定义；验收标准：测试可注入音频帧并捕获播放结果，不依赖真实麦克风；测试要点：回放帧顺序、超时和播放队列通过单元测试；优先级：P0；预计：60 分钟。
+- [x] 2.3 实现可选本机 Transport 适配层；前置条件：Transport 协议已定义；验收标准：未安装音频依赖或无设备时返回结构化错误，不影响测试模式；测试要点：无依赖环境下导入不崩溃；优先级：P1；预计：60 分钟。
+- [x] 2.4 实现音频环形缓冲和格式校验；前置条件：音频模型和 Transport 已定义；验收标准：保留最近音频帧并校验采样率、声道、时间戳；测试要点：缓冲容量、顺序和非法帧测试通过；优先级：P0；预计：60 分钟。
+- [x] 2.5 完成“音频 Transport”模块提交；前置条件：2.1 至 2.4 已完成；验收标准：先通过相关测试、compileall 和 OpenSpec strict 校验，再立即执行 Git commit；测试要点：提交信息使用“`[音频 Transport]：完成[具体功能描述]，包含[关键变更]`”格式；优先级：P0；预计：20 分钟。

 ## 3. Wake/VAD/STT