docs: 完善参数注释与StyleCop配置

src/Api/TakeoutSaaS.MiniApi/Controllers/FilesController.cs

@@ -1,6 +1,4 @@
-using System.Linq;
 using Microsoft.AspNetCore.Authorization;
-using Microsoft.AspNetCore.Http;
 using Microsoft.AspNetCore.Mvc;
 using TakeoutSaaS.Application.Storage.Abstractions;
 using TakeoutSaaS.Application.Storage.Contracts;
@@ -22,6 +20,10 @@ public sealed class FilesController(IFileStorageService fileStorageService) : Ba
     /// <summary>
     /// 上传图片或文件。
     /// </summary>
+    /// <param name="file">上传文件。</param>
+    /// <param name="type">上传类型。</param>
+    /// <param name="cancellationToken">取消标记。</param>
+    /// <returns>上传结果，包含访问链接等信息。</returns>
     [HttpPost("upload")]
     [RequestFormLimits(MultipartBodyLengthLimit = 30 * 1024 * 1024)]
     [ProducesResponseType(typeof(ApiResponse<FileUploadResponse>), StatusCodes.Status200OK)]