视频加载失败

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:全局状态对象,根据当前活跃会话和流式请求的AbortController
  • api():统一的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前端会话管理/
作者
MuZhao
发布于
2026-10-26
许可协议
CC BY-NC-SA 4.0
Profile Image of the Author
MuZhao
Hello, I'm GaoDaXiu.
公告
欢迎来到我的博客!
分类
标签
最新动态
站点统计
文章
124
分类
25
标签
147
总字数
180,592
运行时长
0 天
最后活动
0 天前
站点信息
构建平台
Netlify CI
博客版本
Firefly v6.16.8
文章许可
CC BY-NC-SA 4.0
文章目录