RAGFlow v0.27.1 发布：新增 Azure DevOps、You.com 搜索，修复海量 Bug，性能大幅提升！

2026年8月29日，广受关注的开源 RAG 引擎 RAGFlow 正式发布了 v0.27.1 版本。本次更新带来了多个令人兴奋的新功能，包括全新的 Azure DevOps 数据源连接器、You.com 与 Serply 网页搜索提供商，同时对模型支持、检索性能、聊天体验等方面进行了大量改进，并修复了数十个已知问题。无论你是 RAGFlow 的老用户还是新朋友，这一版本都值得你升级体验。本文将为你详细梳理 v0.27.1 的所有更新内容，帮助你快速了解变化。

一、新功能

本次版本新增了三项重要功能，进一步扩展了 RAGFlow 的数据源接入和搜索能力。

新增 Azure DevOps 连接器（用于数据源）：用户现在可以将 Azure DevOps 中的工作项、代码仓库等数据直接同步到 RAGFlow 知识库，方便构建基于企业研发数据的智能问答系统。
新增 You.com 网页搜索提供商（用于聊天和智能体）：聊天和智能体现在可以使用 You.com 作为网络搜索后端，获取实时互联网信息，增强回答的时效性和覆盖面。
新增 Serply 网页搜索提供商（用于聊天）：除了 You.com，Serply 也被集成进来，为用户提供另一种网络搜索选择，满足不同场景下的搜索需求。

二、模型支持

在模型支持方面，v0.27.1 增加了新的提供商、补全了缺失的模型，并改进了认证方式。

新增 Synthorai 模型提供商：用户现在可以在 RAGFlow 中配置 Synthorai 提供的模型，扩展了可用的大语言模型选项。
补充缺失的 DeepSeek 模型：之前缺失的一些 DeepSeek 模型现已添加，用户可以更完整地使用 DeepSeek 系列模型。
AWS Bedrock 支持 API 密钥认证：除了原有的 IAM 角色认证外，AWS Bedrock 现在也支持直接使用 API 密钥进行认证，简化了配置流程。

三、改进

本次更新在性能、用户体验和功能细节上做了多项优化。

检索 API 暴露更多参数 ：检索 API 现在会返回 rerank_candidates_count、knn top_k 和 num_candidates 等参数，让用户更灵活地控制检索过程。
元数据过滤器下推到元数据索引：将元数据过滤条件下推到索引层执行，大幅提升了带有过滤条件的检索速度。
聊天设置表单自动滚动到错误位置：当保存聊天设置出现错误时，页面会自动滚动到错误字段，帮助用户快速定位问题。
搜索页验证已删除的知识库：在搜索页面中，系统会检查知识库是否已被删除，避免用户对不存在的知识库进行操作。

四、Bug 修复

本次版本修复了大量 Bug，覆盖了 PDF 解析、聊天、数据源同步、前端交互、模型调用等多个方面。以下是完整的修复列表：

修复聊天中 PDF 解析失败的问题
修复 Wiki 编译接受 LLM 错误响应的问题
修复 MinerU 渲染稳定性、错误可见性和代码块解析问题
修复 0 块数据集不显示、无法滚动加载更多数据集的问题
修复 QA Excel 解析器丢弃答案为零的行的问题
修复朴素解析器将空上传视为缺失二进制文件的问题
修复编码检测丢弃置信度高的检测结果的问题
修复启用推理的聊天忽略对话系统提示的问题
修复知识编译使用默认租户 LLM 而非管道 LLM 的问题
修复聊天网络搜索服务不允许为空的问题
修复 Firefox 聊天自动滚动未固定在底部的问题
修复聊天自动滚动未跟随流式答案的问题
修复选择上传后解析进度不可见的问题
修复 BigQuery 连接器错误构造 SQL 查询的问题
修复 WebDAV 列表错误未传播导致修剪数据丢失的问题
修复数据源同步中跨知识库文档 ID 冲突的问题
修复 GPUStack 模型发现和音频支持的问题
修复 Kimi K3 温度参数问题
修复未配置图像转文本模型时 OCR 文本丢失的问题
修复分层 Wiki 主题导航的问题

五、完整变更列表（What's Changed）

