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;
|
|
/**
|
* 消息返回体,同时承载「树节点」与「分支切换」所需的元数据。
|
*
|
* <p>树结构:{@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<MessageDTO> children = new ArrayList<>();
|
|
/**
|
* 该消息随附的图片文件 id(来自 metadata.imageFileIds)。
|
*
|
* <p>前端据此拼出 {@code /api/files/{id}/content} 显示原图。
|
* 单独暴露成字段而不是让前端解析 metadata 字符串,是因为
|
* metadata 在不同序列化路径下可能是对象也可能是字符串(@JsonRawValue),
|
* 前端解析会踩坑;由后端统一还原成数组更可靠(sources 同理)。
|
*/
|
private List<Long> imageFileIds = new ArrayList<>();
|
|
/** 随消息上传图片的 OCR 文字,供「重新生成」时复用图片上下文 */
|
private String imageText;
|
|
/**
|
* RAG 引用来源。
|
*
|
* <p>由 metadata 中的 ragSources 还原而来,用于刷新页面后继续展示
|
* 「这条回答引用了哪些文档的哪一节」。非 RAG 回答为空列表。
|
*/
|
private List<StreamEvent.Source> sources = new ArrayList<>();
|
|
// ---------- 分支切换辅助字段(由 MessageTreeUtil 计算) ----------
|
|
/** 兄弟节点总数(含自身)。为 1 表示没有分支,前端不显示切换箭头 */
|
private Integer siblingCount = 1;
|
|
/** 自己在兄弟中的序号,从 1 开始 */
|
private Integer siblingIndex = 1;
|
|
/** 同一父节点下的所有兄弟消息 id,按创建时间升序,供前端左右切换 */
|
private List<Long> 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);
|
}
|
}
|