docs(api): add api docs

app/router/v2/misc.py

@@ -10,15 +10,28 @@ from pydantic import BaseModel
 
 
 class Background(BaseModel):
+    """季节背景图单项。
+    - url: 图片链接地址。"""
+
     url: str
 
 
 class BackgroundsResp(BaseModel):
+    """季节背景图返回模型。
+    - ends_at: 结束时间（若为远未来表示长期有效）。
+    - backgrounds: 背景图列表。"""
+
     ends_at: datetime = datetime(year=9999, month=12, day=31, tzinfo=UTC)
     backgrounds: list[Background]
 
 
-@router.get("/seasonal-backgrounds", response_model=BackgroundsResp)
+@router.get(
+    "/seasonal-backgrounds",
+    response_model=BackgroundsResp,
+    tags=["杂项"],
+    name="获取季节背景图列表",
+    description="获取当前季节背景图列表。",
+)
 async def get_seasonal_backgrounds():
     return BackgroundsResp(
         backgrounds=[Background(url=url) for url in settings.seasonal_backgrounds]