dsh-pdf-router
适用于 DeepSeek Harness 的路由式 PDF 阅读器：在存在文本层时使用文本层，为扫描件提供可插拔的视觉 OCR 端点，并执行版面感知处理，将表格返回为 HTML、公式返回为 LaTeX（推荐 MiniCPM-OCR）。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:yuanfuda/dsh-pdf-router#3731536711a28cb0256adb3a8b5524caaf92258dPdf Router 以 dsh-pdf-router 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A routing PDF reader for DeepSeek Harness. One tool, pdf_read, that picks the
cheapest engine per page instead of blindly OCRing everything:
| Page situation | Engine | Cost |
|---|---|---|
| Has a text layer | PyMuPDF direct extraction | ~0.01 s/page, zero recognition error |
| No text layer (scan/photo) | vision OCR endpoint (MiniCPM-OCR recommended) | ~20-130 s/page |
| Tables or formulas matter | MiniCPM-OCR layout pipeline | ~130-200 s/page |
The point is not "PDF to text" - several plugins do that. The point is that a page with tables and formulas comes back machine-usable, not merely readable.
dsh plugin --profile web add github:yuanfuda/dsh-pdf-router
Restart the harness afterwards: the loader imports plugin modules once, so a
freshly installed bundle is picked up on the next start. The tool pdf_read
then appears for every session in that profile.
MiniCPM-OCR is a 1.3B document-parsing vision model from OpenBMB, released under Apache-2.0 (code and weights). It is what this plugin is built and measured against.
Why it is the recommendation
<table> elements (OTSL internally, converted by the SDK), display formulas
as LaTeX, and the model keeps the reading order of multi-column pages. A plain
OCR pass gives you neither - it flattens a table into a column of numbers.Weights and sizes (GGUF, from the official repo)
| File | Size | Note |
|---|---|---|
MiniCPM-OCR-1_0-Q4_K_M.gguf | 505 MB | smallest usable; slight loss on dense code |
MiniCPM-OCR-1_0-Q8_0.gguf | 775 MB | recommended balance |
MiniCPM-OCR-1_0-F16.gguf | 1.4 GB | highest fidelity |
mmproj-model-f16-4x.gguf | 859 MB | vision projector, required for images |
Measured on this project's reference machine (Ultra 7 155H, Intel Arc iGPU, 22 threads, no NVIDIA GPU):
| Path | Time | Result |
|---|---|---|
| Text layer, 30-page arXiv paper | 1.9 s total | 0 OCR pages needed |
| MiniCPM-OCR, one scanned page | 21-43 s | two-column reading order preserved |
| MiniCPM-OCR SDK, one table page | 199 s | 5 HTML <table> blocks |
| MiniCPM-OCR SDK, one formula page | 65 s | compilable LaTeX |
Quality check on a real paper page, scored against the PDF's own text layer: sequence CER 0.3% for MiniCPM-OCR versus 53% for a plain OCR pass - the difference is reading order, not characters.
# 1) weights - ModelScope mirrors the official repo (huggingface.co is often blocked in CN)
curl.exe -L -o MiniCPM-OCR-1_0-Q8_0.gguf `
https://modelscope.cn/models/OpenBMB/MiniCPM-OCR-1.0-gguf/resolve/master/MiniCPM-OCR-1_0-Q8_0.gguf
curl.exe -L -o mmproj-model-f16-4x.gguf `
https://modelscope.cn/models/OpenBMB/MiniCPM-OCR-1.0-gguf/resolve/master/mmproj-model-f16-4x.gguf
# 2) runtime: llama.cpp prebuilt with the Vulkan backend drives an Intel/AMD iGPU
# https://github.com/ggml-org/llama.cpp/releases -> llama-b11962-bin-win-vulkan-x64.zip
# 3) serve an OpenAI-compatible endpoint on :18499
llama-server.exe --model MiniCPM-OCR-1_0-Q8_0.gguf --mmproj mmproj-model-f16-4x.gguf `
--host 127.0.0.1 --port 18499 --ctx-size 16384 --n-gpu-layers 999
Layout-aware (want: structure) additionally needs the minicpm-ocr SDK and
PP-DocLayoutV3:
pip install "minicpm-ocr[all]==1.0.2" "paddlepaddle==3.2.1" # CPU is enough
# PP-DocLayoutV3_infer.tar (126 MB) from paddle-model-ecology.bj.bcebos.com
Sources: model card . llama.cpp guide . PyPI SDK
The OCR half is provider-agnostic: anything that speaks OpenAI
POST {base}/chat/completions with image_url content parts works. Point
ocrEndpoint at Ollama, vLLM, LM Studio or a hosted API:
{ "ocrEndpoint": "http://127.0.0.1:11434/v1", "ocrModel": "qwen2.5vl:7b", "ocrProfile": "generic" }
ocrProfile: generic asks the model for Markdown with HTML tables and LaTeX
formulas in words. Expect that only models with real document training - which
is exactly what MiniCPM-OCR is for - will honour it. structure mode is
MiniCPM-OCR specific: it depends on the model's own table and formula prompts.
router.py: pip install pymupdf.
Without it the tool returns an actionable error rather than a traceback.Set on the plugin row (config) in the bundle patch or your profile patch:
| Key | Default | Meaning |
|---|---|---|
pythonPath | auto-detect, then python | python that can import pymupdf |
ocrEndpoint | http://127.0.0.1:18499/v1 | OpenAI-compatible base URL |
ocrModel | minicpm-ocr | model name sent to the endpoint |
ocrApiKey | empty | bearer token for hosted endpoints |
ocrProfile | auto | auto / minicpm / generic prompt family |
ocrPrompt | empty | overrides the instruction text |
sdkExe | auto-detect | minicpmvocr executable, structure only |
layoutModelDir | auto-detect | PP-DocLayoutV3 inference dir, structure only |
defaultWant | auto | auto / text / structure |
timeoutMs | 1800000 | whole-document budget |
{ "path": "C:\\docs\\paper.pdf" } // per-page routing
{ "path": "C:\\docs\\paper.pdf", "pages": "7", "want": "structure" } // HTML tables + LaTeX
{ "path": "C:\\docs\\scan.pdf", "want": "text" } // never call OCR
{ "path": "C:\\docs\\photo.jpg" } // images are OCRed directly
Returns route counts, per-page timing, warnings, the Markdown, and the out
path. Documents above 14000 characters are written to out and truncated inline.
auto on born-digital PDFs is seconds. Batch overnight.import(), so Node caches them by URL; HMR does not cover a workspace
directory linked into a profile.node selftest.mjs checks registration and the render path offline, without
booting a harness.
private: true; fill repository, homepage, bugs, author.LICENSE (MIT) and a raster icon-180.png are already included - market
tiles reject SVG, which is why icon.svg is only the in-app manifest icon.dsh-plugin topic.npm publish --access public (the name dsh-pdf-router is free).data/plugins/<owner>__dsh-pdf-router.yml to
awesome-dsh-plugin.
The repo must be at least one day old at submission time.