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

UserSrc/UserApi/User/UserController.cs

@@ -25,6 +25,9 @@ namespace UserApi.User
             _userService = userService;
         }
 
+        /// <summary>
+        /// 实名认证
+        /// </summary>
         [HttpGet("RealNameAuth")]
         [Authorize]
         public async Task<BaseResponse<string>> RealNameAuth(string realName, string idCard)
@@ -36,6 +39,9 @@ namespace UserApi.User
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 修改名称
+        /// </summary>
         [HttpGet("UpdateUserName")]
         [Authorize]
         public async Task<BaseResponse<string>> UpdateUserName(string userName)
@@ -47,6 +53,9 @@ namespace UserApi.User
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 绑定微信
+        /// </summary>
         [HttpGet("BindWX")]
         [Authorize]
         public async Task<BaseResponse<string>> BindWX(string openId)
@@ -58,6 +67,9 @@ namespace UserApi.User
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 绑定手机号
+        /// </summary>
         [HttpGet("BindMobile")]
         [Authorize]
         public async Task<BaseResponse<string>> BindMobile(string mobile, string code)
@@ -69,6 +81,9 @@ namespace UserApi.User
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 更新头像
+        /// </summary>
         [HttpGet("UpdateAvatar")]
         [Authorize]
         public async Task<BaseResponse<string>> UpdateAvatar(string avatarUrl)
@@ -80,6 +95,9 @@ namespace UserApi.User
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 修改头像框
+        /// </summary>
         [HttpGet("UpdateAvatarFrame")]
         [Authorize]
         public async Task<BaseResponse<string>> UpdateAvatarFrame(string avatarFrame)
@@ -91,6 +109,9 @@ namespace UserApi.User
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 获取用户信息
+        /// </summary>
         [HttpGet("GetUser")]
         [Authorize]
         public async Task<BaseResponse<UserEntity>> GetUser(string userid)
@@ -101,6 +122,9 @@ namespace UserApi.User
             return this.ToResult(result);
         }
 
+        /// <summary>
+        /// 获取当前用户资产和背包
+        /// </summary>
         [HttpGet("GetUserAssets")]
         public async Task<BaseResponse<UserAssetsResponse>> GetUserAssets()
         {
@@ -113,6 +137,9 @@ namespace UserApi.User
             });
         }
 
+        /// <summary>
+        /// 获取用户列表（分页查询）
+        /// </summary>
         [HttpPost("GetUserList")]
         [Authorize]
         public async Task<PageResponse<UserListItemDto>> GetUserList(BaseListPageParam param)
@@ -130,6 +157,9 @@ namespace UserApi.User
             return this.ToPageResult(dtos, (int)result.count);
         }
 
+        /// <summary>
+        /// 发送邮件
+        /// </summary>
         [HttpPost("SendEmail")]
         [Authorize]
         public async Task<BaseResponse<string>> SendEmail(SendEmailParam param)
@@ -141,6 +171,9 @@ namespace UserApi.User
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 获取邮件详情（未读会变为已读）
+        /// </summary>
         [HttpGet("GetEmail")]
         [Authorize]
         public async Task<BaseResponse<EmailDto>> GetEmail(string id)
@@ -166,6 +199,9 @@ namespace UserApi.User
             return this.ToResult(dto);
         }
 
+        /// <summary>
+        /// 领取邮件奖励
+        /// </summary>
         [HttpGet("RewardEmail")]
         [Authorize]
         public async Task<BaseResponse<RewardEmailResponse>> RewardEmail(int type, string? id = "")
@@ -177,6 +213,9 @@ namespace UserApi.User
                 return this.ToFailResult<RewardEmailResponse>(result.msg);
         }
 
+        /// <summary>
+        /// 删除邮件
+        /// </summary>
         [HttpGet("DeleteEmail")]
         [Authorize]
         public async Task<BaseResponse<string>> DeleteEmail(int type, string? id = "")
@@ -188,6 +227,9 @@ namespace UserApi.User
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 一键阅读 - 把所有未读邮件标记为已读
+        /// </summary>
         [HttpGet("ReadEmailMore")]
         [Authorize]
         public async Task<BaseResponse<string>> ReadEmailMore()
@@ -199,6 +241,9 @@ namespace UserApi.User
                 return this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 获取未读邮件数量
+        /// </summary>
         [HttpGet("GetNoReadCount")]
         [Authorize]
         public async Task<BaseResponse<long>> GetNoReadCount()
@@ -207,6 +252,9 @@ namespace UserApi.User
             return this.ToResult(result);
         }
 
+        /// <summary>
+        /// 获取邮件列表（分页）
+        /// </summary>
         [HttpPost("GetEmailByPage")]
         [Authorize]
         public async Task<PageResponse<UserEmail>> GetEmailByPage(GetEmailPageParam param)
@@ -217,6 +265,9 @@ namespace UserApi.User
         }
 
 
+        /// <summary>
+        /// 获取捕鱼返利信息
+        /// </summary>
         [HttpGet("GetFishingReturnInfo")]
         [Authorize]
         public async Task<BaseResponse<FishingReturnDto>> GetFishingReturnInfo()
@@ -232,6 +283,9 @@ namespace UserApi.User
             return this.ToResult(dto);
         }
 
+        /// <summary>
+        /// 领取捕鱼返利金币
+        /// </summary>
         [HttpGet("ClaimFishingReturn")]
         [Authorize]
         public async Task<BaseResponse<ClaimFishingReturnDto>> ClaimFishingReturn()