ragflow v0.27.3 发布：Go 后端迁移、Agentic RAG、解析能力、知识库检索与安全修复全面更新

2026 年 10 月 23 日，RAGFlow 发布 v0.27.3。本次版本覆盖 Go 后端迁移、Agentic RAG、文档解析、知识库编译、检索与重排、数据源连接器、存储可靠性、前端交互、API 权限校验、模型管理、安全防护以及多项测试与构建改进。

从更新内容看，v0.27.3 的重点之一是持续将核心能力迁移到 Go，包括 Agentic RAG、飞书 Wiki 连接器、API 路由与集成测试。同时，版本也针对文档解析与知识库构建中的多个边界场景进行了修复，例如大规模稀疏表格、JSON BOM、XLSX 问答切分、PDF 注释数组、DOCX 预览循环更新、HTML 片段解析等。

一、Go 后端与 Agentic RAG 持续迁移

v0.27.3 继续推进 Agentic RAG 向 Go 后端迁移。

本次更新包括将 Agentic RAG 移植到 Go，以及将相关 Agentic RAG 变更同步迁移到 Go。除此之外，还增加了 Go 相关集成测试，用于覆盖迁移后的实际运行链路。

在 Agent 与检索相关能力上，本次版本还优化了多个关键逻辑：

• 修复 Agent 在比较检索知识库时使用原始 embedding 标识的问题，改为根据解析后的嵌入模型进行比较。

• 检索节点和检索工具支持document_ids，允许按指定文档范围执行检索。

• UI 聊天在 Go 1.0 中会传递pass_all_history_messages=false。

• Python Webhook 的追踪信息追加操作改为原子操作，避免并发场景下的追踪记录问题。

• QQBot 保留分发任务的引用，避免回复任务被丢弃。

• 企业微信支持绑定 Agent。

• SDK 修复 Agent 回答引用丢失的问题，确保回答中的引用信息能够保留。

• SDK 修复分块中的图片标识丢失问题，保留分块关联的图片标识。

• MCP 工具在Info()中会转换工具输入 Schema 的 properties。

• MCP 请求会发送 rerank 候选数量，使检索分页可以在超过 64 条结果时正常工作。

• 调用层能够容忍不同运行时中的无效请求头，提升跨运行时处理兼容性。

• Ollama 在生成视觉描述时禁用推理能力。

这些调整覆盖了 Agent 调用、工具参数、会话历史、结果引用、检索范围、MCP 集成以及渠道消息分发等关键环节。

二、知识库检索、编译与知识图谱能力改进

知识库检索与编译是本次版本的另一项重点。

在检索质量方面，v0.27.3 增加了自然文本重排能力。重排将基于自然分块文本进行，而不是基于已经分词处理的content_ltks。这意味着重排输入更贴近原始语义文本。

在知识库编译和文档状态同步方面，更新包括：

• 文档状态变化时更新知识库工件。

• 按任务类型拆分知识编译日志。

• 移除未使用的知识编译代码。

• 避免嵌套编译器池中的嵌入死锁问题。

• 树结构与 PageIndex 编译流水线新增 claim 和 evidence。

• 知识图谱中同名实体会被合并。

• Wiki 编译页面补充检索字段写入，使已编译页面可以被检索。

• Wiki 中由 MAP 提取的分块会被视为缓存命中，而不是缺失。

• Go API 修复 Wiki 版本历史始终为空的问题，原因是页面 slug 键不匹配。

• 结构图谱会从原始行中发现 bucket。

• 删除 Go 工件删除 API。

• 移除内部命令行中的“从文件插入分块”和“从文件插入元数据”功能。

对于 PDF 解析得到的表格，书籍分块方法现在会将其正确分配到tbls字段中，避免表格内容在书籍切分流程中未被正确归类。

三、文档解析、分块与多格式兼容性增强

文档解析能力在 v0.27.3 中获得了大量细节修复，涵盖 PDF、DOCX、XLSX、HTML、JSON、表格、图像解析等多个方向。

在解析器输出结构上，解析器输出被统一为结构化 JSON 项。此项调整有助于统一不同解析器的结果格式。

在电子表格和表格处理方面，更新包括：

