RAGFlow v1.0.0 正式版帮助通过查找文档生成答案的开发团队,将检索限定在用户访问权限允许的范围内。它还修复了文档结构保留和智能体执行中的错误,处理了利用检索结果补充答案时文档拆分不当或执行结果为空的问题。
1. 为检索范围应用权限和上限
检索对重新排列结果的重排序,以及查找内容相近文档的近邻搜索,都设置了候选数量上限。这种方式是在挑选用于最终回答的文档之前,先限制待审查的候选集合。
对话检索中向数据库请求条件的 SQL 查询,已修正为合并用户可访问的知识库条件。知识库是存储文档的空间。权限条件守住可检索文档的范围,候选数量上限则限制待审查候选集合的大小。删除文档片段(即分块)时,也限制在用于分组管理文档的数据集指定范围内;更新单个分块时则保留数据集和文档范围。
Dify 集成已修正为:当附加在文档上的描述信息(即元数据)的条件为空时,不缩小检索范围。
发布说明中列出的 arxiv、duckduckgo 等四个工具,其响应正文上限为 4 MiB。这项变更限制的是从工具获取的响应本身的大小。
列表 API 的页面大小上限为 100,适用于单次查询的列表条目数。响应正文上限限制字节大小,页面大小上限限制条目数量,二者是独立的限制,不能直接比较这两个数值。
2. 修复文档解析和拆分错误
修复了 PDF 页面边界处句子被截断的问题,并调整了表格处理,以保留此前遗漏的行和合并表头。还修复了 PDF 子分块相互覆盖,以及原文位置与预览不一致的问题,减少了进入检索前文档结构处理阶段的错误。
文档处理支持在解析器选项、采集路径和外部 API 兼容性这三个不同层面得到完善。用于读取文档结构的解析器新增了面向 PDF 的 MiniCPM-OCR,而 MonkeyOCR 在以 Go 实现的文档采集路径中支持 PDF 处理。MinerU 解析器针对 4.1 任务 API 完善了兼容性,并可通过环境配置调整超时时间。
还新增了取消整个文档处理队列和取消运行中任务的功能。当错误任务积压时,这项变更可减少逐一取消待处理文档的负担。
3. 完善智能体执行和外部连接
智能体方面,解决了无法找到内部子智能体组件的问题。
还修复了按预设字段生成结果的结构化输出为空的问题。
防止了保存执行状态时发生的冲突,并改为将组件和条件分支的错误传递给调用方。对于串联多个步骤的任务,这项变更有助于追踪失败发生在哪一步。
翻译和天气功能的身份验证信息改为从节点配置或专用环境变量中获取,与模型可见的参数分离。这种方式将模型处理的输入与外部服务的连接信息分开管理。
完善检索权限和输入上限后,检索与工具调用的范围更易管理。但对于基于较大候选集合或响应配置系统的团队,则需要重新检查现有配置和请求大小。
4. 根据环境安装命令行工具
正式版发布资源包含适配不同操作系统和处理器类型的 6 种命令行工具,以及安装脚本和校验和文件。
Shell 安装脚本会识别操作系统和架构,下载对应文件,并与 SHA256SUMS 对照校验和(用于验证文件完整性的摘要值),然后安装。默认安装位置为 /usr/local/bin,以下配置直接摘自脚本。
INSTALL_DIR="${INSTALL_DIR:-/usr/local/bin}"
GITHUB_REPO="${GITHUB_REPO:-infiniflow/ragflow}"
CLI_NAME="${CLI_NAME:-ragflow-cli}"
VERSION="${VERSION:-latest}"安装版本的默认值指向最新发布版。若要固定为此次正式版,需指定版本配置进行安装,也可按需更改路径。发布资源还提供 Windows 安装脚本。
v1.0.0 的核心是让检索、解析和智能体执行路径更具可预测性,升级前值得同时检查强化后的范围限制与安装方式。
