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);
|
}
|