Skip to content

RAGFlow is an agent-native database: a Retrieval-Augmented Generation (RAG) engine that grew into context infrastructure.

docs(ingestion): correct stale parser-component scope comment (#18147)

Jacka4dbd898bbe7
diff --git a/internal/ingestion/component/parser.go b/internal/ingestion/component/parser.go
index 18e3e1f73a..5031a5b4be 100644
--- a/internal/ingestion/component/parser.go
+++ b/internal/ingestion/component/parser.go
@@ -44,18 +44,21 @@
// - The Python component dispatches to 13 file-format branches
// (pdf, Markdown, text&code, html, spreadsheet, slides, doc,
// docx, image, audio, video, email, epub) — see parser.py
-// function_map at line ~1273. The Go counterparts in
-// internal/parser/parser/ are SKELETONS that print to
-// stdout and return nil. The cgo-gated office variants
-// (docx, doc, ppt, pptx, xls, xlsx) call office_oxide but
-// discard the result.
+// function_map at line ~1273. The Go port is LANDed and LIVE
+// in production for the families the ingestor claims (see
+// cmd/ragflow_server.go: Ingestor.supportedTypes =
+// ["pdf","docx","txt"]); those run their real parsers,
+// including the cgo-gated office variants via office_oxide.
+// Families not yet ported fall through to the raw-text path
+// below rather than printing skeletons.
//
-// - Until the parser package returns real data, the Go Parser
-// component uses a "raw text" fallback: it treats the input
-// binary as UTF-8 and slices it into 1 page (or N pages
-// when the upstream signals a page boundary with a literal
+// - For any family NOT yet ported (its Go parser returns no real
+// data), the component uses a "raw text" fallback: it treats
+// the input binary as UTF-8 and slices it into 1 page (or N
+// pages when the upstream signals a page boundary with a literal
// "\f" form feed). This is the conservative, observable
-// behaviour until the real format dispatch lands.
+// behaviour for UNPORTED families only; ported families run
+// their real parsers.
//
// - The Python side's "image2id" pipeline (parser.py:1317-1329)
// that uploads embedded images to MinIO is not replicated —