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 сторінок, пакетна обробка).

Налаштування й залежності

• Режим Local потребує 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.
• Режим Cloud не потребує нічого. Для 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 із джерелом і датою.

Поради

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

Дивіться також

• Медіатека
• Memory