ragflow v0.21.1 发布：功能更新与优化详解

福大大架构师每日一题

发布于 2025-12-18 15:48:26

5710

发布时间：2025年10月23日 ragflow v0.21.1 版本正式发布，本次版本对功能、性能、文档和界面等多个方面进行了更新和优化，涵盖了模型支持、解析器能力、知识库管理、界面交互以及开发工具等。本篇文章将对更新内容进行详细汇总。

1. 模型与解析能力更新

• 修复 Google Cloud 推理模型（如 gemini）的兼容问题，并进行了进一步完善。
• Gemini 与 Qwen-VL 系列新增视频解析支持，提升多模态理解能力。
• VolcEngine 模型新增 IMAGE2TEXT 类型，扩大图像到文字的转换支持。
• Vision Model 在手册、论文、书籍、单块解析等场景下增加图像增强功能。
• MinerU 支持 PDF 文档解析，并可在数据管道中应用。
• 支持所有类型的嵌入式文档解析。
• 视频解析新增默认输出格式为文本，并可在解析器操作中配置后缀显示与视频预览功能。

2. 知识库与检索优化

• 支持在检索过程中设置元数据过滤（attribute filtering）。
• 知识库重命名后可自动在 Agent 对话中同步显示。
• 创建知识库时支持初始嵌入生成。
• 增加检索测试修复，避免 rerank 出现错误。
• token chunker 与 title chunker 组件文档更新。
• GraphRAG 增加容错机制，并优化流程，与 RAPTOR 的流程改进相结合。
• 修复 RAPTOR 中可能出现的负 max_tokens 问题。

3. 表格、文档与数据处理

• 打印表格时支持自动宽度。
• 优化文件管理能力。
• Excel2HTML 支持新增格式修复，解决 XLS（Excel 97-2003）不支持问题。
• 删除数据管道中无用文件。
• 去除 PDF 嵌入支持并更新解析逻辑。
• 优化 chunk（文档分块）生成按钮的即时生效问题。

4. 管道与 Agent 相关改进

• 管道支持 MinerU PDF 解析器。
• 支持在 Agent 画布中显示管道，并在 Agent 页面显示管道操作表。
• 子节点唯一性约束：同一管道的子节点只能有一个。
• 增加工具节点与检索节点的折叠功能。
• Agent 节点的底部锚点仅在有下游节点时显示。
• Agent 对话页增加对开场白显示的修复。
• 在 Agent 画布上调整卡片样式以匹配设计规范。
• 管道翻译字段移动到 Flow 中。

5. 界面与交互优化

• 修复页面中图片无法上传的问题。
• 浮动组件（Intercom风格）的文本颜色优化。
• 修复文件总览页未显示文件名的问题。
• 调整个人中心侧边栏和资料页 UI 样式。
• MCP 对话框样式调整。
• 支持 Firefox 点击“停止接收消息”时避免页面崩溃。
• 增加视频字段在解析器操作配置中的显示。
• 修复视频文件后缀问题。
• 所有卡片样式调整至新设计方案。

6. 管理端与 CLI 功能

• 管理端 API 新增与优化。
• 管理端支持角色访问控制系统的 CLI 实现。
• 支持运行单条命令模式。
• 管理端提示信息与文档更新。
• LiteLLM 基类的总计数计算逻辑重构。
• 增加 RAGFlowOSS.put() 调用参数优化。

7. 依赖与构建更新

• axios 依赖由 1.7.2 升级到 1.12.0。
• infinity 版本升级至 v0.6.1 并进行了两次依赖同步。

8. 文档更新

• 更新数据集配置、知识图谱构建与 RAPTOR 构建文档。
• 增加长上下文 RAG 使用指南。
• 新增 MinerU 解析 PDF 文档的使用说明。
• 新增 token chunker 与 title chunker 组件说明。
• 更新各类 README 与版本引用至 v0.21.1。
• 架构图与 ragflow-cli 版本更新。

总结

代码地址：github.com/infiniflow/ragflow

ragflow v0.21.1 是一次功能与稳定性双提升的重要版本，特别是在多模态解析、知识库管理、管道可视化以及管理端能力方面均有明显升级。此外，UI 优化和文档的完善也让整体使用体验更为顺畅。对于使用 RAGFlow 进行知识检索、文档解析及智能应用构建的开发者来说，该版本的更新值得尽快升级体验。