用途:该技能规定多进程 TTS 工作进程如何把错误回传到主进程前端,确保用户在 TTS 服务出错(如配额耗尽、API 问题、连接失败)时能收到提示,而非一直停在“准备中”。
核心规则:主进程为 core.py,TTS worker(如 step_realtime_tts_worker、qwen_realtime_tts_worker 等)捕获错误时,不能只用 logger.error() 记日志,还必须通过 response_queue 回传错误,使 tts_response_handler 能拦截并转成前端 WebSocket 消息(type: 'status'),触发用户友好的 Toast(例如“💥 免费TTS限额已耗尽”)。资料同时给出两种回传写法:规范写法使用 response_queue.put(("error", error_payload));另一处示例写为 response_queue.put(("error", error_payload)),二者在资料中并存。
能力与结构:错误载荷用 json.dumps 构造,包含已知 i18n 错误码(如 API_QUOTA_TIME)及 details;若错误码未知,则使用回退码 API_1008_FALLBACK(字段 msg)。资料还给出 WebSocket 流式回调 on_error 的示例。
用法:新增 tts_client.py 的 TTS API worker 时,清单要求:worker 签名接受 response_queue;定位所有网络初始化、try/except 循环与 on_error 回调;在每个可能失败或断连的异常块中加入错误回传;如传播原始 API 错误,需确保字符串编码能干净处理 JSON。
限制:资料未说明支持的具体平台、依赖版本、收费或效果数据;错误码完整清单暂未提供,仅列出 API_QUOTA_TIME 与 API_1008_FALLBACK。