diagnostic-issue-resolver

用途：系统化收集症状、自动诊断并针对性修复热键文本转语音的常见问题，覆盖热键无声、读取上次选区、无音频输出、首词缓慢、语速键失效、Kokoro 超时、锁文件永久卡住、MLX 加速变慢、音频重复播放。平台为 macOS（Apple Silicon）。原 Telegram bot 已于 2026-09-24 退役，因此不处理“bot 无响应”。\n\n主要能力：提供已知问题表（症状、可能原因、诊断命令、修复方法），分阶段流程——症状收集（AskUserQuestion）、自动化诊断、根因分析、应用修复、验证。诊断包括检查 /tmp/kokoro-tts.lock 与 /tmp/tts_kokoro.lock 状态、afplay/say 进程、/tmp/kokoro-tts.log 与 /tmp/tts_errors.log、claude-tts-companion 健康接口 http://[::1]:8780/health、本地 Kokoro 环境与 MLX-Audio、热键脚本链接。\n\n必要用法：需可访问脚本日志、~/.local/share/kokoro/、curl 访问 companion 接口。常用命令如 tts_stop.sh 重置播放相关状态；验证可运行：echo "Diagnostic test complete" | pbcopy && ~/.local/bin/tts_read_clipboard_wrapper.sh; echo "exit=$?"；本地引擎健康检查：bash "$(cc-plugin-root tts-tg-sync)/scripts/kokoro-install.sh" --health；调试 Supertonic：DEBUG=1 TTS_ENGINE=supertonic ~/.local/bin/tts_read_clipboard_wrapper.sh。热键应绑定 ~/.local/bin/tts_read_clipboard_wrapper.sh 并授予辅助功能权限。\n\n限制：仅面向 macOS Apple Silicon 与本地 Kokoro/Supertonic 方案；依赖特定路径、日志与 companion 服务；具体版本、收费与平台支持范围暂未提供。若标准诊断无法定位，可强制引擎、检查系统音频，必要时通过 clean-component-removal 与 full-stack-bootstrap 重装。