go-sip/docs/TODO.md

# 当前待办

## ASR 对接边界音频转换（本地已实现，待真实验收）

- [x] 内部媒体继续使用单声道 16 kHz PCM16；绑定时读取并校验任务现有 `sample_rate`，不补默认值。
- [x] 在 ASR 发送边界按目标采样率转换实际音频；请求参数原样保留，发送的采样率与音频一致，同采样率时不重采样。
- [x] 缺失、非整数、超出 8–48 kHz 范围或转换后没有完整 PCM16 样本时明确失败；不改写参数、不换率、不换服务商。
- [x] 复用已有 PCM16 转换能力；TDD 覆盖 16→8 kHz ASR、8↔16 kHz 媒体转换、同率直通、分块收发和错误输入。
- [ ] 在获批的隔离 ASR-only 与 full-AI 任务上完成真实 ASR 验证；本地测试不能代替供应商和通话验收。
- [x] Bailian task TTS 在 format 缺省时默认原始 PCM16/16000 Hz，并显式发送到供应商；支持 PCM16 归一化、有效 MP3 解码及 PCM WAV 解码/下混/重采样为内部单声道 16 kHz PCM16。MP3 解码器已换为支持 MPEG 2.5/8 kHz 的 `github.com/hujm2023/go-mp3/v2`；本地含 ID3 的 8 kHz 回归样本通过。解码初始化错误保留底层原因。
- [x] WAV RIFF 声明长度异常时报告 RIFF/data 声明与实收长度。仅在完整 Bailian task 响应带有已观测到的精确流式占位长度、标准 44-byte `fmt `/`data` 头时，按实际收到字节修正长度，再交给严格 WAV 解码器验证；其它长度或头结构仍失败关闭。
- [x] 新 MP3 decoder 已用一次真实 8 kHz MPEG 2.5 Bailian 响应验证，成功解码并归一化为内部单声道 16 kHz PCM16；不代表真实 SIP 通话或完整 AI 链路已验收。
- [x] 修复后以 task 6/revision 1 获批执行一次真实 WAV TTS 验证：RIFF 声明 2,147,483,591 bytes / 实收 19,884 bytes，data 声明 2,147,483,547 bytes / 可用 19,840 bytes；精确占位长度修正通过，实际源采样率 8 kHz，归一化为内部 16 kHz PCM16（39,680 bytes，1,240 ms）。SQLite 任务快照 SHA-256 前后相同；覆盖只在进程内，没有拨号或 OSS 写入；音频未留存。
- [ ] 完成获批 full-AI 任务的真实端到端验收（LLM、SIP 媒体、录音与 OSS）；独立 TTS 格式验证不覆盖整条通话链路。

唯一规则来源是共享合同的 [业务规范](../contracts/schema/saas-dispatcher.md) 与 [任务 Schema](../contracts/schema/http-task-detail.schema.json)，这里仅记录未完成工作，不维护第二份字段定义。

**当前边界：** 修复提交 `9bf20cf` 已推送并安装到固定非生产测试机 `server.sip`；共享合同仍为 `940d922`。Agent、Dispatcher、Asterisk 均 enabled+active；Agent/Dispatcher `--debug` 开启、`--capture` 关闭。最后部署状态显示依赖 `verified`、`business_ready=true`、活动通话 0，制品哈希匹配；未重置数据，`real_reboot_verified=false`，不代表生产签收。部署探针修复后从测试机完成 MQ 登录/关闭、3 trunks、1 provider、6 tasks 的只读预检；原任务列表末页重复请求问题由 `ReadAllTasks` 复用及回归测试修复。MP3 与 WAV 的真实 TTS 格式验证通过，任务快照前后 SHA-256 相同，诊断音频未留存；格式诊断自身未拨号或写 OSS。部署后只核实活动通话为 0，没有进行独立试拨；Dispatcher 已恢复正常 SaaS 任务处理，真实通话/LLM/ASR/录音/OSS 全链路仍未验收。此前 2026-10-12 SIP 配置读取出现 HTTP 502，随后 GET 返回 200；其历史根因仍未知，不代表当前探针失败。管理页面浏览器连接超时，未创建或修改任务；ASR-only 验收仍待单独安排。