config.py 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242
  1. """
  2. 配置管理模块
  3. """
  4. import os
  5. from pathlib import Path
  6. from pydantic_settings import BaseSettings
  7. from dotenv import load_dotenv
  8. # 加载环境变量
  9. # 🔥 确保从 backend 目录加载 .env 文件(无论从哪个目录启动服务)
  10. backend_dir = Path(__file__).parent
  11. env_file = backend_dir / ".env"
  12. if env_file.exists():
  13. load_dotenv(env_file)
  14. print(f"✅ 已加载 .env 文件: {env_file}")
  15. else:
  16. # 如果 backend/.env 不存在,尝试从当前目录加载(兼容旧方式)
  17. load_dotenv()
  18. if os.getenv("TTS_SPEECH_RATE"):
  19. print(f"⚠️ 从当前目录加载环境变量,TTS_SPEECH_RATE={os.getenv('TTS_SPEECH_RATE')}")
  20. else:
  21. print(f"⚠️ 未找到 .env 文件: {env_file},使用默认配置")
  22. class Settings(BaseSettings):
  23. """应用配置"""
  24. # 应用基础配置
  25. APP_NAME: str = "Lyrria Voice Assistant"
  26. APP_VERSION: str = "1.0.0"
  27. DEBUG: bool = False
  28. # 服务器配置
  29. HOST: str = os.getenv("HOST", "0.0.0.0")
  30. PORT: int = int(os.getenv("PORT", "8000"))
  31. host: str = os.getenv("HOST", "0.0.0.0") # 别名,兼容小写
  32. port: int = int(os.getenv("PORT", "8000")) # 别名,兼容小写
  33. # WebSocket配置
  34. WS_HEARTBEAT_INTERVAL: int = 30 # 心跳间隔(秒)
  35. WS_TIMEOUT: int = 60 # 超时时间(秒)
  36. # 能量石配置
  37. ENERGY_STONE_TTL_SECONDS: int = int(os.getenv("ENERGY_STONE_TTL_SECONDS", "20"))
  38. CONVERSATION_STONE_INTERVAL_SECONDS: int = int(os.getenv("CONVERSATION_STONE_INTERVAL_SECONDS", "30"))
  39. MISSION_TYPE_CACHE_SECONDS: int = int(os.getenv("MISSION_TYPE_CACHE_SECONDS", "60"))
  40. # DashScope API配置(阿里云)
  41. dashscope_api_key: str = os.getenv("DASHSCOPE_API_KEY", "")
  42. dashscope_api_key_intl: str = os.getenv("DASHSCOPE_API_KEY_INTL", "") # 国际版单独的key(可选)
  43. use_dashscope_intl: bool = os.getenv("USE_DASHSCOPE_INTL", "false").lower() == "true" # 是否使用国际版
  44. @property
  45. def active_dashscope_api_key(self) -> str:
  46. """获取当前激活的API Key(根据国际版/国内版自动选择)"""
  47. if self.use_dashscope_intl and self.dashscope_api_key_intl:
  48. return self.dashscope_api_key_intl
  49. return self.dashscope_api_key
  50. # LLM配置
  51. llm_model: str = os.getenv("LLM_MODEL", "qwen-flash")
  52. LLM_BASE_URL: str = os.getenv("LLM_BASE_URL", "")
  53. # STT配置
  54. # ⚠️ 重要:language参数必须设置!
  55. # 支持的值:
  56. # - 'zh' (中文)
  57. # - 'en' (英文)
  58. # - 'ja' (日文)
  59. # - 'ko' (韩文)
  60. # - 'auto' (自动检测 - 实验性,需要测试)
  61. # 项目正式使用时应设为'en',测试阶段用'zh'或'auto'
  62. STT_MODEL: str = os.getenv("STT_MODEL", "qwen3-asr-flash-realtime")
  63. STT_WS_URL: str = os.getenv("STT_WS_URL", "")
  64. STT_LANGUAGE: str = os.getenv("STT_LANGUAGE", "zh")
  65. # TTS配置
  66. tts_model: str = os.getenv("TTS_MODEL", "qwen3-tts-flash")
  67. TTS_API_URL: str = os.getenv("TTS_API_URL", "")
  68. tts_voice: str = os.getenv("TTS_VOICE", "Cherry") # 女声(支持:Cherry, Stella)
  69. tts_speech_rate: float = float(os.getenv("TTS_SPEECH_RATE", "1.1")) # 语速:1.1 = 10%加速(优化延迟)
  70. # TTS重试配置(处理API速率限制)
  71. TTS_MAX_RETRIES: int = int(os.getenv("TTS_MAX_RETRIES", "3")) # 最大重试次数
  72. TTS_RETRY_DELAY: float = float(os.getenv("TTS_RETRY_DELAY", "5.0")) # 初始重试延迟(秒)- 增加到5秒
  73. TTS_RETRY_BACKOFF: float = float(os.getenv("TTS_RETRY_BACKOFF", "2.0")) # 指数退避系数
  74. # TTS速率控制(预防性措施,避免触发API限制)
  75. TTS_MIN_INTERVAL: float = float(os.getenv("TTS_MIN_INTERVAL", "0.8")) # 两次TTS调用的最小间隔(秒)
  76. # AI助手提示词配置
  77. LEARNER_PROFICIENCY: str = os.getenv("LEARNER_PROFICIENCY", "A1-A2")
  78. AGE_TAG: str = os.getenv("AGE_TAG", "Adult")
  79. TOPIC_TAG: str = os.getenv("TOPIC_TAG", "Daily Conversation")
  80. EXPERIMENT_TAG: str = os.getenv("EXPERIMENT_TAG", "control") # control 或 experiment
  81. USE_SIMPLIFIED_PROMPT: bool = os.getenv("USE_SIMPLIFIED_PROMPT", "false").lower() == "true" # 🔥 使用简化提示词(减少延迟)
  82. # 音频配置
  83. AUDIO_SAMPLE_RATE: int = 16000
  84. AUDIO_BIT_RATE: int = 16
  85. AUDIO_CHANNELS: int = 1
  86. # MySQL配置
  87. MYSQL_HOST: str = os.getenv("MYSQL_HOST", "47.99.164.66")
  88. MYSQL_PORT: int = int(os.getenv("MYSQL_PORT", "3306"))
  89. MYSQL_USER: str = os.getenv("MYSQL_USER", "root")
  90. MYSQL_PASSWORD: str = os.getenv("MYSQL_PASSWORD", "")
  91. MYSQL_DATABASE: str = os.getenv("MYSQL_DATABASE", "Lyrria")
  92. MYSQL_POOL_SIZE: int = int(os.getenv("MYSQL_POOL_SIZE", "10"))
  93. MYSQL_MAX_OVERFLOW: int = int(os.getenv("MYSQL_MAX_OVERFLOW", "20"))
  94. MYSQL_CONNECT_TIMEOUT: int = int(os.getenv("MYSQL_CONNECT_TIMEOUT", "10"))
  95. MYSQL_READ_TIMEOUT: int = int(os.getenv("MYSQL_READ_TIMEOUT", "10"))
  96. MYSQL_POOL_RECYCLE: int = int(os.getenv("MYSQL_POOL_RECYCLE", "7200")) # 🔥 增加到2小时,保持长连接
  97. MYSQL_HEALTHCHECK_INTERVAL: int = int(os.getenv("MYSQL_HEALTHCHECK_INTERVAL", "600")) # 🔥 增加到10分钟,减少检查频率
  98. # Redis配置
  99. REDIS_HOST: str = os.getenv("REDIS_HOST", "47.99.164.66")
  100. REDIS_PORT: int = int(os.getenv("REDIS_PORT", "16379"))
  101. REDIS_DB: int = int(os.getenv("REDIS_DB", "12"))
  102. REDIS_PASSWORD: str = os.getenv("REDIS_PASSWORD", "")
  103. REDIS_SSL: bool = os.getenv("REDIS_SSL", "false").lower() == "true"
  104. REDIS_SESSION_TTL: int = int(os.getenv("REDIS_SESSION_TTL", "86400"))
  105. REDIS_MAX_CONNECTIONS: int = int(os.getenv("REDIS_MAX_CONNECTIONS", "50"))
  106. REDIS_HEALTHCHECK_INTERVAL: int = int(os.getenv("REDIS_HEALTHCHECK_INTERVAL", "300")) # 🔥 Redis健康检查间隔(秒),5分钟检查一次
  107. # HTTP客户端配置(用于DashScope API)
  108. HTTPX_MAX_KEEPALIVE_CONNECTIONS: int = int(os.getenv("HTTPX_MAX_KEEPALIVE_CONNECTIONS", "20")) # 🔥 keepalive连接数
  109. HTTPX_MAX_CONNECTIONS: int = int(os.getenv("HTTPX_MAX_CONNECTIONS", "50")) # 🔥 最大连接数
  110. HTTPX_KEEPALIVE_EXPIRY: float = float(os.getenv("HTTPX_KEEPALIVE_EXPIRY", "600.0")) # 🔥 keepalive过期时间(秒),10分钟,减少长时间未使用后的连接重建
  111. # LLM连接健康检查配置
  112. LLM_HEALTHCHECK_INTERVAL: int = int(os.getenv("LLM_HEALTHCHECK_INTERVAL", "300")) # 🔥 LLM连接健康检查间隔(秒),5分钟检查一次
  113. # TTS连接健康检查配置
  114. TTS_HEALTHCHECK_INTERVAL: int = int(os.getenv("TTS_HEALTHCHECK_INTERVAL", "300")) # 🔥 TTS连接健康检查间隔(秒),5分钟检查一次
  115. # CORS配置
  116. # 支持localhost和任意IP地址访问(端口3000为Vite默认HTTPS端口)
  117. CORS_ORIGINS: list = [
  118. "http://localhost:3000",
  119. "https://localhost:3000",
  120. "http://127.0.0.1:3000",
  121. "https://127.0.0.1:3000",
  122. "http://localhost:5173",
  123. "https://localhost:5173",
  124. "http://127.0.0.1:5173",
  125. "https://127.0.0.1:5173",
  126. # 支持局域网IP访问
  127. "http://192.168.2.112:3000",
  128. "https://192.168.2.112:3000",
  129. "http://192.168.2.112:5173",
  130. "https://192.168.2.112:5173",
  131. "http://192.168.43.35:3000",
  132. "https://192.168.43.35:3000",
  133. "http://192.168.43.35:5173",
  134. "https://192.168.43.35:5173",
  135. ]
  136. # 是否允许所有来源(开发环境可设为True,生产环境务必设为False)
  137. CORS_ALLOW_ALL: bool = os.getenv("CORS_ALLOW_ALL", "true").lower() == "true"
  138. # 日志配置
  139. LOG_LEVEL: str = "INFO"
  140. LOG_DIR: str = "logs"
  141. LOG_ROTATION: str = "500 MB"
  142. LOG_RETENTION: str = "10 days"
  143. # SSL配置(可选,生产环境建议由nginx统一管理SSL)
  144. SSL_KEYFILE: str = os.getenv("SSL_KEYFILE", "")
  145. SSL_CERTFILE: str = os.getenv("SSL_CERTFILE", "")
  146. # OAuth配置 - 微信开放平台(用于登录)
  147. WECHAT_OPEN_APP_ID: str = os.getenv("WECHAT_OPEN_APP_ID", os.getenv("WECHAT_APP_ID", "")) # 开放平台AppID,兼容旧配置
  148. WECHAT_OPEN_APP_SECRET: str = os.getenv("WECHAT_OPEN_APP_SECRET", os.getenv("WECHAT_APP_SECRET", "")) # 开放平台AppSecret,兼容旧配置
  149. WECHAT_REDIRECT_URI: str = os.getenv("WECHAT_REDIRECT_URI", "")
  150. # 微信公众平台配置(用于JSSDK分享)
  151. WECHAT_MP_APP_ID: str = os.getenv("WECHAT_MP_APP_ID", os.getenv("WECHAT_APP_ID", "")) # 公众平台AppID,兼容旧配置
  152. WECHAT_MP_APP_SECRET: str = os.getenv("WECHAT_MP_APP_SECRET", os.getenv("WECHAT_APP_SECRET", "")) # 公众平台AppSecret,兼容旧配置
  153. # 微信JS-SDK配置(用于分享功能)
  154. WECHAT_JSAPI_TICKET: str = os.getenv("WECHAT_JSAPI_TICKET", "") # jsapi_ticket(需要从微信服务器获取)
  155. WECHAT_JSAPI_TICKET_CACHE_KEY: str = "wechat_jsapi_ticket" # Redis缓存key
  156. WECHAT_JSAPI_TICKET_CACHE_TTL: int = int(os.getenv("WECHAT_JSAPI_TICKET_CACHE_TTL", "7200")) # 缓存时间(秒),默认2小时
  157. # 微信公众平台配置(用于公众号消息推送)
  158. WECHAT_MP_TOKEN: str = os.getenv("WECHAT_MP_TOKEN", "") # 公众号服务器配置Token
  159. # OAuth配置 - QQ开放平台
  160. QQ_APP_ID: str = os.getenv("QQ_APP_ID", "")
  161. QQ_APP_KEY: str = os.getenv("QQ_APP_KEY", "")
  162. QQ_REDIRECT_URI: str = os.getenv("QQ_REDIRECT_URI", "")
  163. QQ_APP_NAME: str = os.getenv("QQ_APP_NAME", "Lyrria") # QQ应用名称(用于分享功能)
  164. # 前端URL(用于OAuth回调后的前端跳转)
  165. FRONTEND_URL: str = os.getenv("FRONTEND_URL", "http://localhost:5173")
  166. class Config:
  167. env_file = ".env"
  168. case_sensitive = True
  169. extra = "ignore" # 忽略额外的环境变量(如旧的连接池配置)
  170. # 创建全局配置实例
  171. settings = Settings()
  172. # 🔍 调试:打印 TTS 语速配置(确认环境变量是否正确加载)
  173. import logging
  174. logger = logging.getLogger(__name__)
  175. env_value = os.getenv("TTS_SPEECH_RATE", "未设置")
  176. logger.info(f"🔍 TTS配置检查 - 环境变量 TTS_SPEECH_RATE: {env_value}, 最终配置值 tts_speech_rate: {settings.tts_speech_rate}")
  177. # 确保日志目录存在
  178. Path(settings.LOG_DIR).mkdir(parents=True, exist_ok=True)
  179. # DashScope API endpoint 配置
  180. def get_dashscope_domain() -> str:
  181. """获取 DashScope API 域名"""
  182. return "dashscope-intl.aliyuncs.com" if settings.use_dashscope_intl else "dashscope.aliyuncs.com"
  183. def get_dashscope_ws_url() -> str:
  184. """获取 DashScope WebSocket URL(用于STT)"""
  185. if settings.STT_WS_URL:
  186. return settings.STT_WS_URL
  187. domain = get_dashscope_domain()
  188. return f"wss://{domain}/api-ws/v1/realtime"
  189. def get_dashscope_http_base_url() -> str:
  190. """获取 DashScope HTTP base URL(用于LLM)"""
  191. if settings.LLM_BASE_URL:
  192. return settings.LLM_BASE_URL.rstrip("/")
  193. domain = get_dashscope_domain()
  194. return f"https://{domain}/compatible-mode/v1"
  195. def get_dashscope_tts_api_url() -> str:
  196. """获取 DashScope HTTP API URL(用于TTS)"""
  197. if settings.TTS_API_URL:
  198. return settings.TTS_API_URL.rstrip("/")
  199. domain = get_dashscope_domain()
  200. return f"https://{domain}/api/v1"