kongdeqiang
2026-10-12 ccf1a44c001e233c158bd168dc2d0d96721af929
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
package com.custom.webui.entity;
 
import com.baomidou.mybatisplus.annotation.IdType;
import com.baomidou.mybatisplus.annotation.TableId;
import com.baomidou.mybatisplus.annotation.TableName;
import lombok.Data;
 
import java.time.LocalDateTime;
 
/**
 * 消息实体,对应表 {@code message}。
 *
 * <p><b>核心设计:扁平存储 + parentId</b>。
 * 数据库中不存在任何树形 JSON,所有消息平铺成一张表,通过 {@code parentId} 指向父消息。
 * 树形结构在查询后由 {@link com.custom.webui.util.MessageTreeUtil} 在内存中组装。
 * 这样做的收益:
 * <ul>
 *   <li>消息编辑 / 重新生成天然产生分支(同一个 parentId 下挂多条 assistant 消息)</li>
 *   <li>单条消息更新代价 O(1),不必重写整棵树</li>
 *   <li>便于后续按需分页、增量加载</li>
 * </ul>
 */
@Data
@TableName("message")
public class Message {
 
    @TableId(type = IdType.AUTO)
    private Long id;
 
    private Long chatId;
 
    /** 父消息 id;会话首条消息为 null,是树的根 */
    private Long parentId;
 
    /** user / assistant / system */
    private String role;
 
    private String content;
 
    /** 生成该条 assistant 消息所用的模型名 */
    private String model;
 
    /** 0 = 流式生成中,1 = 流式已完成。用于刷新页面时识别被中断的消息 */
    private Boolean done;
 
    /** 扩展元信息 JSON,如 token 用量、RAG 引用来源、耗时等 */
    private String metadata;
 
    private LocalDateTime createdAt;
 
    // ---------- role 常量,避免各处硬编码字符串 ----------
 
    public static final String ROLE_USER = "user";
    public static final String ROLE_ASSISTANT = "assistant";
    public static final String ROLE_SYSTEM = "system";
}