用途：用于诊断和修复 Deepgram 语音转写集成中的常见错误，包括 API 请求失败、WebSocket 连接异常、转写质量不佳和 SDK 调用问题。
主要能力：提供快速诊断的 curl 命令（验证 API Key 与测试 /v1/listen 转写端点）；HTTP 错误对照表（400、401、403、404、408、413、429、500、502、503 的含义与处理方式）；WebSocket 错误处理模式（如静音约 10 秒断开时定时发送 keepAlive()，编码/采样率/声道需与 listen.live() 选项一致，1008 表示密钥无效或缺少实时流权限）；音频质量排查，用 ffprobe 检查格式，用 ffmpeg 预处理（推荐 16000Hz、单声道、16-bit）；SDK 版本差异修复（v5 使用 DeepgramClient，v5 命名空间如 dg.listen.v1.media.transcribeUrl）；对 429 与 5xx 的指数退避重试模式；其他错误如 ECONNRESET、ETIMEDOUT、ERR_INVALID_ARG_TYPE 与浏览器 CORS 的处理建议。
使用方式：需配置 Deepgram API Key、可用 curl、可访问应用日志。先运行诊断命令确认密钥与端点；再按状态码或错误类型查表定位；音频问题先用 ffprobe/ffmpeg 检查与规范化；对可重试错误实现退避；排障时记录 correlation ID、环境、模型、状态类别与脱敏时间。
适用场景：Deepgram 集成排错、转写失败调试、实时与预录转写问题定位。
限制：涉及具体密钥管理、套餐并发上限与状态页信息需以官方为准；文中示例仅作诊断参考，实际参数应结合自身音频与 SDK 版本验证。