optimize+注释

backend/app/api/endpoints/events.py

@@ -1,4 +1,7 @@
-# app/api/endpoints/events.py
+# app/api/endpoints/events.py
+"""
+事件模块：统一事件列表、详情、搜索时间线（支持精确/语义/混合匹配）
+"""
 import json
 import os
 import time
@@ -74,6 +77,7 @@ def list_unified_events(
 ):
     """查询统一事件列表，并附带平台趋势与标签信息。"""
 
+    # 短期内存缓存，减轻高并发下数据库压力
     cache_key = f"{min_hot}:{hours}:{sort_by}:{skip}:{limit}"
     current_time = time.time()
     if cache_key in _UNIFIED_EVENTS_CACHE:
@@ -83,6 +87,7 @@ def list_unified_events(
 
     time_limit = utcnow() - timedelta(hours=hours)
 
+    # 按热度、时间过滤，再关联平台趋势、排名轨迹、标签
     base_query = db.query(UnifiedEvent).filter(
         UnifiedEvent.hot_score >= min_hot,
         UnifiedEvent.created_at >= time_limit,
@@ -328,6 +333,7 @@ def search_events_timeline(
     matched_event_ids: set[int] = set()
     matched_trend_points: list[tuple[int, str]] = []
 
+    # 遍历统一事件与平台趋势，按模式做精确/语义匹配
     for ev in all_recent_unified:
         text_matched = False
         if use_regex and pattern is not None: