保持下载量数据

router_items.py

@@ -397,6 +397,46 @@ async def record_item_view(item_id: str, current_user: str = Depends(require_aut
     return {"status": "success", "views": result["views"], "daily_views": result["daily_views"]}
 
 
+@router.post("/api/items/{item_id}/use")
+async def record_item_use(item_id: str, current_user: str = Depends(require_auth)):
+    """
+    记录资源使用量/下载量（原子操作，并发安全）
+    📥 每个用户对同一资源只计一次，防止重复计数
+    """
+    result_container = [None]
+    current_month = datetime.date.today().strftime("%Y-%m")
+    
+    def updater(data):
+        for item in data:
+            if item["id"] == item_id:
+                used_by = item.get("used_by", [])
+                if current_user in used_by:
+                    # 用户已使用过，不重复计数
+                    result_container[0] = {"status": "success", "action": "already_used", "uses": item.get("uses", 0)}
+                    return
+                # 首次使用，增加计数
+                used_by.append(current_user)
+                item["uses"] = item.get("uses", 0) + 1
+                # 更新月度使用历史
+                use_history = item.get("use_history", {})
+                use_history[current_month] = use_history.get(current_month, 0) + 1
+                item["use_history"] = use_history
+                item["used_by"] = used_by
+                result_container[0] = {"status": "success", "action": "recorded", "uses": item["uses"]}
+                return
+        result_container[0] = None  # 未找到资源
+    
+    db.atomic_update("items.json", updater, default_data=[])
+    
+    if result_container[0] is None:
+        raise HTTPException(status_code=404, detail="资源不存在")
+    
+    # 🗂️ 清除排序缓存（使用数变化可能影响排序）
+    sort_cache.invalidate("items:")
+    
+    return result_container[0]
+
+
 # ==========================================
 # ❤️ 互动接口（点赞/收藏）
 # ==========================================