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 的預先編譯二進位檔。