Zorox из терминала

Тот же продукт без браузера: загрузить документ, прочитать оформление образца, показать отклонения, дать агенту задачу. Полезно, когда работа повторяется или когда нужно увидеть, что лежит в файле на самом деле.

Установка

Нужен Node 20 или новее. Пакет ставится глобально — дальше команда zorox доступна в любом каталоге.

npm i -g zorox
zorox login [email protected]
zorox --help

Дальше в примерах команды пишутся коротко — whoami вместо npm run cli -- whoami.

Вход

Сессия сохраняется в ~/.config/zorox-cli/session.json и переживает перезапуск терминала. Пароля нет — только код из письма.

```
login
```
Войти по коду из письма.
```
whoami
```
Чей это терминал, какой тариф и сколько осталось.
```
[email protected] · тариф free · баланс 25381 μUSD
```

Документы

```
docs
```
Список документов с идентификаторами и размерами.
```
upload
```
Загрузить .docx в облако.
```
download
```
Скачать документ в файл.
```
delete
```
Удалить документ.

Что внутри файла

Разбор идёт по распакованному DOCX, а не по тому, как файл выглядит в редакторе: видно то, что увидит нормоконтроль.

inspect

Абзацы, шрифты, поля страницы, таблицы, картинки. И сразу скажет, если файл вообще не DOCX.

абзацев:            19
таблиц:             0
картинок:           0
колонтитулы:        0 верх / 0 низ
поля (см):          верх 2.54, низ 2.54, лево 2.54, право 2.54
красная строка:     нет
интервал:           не задан
ориентация:         книжная
жирных прогонов:    6

```
style
```
Прочитать оформление образца. Ничего не сохраняет — показывает, что распозналось, и что распознать не удалось.
```
распознано: шрифт, кегль, выравнивание

{
  "paragraph": {
    "font": "Arial",
    "size": 11,
    "align": "left"
  }
}
```

check

Показать отклонения, ничего не меняя. Проверяется только то, что образец действительно задаёт.

сверка с образцом: 8 абз. основного текста
сверялось: шрифт, кегль, выравнивание
отклонений нет

```
templates
```
Состояние каталога шаблонов: формат по сигнатуре, число полей, замечания.
```
не открывается: 13 · с полями: 1 · требуют внимания: 29
```

Агент

Ход агента идёт по-настоящему: он читает документ, предлагает правки и применяет их тем же кодом, что и браузер. Ход стоит денег с баланса.

chat

Один ход агента с применением правок.

применено: 1 · не легло: 0 · подтверждений: 1
✓ сохранён в облако

```
apply
```
Применить готовые команды без агента — бесплатно.
```
matrix
```
Прогон сценариев: маленький документ, живой ход агента, проверка по распакованному DOCX — не по ответу агента. С --repeat N считает, как часто один и тот же запрос даёт разное.
```
replay
```
Прогон применения по записанным ходам: без сети и без модели.
```
fixtures
```
Собрать маленькие документы — по одной возможности на файл.

Флаги хода агента

--model haiku | sonnet | opus: Модель. По умолчанию серверная; тариф может не пустить.
--no-save: Не сохранять в облако. По умолчанию сохраняет.
--out <файл>: Записать результат ещё и на диск.
--diff: Показать, что именно изменилось в файле.
--reject: Отклонять карточки подтверждения — сухой прогон.
--thread <id>: Продолжить существующий разговор.

Коды возврата

Их читают скрипты, поэтому это часть договора, а не деталь вывода.

0: сделано
1: не получилось: нет сессии, файл не читается, сеть
2: команда отработала, но ничего не изменилось — агент не применил ни одной правки или проверка нашла отклонения

Если что-то пошло не так

Всё перечисленное встречено вживую, а не придумано для полноты.

unknown compression type 3332: старый .doc под именем .docx. С 24.08 CLI говорит это словами, но чужие инструменты — нет: число это байты заголовка OLE2.
403 model_not_in_plan: модель не входит в тариф: sonnet требует Pro, opus — Max.
401 на любой команде: сессия истекла — войдите заново. Токен лежит в ~/.config/zorox-cli/session.json без имени куки: если вписать его руками вместе с zorox_auth=, получится двойной префикс и снова 401.
правки исчезли после прогона: документ был открыт в браузере: его автосохранение выкладывает свою копию поверх. Закройте вкладку перед работой из терминала.