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) у ~/.erebros/mineru/venv, і його запускає scripts/install-autostart.sh.
• Режим Cloud не потребує нічого. Для Precise API додайте облікові дані в .env.local: або MINERU_API_KEY (прямий Bearer-токен), або ваші OpenXLab MINERU_ACCESS_KEY + MINERU_SECRET_KEY (AK/SK, автоматично обмінюються на токен).

Erebros деградує плавно: без CLI режим Local вимкнено, а Cloud і далі працює.

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

Сконвертовані документи потрапляють у ваше сховище за шляхом ~/Obsidian/Erebros/miner-u/<name>/<name>.md, з текою images/ та front-matter із джерелом і датою.

Поради

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

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

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