feat: 修改log audio path

Author: KeQianWang

.env.example

@@ -1,13 +1,13 @@
-#Docker部署的环境变量将此文件复制到.env并根据需要进行自定义
-# 🔮 Mystical Oracle Docker Configuration
+# 🔮 Mystical Oracle Docker 环境变量配置示例
+# 将此文件复制为 .env 并根据需要进行自定义
 
 # ===========================================
 # 模型配置 (Model Configuration)
 # ===========================================
 OLLAMA_BASE_URL=http://ollama:11434
 CHAT_MODEL_NAME=qwen2.5:latest
 EMBEDDING_MODEL_NAME=qwen2.5:latest
-MODEL_TEMPERATURE=0.7
+MODEL_TEMPERATURE=0.3
 
 # ===========================================
 # 数据库配置 (Database Configuration)  
@@ -27,29 +27,34 @@ MAX_HISTORY_MESSAGES=20
 # API 密钥 (API Keys) - 可选配置
 # ===========================================
 # 搜索 API (用于实时信息获取)
-SERPAPI_API_KEY=
+SERPAPI_API_KEY=your_serpapi_key_here
 
 # 缘分居 API (用于八字、解梦、占卜功能)
-YUANFENJU_API_KEY=
+YUANFENJU_API_KEY=your_yuanfenju_key_here
 
 # Microsoft Azure TTS (用于语音合成)
-MICROSOFT_TTS_KEY=
+MICROSOFT_TTS_KEY=your_microsoft_tts_key_here
 
 # ===========================================
 # TTS 配置 (Text-to-Speech Configuration)
 # ===========================================
 TTS_ENDPOINT=
 TTS_VOICE_NAME=zh-CN-XiaoxiaoNeural
 TTS_OUTPUT_FORMAT=audio-16khz-32kbitrate-mono-mp3
+AUDIO_OUTPUT_DIR=/app/audio
+
+# ===========================================
+# 日志配置 (Logging Configuration)
+# ===========================================
+LOG_LEVEL=INFO
+LOG_DIR=/app/logs
+LOG_RETENTION_DAYS=30
 
 # ===========================================
 # 高级配置 (Advanced Configuration)
 # ===========================================
 # 用户代理
 USER_AGENT=Mozilla/5.0 (Mystical Oracle/1.0)
 
-# 日志级别
-LOG_LEVEL=INFO
-
 # 时区设置
 TZ=Asia/Shanghai

.env.template

@@ -1,32 +1,60 @@
-# 环境变量配置文件模板
-# 复制此文件为 .env 并填入真实的 API 密钥
+# 🔮 Mystical Oracle 本地开发,环境变量配置模板
+# 复制此文件为 .env 并填入真实的配置值
 
-# API 密钥配置
-SERPAPI_API_KEY=your_serpapi_key_here
-YUANFENJU_API_KEY=your_yuanfenju_key_here
-MICROSOFT_TTS_KEY=your_microsoft_tts_key_here
-
-# 数据库配置
-QDRANT_PATH=/Users/king/Develop/self/mystical-oracle/qdrant_data
-QDRANT_COLLECTION_NAME=yunshi
-REDIS_URL=redis://localhost:6379/0
-
-# 模型配置
+# ===========================================
+# 模型配置 (Model Configuration)
+# ===========================================
 OLLAMA_BASE_URL=http://localhost:11434
 CHAT_MODEL_NAME=qwen3:8b
 EMBEDDING_MODEL_NAME=bge-m3:latest
 MODEL_TEMPERATURE=0
 
-# TTS配置
-TTS_ENDPOINT=https://eastus.tts.speech.microsoft.com/cognitiveservices/v1
-TTS_VOICE_NAME=zh-CN-YunzeNeural
-TTS_OUTPUT_FORMAT=audio-16khz-32kbitrate-mono-mp3
+# ===========================================
+# 数据库配置 (Database Configuration)
+# ===========================================
+REDIS_URL=redis://localhost:6379/0
+QDRANT_PATH=/Users/king/Develop/self/mystical-oracle/qdrant_data
+QDRANT_COLLECTION_NAME=yunshi
 
-# 应用配置
+# ===========================================
+# Agent 配置 (Agent Configuration)
+# ===========================================
 DEFAULT_SESSION_ID=King
-MAX_HISTORY_MESSAGES=10
 MEMORY_KEY=chat_history
+MAX_HISTORY_MESSAGES=10
+
+# ===========================================
+# API 密钥 (API Keys) - 必须配置
+# ===========================================
+# 搜索 API (用于实时信息获取)
+SERPAPI_API_KEY=your_serpapi_key_here
+
+# 缘分居 API (用于八字、解梦、占卜功能)
+YUANFENJU_API_KEY=your_yuanfenju_key_here
+
+# Microsoft Azure TTS (用于语音合成)
+MICROSOFT_TTS_KEY=your_microsoft_tts_key_here
 
-# 日志配置
+# ===========================================
+# TTS 配置 (Text-to-Speech Configuration)
+# ===========================================
+TTS_ENDPOINT=https://eastus.tts.speech.microsoft.com/cognitiveservices/v1
+TTS_VOICE_NAME=zh-CN-YunzeNeural
+TTS_OUTPUT_FORMAT=audio-16khz-32kbitrate-mono-mp3
+AUDIO_OUTPUT_DIR=/Users/king/Develop/self/mystical-oracle/audio
+
+# ===========================================
+# 日志配置 (Logging Configuration)
+# ===========================================
 LOG_LEVEL=INFO
-LOG_FILE=mystical_oracle.log
+LOG_DIR=logs
+LOG_RETENTION_DAYS=30
+
+# ===========================================
+# 高级配置 (Advanced Configuration)
+# ===========================================
+# 用户代理
+USER_AGENT=Mozilla/5.0 (Mystical Oracle/1.0)
+
+# 时区设置
+TZ=Asia/Shanghai

