docs: update project docs and evaluation history pagination

app/api/evaluations.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 
-from fastapi import APIRouter, Depends
+from fastapi import APIRouter, Depends, Query
 from fastapi.responses import FileResponse
 from sqlalchemy.orm import Session
 
@@ -15,9 +15,14 @@ router = APIRouter()
 
 
 @router.get("", response_model=ApiResponse[EvaluationListResponse])
-def list_evaluations(ctx: UserContext = Depends(get_user_context), db: Session = Depends(get_db)):
+def list_evaluations(
+    page: int = Query(default=1, ge=1, description="页码，从 1 开始"),
+    page_size: int = Query(default=10, ge=1, le=100, description="每页数量，最大 100"),
+    ctx: UserContext = Depends(get_user_context),
+    db: Session = Depends(get_db),
+):
     """历史评价：基于 user_id 查询完整训练后的评价记录。"""
-    return ok(EvaluationService(db).list_history(ctx.user_id))
+    return ok(EvaluationService(db).list_history(ctx.user_id, page=page, page_size=page_size))
 
 
 @router.get("/{evaluation_id}", response_model=ApiResponse[EvaluationDetailResponse])