From a4dbd898bbe707b11ec4eab0e7771697a9113fab Mon Sep 17 00:00:00 2001 From: Jack Date: Wed, 12 Aug 2026 17:58:05 +0800 Subject: [PATCH] docs(ingestion): correct stale parser-component scope comment (#18147) --- internal/ingestion/component/parser.go | 23 +++++++++++++---------- 1 file changed, 13 insertions(+), 10 deletions(-) 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 —