为各服务接口补 /// 中文注释：swagger 恢复中文说明（admin 203 / user 93 / customer 12 / fishgame 4）

AdminSrc/AdminApi/Controllers/ImageUploadController.cs

@@ -17,6 +17,9 @@ namespace AdminApi.Controllers
             _imageUploadService = imageUploadService;
         }
 
+        /// <summary>
+        /// 兼容现有前端的通用上传入口。有 name 时按编号覆盖，否则上传到临时目录。
+        /// </summary>
         [HttpPost("upload")]
         public async Task<IActionResult> UploadFile(IFormFile file, [FromQuery] string? name = null)
         {
@@ -29,6 +32,9 @@ namespace AdminApi.Controllers
                 : Json(this.ToFailResult<object>(result.errorMessage));
         }
 
+        /// <summary>
+        /// 上传公告等临时图片。业务数据保存成功后，由对应业务服务移动到正式目录。
+        /// </summary>
         [HttpPost("upload/temp")]
         public async Task<IActionResult> UploadTempFile(IFormFile file)
         {
@@ -38,6 +44,9 @@ namespace AdminApi.Controllers
                 : Json(this.ToFailResult<object>(result.errorMessage));
         }
 
+        /// <summary>
+        /// 上传道具、碎片等配置图片，按“编号.png”直接覆盖正式图片。
+        /// </summary>
         [HttpPost("upload/config")]
         public async Task<IActionResult> UploadConfigFile(IFormFile file, [FromQuery] string? number = null)
         {