本地 Coqui TTS 语音服务 | 调用 ./coqui-tts.sh 将文字转为中文语音并播放（免费方案）
npx skills add https://github.com/cagegit/hotel-front-desk-agent --skill coqui-tts-localCopie e cole este comando no Claude Code para instalar a skill
视觉管道：通过摄像头检测来宾、人脸识别、主动问候。在无摄像头环境下此技能可跳过。
语音交互规范：Talk Mode 使用、唤醒词响应、语音合成配置、STT/ TTS 集成。
酒店入住登记：查预订、身份验证、分配房间、发放房卡。触发词：入住、办理入住、check in、我有预订。
酒店退房办理：核查账单、处理结算、回收房卡、友好送别。触发词：退房、结账、check out。
客房服务：响应客房呼叫，识别服务类型，创建工单，通知相关部门。触发词：客房服务、打扫、维修、送餐、投诉。
客户问题处理：查看待处理投诉、分配处理人、标记解决、统计总览。触发词：投诉、问题、反馈、待处理。
| name | coqui-tts-local |
| description | 本地 Coqui TTS 语音服务 | 调用 ./coqui-tts.sh 将文字转为中文语音并播放（免费方案） |
| metadata | {"requires":["bash","curl","afplay"]} |
./skills/coqui-tts/coqui-tts.sh - 可直接调用的 bash 脚本
Coqui TTS 服务必须已启动：
python -m TTS.server --listen 127.0.0.1:8000
验证服务状态：
curl http://127.0.0.1:8000/health
API 工作方式：
/v1/speak{"status": "success"}http://127.0.0.1:8000/v1/speakzh-cn (中文)./skills/coqui-tts/coqui-tts.sh "文字"saysay "文字"在对话中让 agent 自然触发：
Agent 会执行：
./skills/coqui-tts/coqui-tts.sh "你的文字"
流程：
audio_url 字段.wav 文件afplay 自动播放cd /Users/cage/work/hotel_bot_app/hotel-front-desk-agent/agents/front-desk/
./skills/coqui-tts/coqui-tts.sh "测试小瑞的声音"
预期输出：
🎤 Generating speech with Coqui TTS...
✅ Audio file ready: /Users/cage/llm_tools/coqui_tts/output.wav
▶️ Playing audio...
✅ Done!
同时会听到中文播报声。
| 参数 | 说明 | 默认值 |
|---|---|---|
<text> (必填) | 要播报的文字 | - |
--model MODEL_ID | TTS 模型 ID | tts_models/zh-CN/baker/tacotron2-DDC |
--silent | 仅生成文件不播放 | false |
--output FILE | 自定义输出路径 | 临时文件 |
示例：
# 指定其他语言模型
./skills/coqui-tts/coqui-tts.sh --model tts_models/en_US/multi-dataset/jenny-docker "Hello world"
# 只生成不播放
./skills/coqui-tts/coqui-tts.sh --silent "test.wav"
| 问题 | 诊断命令 |
|---|---|
| JSON 不是音频 | file output.wav 确认类型 |
| 连接拒绝 | curl http://127.0.0.1:8000/health |
| 无声 | afplay /path/to/file.wav 测试系统音量 |
| 文件不存在 | 检查 Coqui TTS 配置的输出目录权限 |