Upload 2 files

history_manager.py

@@ -6,13 +6,13 @@ import traceback
 
 class UserHistoryManager:
     def __init__(self):
-        """初始化歷史紀錄管理器"""
+        """Initialize history record manager"""
         self.history_file = "user_history.json"
         print(f"Initializing UserHistoryManager with file: {os.path.abspath(self.history_file)}")
         self._init_file()
 
     def _init_file(self):
-        """初始化JSON檔案"""
+        """Initialize JSON file"""
         try:
             if not os.path.exists(self.history_file):
                 print(f"Creating new history file: {self.history_file}")
@@ -20,102 +20,155 @@ class UserHistoryManager:
                     json.dump([], f)
             else:
                 print(f"History file exists: {self.history_file}")
-                with open(self.history_file, 'r', encoding='utf-8') as f:
-                    data = json.load(f)
-                    print(f"Current history entries: {len(data)}")
+                # Added a check for empty file before loading
+                if os.path.getsize(self.history_file) > 0:
+                    with open(self.history_file, 'r', encoding='utf-8') as f:
+                        data = json.load(f)
+                        print(f"Current history entries: {len(data)}")
+                else:
+                    print("History file is empty.")
         except Exception as e:
             print(f"Error in _init_file: {str(e)}")
             print(traceback.format_exc())
 
-    def save_history(self, user_preferences: dict = None, results: list = None, search_type: str = "criteria", description: str = None) -> bool:
+    def save_history(self, user_preferences: dict = None, results: list = None, search_type: str = "criteria", description: str = None, user_description: str = None) -> bool:
         """
-        保存搜尋歷史，確保結果資料被完整保存
-        
-        Args:
-            user_preferences: 使用者的搜尋偏好設定
-            results: 品種推薦結果列表
-            search_type: 搜尋類型
-            description: 搜尋描述
-        
-        Returns:
-            bool: 保存是否成功
+        Save search history with complete result data
         """
         try:
-            # 初始化時區和當前時間
             taipei_tz = pytz.timezone('Asia/Taipei')
             current_time = datetime.now(taipei_tz)
-            
-            # 創建歷史紀錄項目並包含時間戳記
+
             history_entry = {
                 "timestamp": current_time.strftime("%Y-%m-%d %H:%M:%S"),
                 "search_type": search_type
             }
-            
-            # 確保結果資料的完整性
+
+            description_text = user_description or description
+            if search_type == "description" and description_text:
+                history_entry["user_description"] = description_text[:200] + "..." if len(description_text) > 200 else description_text
+
+            def _to_float(x, default=0.0):
+                try:
+                    return float(x)
+                except Exception:
+                    return default
+
+            def _to_int(x, default=0):
+                try:
+                    return int(x)
+                except Exception:
+                    return default
+
             if results and isinstance(results, list):
                 processed_results = []
-                for result in results[:15]:
-                    # 確保每個結果都包含必要的欄位
-                    if isinstance(result, dict):
-                        processed_result = {
-                            'breed': result.get('breed', 'Unknown'),
-                            'overall_score': result.get('overall_score', 0),
-                            'rank': result.get('rank', 0),
-                            'size': result.get('size', 'Unknown') 
-                        }
-                        processed_results.append(processed_result)
+                for i, r in enumerate(results[:15], start=1):
+                    processed_results.append({
+                        "breed": str(r.get("breed", "Unknown")),
+                        "rank": _to_int(r.get("rank", i)),
+                        # 先拿 overall_score，沒有就退 final_score，都轉成 float
+                        "overall_score": _to_float(r.get("overall_score", r.get("final_score", 0))),
+                        # 描述搜尋常見附加分，也一併安全轉型
+                        "semantic_score": _to_float(r.get("semantic_score", 0)),
+                        "comparative_bonus": _to_float(r.get("comparative_bonus", 0)),
+                        "lifestyle_bonus": _to_float(r.get("lifestyle_bonus", 0)),
+                        "size": str(r.get("size", "Unknown")),
+                    })
                 history_entry["results"] = processed_results
