一、版本概览ragflow v0.25.6 于2026年5月26日发布是一次覆盖Agent、RAG、API、Go 驱动、文档解析、异步调度、权限安全、国际化等多个模块的综合性更新。从这次发布内容来看v0.25.6 并不是单点功能补丁而是一次明显偏向能力补齐、体验增强、问题修复、生态扩展的版本升级。本次版本最值得关注的方向包括Agent 新增 Browser 组件让 AI 能够自主浏览和操作网页RAG RAPTOR 构建升级到 AHC 模式语义扩展从文档级别提升到数据集级别Agent 新增轻量级tool装饰器简化 Python 函数注册流程Agent 消息支持显示 base64 图片Doc Generator 文件元数据可作为独立变量暴露Agent chat completion 支持传入chat_template_kwargs/chat/completions 接口支持只发送最新消息检索阶段向量相似度权重修复大量异步、解析器、表格、HTML、日志、文档状态、空响应等问题修复Go 侧继续补充大量模型与能力驱动安全性增强包括 SSRF、防止 user_id 伪造、敏感字段泄露修复国际化完善法语翻译补齐大量缺失项最低 Python 版本提升到 3.13下面将严格按照本次发布内容完整梳理 v0.25.6 的更新要点。二、新功能Agent 新增 Browser 组件本次版本最核心的新功能之一是Agent 新增 Browser 组件。这个组件的作用是让 AI 能够自主导航并与网页交互。这意味着 Agent 不再只是被动接收页面内容而是可以具备更强的网页操作能力在实际使用中可以执行更多基于浏览器的任务。对于需要网页访问、页面交互、信息获取、在线操作等场景来说这项能力是非常关键的补强。从版本说明来看这一新增功能属于 Agent 能力层面的重要扩展也是 v0.25.6 最具代表性的新增特性之一。三、RAG 改进RAPTOR 构建引入 AHC 模式在 RAG 方面本次版本对RAPTOR 构建做了重要升级引入了AHC 模式Ψ-RAG。1. 语义扩展维度升级AHC 模式的特点是将语义扩展从文档级别提升到了数据集级别。这意味着构建索引时系统不仅仅是围绕单篇文档做语义聚合而是可以在更大范围的数据集合上进行语义建模从而增强整体的结构表达能力。2. 构建性能提升版本说明明确指出索引构建性能显著高于旧 RAPTOR在Recall5和平均 F1上也优于旧 RAPTOR也就是说这次升级不仅是“快”同时也是“准”。3. 支持模式切换用户可以在AHC和GMM模式之间切换。这说明系统保留了不同构建策略的选择能力便于根据实际场景做灵活配置。4. 本版本修复问题该特性在 v0.25.3 中已引入本次 v0.25.6 主要是修复了多个相关 Bug进一步增强稳定性与可用性。四、Agent 改进轻量级tool装饰器本次版本新增了一个非常实用的 Agent 改进轻量级tool装饰器。它的目标是简化 Python 函数注册流程让开发者更方便地把 Python 函数注册给 chat 模型使用。从开发体验角度看这种轻量化的装饰器形式能够减少样板代码提升工具定义效率。这是 Agent 工程化体验上的一个明确优化。五、Agent 改进消息支持显示 base64 图片Agent 消息现在支持显示base64 编码图片。这项改进的意义在于提高多模态消息展示能力使 Agent 消息不再局限于纯文本在实际交互中可以更自然地携带和展示图片内容这对于图文混合、截图展示、视觉信息传递等场景非常有帮助。六、Agent 改进Doc Generator 文件元数据作为独立变量暴露本次版本还改进了Doc Generator组件。现在Doc Generator 组件的文件元数据可以作为离散变量暴露出来。这意味着开发者在处理文档生成流程时可以更精细地访问和使用这些元信息提升工作流灵活性。七、Agent 改进支持传入chat_template_kwargsAgent chat completion 接口现在支持开发者传入chat_template_kwargs。这一能力的开放意味着在构建 chat completion 请求时可以对模板参数进行更细粒度的控制。从版本描述来看这是对 Agent chat completion 接口能力的一次增强。八、接口修复/chat/completions 允许只发送最新消息本次版本修复了一个非常实用的接口问题/chat/completions 现在允许请求体中只发送最新消息不再强制要求传递完整对话历史。这意味着API 调用更轻量请求体更简洁更适合“只传当前轮输入”的调用方式也更符合实际集成中的常见使用习惯这一点在版本说明中被单独强调说明是一个重要的 API 行为修复。九、检索修复向量相似度权重在检索阶段未生效本次版本修复了一个 RAG 检索相关问题向量相似度权重在检索阶段没有被正确应用。这类问题会直接影响检索结果排序和召回质量。版本修复后相关权重能够在检索阶段正确生效使检索行为更符合配置预期。十、数据集与配置页面修复本次版本修复了多个管理页面问题1. 解析器配置保存失败修复了数据集配置页面中 parser configs 无法保存的问题。2. 数据源详情页日志显示不完整修复了数据源详情页面日志不能完全展示的问题。3. 文档状态过滤失败修复了document status filtering failure的问题。这些都是影响日常运维和配置管理的关键体验问题。十一、空响应与解析修复本次版本也修复了一些更底层的健壮性问题修复了空 LLM choices response时的 crash guard 问题修复了HTML 标签在 ingestion pipeline parser output 中残留的问题修复了table parser metadata问题修复了empty file的提示问题使错误信息更清晰这些修复共同提升了 ingestion 和解析链路的稳定性。十二、RAG RAPTOR 相关修复除了 AHC 模式升级外本版本还修复了 RAPTOR 的构建问题修复了使用 Infinity document engine 时 RAPTOR 构建过程停止的问题这说明 RAPTOR 相关功能在不同文档引擎下的兼容性得到了进一步修正。十三、流式响应解析修复本次版本修复了Mistral / Upstage reasoning models 的流式响应解析问题这类问题主要影响模型流式输出的稳定解析修复后有助于提升 reasoning 模型在流式场景中的可用性。十四、异步与事件循环问题修复本次版本对 asyncio 相关问题做了集中修复包括修复asyncio event loop nesting修复fire-and-forget task问题修复asyncio.Semaphore bound to different event loop错误修复了与 asyncio 正确性相关的问题这些问题通常出现在高并发、异步任务调度或多事件循环环境中修复后将显著提升系统稳定性。十五、Agent 相关 bug 修复Agent 在本次版本中也有多项修复修复Agent component prompt variable 消失的问题修复search vector_similarity_weight相关问题修复agent attachment download api的移动问题修复agent 创建与更新 API 中 canvas_type的支持问题这些都属于 Agent 功能细节上的关键修正。十六、API 与安全性增强本次版本在 API 与安全方面也有多项重要修复1. session user_id 伪造修复修复了通过 request body 伪造 session user_id的问题。2. /dify/retrieval 权限校验修复了/dify/retrieval 中 kb ownership 校验问题。3. 敏感字段泄露防护修复了用户 API 响应中敏感字段泄露的问题。4. SSRF 防护修复了misc_utils.download_img 在 OAuth avatars 场景下的 SSRF 风险。这些改动说明本次版本对安全性进行了明显加固。十七、文档与工具能力修复本次版本还修复或增强了文档相关能力修复/documents/{id}/download相关问题后又进行了回退处理修复解析器输出中的 HTML 标签修复PDF 文档顶部红色高亮替换为黄色修复chunk 标签列表显示提供了chunk management、chat assistant、retrieval 的 SDK 和 cURL 示例修复metadata相关问题这些更新有助于提升文档处理、展示和接口调用的可用性。十八、Go 侧能力大规模补齐本次版本中Go 相关驱动和模型支持非常丰富涉及大量 provider、embed、rerank、ASR、TTS、OCR 等能力扩展。下面按内容完整整理。1. 新增或补充的 provider / driverTogetherAIn1n.aiGPUStackchatAzure OpenAI 模型驱动PPIO providerGroq providerTencent Hunyuan providerTokenPony providerHuaweiCloud model providerModelScope providerOrcaRouter providerFuturMix providerTokenHub providerAWS Bedrock provider2. 新增 embed 能力TogetherAI embedXinference embedTencent Hunyuan embed3. 新增 rerank 能力Xinference rerankNovita rerankDeepInfra rerankTogetherAI rerank4. 新增 ASR / TTS 能力Xinference ASRXinference TTSTogetherAI ASRTogetherAI TTSZhipuAI ASROpenRouter ASRGroq reasoning_chat、TTS、ASR5. 新增 OCR 能力ZhipuAI OCRBaidu OCR 输入校验PaddleOCR_Local providerhosted OCR providers 通过 drivers 路由6. 其他 Go 侧能力OpenAI audio endpoints 支持Ollama 的 chat、listmodels、embed 重写Elasticsearch functions in Go这些内容说明 Go 生态能力在本版本中持续扩展覆盖更多模型服务与多模态任务。十九、Evaluation 与测试增强本次版本还涉及评估和测试能力增强evaluation 中增加token usage跟踪增加新的restful api suite测试与测试用例改进retry 和 timeout改进CI这些变化主要提升研发质量、测试覆盖与持续集成稳定性。二十、国际化与文档更新本次版本也完成了不少文档和国际化工作将Python 最低版本要求提升至 3.13更新 README 和文档中的版本引用到 v0.25.6更新 v0.25.5 发布说明完成 Discord 集成指南初稿与草稿形式的 v0.25.6 发布说明同步完善法语翻译补齐约 1400 个缺失键这说明项目在文档、版本维护和语言支持方面也持续推进。二十一、其他修复与完善除了前述大项本次版本还包括以下修复与调整修复API 路径错误修复任务语言缺失修复模型类型加入 llm_setting修复OpenAI chat completion 与 session_id / conversation_id 关联问题修复文档下载内容类型推断相关问题后回退修复数据源详情日志显示不完整修复表格解析 metadata修复PDF 高亮颜色修复空文件报错信息修复tag list 显示修复parser config 保存问题修复restful api suite 测试修复agent attachment download API修复search vector_similarity_weight修复prompt variable 消失修复canvas_type 支持修复敏感字段泄露修复SSRF修复empty LLM choices修复event loop 相关问题这些修复覆盖了前后端、API、任务调度、解析链路和安全边界多个层面。二十二、版本总结代码地址github.com/infiniflow/ragflow总体来看ragflow v0.25.6 是一次非常全面的版本更新核心特征可以概括为Agent 能力增强Browser 组件tool装饰器base64 图片展示文件元数据独立暴露chat_template_kwargs支持RAG 能力升级RAPTOR 引入 AHC 模式构建性能和检索指标提升修复 Infinity engine 兼容问题修复向量相似度权重问题API 行为优化/chat/completions 允许只传最新消息权限、会话、路径、响应结构等问题修复稳定性全面提升async / event loop 修复parser / metadata / HTML / table 修复空响应、空文件、流式解析修复安全性增强防 user_id 伪造防敏感字段泄露防 SSRF权限校验加强生态扩展大量 Go provider、embed、rerank、ASR、TTS、OCR 能力补齐工程化完善测试增强CI 改进文档更新Python 3.13 适配法语翻译补齐如果从“升级价值”来看v0.25.6 兼具功能增强、性能优化、问题修复和生态扩张四个维度属于非常值得关注的一次版本更新。