kongdeqiang
2026-10-12 7c687dd3c8fba9f7632f5e29d94a708e5f497abd
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
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);
    }
}