MinerU

MinerU конвертирует PDF, изображения и офисные документы (docx / pptx / xlsx) в Markdown, по адресу /d-forge/mineru - инструмент внутри D-Forge.

MinerU переехал в D-Forge в v6.6.36; его API не изменился, а старый маршрут /mineru перенаправляет сюда.

Что делает

Превращает документы в Markdown, записываемый прямо в ваше хранилище (vault) Obsidian, с блоком front-matter source и date и извлечёнными изображениями рядом с текстом.

Ключевые функции

Четыре вкладки:

• Convert - файлы ставятся в очередь тремя способами: перетаскиванием, через Choose files (пакетно) или Scan a folder (укажите любой каталог - он найдёт все конвертируемые файлы). Выберите режим (см. ниже) и нажмите Convert; прогресс транслируется вживую, и каждый готовый документ записывается в хранилище.
• Library - просмотр сконвертированного Markdown (и изображений) в вашем хранилище.
• History - каждая прошлая задача: режим, бэкенд, успех по каждому файлу и длительность.
• Settings - значения по умолчанию: папка вывода, папка сканирования по умолчанию, бэкенд / метод / язык, а также статус локального CLI / облачного токена.

Режимы

• Local - CLI mineru на этой машине. Выберите бэкенд (pipeline / vlm-engine / hybrid-engine), метод (auto / txt / ocr), язык и разбор формул / таблиц. Полностью офлайн.
• Cloud - mineru.net. Работает без ключа (бестокенный Agent API, ≤ 10 МБ / 20 страниц на файл); с учётными данными автоматически переходит на Precise API (200 МБ / 200 страниц, пакетная обработка).

Установка и зависимости

• Локальному режиму нужен CLI mineru: uv tool install "mineru[core]" или pip install mineru[core]. Помощник scripts/setup-mineru.sh разворачивает его с учётом железа (NVIDIA → CUDA, AMD → ROCm, иначе CPU) в ~/.maven/mineru/venv и запускается из scripts/install-autostart.sh.
• Облачному режиму не нужно ничего. Для Precise API положите учётные данные в .env.local: либо MINERU_API_KEY (прямой Bearer-токен), либо ваши OpenXLab MINERU_ACCESS_KEY + MINERU_SECRET_KEY (AK/SK, автоматически обмениваются на токен).

M.A.V.E.N деградирует корректно: без CLI режим Local отключён, а Cloud продолжает работать.

Куда попадает результат

Сконвертированные документы попадают в ваше хранилище по пути ~/Obsidian/maven-os/miner-u/<name>/<name>.md, с папкой images/ и front-matter source/date.

Советы

• Облачный режим - путь без настройки; хорош для редкого файла в рамках бесплатного лимита 10 МБ / 20 страниц.
• Используйте Scan a folder, чтобы пакетно сконвертировать целый каталог одной задачей.

См. также

• Медиатека
• Память