2026年5月14日，RAGFlow 发布了 v0.25.4 版本。
本次更新围绕 新特性、使用体验优化、模型支持补充、Bug 修复 四个方向展开，整体来看，这是一个非常实用、面向落地场景的版本升级。

---

一、v0.25.4 版本概览

RAGFlow v0.25.4 的核心关键词可以概括为：

• 新增通用型 RESTful API 数据源连接器
• Agent 标签管理增强，支持过滤和排序
• Widget 自定义与持久化
• OpenAI 模型列表新增 gpt-5.4-mini 和 gpt-5.4-nano
• 修复数据集文档下载路由问题

从发布内容来看，这次更新既有面向集成能力的增强，也有面向使用体验的优化，同时还补充了模型支持并修复了影响实际使用的缺陷。对于已经在使用 RAGFlow 的用户来说，这种版本通常意味着系统在“能接什么、怎么管、怎么配、怎么用”这几个关键层面更进一步。

---

二、新特性：新增通用、配置驱动的 RESTful API 数据源连接器

本次最值得关注的新特性之一，就是新增了一个 通用的、配置驱动的 RESTful API 数据源连接器。

1. 这项能力的意义

从名字上看，这个连接器的重点是“通用”和“配置驱动”。

这意味着它不再局限于某一种固定的数据源类型，也不需要为每一种接口都单独定制深度开发，而是可以通过配置方式，将符合 RESTful API 形式的数据接入 RAGFlow 的数据源体系中。
对于需要对接外部系统、业务接口、第三方平台接口的场景来说，这个更新非常实用。

2. 对数据接入场景的价值

在实际应用中，很多数据并不是静态文件，也不是数据库导出，而是分布在各种 RESTful API 中，例如：

• 业务系统接口
• 第三方平台接口
• 内部服务接口
• 动态内容接口

有了这个通用连接器之后，RAGFlow 在数据接入层面会更加灵活。
它让“数据源”不再只是单一格式输入，而是可以面向更广泛的 API 化数据体系，从而提升知识库构建时的数据整合能力。

3. 配置驱动的优势

“配置驱动”通常意味着用户可以通过参数配置来完成接入，而不必频繁修改代码逻辑。
这种方式的好处在于：

• 接入更快
• 适配更灵活
• 后续维护更方便
• 更适合标准化、可重复的接入流程

对于企业场景而言，配置驱动的数据源接入可以降低集成成本，也能提高不同业务系统接入 RAGFlow 的效率。

4. 对 RAGFlow 整体能力的补充

这次新增 RESTful API 数据源连接器，实际上是对 RAGFlow 数据接入能力的一次重要扩展。
它让系统更适合面对复杂、分散、动态变化的数据环境，也让 RAGFlow 在知识处理链路中更加贴近真实业务使用方式。

---

三、功能改进：Agent 标签管理支持过滤和排序

v0.25.4 的另一个重点改进，是 Agent 标签管理增强，新增了 过滤和排序 能力。

1. 为什么这个改进重要

当系统中的 Agent 数量越来越多时，标签管理就会成为重要的组织方式。
如果没有良好的标签管理机制，用户在查找、分类和维护 Agent 时会变得很不方便。

这次更新加入过滤和排序，说明 RAGFlow 在 Agent 管理层面开始更加注重可维护性和可视化组织能力。

2. 过滤能力带来的改变

过滤能力的加入，意味着用户可以更快地从大量标签或 Agent 中筛选出自己需要的内容。
这对于以下情况尤其有价值：

• Agent 数量较多
• 标签体系复杂
• 需要快速定位某类 Agent
• 需要按特定条件查看管理对象

过滤能够直接减少查找成本，让管理动作更聚焦、更高效。

3. 排序能力带来的改变

排序功能则进一步提升了管理体验。
当标签和 Agent 处于一个较大的集合中时，合理的排序方式可以帮助用户更快建立认知，提升浏览效率，减少无序带来的混乱感。

4. 对日常管理体验的提升

综合来看，Agent 标签管理支持过滤和排序后，用户在操作中会明显感受到：

