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 getMessageTree(Long userId, Long chatId); /** 编辑消息内容(不产生新分支,仅原地更新) */ MessageDTO updateMessage(Long userId, Long chatId, Long messageId, MessageUpdateRequest request); /** * 删除一条消息及其全部子孙消息。 * *

这是比「只删自己」更符合直觉的语义:删掉中间的一条, * 其后续对话失去上下文也就没有保留意义。 */ void deleteMessage(Long userId, Long chatId, Long messageId); /** * 流式对话核心入口。 * *

方法立即返回一个 {@link SseEmitter},真正的生成过程在 * {@code sseExecutor} 线程池中异步执行: *

    *
  1. 保存 user 消息
  2. *
  3. 创建 done=0 的 assistant 占位消息
  4. *
  5. RAG 检索(可选),把片段注入 system prompt
  6. *
  7. 调用 LLM 流式接口,逐块通过 SSE 下发
  8. *
  9. 流结束写回完整 content 并置 done=1
  10. *
* * @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 imageFileIds); /** 取会话最后一条消息的 id,用于确定新消息的父节点 */ Long findLeaflessParent(Long chatId); /** 按 id 与归属校验取消息 */ Message requireOwnedMessage(Long userId, Long chatId, Long messageId); }