DEPLOYMENT.md

@@ -0,0 +1,73 @@
+# Mystical Oracle 部署指南
+
+## 部署选项
+
+### 1. 单实例部署（开发/测试环境）
+
+使用单个应用实例，适合开发和测试：
+
+```bash
+docker-compose -f docker-compose.single.yml up -d
+```
+
+应用将在 http://localhost:8000 可用
+
+### 2. 负载均衡部署（生产环境）
+
+使用Nginx负载均衡器和多个应用实例，提供高可用性：
+
+```bash
+docker-compose up -d
+```
+
+应用将在 http://localhost 可用，nginx自动进行负载均衡
+
+## 目录结构说明
+
+```
+mystical-oracle/
+├── audio/              # TTS生成的音频文件统一存储目录
+├── logs/               # 应用日志文件统一存储目录
+├── nginx/              # Nginx配置文件
+│   └── nginx.conf     # 负载均衡配置
+├── docker-compose.yml          # 生产环境配置（负载均衡）
+├── docker-compose.single.yml   # 单实例配置
+└── ...
+```
+
+## 环境变量配置
+
+在 `.env` 文件中配置以下变量：
+
+```env
+# 音频输出目录（Docker内部路径）
+AUDIO_OUTPUT_DIR=/app/audio
+
+# 日志配置
+LOG_DIR=/app/logs
+LOG_RETENTION_DAYS=30
+
+# 其他现有配置...
+```
+
+## 负载均衡特性
+
+- **负载均衡策略**: ip_hash，确保同一用户访问同一后端实例
+- **健康检查**: 自动检测和移除不健康的实例
+- **故障转移**: 主实例故障时自动切换到备份实例
+- **静态文件缓存**: 自动缓存CSS、JS、图片等静态资源
+- **音频文件缓存**: 音频文件缓存1小时，减少服务器负载
+
+## 监控和日志
+
+- **应用日志**: 自动按日期命名，超过30天自动清理
+- **Nginx日志**: 存储在nginx_logs volume中
+- **健康检查**: 所有服务都配置了健康检查端点
+
+## 扩展说明
+
+如需增加更多应用实例，修改 `docker-compose.yml`：
+
+1. 复制 `mystical-oracle-2` 服务配置
+2. 修改服务名和INSTANCE_ID
+3. 在nginx配置中添加新的server

config/logger.py

@@ -4,19 +4,41 @@
 """
 import os
 import logging
+import glob
+from datetime import datetime, timedelta
+from pathlib import Path
 from logging.handlers import RotatingFileHandler
 from typing import Optional
 
 # 从环境变量获取日志配置
 LOG_LEVEL = os.getenv("LOG_LEVEL", "INFO").upper()
-LOG_FILE = os.getenv("LOG_FILE", "mystical_oracle.log")
+LOG_DIR = os.getenv("LOG_DIR", "logs")
+LOG_RETENTION_DAYS = int(os.getenv("LOG_RETENTION_DAYS", "30"))
+
+# 确保日志目录存在
+Path(LOG_DIR).mkdir(parents=True, exist_ok=True)
 
 
 class Logger:
     """统一日志管理类"""
 
     _loggers = {}
 
+    @classmethod
+    def _cleanup_old_logs(cls) -> None:
+        """清理超过指定天数的日志文件"""
+        try:
+            cutoff_date = datetime.now() - timedelta(days=LOG_RETENTION_DAYS)
+            log_pattern = os.path.join(LOG_DIR, "*.log*")
+            
+            for log_file in glob.glob(log_pattern):
+                file_path = Path(log_file)
+                if file_path.stat().st_mtime < cutoff_date.timestamp():
+                    file_path.unlink()
+                    print(f"已删除过期日志文件: {log_file}")
+        except Exception as e:
+            print(f"清理日志文件时出错: {e}")
+    
     @classmethod
     def get_logger(cls, name: str, log_file: Optional[str] = None) -> logging.Logger:
         """获取或创建日志器"""
@@ -43,10 +65,15 @@ def get_logger(cls, name: str, log_file: Optional[str] = None) -> logging.Logger
         console_handler.setFormatter(formatter)
         logger.addHandler(console_handler)
 
-        # 文件处理器（带轮转）
-        file_name = log_file or LOG_FILE
+        # 文件处理器（带轮转），使用日期命名
+        if not log_file:
+            date_str = datetime.now().strftime("%Y%m%d")
+            log_file = os.path.join(LOG_DIR, f"mystical_oracle_{date_str}.log")
+        else:
+            log_file = os.path.join(LOG_DIR, log_file)
+            
         file_handler = RotatingFileHandler(
-            file_name,
+            log_file,
             maxBytes=10 * 1024 * 1024,  # 10MB
             backupCount=5,
             encoding='utf-8'
@@ -55,6 +82,9 @@ def get_logger(cls, name: str, log_file: Optional[str] = None) -> logging.Logger
         file_handler.setFormatter(formatter)
         logger.addHandler(file_handler)
 
+        # 清理旧日志文件
+        cls._cleanup_old_logs()
+        
         # 缓存日志器
         cls._loggers[name] = logger
 

config/settings.py

@@ -38,6 +38,7 @@ class BotConfig:
     TTS_ENDPOINT = os.getenv("TTS_ENDPOINT")
     TTS_VOICE_NAME = os.getenv("TTS_VOICE_NAME")
     TTS_OUTPUT_FORMAT = os.getenv("TTS_OUTPUT_FORMAT")
+    AUDIO_OUTPUT_DIR = os.getenv("AUDIO_OUTPUT_DIR")
 
     # 缘分居 API 端点
     YUANFENJU_ENDPOINTS = {