改进列表查询, 增加多个可筛选字段

app/api/cards.py

@@ -119,20 +119,20 @@ def list_cards_detailed(
         max_detection_score: Optional[float] = Query(None, ge=0, le=10, description="筛选：最大检测分"),
         min_modified_score: Optional[float] = Query(None, ge=-100, le=10, description="筛选：最小修改分"),
         max_modified_score: Optional[float] = Query(None, ge=0, le=10, description="筛选：最大修改分"),
-        created_start: Optional[date] = Query(None, description="筛选：创建日期起始 (含)"),
+        created_start: Optional[date] = Query(None, description="筛选：创建日期起始 (含), 输入如:2025-10-01"),
         created_end: Optional[date] = Query(None, description="筛选：创建日期结束 (含)"),
         updated_start: Optional[date] = Query(None, description="筛选：更新日期起始 (含)"),
         updated_end: Optional[date] = Query(None, description="筛选：更新日期结束 (含)"),
         sort_by: SortBy = Query(SortBy.updated_at, description="排序字段"),
         sort_order: SortOrder = Query(SortOrder.desc, description="排序顺序"),
         skip: int = Query(0, ge=0, description="分页：跳过的记录数"),
-        page_num: int = Query(None, ge=0, description="分页：第n页(skip*limit)"),
+        page_num: int = Query(None, ge=1, description="分页：第n页: (page_num-1) * limit"),
         limit: int = Query(100, ge=1, le=1000, description="分页：每页的记录数"),
         db_conn: PooledMySQLConnection = db_dependency
 ):
     """获取卡牌的基础信息列表，支持按名称、类型筛选，以及多字段排序和分页。"""
     if page_num is not None:
-        skip = page_num * limit
+        skip = (page_num-1) * limit
     try:
         cards_with_images = crud_card.get_card_list_with_images(
             db_conn,