Update TTS speaker configuration: replace static mapping with dynamic retrieval, add available speaker listing, and update CLI argument parsing for improved flexibility and maintainability.

src/VoiceDialogue/main.py

@@ -87,19 +87,13 @@ def launch_system(
     answer_generator_worker.start()
     threads.append(answer_generator_worker)
 
-    speaker_mapping = {
-        '罗翔': 'Luo Xiang',
-        '马保国': 'Ma Baoguo',
-        '沈逸': 'Shen Yi',
-        '杨幂': 'Yang Mi',
-        '周杰伦': 'Jay Zhou',
-        '马云': 'Ma Yun',
-    }
-    role = speaker_mapping.get(speaker)
-    if role is None:
-        raise ValueError(f"不支持的TTS配置: {speaker}")
+    # 动态获取TTS配置，而不是使用固定映射
+    tts_speaker_config = _get_tts_config_by_speaker_name(speaker)
+    if tts_speaker_config is None:
+        # 如果找不到指定说话人，列出所有可用说话人并抛出异常
+        available_speakers = _get_available_speaker_names()
+        raise ValueError(f"不支持的TTS说话人: {speaker}。可用说话人: {', '.join(available_speakers)}")
 
-    tts_speaker_config = tts_config_registry.get_config(TTSConfigType.MOYOYO, role)
     audio_generator_worker = TTSAudioGenerator(
         text_input_queue=text_input_queue,
         audio_output_queue=audio_output_queue,
@@ -121,37 +115,100 @@ def launch_system(
         thread.join()
 
 
-def launch_api_server(host: str = "0.0.0.0", port: int = 8000, reload: bool = False):
+def _get_tts_config_by_speaker_name(speaker_name: str):
     """
-    启动API服务器
+    根据说话人名称获取TTS配置
+    
+    支持中文名称和英文名称，优先匹配中文名称映射，
+    如果找不到则直接使用英文名称搜索
     
     Args:
-        host (str): 服务器主机地址，默认为 "0.0.0.0"
-        port (int): 服务器端口，默认为 8000
-        reload (bool): 是否启用热重载，默认为 False
+        speaker_name (str): 说话人名称
+        
+    Returns:
+        BaseTTSConfig: TTS配置，如果找不到则返回None
     """
-    print(f'{"=" * 80}\n正在启动API服务器...\n{"=" * 80}')
-    print(f"服务器地址: http://{host}:{port}")
-    print(f"API文档: http://{host}:{port}/docs")
-    print(f"热重载: {'启用' if reload else '禁用'}")
-    print(f'{"=" * 80}')
+    # 中文名称到英文名称的映射（保持向后兼容）
+    chinese_to_english_mapping = {
+        '罗翔': 'Luo Xiang',
+        '马保国': 'Ma Baoguo', 
+        '沈逸': 'Shen Yi',
+        '杨幂': 'Yang Mi',
+        '周杰伦': 'Zhou Jielun',
+        '马云': 'Ma Yun',
+    }
+    
+    # 首先尝试中文名称映射
+    english_name = chinese_to_english_mapping.get(speaker_name, speaker_name)
+    
+    # 获取所有可用配置
+    all_configs = tts_config_registry.get_all_configs()
+    
+    # 搜索匹配的配置
+    for config in all_configs:
+        if config.character_name == english_name:
+            return config
+    
+    # 如果通过映射找不到，尝试直接匹配输入的名称
+    if speaker_name != english_name:
+        for config in all_configs:
+            if config.character_name == speaker_name:
+                return config
+    
+    return None
 
-    # 导入并启动FastAPI应用
-    uvicorn.run(
-        "api.app:app",
-        host=host,
-        port=port,
-        reload=reload,
-        log_level="info"
-    )
+
+def _get_available_speaker_names():
+    """
+    获取所有可用的说话人名称列表
+    
+    Returns:
+        list[str]: 包含中文显示名称和英文原始名称的列表
+    """
+    # 中文显示名称映射
+    english_to_chinese_mapping = {
+        'Luo Xiang': '罗翔',
+        'Ma Baoguo': '马保国',
+        'Shen Yi': '沈逸', 
+        'Yang Mi': '杨幂',
+        'Zhou Jielun': '周杰伦',
+        'Ma Yun': '马云',
+    }
+    
+    all_configs = tts_config_registry.get_all_configs()
+    speaker_names = []
+    
+    for config in all_configs:
+        # 优先显示中文名称
+        chinese_name = english_to_chinese_mapping.get(config.character_name)
+        if chinese_name:
+            speaker_names.append(chinese_name)
+        else:
+            # 如果没有中文映射，使用英文原名
+            speaker_names.append(config.character_name)
+    
+    return sorted(speaker_names)
+
+
+def _update_argument_parser_speaker_choices():
+    """
+    动态更新命令行参数解析器中的说话人选项
+    
+    Returns:
+        list[str]: 可用的说话人选择列表
+    """
+    return _get_available_speaker_names()
 
 
 def create_argument_parser():
     """创建命令行参数解析器"""
+    # 动态获取可用说话人列表
+    available_speakers = _update_argument_parser_speaker_choices()
+    
     parser = argparse.ArgumentParser(
         description="VoiceDialogue - 语音对话系统",
         formatter_class=argparse.RawDescriptionHelpFormatter,
-        epilog="""
+        epilog=f"""
 示例用法:
   # 启动命令行模式（默认）
   python main.py
@@ -169,7 +226,7 @@ def create_argument_parser():
   python main.py --mode api --port 8000 --reload
 
 支持的说话人:
-  罗翔, 马保国, 沈逸, 杨幂, 周杰伦, 马云
+  {', '.join(available_speakers)}
         """
     )
 
@@ -191,8 +248,8 @@ def create_argument_parser():
     )
     cli_group.add_argument(
         '--speaker', '-s',
-        choices=['罗翔', '马保国', '沈逸', '杨幂', '周杰伦', '马云'],
-        default='沈逸',
+        choices=available_speakers,
+        default='沈逸' if '沈逸' in available_speakers else (available_speakers[0] if available_speakers else '沈逸'),
         help='TTS说话人 (默认: 沈逸)'
     )
 
@@ -218,6 +275,31 @@ def create_argument_parser():
     return parser
 
 
+def launch_api_server(host: str = "0.0.0.0", port: int = 8000, reload: bool = False):
+    """
+    启动API服务器
+    
+    Args:
+        host (str): 服务器主机地址，默认为 "0.0.0.0"
+        port (int): 服务器端口，默认为 8000
+        reload (bool): 是否启用热重载，默认为 False
+    """
+    print(f'{"=" * 80}\n正在启动API服务器...\n{"=" * 80}')
+    print(f"服务器地址: http://{host}:{port}")
+    print(f"API文档: http://{host}:{port}/docs")
+    print(f"热重载: {'启用' if reload else '禁用'}")
+    print(f'{"=" * 80}')
+
+    # 导入并启动FastAPI应用
+    uvicorn.run(
+        "api.app:app",
+        host=host,
+        port=port,
+        reload=reload,
+        log_level="info"
+    )
+
+
 def main():
     """
     主程序入口函数