kongdeqiang
2026-10-14 9f9e043849b6f497e00399900ff234cf097eba82
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
package com.custom.webui.dto.resp;
 
import com.fasterxml.jackson.annotation.JsonRawValue;
import lombok.Data;
 
import java.time.LocalDateTime;
import java.util.List;
 
/**
 * 会话返回体。
 *
 * <p>{@code meta} 在原实体里是 JSON 字符串,这里用 {@link JsonRawValue} 直接内联输出,
 * 避免前端拿到被二次转义的字符串。
 */
@Data
public class ChatDTO {
 
    private Long id;
 
    private String title;
 
    /** 模型参数对象,直接内联为 JSON */
    @JsonRawValue
    private String meta;
 
    private LocalDateTime createdAt;
 
    private LocalDateTime updatedAt;
 
    /**
     * 是否置顶。
     *
     * <p>前端据此把会话放进最上方的「置顶」分组,并在标题前显示图钉。
     */
    private Boolean pinned;
 
    /** 置顶时间,置顶分组按它倒序(与活跃时间无关) */
    private LocalDateTime pinnedAt;
 
    /** 是否已归档;主列表只取 archived=false,归档列表只取 true */
    private Boolean archived;
 
    private LocalDateTime archivedAt;
 
    /**
     * 所属自建分组 id,{@code null} = 未分组。
     *
     * <p>前端就拿这个字段把会话挂到对应分组下,不需要再为「某个分组里有哪些会话」
     * 单独发请求 —— 会话列表本来就一次返回了全部。
     */
    private Long groupId;
 
    /** 会话内消息总数,用于侧边栏展示 */
    private Long messageCount;
 
    /** 已绑定的知识库集合名列表 */
    private List<String> collectionNames;
 
    /**
     * 搜索命中片段,仅在会话搜索结果里有值。
     *
     * <p>命中标题时为空(标题本身就是结果),命中消息内容时是该消息
     * 围绕关键词截取的一段文字,用于让用户确认「是不是这次对话」。
     */
    private String matchSnippet;
 
    /** 命中位置:title / message / both,前端据此显示不同图标 */
    private String matchType;
}