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

AdminSrc/AdminApi/Customer/CustomerController.cs

@@ -22,6 +22,9 @@ namespace AdminApi.Customer
             _customerService = customerService;
         }
 
+        /// <summary>
+        /// 获取客服列表
+        /// </summary>
         [HttpGet("list")]
         public async Task<PageResponse<CustomerDto>> GetCustomerList([FromQuery] GetCustomerListParam param)
         {
@@ -30,6 +33,9 @@ namespace AdminApi.Customer
             return this.ToPageResult(dtos, result.total);
         }
 
+        /// <summary>
+        /// 根据ID获取客服详情
+        /// </summary>
         [HttpGet("{id}")]
         public async Task<BaseResponse<CustomerDto>> GetCustomerById(string id)
         {
@@ -38,6 +44,9 @@ namespace AdminApi.Customer
             return this.ToResult(dto);
         }
 
+        /// <summary>
+        /// 添加新客服
+        /// </summary>
         [HttpPost]
         public async Task<BaseResponse<CustomerDto>> AddCustomer([FromBody] AddCustomerParam param)
         {
@@ -53,6 +62,9 @@ namespace AdminApi.Customer
             }
         }
 
+        /// <summary>
+        /// 更新客服信息
+        /// </summary>
         [HttpPut]
         public async Task<BaseResponse<string>> UpdateCustomer([FromBody] UpdateCustomerParam param)
         {
@@ -67,6 +79,9 @@ namespace AdminApi.Customer
             }
         }
 
+        /// <summary>
+        /// 删除客服
+        /// </summary>
         [HttpDelete("{id}")]
         public async Task<BaseResponse<string>> DeleteCustomer(string id)
         {
@@ -81,6 +96,9 @@ namespace AdminApi.Customer
             }
         }
 
+        /// <summary>
+        /// 获取会话列表
+        /// </summary>
         [HttpGet("conversations")]
         public async Task<PageResponse<ConversationDto>> GetConversationList([FromQuery] GetConversationListParam param)
         {
@@ -89,6 +107,9 @@ namespace AdminApi.Customer
             return this.ToPageResult(dtos, result.total);
         }
 
+        /// <summary>
+        /// 根据ID获取会话详情
+        /// </summary>
         [HttpGet("conversation/{id}")]
         public async Task<BaseResponse<ConversationDto>> GetConversationById(string id)
         {
@@ -97,6 +118,9 @@ namespace AdminApi.Customer
             return this.ToResult(dto);
         }
 
+        /// <summary>
+        /// 删除会话及全部关联聊天记录。
+        /// </summary>
         [HttpDelete("conversation/{id}")]
         public async Task<BaseResponse<string>> DeleteConversation(string id)
         {
@@ -106,6 +130,9 @@ namespace AdminApi.Customer
                 : this.ToFailResult<string>(result.msg);
         }
 
+        /// <summary>
+        /// 获取会话聊天记录
+        /// </summary>
         [HttpGet("chatlog/{conversationId}")]
         public async Task<BaseResponse<List<MessageDto>>> GetChatLog(string conversationId)
         {
@@ -121,6 +148,9 @@ namespace AdminApi.Customer
             }
         }
 
+        /// <summary>
+        /// 删除单条消息
+        /// </summary>
         [HttpDelete("message/{id}")]
         public async Task<BaseResponse<string>> DeleteMessage(string id)
         {
@@ -135,6 +165,9 @@ namespace AdminApi.Customer
             }
         }
 
+        /// <summary>
+        /// 删除会话所有消息
+        /// </summary>
         [HttpDelete("messages/{conversationId}")]
         public async Task<BaseResponse<string>> DeleteAllMessages(string conversationId)
         {
@@ -149,6 +182,9 @@ namespace AdminApi.Customer
             }
         }
 
+        /// <summary>
+        /// 批量删除消息
+        /// </summary>
         [HttpPost("messages/delete-batch")]
         public async Task<BaseResponse<string>> DeleteMessagesBatch([FromBody] DeleteMessagesBatchRequest param)
         {