chore: sync local updates

mengyastore-backend-go/internal/handlers/admin_chat.go

@@ -8,7 +8,8 @@ import (
 )
 
 // GetAllConversations 返回所有用户会话列表。
-// @Summary 全部会话列表
+// @Summary 管理端：列出全部聊天会话
+// @Description 返回每个有过消息的用户账号等信息，供客服选择会话；需管理令牌 `X-Admin-Token`。
 // @Tags 管理端-聊天
 // @Produce json
 // @Security AdminToken
@@ -29,11 +30,12 @@ func (h *AdminHandler) GetAllConversations(c *gin.Context) {
 }
 
 // GetConversation 返回指定账号的全部消息记录。
-// @Summary 指定用户聊天记录
+// @Summary 管理端：查看某用户的完整聊天记录
+// @Description 路径参数 `account` 为用户账号标识；返回按时间排列的消息数组；需管理令牌。
 // @Tags 管理端-聊天
 // @Produce json
 // @Security AdminToken
-// @Param account path string true "用户账号"
+// @Param account path string true "用户账号（路径）"
 // @Success 200 {object} SwaggerMessagesWrap
 // @Failure 400 {object} SwaggerErrorBody
 // @Failure 401 {object} SwaggerErrorBody
@@ -61,13 +63,14 @@ type AdminChatPayload struct {
 }
 
 // AdminReply 向指定用户发送管理员回复。
-// @Summary 管理员回复
+// @Summary 管理端：向用户回复一条消息
+// @Description 路径为对方账号，JSON body 含 `content`；写入后用户侧拉取可见。
 // @Tags 管理端-聊天
 // @Accept json
 // @Produce json
 // @Security AdminToken
-// @Param account path string true "用户账号"
-// @Param body body AdminChatPayload true "回复内容"
+// @Param account path string true "用户账号（路径）"
+// @Param body body AdminChatPayload true "回复正文 JSON"
 // @Success 200 {object} SwaggerOneChatMsgWrap
 // @Failure 400 {object} SwaggerErrorBody
 // @Failure 401 {object} SwaggerErrorBody
@@ -101,11 +104,12 @@ func (h *AdminHandler) AdminReply(c *gin.Context) {
 }
 
 // ClearConversation 清除与指定用户的全部消息记录。
-// @Summary 清空会话
+// @Summary 管理端：清空与某用户的会话
+// @Description 删除该账号在系统中的全部聊天消息记录；不可恢复请谨慎使用。
 // @Tags 管理端-聊天
 // @Produce json
 // @Security AdminToken
-// @Param account path string true "用户账号"
+// @Param account path string true "用户账号（路径）"
 // @Success 200 {object} SwaggerBoolOKWrap
 // @Failure 400 {object} SwaggerErrorBody
 // @Failure 401 {object} SwaggerErrorBody