Установка и проверка

A4 — готовое приложение для macOS, Windows и Linux. Вместе с интерфейсом внутри пакета поставляется нативный исполняемый файл fastdoc-cli. Для встраивания это внешний процессор документов: его можно запускать из своего настольного приложения, серверной обвязки или локального веб-хоста.

Скачать и проверить

Актуальная сборка публикуется на dl.plantype.ru. Там же лежит SHA256SUMS — список контрольных сумм всех файлов выпуска. Сверьте скачанное до установки:

base=https://dl.plantype.ru/a4/release/latest
curl -fsSLO $base/SHA256SUMS
# имя файла с номером версии берём из того же списка
curl -fLO $base/$(awk '/arm64.dmg$/ {print $2; exit}' SHA256SUMS)
shasum -a 256 -c SHA256SUMS --ignore-missing

Для Windows замените образец имени на arm64.msi или x64.msi, для Linux — на amd64.deb, и считайте сумму средствами своей системы: Get-FileHash в PowerShell, sha256sum -c в Linux.

Образец с arm64.dmg выбран не случайно: сборка A4 для macOS есть только под Apple Silicon, для Mac на процессоре Intel в каталоге выпуска её нет. Для Windows публикуются обе архитектуры, для Linux — только x86-64.

Часть поставки для Linux подписана отдельно: рядом с deb и AppImage лежат файлы .asc, и там же открытый ключ, которым подпись проверяется. У пакета rpm отделённой подписи в каталоге выпуска нет — для него остаётся сверка контрольной суммы.

curl -fsSLO $base/fastoffices-signing-key.asc
gpg --import fastoffices-signing-key.asc
curl -fsSLO $base/$(awk '/amd64.deb.asc$/ {print $2; exit}' SHA256SUMS)
gpg --verify A4-*-amd64.deb.asc A4-*-amd64.deb

На macOS и Windows подпись проверяет сама система при установке: там работает платформенная подпись, а не эта. Образ для macOS подписан сертификатом Developer ID и заверен у Apple — spctl отвечает accepted, source=Notarized Developer ID.

В сертификате стоит имя юридического лица, а не название продукта: Developer ID Application: HEALTH INFORMATIC SECURITY SYSTEM SL (K58GV7E7X4). Так и должно быть — сверяйте с этим идентификатором команды, K58GV7E7X4.

Установщики для Windows в текущем выпуске цифровой подписи не несут: система покажет предупреждение о неизвестном издателе. Проверяйте такой файл контрольной суммой из SHA256SUMS — она для него есть.

macOS

CLI="/Applications/A4.app/Contents/Resources/runtime/native/fastdoc-cli"
test -x "$CLI" && echo "процессор найден"

# Показать доступные одноразовые команды
"$CLI" --help | head -n 20

Windows

$CLI = "C:\Program Files\A4\resources\runtime\native\fastdoc-cli.exe"
if (Test-Path $CLI) { "процессор найден" }

# Показать доступные одноразовые команды
& $CLI --help | Select-Object -First 20

Linux

CLI="/opt/A4/resources/runtime/native/fastdoc-cli"
test -x "$CLI" && echo "процессор найден"

# Показать доступные одноразовые команды
"$CLI" --help | head -n 20

Это путь для пакетов deb и rpm. Поставка AppImage работает без установки, каталога у неё нет — распакуйте образ и возьмите процессор изнутри:

./A4-….AppImage --appimage-extract
CLI="$PWD/squashfs-root/resources/runtime/native/fastdoc-cli"

Ожидаемый результат

В терминале появляется строка «процессор найден», а следом — начало списка команд. Если приложение установлено в другой каталог, замените путь в первой строке: всё, что после каталога установки, одинаково во всех системах — resources/runtime/native.

Архитектура внешней интеграции

Ваша оболочка → сеанс JSONL или WebSocket → fastdoc-cli → DOCX и модель документа

Маршрут	Когда использовать	Транспорт	Готовность
Сеанс JSONL	Первый прототип, настольная или серверная обвязка	stdin и stdout	Готов; с него стоит начинать
WebSocket	Веб- или настольная оболочка с асинхронными запросами	ws://127.0.0.1 и пропуск	Готов
Web Surface	Посмотреть встраивание на живом документе	HTTP и WebSocket сеанса	Работает, но правка ограничена первым абзацем; после перезагрузки страницы нужно переподключение
Разовый вызов	Пакетные операции и автоматизация	аргументы процесса и JSON	Готов
Electron preload	Только внутри собственного окна A4	contextBridge и IPC	Внутренний контракт, для встраивания не предназначен

Что дальше

Процессор на месте — дальше есть три пути, в зависимости от того, что нужно проверить первым.

• Убедиться, что API отвечает. Быстрый старт: открыть DOCX, изменить абзац командой и сохранить результат.
• Посмотреть встраивание вживую. Запуск Web Surface: поверхность открывается в браузере поверх того же процессора. Правка в ней ограничена первым абзацем — это демонстрация пути, не редактор.
• Понять формат запросов. Объекты запросов и ответов и полный перечень в справочнике команд.

Если что-то не запускается, начните с диагностики.