v1.4.0

LangChain-RAG-FastAPI-Service v1.4.0

发布日期：2026-05-16

✨ 新增特性

• SSE 实时推送 RAG 思考过程 — Agent 推理中间步骤通过 ContextVar + asyncio.create_task + 队列实时推送到前端，支持流式展示思考链
• 前端思考过程面板 — 用户界面新增思考过程可视化组件，可实时查看 RAG 各阶段状态
• 重排序重构为两阶段 — 拆分为计算前/后两个阶段，返回详细打分字段，便于前端展示排序依据
• 统一 SSE 事件模型 — 新增 SSEEvent dataclass + to_sse() 方法，统一事件序列化
• 测试用户登录 — 登录接口对测试用户特殊处理，返回正确 token 及虚假个人信息，不写入数据库，方便演示
• PDF 解析引擎升级 — 使用 LangChain UnstructuredPDFLoader 替换 PyPDFLoader，提升复杂 PDF 解析兼容性
• "关于我们"页面优化 — 优化展示效果，支持一键跳转项目 GitHub

🏗️ 架构调整

• 向量库上传流程重构 — handle_add_vector_multiple_stream 拆分为 9 个 SSE 辅助方法 + 3 个阶段方法，主函数从 275 行压缩至 44 行，消除 8 处重复 yield
• MD5 操作抽取 — 将 MD5 文件操作从 VectorStoreService 转移到 MD5Store 类，消除 5 处重复文件操作代码
• 清理废弃模型 — 移除已被 SSEEvent 替代的 UploadProgress Pydantic 模型和 SliceResult 类，减少技术债务

🐛 问题修复

• 修复 Vite proxy 误匹配导致刷新 /knowledgebase 路由时出现 404 的问题

📦 新增依赖

• 导出 requirements.txt（从 pyproject.toml 生成），方便习惯使用 pip 的用户安装依赖

📚 文档

• 新增知识库前端界面展示截图
• 增加 Django ORM 迁移指令
• 修复文档中错误的路由

---

欢迎提交 Issue & PR 参与项目共建