开发路线图

路线图可能会经常变更，如果有强烈的建议，可以在 issue 中提。

看板

• 集成 LangFuse (观望) 添加用户日志与用户反馈模块，可以在 AgentView 中查看信息
• 集成 neo4j mcp （或者自己构建工具）
• chat_model 的 call 需要异步
• 优化智能体文件系统：
  • 使用 CompositeBackend 和 自定义后端系统，链接 minio 中的知识库文件。提供除检索以外的方法
  • 考虑修改附件的处理逻辑，考虑使用文件系统，将附件解析后放到文件系统中，智能体按需读取（当前是完全解析，放进上下文）
  • 【后续】用户可以使用 @ 来引用附件，例如 @file:reports.md 相较于现在的处理逻辑感觉会更加自然一点。
• skills 如何实现还需要继续调研
• 增加 paddle-vl 以及 deepseek-ocr 的支持（deepseek-ocr 已支持）
• 系统层面添加 apikey，在智能体、知识库调用中支持 apikey 以支持外部调用
• 支持更多类型的文档源的导入功能（支持后端配置的白名单的 URL 导入）
• 部分场景应该使用默认模型作为默认值而不是空值
• 文件上传解析后，如何提示用户需要入库
• 检索测试中，添加问答
• 丰富当前智能体的 Prompt，最好支持从 markdown 解析
• 模型的配置也传输到数据库（待定）

Bugs

• 部分异常状态下，智能体的模型名称出现重叠#279
• 部分 local 的 mcp server 无法正常加载，但是建议在项目外部启动 mcp 服务器，然后通过 sse 的方式使用。
• DeepSeek 官方接口适配会出现问题
• 部分推理后端与 langchain 的适配有问题：
• 目前的知识库的图片存在公开访问风险
• 工具传递给模型的时候，使用英文，但部分模型不支持中文函数名（如gpt-4o-mini，deepseek 官方接口）
• 当前的 upload 图谱查询为同步操作，可能会导致页面卡顿
• FileTable 的自动刷新失效
• 生成基准测试会把所有的向量都计算一遍不合理

v0.5

新增

• 优化 OCR 体验并新增对 Deepseek OCR 的支持
• 优化 RAG 检索，支持根据文件 pattern 来检索（Agentic Mode）
• 重构智能体对于“工具变更/模型变更”的处理逻辑，无需导入更复杂的中间件
• 重构知识库的 Agentic 配置逻辑，与 Tools 解耦
• 将工具与知识库解耦，在 context 中就完成解耦，虽然最终都是在 Agent 中的 get_tools 中获取
• 优化chunk逻辑，移除 QA 分割，集成到普通分块中，并优化可视化逻辑
• 重构知识库处理逻辑，分为 上传—解析—入库 三个阶段
• 重构 MCP 相关配置，使用数据库来控制 #469
• 使用 docling 解析 office 文件（docx/xlsx/pptx）
• 优化后端的依赖，减少镜像体积 #428
• 优化 liaghtrag 的知识库调用结果，提供 content/graph/both 多个选项
• 优化数据库查询工具，可通过设计环境变量添加描述，让模型更好的调用
• 优化任务组件，改用 postgresql 存储，并新增删除任务的接口

修复

• 修复知识图谱上传的向量配置错误，并新增模型选择以及 batch size 选择
• 修复部分场景下获取工具列表报错 #470
• 修改方法备注信息 #478
• 修复多次 human-in-the-loop 的渲染解析问题 #453 #475

v0.4

新增

• 新增对于上传附件的智能体中间件，详见文档
• 新增多模态模型支持（当前仅支持图片），详见文档
• 新建 DeepAgents 智能体（深度分析智能体），支持 todo，files 等渲染，支持文件的下载。
• 新增基于知识库文件生成思维导图功能（#335）
• 新增基于知识库文件生成示例问题功能（#335）
• 新增知识库支持文件夹/压缩包上传的功能（#335）
• 新增自定义模型支持、新增 dashscope rerank/embeddings 模型的支持
• 新增文档解析的图片支持，已支持 MinerU Officical、Docs、Markdown Zip格式
• 新增暗色模式支持并调整整体 UI（#343）
• 新增知识库评估功能，支持导入评估基准或者自动构建评估基准（目前仅支持Milvus类型知识库）详见文档
• 新增同名文件处理逻辑：遇到同名文件则在上传区域提示，是否删除旧文件
• 新增生产环境部署脚本，固定 python 依赖版本，提升部署稳定性
• 优化图谱可视化方式，统一图谱数据结构，统一使用基于 G6 的可视化方式，同时支持上传带属性的图谱文件，详见文档
• 优化 DBManager / ConversationManager，支持异步操作
• 优化 知识库详情页面，更加简洁清晰，增强文件下载功能

修复

• 修复重排序模型实际未生效的问题
• 修复消息中断后消息消失的问题，并改善异常效果
• 修复当前版本如果调用结果为空的时候，工具调用状态会一直处于调用状态，尽管调用是成功的
• 修复检索配置实际未生效的问题

破坏性更新

• 移除 Chroma 的支持，当前版本标记为移除
• 移除模型配置预设的 TogetherAI

v0.3

Added

• 添加测试脚本，覆盖最常见的功能（已覆盖API）
• 新建 tasker 模块，用来管理所有的后台任务，UI 上使用侧边栏管理。Tasker 中获取历史任务的时候，仅获取 top100 个 task。
• 优化对文档信息的检索展示（检索结果页、详情页）
• 优化全局配置的管理模型，优化配置管理
• 支持 MinerU 2.5 的解析方法 0.3.5
• 修改现有的智能体Demo，并尽量将默认助手的特性兼容到 LangGraph 的 create_agent 中
• 基于 create_agent 创建 SQL Viewer 智能体 0.3.5
• 优化 MCP 逻辑，支持 common + special 创建方式 0.3.5
• LightRAG 知识库应该可以支持修改 LLM

Fixed

• 修复本地知识库的 metadata 和 向量数据库中不一致的情况。
• v1 版本的 LangGraph 的工具渲染有问题
• upload 接口会阻塞主进程
• LightRAG 知识库查看不了解析后的文本，偶然出现，未复现
• 智能体的加载状态有问题：（1）智能体加载没有动画；（2）切换对话和加载中，使用同一个loading状态。
• 前端工具调用渲染出现问题
• 当前 ReAct 智能体有消息顺序错乱的 bug，且不会默认调用工具
• 修复文件管理：（1）文件选择的时候会跨数据库；（2）文件校验会算上失败的文件；