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 children = new ArrayList<>(); /** * 该消息随附的图片文件 id(来自 metadata.imageFileIds)。 * *

前端据此拼出 {@code /api/files/{id}/content} 显示原图。 * 单独暴露成字段而不是让前端解析 metadata 字符串,是因为 * metadata 在不同序列化路径下可能是对象也可能是字符串(@JsonRawValue), * 前端解析会踩坑;由后端统一还原成数组更可靠(sources 同理)。 */ private List imageFileIds = new ArrayList<>(); /** 随消息上传图片的 OCR 文字,供「重新生成」时复用图片上下文 */ private String imageText; /** * RAG 引用来源。 * *

由 metadata 中的 ragSources 还原而来,用于刷新页面后继续展示 * 「这条回答引用了哪些文档的哪一节」。非 RAG 回答为空列表。 */ private List sources = new ArrayList<>(); // ---------- 分支切换辅助字段(由 MessageTreeUtil 计算) ---------- /** 兄弟节点总数(含自身)。为 1 表示没有分支,前端不显示切换箭头 */ private Integer siblingCount = 1; /** 自己在兄弟中的序号,从 1 开始 */ private Integer siblingIndex = 1; /** 同一父节点下的所有兄弟消息 id,按创建时间升序,供前端左右切换 */ private List siblingIds = new ArrayList<>(); /** 该消息当前选中的子分支 id:当 children 多于 1 个时,指向用户最后活跃的那条 */ private Long activeChildId; /** 便捷方法:追加子节点 */ public void addChild(MessageDTO child) { if (this.children == null) { this.children = new ArrayList<>(); } this.children.add(child); } }