除了上述分类列出的内容，v0.27.1 还包含了大量底层代码优化、新功能和修复。以下是本次版本所有合并的拉取请求描述（已省略用户名和编号，按原文顺序排列）：

修复浮动聊天小部件中思考/检索块的样式
修复 GitHub 数据源未验证仓库可访问性的问题
修复测试数据源连接需要连接器名称的问题
新增数据源 Confluence
重构：移除一些未使用的模型类型
修复 API 报告模型发现失败原因而非吞掉错误
修复 GaussDB 上保留无扩展名文档后缀
修复内存：遵守自定义提取提示
修复内存：规范化无效的提取时间戳
修复内存：要求语义有效的时间戳
修复 NLP：区分字母 OOV 词项权重
修复聊天未将模型配置传递给提供商
新增聊天：自检矛盾的提示/数据集设置
新增聊天：添加 Serply 网页搜索提供商
修复清除过期的租户模型 ID
新增连接器：IMAP
修复传递 Infinity 向量相似度权重
更新思考描述
修复未配置图像转文本模型时保留 OCR 文本
修复聊天：在关闭异步通道前排空深度研究协程
新增 Deepdoc：Python 中间重放一致性工具和表格单元格填充修复
修复 Ollama：保留多模态图像
新增 CLI：添加版本标志
在 Docker Compose 中为 CPU 和 GPU 服务添加 ulimits
修复 Ollama 聊天错误
修复 RAG 合并路径中的二次去重
重构分块器：用 PairChunker/PageChunker 替换 QAChunker/PresentationChunker，删除 TagChunker
更新发布说明
新增聊天：添加 You.com 网页搜索提供商
修复在数据集创建对话框中输入法组合状态下的回车键处理
修复数据集：保留禁用的 RAPTOR 和 GraphRAG 设置
修复处理没有 ID 的租户 LLM
重构摄取：统一模块化元数据上的自动元数据，硬删除旧版平面数据
新增标题分块器：在 Go 标题系列块上强制块令牌上限
修复 Deepdoc：在表格单元格填充前丢弃嵌套 OCR 框，暴露 13/14 一致性差距
修复数据源返回两次错误
新增同步器：实现钉钉 AI 表格数据源
文档：添加数据集文档并修复断链
测试：固定裸租户模型 ID 解析
修复内存：使默认提示确定性
修复认证：在发现前去除 OIDC 颁发者尾部斜杠
新增同步器：添加 R2 连接器，支持检查点续传
新增分块器：在 TokenChunker 合并中强制硬令牌上限
修复列出所有模型时出现两个 VLM 模型类型
修复数据库：使 MariaDB 上的负 GET_LOCK 超时生效
修复保留阻塞的 GaussDB 咨询锁
新增改进增量 Wiki 编译
修复确保添加租户 OCR ID
修复在 General 和 pipeline 之间切换图像/PPT/邮件/音频时出错
修复编译模板：发出带有收缩"example"键的 Wiki 预设
修复从超级用户切换到普通用户时出错
修复摄取：为内置管道摄取日志显示数据管道列
新增同步器：添加 Moodle 连接器，支持检查点续传
重构简化同步任务服务并加强调度器恢复
新增同步器：实现数据源 Jira
修复在 RAGFlowAvatar 中为多单词名称渲染两个首字母
新增智能体：支持 OpenAI 兼容响应
修复对齐 Wiki 图和数据集日志
修复深度分页辅助函数中应用 order_by 返回值（无序 OFFSET/LIMIT 可能跳过或重复行）
修复 Web：清理解析的 Markdown 树而非字符串
修复 Deepdoc：无论空白差异如何，去重 OCR 子串片段
修复 Deepdoc：通过跨度注入保留覆盖单元格，使跨度表保留所有 TSR 行
Go：修复错误处理
修复仅将源键存储在 pipeline_operation_log.source_from 中
修复解析器：允许音频家族使用文本输出格式
修复智能体：为新会话重置执行路径
新增验证从搜索页面删除的知识库
修复 Web：保持聊天自动滚动跟随流式答案
修复知识编译使用管道 LLM 而非默认租户 LLM
修复 Kimi K3 温度
修复 Web：在 TreeSelect 过滤中保留标题匹配节点的整个子树
修复通过 DashScope 原生端点实现通义千问 TTS
修复智能体：在 agentbot 完成中绑定查询字段并清理失败的首次接触会话
修复文件：拒绝在创建/重命名中包含"/"的文件夹名称
修复内存：将内存 valid_at/forget_at 持久化为服务器本地时间而非 UTC
修复将文件重命名传播到所有关联的知识库文档
修复模型：在目录未命中时推断模型类型，使 Qwen VLM 显示 LLM+VLM 标签
修复 Go 聊天管道将图像块发送给纯文本模型（智谱 GLM 错误 1210）
修复引擎：当 NATS 引擎未初始化时返回错误而非 panic
新增重写基于 Go 的提取器操作表单
修复允许 yiyan API 密钥
修复文档存储：在池初始化中重试瞬时连接错误
修复搜索页面非全屏时的布局裁剪
修复搜索：空查询时不跳转到之前的搜索结果
新增 Go 同步器：添加 Slack 连接器，支持检查点续传
性能检索：将元数据过滤器下推到元数据索引
添加工作流用的 dockerfile_ci 并恢复单一 dockerfile
文档：在文档之间添加链接
修复 Web：点击开关设置行的任意位置都会切换开关
修复元数据：批量处理大型文档 ID 过滤器
修复数据集摄取日志除成功外没有其他类型
修复 LLM：在三个调用点统一 TTS / Seq2txt 提供者密钥解析
修复 GaussDB 上保留空聊天字段
新增提供商：当模型没有类型时应用模型类型推断
新增同步器：添加数据源 DropBox
优化同步器：优化发生错误时的返回
修复构建：命名检查所需的编译器及失败的选项
修复保留 update_metadata_to 中的非字符串值
新增连接器：SharePoint
重构前端处理不同后端服务的逻辑，使用 pickByBackend 提升代码清晰度和可维护性
修复 Web：删除单个文件后保持多选计数同步
修复删除数据集后所有者过滤计数未更新
修复 Go：对 AI 摘要使用 LLM 设置并返回原始错误消息
修复 Web：接受百度一言的单个 API 密钥
修复 Deepdoc：关闭 ocr_real 文本间隙分歧并固定字符到框匹配
修复 CLI：统计基准应用失败次数
修复 show_env：将 git 错误排除在环境报告之外
文档入口点：显示 usage() 接受的每个选项
修复 Deepdoc：在一致性重放中使 Go 表格行数与 Python 每字符 R/C 对齐
修复 Deepdoc：解决 OCR 文本间隙------PDF 解析器中的字符丢失/重复
修复 HTML 解析器将空上传视为缺失二进制文件
将智能推理智能体 RAG 移植到 eino ADK
修复 Web：为每个提供商实例卡片提供自己的表面
修复摄取：在提取器提示中遵守自动关键字/自动问题 top_n 滑块
修复 Web：容器大小改变时调整思维导图大小
修复 Web：为工具图标使用真实的 Keenable 标记
在 Docker Compose 中添加 nats 和 clickhouse 暴露端口
修复 Invoke 代理使用验证过的 URL；删除 Canvas.reset 中的多余调试打印
移除三个无操作的自赋值
文档：用相对页面链接替换根相对交叉链接
修复 OpenSearch：通过将相似度映射到 knn 提升来停止向量分数清零
回滚"将智能推理智能体 RAG 移植到 eino ADK"
修复文档格式
修复考虑检查点摄取进度
修复 workerpool：关闭 SubmitTo/StopWait 竞争且不丢失进行中的任务
修复 manual：仅匹配 .docx 使旧 .doc 干净地失败
新增 Go 同步器：添加 Salesforce 连接器，支持检查点续传
修复摄取：使用内存索引重构标签提取器，非对称覆盖，多源丰富和 worker pool 排序
安全：移除泄露的 OAuth 凭据并停止记录用户秘密
修复纠正 rerank------添加 prefetch_size
新增 Go 同步器：添加 Teams 连接器，支持位置续传
修复在检索热路径上预编译正则表达式
修复将 prefetch_size 移植到 Go
修复 Web：在浮动聊天小部件中隐藏空思考条
修复智能体：保留消息引用周围的空白
修复验证消息内容以防止空值
修复智能体中的 PDF 生成问题
补充缺失的 DeepSeek 模型
修复 SDK：温度默认值应为浮点数，而不是 1 元组
修复 task_executor：将提取的重要关键词数量限制在 ES 关键词限制内
修复一些注释
修复在 _factory_model_types 中规范化模型类型并更新 calculate_model_type
修复在 executeMemoryTask 中恢复 panic，防止毒记忆任务杀死摄取 worker
新增提取器：为关键词、问题和摘要添加内联 24 小时 Redis LLM 缓存
修复 Deepdoc：防止跨页表格因页面本地 Y 坐标而过合并
新增提取器操作符可以同时处理多个提取任务
修复聊天：停止 rag_agent 将消息簿记键转发给提供商
修复 Deepdoc：传播跨越单元格边界框使 Go 输出正确的 colspan
修复文档删除时发布 Wiki 事件
修复智能体：暴露取消终止状态
修复模型：将选定模型传入验证并捕获构造函数错误
新增 Bedrock：支持 API 密钥认证
修复将 .wmf 文件分类为 VISUAL 而非 OTHER
重构将 prefetch_size 重命名为 rerank_candidates
修复 Wiki：在没有编译配置时保护生成
文档迁移：说明备份实际覆盖的卷
修复 API：使 API 密钥主体在 POST /messages 上的豁免可达
新增智能体：添加 You.com 搜索工具
修复 RAG：将搜索查询和页面文本排除在连接器日志之外
修复管理员：正确显示 AWS S3 状态
修复细化 NLTK 数据使用目录
修复字面替换 UserFillUp 提示占位符以避免正则错误
修复字面替换 Message 变量以避免正则转义错误
修复人类可读持续时间标签中的尾随空格
修复 Web：从 history.location getter 返回真实导航状态
修复 Web：在标签输入中忽略输入法组合回车
修复在"链接到知识库"对话框中显示链接的知识库名称而非 ID
修复 Web：在嵌入式浮动小部件中显示智能体开场白
修复机器人：将聊天机器人完成最后一帧和历史持久化与 Python 对齐
修复为 SelectWithSearch 添加自定义占位符
修复添加并使用 paddleOCR.net 模型
修复 Web：在搜索时保持多选选项的声明顺序
修复 Web：使聊天附件图片可点击放大
修复 Web：使溢出的卡片描述工具提示可滚动
修复设置模型：停止静默丢弃重名提供商实例
修复 Go：按创建时间排序提供商模型实例
修复 Web：在窄视口下聊天设置面板被聊天输入重叠
修复删除所有编译实体后返回该页显示空数据条目
修复 Web：始终在浮动聊天小部件回复上显示复制按钮
修复路由：在智能体上传和附件下载上接受共享（beta）令牌
修复服务器：在 Wiki 空资格消息中区分空文档和缺失模板
修复公共：从 _list_files_recursive 传播 WebDAV 列表错误以避免修剪数据丢失
修复智能体：将爬虫响应体限制在 4 MiB
修复支持分层 Wiki 主题导航
修复邮件和演示文稿解析器将空上传视为缺失二进制文件
Go：移植停止转发簿记键的修复
修复跳过空知识编译事件
修复修改空聊天响应的错误消息
修复 MCP：在 list_datasets 输出中包含数据集名称
修复连接器：遵守配置的 S3 兼容存储桶类型
修复 PDF：colspan 组装丢失和 TSR 几何比较诊断
修复数据源同步中的跨知识库文档 ID 冲突
重构：在 /api/v1/retrieval 中暴露 knn top_k 和 knn num_candidates
新增 Go 同步器：添加 Azure Blob 存储连接器，支持检查点续传
修复管理员：在引导中遵守 DEFAULT_SUPERUSER_EMAIL/PASSWORD 环境变量
修复选择上传后文档被直接解析但解析进度不可见
修复 Web：数据集文件列表清空时回退一页
修复 Web：创建或编辑块时要求块内容非空
修复在 Python 版数据集配置页面添加聊天模型
修复 Web：保持 Firefox 聊天自动滚动固定在底部
修复智能体：防止浏览器 URL 文件上传中的路径遍历和 SSRF
修复智能体：编辑内部终端错误
修复 GPUStack 模型发现和音频支持
将 knn top_k 和 num_candidates 移植到 Go
修复 PDF：恢复被页面绝对 Y 门错误拒绝的跨页表格合并
修复 total 作为总数，跟随 Go
修复智能体：自动播放无默认 TTS 模型时出现 panic 和原始错误
修复聊天：传播思维导图流失败
修复解析器：在 PDF JSON 路径中裁剪媒体部分，统一 Data URI 和 Markdown 渲染
修复 Deepdoc：加强 opendataloader 表格单元格解析以防坏 JSON
修复 PDF：从文本层提取中去除平铺水印文本
修复智能体：默认缺失 Graph 路径，使存储的 DSL 不会 KeyError
修复 Go：PaddleOCR -> PaddleOCR.local，PaddleOCR.net -> PaddleOCR
修复聊天：在 Go 聊天管道中将上传的图像附件传递给视觉模型
新增数据源：添加 Azure DevOps 连接器
修复内存：使 Go 语义有效时间提示与 Python 措辞对齐
文档沙箱：描述容器池实际大小
修复沙箱：移除存在的沙箱容器，而非池大小范围
修复 Web：显示数据集导航树加载失败
文档：更新 27.0 发布说明
修复解析器：清理 .eml 文本输出用于分块
修复 Web：智能体探索流式答案泄漏到切换后的会话
修复 Web：停止 RAGFlow 品牌块与嵌入共享头重叠
修复沙箱：将沙箱环境与其所需的 Python 版本同步
文档 API：按服务器注册方式拼写推荐端点
文档 API：将文档更新端点记录为 PATCH
修复 MinerU 模型
修复令牌分块器推荐的块大小限制为整数
修复智能体：传播 webhook 终止状态
修复允许空的 GitHub 仓库
修复 find_codec 丢弃置信度高的编码检测并返回垃圾编解码器
修复插入块时继承文档状态
修复 naive：将配置错误的 MinerU PDF 路由到 by_mineru 而非 by_plaintext
重构解析器：跨文档格式整合视觉图形增强
修复解析器：支持 webp 图像 OCR 并纠正 VLM 门的符文计数
修复 BigQuery 连接器错误构造 SQL 查询
修复 OpenSearch：将多文档更新范围限定到目标知识库
修复接受空的 ASR 验证结果
修复 Web：限制嵌入对话框用户 ID 输入长度并添加数据类型提示
修复模型提供商：按持久化 ID 解析实例
修复 Docker：防止所有前台 entrypoint.sh 循环在非零退出时退出
新增数据源：添加 Xquik X 搜索连接器
修复 Web：跳过空节点/边的画布自动保存
修复 SDK：按多个 ID 过滤文档
修复 Web：为思考模式字段使用专用标签
修复聊天网络搜索服务允许为空
修复安全：认证沙箱执行器 API 并隔离容器网络
重构解析器：从 pptx/xls/pdf 包装器中提取共享的 parseWithTCADP 核心
修复 0 块数据集不显示导致无法滚动获取更多数据集
修复聊天：在 worker 完成后保留深度研究取消
修复 MinerU 渲染稳定性、错误可见性和代码块解析问题
修复 Web：将智能体流类型卡片放在首位
移除知识编译器类型和测试
新增当聊天设置表单有错误时，点击"保存"按钮自动滚动到错误位置
重构：在 /api/v1/retrieval 中添加 rerank_candidates_count、knn top_k 和 num_candidates
修复 Go：从 run_go_tests.sh 中删除已移除的 internal/cache 包
修复构建：在 build.sh 的清理陷阱中保留管理服务器
修复测试：让 run_tests.py --help 退出码为 0
Go：修复上下文，第三部分
新增从 xlsx 解析器提取图像
修复 PDF：不跨页合并锚点不在页面底部的表格
修复文档：在文档解析或调度时拒绝配置编辑
修复解析器：将图像输出格式对齐到 json 并使用按家族默认值（严格）
更好地增强消息
修复图：在 AnalyzeNHopPaths 中使用 max-wins 进行 PageRank 并纠正测试夹具
修复对齐跨语言提示分隔符与解析器
文档配置：命名 ragflow 服务端口键为 http_port
修复访问 Go 版 Wiki 页面时出错
重构细化错误消息------使用 %W
修复 PDF：移除未使用的上下文导入破坏手动测试构建
修复模式同步：停止报告 BaseModel 时间戳为丢弃列
修复分块器：在所有上限分割子块上保留 PDF 位置，使块不丢失预览图像
修复示例：等待 API 实际返回的 DONE 状态
修复朴素解析器将空上传视为缺失二进制文件
细化 entrypoint.sh------整理代码
修复 MCP 列表页删除最后一条记录后视图未导航到上一页
新增同步锚点续传
修复 QA Excel 解析器丢弃答案为零值的行
将 None 更新为 Naive（跟随英文）
新增 Synthorai 模型提供商
修复 OceanBase 块顺序字段持久化
修复扩展名错误时回退到真实 Office 容器格式
重构将"Fig."翻译为中文
修复 API：在启用推理的聊天中遵守对话系统提示
新增智能体：使 MCP 工具调用超时可配置
修复智能体：实现 webhook 跟踪轮询
修复 Web：保持键入的滑块值在滑块的步进网格上
修复数据集：将朴素解析器 ID 规范化为 general
修复 Web：将描述长度限制在 512 个字符
修复音频和视频解析器的模型为必填字段
修复移除已弃用的 mimo-v2-flash
修复 Web：为数据集数据源操作按钮添加缺失的悬停工具提示
新增 Go 同步器：添加 OCI 存储连接器，支持续传
测试智能体：固定模板引用模式的空白处理
修复 Web：保存后数据集自动元数据开关恢复为关闭
修复当管道解析器组件将文件类型从 PDF 切换到图像时，默认解析方法应为 OCR
修复 Web：在 One 模式下保存令牌分块器设置
修复 NLP：以 UTF-8 加载词项权重资源
修复支持 .wmf 文件扩展名不区分大小写并移除重复的 avi
修复解析器：为每次调用连接 VLM 模型配置，加强视觉调度
回滚"修复 Web：文件列表总数与显示行不匹配"
修复摄取：在画布调试运行中以无缓存方式运行 Wiki 编译器
修复拒绝 Wiki LLM 错误响应
修复聊天中解析 PDF
修复在 REST API 中隐藏技能文件夹
修复 rerank_candidates_count 验证错误
修复元数据过滤器：将解析的文档 ID 传播到检索
修复 Go 智能体标签排序与 Python 匹配
新增 Go 同步器：添加 S3 和 S3 兼容连接器
修复分块器：按比例切片 PDF 位置，使子块预览与文本匹配
修复无需验证非数据集格式的数据
修复移除默认模型并显示内置模型
文档：添加聊天文档
修复 Web：从提供商目录派生 base_url 可见性
修复处理 Jina VLM 流式响应
修复将智能体轮次映射到反应步骤
修复 OceanBase 和 SeekDB 中过大的重要关键词
修复 rag/utils：确保 v1 识别 v1beta/v1alpha 风格版本后缀
修复遵守生成参数启用标志
修复支持 SeekDB 向量分数提取
重构添加 page_size 支持
修复添加 Separator 组件并在 NaiveConfiguration 中恢复 GlobalIndexModelItem
修复 API：从数据集所有者而非聊天租户派生 SQL 检索租户
修复 Web：停止字段标签打开 MultiSelect 弹窗
修复在 NaiveConfiguration 中重新排序组件以改善结构
修复管道解析器操作符的文件类型切换导致解析方法未能切换
修复遵守输入法组合状态下的回车发送
修复构建：将 GOPROXY 传递给 ragflow-cli 的 go build
新增 Go 连接器：添加 Box 连接器
修复 Web：停止字段标签切换开关
修复数据集：在数据集所有者索引中重建导航树
文档：将 README 和文档中的版本引用更新为 v0.27.1
文档：0.27.1 发布说明

六、总结

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

RAGFlow v0.27.1 是一次内容丰富、覆盖面广的版本更新，不仅引入了 Azure DevOps、You.com、Serply 等全新集成，还大幅提升了检索性能、聊天体验和系统稳定性。大量 Bug 修复和底层优化表明开发团队对产品质量的持续打磨。如果你正在使用 RAGFlow，强烈建议升级到此版本以获得更好的使用体验。如果你还未尝试过 RAGFlow，现在正是入手的好时机。关注 RAGFlow 的后续版本，期待更多惊喜！