@dsh-external/dsh-pdf

🧰 Usage

read_pdf file_path=... [pages="1-3"] [mode=auto|text|ocr] [ocrEngine=auto|windows|tesseract] [maxCharsPerPage=20000]

Example result:

{
  "path": ".../test.pdf",
  "totalPages": 7,
  "mode": "auto",
  "pages": [
    { "number": 1, "text": "test… [OCR] test…", "source": "mixed", "chars": 163 },
    { "number": 2, "text": "1 test）…", "source": "text", "chars": 876 }
  ],
  "engines": ["windows: ok", "tesseract: unavailable (no traineddata)"],
  "warnings": []
}

Each page reports source: text (text layer only), ocr (OCR only), or mixed (both).

⚙️ Configuration

The plugin registers a dsh-pdf settings section (host namespace + a settings-UI card): every knob below is adjustable live in the DSH settings UI (Settings → Plugins → dsh-pdf); changes apply immediately and clear the result cache. The same keys can be set in cordis.patch.yml as the composition base:

Key	Default	Description
maxFileBytes	209715200	byte cap per PDF read
readLimitPages	50	max pages processed per call
ocrMinChars	120	pages with fewer text-layer chars get OCR'd in auto mode
ocrScale	2	render scale for OCR (2 ≈ 144 DPI)
ocrEngine	auto	auto / windows / tesseract
ocrTimeoutMs	60000	per-page OCR timeout
maxCharsPerPage	20000	per-page character cap in results
cacheEntries	4	result cache entries
cacheDir	%TEMP%/dsh-pdf	scratch dir for the OCR script and temp images

Settings UI: the plugin registers a dsh-pdf settings section — all keys above are adjustable live in the DSH settings UI (Settings → Plugins → dsh-pdf); changes apply immediately and clear the result cache. The cordis.patch.yml values act as the composition base.