RAGFlow v0.25.2 已于 2026 年 5 月 10 日发布。这一版本的关键词非常明确API 继续统一、数据源删除同步能力增强、权限控制更严格、性能瓶颈被修复、兼容性持续维护。如果你正在关注 RAGFlow 的升级节奏v0.25.2 是一次覆盖面非常广的版本更新既有架构层面的持续演进也有大量面向生产可用性的修补与增强。一、v0.25.2 版本总览本次版本主要分为三大方向1API 继续重构与统一RAGFlow 持续推进 Web API 向 RESTful 规范迁移同时强调保持旧接口兼容。这意味着新旧客户端在迁移过程中不会被强制打断整体升级更平滑。2数据源删除文件同步能力增强本次新增了一个轻量级 snapshot 机制用于同步多个数据源中的已删除文件并尽可能真实反映远端数据源状态。该能力覆盖多个数据源说明 RAGFlow 在“同步一致性”方面进一步强化。3大量 bug 修复与安全/性能提升从元数据可见性问题、重复 chat 输出、过滤性能瓶颈到权限检查、兼容性路由、导出下载、数据集访问控制等本次版本对生产环境中的关键问题做了系统性修正。二、核心改进API 统一继续推进旧接口保持兼容v0.25.2 延续了前几个版本的方向Web API 向 RESTful 风格持续重构和统一。这类改动通常意味着路由命名更统一资源表达方式更清晰接口层次更适合长期维护客户端调用体验更一致更重要的是本次更新特别强调了一个原则所有 legacy 端点都保持向后兼容。也就是说虽然内部接口正在逐步规范化但旧版本的调用方式仍然可用。这对于正在使用 RAGFlow 的团队非常关键因为它降低了升级风险也减少了迁移成本。这次还出现了多个与 RESTful 重构相关的更新点例如文档预览/下载迁移到 RESTful API文档下载增加兼容路由完整的旧文档 API 向后兼容维护路由名称调整legacy 系统健康检查路由保留这说明 RAGFlow 并不是简单地“换接口”而是在做一套渐进式 API 重构新规范逐步落地老调用继续可用保证系统演进不中断。三、数据源同步重大升级删除文件同步机制上线本次最值得关注的功能之一是轻量级 snapshot 机制的引入。它的目的很明确用于同步远端数据源中被删除的文件从而让本地状态更忠实地反映远端真实变化。这项能力覆盖了多个数据源包括MoodleDingTalk AI TableRSSWebDAVAsanaZendeskIMAPSeafile以及本次还扩展到dingtalk-ai-tablemoodlersswebdavasanazendeskseafilerdbms从更新描述看这不是单点修补而是一次跨数据源的能力扩展。它解决的是同步系统中非常现实的问题远端数据源删了文件本地如果不知道就会产生脏数据、误检索、误展示、甚至误引用。这个机制带来的直接价值删除内容能够被更及时识别数据源状态更一致检索结果更可靠数据同步更贴近真实远端状态后续文档管理与权限控制更容易保持正确性此外这次更新中还包含了多个与同步相关的修复数据源空列表同步修复文件批量删除优化文档删除权限检查补充删除文档 UUID 校验移除连接器服务时间设置与日志间隔修正同步文档 ID 按连接器作用域隔离避免跨知识库冲突可以看出v0.25.2 不只是“支持删除同步”而是顺手把整条同步链路的稳定性、隔离性、正确性都加强了一遍。四、性能优化元数据过滤从内存处理下沉到 Elasticsearch这次版本里有一个非常明确的性能改进点元数据过滤不再在内存中处理而是下推到 Elasticsearch。这项优化非常重要因为内存过滤通常会带来以下问题数据量大时性能明显下降过滤逻辑难以扩展会产生额外的内存开销检索链路容易出现瓶颈本次改动后过滤逻辑交给 Elasticsearch 执行说明系统更合理地利用了检索引擎能力。对于大规模数据集场景这种优化往往能带来非常明显的收益。除此之外性能类修复还包括避免 embedding 累积中的 O(n²) 数组增长RocksDB 元数据并发 CREATE/DROP 冲突重试图谱构建中的合并并发和 checkpoint 恢复文件批量删除优化任务日志数量上限放宽继续优化数据过滤与检索链路这些变化表明v0.25.2 不只是修小 bug而是在处理大数据量、大并发环境下的真实使用问题。五、聊天与多模态能力增强本次在 chat 体验方面也有较多更新简化 chat并支持多模态 chat支持多模态 chat 流式输出修复聊天页面 LaTeX 公式无法显示修复双重转义的 LaTeX 反斜杠和 HTML 实体修复重复 chat 输出修复非流式工具调用追加到 chat history 的异常修复对话中的思考显示折叠与深度研究检索标签分离修复聊天页中书写公式显示问题修复部分输出与消息展示错误这些修复说明 RAGFlow 在对话层的目标并不是只做“能聊”而是进一步让复杂能力在前端表现上保持稳定。例如公式内容能正确渲染多模态请求可流式返回工具调用历史更稳定deep research 的展示标签更清晰聊天输出重复问题被处理这类体验修复对最终用户感知非常明显尤其是在知识问答、文档分析、多模态辅助场景里。六、权限控制全面收紧多处接口补上授权检查v0.25.2 在安全性方面非常明显的一点就是权限检查更严格了。多个接口都补上了 tenant 级别的授权控制或 IDOR 防护避免越权访问和跨租户泄露。本次涉及的安全与权限修复包括文档删除权限检查beta 文档下载授权检查文档下载 endpoint 加强租户授权chatbot SDK endpoint 强制 tenant 级授权memory 与 message endpoint 强制 tenant 权限文件 ancestry 接口补权限检查/files/link-to-datasets 授权缺失修复私有数据集访问检查中的越权修复agent 权限问题修复及回滚team member 无法编辑 agent 的修复hybrid 模式下认证问题修复CLI 登录、注册、注销相关修复document download 兼容路由同时保留授权逻辑这些修复共同指向一个目标多租户环境下的数据隔离必须严格。这对于企业部署尤其重要因为一旦权限边界不清晰就可能造成数据泄露或者误操作。七、模型与推理能力持续扩展更多 provider 接入v0.25.2 中模型接入能力继续扩展新增或完善了多个 provider 支持包括FuturMixVllmOllamaxAIlm-studioOpenAINvidiaOpenRouterHuggingFace阿里云相关能力ZhipuAI 的 RerankGitee AI 的 RerankSiliconFlow 的 BalanceDeepSeek 的 BalanceAliyun 的 EncodeembeddingsBedrock 相关修正MiniMax GroupId header 支持继续优化 model service 的统一调用逻辑同时还有以下相关改进使用统一的 GetChatModel减少重复函数修正 IMAGE2TEXT 到 CHAT 的 fallback 与 model_type 归一化修复本地模型连接检查的全局状态污染修复不同 provider 的 ListModels 和 CheckConnection 接口对接修复 agent completion 的兼容性支持 non-stream runtime agent completion这意味着 RAGFlow 的模型生态继续变宽同时内部调用链也在变得更统一、更可维护。八、数据集、文档、检索与 RAG 相关修复围绕数据集与文档的修复非常多覆盖面很广允许搜索多个数据集修复数据集文件页面路由错误修复数据集文件过滤 API修复 document api 的向后兼容修复知识库 prompt 中 document_metadata 为空导致的 citation 崩溃修复 tag parser id修复 handle id as keyword修复 kb_ids 在 SQL 拼接前的 UUID 校验修复文档导出元数据丢失修复文档生成器输出补充 base64修复文档转换的向后兼容修复过滤条件下 rerank 不应绕过阈值修复嵌入模型切换后已有 chunks 的恢复问题修复 shared dataset 访问时的私有数据集授权绕过修复 file ancestry 相关越权修复 dataset search 多数据集 UI修复删除 last file 的问题修复 sync 中 document IDs 按 connector 作用域隔离修复 filter api 在 dataset document 中的行为这些更新集中体现了 RAGFlow 的核心定位文档检索、数据集管理、RAG 召回、rerank、导出、转换、权限控制必须形成闭环。任何一个环节不稳定最终都会影响问答、引用和业务结果。九、开发者与 CLI 能力增强本次版本也强化了 Go 相关能力与 CLI 工具链包括CLI 支持 text、image、video 聊天CLI 登录修复CLI 注册修复CLI 注销修复Go CLI 支持数据集搜索Go CLI 支持 embed 和 rerankGo 管理 ingestion tasksGo 侧日志模块迁移到 commonGo 侧 auth 修复Go 侧 provider 实现持续扩展这些内容说明 RAGFlow 不只是 Web 产品也在持续建设命令行和程序化使用能力方便自动化、调试和运维集成。十、其他值得关注的细节修复除了上面的大方向这次版本还有不少细节修复同样影响生产稳定性版本信息修复任务日志更多展示路由名称调整树形图/画布运行路径感知修复文档预览下载元数据保留兼容历史健康检查路由支持 local provider 的代码执行组件去除部分过时模型Turkish 本地化字符串更新SSL 证书配置指南补充README 与版本引用更新release notes 和发布时间同步修正docs 全面更新到 v0.25.2这些内容虽然看起来零散但它们是成熟产品持续迭代中非常重要的一部分让系统更稳定、文档更准确、升级更顺畅、运维更友好。十一、v0.25.2 的整体意义如果把这次更新浓缩成一句话那就是RAGFlow v0.25.2 是一次以兼容性为前提、以稳定性和安全性为重点、以同步与检索性能优化为亮点的综合升级。它没有只做单一功能而是同时推进了REST API 统一删除文件同步多数据源一致性权限与安全检索性能多模态聊天模型 provider 扩展CLI 与 Go 侧增强向后兼容维护这类版本通常最适合生产环境关注因为它解决的不是表面功能而是实际落地中的关键痛点。十二、总结代码地址github.com/infiniflow/ragflowRAGFlow v0.25.2 这次更新内容非常密集覆盖范围也非常广。从 API 重构到数据源删除同步从元数据过滤性能到聊天展示修复从租户权限到多 provider 支持再到 CLI 与 Go 侧完善几乎可以说是一次“全栈型”的版本升级。