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 { /** * 获取会话的完整消息树。 * *
返回的是根节点列表,每个节点通过 {@code children} 递归嵌套,
* 并附带分支切换所需的 sibling 元数据。
*/
List 这是比「只删自己」更符合直觉的语义:删掉中间的一条,
* 其后续对话失去上下文也就没有保留意义。
*/
void deleteMessage(Long userId, Long chatId, Long messageId);
/**
* 流式对话核心入口。
*
* 方法立即返回一个 {@link SseEmitter},真正的生成过程在
* {@code sseExecutor} 线程池中异步执行:
*
*
*
* @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