---
name: tts-voice
description: 文字轉語音（LuxTTS Voice Cloning）。將文字合成為 48kHz 高品質語音，支援語音克隆。
triggers:
  - "文字轉語音"
  - "tts"
  - "語音合成"
  - "唸出來"
  - "說出來"
  - "轉語音"
  - "voice"
tools:
  - exec
---

# tts-voice Skill

## 功能說明

透過本機 LuxTTS 服務（port 7860）將文字合成為語音。支援：

- 預設參考音訊快速合成
- 自訂語速（speed）、步數（steps）、溫度（t_shift）

## 觸發範例

```
使用者：「tts 你好，歡迎來到我的頻道」
→ 使用預設參考音訊合成語音，回傳 wav 檔

使用者：「文字轉語音 Hello world」
→ 合成英文語音

使用者：「語音合成 慢速 這是一段測試」
→ speed=0.8 慢速合成

使用者：「唸出來 快速 今天天氣真好」
→ speed=1.3 快速合成
```

## 參數

| 修飾詞 | 效果 |
|--------|------|
| 慢速 / slow | speed=0.8 |
| 快速 / fast | speed=1.3 |
| 高品質 / hq | num_steps=6, t_shift=0.95 |
| （無修飾）| speed=1.0, num_steps=4, t_shift=0.9 |

## 技術細節

- 服務：LuxTTS（FastAPI，port 7860，systemd user service）
- 認證：session cookie（自動取得）
- 參考音訊：`~/LuxTTS/ref_speech.wav`
- 輸出：48kHz wav（存放 `/tmp/tts_output_*.wav`）
- CPU 模式合成約 15-20 秒
