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

This commit is contained in:
Jack
2026-08-12 17:58:05 +08:00
committed by GitHub
parent c677e9af36
commit a4dbd898bb

View File

@@ -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 —