添加设置相关的API路由

- 支持用户自定义提示词的获取、更新和重置功能
- 同时更新应用数据存储路径的获取逻辑。

src/voice_dialogue/api/app.py

@@ -11,7 +11,7 @@ from .core.config import AppConfig
 from .core.lifespan import lifespan
 from .middleware.logging import LoggingMiddleware
 from .middleware.rate_limit import RateLimitMiddleware
-from .routes import tts_routes, asr_routes, system_routes, websocket_routes
+from .routes import tts_routes, asr_routes, system_routes, websocket_routes, settings_routes
 
 
 def create_app() -> FastAPI:
@@ -56,6 +56,7 @@ def _register_routes(app: FastAPI):
     v1_router.include_router(tts_routes.router, prefix="/tts", tags=["TTS模型管理"])
     v1_router.include_router(asr_routes.router, prefix="/asr", tags=["ASR模型管理"])
     v1_router.include_router(system_routes.router, prefix="/system", tags=["系统管理"])
+    v1_router.include_router(settings_routes.router, prefix="/settings", tags=["设置管理"])
     app.include_router(v1_router)
 
     app.add_websocket_route("/api/v1/ws", websocket_routes.ws)

src/voice_dialogue/api/routes/__init__.py

@@ -1,3 +1,3 @@
-from . import tts_routes, asr_routes, system_routes, websocket_routes
+from . import tts_routes, asr_routes, system_routes, websocket_routes, settings_routes
 
-__all__ = ["tts_routes", "asr_routes", "system_routes", "websocket_routes"]
+__all__ = ["tts_routes", "asr_routes", "system_routes", "websocket_routes", "settings_routes"]

src/voice_dialogue/api/routes/settings_routes.py

@@ -0,0 +1,102 @@
+"""设置相关的API路由"""
+from typing import Optional
+
+from fastapi import APIRouter, HTTPException
+from pydantic import BaseModel, Field
+
+from voice_dialogue.config.llm_config import CHINESE_SYSTEM_PROMPT, ENGLISH_SYSTEM_PROMPT
+from voice_dialogue.config.user_config import (
+    get_user_prompts, save_user_prompts, get_prompt, reset_prompts_to_default
+)
+
+router = APIRouter()
+
+
+class PromptsResponse(BaseModel):
+    """获取 Prompts 的响应模型"""
+    chinese_prompt: str = Field(..., description="中文系统提示词")
+    english_prompt: str = Field(..., description="英文系统提示词")
+    is_custom: bool = Field(..., description="是否为用户自定义")
+
+
+class UpdatePromptsRequest(BaseModel):
+    """更新 Prompts 的请求模型"""
+    chinese_prompt: Optional[str] = Field(None, description="中文系统提示词")
+    english_prompt: Optional[str] = Field(None, description="英文系统提示词")
+
+
+class DefaultPromptsResponse(BaseModel):
+    """默认 Prompts 的响应模型"""
+    chinese_prompt: str = Field(..., description="默认中文系统提示词")
+    english_prompt: str = Field(..., description="默认英文系统提示词")
+
+
+@router.get("/settings/prompts", response_model=PromptsResponse, summary="获取当前生效的 Prompt")
+async def get_current_prompts():
+    """
+    获取当前系统中正在使用的中文和英文系统 Prompt
+    会融合用户自定义设置和系统默认值
+    """
+    user_prompts = get_user_prompts()
+    is_custom = bool(user_prompts)  # 如果有用户自定义配置，则认为是自定义的
+
+    return PromptsResponse(
+        chinese_prompt=get_prompt("zh"),
+        english_prompt=get_prompt("en"),
+        is_custom=is_custom
+    )
+
+
+@router.get("/settings/prompts/default", response_model=DefaultPromptsResponse, summary="获取默认 Prompt")
+async def get_default_prompts():
+    """获取系统默认的 Prompt"""
+    return DefaultPromptsResponse(
+        chinese_prompt=CHINESE_SYSTEM_PROMPT,
+        english_prompt=ENGLISH_SYSTEM_PROMPT
+    )
+
+
+@router.post("/settings/prompts", summary="更新并保存用户的 Prompt 设置")
+async def update_user_prompts(request: UpdatePromptsRequest):
+    """
+    更新用户自定义的 Prompt
+    只更新请求体中提供的字段，未提供的字段将保持不变
+    """
+    try:
+        # 获取当前用户配置
+        current_prompts = get_user_prompts()
+
+        # 构建更新数据
+        update_data = request.model_dump(exclude_unset=True)
+
+        if not update_data:
+            raise HTTPException(status_code=400, detail="请求体不能为空")
+
+        # 更新配置
+        current_prompts.update(update_data)
+
+        # 保存配置
+        if not save_user_prompts(current_prompts):
+            raise HTTPException(status_code=500, detail="保存配置失败")
+
+        return {"message": "用户 Prompt 更新成功", "updated_fields": list(update_data.keys())}
+
+    except HTTPException:
+        raise
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"更新 Prompt 失败: {str(e)}")
+
+
+@router.delete("/settings/prompts", summary="重置 Prompt 为默认值")
+async def reset_prompts():
+    """重置用户自定义的 Prompt 为系统默认值"""
+    try:
+        if not reset_prompts_to_default():
+            raise HTTPException(status_code=500, detail="重置失败")
+
+        return {"message": "Prompt 已重置为默认值"}
+
+    except HTTPException:
+        raise
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=f"重置 Prompt 失败: {str(e)}")