• 修复大规模稀疏电子表格处理问题。

• 修复 JSON 文件携带 BOM 时的解析问题。

• 修复 XLSX 问答分块问题。

• XLSX 电子表格会以带类型的表格分块形式输出。

• 修复多行表格单元格中问答对被丢弃的问题。

• 分块器在每次hardSplitPiece迭代中只进行一次 BPE 处理，而不是两次。

• 数据流保留标量文本输出形状。

• 支持在保存数据库字段时自定义文件扩展名。

• 支持解析 HTML 片段，而不仅仅是完整 HTML 文档。

在 PDF 与文档预览方面，更新包括：

• 修复间接 PDF 注释数组的处理问题。

• 修复 DOCX 预览中的无限更新循环。

• 构建层对pdf_oxide版本门槛进行后缀版本适配，避免版本字符串带后缀时判断错误。

• VisionFigureParser 支持将lang作为命名参数传入。

• MinerU API 的错误响应体会被展示，并重新抛出解析失败错误。

在文档更新与任务控制方面，更新包括：

• 文档更新时校验不可变字段。

• 任务取消操作按照数据集访问权限进行授权。

• 数据集文档下载路由在 Go API 中按租户进行授权。

• 嵌入检查样本数量增加校验。

• 空的metadata_condition.conditions列表会被视为无过滤条件。

• 元数据过滤结果会与调用方可访问的文档范围进行交集处理。

四、Wiki、数据源与飞书连接器更新

v0.27.3 新增和完善了飞书 Wiki 数据源能力。

数据源侧新增飞书 Wiki 文件连接器，Go 后端同步器也新增飞书 Wiki 连接器支持。这使飞书 Wiki 的文件与内容同步能力进一步进入 Go 后端链路。

同时，MySQL 和 PostgreSQL 同步支持file_extension，可以为同步后的文件指定扩展名。

Wiki 模块还修复了多个体验和数据一致性问题：

• 进入 Wiki 后，即使没有实际修改，右上角也会错误显示存在修改的情况得到修复。

• Go API 中 Wiki 版本历史为空的问题得到修复。

• MAP 提取出的分块会视作缓存命中。

• 已编译 Wiki 页面会写入检索字段，使其能够被搜索和检索。

五、模型、推理与运行时组件更新

模型和运行时方面，本次版本包含以下更新：

• 新增 AnonRouter 模型提供方。

• 删除模型提供方时，提供方模型和实例会在同一个事务中删除。

• ONNX Runtime 原生运行时统一升级至 1.29.0。

• 移除 beartype 的包级导入钩子。

• 移除已废弃的函数。

• 修复原生后端测试失败问题。

• 增加 Infinity 相关测试，覆盖 SQL 字面量转义。

• 模板侧对齐数据分析 CodeExec 提示词。

其中，模型提供方及实例采用同一事务删除，有助于保证删除过程的一致性。ONNX Runtime 原生组件统一版本，则使运行时依赖保持一致。

六、缓存、存储与后端可靠性优化

在缓存与存储方面，v0.27.3 带来多项可靠性改进。

缓存后端从 Valkey 8 迁移到 apache/kvrocks:2.16.0。

对象存储与后端重试逻辑也获得增强：

• 对临时 S3 失败进行重试。

• 重试后保留原始错误。

• 后端重试过程中保留错误信息。

• 修复存储层重试后错误被覆盖或丢失的问题。

这些调整主要聚焦临时故障场景下的错误可见性与重试行为，避免重试逻辑掩盖最初发生的实际错误。

七、安全、权限与请求防护修复

安全与权限控制是本次版本的重要组成部分。

v0.27.3 包含以下安全和授权调整：

• 任务取消按照数据集访问权限进行授权。

• 数据集文档下载接口在 Go API 中按租户进行授权。

• 元数据过滤结果与调用者可访问文档范围进行交集处理。

• 修复 SSRF 防护中 IPv6 过渡地址的解包问题。

• 修复ob_conn_base.py中的安全问题。

• Webhook 表单增加校验。

• 嵌入检查样本数量增加输入校验。

• 文档更新时校验不可变字段。

