用途:管理 Kokoro TTS HTTP 服务器,支持启动、停止与验证。触发词包括 start tts server、kokoro server、tts http、stop tts server。
主要能力:服务在 localhost:8779 提供 OpenAI 兼容接口,包括 GET /health(健康状态 JSON)、GET /v1/models(列出模型)、POST /v1/audio/speech(文本转音频,支持 WAV、MP3、Opus、PCM)。健康检查预期返回 status、provider、model、device 等字段。
使用方式:前台测试启动运行 ~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_server.py。生产环境按 macOS launchd 策略需编译 Swift 启动二进制并创建 ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist,然后执行 launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist;停止用 launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.terryli.kokoro-tts-server.plist。验证可运行 curl -s http://127.0.0.1:8779/health | python3 -m json.tool。
环境变量:KOKORO_SERVER_PORT(默认 8779)、KOKORO_SERVER_HOST(默认 127.0.0.1)、KOKORO_DEFAULT_VOICE(默认 af_heart)、KOKORO_DEFAULT_LANG(默认 en-us)、KOKORO_DEFAULT_SPEED(默认 1.0,范围 0.1–5.0)、KOKORO_PLAY_LOCAL(默认 0,通过 afplay 播放)。
限制与排查:端口占用可用 lsof -i :8779 查找并终止;模型加载失败需先运行 /kokoro-tts:install;首次请求较慢属正常,因触发模型加载。该技能提倡自我更新,但仅针对真实可复现问题修改说明。