src/voice_dialogue/config/paths.py

@@ -1,3 +1,4 @@
+import os
 import sys
 from pathlib import Path
 
@@ -26,6 +27,27 @@ AUDIO_RESOURCES_PATH = ASSETS_PATH / "audio"
 FRONTEND_ASSETS_PATH = ASSETS_PATH / "www"
 
 
+# 用户数据路径 - 根据操作系统选择合适的目录
+def get_app_data_path() -> Path:
+    """获取应用数据存储路径"""
+    app_name = "Voice Dialogue"
+
+    if sys.platform == "darwin":  # macOS
+        base_path = Path.home() / "Library" / "Application Support"
+    elif sys.platform == "win32":  # Windows
+        base_path = Path(os.environ.get("APPDATA", Path.home() / "AppData" / "Roaming"))
+    else:  # Linux and others
+        base_path = Path.home() / ".config"
+
+    return base_path / app_name
+
+
+APP_DATA_PATH = get_app_data_path()
+if not APP_DATA_PATH.exists():
+    APP_DATA_PATH.mkdir(parents=True, exist_ok=True)
+USER_PROMPTS_PATH = APP_DATA_PATH / "user_prompts.json"
+
+
 def load_third_party():
     # 添加第三方库到 Python 路径
     if THIRD_PARTY_PATH.exists() and str(THIRD_PARTY_PATH) not in sys.path:

src/voice_dialogue/config/user_config.py

