CLI-плагины Documentize
Открыть приложение: Получить CLI-плагины → (products.documentize.ai)
Кратко
CLI-плагин — это небольшой самодостаточный инструмент командной строки, который выполняет одну операцию: объединение, сжатие, поворот, извлечение текста, OCR и так далее. Вы скачиваете его из каталога плагинов на products.documentize.ai/pdf-cli, запускаете со средой выполнения .NET и соединяете несколько плагинов в shell-скрипте. Обработка идёт на вашем компьютере.
Установка
- Откройте каталог, найдите плагин по поиску или категории (AI, Convert, Edit, Extract, OCR, Security, Archive) и скачайте его zip-архив.
- Установите среду выполнения .NET 10 (не SDK). Загрузка содержит готовую
.dll. - Положите файл лицензии
documentize.licрядом с.dllплагина. Без него плагин работает в пробном режиме. - Только в Linux установите графические библиотеки и шрифты:
sudo apt-get install -y libgdiplus fontconfig fonts-liberation fonts-dejavu-core - Проверьте, что всё работает:
dotnet Documentize.Merge.dll --help.
В Windows и macOS при обычной работе дополнительные пакеты не нужны. В некоторые zip-архивы входит и нативный исполняемый файл (./Documentize.Merge, Documentize.Merge.exe), который можно запускать вместо dotnet ...dll.
Модель папок (прочитайте один раз)
Плагины не принимают пути к файлам в виде флагов. Они работают с парой папок задачи:
- вход:
<PLUGIN_INPUT_DIR>/<task-id>/ - выход:
<PLUGIN_OUTPUT_DIR>/<task-id>/
Обе переменные по умолчанию равны /tmp/documentize/input и /tmp/documentize/output в Linux/macOS (%TEMP%\documentize\... в Windows). Всегда передавайте свой --task-id, иначе будет использован случайный GUID, и вы не узнаете, куда делся результат. Каждый плагин также оставляет в выходной папке служебный файл <task-id>.json; при ручном запуске его можно игнорировать.
Коды завершения из readme плагинов: 0 — успех, 1 — задача запустилась, но завершилась неудачно (подробности в stderr), 2 — ошибка в использовании.
По одному примеру на семейство
Флаги ниже взяты из readme плагинов.
export PLUGIN_INPUT_DIR=$HOME/dmz/in PLUGIN_OUTPUT_DIR=$HOME/dmz/out
# Merge: файлы во входной папке объединяются в порядке имён. Других флагов нет.
mkdir -p $PLUGIN_INPUT_DIR/j1 && cp a.pdf b.pdf $PLUGIN_INPUT_DIR/j1/
dotnet Documentize.Merge.dll --task-id j1
# Compress: --compress-type — целочисленный пресет, по умолчанию 1
dotnet Documentize.Compress.dll --task-id j2 --compress-type 1
# Rotate: --angle (по умолчанию 90), --rotate-type (a = все страницы), --page-num
dotnet Documentize.Rotate.dll --task-id j3 --angle 90
# Remove pages: --remove-range обязателен, например 1,3,5-7
dotnet Documentize.RemovePages.dll --task-id j4 --remove-range 1,3
# OCR в PDF с возможностью поиска: --language (код Tesseract, по умолчанию eng)
dotnet Documentize.OcrSearchable.dll --task-id j5 --language eng
Цепочки в shell
Конвейера (pipe) здесь нет: выходная папка шага N становится входной папкой шага N+1. Оберните это в небольшую функцию:
step() { # step <prev-task> <next-task> <plugin> [flags...]
prev=$1; next=$2; plugin=$3; shift 3
mkdir -p "$PLUGIN_INPUT_DIR/$next"
cp "$PLUGIN_OUTPUT_DIR/$prev"/*.pdf "$PLUGIN_INPUT_DIR/$next/"
dotnet "Documentize.$plugin.dll" --task-id "$next" "$@"
}
# объединить -> удалить обложку -> сжать
dotnet Documentize.Merge.dll --task-id m1 # входные файлы уже в $PLUGIN_INPUT_DIR/m1
step m1 m2 RemovePages --remove-range 1
step m2 m3 Compress --compress-type 1
ls "$PLUGIN_OUTPUT_DIR/m3"
Используйте set -e, чтобы ненулевой код завершения останавливал цепочку. Правила порядка из главы «Организация» действуют и здесь: сначала организуем, сжимаем в самом конце.
Альтернативный способ ввода
Вместо флагов плагин принимает один аргумент: JSON в кодировке base64 (поля в PascalCase плюс "ID"). Удобно, когда плагин запускает другая программа; подробности смотрите в readme внутри каждого zip.
Заметки и предостережения
- На страницах каталога может быть показана команда вида
doccli; авторитетны readme из zip-архивов плагинов (сверяйтесь с тем архивом, который вы скачали). - Ожидайте проверки лицензии при первом запуске и подключения к интернету для активации (проверьте для каждого плагина).