*图由 Nano Banana 2 生成
- 智能体开发：基于 LangGraph，支持子智能体、Skills、MCPs、Tools 与中间件机制
- 知识库（RAG）：多格式文档上传，支持 Embedding / Rerank 配置及知识库评估
- 知识图谱：基于 LightRAG 的图谱构建与可视化，支持属性图谱并参与智能体推理
- 平台与工程化：Vue + FastAPI 架构，支持暗黑模式、Docker 与生产级部署
- 构建 面向真实业务的 RAG + 知识图谱智能体
- 将 PDF / Word / Markdown / 图片快速转化为可推理的知识库
- 自动（LightRAG）或手动构建知识图谱，并用于智能体推理
- 使用 LangGraph v1 构建多智能体 / 子智能体系统
[2026/03/26] v0.6.0.beta1 版本发布
- 重构后端代码 src -> backend/package/yuxi
- 重构文档解析，统一文档解析体验，并新增 Parser 类
- 新增 LITE 模式启动，启动时不加载知识库、知识图谱相关模块，可以使用 make up-lite 快捷启动
- 新增沙盒环境，详见后续文档更新，统一沙盒虚拟路径前缀默认值为
/home/gem/user-data - 新增基于沙盒的文件系统，前端工作台可以查看文件系统，支持预览（文本、图片、PDF、HTML）、下载文件
- 新增基于沙盒的知识库只读映射，按“用户可访问知识库 ∩ 当前 Agent 已启用知识库”暴露原始文件与解析后的 Markdown #576
- 重构附件系统，直接集成在了沙盒文件系统中，附件上传后直接落盘到沙盒挂载目录
- 优化前端流式消息体验：新增通用
useStreamSmoother调度层，统一平滑 Agent runs SSE、普通聊天流与审批恢复流中的loadingchunk - 重构前端 Agent 路由结构及表现形式，体验更加顺畅，切换更加自然（类 chatgpt 体验）
- 新增 API Key 认证功能，支持外部系统通过 API Key 调用系统服务 #502
- 新增 subagents 的支持，支持在 web 中添加 subagents，以及两个内置的子智能体
- 新增内置Skills reporter，并移除内置 Agent reporter，数据库报表将由 Skills 完成
- 新增文件上传队列功能，大批量文件上传任务，前端显示上传进度，并限制同时上传的文件数量，避免过载
- 重构 MINIO 的知识库上传逻辑，文件组织更加统一，但可能会导致历史知识库存在删除残留
- 新增对话自动生成标题功能，默认启用，基于 fast model 调用
- 新增知识库 PDF、图片的预览功能
- 修复 Lightrag 知识库修改配置后，模型没有切换的 bug #580
- 修复数据库获取接口未过滤文件字段而导致的数据包过大的情况
[2026/03/01] v0.5.0 版本发布
- 优化 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 存储，并新增删除任务的接口
- 重构知识库文件系统，将附件与文件系统整合，文件系统使用 StateStore 存储
[2025/12/19] v0.4.0 版本发布
- 新增对于上传附件的智能体中间件，详见文档
- 新增多模态模型支持（当前仅支持图片），详见文档
- 新建 DeepAgents 智能体（深度分析智能体），支持 todo，files 等渲染，支持文件的下载。
- 新增基于知识库文件生成思维导图功能（#335）
- 新增基于知识库文件生成示例问题功能（#335）
- 新增知识库支持文件夹/压缩包上传的功能（#335）
- 新增自定义模型支持、新增 dashscope rerank/embeddings 模型的支持
- 新增文档解析的图片支持，已支持 MinerU Officical、Docs、Markdown Zip 格式
- 新增暗色模式支持并调整整体 UI（#343）
- 新增知识库评估功能，支持导入评估基准或者自动构建评估基准（目前仅支持 Milvus 类型知识库）详见文档
- 新增同名文件处理逻辑：遇到同名文件则在上传区域提示，是否删除旧文件
- 新增生产环境部署脚本，固定 python 依赖版本，提升部署稳定性
- 优化图谱可视化方式，统一图谱数据结构，统一使用基于 G6 的可视化方式，同时支持上传带属性的图谱文件，详见文档
- 优化 DBManager / ConversationManager，支持异步操作
- 优化 知识库详情页面，更加简洁清晰，增强文件下载功能
- 修复重排序模型实际未生效的问题
- 修复消息中断后消息消失的问题，并改善异常效果
- 修复当前版本如果调用结果为空的时候，工具调用状态会一直处于调用状态，尽管调用是成功的
- 修复检索配置实际未生效的问题
- 移除 Chroma 的支持，当前版本标记为移除
- 移除模型配置预设的 TogetherAI
[2025/11/05] v0.3.0 版本发布
- 全面适配 LangChain/LangGraph v1 版本的特性，使用 create_agent 创建智能体入口。
- 文档解析升级，适配 mineru-2.6 以及 mineru-api。
- 更多智能体开发套件 中间件、子智能体，更简洁，更易上手。
克隆代码，并初始化
git clone --branch v0.6.0.beta1 --depth 1 https://github.com/xerrors/Yuxi-Know.git
cd Yuxi-Know
# Linux/macOS
./scripts/init.sh
# Windows PowerShell
.\scripts\init.ps1
然后需要使用 docker 启动项目
docker compose up --build
等待启动完成后，访问 http://localhost:5173
首页 |
Dashboard 统计 |
智能体配置 |
知识库调用 |
新建知识库 |
知识库管理 |
知识图谱可视化 |
项目使用文档 |
拓展管理（Skills） |
拓展管理（MCPs） |
用户/部门权限管理 |
模型供应商配置 |
本项目参考并引用了以下优秀开源项目，在此致以诚挚的感谢：
- LightRAG - 直接引入作为图谱构建与检索的基础包
- DeepAgents - 直接引入作为深度智能体框架
- DeerFlow - 参考了其 Sandbox 智能体架构的实现思路
- RAGflow - 参考了其文档 Text Chunking 的分块策略
- LangGraph - 多智能体编排框架，本项目的核心架构基础
- 项目 Logo 由 Nano Banana 2 生成
感谢所有贡献者的支持！
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。
如果这个项目对您有帮助，请不要忘记给我们一个 ⭐️