-            
-            # 加入使用者偏好設定（如果有的話）
-            if user_preferences:  
-                formatted_preferences = {
-                'living_space': user_preferences.get('living_space'),
-                'exercise_time': user_preferences.get('exercise_time'),
-                'grooming_commitment': user_preferences.get('grooming_commitment'),
-                'experience_level': user_preferences.get('experience_level'),  
-                'has_children': user_preferences.get('has_children'),
-                'noise_tolerance': user_preferences.get('noise_tolerance'),
-                'size_preference': user_preferences.get('size_preference')  
+
+            if user_preferences:
+                history_entry["preferences"] = {
+                    'living_space': user_preferences.get('living_space'),
+                    'exercise_time': user_preferences.get('exercise_time'),
+                    'grooming_commitment': user_preferences.get('grooming_commitment'),
+                    'experience_level': user_preferences.get('experience_level'),
+                    'has_children': user_preferences.get('has_children'),
+                    'noise_tolerance': user_preferences.get('noise_tolerance'),
+                    'size_preference': user_preferences.get('size_preference')
                 }
-                history_entry["preferences"] = user_preferences
-            
-            # 讀取現有歷史
-            with open(self.history_file, 'r', encoding='utf-8') as f:
-                history = json.load(f)
-            
-            # 加入新紀錄並保持歷史限制
+
+            try:
+                history = []
+                if os.path.exists(self.history_file) and os.path.getsize(self.history_file) > 0:
+                    with open(self.history_file, 'r', encoding='utf-8') as f:
+                        history = json.load(f)
+            except json.JSONDecodeError as e:
+                print(f"JSON decode error when reading history: {str(e)}")
+                backup_file = f"{self.history_file}.backup.{int(datetime.now().timestamp())}"
+                if os.path.exists(self.history_file):
+                    os.rename(self.history_file, backup_file)
+                    print(f"Backed up corrupted file to {backup_file}")
+                history = []
+
             history.append(history_entry)
-            if len(history) > 20:  # 保留最近 20 筆
-                history = history[-20:]
-            
-            # 儲存更新後的歷史
-            with open(self.history_file, 'w', encoding='utf-8') as f:
-                json.dump(history, f, ensure_ascii=False, indent=2)
-            
-            print(f"Successfully saved history entry: {history_entry}")
+            history = history[-20:] # Keep recent 20 entries
+
+            temp_file = f"{self.history_file}.tmp"
+            try:
+                with open(temp_file, 'w', encoding='utf-8') as f:
+                    json.dump(history, f, ensure_ascii=False, indent=2)
+                os.rename(temp_file, self.history_file)
+            except Exception as e:
+                if os.path.exists(temp_file):
+                    os.remove(temp_file)
+                raise
+
+            print(f"Successfully saved history entry for {search_type} search.")
             return True
-        
+
         except Exception as e:
             print(f"Error saving history: {str(e)}")
             print(traceback.format_exc())
             return False
 
-    
+    # get_history, clear_all_history, and format_history_for_display methods remain the same as you provided
     def get_history(self) -> list:
-        """獲取搜尋歷史"""
+        """Get search history"""
         try:
             print("Attempting to read history")  # Debug
-            with open(self.history_file, 'r', encoding='utf-8') as f:
-                data = json.load(f)
-                print(f"Read {len(data)} history entries")  # Debug
-                return data if isinstance(data, list) else []
+
+            # Check if file exists and is not empty
+            if not os.path.exists(self.history_file):
+                print("History file does not exist, creating empty file")
+                with open(self.history_file, 'w', encoding='utf-8') as f:
+                    json.dump([], f)
+                return []
+
+            # Check file size
+            if os.path.getsize(self.history_file) == 0:
+                print("History file is empty, initializing with empty array")
+                with open(self.history_file, 'w', encoding='utf-8') as f:
+                    json.dump([], f)
+                return []
+
+            # Try to read with error recovery
+            try:
+                with open(self.history_file, 'r', encoding='utf-8') as f:
+                    content = f.read().strip()
+                    if not content:
+                        print("File content is empty, returning empty list")
+                        return []
+                    data = json.loads(content)
+                    print(f"Read {len(data)} history entries")  # Debug
+                    return data if isinstance(data, list) else []
+            except json.JSONDecodeError as je:
+                print(f"JSON decode error: {str(je)}")
+                print(f"Corrupted content near position {je.pos}")
+                # Backup corrupted file and create new one
+                backup_file = f"{self.history_file}.backup"
+                os.rename(self.history_file, backup_file)
+                print(f"Backed up corrupted file to {backup_file}")
+                with open(self.history_file, 'w', encoding='utf-8') as f:
+                    json.dump([], f)
+                return []
+
         except Exception as e:
             print(f"Error reading history: {str(e)}")
             print(traceback.format_exc())
             return []
 
     def clear_all_history(self) -> bool:
-        """清除所有歷史紀錄"""
+        """Clear all history records"""
         try:
             print("Attempting to clear all history")  # Debug
             with open(self.history_file, 'w', encoding='utf-8') as f:
@@ -126,3 +179,158 @@ class UserHistoryManager:
             print(f"Error clearing history: {str(e)}")
             print(traceback.format_exc())
             return False
+
+    def format_history_for_display(self) -> str:
+        """
+        Format history records for HTML display
+
+        Returns:
+            str: Formatted HTML string
+        """
+        try:
+            history = self.get_history()
+
+            if not history:
+                return """
+                <div style="text-align: center; padding: 20px; color: #718096;">
+                    <p>No search history yet</p>
+                </div>
+                """
+
+            html_parts = []
+            html_parts.append("""
+                <div style="max-height: 400px; overflow-y: auto;">
+            """)
+
+            for i, entry in enumerate(reversed(history)):  # Latest entries first
+                search_type = entry.get('search_type', 'criteria')
+                timestamp = entry.get('timestamp', 'Unknown time')
+                results = entry.get('results', [])
+
+                # Set tag color based on search type
+                if search_type == 'description':
+                    tag_color = "#4299e1"  # Blue
+                    tag_bg = "rgba(66, 153, 225, 0.1)"
+                    tag_text = "Description Search"
+                    icon = "🤖"
+                else:
+                    tag_color = "#48bb78"  # Green
+                    tag_bg = "rgba(72, 187, 120, 0.1)"
+                    tag_text = "Criteria Search"
+                    icon = "🔍"
+
+                # Search content preview
+                preview_content = ""
+                if search_type == 'description':
+                    user_desc = entry.get('user_description', '')
+                    if user_desc:
+                        preview_content = f"Description: {user_desc}"
+                else:
+                    prefs = entry.get('preferences', {})
+                    if prefs:
+                        living = prefs.get('living_space', '')
+                        size = prefs.get('size_preference', '')
+                        exercise = prefs.get('exercise_time', '')
+                        preview_content = f"Living: {living}, Size: {size}, Exercise: {exercise}min"
+
+                # Result summary
+                result_summary = ""
+                if results:
+                    top_breeds = [r.get('breed', 'Unknown') for r in results[:3]]
+                    result_summary = f"Recommended: {', '.join(top_breeds)}"
+                    if len(results) > 3:
+                        result_summary += f" and {len(results)} breeds total"
+
+                html_parts.append(f"""
+                    <div style="
+                        border: 1px solid #e2e8f0;
+                        border-radius: 8px;
+                        padding: 12px;
+                        margin: 8px 0;
+                        background: white;
+                        box-shadow: 0 1px 3px rgba(0,0,0,0.1);
+                    ">
+                        <div style="display: flex; justify-content: between; align-items: center; margin-bottom: 8px;">
+                            <div style="
+                                background: {tag_bg};
+                                color: {tag_color};
+                                padding: 4px 8px;
+                                border-radius: 12px;
+                                font-size: 0.8em;
+                                font-weight: 600;
+                                display: inline-flex;
+                                align-items: center;
+                                gap: 4px;
+                            ">
+                                {icon} {tag_text}
+                            </div>
+                            <div style="font-size: 0.8em; color: #718096;">
+                                {timestamp}
+                            </div>
+                        </div>
+
+                        {f'<div style="font-size: 0.9em; color: #4a5568; margin: 4px 0;">{preview_content}</div>' if preview_content else ''}
+                        {f'<div style="font-size: 0.9em; color: #2d3748; font-weight: 500;">{result_summary}</div>' if result_summary else ''}
+                    </div>
+                """)
+
+            html_parts.append("</div>")
+
+            return ''.join(html_parts)
+
+        except Exception as e:
+            print(f"Error formatting history for display: {str(e)}")
+            return f"""
+            <div style="text-align: center; padding: 20px; color: #e53e3e;">
+                <p>Error loading history records: {str(e)}</p>
+            </div>
+            """
+
+    def get_search_statistics(self) -> dict:
+        """
+        Get search statistics information
+
+        Returns:
+            dict: Statistics information
+        """
+        try:
+            history = self.get_history()
+
+            stats = {
+                'total_searches': len(history),
+                'criteria_searches': 0,
+                'description_searches': 0,
+                'most_searched_breeds': {},
+                'search_frequency_by_day': {}
+            }
+
+            for entry in history:
+                search_type = entry.get('search_type', 'criteria')
+                if search_type == 'description':
+                    stats['description_searches'] += 1
+                else:
+                    stats['criteria_searches'] += 1
+
+                # Count breed search frequency
+                results = entry.get('results', [])
+                for result in results:
+                    breed = result.get('breed', 'Unknown')
+                    stats['most_searched_breeds'][breed] = stats['most_searched_breeds'].get(breed, 0) + 1
+
+                # Count search frequency by date
+                timestamp = entry.get('timestamp', '')
+                if timestamp:
+                    date = timestamp.split(' ')[0]
+                    stats['search_frequency_by_day'][date] = stats['search_frequency_by_day'].get(date, 0) + 1
+
+            return stats
+
+        except Exception as e:
+            print(f"Error getting search statistics: {str(e)}")
+            return {
+                'total_searches': 0,
+                'criteria_searches': 0,
+                'description_searches': 0,
+                'most_searched_breeds': {},
+                'search_frequency_by_day': {}
+            }

search_history.py

@@ -1,20 +1,20 @@
 import gradio as gr
 import traceback
-from typing import Optional, Dict, List
+from typing import  Optional , Dict , List
 from history_manager import UserHistoryManager
 
-class  SearchHistoryComponent :
-    def  __init__ ( self ):
+class SearchHistoryComponent:
+    def __init__(self):
         """初始化搜尋歷史組件"""
         self.history_manager = UserHistoryManager()
 
-    def  format_history_html ( self, history_data: Optional [ List [ Dict ]] = None ) -> str :
-        try :
-            if history_data is  None :
+    def format_history_html(self, history_data: Optional[List[Dict]] = None) -> str:
+        try:
+            if history_data is None:
                 history_data = self.history_manager.get_history()
 
-            if  not history_data:
-                return  """
+            if not history_data:
+                return """
                 <div style='text-align: center; padding: 40px 20px;'>
                     <p>No search history yet. Try making some breed recommendations!</p>
                 </div>
@@ -22,62 +22,115 @@ class  SearchHistoryComponent :
 
             html = "<div class='history-container'>"
 
-            # 對歷史記錄進行反轉，最新的顯示在前面
-            for entry in  reversed (history_data):
-                timestamp = entry.get( 'timestamp' , 'Unknown time' )
-                search_type = entry.get( 'search_type' , 'criteria' )
-                results = entry.get( 'results' , [])
-
-                # 顯示時間戳記和搜尋類型
+            # 最新的顯示在前面
+            for entry in reversed(history_data):
+                timestamp = entry.get('timestamp', 'Unknown time')
+                search_type = entry.get('search_type', 'criteria')
+                results = entry.get('results', [])
+
+                # 標籤樣式
+                if search_type == "description":
+                    border_color = "#4299e1"
+                    tag_color = "#4299e1"
+                    tag_bg = "rgba(66, 153, 225, 0.1)"
+                    tag_text = "Description Search"
+                    icon = "🤖"
+                else:
+                    border_color = "#48bb78"
+                    tag_color = "#48bb78"
+                    tag_bg = "rgba(72, 187, 120, 0.1)"
+                    tag_text = "Criteria Search"
+                    icon = "🔍"
+
+                # header
                 html += f"""
                 <div class="history-entry">
-                    <div class="history-header" style="border-left: 4px solid #4299e1; padding-left: 10px;">
-                        <span class="timestamp">🕒 {timestamp} </span>
-                        <span class="search-type" style="color: #4299e1; font-weight: bold; margin-left: 10px;">
-                            Search History
+                    <div class="history-header" style="border-left: 4px solid {border_color}; padding-left: 10px;">
+                        <span class="timestamp">🕒 {timestamp}</span>
+                        <span class="search-type" style="
+                            background: {tag_bg};
+                            color: {tag_color};
+                            padding: 4px 8px;
+                            border-radius: 12px;
+                            font-size: 0.8em;
+                            font-weight: 600;
+                            margin-left: 10px;
+                            display: inline-flex;
+                            align-items: center;
+                            gap: 4px;
+                        ">
+                            {icon} {tag_text}
                         </span>
                     </div>
                 """
 
-                # 顯示搜尋參數
-                if search_type == "criteria" :
-                    prefs = entry.get( 'preferences' , {})
+                # 參數/描述
+                if search_type == "criteria":
+                    prefs = entry.get('preferences', {})
                     html += f"""
                     <div class="params-list" style="background: #f8fafc; padding: 16px; border-radius: 8px; margin-bottom: 16px;">
                         <h4 style="margin-bottom: 12px;">Search Parameters:</h4>
                         <ul style="display: grid; grid-template-columns: repeat(2, 1fr); gap: 12px;">
-                            <li>Living Space: {prefs.get( 'living_space' , 'N/A' )} </li>
-                            <li>Exercise Time: {prefs.get( 'exercise_time' , 'N/A' )} minutes</li>
-                            <li>Grooming: {prefs.get( 'grooming_commitment' , 'N/A' )} </li>
-                            <li>Size Preference: {prefs.get( 'size_preference' , 'N/A' )} </li>
-                            <li>Experience: {prefs.get( 'experience_level' , 'N/A' )} </li>
-                            <li>Children at Home: { "Yes"  if prefs.get( 'has_children' ) else  "No" } </li>
-                            <li>Noise Tolerance: {prefs.get( 'noise_tolerance' , 'N/A' )} </li>
+                            <li>Living Space: {prefs.get('living_space', 'N/A')}</li>
+                            <li>Exercise Time: {prefs.get('exercise_time', 'N/A')} minutes</li>
+                            <li>Grooming: {prefs.get('grooming_commitment', 'N/A')}</li>
+                            <li>Size Preference: {prefs.get('size_preference', 'N/A')}</li>
+                            <li>Experience: {prefs.get('experience_level', 'N/A')}</li>
+                            <li>Children at Home: {"Yes" if prefs.get('has_children') else "No"}</li>
+                            <li>Noise Tolerance: {prefs.get('noise_tolerance', 'N/A')}</li>
                         </ul>
                     </div>
                     """
+                elif search_type == "description":
+                    description = entry.get('user_description', '')
+                    html += f"""
+                    <div class="params-list" style="background: #f0f8ff; padding: 16px; border-radius: 8px; margin-bottom: 16px; border: 1px solid rgba(66, 153, 225, 0.2);">
+                        <h4 style="margin-bottom: 12px; color: #4299e1;">User Description:</h4>
+                        <div style="
+                            background: white;
+                            padding: 12px;
+                            border-radius: 6px;
+                            border-left: 3px solid #4299e1;
+                            font-style: italic;
+                            color: #2d3748;
+                            line-height: 1.5;
+                        ">
+                            "{description}"
+                        </div>
+                    </div>
+                    """
 
-                # 關鍵修改：確保結果部分始終顯示
-                if results:   # 只有在有結果時才顯示結果區域
+                # 結果區
+                if results:
                     html += """
                     <div class="results-list" style="margin-top: 16px;">
                         <h4 style="margin-bottom: 12px;">Top 15 Breed Matches:</h4>
                         <div class="breed-list">
                     """
 
-                    # 顯示每個推薦結果
-                    for i, result in  enumerate (results[: 15 ], 1 ):
-                        breed = result.get( 'breed' , 'Unknown breed' )
-                        score = result.get( 'overall_score' , 0 )   # 改用overall_score
-                        if  isinstance (score, ( int , float )):   # 確保分數是數字
-                            score = float (score) * 100   # 轉換為百分比
+                    for i, result in enumerate(results[:15], 1):
+                        breed = result.get('breed', 'Unknown breed')
+
+                        # ★ 分數回退順序：final_score → overall_score → semantic_score
+                        score_val = (
+                            result.get('final_score', None)
+                            if result.get('final_score', None) not in [None, ""]
+                            else result.get('overall_score', None)
+                        )
+                        if score_val in [None, ""]:
+                            score_val = result.get('semantic_score', 0)
+
+                        try:
+                            score_pct = float(score_val) * 100.0
+                        except Exception:
+                            score_pct = 0.0
 
                         html += f"""
                         <div class="breed-item" style="margin-bottom: 8px;">
                             <div class="breed-info" style="display: flex; align-items: center; justify-content: space-between; padding: 8px; background: #f8fafc; border-radius: 6px;">
                                 <span class="breed-rank" style="background: linear-gradient(135deg, #4299e1, #48bb78); color: white; padding: 4px 10px; border-radius: 6px; font-weight: 600; min-width: 40px; text-align: center;">#{i}</span>
                                 <span class="breed-name" style="font-weight: 500; color: #2D3748; margin: 0 12px;">{breed.replace('_', ' ')}</span>
-                                <span class="breed-score" style="background: #F0FFF4; color: #48BB78; padding: 4px 8px; border-radius: 4px; font-weight: 600;">{score:.1f}%</span>
+                                <span class="breed-score" style="background: #F0FFF4; color: #48BB78; padding: 4px 8px; border-radius: 4px; font-weight: 600;">{score_pct:.1f}%</span>
                             </div>
                         </div>
                         """
@@ -87,86 +140,50 @@ class  SearchHistoryComponent :
                     </div>
                     """
 
-                html += "</div>"   # 關閉history-entry div
+                html += "</div>"  # 關閉 .history-entry
 
-            html += "</div>"   # 關閉history-container div
+            html += "</div>"  # 關閉 .history-container
             return html
 
         except Exception as e:
-            print ( f"Error formatting history: { str (e)} " )
-            print (traceback.format_exc())
-            return  f"""
+            print(f"Error formatting history: {str(e)}")
+            print(traceback.format_exc())
+            return f"""
             <div style='text-align: center; padding: 20px; color: #dc2626;'>
                 Error formatting history. Please try refreshing the page.
-                <br>Error details: { str (e)}
+                <br>Error details: {str(e)}
             </div>
             """
 
-    def  clear_history ( self ) -> str :
-        """清除所有搜尋紀錄"""
-        try :
+    def clear_history(self) -> str:
+        try:
             success = self.history_manager.clear_all_history()
-            print ( f"Clear history result: {success} " )
+            print(f"Clear history result: {success}")
             return self.format_history_html()
         except Exception as e:
-            print ( f"Error in clear_history: { str (e)} " )
-            print (traceback.format_exc())
-            return  "Error clearing history"
+            print(f"Error in clear_history: {str(e)}")
+            print(traceback.format_exc())
+            return "Error clearing history"
 
-    def  refresh_history ( self ) -> str :
-        """刷新歷史記錄顯示"""
-        try :
+    def refresh_history(self) -> str:
+        try:
             return self.format_history_html()
         except Exception as e:
-            print ( f"Error in refresh_history: { str (e)} " )
-            return  "Error refreshing history"
-
-    def  save_search ( self, user_preferences: Optional [ dict ] = None ,
-                results: list = None ,
-                search_type: str = "criteria" ,
-                description: str = None ) -> bool :
-        """
-        儲存搜尋結果到歷史記錄
-        這個方法負責處理搜尋結果的保存，並確保只保存前15個最相關的推薦結果。
-        在儲存之前，會處理結果資料確保格式正確且包含所需的所有資訊。
-        Args:
-            user_preferences: 使用者偏好設定(僅用於criteria搜尋)
-                包含所有搜尋條件如居住空間、運動時間等
-            results: 推薦結果列表
-                包含所有推薦的狗品種及其評分
-            search_type: 搜尋類型("criteria" 或"description")
-                用於標識搜尋方式
-            description: 用戶輸入的描述(僅用於description搜尋)
-                用於自然語言搜尋時的描述文本
-
-        Returns:
-            bool: 表示保存是否成功
-        """
-        # 首先確保結果不為空且為列表
-        if results and  isinstance (results, list ):
-            # 只取前15個結果
-            processed_results = []
-            for result in results[: 15 ]:   # 限制為前15個結果
-                # 確保每個結果都包含必要的信息
-                if  isinstance (result, dict ):
-                    processed_result = {
-                        'breed' : result.get( 'breed' , 'Unknown' ),
-                        'overall_score' : result.get( 'overall_score' , result.get( 'final_score' , 0 )),
-                        'rank' : result.get( 'rank' , 0 ),
-                        'base_score' : result.get( 'base_score' , 0 ),
-                        'bonus_score' : result.get( 'bonus_score' , 0 ),
-                        'scores' : result.get( 'scores' , {})
-                    }
-                    processed_results.append(processed_result)
-        else :
-            # 如果沒有結果，創建空列表
-            processed_results = []
-
-        # 調用history_manager 的save_history 方法保存處理過的結果
+            print(f"Error in refresh_history: {str(e)}")
+            return "Error refreshing history"
+
+    def save_search(self,
+                    user_preferences: Optional[dict] = None,
+                    results: list = None,
+                    search_type: str = "criteria",
+                    description: str = None) -> bool:
+        """參數原樣透傳給 history_manager"""
         return self.history_manager.save_history(
             user_preferences=user_preferences,
-            results=processed_results,   # 使用處理過的結果
-            search_type= 'criteria'
+            results=results,
+            search_type=search_type,
+            description=description,
+            user_description=description
         )
 
 def  create_history_component ():
@@ -272,7 +289,7 @@ def  create_history_tab ( history_component: SearchHistoryComponent ):
 
         with gr.Row():
             with gr.Column(scale= 4 ):
-                history_display = gr.HTML()
+                history_display = gr.HTML(value=history_component.format_history_html())
                 with gr.Row(equal_height= True ):
                     with gr.Column(scale= 1 ):
                         clear_history_btn = gr.Button(
@@ -287,8 +304,6 @@ def  create_history_tab ( history_component: SearchHistoryComponent ):
                             elem_classes= "custom-btn refresh-btn"
                         )
 
-                history_display.value = history_component.format_history_html()
-
                 clear_history_btn.click(
                     fn=history_component.clear_history,
                     outputs=[history_display],
@@ -299,4 +314,4 @@ def  create_history_tab ( history_component: SearchHistoryComponent ):
                     fn=history_component.refresh_history,
                     outputs=[history_display],
                     api_name= "refresh_history"
-                )
+                )