SSRF 防护方面，对 IPv6 过渡地址进行解包后再执行 URL 守卫检查，有助于覆盖更多地址表示形式。元数据过滤与文档作用域交集处理，则避免过滤检索结果超出调用方可访问的文档范围。

八、前端界面与交互体验修复

前端部分包含多项组件和页面体验调整。

本次更新修复了以下问题：

• TreeSelect 组件文本颜色调整。

• SelectWithSearch 下拉菜单中的文本不会再被勾选图标遮挡。

• NumberInput 的 ref 转发到实际 input 元素。

• “top n” 最小值设置为 1，并限制为整数。

• 管道日志详情查询键按作用域区分。

• DOCX 预览无限更新循环得到修复。

• 进入 Wiki 后错误显示已修改状态的问题得到修复。

• 无法删除已选择的无效数据集的问题得到修复。

• 繁体中文增加子分隔符翻译。

• 中文分隔符预览实现本地化。

这些调整覆盖表单输入、下拉选择、树形选择、管道日志、文档预览、Wiki 编辑状态以及国际化显示等场景。

九、管道、文件与操作能力改进

在流程与文件管理方面，v0.27.3 支持删除 Pipeline 中解析器操作节点所使用的文件。

这一更新使管道中的解析器操作文件可以被删除，改善文件管理能力。

同时，数据流模块修复标量文本输出形状保留问题，确保标量文本不会在数据流传递中被错误转换为其他数据结构。

十、构建、测试与工程维护调整

工程维护方面，本次版本包括：

• 新增 Go 集成测试。

• 修复原生后端 CI 测试失败问题。

• 增加 Infinity SQL 字面量转义测试。

•pdf_oxide版本门槛检查支持后缀版本。

• 移除废弃函数。

• 移除未使用的知识编译代码。

• 移除 Go 工件删除 API。

• 移除内部文件导入分块和元数据的命令行功能。

• 更新 FAQ 文档。

• 修复指向已移除docker-compose-gpu.yml的无效文档链接。

这些内容主要集中于持续清理无用代码、移除过时接口、完善测试覆盖，以及修复文档中的过期链接。

十一、v0.27.3 更新内容汇总

代码地址：github.com/infiniflow/ragflow

本次版本的关键变化可以归纳为以下几个方向：

• Agentic RAG 持续迁移至 Go。

• Agent、MCP、SDK、Webhook、QQBot、企业微信等集成能力得到修复和增强。

• 检索支持按文档标识限定范围。

• 重排基于自然文本分块进行。

• 知识编译日志按任务类型拆分。

• 树结构与 PageIndex 编译支持 claim 和 evidence。

• Wiki 页面检索字段补齐，Go API Wiki 历史问题修复。

• 飞书 Wiki 文件连接器与 Go 同步连接器上线。

• XLSX、JSON、HTML、PDF、DOCX、图像解析等文档处理能力得到改进。

• Excel 表格输出支持带类型的表格分块。

• PDF 表格可以正确进入书籍分块的表格字段。

• 缓存后端迁移至 apache/kvrocks:2.16.0。

• S3 临时失败支持重试，重试过程保留原始错误。

• ONNX Runtime 原生运行时统一至 1.29.0。

• 新增 AnonRouter 模型提供方。

• API 的任务取消、文档下载、元数据过滤等权限校验进一步加强。

• SSRF、数据库连接、安全校验等问题得到修复。

• 前端修复 TreeSelect、SelectWithSearch、NumberInput、Wiki 修改状态、DOCX 预览等多个问题。

• 文档、FAQ、构建版本判断和 CI 测试同步完善。

总体来看，RAGFlow v0.27.3 是一次覆盖范围较广的维护与能力增强版本。它在 Go 后端迁移、Agentic RAG、知识库检索、文档解析、Wiki 与飞书集成、权限安全、存储稳定性和前端可用性等方面持续推进，并通过大量边界问题修复提升整体运行稳定性。

我们相信人工智能为普通人提供了一种“增强工具”，并致力于分享全方位的AI知识。在这里，您可以找到最新的AI科普文章、工具评测、提升效率的秘籍以及行业洞察。 欢迎关注“福大大架构师每日一题”，发消息可获得面试资料，让AI助力您的未来发展。