kongdeqiang
2026-10-10 ad24c871d74a417db5412fd9d1fa60411c33ae7f
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
package com.custom.webui.service;
 
import com.custom.webui.dto.req.MessageUpdateRequest;
import com.custom.webui.dto.resp.MessageDTO;
import com.custom.webui.entity.Message;
import org.springframework.web.servlet.mvc.method.annotation.SseEmitter;
 
import java.util.List;
 
/** 消息与流式对话服务。 */
public interface MessageService {
 
    /**
     * 获取会话的完整消息树。
     *
     * <p>返回的是根节点列表,每个节点通过 {@code children} 递归嵌套,
     * 并附带分支切换所需的 sibling 元数据。
     */
    List<MessageDTO> getMessageTree(Long userId, Long chatId);
 
    /** 编辑消息内容(不产生新分支,仅原地更新) */
    MessageDTO updateMessage(Long userId, Long chatId, Long messageId, MessageUpdateRequest request);
 
    /**
     * 删除一条消息及其全部子孙消息。
     *
     * <p>这是比「只删自己」更符合直觉的语义:删掉中间的一条,
     * 其后续对话失去上下文也就没有保留意义。
     */
    void deleteMessage(Long userId, Long chatId, Long messageId);
 
    /**
     * 流式对话核心入口。
     *
     * <p>方法立即返回一个 {@link SseEmitter},真正的生成过程在
     * {@code sseExecutor} 线程池中异步执行:
     * <ol>
     *   <li>保存 user 消息</li>
     *   <li>创建 done=0 的 assistant 占位消息</li>
     *   <li>RAG 检索(可选),把片段注入 system prompt</li>
     *   <li>调用 LLM 流式接口,逐块通过 SSE 下发</li>
     *   <li>流结束写回完整 content 并置 done=1</li>
     * </ol>
     *
     * @param userId    当前用户
     * @param chatId    会话 id
     * @param content   用户输入
     * @param parentId  新消息挂载的父消息 id;为空表示接在当前活跃分支末尾
     * @param modelName 覆盖会话默认模型,可为空
     * @param useRag    本次是否启用知识库检索
     * @param imageText  随消息上传的图片经 OCR 提取出的文字。
     *                   走 OCR 而不是直接把图给模型,是因为当前 Ollama 模型
     *                   是纯文本模型;OCR 方案对所有模型通用。
     *                   有值时会被拼进本轮 prompt 作为「图片内容」上下文。
     * @param imageFileIds 随消息上传的图片在 upload_file 中的 id,
     *                   写入消息 metadata,前端据此展示原图
     */
    SseEmitter streamChat(Long userId, Long chatId, String content,
                          Long parentId, String modelName, boolean useRag,
                          String imageText, List<Long> imageFileIds);
 
    /** 取会话最后一条消息的 id,用于确定新消息的父节点 */
    Long findLeaflessParent(Long chatId);
 
    /** 按 id 与归属校验取消息 */
    Message requireOwnedMessage(Long userId, Long chatId, Long messageId);
}