[Feature]STT：ffmpeg 未安装时降级处理

[lingyun14beta]

Description / 描述

ffmpeg 未安装时，AstrBot 会打印警告但仍将原始 amr 文件直接送给 STT API，导致 API 返回 400 Bad Request（不支持 amr 格式）。建议在 ffmpeg 转码失败时直接终止 STT 流程，不再继续调用 API。

Use Case / 使用场景

用户在 QQ 群发送语音消息，bot 配置了 STT 但服务器未安装 ffmpeg。目前日志会出现api的 400 报错，但ffmpeg只有黄色错误。

Willing to Submit PR? / 是否愿意提交PR？

• Yes, I am willing to submit a PR. / 是的，我愿意提交 PR。

Code of Conduct

• I have read and agree to abide by the project's Code of Conduct. /

[dosubot]

感谢提出这个问题。我查看了相关代码，确认了你描述的行为：

问题根因： 在 PreProcessStage 中，音频转换失败（包括 ffmpeg 未安装）时，异常被捕获并仅记录为 warning，但原始未转换的音频文件仍然保留在 message chain 中 [1]。随后 STT 流程继续执行，将这个原始 amr 文件发送给 API，导致 400 错误。

except Exception as e:
    logger.warning(f"Voice processing failed: {e}")
    # 但 pipeline 继续，原始 Record 组件未被移除

建议的修复方向：

1. 在 PreProcessStage 的音频转换失败时，标记该 Record 组件为"不可转写"，跳过后续 STT 调用
2. 或者在 STT provider 层（如 OpenAI Whisper provider）检测到不支持的格式时提前终止，而不是直接发送给 API [2]

值得注意的是，QQ 的 SILK 格式语音实际上有单独的 pysilk 处理路径，不依赖 ffmpeg [3]。如果你遇到的是 amr 格式，说明音频可能来自特定场景下未走 SILK 路径的情况。

这个改动逻辑上比较简单——在转换失败时将对应的 Record 组件从待处理列表中移除或跳过即可。

To reply, just mention @dosu.

---

Share context across your team and agents. Try Dosu.