Быстрый старт: первый JSONL-сеанс

За 10–15 минут: запустить fastdoc-cli, открыть DOCX, изменить первый абзац командой mutate, сохранить результат и проверить его без GUI.

Это самый короткий путь от установленного A4 до доказанного цикла «команда → изменение модели → запись DOCX → повторное чтение».

Команды ниже выполняются в подготовленной папке ~/Desktop/A4-API-first-run. Её вместе со скриптами a4-api-demo.mjs и start-web-demo.sh даёт Evaluation Kit — отдельный артефакт поставки (см. Состав поставки). В установщик A4 он не входит и с dl.plantype.ru не скачивается: его запрашивают у поставщика.

Если Evaluation Kit ещё не получен, установленного A4 достаточно, чтобы пройти тот же путь вручную: fastdoc-cli лежит внутри приложения (см. Установка и проверка), формат запросов описан в Объектах запросов и ответов, полный перечень команд — в справочнике. Пример полностью выписанного скрипта есть у F1: проверенный скрипт.

Первый настоящий вызов: JSONL-сеанс

JSONL — самый простой контракт для первой интеграции: один JSON-запрос в строке stdin, один JSON-ответ в строке stdout. Rust хранит состояние открытого документа между командами.

Подготовка

Откройте терминал.
Проверьте Node.js командой node --version — нужна версия 22 LTS или новее.
Перейдите в подготовленную папку на рабочем столе.
Запустите демонстрационный клиент, передав явные пути входного и выходного файла.

cd ~/Desktop/A4-API-first-run
node --version

node a4-api-demo.mjs \
  "/Applications/A4.app/Contents/Resources/app/fixtures/docx/simple_text.docx" \
  "$PWD/api-demo-result.docx"

cd $HOME\Desktop\A4-API-first-run
node --version

node a4-api-demo.mjs `
  "C:\Program Files\A4\resources\app\fixtures\docx\simple_text.docx" `
  "$PWD\api-demo-result.docx"

cd ~/Desktop/A4-API-first-run
node --version

node a4-api-demo.mjs \
  "/opt/A4/resources/app/fixtures/docx/simple_text.docx" \
  "$PWD/api-demo-result.docx"

Что делает скрипт

Запускает fastdoc-cli serve из пакета приложения.
Читает приветствие протокола и список из 28 команд.
Отправляет ping, затем open и model.
Командой mutate вставляет текст «API DEMO:» в начало первого абзаца.
Читает status и сохраняет копию командой save.
Завершает процесс командой shutdown.

Фактический вывод проверенного прогона

Connected: fastdoc.session-serve.v1
Commands available: 28
Ping: true
Session: rust-session-20320-1
Before: This is a sample word document. It has two pages, but no headers or footers.
After:  API DEMO: This is a sample word document. It has two pages, but no headers or footers.
Revision: 1; dirty: true
Saved: /Users/tester/Desktop/A4-API-first-run/api-demo-result.docx

Открыть результат и увидеть изменение

open -a A4 ~/Desktop/A4-API-first-run/api-demo-result.docx

& "C:\Program Files\A4\A4.exe" "$HOME\Desktop\A4-API-first-run\api-demo-result.docx"

/opt/A4/a4 ~/Desktop/A4-API-first-run/api-demo-result.docx

В начале первого абзаца должен появиться префикс API DEMO:. Это подтверждает полный цикл: команда пришла в Rust, изменила модель документа, записалась в DOCX и была прочитана графическим редактором.

Рисунок 1. Реальный результат API-прогона в установленной A4: первый абзац начинается с «API DEMO:». Скриншот сделан 26 августа 2026.

Проверить сохранённый файл без GUI

CLI="/Applications/A4.app/Contents/Resources/runtime/native/fastdoc-cli"
"$CLI" model-docx \
  "$HOME/Desktop/A4-API-first-run/api-demo-result.docx" \
  --format json

$CLI = "C:\Program Files\A4\resources\runtime\native\fastdoc-cli.exe"
& $CLI model-docx `
  "$HOME\Desktop\A4-API-first-run\api-demo-result.docx" `
  --format json

CLI="/opt/A4/resources/runtime/native/fastdoc-cli"
"$CLI" model-docx \
  "$HOME/Desktop/A4-API-first-run/api-demo-result.docx" \
  --format json

Что дальше

Разобрать формат запроса и ответа — Объекты запросов и ответов.
Те же команды, но по WebSocket — Тот же контракт через WebSocket.
Показать документ пользователю — Запуск Web Surface, а затем Встраивание Surface.
Полный перечень команд сеанса — справочник.
Что-то не запускается — Диагностика и контрольный список.