• 查找更方便
• 分类更清晰
• 管理更有序
• 维护成本更低

这类优化虽然不一定像新特性那样“显眼”，但对长期使用体验的提升非常直接。

---

四、功能改进：Widget 自定义与持久化

本次更新中，Widget 自定义和持久化 也是一个非常值得关注的改进点。

1. Widget 自定义的意义

Widget 往往是界面中承担展示、操作或信息汇总功能的组件。
能够自定义 Widget，说明用户可以根据自己的使用习惯或业务需求，对界面组件进行更灵活的配置。

这会让界面更贴近实际使用，而不是只停留在固定布局和固定展示方式上。

2. 持久化的价值

“持久化”意味着用户对 Widget 所做的自定义设置不会在刷新、重启或重新进入页面后丢失，而是可以保留下来。
这对于产品体验来说非常重要，因为它解决了一个典型问题：
用户花时间配置好的内容，不能每次都重新来一遍。

3. 对使用体验的直接提升

Widget 自定义与持久化一起上线，带来的体验提升包括：

• 页面更符合个人习惯
• 配置结果更稳定
• 使用过程更连续
• 减少重复操作

对于经常使用 RAGFlow 的用户来说，这类功能会显著提升效率和舒适度。
尤其是在多次进入同一工作界面时，系统可以保持之前的 Widget 状态，让用户专注于工作本身，而不是重复调整界面。

4. 这项更新说明了什么

从产品方向上看，这说明 RAGFlow 不仅关注底层能力和集成能力，也开始进一步打磨前端交互与工作台体验。
这是一个很典型的成熟产品演进信号：功能越来越强，使用也越来越顺手。

---

五、模型支持：新增 gpt-5.4-mini 和 gpt-5.4-nano

在模型支持方面，v0.25.4 为 OpenAI 模型列表新增了：

• gpt-5.4-mini
• gpt-5.4-nano

1. 模型列表扩展的意义

模型支持的扩充，意味着 RAGFlow 能更好适配新的模型能力和不同使用需求。
不同模型通常会在速度、成本、能力表现上有所差异，因此增加更多可选项，可以让用户根据实际场景进行更灵活的选择。

2. mini 与 nano 的补充价值

从命名上看，mini 和 nano 这类模型通常意味着更轻量化的选择。
将它们加入 OpenAI 模型列表，意味着用户在构建应用或工作流时，有了更多模型配置空间。

对于系统来说，模型支持的完善不仅是“加一个选项”这么简单，它代表着平台对新模型生态的持续跟进，也让产品在可用性和兼容性上更进一步。

3. 对使用者的实际意义

这次新增模型之后，用户可以在支持的模型列表中直接看到并使用相关模型，减少适配成本。
同时，随着模型列表更新，RAGFlow 也能更好满足不同业务对模型能力和响应特征的需求。

---

六、Bug 修复：修复数据集文档下载路由

v0.25.4 还修复了一个与实际使用相关的问题：
数据集文档下载路由修复。

1. 为什么这个修复重要

数据集文档下载是知识库或数据管理场景中很基础、但很关键的功能。
如果下载路由存在问题，就会直接影响用户获取文档的流程，甚至影响日常使用效率。

这次修复说明团队已经针对具体功能路径进行了处理，提升了数据集文档下载的稳定性和可用性。

2. 对实际使用的影响

这个修复通常会带来以下好处：

• 下载流程更稳定
• 文档获取更顺畅
• 减少异常情况
• 提升用户对数据集管理功能的信任感

对于需要频繁查看、导出或使用数据集文档的用户来说，这个修复非常实际。

---

七、其他变更内容整理

除了上面几项核心升级之外，v0.25.4 的 “What’s Changed” 中还包含了多项具体变更。下面按发布内容进行完整梳理。

1. 新增通用 API 连接器相关功能

本次更新明确包含了 Feature/generic api connector，与前面提到的通用配置驱动 RESTful API 数据源连接器相对应。
这项内容是本版最核心的新功能之一。

