package com.custom.webui.dto.resp; import com.fasterxml.jackson.annotation.JsonRawValue; import lombok.Data; import java.time.LocalDateTime; import java.util.ArrayList; import java.util.List; /** * 消息返回体,同时承载「树节点」与「分支切换」所需的元数据。 * *
树结构:{@link #children} 是该消息的子消息数组。
* 分支结构:同一条 user 消息下可能挂多条 assistant 消息(重新生成产生),
* 前端用 {@link #siblingCount} 渲染 {@code < 2/3 >} 切换器,
* 用 {@link #activeChildId} 记住用户当前选中了哪个分支。
*/
@Data
public class MessageDTO {
private Long id;
private Long chatId;
private Long parentId;
private String role;
private String content;
private String model;
/** false 表示这条消息的流式生成被中断(例如刷新页面导致连接断开) */
private Boolean done;
@JsonRawValue
private String metadata;
private LocalDateTime createdAt;
/** 子消息列表,构成消息树 */
private List 前端据此拼出 {@code /api/files/{id}/content} 显示原图。
* 单独暴露成字段而不是让前端解析 metadata 字符串,是因为
* metadata 在不同序列化路径下可能是对象也可能是字符串(@JsonRawValue),
* 前端解析会踩坑;由后端统一还原成数组更可靠(sources 同理)。
*/
private List 由 metadata 中的 ragSources 还原而来,用于刷新页面后继续展示
* 「这条回答引用了哪些文档的哪一节」。非 RAG 回答为空列表。
*/
private List