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

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

Avalonia-Services/Services/AuthService/AuthEndpointServices.cs

@@ -1,3 +1,4 @@
+using Avalonia_Common.Core;
 using Avalonia_Services.Core;
 using System.Threading.Tasks;
 
@@ -13,21 +14,21 @@ namespace Avalonia_Services.Services.AuthService
         /// </summary>
         /// <param name="ctx">服务端点上下文。</param>
         /// <returns>包含 Token 的认证响应。</returns>
-        Task<object?> LoginAsync(ServiceEndpointContext ctx);
+        Task<IApiResponse> LoginAsync(ApiLoginRequest request, ServiceEndpointContext ctx);
 
         /// <summary>
         /// 使用 Refresh Token 刷新 Access Token。
         /// </summary>
         /// <param name="ctx">服务端点上下文。</param>
         /// <returns>新的 Token 对。</returns>
-        Task<object?> RefreshAsync(ServiceEndpointContext ctx);
+        Task<IApiResponse> RefreshAsync(ApiRefreshTokenRequest request, ServiceEndpointContext ctx);
 
         /// <summary>
         /// 处理用户登出请求。
         /// </summary>
         /// <param name="ctx">服务端点上下文。</param>
         /// <returns>登出结果。</returns>
-        Task<object?> LogoutAsync(ServiceEndpointContext ctx);
+        Task<IApiResponse> LogoutAsync(ApiLogoutRequest request, ServiceEndpointContext ctx);
     }
 
     /// <summary>
@@ -40,20 +41,20 @@ namespace Avalonia_Services.Services.AuthService
         /// </summary>
         /// <param name="ctx">服务端点上下文。</param>
         /// <returns>包含 Token 的认证响应。</returns>
-        Task<object?> AuthorizeAsync(ServiceEndpointContext ctx);
+        Task<IApiResponse> AuthorizeAsync(PcAuthorizeRequest request, ServiceEndpointContext ctx);
 
         /// <summary>
         /// 刷新当前 Token。
         /// </summary>
         /// <param name="ctx">服务端点上下文。</param>
         /// <returns>新的 Token 响应。</returns>
-        Task<object?> RefreshAsync(ServiceEndpointContext ctx);
+        Task<IApiResponse> RefreshAsync(PcRefreshRequest request, ServiceEndpointContext ctx);
 
         /// <summary>
         /// 处理用户登出请求。
         /// </summary>
         /// <param name="ctx">服务端点上下文。</param>
         /// <returns>登出结果。</returns>
-        Task<object?> LogoutAsync(ServiceEndpointContext ctx);
+        Task<IApiResponse> LogoutAsync(PcLogoutRequest request, ServiceEndpointContext ctx);
     }
 }