2. 使用上下文管理器处理 pdfplumber，避免资源泄漏

本次更新中加入了一个针对 PDF 处理的修复：
使用上下文管理器来处理 pdfplumber，防止资源泄漏。

这说明系统在处理 PDF 文件时更加规范，减少了资源占用长期不释放的问题。
对于频繁处理文档的场景而言，这种修复有助于提高程序稳定性，降低潜在风险。

3. Widget 自定义与持久化

这一项已经在前面详细说明，本次更新明确包含了这项能力，说明它是本版的重要改进之一。

4. 文档编辑更新

发布内容中还包括了对 v0.25.3 发布说明草稿 的编辑更新，以及后续的 v0.25.3 发布说明最终定稿。
这些属于文档整理层面的内容，确保版本信息和说明保持准确一致。

5. Agent 标签管理加入过滤和排序

这一项对应前面提到的功能改进，说明 Agent 管理能力得到增强，标签体系更便于维护和查看。

6. 增加 Voyage AI provider

本次更新中还加入了 Voyage AI provider。
这说明 RAGFlow 在模型或相关提供方接入层面继续扩展支持范围，使系统可对接的能力更丰富。

7. 文档格式修复

更新中还包含了 修复文档格式 的内容。
这类调整主要是为了提升文档展示和可读性，确保版本说明、README 和相关文档在呈现上更加规范。

8. 新增 gpt-5.4-mini 和 gpt-5.4-nano

这一项是本次模型支持更新的核心内容，已经在前文展开说明。

9. 更新 README 和文档中的版本引用到 v0.25.4

本次发布还包括对 README 和文档中的版本引用更新。
这样可以保证项目文档与当前版本保持一致，避免用户在查阅资料时出现版本信息混乱的问题。

10. 补充 v0.25.4 发布说明草稿

发布列表中还提到新增了 v0.25.4 release notes draft。
这意味着版本发布过程中的说明文档也在同步完善，便于后续正式发布和对外说明。

---

八、从这次更新看 RAGFlow 的演进方向

结合 v0.25.4 的更新内容，可以看出 RAGFlow 正在从几个方向持续增强：

1. 更强的数据接入能力

新增通用 RESTful API 数据源连接器，说明系统正在朝着更通用、更开放、更容易集成外部数据的方向发展。

2. 更好的管理能力

Agent 标签管理支持过滤和排序，意味着系统在对象管理和运维体验方面持续打磨。

3. 更灵活的界面体验

Widget 自定义与持久化说明产品越来越重视用户的个性化配置和使用连续性。

4. 更完善的模型生态

新增 gpt-5.4-mini 和 gpt-5.4-nano，说明模型支持层持续保持更新，帮助用户适应不同模型选择。

5. 更稳定的核心体验

修复数据集文档下载路由，以及 pdfplumber 资源泄漏处理，说明开发团队也在持续修补底层稳定性和功能可靠性问题。

---

九、v0.25.4 适合关注哪些用户

如果你属于下面几类用户，那么这次更新尤其值得关注：

• 正在使用 RAGFlow 构建知识库的人
• 需要对接 RESTful API 数据源的人
• 关注 Agent 管理和标签体系的人
• 经常自定义工作界面 Widget 的人
• 需要使用 OpenAI 新模型的人
• 依赖数据集文档下载功能的人

这些用户都能从本次更新中找到直接相关的改进点。

---

十、总结

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

RAGFlow v0.25.4 是一次覆盖面比较广、实用性较强的版本更新。
它不仅新增了 通用配置驱动的 RESTful API 数据源连接器，还增强了 Agent 标签管理，引入了 Widget 自定义与持久化，补充了 gpt-5.4-mini 和 gpt-5.4-nano 的模型支持，同时也修复了 数据集文档下载路由 问题。

此外，本次更新中还包括：

• 使用上下文管理器处理 pdfplumber，防止资源泄漏
• 增加 Voyage AI provider
• 修复文档格式
• 更新版本引用到 v0.25.4
• 完成相关发布说明文档整理