粤声文转语音

解决什么问题

很多项目需要粤语语音，但直接把普通话文本丢给 TTS，往往得到「书面粤语」或普通话腔：词汇是北方口语，语气词缺失，否定、完成、进行体也不对。cantonese-tts 的价值在于先把文本做一次粤语口语化改写，再按语气和发音人参数合成 MP3，适合做对话原型、短文案配音、粤语界面播报和内容本地化验证。

核心能力与步骤

• 文本粤语化：按词表把 漂亮 换成 靓、东西 换成 嘢、没有 换成 冇、为什么 换成 点解；补充 啦/嘅/咩/喎/㗎 等语气词，并调整语法，如否定用 唔 + V，完成用 V + 咗，进行用 喺 + V + 紧，先 常放句末。
• 选择语气：默认 normal，Rate +18%、Pitch +8Hz；slow 适合平静或悲伤，fast 适合开心兴奋，angry 适合不耐烦或生气，通过 Rate 和 Pitch 拉开节奏。
• 可选发音人：使用 --voice 指定 hiuMaan（胡曼，默认女声）、hiuGaai（曉佳，女声）或 wanLung（雲龍，男声）。
• 生成结果：合成 MP3，并把文件路径打印到控制台；调用方拿到路径后再决定播放、下载或分发。

适用边界

它适合需要快速得到可听粤语草稿的工程场景，不负责解释方言文化注释，也不能保证所有长文本、复杂标点、数字缩写、多角色对白都自然。若要用于正式广播、客服、医疗或法律场景，应先用小样本试听，再保留人工校对粤语表达和语气参数。