feat: 更新模块文档，添加详细说明和使用示例

src/minenasai/webtui/server.py

@@ -7,13 +7,14 @@ from __future__ import annotations
 
 import asyncio
 import uuid
+from collections.abc import AsyncGenerator
 from contextlib import asynccontextmanager
 from pathlib import Path
-from typing import Any, AsyncGenerator
+from typing import Any
 
 from fastapi import FastAPI, WebSocket, WebSocketDisconnect
 from fastapi.middleware.cors import CORSMiddleware
-from fastapi.responses import FileResponse, HTMLResponse
+from fastapi.responses import HTMLResponse
 from fastapi.staticfiles import StaticFiles
 
 from minenasai.core import get_logger, get_settings, setup_logging
@@ -95,8 +96,12 @@ manager = ConnectionManager()
 
 
 @asynccontextmanager
-async def lifespan(app: FastAPI) -> AsyncGenerator[None, None]:
-    """应用生命周期管理"""
+async def lifespan(_app: FastAPI) -> AsyncGenerator[None, None]:
+    """应用生命周期管理
+
+    Args:
+        _app: FastAPI 应用实例（lifespan 标准签名要求）
+    """
     settings = get_settings()
     setup_logging(settings.logging)
     logger.info("Web TUI 服务启动", port=settings.webtui.port)