1. Translator 类增强

添加 ThreadPoolExecutor 线程池用于异步翻译修改 translate_multi() 方法，支持 async_mode 参数（默认 True）添加 _get_cached_translation() 方法，快速获取缓存添加 _translate_async() 方法，异步执行翻译任务 2. 异步翻译逻辑命中缓存：立即返回缓存结果未命中缓存：异步启动翻译任务（不阻塞）返回 None（本次查询不使用）翻译完成后自动存入缓存下次查询时可直接使用缓存结果 3. QueryParser 更新调用 translate_multi() 时使用 async_mode=True 过滤掉 None 值（未完成的翻译）优化日志输出，区分缓存命中和异步翻译工作流程首次查询：未命中缓存 → 异步翻译 → 返回空翻译 → 不阻塞翻译完成：结果存入缓存后续查询：命中缓存 → 立即返回 → 快速响应

1. Translator 类增强
添加 ThreadPoolExecutor 线程池用于异步翻译修改 translate_multi() 方法，支持 async_mode 参数（默认 True）添加 _get_cached_translation() 方法，快速获取缓存添加 _translate_async() 方法，异步执行翻译任务 2. 异步翻译逻辑命中缓存：立即返回缓存结果未命中缓存：异步启动翻译任务（不阻塞）返回 None（本次查询不使用）翻译完成后自动存入缓存下次查询时可直接使用缓存结果 3. QueryParser 更新调用 translate_multi() 时使用 async_mode=True 过滤掉 None 值（未完成的翻译）优化日志输出，区分缓存命中和异步翻译工作流程首次查询：未命中缓存 → 异步翻译 → 返回空翻译 → 不阻塞翻译完成：结果存入缓存后续查询：命中缓存 → 立即返回 → 快速响应
tangwang
1 parent 7bc756c5
Showing 2 changed files with 89 additions and 7 deletions Show diff stats
query/query_parser.py
query/translator.py
@@ -214,7 +214,7 @@ class QueryParser:
         if context:
             context.store_intermediate_result('detected_language', detected_lang)
-        # Stage 4: Translation
+        # Stage 4: Translation (async mode - only returns cached results, missing ones translated in background)
         translations = {}
         if self.config.query_config.enable_translation:
             try:
@@ -228,16 +228,24 @@ class QueryParser:
                 )
                 if target_langs:
-                    log_info(f"开始翻译 | 源语言: {detected_lang} | 目标语言: {target_langs}")
                     # Use e-commerce context for better disambiguation
                     translation_context = 'e-commerce product search'
+                    # Use async mode: returns cached translations immediately, missing ones translated in background
                     translations = self.translator.translate_multi(
                         query_text,
                         target_langs,
                         source_lang=detected_lang,
-                        context=translation_context
+                        context=translation_context,
+                        async_mode=True
                     )
-                    log_info(f"翻译完成 | 结果: {translations}")
+                    # Filter out None values (missing translations that are being processed async)
+                    translations = {k: v for k, v in translations.items() if v is not None}
+                    
+                    if translations:
+                        log_info(f"翻译完成（缓存命中） | 结果: {translations}")
+                    else:
+                        log_debug(f"翻译未命中缓存，异步翻译中...")
+                    
                     if context:
                         context.store_intermediate_result('translations', translations)
                         for lang, translation in translations.items():
@@ -5,8 +5,13 @@ Supports DeepL API for high-quality translations.
 """
 import requests
+import threading
+from concurrent.futures import ThreadPoolExecutor
 from typing import Dict, List, Optional
 from utils.cache import DictCache
+import logging
+
+logger = logging.getLogger(__name__)
 # Try to import DEEPL_AUTH_KEY, but allow import to fail
 try:
@@ -66,6 +71,12 @@ class Translator:
             self.cache = DictCache(".cache/translations.json")
         else:
             self.cache = None
+        
+        # Thread pool for async translation
+        self.executor = ThreadPoolExecutor(max_workers=2, thread_name_prefix="translator")
+        
+        # Thread pool for async translation
+        self.executor = ThreadPoolExecutor(max_workers=2, thread_name_prefix="translator")
     def translate(
         self,
@@ -266,24 +277,87 @@ class Translator:
         text: str,
         target_langs: List[str],
         source_lang: Optional[str] = None,
-        context: Optional[str] = None
+        context: Optional[str] = None,
+        async_mode: bool = True
     ) -> Dict[str, Optional[str]]:
         """
         Translate text to multiple target languages.
+        
+        In async_mode=True (default):
+        - Returns cached translations immediately if available
+        - Launches async tasks for missing translations (non-blocking)
+        - Returns None for missing translations (will be available in cache next time)
+        
+        In async_mode=False:
+        - Waits for all translations to complete (blocking)
         Args:
             text: Text to translate
             target_langs: List of target language codes
             source_lang: Source language code (optional)
             context: Context hint for translation (optional)
+            async_mode: If True, return cached results immediately and translate missing ones async
         Returns:
-            Dictionary mapping language code to translated text
+            Dictionary mapping language code to translated text (only cached results in async mode)
         """
         results = {}
+        missing_langs = []
+        
+        # First, get cached translations
         for lang in target_langs:
-            results[lang] = self.translate(text, lang, source_lang, context)
+            cached = self._get_cached_translation(text, lang, source_lang, context)
+            if cached is not None:
+                results[lang] = cached
+            else:
+                missing_langs.append(lang)
+        
+        # If async mode and there are missing translations, launch async tasks
+        if async_mode and missing_langs:
+            for lang in missing_langs:
+                self._translate_async(text, lang, source_lang, context)
+            # Return None for missing translations
+            for lang in missing_langs:
+                results[lang] = None
+        else:
+            # Synchronous mode: wait for all translations
+            for lang in missing_langs:
+                results[lang] = self.translate(text, lang, source_lang, context)
+        
         return results
+    
+    def _get_cached_translation(
+        self,
+        text: str,
+        target_lang: str,
+        source_lang: Optional[str] = None,
+        context: Optional[str] = None
+    ) -> Optional[str]:
+        """Get translation from cache if available."""
+        if not self.cache:
+            return None
+        
+        translation_context = context or self.translation_context
+        cache_key = f"{source_lang or 'auto'}:{target_lang}:{translation_context}:{text}"
+        return self.cache.get(cache_key, category="translations")
+    
+    def _translate_async(
+        self,
+        text: str,
+        target_lang: str,
+        source_lang: Optional[str] = None,
+        context: Optional[str] = None
+    ):
+        """Launch async translation task."""
+        def _do_translate():
+            try:
+                result = self.translate(text, target_lang, source_lang, context)
+                if result:
+                    logger.debug(f"Async translation completed: {text} -> {target_lang}: {result}")
+            except Exception as e:
+                logger.warning(f"Async translation failed: {text} -> {target_lang}: {e}")
+        
+        self.executor.submit(_do_translate)
     def _add_ecommerce_context(
         self,