一、版本概览
RAGFlow 发布了 v0.26.2 Latest,发布时间为 2026 年 6 月 29 日。
本次版本更新内容非常集中,既有面向业务使用的功能增强,也有面向底层能力的稳定性修复,还包含大量 Go API、Go CLI、数据集、文档解析、聊天渠道、MCP、Dataflow、模型接入、前端体验等方面的持续演进。
从官方变更内容来看,v0.26.2 的重点主要集中在以下几个方向:
- • 聊天渠道能力继续扩展
- • 文件解析链路增强,尤其是 OCR、DOCX、Markdown、PDF、Excel 等场景
- • 数据集与文档管理能力加强
- • MCP 稳定性修复
- • Dataflow 接口与运行反馈能力恢复
- • Google Cloud Gemini 新模型区域路由问题修复
- • Go API 与 Go CLI 持续补齐与迁移
- • 多项 UI/UX、国际化、Agent、工具链、构建与发布流程修正
二、官方 Summary
Released on June 29, 2026.
也就是:RAGFlow v0.26.2 于 2026 年 6 月 29 日正式发布。
三、新功能总览
本次版本在“New features”部分给出的新增能力,主要包括聊天渠道接入和文件解析增强两大块。
1. 聊天渠道新增 WhatsApp 接入
RAGFlow v0.26.2 新增了 WhatsApp 集成能力,接入方式为:
- • 通过 二维码扫描接入 WhatsApp
这意味着在聊天渠道层面,RAGFlow 已经把 WhatsApp Web 类型的接入能力纳入支持范围。
2. 聊天渠道新增钉钉接入
新增 DingTalk(钉钉) 集成能力,接入方式为:
- • 通过 Bot API 凭据完成接入
对于企业内部消息触达与机器人对接场景来说,这属于非常直接且实用的能力扩展。
3. 聊天渠道新增企业微信接入
新增 WeCom(企业微信) 集成能力,接入方式为:
- • 通过 WebSocket 连接完成接入
这意味着 RAGFlow 在企业级沟通入口上的覆盖进一步增强。
4. 文件解析增强:PaddleOCR 管线升级
在文件解析方面,本次版本新增了两项关键能力:
- • 为 PP-OCRv6 以及类似文本识别模型增加了回退逻辑
- • 在 PaddleOCR 流水线中集成图像解析能力
这说明 RAGFlow 在 OCR 识别兼容性和图像内容解析链路上都进行了增强。
四、改进项详解
“Improvements”部分的更新看似不多,但都非常关键,集中在数据集、聊天渠道和国际化三个领域。
1. 数据集改进
1)空文件夹与数据集关联的边界场景处理
新增了一个边界检查逻辑,用于在文件摄取时:
- • 安全地将 空文件夹链接到数据集
这能避免空目录在接入数据集时出现异常或处理失败。
2)大规模数据集元数据分页支持
对 get_flatted_meta_by_kbs() 方法增加了分页能力,以防止以下问题:
- • 当数据集文档数量超过 10,000 时
- • CRUD 操作可能因为元数据查询体量过大而失败
该改进明显是为大规模知识库场景提供稳定性保障。
2. 聊天渠道改进
对聊天渠道历史会话持久化逻辑进行了优化,具体表现为:
- • 终端用户的会话历史在 系统重启后仍可保留
- • 当一个聊天渠道绑定到新的对话时,历史会话依旧 保持隔离
这解决了“历史能否持久化”和“新旧对话是否混淆”两个核心问题。
3. 国际化改进
1)韩语界面覆盖增强
- • 扩展了国际化覆盖范围
- • 优化了 韩语 UI 翻译
2)法语翻译补充
补充了以下法语翻译缺失项:
- • 聊天渠道
- • 用户名校验
- • 模型编辑
五、Bug 修复重点解读
这一部分是本次版本最关键的内容之一,涉及文件解析、MCP、Dataflow、LLM、UI/UX 多个方向。
1. 文件解析相关修复
1)DOCX 的 Heading 样式触发 ValueError
修复了如下问题:
- • 在解析
.docx文件时 - • 当遇到
Heading样式时会抛出ValueError
2)法律文档解析器误删 DOCX 表格
修复问题:
- • 在法律文档解析器中
- •
.docx文件里的表格会被静默移除
3)DeepDoc 分隔符导致 Markdown 标题与正文分离
修复问题:
- • 当设置了 DeepDoc delimiter 时
- • 孤立的 Markdown 标题会与其后续内容错误分离
4)Markdown 表格重复出现在分块结果中
修复问题:
- • Markdown 表格在 chunk 结果中出现两次
- • 一次作为独立 chunk
- • 一次又包含在普通文本 chunk 中
2. MCP 相关修复
1)空白文档页导致 MCP Server 挂起
修复问题:
- • MCP 服务端在遇到空文档页时会无限挂起
- • 文档最后一页还会因为分页逻辑缺陷被静默丢弃
2)MCP 连接与数据集发现失败
修复问题:
- • MCP 连接与数据集发现流程失败
- • 原因是服务端硬编码抓取数量上限超过了新引入的
page_size限制
3. Dataflow 相关修复
1)恢复 rerun 接口,并补全 DSL 返回
修复内容:
- • 恢复 Dataflow rerun endpoint
- • 确保 ingestion response 中包含 DSL payload
- • 以便时间线和解析器视图可以稳定渲染
2)恢复默认配置并返回真实 SSE 负载
修复内容:
- • 恢复 Dataflow parser 默认值
- • 返回真实 SSE payload
- • 使 pipeline 运行时能够正确暴露 message ID 和日志更新
4. LLM 相关修复
Gemini 3.5 Flash 在 Google Cloud Vertex AI 的区域路由问题
修复问题:
- • 通过 Google Cloud(Vertex AI)provider 使用新的
gemini-3.5-flash模型时 - • 如果使用
eu或us区域 endpoint 会失败
修复方式为:
- • 显式使用多区域路由
- • 请求发送到
aiplatform. - • 而不是使用合成的 ``
5. UI/UX 相关修复
元数据新增弹窗发送空值
修复问题:
- • metadata add modal 会向后端发送空值
六、What’s Changed 全量变更整理
下面按照官方完整变更记录,对所有更新逐条整理。为便于阅读,按主题归类呈现。
七、启动、发布、构建与环境相关变更
1. 启动与发布流程修复
- • 修复启动脚本
- • 修复发布流程
- • 修复 Windows 和 Mac 构建发布工作流
- • 为发布流程增加 nightly tags
- • 增强 release.yml 中的 Windows 构建配置
- • 修复 Windows 环境下错误的 clang/toolchain 配置
- • 修复 Windows C 编译器硬编码路径问题
- • 增强 Windows 下 office_oxide 和 rag tokenizer 的构建流程
- • 处理 arm64 平台下 SIMDe 头文件安装问题
- • 新增环境变量
ALLOW_ANY_HOST,用于跳过 host 检查
2. 依赖与安全相关
- • web 端升级 lodash,避开存在漏洞的版本范围
- • 移除 deepdoc 依赖
八、聊天渠道相关变更
这是本次版本最显著的功能扩展之一。
1. 新增聊天渠道
- • 新增企业微信 WebSocket 聊天渠道支持
- • 新增钉钉聊天渠道支持
- • 新增 WhatsApp Web 二维码聊天渠道支持
2. 聊天渠道迁移与接口完善
- • 完成聊天渠道 API 的 Go 侧迁移,并补充测试
- • 修复聊天渠道默认值问题
- • 修复 Feishu 关闭相关问题
- • 保持聊天渠道绑定关系的一致性
- • 确保终端用户会话历史在重启后仍能保留,同时在绑定到新对话时保持隔离
3. 聊天展示与配置修复
- • 修复 Chat/Search/Agent bot 显示图片问题
- • 修复 VLM 渠道请求中的多模态聊天图片路由问题
- • 修复“Flexible Chat Configuration”相关问题
- • 修复设置模型后无法继续聊天的问题
- • 当空响应未设置时,修复报错
ERROR: 'knowledge' - • 新增与聊天相关的 FormField 命名前缀
- • 修复 Agent 对话顶部弹出空消息通知的问题
九、文件解析、文档解析与 OCR 相关变更
这一部分内容非常多,也是 v0.26.2 的核心之一。
1. PaddleOCR 与图像解析
- • 为 PaddleOCR 新增模型 JSON 配置
- • 支持 PP-OCRv6
ocrResults回退逻辑 - • 在 PaddleOCR 流程中集成图像解析能力
2. DOCX 解析相关
- • 修复 DOCX 解析中
Heading样式触发ValueError - • 修复法律文档解析器在处理 DOCX 时丢失表格的问题
- • 保留 DOCX 中的表格内容
3. Markdown 解析相关
- • 修复设置 delimiter 时,孤立标题行与后续段落分离的问题
- • 修复 Markdown 表格 chunk 重复问题
- • 修复
use_sql场景下 Markdown 分隔符与 Source header 对齐问题 - • 支持 GFM 表格分隔线中一个或多个短横线的写法
4. HTML、Excel、PDF 解析相关
- • 修复 HTML parser 在拆分超大块内容时未保留原始文本的问题
- • 修复 Excel parser 在构建文本 chunk 时丢失值为 0 的单元格问题
- • 曾加入“保留零值与 false Excel 单元格”的逻辑,后续进行了回滚
- • 修复 VLM PDF parser 只解析前 12 页的问题
- • 让 PDF 默认页范围与后端保持一致
5. DeepDoc 与文本分块相关
- • 修复 DeepDoc 在 call 中丢失零值和 false 的问题后又进行了回滚
- • 修复
naive_merge对超大 section 的拆分与 overlap token 统计逻辑 - • 修复
[ID:0]未转换为Fig. 1的问题 - • 修复文档进度在 embedding model 出错时未设置为 fail 的问题
- • 修复
document_service中progress_msg.strip()可能出现的NoneType错误
6. 文件移动与存储相关
- • 修复 move file 失败的问题
- • 修复 Python RAGFlowS3 存储实现中缺失的 move 和 copy 方法
- • 恢复
/v1/document/upload_info到/api/v1/documents/upload的回补支持
十、数据集、文档与元数据相关变更
1. 数据集核心能力增强
- • 为
get_flatted_meta_by_kbs()增加分页,支持超过 10k 文档的数据集 - • 处理空文件夹链接到数据集时的边界情况
- • 新数据集无法更新配置的问题已修复
- • 新增数据集搜索接口
- • 新增数据集 tags 接口
- • 新增数据集 tags 聚合接口
- •…