SuperAPI AI 工具集

voice-quality-audition

测试与质量

查看项目

更新于 10-16 00:21

技能介绍

用途:对比 Kokoro TTS 各语音的质量,帮助选出新的默认语音(TTS_VOICE_EN / TTS_VOICE_ZH)。每个语音会先报出自身名称,再朗读一段文本。

主要能力:运行 tts_kokoro_audition.sh 依次播放各语音;文本取自 macOS 剪贴板(pbpaste),为空时使用内置的图书馆阅读段落;提供语音目录,含语音 ID、名称、等级与性别,如 af_heart(Heart,A,女)、af_bella(Bella,A-,女)、af_nicole(Nicole,B-,女)、af_aoede/af_kore/af_sarah(C+,女)、am_adam(F+,男)、am_echo(D,男)、am_michael 与 am_puck(未评级,男)。

使用方式:先执行 kokoro-install.sh --health 做体检(6 项检查须全过:venv、Python 3.14、mlx_audio 可导入、kokoro_common.py、tts_generate.py、version.json);再运行 ~/.local/bin/tts_kokoro_audition.sh 或插件脚本路径。可选择全量试听(10 个语音,耗时数分钟)或只试听部分语音(编辑脚本中的 VOICES 数组或手动传入语音 ID)。脚本会获取 TTS 锁,逐个播放并间隔 1 秒,退出时释放锁。试听后收集偏好,可修改 ~/.claude/automation/claude-telegram-sync/mise.toml 中的 TTS_VOICE_EN/TTS_VOICE_ZH 并重启 Telegram 机器人生效。

要求与限制:仅限 macOS Apple Silicon(需 MLX Metal),需已安装并健康运行的 Kokoro TTS 引擎、afplay(macOS 自带)。常见问题:无声音多为 Kokoro 未安装;音频被截断多为 TTS 锁被抢占(pgrep -la afplay);提示“ERROR: Local Kokoro not found”用 --health 诊断、--install 修复;锁残留可 rm -f /tmp/kokoro-tts.lock;全部语音听起来相同可 kokoro-install.sh --upgrade 重下模型。语音目录与评级的详细标准见其参考文档;官方未提供的内容暂未说明。