v2.1.0

v2.1.0

---

发布日期：2026年6月8日

🎉 重大更新

🎨 前端全面重构

• 从 Vue 3 + Vant 技术栈整体迁移至 React 19 + TypeScript + Tailwind CSS + Radix UI
• 重新设计组件体系与交互逻辑，带来更流畅的用户体验和更强的可维护性
• 原Vue3前端保留为分支 vue3-frontend

---

🚀 v2.1.0 新功能

📝 笔记能力增强

• 笔记创建与更新支持category分类和tags标签字段，路由等待初始化完成后响应
• 后端新增笔记Markdown下载接口，完美支持中文文件名，前端配套一键下载按钮

⚙️ 后台初始化管理

• 新增BackgroundInitManager单例管理器，后台异步初始化chat/embed/vision等重型模型资源
• 应用启动时间大幅缩短，无需等待所有模型加载完成即可启动FastAPI服务器

🛠️ Django 服务强化

• 应用启动时自动检测并执行数据库迁移，自动创建admin测试用户，避免用户因不熟悉DjangoORM而无法迁移数据库
• 数据库引擎支持短名称配置与环境变量注入
• 添加Django管理命令，注册serializer手机号字段允许为空

---

⚡ 性能优化

• Agent SSE 流式响应：采用15字符/0.03s的chunk化输出策略，加入handle_parsing_errors异常处理，大幅提升流式输出稳定性
• DashScope 嵌入API：优化为批量调用模式（batch_size=10），失败时主动抛出异常而非静默失败，便于问题排查
• Redis 连接池：支持event loop切换与连接复用，降低连接开销
• RAG 检索调优：将文档分块大小chunk_size从200提升至1000，Agent Prompt强化优先检索原则

---

🔧 核心重构

🧠 模型与服务惰性加载

• 实现_LazyEmbedding延迟加载类，解决后台初始化时序冲突问题
• Vision服务改为模型延迟初始化，首次调用时才完成解析加载
• RAG全链路组件（reorder_service、vector_store、document_handler、rag_service）均改为惰性加载，移除模块级直接导入
• 业务服务层（note_service、review_service）的模型依赖统一通过init_manager获取，彻底解耦模块依赖

🗄️ 配置体系优化

• Redis连接参数全部从环境变量读取，移除所有硬编码配置，提升部署安全性与灵活性

---

🐛 Bug 修复

• 修复JWT黑名单Redis检查失败时返回500错误的问题
• 修正Chroma语义搜索filter语法错误，解决检索条件不生效问题
• 修复Python callable类型注解错误
• 添加drf-spectacular依赖

---

🧹 项目维护

• 正式添加MIT开源许可证，明确开源协议
• 关闭数据库SQL日志输出，减少不必要的日志冗余
• 更新前端界面截图，修正文档内容错误
• 优化后端依赖配置：限定python-magic-bin平台范围、配置PyTorch CUDA索引、完善包发现设置

---

⚠️ 升级注意

1. 前端技术栈已全面迁移至React 19，需重新安装依赖：npm install
2. 新增数据库字段与配置项，Django应用启动时会自动执行迁移，请留意控制台输出
3. Redis连接参数需通过环境变量配置，原硬编码配置已失效
4. 后端依赖已更新，建议使用uv sync重新同步依赖环境