Samge0/ragflow-upload

解决的问题

该工具解决了默认 RAGFlow 知识库上传界面的限制，通常一次上传的文件数量有限。它自动将本地目录及子目录中的大量文档导入 RAGFlow 知识库，无需手动分批和等待，实现了大规模文档导入的自动化。

工作原理

作为客户端（可作为独立可执行文件或 Python 脚本使用）运行，与 RAGFlow API/SDK 交互。该工具扫描指定的本地目录中支持的文件类型（如 .md、.txt、.pdf、.docx），将文件上传至目标知识库，并触发解析和分块处理。同时支持通过配套的 .meta.json 文件添加自定义元数据。

适用人群

需要将大型数据集或本地归档文件（如笔记集合或技术手册）高效迁移到 AI 知识库的 RAGFlow 用户（v0.26.2+）。

主要特性

• 自动分批处理：自动遍历目录，批量上传并解析文档。
• 进度追踪：实时监控解析进度，并保存状态记录，中断后可跳过已处理文件。
• 元数据支持：通过 JSON 文件为文档附加自定义元数据。
• 灵活分块：支持多种 RAGFlow 分块方法，包括 naive、general、paper、book、laws、presentation、manual 和 qa。
• 独立客户端：为不想运行 Python 代码的用户提供 Windows、macOS 和 Linux 的预编译二进制文件。