Mini-Rag项目构建-7前端会话管理
988 字
5 分钟
Mini-Rag项目构建-7前端会话管理
项目Github地址: https://github.com/gaodaxiu0406/Mini-Rag
⭐ 如果这个项目对你有帮助,欢迎Github点一个 Star——你的一个星,是对独立开发者最直接的鼓励;发现问题或有想法,也欢迎提 Issue。
整体设计
全部代码放在一个IIFE中,避免污染全局变量。
按职责分块:工具函数与全局状态 → 会话管理 → 聊天(SSE流式) → 事件绑定与初始化
测试代码
在static/js文件夹下创建app.js文件,写入以下代码
alert("Hello, World!");运行app.py,在浏览器打开地址,有弹框,表示代码运行成功

关键说明
app.js文件代码
( function() { const API = "/api"
let state = { session: [], activeSessionId: null, streamingAbort: null, }; const $ = (sel) => document.querySelector(sel); const sessionList = $("#session-list"); const messagesEl = $("#chat"); const userInput = $("#user-input"); const btnSend = $("#btn-send"); const btnNew = $("#btn-new-session"); const sessionTitle = $("#current-session-title");
/** * api请求方法 * @param {*} method 方法 * @param {*} path 路径 * @param {*} body 请求体 * @returns */ async function api(method, path, body) { const opts = { method, headers: { "Content-Type": "application/json" } }; if (body) opts.body = JSON.stringify(body); // 原生fetch请求向后端发送请求 const res = await fetch(API + path, opts); return await res.json(); } })()state:全局状态对象,根据当前活跃会话和流式请求的AbortControllerapi():统一的JSON请求函数,自动设置Content-Type和序列化body- 这里只取聊天需要的DOM元素;文档区元素加知识库功能时再取
会话管理逻辑说明
// —— —— 会话管理 —— ——// 加载会话async function loadSessions() { // 接收在会话列表中获取后台所有会话数据 state.session = await api("GET", "/sessions"); // 刷新会话列表 await renderSessions();}// 刷新会话列表function renderSessions() { sessionList.innerHTML = ""; state.session.forEach(s => { const li = document.createElement("div"); li.className = "session-item"; li.dataset.id = s.id; if (s.id === state.activeSessionId) li.classList.add("is-active");
const span = document.createElement("span"); span.textContent = s.title || "未命名"; span.style.flex = 1;
span.addEventListener("click", () => { switchSession(s.id); }); const del = document.createElement("b"); del.className = "session-item__close"; del.textContent = "×"; del.addEventListener("click", (e) => { e.stopPropagation(); deleteSession(s.id); });
li.appendChild(span); li.appendChild(del); sessionList.appendChild(li); });}
// 切换会话按钮async function switchSession(id) { console.log(state, 'state') state.activeSessionId = id; // 根据会话id获取会话数据 const sess = await api("GET", `/sessions/${id}`); console.log(sess, 'sess') messagesEl.innerHTML = ""; if (sess && sess.messages) { sess.messages.forEach(msg => addMessage(msg.role, msg.content)); sessionTitle.textContent = sess ? sess.title : "Mini-RAG"; scrollBottom(); btnSend.disabled = false; renderSessions(); }}
// 删除会话按钮async function deleteSession(id) { await api("DELETE", `/sessions/${id}`); if (state.activeSessionId === id) { state.activeSessionId = null; messagesEl.innerHTML = ""; sessionTitle.textContent = "选择一个会话"; btnSend.disabled = true; } await loadSessions();}switchSession:点击会话 → 请求后端拿完整消息列表 → 清空消息区 → 逐条addMessage重建DOM。这样即使刷新页面,历史消息也能完整恢复deleteSession:删除后如果正好是当前会话,清空聊天区并禁用发送按钮renderSessions:用createElement动态构建DOM,而非innerHTML拼接字符串————后者在列表项多时会很慢
消息渲染辅助函数
// —— —— 消息渲染辅助函数 —— ——function addMessage(role, content, idHint) { const div = document.createElement("div"); div.className = `msg ${role}`; const divContent = document.createElement("div"); divContent.className = "msg__bubble"; if (idHint) divContent.id = idHint; divContent.textContent = content; div.appendChild(divContent); messagesEl.appendChild(div); scrollBottom(); return div;}function scrollBottom() { messagesEl.scrollTop = messagesEl.scrollHeight;}switchSession里用到了addMessage和scrollBottom两个函数
addMessage:往消息区追加一条消息气泡。role取user或assistant,对应CSS里靠右/靠左的样式;idHint用于后面流式聊天时给“思考中…”气泡一个临时id,方便定位scrollBottom:把消息区滚动条滚到底部,保证最新消息可见。会话切换、发送消息时都会用到
事件绑定与初始化
// —— —— 事件绑定与初始化 —— ——btnNew.addEventListener("click", async () => { const sess = await api("POST", "/sessions"); state.activeSessionId = sess.id; messagesEl.innerHTML = ""; sessionTitle.textContent = sess.title || "Mini-RAG"; btnSend.disabled = false; // 异步刷新 await loadSessions();});// 初始加载async function init() { // 刷新会话列表 await loadSessions();}
init();最后把“新会话”按钮接上,并在页面加载时拉取会话列表
- 新建会话流程:点击“新会话”按钮 →
POST/sessions让后端创建会话 → 把返回的id设为当前活跃会话
支持与分享
如果这篇文章对你有帮助,欢迎分享给更多人或打赏支持!
Mini-Rag项目构建-7前端会话管理
https://gaodaxiu-blog.netlify.app/posts/guide/7项目构建-7前端会话管理/相关文章智能推荐
1
Mini-Rag项目构建-4会话存储、查询、删除
Mini-Rag项目构建实现`storage.py`(会话部分):每个对话对应一个JSON文件,支持新建、读取、列表、删除。用JSON文件做持久化,不用任何数据库。
2
Mini-Rag项目构建-6前端页面结构
Mini-Rag项目构建前端页面结构
3
Mini-Rag项目构建-8前端SSE流式聊天
Mini-Rag项目构建补全聊天功能:SSE流式渲染、以及发送/输入的事件绑定
4
Mini-Rag项目构建-11对话接入rag
Mini-Rag项目构建对话接入检索
5
Mini-Rag项目构建-10向量化检索
Mini-Rag项目构建TF-IDF向量与检索
随机文章随机推荐












