北京
RAGFlow v0.25.2 已于 2026 年 5 月 10 日發(fā)布。這一版本的關(guān)鍵詞非常明確：API 繼續(xù)統(tǒng)一、數(shù)據(jù)源刪除同步能力增強(qiáng)、權(quán)限控制更嚴(yán)格、性能瓶頸被修復(fù)、兼容性持續(xù)維護(hù)。如果你正在關(guān)注 RAGFlow 的升級(jí)節(jié)奏，v0.25.2 是一次覆蓋面非常廣的版本更新，既有架構(gòu)層面的持續(xù)演進(jìn)，也有大量面向生產(chǎn)可用性的修補(bǔ)與增強(qiáng)。
一、v0.25.2 版本總覽
本次版本主要分為三大方向：
1）API 繼續(xù)重構(gòu)與統(tǒng)一
RAGFlow 持續(xù)推進(jìn) Web API 向 RESTful 規(guī)范遷移，同時(shí)強(qiáng)調(diào)保持舊接口兼容。這意味著新舊客戶端在遷移過程中不會(huì)被強(qiáng)制打斷，整體升級(jí)更平滑。
2）數(shù)據(jù)源刪除文件同步能力增強(qiáng)
本次新增了一個(gè)輕量級(jí) snapshot 機(jī)制，用于同步多個(gè)數(shù)據(jù)源中的已刪除文件，并盡可能真實(shí)反映遠(yuǎn)端數(shù)據(jù)源狀態(tài)。該能力覆蓋多個(gè)數(shù)據(jù)源，說明 RAGFlow 在“同步一致性”方面進(jìn)一步強(qiáng)化。
3）大量 bug 修復(fù)與安全/性能提升
從元數(shù)據(jù)可見性問題、重復(fù) chat 輸出、過濾性能瓶頸，到權(quán)限檢查、兼容性路由、導(dǎo)出下載、數(shù)據(jù)集訪問控制等，本次版本對(duì)生產(chǎn)環(huán)境中的關(guān)鍵問題做了系統(tǒng)性修正。
二、核心改進(jìn)：API 統(tǒng)一繼續(xù)推進(jìn)，舊接口保持兼容
v0.25.2 延續(xù)了前幾個(gè)版本的方向：Web API 向 RESTful 風(fēng)格持續(xù)重構(gòu)和統(tǒng)一。這類改動(dòng)通常意味著：
? 路由命名更統(tǒng)一
? 資源表達(dá)方式更清晰
? 接口層次更適合長期維護(hù)
? 客戶端調(diào)用體驗(yàn)更一致
更重要的是，本次更新特別強(qiáng)調(diào)了一個(gè)原則：所有 legacy 端點(diǎn)都保持向后兼容。也就是說，雖然內(nèi)部接口正在逐步規(guī)范化，但舊版本的調(diào)用方式仍然可用。這對(duì)于正在使用 RAGFlow 的團(tuán)隊(duì)非常關(guān)鍵，因?yàn)樗档土松?jí)風(fēng)險(xiǎn)，也減少了遷移成本。
這次還出現(xiàn)了多個(gè)與 RESTful 重構(gòu)相關(guān)的更新點(diǎn)，例如：
? 文檔預(yù)覽/下載遷移到 RESTful API
? 文檔下載增加兼容路由
? 完整的舊文檔 API 向后兼容維護(hù)
? 路由名稱調(diào)整
? legacy 系統(tǒng)健康檢查路由保留
這說明 RAGFlow 并不是簡單地“換接口”，而是在做一套漸進(jìn)式 API 重構(gòu)：新規(guī)范逐步落地，老調(diào)用繼續(xù)可用，保證系統(tǒng)演進(jìn)不中斷。
三、數(shù)據(jù)源同步重大升級(jí)：刪除文件同步機(jī)制上線
本次最值得關(guān)注的功能之一，是輕量級(jí) snapshot 機(jī)制的引入。它的目的很明確：用于同步遠(yuǎn)端數(shù)據(jù)源中被刪除的文件，從而讓本地狀態(tài)更忠實(shí)地反映遠(yuǎn)端真實(shí)變化。
這項(xiàng)能力覆蓋了多個(gè)數(shù)據(jù)源，包括：
? Moodle
? DingTalk AI Table
? RSS
? WebDAV
? Asana
? Zendesk
? IMAP
? Seafile
以及本次還擴(kuò)展到：
? dingtalk-ai-table
? moodle
? rss
? webdav
? asana
? zendesk
? seafile
? rdbms
從更新描述看，這不是單點(diǎn)修補(bǔ)，而是一次跨數(shù)據(jù)源的能力擴(kuò)展。它解決的是同步系統(tǒng)中非常現(xiàn)實(shí)的問題：遠(yuǎn)端數(shù)據(jù)源刪了文件，本地如果不知道，就會(huì)產(chǎn)生臟數(shù)據(jù)、誤檢索、誤展示、甚至誤引用。
這個(gè)機(jī)制帶來的直接價(jià)值
? 刪除內(nèi)容能夠被更及時(shí)識(shí)別
? 數(shù)據(jù)源狀態(tài)更一致
? 檢索結(jié)果更可靠
? 數(shù)據(jù)同步更貼近真實(shí)遠(yuǎn)端狀態(tài)
? 后續(xù)文檔管理與權(quán)限控制更容易保持正確性
此外，這次更新中還包含了多個(gè)與同步相關(guān)的修復(fù)：
? 數(shù)據(jù)源空列表同步修復(fù)
? 文件批量刪除優(yōu)化
? 文檔刪除權(quán)限檢查補(bǔ)充
? 刪除文檔 UUID 校驗(yàn)移除
? 連接器服務(wù)時(shí)間設(shè)置與日志間隔修正
? 同步文檔 ID 按連接器作用域隔離，避免跨知識(shí)庫沖突
可以看出，v0.25.2 不只是“支持刪除同步”，而是順手把整條同步鏈路的穩(wěn)定性、隔離性、正確性都加強(qiáng)了一遍。
四、性能優(yōu)化：元數(shù)據(jù)過濾從內(nèi)存處理下沉到 Elasticsearch
這次版本里有一個(gè)非常明確的性能改進(jìn)點(diǎn)：元數(shù)據(jù)過濾不再在內(nèi)存中處理，而是下推到 Elasticsearch。
這項(xiàng)優(yōu)化非常重要，因?yàn)閮?nèi)存過濾通常會(huì)帶來以下問題：
? 數(shù)據(jù)量大時(shí)性能明顯下降
? 過濾邏輯難以擴(kuò)展
? 會(huì)產(chǎn)生額外的內(nèi)存開銷
? 檢索鏈路容易出現(xiàn)瓶頸
本次改動(dòng)后，過濾邏輯交給 Elasticsearch 執(zhí)行，說明系統(tǒng)更合理地利用了檢索引擎能力。對(duì)于大規(guī)模數(shù)據(jù)集場景，這種優(yōu)化往往能帶來非常明顯的收益。
除此之外，性能類修復(fù)還包括：
? 避免 embedding 累積中的 O(n2) 數(shù)組增長
? RocksDB 元數(shù)據(jù)并發(fā) CREATE/DROP 沖突重試
? 圖譜構(gòu)建中的合并并發(fā)和 checkpoint 恢復(fù)
? 文件批量刪除優(yōu)化
? 任務(wù)日志數(shù)量上限放寬
? 繼續(xù)優(yōu)化數(shù)據(jù)過濾與檢索鏈路
這些變化表明，v0.25.2 不只是修小 bug，而是在處理大數(shù)據(jù)量、大并發(fā)環(huán)境下的真實(shí)使用問題。
五、聊天與多模態(tài)能力增強(qiáng)
本次在 chat 體驗(yàn)方面也有較多更新：
? 簡化 chat，并支持多模態(tài) chat
? 支持多模態(tài) chat 流式輸出
? 修復(fù)聊天頁面 LaTeX 公式無法顯示
? 修復(fù)雙重轉(zhuǎn)義的 LaTeX 反斜杠和 HTML 實(shí)體
? 修復(fù)重復(fù) chat 輸出
? 修復(fù)非流式工具調(diào)用追加到 chat history 的異常
? 修復(fù)對(duì)話中的思考顯示折疊與深度研究檢索標(biāo)簽分離
? 修復(fù)聊天頁中書寫公式顯示問題
? 修復(fù)部分輸出與消息展示錯(cuò)誤
這些修復(fù)說明 RAGFlow 在對(duì)話層的目標(biāo)并不是只做“能聊”，而是進(jìn)一步讓復(fù)雜能力在前端表現(xiàn)上保持穩(wěn)定。例如：
? 公式內(nèi)容能正確渲染
? 多模態(tài)請(qǐng)求可流式返回
? 工具調(diào)用歷史更穩(wěn)定
? deep research 的展示標(biāo)簽更清晰
? 聊天輸出重復(fù)問題被處理
這類體驗(yàn)修復(fù)對(duì)最終用戶感知非常明顯，尤其是在知識(shí)問答、文檔分析、多模態(tài)輔助場景里。
六、權(quán)限控制全面收緊：多處接口補(bǔ)上授權(quán)檢查
v0.25.2 在安全性方面非常明顯的一點(diǎn)，就是權(quán)限檢查更嚴(yán)格了。多個(gè)接口都補(bǔ)上了 tenant 級(jí)別的授權(quán)控制或 IDOR 防護(hù)，避免越權(quán)訪問和跨租戶泄露。
本次涉及的安全與權(quán)限修復(fù)包括：
? 文檔刪除權(quán)限檢查
? beta 文檔下載授權(quán)檢查
? 文檔下載 endpoint 加強(qiáng)租戶授權(quán)
? chatbot SDK endpoint 強(qiáng)制 tenant 級(jí)授權(quán)
? memory 與 message endpoint 強(qiáng)制 tenant 權(quán)限
? 文件 ancestry 接口補(bǔ)權(quán)限檢查
? /files/link-to-datasets 授權(quán)缺失修復(fù)
? 私有數(shù)據(jù)集訪問檢查中的越權(quán)修復(fù)
? agent 權(quán)限問題修復(fù)及回滾
? team member 無法編輯 agent 的修復(fù)
? hybrid 模式下認(rèn)證問題修復(fù)
? CLI 登錄、注冊(cè)、注銷相關(guān)修復(fù)
? document download 兼容路由同時(shí)保留授權(quán)邏輯
這些修復(fù)共同指向一個(gè)目標(biāo)：多租戶環(huán)境下的數(shù)據(jù)隔離必須嚴(yán)格。這對(duì)于企業(yè)部署尤其重要，因?yàn)橐坏?quán)限邊界不清晰，就可能造成數(shù)據(jù)泄露或者誤操作。
七、模型與推理能力持續(xù)擴(kuò)展：更多 provider 接入
v0.25.2 中，模型接入能力繼續(xù)擴(kuò)展，新增或完善了多個(gè) provider 支持，包括：
? FuturMix
? Vllm
? Ollama
? xAI
? lm-studio
? OpenAI
? Nvidia
? OpenRouter
? HuggingFace
? 阿里云相關(guān)能力
? ZhipuAI 的 Rerank
? Gitee AI 的 Rerank
? SiliconFlow 的 Balance
? DeepSeek 的 Balance
? Aliyun 的 Encode（embeddings）
? Bedrock 相關(guān)修正
? MiniMax GroupId header 支持
? 繼續(xù)優(yōu)化 model service 的統(tǒng)一調(diào)用邏輯
同時(shí)還有以下相關(guān)改進(jìn)：
? 使用統(tǒng)一的 GetChatModel，減少重復(fù)函數(shù)
? 修正 IMAGE2TEXT 到 CHAT 的 fallback 與 model_type 歸一化
? 修復(fù)本地模型連接檢查的全局狀態(tài)污染
? 修復(fù)不同 provider 的 ListModels 和 CheckConnection 接口對(duì)接
? 修復(fù) agent completion 的兼容性
? 支持 non-stream runtime agent completion
這意味著 RAGFlow 的模型生態(tài)繼續(xù)變寬，同時(shí)內(nèi)部調(diào)用鏈也在變得更統(tǒng)一、更可維護(hù)。
八、數(shù)據(jù)集、文檔、檢索與 RAG 相關(guān)修復(fù)
圍繞數(shù)據(jù)集與文檔的修復(fù)非常多，覆蓋面很廣：
? 允許搜索多個(gè)數(shù)據(jù)集
? 修復(fù)數(shù)據(jù)集文件頁面路由錯(cuò)誤
? 修復(fù)數(shù)據(jù)集文件過濾 API
? 修復(fù) document api 的向后兼容
? 修復(fù)知識(shí)庫 prompt 中 document_metadata 為空導(dǎo)致的 citation 崩潰
? 修復(fù) tag parser id
? 修復(fù) handle id as keyword
? 修復(fù) kb_ids 在 SQL 拼接前的 UUID 校驗(yàn)
? 修復(fù)文檔導(dǎo)出元數(shù)據(jù)丟失
? 修復(fù)文檔生成器輸出補(bǔ)充 base64
? 修復(fù)文檔轉(zhuǎn)換的向后兼容
? 修復(fù)過濾條件下 rerank 不應(yīng)繞過閾值
? 修復(fù)嵌入模型切換后已有 chunks 的恢復(fù)問題
? 修復(fù) shared dataset 訪問時(shí)的私有數(shù)據(jù)集授權(quán)繞過
? 修復(fù) file ancestry 相關(guān)越權(quán)
? 修復(fù) dataset search 多數(shù)據(jù)集 UI
? 修復(fù)刪除 last file 的問題
? 修復(fù) sync 中 document IDs 按 connector 作用域隔離
? 修復(fù) filter api 在 dataset document 中的行為
這些更新集中體現(xiàn)了 RAGFlow 的核心定位：文檔檢索、數(shù)據(jù)集管理、RAG 召回、rerank、導(dǎo)出、轉(zhuǎn)換、權(quán)限控制必須形成閉環(huán)。任何一個(gè)環(huán)節(jié)不穩(wěn)定，最終都會(huì)影響問答、引用和業(yè)務(wù)結(jié)果。
九、開發(fā)者與 CLI 能力增強(qiáng)
本次版本也強(qiáng)化了 Go 相關(guān)能力與 CLI 工具鏈，包括：
? CLI 支持 text、image、video 聊天
? CLI 登錄修復(fù)
? CLI 注冊(cè)修復(fù)
? CLI 注銷修復(fù)
? Go CLI 支持?jǐn)?shù)據(jù)集搜索
? Go CLI 支持 embed 和 rerank
? Go 管理 ingestion tasks
? Go 側(cè)日志模塊遷移到 common
? Go 側(cè) auth 修復(fù)
? Go 側(cè) provider 實(shí)現(xiàn)持續(xù)擴(kuò)展
這些內(nèi)容說明 RAGFlow 不只是 Web 產(chǎn)品，也在持續(xù)建設(shè)命令行和程序化使用能力，方便自動(dòng)化、調(diào)試和運(yùn)維集成。
十、其他值得關(guān)注的細(xì)節(jié)修復(fù)
除了上面的大方向，這次版本還有不少細(xì)節(jié)修復(fù)，同樣影響生產(chǎn)穩(wěn)定性：
? 版本信息修復(fù)
? 任務(wù)日志更多展示
? 路由名稱調(diào)整
? 樹形圖/畫布運(yùn)行路徑感知修復(fù)
? 文檔預(yù)覽下載元數(shù)據(jù)保留
? 兼容歷史健康檢查路由
? 支持 local provider 的代碼執(zhí)行組件
? 去除部分過時(shí)模型
? Turkish 本地化字符串更新
? SSL 證書配置指南補(bǔ)充
? README 與版本引用更新
? release notes 和發(fā)布時(shí)間同步修正
? docs 全面更新到 v0.25.2
這些內(nèi)容雖然看起來零散，但它們是成熟產(chǎn)品持續(xù)迭代中非常重要的一部分：讓系統(tǒng)更穩(wěn)定、文檔更準(zhǔn)確、升級(jí)更順暢、運(yùn)維更友好。
十一、v0.25.2 的整體意義
如果把這次更新濃縮成一句話，那就是：
RAGFlow v0.25.2 是一次以兼容性為前提、以穩(wěn)定性和安全性為重點(diǎn)、以同步與檢索性能優(yōu)化為亮點(diǎn)的綜合升級(jí)。
它沒有只做單一功能，而是同時(shí)推進(jìn)了：
? REST API 統(tǒng)一
? 刪除文件同步
? 多數(shù)據(jù)源一致性
? 權(quán)限與安全
? 檢索性能
? 多模態(tài)聊天
? 模型 provider 擴(kuò)展
? CLI 與 Go 側(cè)增強(qiáng)
? 向后兼容維護(hù)
這類版本通常最適合生產(chǎn)環(huán)境關(guān)注，因?yàn)樗鉀Q的不是表面功能，而是實(shí)際落地中的關(guān)鍵痛點(diǎn)。
十二、總結(jié)
代碼地址：github.com/infiniflow/ragflow
RAGFlow v0.25.2 這次更新內(nèi)容非常密集，覆蓋范圍也非常廣。從 API 重構(gòu)到數(shù)據(jù)源刪除同步，從元數(shù)據(jù)過濾性能到聊天展示修復(fù)，從租戶權(quán)限到多 provider 支持，再到 CLI 與 Go 側(cè)完善，幾乎可以說是一次“全棧型”的版本升級(jí)。
我們相信人工智能為普通人提供了一種“增強(qiáng)工具”，并致力于分享全方位的AI知識(shí)。在這里，您可以找到最新的AI科普文章、工具評(píng)測、提升效率的秘籍以及行業(yè)洞察。 歡迎關(guān)注“福大大架構(gòu)師每日一題”，發(fā)消息可獲得面試資料，讓AI助力您的未來發(fā)展。
特別聲明：以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺(tái)“網(wǎng)易號(hào)”用戶上傳并發(fā)布，本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.
