Edge 智读

⚠️ 强烈建议：请将该动作加入 Quicker 的自动运行中。

本动作采用本地 FastAPI 语音微服务。让该动作随 Quicker 启动后，可提前完成服务启动、HTTP 连接池预热、中英文常用音色预热与流式暖机，明显降低第一次朗读时的等待感，尤其有助于压低英文首帧延迟。

🖱️ 左键极速触发（核心用法）

• 正常朗读：选中文本后点击动作图标即可朗读。首段优先走流式接口，收到首个音频帧后立即播放；后续分段按窗口并发下载，减少断续感。
• 重复朗读加速：同一段文字在当前 Quicker 运行期间再次朗读时，已生成过的相同分段会优先从内存缓存读取；在音色和语速不变的情况下，第二次通常可更快出声。
• 无缝切换：正在朗读时，直接框选新文字再次触发，旧任务会通过令牌隔离停止，新任务重新规划分段并播放。
• 一键静音：播放状态下，不选中文字再次触发动作，即刻停止播放、清空缓冲并终止当前流水线。
• 空选预热：未播放且未选中文字时触发，可静默启动服务并完成基础预热。

⚙️ 右键高级定制（扩展菜单）

• 录制到文件：将选中文本导出为 MP3。录制流程按分段并发生成音频，合并时带重试补偿，减少临时文件占用。
• 设置语速：支持中英文分别设置语速，参数直连 edge-tts 的 rate 接口。
• 选择朗读者：支持自动匹配中英文音色，也可手动指定微软神经网络音色。

⚠️ 故障排查与运行日志

如果按下后毫无反应、启动慢或偶发无声，请先按“更新与重启 → 检测与修复 → 查看日志”的顺序排查：

• 确认版本最新：请先确保 Quicker 已更新到最新版，同时确认本动作“Edge 智读”也是最新版本。旧版动作或旧版后台服务可能缺少最新修复。
• 更新后重启：更新 Quicker 或本动作后，如果仍然无法正常朗读、启动慢或偶发无声，请先完全退出并重新启动 Quicker；如问题依旧，再重启一次电脑，以确保旧的后台服务进程、缓存状态和音频占用被彻底释放。
• 使用检测与修复：右键本动作，优先使用动作内置的“检测与修复”功能。如果检测后仍无法使用，可执行“重置”后重新初始化运行环境。
• 开启调试日志：右键编辑本动作，将变量 tts_debug_log 赋值为 1，保存后重启 Quicker 或重启电脑，然后再次运行本动作，以便记录更完整的排查日志。
• 查看双日志：按 Win + R，输入 %LocalAppData%\QuickerTTS 回车；重点查看 quicker_tts_client.log（Quicker 动作侧日志）和 edge_tts_server.log（本地语音服务侧日志）。
• 系统音量：无报错但无声时，检查 Windows 音量混音器中 Quicker 是否被静音。
• 杀毒拦截：若服务启动失败，请检查 %LocalAppData%\QuickerTTS 下的 python.exe/pythonw.exe 是否被安全软件拦截。
• 网络连通：需要能访问微软 TTS 服务，同时本机 127.0.0.1 环回通信不能被安全软件拦截。
• 依赖异常：若提示 fastapi、uvicorn 或 edge_tts 导入失败，可使用动作内置的检测与修复/重置功能，或删除 %LocalAppData%\QuickerTTS 后重新初始化。