🚀 feat(tts): 支持离线 API 和更多配置项

- 新增离线 API 配置项和相关功能
- 重构在线 API 调用逻辑，支持参考音频和自定义模型
- 优化配置文件结构，增加更多可配置选项
- 重构代码，提高可维护性和扩展性
- 更新 README 文档，增加新的配置说明和使用方法

Author: Cvandia

README.md

@@ -69,19 +69,36 @@ git clone https://github.com/Cvandia/nonebot-plugin-fishspeech-tts
 
 ## ⚙️ 配置
 
-**在env.中添加以下配置**
+**在.env中添加以下配置**
 
-| 配置 | 类型 |必填项| 默认值 | 说明 |
+| 基础配置 | 类型 |必填项| 默认值 | 说明 |
 |:-----:|:----:|:----:|:---:|:----:|
 |tts_is_online|bool|是|True|是否使用云端api|
-|tts_is_to_me|bool|是|True|是否需要at触发(防止误触)|
-|online_authorization|str|依据第一个配置项|"xxxx"|fish-audio 后端api鉴权，详见[链接](https://fish.audio/zh-CN/go-api/api-keys/)||
-|tts_api_url|str|依据第一个配置项|"http://127.0.0.1:8080"|离线或自定义api地址
-|tts_audio_path|str|依据第一个配置项|"./data/参考音频"|合成角色语音路劲|
 |tts_chunk_length|literal|否|"normal"|请求时音频分片长度，默认为normal，可选：short, normal, long|
+|tts_is_to_me|bool|否|True|是否仅当被@时回复|
+|tts_audio_path|str|否|"./data/参考音频"|语音素材路径，默认为"./data/参考音频"|
 
-**注：参考音频的文件名格式为：［角色名］音频对应的文字标签.wav**
-**支持同一角色的不同语音**
+**注：参考音频的文件名格式为：［角色名］音频对应的文字标签.[音频后缀名]**
+
+**! 支持同一角色的不同语音 !**
+
+**音频后缀目前支持有详见[files.py](./nonebot_plugin_fishspeech_tts/files.py)中的`AUDIO_FILE_SUFFIX`**
+___
+
+如果你想使用官方的api，请将配置项`tts_is_online`设置为`True`并配置以下
+
+| 配置项 | 类型 | 必填项 | 默认值 | 说明 |
+|:-----:|:----:|:----:|:---:|:----:|
+|online_authorization|str|是|"xxxxx"|官网api鉴权秘钥，详见[链接](https://fish.audio/zh-CN/go-api/api-keys/)|
+|online_model_first|bool|否|True|如果你想调用官方模型，通过自己的参考音频，定制角色音色，将此项设为`False`。当然，如果你没有准备参考音频，也是会调用官网已经有的音色，具体详见[链接](https://fish.audio/zh-CN/)|
+
+---
+
+如果你想使用[自搭](#离线搭建fish-speech)或者其他的[fish-speech](https://github.com/fishaudio/fish-speech)项目的api,请将配置项`tts_is_online`设置为`Fasle`并配置以下
+
+| 配置项 | 类型 | 必填项 | 默认值 | 说明 |
+|:----:|:----:|:----:|:---:|:----:|
+|offline_api_url|str|是|"http://127.0.0.1:8080"|你的`fish-speech`api地址|
 
 ## ⭐ 使用
 

nonebot_plugin_fishspeech_tts/__init__.py

@@ -8,9 +8,10 @@
 require("nonebot_plugin_alconna")
 
 from nonebot_plugin_alconna import UniMessage, Reply, UniMsg, Text
-from .fish_audio_api import fish_audio_api, ChunkLength
+from .fish_audio_api import fish_audio_api
 from .fish_speech_api import fish_speech_api
 from .exception import APIException
+from .request_params import ChunkLength
 from .config import config, Config
 import contextlib
 
@@ -76,7 +77,10 @@ async def tts_handle(message: UniMsg, match: tuple = RegexGroup()):
     try:
         if is_online:
             await tts_handler.send("正在通过在线api合成语音, 请稍等")
-            audio = await fish_audio_api.generate_tts(text, speaker, chunk_length)
+            request = await fish_audio_api.generate_servettsrequest(
+                text, speaker, chunk_length
+            )
+            audio = await fish_audio_api.generate_tts(request)
             await UniMessage.voice(raw=audio).finish()
         else:
             await tts_handler.send("正在通过本地api合成语音, 请稍等")
@@ -93,11 +97,11 @@ async def tts_handle(message: UniMsg, match: tuple = RegexGroup()):
 async def speaker_list_handle(event: Event):
     try:
         if is_online:
-            await speaker_list.send("具体见官网:https://fish.audio/zh-CN/")
+            _list = fish_audio_api.get_speaker_list()
+            await speaker_list.finish("语音角色列表: " + ", ".join(_list))
         else:
-            await speaker_list.send("正在获取本地语音角色列表, 请稍等")
-            speakers = fish_speech_api.get_speaker_list()
-            await speaker_list.send("语音角色列表: " + ", ".join(speakers))
+            _list = fish_speech_api.get_speaker_list()
+            await speaker_list.finish("语音角色列表: " + ", ".join(_list))
     except APIException as e:
         await speaker_list.finish(str(e))
 

nonebot_plugin_fishspeech_tts/config.py

@@ -5,12 +5,17 @@
 
 class Config(BaseModel):
 
-    online_authorization: Optional[str] = "xxxxx"
-    tts_api_url: str = "http://127.0.0.1:8080"
+    # 基础配置
     tts_is_online: bool = True
     tts_chunk_length: Literal["normal", "short", "long"] = "normal"
     tts_is_to_me: bool = True
     tts_audio_path: str = "./data/参考音频"
 
+    # 区分配置
+    online_authorization: Optional[str] = "xxxxx"
+    online_model_first: bool = True
+
+    offline_api_url: str = "http://127.0.0.1:8080"
+
 
 config = get_plugin_config(Config)

nonebot_plugin_fishspeech_tts/exception.py

@@ -1,3 +1,12 @@
+from httpx import (
+    ReadTimeout,
+    ConnectTimeout,
+    ConnectError,
+    RequestError,
+    HTTPStatusError,
+)
+
+
 class APIException(Exception):
     """API异常类"""
 
@@ -8,3 +17,17 @@ class AuthorizationException(APIException):
     """授权异常类"""
 
     pass
+
+
+class FileHandleException(Exception):
+    """文件处理异常类"""
+
+    pass
+
+
+class HTTPException(
+    ReadTimeout, ConnectTimeout, ConnectError, RequestError, HTTPStatusError
+):
+    """HTTP异常类"""
+
+    pass

nonebot_plugin_fishspeech_tts/files.py

@@ -0,0 +1,86 @@
+from pathlib import Path
+from nonebot.log import logger
+from .exception import FileHandleException
+import re
+
+
+# 音频文件后缀
+AUDIO_FILE_SUFFIX = [
+    ".mp3",
+    ".wav",
+    ".flac",
+    ".ogg",
+    ".m4a",
+    ".wma",
+    ".aac",
+    ".aiff",
+    ".aif",
+    ".aifc",
+]
+
+
+def extract_text_by_filename(file_name: str) -> str:
+    """
+    从文件名中提取文本标签
+
+    Args:
+        file_name: 文件名
+    Returns:
+        ref_text: 提取的文本标签
+
+    exception:
+        FileHandleException: 未能从文件名中提取文本标签
+    """
+
+    ref_text = re.sub(r"\[.*\]", "", file_name)
+    ref_text = Path(ref_text).stem
+    if not ref_text:
+        raise FileHandleException(f"未能从文件名{file_name}中提取文本标签")
+    return ref_text
+
+
+def get_speaker_audio_path(path_audio: Path, speaker_name: str) -> list[Path]:
+    """
+    获取指定说话人的音频文件路径
+
+    Args:
+        speaker_name: 说话人姓名
+        path_audio: 音频文件路径
+    Returns:
+        speaker_audio_path: 说话人音频文件路径列表
+
+    exception:
+        FileHandleException: 未找到说话人音频文件
+    """
+
+    speaker_audio_path = []
+    for audio in path_audio.iterdir():
+        if speaker_name in audio.name and audio.suffix in AUDIO_FILE_SUFFIX:
+            speaker_audio_path.append(audio)
+    logger.debug(f"获取到角色的语音路劲: {speaker_audio_path}")
+    if not speaker_audio_path:
+        raise FileHandleException(f"未找到角色:{speaker_name}的音频文件")
+    return speaker_audio_path
+
+
+def get_path_speaker_list(path_audio: Path) -> list[str]:
+    """
+    获取说话人列表
+
+    Returns:
+        list[str]: 说话人列表
+
+    exception:
+        FileHandleException: 未找到说话人
+    """
+    speaker_list = []
+    for audio in path_audio.iterdir():
+        if audio.suffix in AUDIO_FILE_SUFFIX:
+            speaker_name = re.search(r"\[(.*)\]", audio.stem)
+            if speaker_name:
+                speaker_list.append(speaker_name.group(1))
+    # 去重
+    speaker_list = list(set(speaker_list))
+    if not speaker_list:
+        raise FileHandleException("未找到说话人音频文件")
+    return speaker_list