RAGFlow 在 2026 年 7 月 7 日发布了 v0.26.4。从这次版本说明来看v0.26.4 并不是单点更新而是一轮覆盖面非常广的系统性迭代既有 NLP 分词能力的增强也有 Go 架构继续推进后的大量对齐与补齐既修复了 MCP、Agent、知识库、文档解析、标签、过滤器、界面交互等多个使用层面的具体问题也进一步完善了 RAPTOR、GraphRAG、文件同步、编译工作流、数据库迁移、CLI 构建与文档配套。一、版本概览RAGFlow v0.26.4 发布于 2026 年 7 月 7 日。本次更新主要包含三部分新特性问题修复变更明细其中最值得关注的方向有四个NLP 与分词链路增强Go 后端进一步统一与对齐Agent、MCP、知识库链路大量修复文档解析、RAPTOR、GraphRAG 等数据处理能力继续打磨二、v0.26.4 的新特性1. NLP 与 Tokenization 升级这次版本在 NLP 与分词方面带来了明确增强新增支持 16 种语言的语言感知 Snowball 词干提取器将数据集语言参数贯穿到整个分词处理链路前端新增荷兰语支持同时新增了 BM25 分词对荷兰语的原生支持这部分更新非常重要。它意味着 RAGFlow 在多语言处理上进一步向“全链路一致”靠拢。此前很多系统虽然支持多语言界面但分词、检索、词干化、BM25 召回这些关键环节并没有真正完成一致性打通。v0.26.4 的变化在于不只是单独加了一个前端语言而是把“数据集语言参数”真正传进了 tokenization pipeline这会直接影响检索质量和跨语言数据处理的表现。2. 知识编译工作流上线本次加入了knowledge compilation workflowssession 与 memory 数据的 gbrain compile template一些 wiki 模板从版本说明看这些能力都围绕“知识编译”和“模板化沉淀”展开说明系统在知识组织、会话数据、记忆数据处理方面进一步标准化。3. Agent 能力增强Agent 相关新增点包括在 Agent canvas 中为每个 LLM 节点暴露 thinking mode 控制begin 节点支持 JSON object 输入Go 后端补充内置 Agent 模板种子增加 BGPT 组件及其输入表单这些变化虽然分散但放在一起看会发现 Agent 的配置能力、可视化能力和 Go 端可用性都在同步增强。4. 文本切分与分块后处理增强Go 方向新增了两项很关键的能力chunk pipeline 新增长度切分策略并支持 overlap后处理过滤器中支持丢弃空 chunk 和重复 chunk这两点直接作用于知识入库质量。前者更灵活后者更干净有助于减少重复噪声和无效切片。5. Harness 与事件能力扩展本次更新加入event sourcing and replay to harness移除 naive inline graph engine统一图执行到单一 pregel engine这说明底层执行框架在继续收敛朝着更加统一、可回放、可追踪的执行模型发展。6. Go 服务与工程能力继续推进Go 相关新增和调整包括将三个服务统一为一个二进制增加 file syncer service framework增加 migrate database flag多轮 agent PR 迁移到 GoGo 与 Python 的 ingestion 边界对齐Go parser backend 与 PDF pipeline 对齐 PythonGo 侧补充缺失的 chunk method、模板、组件和表单这一系列变化非常集中体现出 Go 后端正在从“功能补齐”走向“架构统一”。三、官方列出的重点问题修复官方在版本摘要中单独点出了以下问题这些都是实际使用中影响比较明显的点1. LM-Studio 模型名包含 时触发 ValueError系统在解析包含 符号的 LM-Studio 模型名时会崩溃。v0.26.4 修复了这一问题并且在 Agent 模板拆分等多个位置也加入了对 变量名的防御处理。2. MCP 服务端因 /chats 返回分页字典而崩溃list_chats 原先预期 /chats API 返回的是列表但实际收到的是分页字典结构因此 MCP server 会崩溃。v0.26.4 已修复对字典响应的处理逻辑。3. Docling 解析器会静默丢失数学公式这是一个非常关键的文档解析问题。之前数学公式没有被正确提取而是直接被静默丢弃。v0.26.4 修复后Docling parser 可以正确提取文档中的数学公式。4. metadata 行内编辑无法持久化到后端用户对 metadata value 的 inline edit 在界面上看似修改成功但没有真正保存到后端。本次版本已修复。5. 批量把文件链接到数据集时会删除已有链接这个问题会直接影响知识库管理结果。之前 bulk linking files to datasets 时系统会误删原有链接。v0.26.4 修复后已有关联关系会被保留。6. 过滤器无法使用中文这是中文用户会非常在意的问题。本次明确修复了 filter to use Chinese。7. 标签权重没有严格限制为大于 0系统此前没有强制 tag weight 必须大于 0。本次版本补上了这条校验规则。8. Agent prompt 下拉菜单布局错乱前端界面层面的一个明显问题。v0.26.4 修复了下拉菜单布局异常。9. Laws chunker 错把点号编号交叉引用识别为标题对于法律类文本切分这会影响结构识别。此次修复后dotted-number cross-references 不会再被误判为 heading。10. 编辑 MCP server 名称时允许保存重复名称这会导致 MCP server 管理混乱。此次版本已修复重复命名校验。11. 系统允许导出空的 MCP server 选择空选择原本不应被导出。v0.26.4 已补上防护。四、按模块梳理 v0.26.4 的全部变更下面按照模块将变更清单完整整理。四点一 Go 架构与服务层变化本次 Go 方向更新非常密集包括将三个服务统一为一个二进制增加文件同步服务框架修复 list services多处 Go 重构更新错误信息CLI 中移动 order、columns、sort、group by 相关处理文档上传后默认应为 enabled为新租户补上缺失的 resume chunk method数据库迁移 flag 新增修复 ragflow-cli 构建修复 releaseCLI 构建时去掉 cgo修复 cgo build重构 UUID functions修复开发指南这部分说明 Go 化在继续提速而且不只是业务功能还包括构建链路、发布链路、迁移能力、CLI、开发文档等全套工程能力。四点二 知识库、文件、文档与数据处理链路知识库和文档处理本次修复了很多实际问题修复竞态条件导致重复出现 skills 和 .knowledgebase 文件夹批量链接文件到知识库时保留原有链接删除带有关联文档的文件时修复 KB counter drift文档和文件访问检查补齐上传文档默认 enabled上传部分成功的数据保持为数组被引用文件不显示的问题修复在空数据集场景下缺失 ES 或 OpenSearch 索引时check_embedding 不再返回 HTTP 500memory 名称不会因为 description 更新而自动追加 (1)这部分更新虽然看上去“碎”但其实都很影响日常使用。尤其是文件关联、上传状态、访问校验、部分成功结果结构、引用文件显示等都是知识库系统中最常见也最容易引发困惑的细节。四点三 文档解析与 PDF 管线文档解析是这次版本的重点之一Docling parser 现在可以提取数学公式PDF parser 重构Go parser backend 与 Python 对齐Go 的 PDF pipeline 与 Python 对齐文档导出时会去掉 reasoning model 的 thinking tags修复 closed image 上操作导致的 ValueError修复 document parsing 因 Langfuse flush 或 shutdown 死锁而冻结的问题这说明文档处理链路不仅修复了显性 bug也在做后端一致性和稳定性加固。四点四 NLP、分词、过滤与切分这一块更新非常集中引入支持 16 种语言的语言感知 Snowball 词干提取器数据集语言参数贯穿 tokenization pipeline前端新增荷兰语BM25 tokenization 原生支持荷兰语修复 filter 使用中文Laws chunker 不再把点号编号交叉引用误判为标题新增长度切分策略并支持 overlap后处理过滤器丢弃空 chunk 与重复 chunk这说明 v0.26.4 在文本预处理上既做了国际化也做了规则精度提升。四点五 Agent 模块更新Agent 是本次修复最密集的区域之一完整变更包括AkShare 已迁移到 ToolBase可作为 Agent tool 使用Crawler 已迁移到 ToolBase可加载和运行agent chat completions 无法使用的问题修复修复无法从本地导入 mcp修复无法获取 MCP tools修复无法在 agent-log 中获取 query修复通过 doc_id 启用 MCP 文件预览收集 ReAct tool 响应中的 CodeExec artifactsGo backend 支持 Agent 单组件调试Agent canvas 中支持每个 LLM node 的 thinking mode 控制Go 端调试输入表单与 Python 对齐Yahoofinance 的输入和运行修复ExeSQL 与 Browser agent nodes 缺失输入表单的问题修复Go agent web 修复 BGPT canvas form watcher 使用Go agent 新增 BGPT component 与 input formbegin node 支持 JSON object 输入修复 Agent Chat 不工作修复 Agent session 丢失 tagAgent 更新时保存 draft version限制 Agent 只能使用与 embedding model 兼容的 memory从这个列表可以看出Agent 这次不是单纯修一个点而是从工具适配、输入表单、日志、调试、兼容性、会话标签、草稿保存到组件接入都做了补齐。四点六 MCP 相关更新MCP 在 v0.26.4 中也获得了系统修复list_chats 兼容 /chats API 返回分页 envelope 字典防止导出空的 MCP server 选择防止编辑时保存重复的 MCP server 名称修复无法获取 MCP tools修复本地导入 MCP启用通过 doc_id 的 MCP 文件预览这说明 MCP 的“可管理性”和“稳定性”都有提升。四点七 Team、Memory、Search 与权限相关修复这部分看似不起眼但都跟团队协作相关permissionme 时获取 team memory 的问题修复获取 team member chat 的问题修复团队 search 在自己的 search-list 中显示问题修复memory update 失败时去掉重复 error toastmemory 名称不再因描述更新自动加后缀Agent 限制使用与 embedding model 兼容的 memory这些修复主要集中在权限、显示和一致性层面。四点八 RAPTOR、GraphRAG 与聚类链路数据组织和图增强能力也有多项更新限制 RAPTOR UMAP 的 n_neighbors避免大数据集 OOM无法运行 raptor 的问题修复小 RAPTOR 层级改为一步折叠而不是每层一个节点RAPTOR GMM 在小型降维簇场景下更稳健GraphRAG 过滤 negative-judgment 和 misattributed relationship edges这部分更新主要围绕稳定性、内存占用和图关系质量展开。四点九 Harness 与执行引擎Harness 的更新包括修复 DAG slow-branch test 中因 pregel engine 的 nil 初始化导致的问题移除 naive inline graph engine统一到单一 pregel engine增加 event sourcing and replay可以看出这部分是在持续推进底层执行框架的一致化。四点十 前端界面与交互修复界面层面本次也修了不少细节agent prompt dropdown menu 布局错乱修复visual input file label 本地化MoveDialog 组件优化 folder data handlingconfirm delete dialog 防止文本溢出Referenced files not displaying 修复PageIndex 不工作问题修复这些都是用户日常能直接感知到的变化。四点十一 标签、元数据与导出导入相关修复这部分更新包括metadata 行内编辑值无法持久化到后端的问题修复tag weight 必须大于 0Agent session 丢 tag 修复文档导出剥离 reasoning model thinking tagssimilarity threshold fallback 改为使用 nullish coalescing四点十二 Provider、模型与时间戳相关修复 providers 列表顺序问题修复 OpenAI response created timestamp修复包含 的模型 ID 在 list_tenant_added_models 中触发 too many values to unpack 的问题在 Agent 模板拆分位置加强对 变量名的防御四点十三 安全、依赖与环境crawl4ai 升级到 0.9.0修复 nats host封装终端颜色输出并增加跨平台颜色检测docs 更新 Docker 构建说明development script 更新四点十四 发布、文档与仓库展示相关本次还有不少面向发布与文档的修正更新 READMEs 和 docs 中的版本引用到 v0.26.4新增 v0.26.4 release notes修复 docker pulls badge修复 release badge 的缓存修复 french 的 camo cache修复 gitee mirrors 的 logo这些内容虽然不直接影响核心功能但对于文档一致性、发布可见性和项目展示都很重要。五、v0.26.4 的几个核心价值点基于全部变更内容可以把这个版本的价值浓缩成以下几点1. 多语言处理更完整有了 16 种语言词干化、数据集语言参数打通、荷兰语前后端支持RAGFlow 的多语言能力更加成体系。2. Go 后端更接近主线能力从服务统一、解析对齐、Agent 能力补齐、模板补种到 CLI 构建修复这说明 Go 方向正在快速追平并整合原有能力。3. Agent 与 MCP 更可用了Agent 工具、输入表单、调试、日志、Memory 兼容性、Chat 可用性以及 MCP 的导入、预览、分页响应、重复命名校验等都直接改善了使用体验。4. 文档解析与知识库管理更稳数学公式提取恢复、访问校验补齐、批量链接保留已有关系、文档上传默认启用、引用文件显示修复、导出清洗 thinking tags这些都让知识处理链路更完整。5. RAPTOR、GraphRAG、Harness 继续走向稳定OOM 防护、小簇稳健性、层级折叠、关系边过滤、事件回放、统一执行引擎说明底层智能处理能力在进一步“工程化”。六、完整更新清单汇总为了方便收藏和转发这里再做一次完整汇总不遗漏任何变更点发布 v0.26.4新增支持 16 种语言的语言感知 Snowball stemmer数据集语言参数贯穿 tokenization pipeline前端新增 Dutch修复包含 的 LM-Studio 模型名解析崩溃修复 MCP server 在 list_chats 遇到分页字典响应时崩溃修复 Docling parser 丢失数学公式修复 metadata 行内编辑值未持久化到后端修复 bulk-linking files to datasets 时移除现有链接修复 filter 无法使用中文修复 tag weight 未限制为大于 0修复 agent prompt dropdown menu 布局异常修复 Laws chunker 将点号编号交叉引用误判为标题修复编辑 MCP server 时允许重复名称修复允许导出空 MCP server 选择三个服务统一为一个二进制增加 knowledge compilation workflows增加 file syncer service frameworkAkShare 迁移到 ToolBase修复 skills 与 .knowledgebase 文件夹竞态重复修复 harness DAG slow-branch 与 pregel engine nil 初始化问题统一代码格式化bulk linking files to knowledge bases 保留已有链接修复 agent chat completions 无法使用修复无法从本地导入 mcp修复无法获取 MCP tools修复删除带关联文档文件时 KB counter drift防止导出空 MCP server 选择防止编辑 MCP server 时出现重复名称修复 list services本地化 agent form 中的 visual input file label优化 MoveDialog 组件的 folder data handling多处 Go 重构Crawler 迁移到 ToolBaseharness 统一图执行引擎到单一 pregel engine多项 Agent PR 迁移到 Go增加 session 和 memory 数据的 gbrain compile template修复 permissionme 时获取 team memory修复获取 team member chat修复团队 search 出现在 own search-list 的问题修复 providers 列表顺序修复 agent-log 无法获取 query在模板拆分位置增强对 变量名的防御更新 Go 错误信息CLI 调整 order、columns、sort、group by通过 doc_id 启用 MCP 文件预览更新 Docker 构建文档更新 development script增加 wiki templates删除 canvas_app.py 和 evaluation_service.py限制 RAPTOR UMAP n_neighbors 防止大数据集 OOMGo ingestion 边界与 Python 对齐重构 pdf parser收集 ReAct tool 响应中的 CodeExec artifactsGo backend 支持 Agent 单组件调试修复 Elasticsearch skill search field mapping补充 document 和 file 访问检查Agent canvas 中按 LLM node 暴露 thinking mode 控制Helm chart 默认 minio image 切换再次迁移 Agent PR 到 Go修复 Docling 数学公式提取REST API 中 memory message limit 和 top_n 限制到最大页大小修复 nats host修复 Laws chunker 误判修复 metadata 行内编辑持久化Go agent debug input form 与 Python 对齐Go chunk pipeline 新增长度切分策略和 overlapGo 后处理过滤器丢弃空 chunk 和重复 chunk修复 OpenAI response created timestamp修复 agent prompt dropdown menu 布局修复 tag weight 大于 0 校验修复 Agent session 丢失 tagGo 合并函数修复 filter 使用中文上传文档默认 enabled移除冗余函数并将 run_raptor 调整为 do_raptor修复 Yahoofinance 输入和运行修复 ExeSQL 和 Browser agent nodes 缺失输入表单上传部分成功数据保持数组结构为新租户补充 resume chunk methodGo parser backend 与 PDF pipeline 对齐 PythonGraphRAG 过滤 negative-judgment 和 misattributed relationship edges缺失 ES 或 OpenSearch 索引时 check_embedding 不再报 HTTP 500小 RAPTOR 层级一步折叠修复 MCP list_chats 处理字典响应RAPTOR GMM 在小 reduced clusters 更稳健Workflow agent completions 在省略 stream 时默认 streamTrue 的问题修复crawl4ai 升级到 0.9.0harness 增加 event sourcing 和 replayBM25 tokenization 原生支持 Dutch修复模型 ID 包含 时 list_tenant_added_models 报错封装终端颜色输出并增加跨平台颜色检测修复 BGPT canvas form watcher 使用使用 slices.Contains 简化代码Go agent 增加 BGPT 组件与 input formGo backend 补充内置 Agent 模板begin node 支持 JSON object 输入修复 Agent Chat 不工作文档导出剥离 thinking tags修复 memory update 失败重复 error toast修复 confirm delete dialog 文本溢出修复开发指南限制 Agent 使用与 embedding model 兼容的 memory修复 referenced files 不显示Agent 更新时保存 draft version修复 go-pipeline 列出 agents 时错误过滤 ingestion pipelines修复 closed image 上的操作异常修复无法运行 raptorsimilarity threshold fallback 改为 nullish coalescing重构 UUID functions修复 docker pulls badge修复 release badge 缓存修复 french camo cache修复 PageIndex 不工作修复 gitee mirrors logo修复 Langfuse flush 或 shutdown 死锁导致 document parsing 冻结修复 memory 名称因 description 更新自动追加 (1)READMEs 与 docs 版本引用更新到 v0.26.4新增 v0.26.4 release notesGo 增加 migrate database flag修复 ragflow-cli building修复 releaseCLI 构建去掉 cgo修复 cgo build七、结语RAGFlow v0.26.4 是一个非常典型的“工程质量版本”。它没有用特别夸张的新功能去吸引眼球但它做了大量真正影响系统可用性和稳定性的工作多语言分词更完整了中文过滤可用了数学公式不再丢了MCP 和 Agent 大量细节问题被修掉了Go 后端继续快速对齐主线能力RAPTOR、GraphRAG、Harness 这些底层链路也在持续稳固。