feat: 完善统一端点响应与请求绑定框架

- 新增 IApiResponse 统一响应契约，覆盖普通响应和分页响应
- 扩展端点映射，支持 IApiResponse 和带请求 DTO 的 MapXxx 重载
- 增加 Body、Query、Route Values 到请求 DTO 的自动绑定
- 增加 PC 端路由模式匹配，支持 {id} 和 {id:int}
- API 与 PC 端点上下文补充路由参数传递
- 调整 OpenAPI 请求类型处理，避免 GET/DELETE 被标记为 JSON Body
- 鉴权端点迁移到强类型请求绑定和 IApiResponse 返回
- 增加统一端点文件流响应支持

Avalonia-API/Authentication/ApiAuthEndpointService.cs

@@ -4,7 +4,6 @@ using Avalonia_EFCore.Models;
 using Avalonia_Services.Core;
 using Avalonia_Services.Services.AuthService;
 using Microsoft.EntityFrameworkCore;
-using System.Text.Json;
 
 namespace Avalonia_API.Authentication
 {
@@ -17,21 +16,15 @@ namespace Avalonia_API.Authentication
         JwtTokenService jwtTokenService,
         RefreshTokenService refreshTokenService) : IApiAuthEndpointService
     {
-        private static readonly JsonSerializerOptions JsonOptions = new()
-        {
-            PropertyNameCaseInsensitive = true,
-        };
-
         /// <summary>
         /// 处理用户登录请求。根据账号（邮箱或用户名）查找或创建用户，
         /// 生成 JWT Access Token 和 Refresh Token 并返回。
         /// </summary>
         /// <param name="ctx">服务端点上下文，包含请求体、请求头等信息。</param>
         /// <returns>包含 AccessToken、RefreshToken 及过期时间的认证响应。</returns>
-        public async Task<object?> LoginAsync(ServiceEndpointContext ctx)
+        public async Task<IApiResponse> LoginAsync(ApiLoginRequest request, ServiceEndpointContext ctx)
         {
-            var request = Deserialize<ApiLoginRequest>(ctx.Body);
-            if (string.IsNullOrWhiteSpace(request?.Account))
+            if (string.IsNullOrWhiteSpace(request.Account))
             {
                 ctx.StatusCode = 400;
                 return ResponseHelper.Failure(400, "账号不能为空");
@@ -72,11 +65,10 @@ namespace Avalonia_API.Authentication
         /// </summary>
         /// <param name="ctx">服务端点上下文，包含请求体中的 RefreshToken。</param>
         /// <returns>新的 Token 对；若 Refresh Token 无效则返回 401 错误。</returns>
-        public async Task<object?> RefreshAsync(ServiceEndpointContext ctx)
+        public async Task<IApiResponse> RefreshAsync(ApiRefreshTokenRequest request, ServiceEndpointContext ctx)
         {
-            var request = Deserialize<ApiRefreshTokenRequest>(ctx.Body);
             var rotated = await refreshTokenService.RotateAsync(
-                request?.RefreshToken,
+                request.RefreshToken,
                 ctx.GetHeader("User-Agent"),
                 GetRemoteIpAddress(ctx));
 
@@ -109,26 +101,12 @@ namespace Avalonia_API.Authentication
         /// </summary>
         /// <param name="ctx">服务端点上下文，包含请求体中的 RefreshToken。</param>
         /// <returns>登出成功的响应。</returns>
-        public async Task<object?> LogoutAsync(ServiceEndpointContext ctx)
+        public async Task<IApiResponse> LogoutAsync(ApiLogoutRequest request, ServiceEndpointContext ctx)
         {
-            var request = Deserialize<ApiLogoutRequest>(ctx.Body);
-            await refreshTokenService.RevokeAsync(request?.RefreshToken);
+            await refreshTokenService.RevokeAsync(request.RefreshToken);
             return ResponseHelper.Succeed("退出成功");
         }
 
-        /// <summary>
-        /// 将 JSON 请求体反序列化为指定类型。
-        /// </summary>
-        /// <typeparam name="T">目标类型。</typeparam>
-        /// <param name="body">JSON 请求体字符串，可为空。</param>
-        /// <returns>反序列化后的对象；若 body 为空则返回默认值。</returns>
-        private static T? Deserialize<T>(string? body)
-        {
-            return string.IsNullOrWhiteSpace(body)
-                ? default
-                : JsonSerializer.Deserialize<T>(body, JsonOptions);
-        }
-
         /// <summary>
         /// 从上下文的 Items 中提取 ASP.NET Core HttpContext，并获取客户端远程 IP 地址。
         /// </summary>