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

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

Что получится через 10–15 минут

Rust-процесс ответит на ping и сообщит протокол fastdoc.session-serve.v1; DOCX будет открыт, его первый абзац изменится через API и сохранится отдельным файлом; результат откроется в A4.

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

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

Подготовка

Откройте Terminal.

Проверьте Node.js командой node –version. Для демонстрации используйте Node.js 22 LTS или новее.

Перейдите в уже подготовленную папку на Desktop.

Запустите демонстрационный клиент и передайте явные пути входа и выхода.

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"

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

Запускает /Applications/A4.app/Contents/Resources/runtime/native/fastdoc-cli serve.

Читает bootstrap протокола и список из 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

Критерий успеха

Ping: true, revision=1, dirty=true и новый api-demo-result.docx на диске.

ШАГ 2

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

open -a 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

Что искать в JSON

в body.blocks найдите первый объект kind=paragraph. Его text должен начинаться с API DEMO:. Это прямой доступ к структуре документа, а не чтение изображения или PDF.

ШАГ 3