为各服务接口补 /// 中文注释：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)
         {

AdminSrc/AdminApi/Controllers/OperationLogController.cs

@@ -28,6 +28,9 @@ namespace AdminApi.Controllers
             _logRepo = logRepo;
         }
 
+        /// <summary>
+        /// 分页查询操作日志
+        /// </summary>
         [HttpPost("list")]
         public async Task<PageResponse<OperationLogDto>> GetList([FromBody] OperationLogQueryParam param)
         {
@@ -38,6 +41,9 @@ namespace AdminApi.Controllers
             return this.ToPageResult(dtos, (int)count);
         }
 
+        /// <summary>
+        /// 获取所有管理员（下拉选择用）
+        /// </summary>
         [HttpGet("admins")]
         public async Task<BaseResponse<List<AdminOptionDto>>> GetAdmins()
         {
@@ -46,6 +52,9 @@ namespace AdminApi.Controllers
             return this.ToResult(result);
         }
 
+        /// <summary>
+        /// 获取所有模块（下拉选择用）
+        /// </summary>
         [HttpGet("modules")]
         public BaseResponse<List<ModuleOptionDto>> GetModules()
         {
@@ -55,6 +64,9 @@ namespace AdminApi.Controllers
             return this.ToResult(modules);
         }
 
+        /// <summary>
+        /// 删除操作日志
+        /// </summary>
         [HttpPost("Delete")]
         public async Task<BaseResponse<string>> Delete(string id)
         {
@@ -65,6 +77,9 @@ namespace AdminApi.Controllers
                 return this.ToFailResult<string>("删除失败");
         }
 
+        /// <summary>
+        /// 批量删除操作日志
+        /// </summary>
         [HttpPost("BatchDelete")]
         public async Task<BaseResponse<string>> BatchDelete([FromBody] List<string> ids)
         {