@@ -0,0 +1,88 @@
+"""用户配置管理模块"""
+import json
+from typing import Dict
+
+from voice_dialogue.utils.logger import logger
+from .llm_config import CHINESE_SYSTEM_PROMPT, ENGLISH_SYSTEM_PROMPT
+from .paths import USER_PROMPTS_PATH
+
+
+def get_user_prompts() -> Dict[str, str]:
+    """
+    加载用户自定义的 prompts
+    
+    Returns:
+        Dict[str, str]: 用户自定义的 prompts，如果文件不存在或解析失败则返回空字典
+    """
+    if not USER_PROMPTS_PATH.exists():
+        logger.info(f"用户配置文件不存在: {USER_PROMPTS_PATH}")
+        return {}
+
+    try:
+        with open(USER_PROMPTS_PATH, 'r', encoding='utf-8') as f:
+            user_prompts = json.load(f)
+            logger.info("成功加载用户自定义 prompts")
+            return user_prompts
+    except (json.JSONDecodeError, IOError) as e:
+        logger.error(f"无法加载用户 prompt 配置文件: {e}")
+        return {}
+
+
+def save_user_prompts(prompts: Dict[str, str]) -> bool:
+    """
+    保存用户自定义的 prompts 到 JSON 文件
+    
+    Args:
+        prompts: 要保存的 prompts 字典
+        
+    Returns:
+        bool: 保存是否成功
+    """
+    try:
+        # 确保目录存在
+        if not USER_PROMPTS_PATH.parent.exists():
+            USER_PROMPTS_PATH.parent.mkdir(parents=True, exist_ok=True)
+
+        with open(USER_PROMPTS_PATH, 'w', encoding='utf-8') as f:
+            json.dump(prompts, f, ensure_ascii=False, indent=4)
+        logger.info(f"用户 prompts 已保存到: {USER_PROMPTS_PATH}")
+        return True
+    except IOError as e:
+        logger.error(f"无法保存用户 prompt 配置文件: {e}")
+        return False
+
+
+def get_prompt(language: str) -> str:
+    """
+    获取指定语言的 prompt
+    优先从用户配置中获取，如果未配置，则返回默认值
+    
+    Args:
+        language: 语言代码，"zh" 表示中文，其他表示英文
+        
+    Returns:
+        str: 对应语言的系统提示词
+    """
+    user_prompts = get_user_prompts()
+
+    if language == "zh":
+        return user_prompts.get("chinese_prompt", CHINESE_SYSTEM_PROMPT)
+    else:
+        return user_prompts.get("english_prompt", ENGLISH_SYSTEM_PROMPT)
+
+
+def reset_prompts_to_default() -> bool:
+    """
+    重置 prompts 为默认值
+    
+    Returns:
+        bool: 重置是否成功
+    """
+    try:
+        if USER_PROMPTS_PATH.exists():
+            USER_PROMPTS_PATH.unlink()
+            logger.info("用户自定义 prompts 已重置为默认值")
+        return True
+    except IOError as e:
+        logger.error(f"重置 prompts 失败: {e}")
+        return False

src/voice_dialogue/services/text/generator.py

@@ -9,6 +9,7 @@ from voice_dialogue.config import paths
 from voice_dialogue.config.llm_config import (
     get_llm_model_params, get_apple_silicon_summary, CHINESE_SYSTEM_PROMPT, ENGLISH_SYSTEM_PROMPT
 )
+from voice_dialogue.config.user_config import get_prompt  # 修改导入
 from voice_dialogue.core.base import BaseThread
 from voice_dialogue.core.constants import chat_history_cache
 from voice_dialogue.models.voice_task import VoiceTask, QuestionDisplayMessage
@@ -38,10 +39,7 @@ class LLMResponseGenerator(BaseThread):
 
     def _get_prompt_by_language(self, language: str) -> str:
         """根据语言获取对应的 prompt"""
-        if language == "zh":
-            return CHINESE_SYSTEM_PROMPT
-        else:
-            return ENGLISH_SYSTEM_PROMPT
+        return get_prompt(language)
 
     def get_session_history(self, session_id: str) -> InMemoryChatMessageHistory:
         message_history = InMemoryChatMessageHistory()
@@ -193,7 +191,9 @@ class LLMResponseGenerator(BaseThread):
         self.model_instance = create_langchain_chat_llamacpp_instance(
             local_model_path=model_path, model_params=model_params
         )
-        pipeline = create_langchain_pipeline(self.model_instance, CHINESE_SYSTEM_PROMPT, self.get_session_history)
+        # 使用默认中文 prompt 进行 warmup
+        prompt = get_prompt("zh")
+        pipeline = create_langchain_pipeline(self.model_instance, prompt, self.get_session_history)
         warmup_langchain_pipeline(pipeline)
 
         self.is_ready = True