# История изменений CLI MAX (/ru/docs/max/changelog)

Узнайте, что изменилось в выпусках: новые возможности, исправления и изменения, влияющие на команды. Начните со своей установленной версии, затем откройте инструкцию для функции, которую хотите попробовать.

Заметные изменения в `@wirecat/max-cli`. Формат — по одному разделу на версию, новое сверху;
номера версий по [семантике](https://semver.org/lang/ru/), то есть до `1.0.0` интерфейс команд
ещё может меняться.

## 0.111.0 — 12.11.2026 [#01110--12112026]

### Что нового [#что-нового]

- **Журнал запуска хранит прогресс синхронизации.** Каждая строка прогресса `messages sync` теперь ещё и событие
  `sync.progress` со счётчиками, при любом формате вывода, поэтому `max <profile> runs show <run>` показывает, что
  видел WireCat Desktop и когда.
- **Часть имени в `from:` и `chat:`.** `from:Ярослав*` и `chat:*Квестор*` находят по части имени, алиаса или
  @username, регистр и ё/е не важны. Если под образец не подходит никто, ответ `not_found` с ближайшими именами; если
  подходят больше 50, `query.too-large`, уточните образец. Номер и точное имя работают как раньше. Если точно так
  названы несколько людей, ошибка теперь предлагает и тех, у кого это имя только входит в имя: на «Ярослав» и
  «Ярослав Орлов».
- **Часть слова в тексте сообщений.** `*договор*` без поля находит «Договор», «ДОГОВОРЫ» и «переговоры», в том числе
  в большом архиве, внутри `AND`, `OR`, `NOT` и вместе с `chat:` и `date:`. Нужны три буквы подряд.
- **Начало слова ищет там же, где целое слово.** `счет*` без поля теперь находит слово и в расшифровках голосовых, в
  тексте и в именах файлов, а `matched_in` говорит, где именно.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты]

- **Собран на cli-core 0.642.0** (был 0.638.0). Хранилище остаётся на версии 66. Подробности в
  [журнале изменений cli-core](https://github.com/WireCatLabs/cli-core/blob/main/CHANGELOG.md).
- **`*часть*` в тексте сообщений ищется так, как написана.** Раньше `*мои*` находил и «мой», а `*cafe*` и «café».
  Теперь не важны только регистр и ё/е. Что учесть: пишите букву так, как она стоит в тексте, или ищите целое слово
  (`мой`), оно по-прежнему находит все формы.
- **Удалённые эмбеддинги по обычному http только на этом компьютере.** `--base-url` или `embedding_base_url` с
  адресом `http://` на другой машине теперь отказ `model.address-refused`: сообщения шли бы по сети без шифрования.
  Что учесть: укажите `https://` или запустите модель на этом компьютере (`localhost`, `127.0.0.1`). Сохранённая
  настройка по-прежнему читается, другие команды не ломаются.
- **`list:` в поиске сообщений теперь отказ.** Это поле почты, и раньше запрос с ним молча ничего не находил. Теперь
  ответ `query.unsupported-field` с объяснением.
- **Тестовые данные скрыты из списков людей.** Человек, у которого все адреса тестовые (`example.com`, `.test` и
  подобные) или заведены как пример, больше не показывается ни в одном виде, в том числе в `all`.

### Исправлено [#исправлено]

- **`messages sync --all` показывает прогресс внутри чата.** MAX отдаёт чат по 30 сообщений с паузой 5–10 секунд, а
  строка прогресса выходила, только когда чат закончен: на большом чате WireCat Desktop минутами показывал «Чат 1 из
  36 · 0». Теперь счётчик `fetched` растёт после каждой страницы, не чаще двух раз в секунду.
- **Подсказка про хранилище паролей больше не отправляет в cron.** Если вход в профиль был, а токен не читается,
  ошибка и `max <profile> doctor` теперь говорят, что хранилище, скорее всего, заблокировано: сразу после загрузки
  оно открывается при входе в систему, и запуск по расписанию ждёт этого сам. Совет про `XDG_RUNTIME_DIR` остался
  для cron и ssh.
- **Ежедневное и разовое расписание пережидает просьбу MAX подождать.** Если такой запуск по таймеру получил
  `rate_limited`, он ждёт столько, сколько попросил MAX, если это не больше шести часов, и пробует ещё раз, а не
  пропадает до следующего дня. Что учесть: расписание с `--every` и запуск руками по-прежнему завершаются ошибкой
  сразу.
- **`*слово*` в тексте подсказывает выход.** Если такой образец перебирает слишком много слов, ошибка теперь
  предлагает `слово*`, который находит и формы слова.

## 0.110.0 — 11.11.2026 [#01100--11112026]

### Что нового [#что-нового-1]

- **`participants_count` в поиске и статистике.** `participants_count<10` находит сообщения в чатах меньше чем из
  десяти человек, поэтому `stats messages show -- 'kind:private OR (kind:group participants_count<10)'` считает личные
  разговоры без больших групп.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-1]

- **Собран на cli-core 0.638.0** (был 0.633.0) и cli-base 0.96.0 (была 0.93.0). При первом открытии хранилище переходит на версию 66.
  `contacts unlink` теперь требует `--from person:<uid>` или `--from person:me`: человек, от которого отвязывается
  аккаунт. Без него команда отказывает и подсказывает, что добавить. Аккаунт, который уже записан на другого человека,
  не двигается. Подробности в
  [журнале изменений cli-core](https://github.com/WireCatLabs/cli-core/blob/main/CHANGELOG.md).

### Исправлено [#исправлено-1]

- **Перевод системных часов назад больше не останавливает синхронизацию на часы.** Если часы компьютера шли вперёд и
  их поправили, max считал, что MAX попросил подождать, и отказывал в каждой синхронизации, хотя к MAX даже не
  обращался. Теперь ожидание пересчитывается на величину сдвига, а в отказе больше не написано, что ждать попросил MAX.

## 0.109.0 — 10.11.2026 [#01090--10112026]

### Что нового [#что-нового-2]

- **`muted:` в поиске и статистике, из `@wirecat/cli-core` 0.633.0.** `muted:false` не учитывает чаты, где вы
  выключили уведомления, поэтому `stats messages show -- 'date>=30d muted:false'` считает только то, что синхронизация
  ещё читает. `stats messages responses` и `stats messages waiting` тоже его понимают.
- **`store import`, из `@wirecat/cli-core` 0.633.0.** Загружает выдуманные чаты, людей и сообщения из файла с пометкой synthetic в тестовое хранилище, например в песочницу Desktop; настоящее хранилище владельца не трогает.

## 0.108.0 — 10.11.2026 [#01080--10112026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-2]

- **Собран на cli-core 0.630.0** (был 0.624.0). При первом открытии хранилище переходит на версию 63. Вид каждого
  человека хранится при нём, а сохранение участников чата не трогает строки тех, кто остался, поэтому `people list` в
  memo фильтрует, считает и листает страницы в SQL. Кто писал в личном чате или в малой группе, теперь считается
  человеком владельца, ни одно правило не присоединяет никого к самому владельцу, а имя совпадает на кириллице и
  латинице. Инструмент на старом cli-core, который сохраняет участников, стирает сохранённые виды, поэтому max, tg и
  memo переходят вместе. Что изменилось между версиями, в
  [журнале изменений cli-core](https://github.com/WireCatLabs/cli-core/blob/main/CHANGELOG.md).

## 0.107.0 — 09.11.2026 [#01070--09112026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-3]

- **Собран на cli-core 0.624.0** (был 0.618.0). При первом открытии хранилище переходит на версию 61 (связи людей с
  владельцем, только добавление). Что изменилось между версиями, в
  [журнале изменений cli-core](https://github.com/WireCatLabs/cli-core/blob/main/CHANGELOG.md).
- **`search messages --timeout 30s` ищет до 29 секунд.** Раньше поиск останавливался через 2 секунды, сколько бы
  времени ни дали запуску, и правильный запрос по большому хранилищу падал в WireCat Desktop. Без `--timeout` предел
  остаётся 2 секунды, в том числе для агентов и MCP.
- **`schedule pause <имя>` и `schedule resume <имя>`**: расписание снимается с таймера и остаётся, `schedule run`
  его по-прежнему запускает. `--at` можно дать несколько раз: `--at 08:30 --at 18:00`.

## 0.106.0 — 09.11.2026 [#01060--09112026]

### Что нового [#что-нового-3]

- **Пулреквест пишет свои строки для журнала изменений в отдельный файл, `changes/<ветка>.md`.** Открытые
  пулреквесты больше не конфликтуют в разделе «Не выпущено». `pnpm docs:check` проверяет каждый такой файл, а
  `bin/release` собирает их в раздел версии. Пока идёт переход, запись в «Не выпущено» тоже работает.

### Исправлено [#исправлено-2]

- **`max serve` завершается, когда его версия устарела, и служба запускает новую.** Раз в минуту он проверяет, не
  перешло ли общее хранилище на формат, в который эта версия уже не может писать, и не установлена ли более новая
  версия max. Если да, он пишет в журнал `serve.outdated` и выходит с кодом 3, а служба systemd
  (`Restart=on-failure`) запускает установленную версию. Почему: раньше `serve` мог работать на старой версии и
  ничего не сохранять.
- **После `max store recover run` обычная синхронизация снова загружает то, что могло пропасть при повреждении.**
  Восстановление помечает как не загруженное всё, что чат хранил начиная с суток до последней пройденной глубокой
  проверки. Из cli-core 0.618.0 (было 0.616.0).

## 0.105.0 — 09.11.2026 [#01050--09112026]

### Что нового [#что-нового-4]

- **`max <профиль> account remove --keep-data|--delete-data` выводит профиль из MAX и стирает его на этом компьютере.**
  Команда завершает сессию на сервере MAX, потом удаляет токен из ключницы и файлы профиля: состояние, сокет и
  журнал `max serve`, а вместе с ними то, что общий слой хранит для профиля. `--keep-data` оставляет сообщения в
  хранилище, и поиск их находит; `--delete-data` удаляет и их. Другие профили не затрагиваются.
  Почему: до сих пор `session end` забывал только токен, а остальное профиль оставлял за собой.
  Что учесть: пока для профиля работает `max serve`, команда отказывает, как и `session end`: сначала
  `max <профиль> server stop`. Токен бота (`bot:<профиль>`) остаётся: бот это отдельный аккаунт. Запуск с
  перенесёнными папками забывает только свою копию и не выводит владельца из MAX.

## 0.104.0 — 08.11.2026 [#01040--08112026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-4]

- **`max` открывает хранилище, которое уже перевели memo и другие инструменты WireCat, и сам переводит его на
  версию 57.** Хранилище версии 56 и выше не открывают `max` 0.103.0 и старше и все инструменты на cli-core старше
  0.606.0: они просят обновиться.
  Что учесть: обновляйте `max`, `tg` и memo вместе (cli-core 0.606.0, 0.607.0).
- **`--offline` у команды, которой нужен MAX, отвечает `permission_error` (`offline.refused`) с кодом выхода 5.**
  Раньше `chats inspect`, `chats events`, `chats folders …` и `upgrade` отвечали `validation_error` с кодом 2.
  Что учесть: скрипт, который ждёт там код 2, должен ждать 5 (cli-core 0.607.0).
- **`contacts context` и `contacts prepare` читают только аккаунты той же сферы, что и профиль.** Личный профиль
  больше не показывает почту, сообщения, события и встречи человека из рабочих аккаунтов, а рабочий — из личных.
  В ответе появилось поле `accounts`: каждый прочитанный аккаунт и его сфера (cli-core 0.605.0).
- **Имя, набранное через «е», находит чат или человека с «ё».** Имя, которое раньше совпадало с одним чатом или
  человеком, теперь может совпасть с двумя (`Алена` и `Алёна`); тогда `max` отказывает и называет оба варианта, как
  при любом неоднозначном имени (cli-core 0.601.0).
- **Поиск чаще читает запрос как обычные слова.** `?` в конце слова — знак вопроса: `счёт?` находит «счёт». Текст с
  двоеточием, ссылкой, скобкой или незакрытой кавычкой (`встреча в 10:30`) ищется как слова, а раньше поиск
  отказывал (cli-core 0.602.0, 0.604.0).

### Исправлено [#исправлено-3]

- **Повреждённый файл хранилища останавливает запись и называет `max store recover`.** Раньше команда, получившая
  от SQLite «database disk image is malformed», падала с `internal_error`. Теперь ответ — `configuration_error`
  (`store.damaged`), и следующие команды, которые пишут, отказывают, пока глубокая проверка или восстановление не
  пройдут. Чтение работает (cli-core 0.605.0).
- **Людей, которых вы разделили, ничто не соединяет снова.** Третий контакт с тем же адресом почты мог снова
  соединить двух людей после того, как вы их разделили (cli-core 0.605.0).

## 0.103.0 — 07.11.2026 [#01030--07112026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-5]

- **`max schedule agent` и `max schedule command` принимают `--deliver-to <маршрут>` вместо `--to <маршрут>`**, а
  `schedule list` называет поле `deliver_to` (cli-core 0.600.0). Расписания, сохранённые с `--to`, доставляют
  результат как раньше.

### Исправлено [#исправлено-4]

- **Открытие хранилища больше не сбрасывает блокировки файла SQLite.** Раньше файл открывался с усечением, и это
  снимало POSIX-блокировки, которые держали другие процессы, так что две записи могли пересечься (cli-core 0.599.0).
- **`max mcp serve --permission <ключ>=deny` теперь действует и на собственные команды `max`.** Раньше уровни,
  заданные серверу MCP, не видели проверки `max`: агент мог выполнить `contacts sync`, `messages transcribe`,
  `watch` и команды `max bot` (например, `bot comments send`) по сохранённым уровням профиля, а запрос уходил в MAX.
  Теперь такая команда получает `permission_error` до соединения.
  Что учесть: запуск агента с такими уровнями больше не идёт через общий `max serve` (он знает только сохранённые
  уровни), а открывает своё соединение, как и запуск с `--permission` в терминале.

## 0.102.0 — 05.11.2026 [#01020--05112026]

### Исправлено [#исправлено-5]

- **`max bot list` и `max bot list --check` снова работают без имени профиля.** В 0.101.0 на компьютере без профилей
  они отвечали ошибкой `name a profile`, и список ботов можно было получить, только поставив любое слово первым:
  `max personal bot list`. Команда читает все боты на этом компьютере, поэтому профиль ей не нужен, как и в `tg` и
  `wa`.
  Что учесть: остальные команды `max bot …` по-прежнему требуют профиль, `max` сам его не выбирает.

## 0.101.0 — 05.11.2026 [#01010--05112026]

### Исправлено [#исправлено-6]

- **Запрос к Bot API и загрузка файла больше не держат завершённую команду в памяти до конца своего лимита
  времени.** Таймер лимита работал до конца, даже когда MAX уже ответил, и удерживал всё, что загрузила команда.
  Процесс, который делает много запросов подряд, как `max bot mcp` или `max bot updates watch`, рос с каждым
  запросом. То же исправлено для `--timeout` у команд `max bot`.

## 0.100.0 — 05.11.2026 [#01000--05112026]

### Что нового [#что-нового-5]

- **`max config migrate` дописывает в файл каждую настройку, которой там нет, со встроенным значением, и так же
  делает любая запись `max` в файл.** В `config.json` видны и правятся все настройки, `serve` и `transcribe_model`
  тоже, без документации. Ваши значения, их порядок и незнакомые ключи остаются; `config unset` убранное обратно не
  пишет, а простое чтение файл не переписывает (cli-core 0.563.0).
- **`max config show` у каждой настройки показывает встроенное значение и что она делает**, а также
  `keep_successful_runs_for_days` и `runs_size_limit_mb`, которых в списке не было.
- **Из cli-core 0.563.0:** `config repair` чинит синтаксис JSON в файле настроек; `stats messages responses` и
  `stats messages waiting`; `tasks status`, `tasks review` и `tasks acknowledge`.
- **Из cli-core 0.564.0–0.566.0:** `store chats status` считает чаты, которые архив хранит с первого сообщения,
  частично или не хранит вовсе; `stats tasks show` принимает запрос и считает задачи, открытые и закрытые
  за период (`-- created>=30d`); `has:transcript` находит голосовые сообщения с расшифровкой.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-6]

- **Запись в задачу, которую изменили после того, как вы её прочитали, теперь завершается кодом `conflict`, выход
  15**, а не `configuration_error`, выход 3. Причина по-прежнему `task.stale` (cli-core 0.567.0, cli-base 0.77.1).
- **`max account list` больше не показывает бота как аккаунт без входа.** Имя, которое есть только у бота, не
  выводится; имя, которое и ваш аккаунт, и бот, помечено `bot: true` (cli-core 0.567.0).
- **Новый код ошибки `conflict` (код возврата 15) есть в `max commands --json` и в схеме ошибок инструментов MCP**
  (cli-base 0.77.1). Он значит, что запись отклонена, потому что то, что она меняет, изменилось после чтения. Его
  возвращает запись в задачу на устаревшей копии (см. выше).
- **`search all` ранжирует все источники одним списком, ищет почту и по смыслу и находит записи по вопросу,
  написанному предложением** (cli-core 0.564.0). Раньше находки источников шли по очереди, а вопрос находил только
  записи, где были все его слова.

## 0.99.0 — 03.11.2026 [#0990--03112026]

### Что нового [#что-нового-6]

- **`wcat max` запускает программу, а `wcat --help` её показывает.** Пакет ставит команду `wcat-max` рядом с `max`, и
  `wcat-max --wcat-describe` печатает для `wcat` имя, версию и описание программы.

## 0.98.0 — 02.11.2026 [#0980--02112026]

### Что нового [#что-нового-7]

- **`projects evidence` и `projects status` читают связанные чаты по назначению**: `--purpose sales,work` или
  `--purpose all`. Без флага берутся назначения по умолчанию (встроенное — `work`). Чат, который не попал в
  выборку, не пропадает молча: это строка `missing` с назначением, числом сообщений и командой, которая его прочтёт
  (cli-core 0.553.0).
- **`projects evidence --include-proposed`** читает и чаты с людьми, которые предложены для проекта, но ещё не
  подтверждены; всё, что они принесли, помечено `proposed` (cli-core 0.553.0).
- **`projects evidence --compact`** печатает по строке на найденное, связанный чат, пропущенный чат и участника
  (cli-core 0.553.0).

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-7]

- **В JSON `projects status` появилось поле `purposes`**, а у чата, пропущенного по назначению, — аккаунт, id чата
  и счётчики (cli-core 0.553.0).

## 0.97.0 — 02.11.2026 [#0970--02112026]

### Что нового [#что-нового-8]

- **`max serve` дочитывает то, что пришло, пока он не работал.** Через 30 секунд после подключения он читает чаты, в
  которых есть сообщения новее тех, что лежали в копии при его запуске: не дальше 7 дней назад, до 500 сообщений на
  чат и не дольше 5 минут. После простоя больше недели запустите один раз `max <profile> messages sync --all`
  (cli-core 0.552.0).
- **`server install` включает службу**, и `serve` стартует при каждом входе в систему и после перезагрузки. Службу,
  которую поставил прежний `max`, включите, повторив `max <profile> server install`; `server status` показывает
  `starts_at_login`. Служба из рабочей копии max записывается, но не включается (cli-core 0.552.0).
- **`messages sync` соблюдает ограничения истории**: по умолчанию не читает группу больше 50 человек
  (`history_group_members_max`), читает группу на 365 дней назад, а личный чат на 1095 (`history_group_days`,
  `history_dialog_days`), и говорит, что пропустил, в `limited`. `--full-history` читает дальше на один запуск;
  чтобы читать большие группы всегда, поднимите настройку. Новые сообщения не теряются никогда (cli-core 0.551.0).
- **`max <profile> projects status <проект>`** показывает, где стоит проект, только по локальной копии (cli-core 0.551.0).
- **`--compact`** печатает по строке на элемент для агента, из того же ответа, что и `--json` (cli-core 0.550.0).
- **`messages list` читает окно с обеих сторон**, и без сети тоже: `'date>=2026-10-01 date<2026-10-20'` читает вперёд
  от начала и останавливается на конце. Раньше такой запрос отказывал (cli-core 0.547.0).
- **Команда, которой нужен чат или сообщение, принимает и ссылку, которую печатают другие программы WireCat**
  (`msg:…`, `chat:…`) (cli-core 0.546.0).

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-8]

- **Поиск, которому не хватило времени, завершается `timeout` с причиной `query.time-limit`** примерно за 2 секунды,
  а не `validation_error` / `query.too-large` после долгой работы. Запрос правильный; добавьте `chat:` или `date:`,
  чтобы искать в меньшей части копии (cli-core 0.552.0).
- **Текст вида `<вид>:<без пробелов>` вместо чата читается как ссылка**, а ссылка на другой аккаунт или мессенджер
  отклоняется со своей причиной. Ключ после `--` читается как ключ (cli-core 0.546.0).

### Исправлено [#исправлено-7]

- **Синхронизация, у которой закрылся вывод, доделывает работу.** Закрытый канал (EPIPE) раньше её обрывал
  (cli-core 0.552.0).
- **`messages delete` без номера сообщения отказывает до подключения** (cli-core 0.551.0).
- **`page.next` у `messages list` выполняется как написано, а начало «включительно» сохраняет сообщение, отправленное
  ровно в этот момент** (cli-core 0.547.0).
- **Если ключница заперта, `max serve` и запуск по расписанию пробуют снова, а не просят войти заново.** Профиль,
  который уже входил на этом компьютере, но не может прочитать токен, отвечал `authentication_error` (код 4). Служба
  `serve` с `RestartPreventExitStatus=4` после этого не перезапускалась до ручного `server start`, а таймер, сработавший
  при загрузке до входа в систему, терял запуск на весь день. Теперь `max serve` и запуск под таймером (`MAX_SCHEDULED`)
  отвечают `provider_unavailable` (код 12) с причиной `credentials.unreachable`: systemd перезапускает службу, а
  `schedule exec` (cli-core) повторяет запуск, пока вход не откроет ключницу. Команда, набранная вручную, отвечает как
  раньше.

## 0.96.0 — 02.11.2026 [#0960--02112026]

### Что нового [#что-нового-9]

- **`max <profile> messages download --offline` копирует файл, который уже есть на этом компьютере**, не подключаясь;
  `--attachment <n>` выбирает один файл сообщения, а вместо чата и сообщения можно передать ссылку `msg:`
  (cli-core 0.532.0).
- **Первый запуск новой версии обновляет инструкции для агентов, которые поставила старая.** Устаревшая копия
  `SKILL.md` (Claude Code, `~/.agents/skills`, Hermes) переписывается один раз, с одной строкой в stderr; копию,
  которой нет, без версии или ссылку команда не трогает. `MAX_NO_SKILL_REFRESH=1` это отключает (cli-core 0.544.0).

### Безопасность [#безопасность]

- **Агент больше не может ослабить права из своей оболочки.** `max <profile> config set|unset permissions…`,
  запущенная агентом (Hermes, OpenClaw, Claude Code и другие, что помечают свою оболочку), может только ужесточить
  уровень, но не ослабить, а `mcp.authority` и `bot.api` меняет только владелец. Поэтому режим «только чтение»,
  который ставит приложение WireCat, держится, даже если сообщение в чате уговорит агента запустить `config set`.
  Права меняйте в терминале вне агента (cli-core 0.544.0).

## 0.95.0 — 01.11.2026 [#0950--01112026]

### Что нового [#что-нового-10]

- **`projects evidence --json` даёт команду докачки для каждого привязанного чата** в `linked_chats[].sync_command`:
  ту же строку, что в тексте, или null, если чат загружен полностью (cli-core 0.517.0).

### Исправлено [#исправлено-8]

- **`projects evidence` больше не пишет «held from <date> only»** про чат, который дошёл до первого сообщения: теперь
  «held from its first message, behind since <date>» или «with gaps». Прогресс `messages sync` показывает, докуда
  дошёл, датой («back to <date>»), а не ключом сообщения, который в MAX был числом миллисекунд (cli-core 0.517.0).

## 0.94.0 — 01.11.2026 [#0940--01112026]

### Что нового [#что-нового-11]

- **`max <profile> projects evidence <project>`** (`projectsCommand` из cli-core). Показывает, что о проекте есть в
  сохранённых сообщениях этого аккаунта: название, ключ, другие имена, слова, контакты, подтверждённые участники и
  привязанные чаты. **`--sync-first`** (по умолчанию выключен, в MCP его нет) сначала докачивает привязанные чаты,
  которых в хранилище нет до `--since-time`, по одному, за `--sync-time` (3 минуты на все). Чат, на который не
  хватило времени, остаётся частичным, с `missing` и `next`. Если докачать не удалось (например, нужен запущенный
  `serve`), чат помечается `failed` с причиной, а чтение продолжается. Доступ закрывает право
  `messages` (cli-core 0.511.0).

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-9]

- **Журнал вызовов MCP называет агента, который сделал вызов, а не `max-mcp`** (cli-core 0.509.0): имя, которым
  клиент назвал себя (`clientInfo.name`, например `claude-code`), иначе агента, запустившего сервер, иначе `max-mcp`.
  Фильтр по `max-mcp` новые вызовы не находит. Имя — слова самого клиента, только подпись.

## 0.93.0 — 31.10.2026 [#0930--31102026]

### Что нового [#что-нового-12]

- **`messages sync --json` пишет ход синхронизации в stderr** (cli-core 0.507.0): по одной строке JSON, только
  счётчики, без id и названий чатов. stdout по-прежнему несёт один ответ.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-10]

- **`search messages --discover` ищет по смыслу и тогда, когда в запросе есть `-`, `NOT`, `OR`, скобки, фразы или
  `exact:`** (cli-core 0.506.0). Раньше такой запрос шёл только строгим поиском. Теперь слова по-прежнему ищутся всем
  запросом (`discovery.method: "lexical-strict"`), а к ним добавляются сообщения, близкие по смыслу к его словам.
  Каждое сообщение, найденное по смыслу, и каждый добавленный ответ или продолжение подходят под все поля запроса и
  не содержат исключённых слов.

### Исправлено [#исправлено-9]

- **Описание `doctor` то же, что у остальных CLI: «the state this installation is in, without connecting unless
  --online»** (cli-core 0.507.0). Раньше max подменял его своим, и сводка расходилась с общей.
- **`search messages --discover` с узким фильтром (`chat:`, `date:`) ранжирует по смыслу сообщения самого фильтра**,
  если их не больше 100 000, а не 100 ближайших во всём архиве, поэтому страница заполняется (cli-core 0.506.0).
- **`search messages --discover` работает с базой, открытой только для чтения** (cli-core 0.506.0).
- **Долгая перестройка в одном процессе больше не ломает запись в другом ошибкой "database is locked"**
  (cli-core 0.506.0).
- **Запасной файл для токена теперь ведёт cli-base 0.68.0, без своего кода в max** (cli-core 0.507.0). Токен из
  личного файла читается оттуда, и ротация оставляет его там; `session start` возвращает его в связку ключей и
  удаляет копию в файле, как в 0.92.0. Предупреждение о недоступной связке ключей — по-прежнему одно за запуск.

## 0.92.0 — 31.10.2026 [#0920--31102026]

### Что нового [#что-нового-13]

- **`search messages` говорит, сколько всего сообщений подходит: `page.total`** (cli-core 0.501.0). В `--json`
  появилось `page.total: { value, relation }` в форме `hits.total` из Elasticsearch: `eq` — точное число, `gte` —
  не меньше (счёт останавливается на 10 000). В терминале под найденным — `showing 1–20 of 144`.
- **`session start --credential-storage keyring|file`.** По умолчанию токен в системном хранилище паролей, а если оно
  недоступно — в файле, доступном только вам, без вопросов и с одним предупреждением. `file` выбирает файл сразу; не
  советуем. Токен из файла читается первым, так что запертое хранилище для него больше не трогается; следующий вход
  с хранилищем возвращает токен туда. Ответ говорит, куда лёг токен: `credential_storage`. Нужен cli-core 0.503.0.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-11]

- **max требует cli-base 0.67.0** (cli-core 0.501.0).

## 0.91.0 — 31.10.2026 [#0910--31102026]

### Что нового [#что-нового-14]

- **`messages list --offline`, `tasks agenda` и `search all` говорят, когда локальная копия держит чат только частично**
  (cli-core 0.493.0). Чат, скачанный не до начала или ни разу не скачанный, даёт `meta.complete: false`, `missing` и
  `next` с шагом `messages sync <чат>` (сначала за окно ответа, если оно есть). В `tasks agenda` у каждой строки есть
  `completeness` и `held`, а в тексте такой чат помечен `[partial]` или `[never fetched]`. Код выхода остаётся 0.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-12]

- **`search messages`, `search all`, `tasks agenda` и `messages list --offline` отвечают `meta.complete: false`, если
  чат, который они читали, есть в копии только частично** (cli-core 0.493.0). Раньше было `true`, а пробел был виден
  только в `missing` и `next`. Скрипт, который считал `meta.complete` знаком «ни один источник не упал», должен читать
  причину в `missing`. Код выхода по-прежнему 0.
- **Продолжения в `search messages --discover --json` идут отрывком до 240 знаков, как сама находка:
  `items[].follow_ups[].excerpt` вместо `text`** (cli-core 0.496.0). В 0.90.0 продолжение шло целым сообщением, и на
  реальном архиве одно длинное сообщение добавляло 7 КБ к ответу из пяти находок. Целиком сообщение показывает
  `messages context <ref>`. Вывод в терминале не изменился.

### Исправлено [#исправлено-10]

- **`search messages --discover` с датой и временем в кавычках больше не падает с `query.invalid-date`** (cli-core
  0.496.0). Исправление «22:00» в 0.90.0 заменяло двоеточие между цифрами и внутри кавычек, поэтому
  `date:["2026-08-21T21:30:00Z" TO "…"]` с `--discover` не работал.
- **`search notes` и заметки в `search all` соблюдают поля запроса и для найденного по смыслу** (cli-core 0.496.0).
  `date:today` или `tag:work` без `--exact` возвращали около 20 заметок, не подходящих ни под одно поле. Теперь по
  смыслу ищутся только слова запроса, а каждое поле и каждое исключённое слово (`-draft`) действуют на все находки.
- **У документа Drive `date:` и показанное `updated_at` — одно время, время правки в Drive** (cli-core 0.496.0).
  Раньше `date:` читал время изменения копии, и из 20 находок по `date>=30d` у 16 была показана более старая дата.
- **Запуск с перенесёнными папками больше не может стереть вход владельца из связки ключей и не выводит его из MAX**
  (cli-base 0.65.5, WC-SECR-24). Раньше перенесённым считался только запуск с `MAX_*_DIR`; запуск с другим `HOME` или
  папкой XDG трогал настоящую запись `max-cli`, и `session end` в нём стирал её. Теперь такой запуск читает вход
  владельца, но не меняет и не удаляет его, а новый вход пишет во временную запись. `session end` на входе владельца
  ничего не завершает и отвечает `kept: "owners-sign-in"`.
- **`bin/max` в рабочей копии больше не копирует токены**: копия читает вход владельца, а `scripts/seed-worktree.ts`
  переносит только состояние профиля.
- **max требует cli-base 0.65.5 и cli-core 0.496.0.**

## 0.90.0 — 31.10.2026 [#0900--31102026]

### Что нового [#что-нового-15]

- **`max <профиль> search messages '<вопрос>' --discover` показывает продолжения — более поздние сообщения, которые могут
  отменить или поменять найденное (cli-core 0.492.0).** К первым пяти найденным добавляется до двух более поздних
  сообщений из любого чата, который читает поиск, с редким общим словом (его основа есть не более чем в трёх сообщениях
  архива): так видно, если решение потом отменили, а отмена не была ответом. В `--json` это `items[].follow_ups`, в
  терминале — строки `later, shares a rare word`. Что учесть: продолжения появляются, когда основы слов уже построены.

### Исправлено [#исправлено-11]

- **`search messages --discover` больше не падает на вопросе со временем или пропорцией («до 22:00», «1:1»)** (cli-core
  0.492.0). Двоеточие между цифрами читалось как фильтр поля, и поиск завершался ошибкой `query.invalid-syntax`.
- **Поправка к 0.89.0: в нём же запись в хранилище перестала падать с «database is locked», пока другая программа WireCat
  пишет в него** (cli-core 0.485.0). Запись 0.89.0 об этом не говорит.
- **max требует cli-core 0.492.0** (cli-base остаётся 0.65.0).

## 0.89.0 — 31.10.2026 [#0890--31102026]

### Что нового [#что-нового-16]

- **`contacts list notes:` находит часть слова в любом регистре, в том числе кириллицу (cli-core 0.490.0).** Раньше
  `notes:КВАРТ` не находил заметку со словом «квартира»: сравнение без учёта регистра работало только для латиницы, а поиск
  читал все заметки. Теперь заметки ищутся по индексу из трёх символов и отвечают за миллисекунды. Что учесть: запрос
  короче трёх символов отклоняется с ошибкой «search needs at least three characters» (пустой запрос по-прежнему
  ничего не отбирает). Хранилище обновится до версии 40 при первом открытии; заметки, сохранённые раньше, получают
  индекс порциями при `search notes` или `store migrate`, а пока их ищет прежний способ. Сборка другой программы
  WireCat со старым cli-core не пишет индекс в уже обновлённое хранилище, поэтому обновите все программы WireCat сразу.

### Исправлено [#исправлено-12]

- **Поправка к 0.88.0: поля карточки контакта называются `firstName`, `lastName` и `userId`.** В записи 0.88.0 про
  вложение `CONTACT` они названы `first_name`, `last_name` и `user_id`; #874 переименовал их, а запись осталась прежней.
- **max требует cli-core 0.491.0** (cli-base остаётся 0.65.0). В 0.491.0 исправлена только почтовая синхронизация,
  max её не использует.

## 0.88.0 — 31.10.2026 [#0880--31102026]

### Что нового [#что-нового-17]

- **Карточка контакта в сообщении (`CONTACT`) читается как контакт: у вложения есть `contact` с именем, `first_name`, `last_name` и `user_id`.**
  Раньше такое вложение приходило только с видом `contact`, без имени. Что учесть: MAX не присылает телефон в карточке,
  поэтому поля `phone` нет.

### Исправлено [#исправлено-13]

- **Поиск по названию чата и по имени контакта не зависит от регистра в любом алфавите (cli-core 0.484.0).** Раньше
  `max <профиль> chats list 'title:СТАС*' --offline` не находил чат «Стас»: локальное хранилище сравнивало без учёта
  регистра только латинские буквы. Теперь находит; так же работает `name:` в `tags list` для названий чатов и имён контактов.
  Что учесть: хранилище обновится до версии 38 при первом открытии, ничего делать не нужно. Если то же хранилище
  открывает более старая сборка другой программы WireCat и переименовывает что-то, поиск по новому названию заработает
  после следующего открытия хранилища новой сборкой.
- **`max --help` показывает `gcal` в списке «Works with» (cli-core 0.482.0).** Это Google Календарь рядом с остальными
  данными WireCat; `max setup` предлагает установить `@wirecat/gcal-cli`. Если скрипт сверяет текст первого экрана,
  в нём появилась одна строка.
- **max требует cli-core 0.484.0** (cli-base остаётся 0.65.0).

## 0.87.0 — 30.10.2026 [#0870--30102026]

### Исправлено [#исправлено-14]

- **Личные диалоги в локальном хранилище получают название по имени собеседника, и `max <профиль> chats list 'title:Стас*' --offline` их находит.**
  Раньше у диалога в хранилище не было названия, а каждый вход в MAX стирал и то, что успел записать `chats list`,
  поэтому поиск по названию без сети не находил ни одного диалога, и агентам приходилось перебирать все.
  Теперь после входа название берётся из имени собеседника (то же имя показывает `contacts`), в том числе у диалогов,
  записанных раньше.
  Что учесть: диалог, чьего собеседника нет в контактах и среди участников чатов, остаётся без названия, пока не
  выполнен `chats list` с сетью.

## 0.86.0 — 29.10.2026 [#0860--29102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-13]

- **`max contacts info` заменён командой `max contacts show` (cli-core 0.477.0).** Она показывает контакт целиком,
  телефон теперь выводится полностью, без маски. Что сделать: в скриптах замените `contacts info` на
  `contacts show`. Старого вида команды больше нет.
- **max требует cli-core 0.478.0** (cli-base остаётся 0.65.0).

### Исправлено [#исправлено-15]

- **`sender_is_me` в `inbox`, `review`, `search messages` и `search all` (cli-core 0.478.0).** Эти ответы не
  отмечали ваши собственные сообщения; теперь поле есть, как в `messages list`.

## 0.85.0 — 29.10.2026 [#0850--29102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-14]

- **`max mcp serve` без профиля больше не отдаёт все профили (cli-core 0.470.0).** Он завершается с кодом 2
  (`validation_error`) и перечисляет профили этого компьютера. Назовите профиль первым словом (`max work mcp serve`),
  список (`max mcp serve --profiles work,personal`) или все (`--profiles all`). Так же работают `--http`,
  `mcp server start|stop|status`, `mcp revoke` и `mcp config`. Кого касается: запись MCP-клиента из 0.83.0–0.84.0
  с `max mcp serve` без профиля перестанет запускаться — напечатайте её заново через `max mcp config --profiles all`
  или впишите профиль. Фоновый сервер всех профилей, запущенный этими версиями, запустите заново командой
  `max mcp server start --profiles all`. Запись в MCP Registry уже запускает `mcp serve --profiles all`, Docker-образ —
  профиль `glama`, `doctor --online` — проверяемый профиль.
- **У каждого сообщения в ответах `messages list`, `show`, `context`, поиска и `inbox` есть `sender_is_me`
  (cli-core 0.473.0).** Оно истинно для своих сообщений, в том числе в MAX, где у владельца нет id отправителя.
  Скрипт, который сверяет ответ со строгой копией схемы, отвергнет новое поле.
- **max требует cli-core 0.473.0** (cli-base остаётся 0.65.0). `max --help` в «Works with» теперь называет и `mail`.
- **Навык для агентов опубликован в ClawHub под именем `wirecat-max`.** Установка:
  `openclaw skills install @wirecat/wirecat-max`. Запись `max-cli` больше не обновляется.
  `max skill install` по-прежнему пишет `skills/max-cli/`.

## 0.84.0 — 27.10.2026 [#0840--27102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-15]

- **cli-core 0.469.0 и cli-base 0.65.0.** cli-core 0.469 принимает только cli-base 0.65, поэтому обе версии меняются
  вместе. В cli-base 0.65 есть глаголы `serve` и `revoke`, поэтому их записи в базовой линии линтера удалены, а его
  `cli-dev bundle` находит сервер, запущенный с флагом перед `mcp serve`. С cli-core 0.468 MCP-сервер предлагает
  команду, которая только загружает данные в хранилище, через инструмент чтения.

## 0.83.0 — 27.10.2026 [#0830--27102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-16]

- **MCP-сервер запускается командой `max mcp serve`, а `max mcp` только показывает справку (cli-core 0.463.0).**
  Так же для бота: `max <бот> bot mcp serve`. Входы браузерных приложений завершает `max mcp revoke` вместо
  `max mcp --revoke`. Записи, которые печатают `mcp config` и `mcp add`, `mcp server start`, `doctor --online`,
  запись в MCP Registry и Docker-образ уже запускают `mcp serve`. Что сделать: в своей записи MCP-клиента или в
  скрипте замените `max <профиль> mcp` на `max <профиль> mcp serve`, а `mcp --revoke` на `mcp revoke`. Старого
  вида команды больше нет.
- **`skill show`, `skill status` и `skill install` с `--json` печатают `{ item, meta }` (cli-core 0.462.0).** Поля,
  которые были на верхнем уровне (`name`, `content`, `written`), теперь внутри `item`. Установщик для Windows уже
  читает новый вид.
- **`max account list` показывает, вошёл ли профиль на этом компьютере** (`signed_in`), а результаты поиска любого
  вида называют поля, которые агент читает как данные (`untrusted`). Скрипт, который сверяет ответ со старой строгой
  копией схемы, отвергнет новое поле (cli-core 0.464.0 и 0.466.0).
- **Каждый запуск записывается по умолчанию, удачный тоже (cli-core 0.467.0).** Удачные хранятся 7 дней
  (`keep_successful_runs_for_days`), неудачные — 30 (`keep_runs_for_days`); каталог запусков не больше
  `runs_size_limit_mb` (200). При `record_input` по умолчанию удачная отправка оставляет набранный текст в локальной
  записи с правами `0600` на 7 дней. `record: false` теперь оставляет неудачные запуски (раньше — ничего),
  `record_input: false` скрывает набранное везде, `--no-record` не оставляет ничего. `kept_because_failed` в
  `run.json` больше не ставится.
- **max требует cli-core 0.467.0 и cli-base 0.64.0.**

### Что нового [#что-нового-18]

- **Запрос в записи запуска помечен как сетевой и знает свою попытку.** Каждый кадр личного протокола и каждый
  запрос Bot API в `events.jsonl` получает `"level": "wire"` и `transport` (`max-ws` или `http`). Запрос Bot API
  получает ещё `attempt`, а повтор после `429` или сбоя — `wait_ms`, сколько клиент ждал перед ним. Так же
  нумеруются повторы `messages send`, пока файл не готов (`attachment.not.ready`). Нужен cli-core
  с записью каждого запуска.
- **`max upgrade` перезапускает браузерный MCP-сервер, который запустил `max mcp server start`,** на том же порту, с
  тем же адресом и ограничениями (`mcp_servers`, старая → новая версия); сервер, запущенный вручную, остаётся и
  называется. Сессии агентов по stdio на старой версии перечислены (`stale_sessions`): перезапустите их из приложения
  агента. Работает со следующего обновления (cli-core 0.464.0).

### Исправлено [#исправлено-16]

- **`max mcp serve` без профиля помечает профили, в которые не выполнен вход.** Раньше в списке были все профили, и
  приложение могло выбрать профиль без входа и получить ошибку. Теперь в меню приложения и в описании у такого
  профиля стоит «— not signed in», профили только для бота не показываются (у бота свой `bot mcp serve`), а вызов
  для профиля без входа отвечает, как войти: `max <профиль> setup` или из WireCat Desktop.
- **Страница входа браузерного MCP-сервера объясняет, что код работает для одного входа.** После входа приложения
  новый код появляется в WireCat Desktop и в `max mcp server status` (cli-core 0.466.0).
- **Навык max-cli больше не отправляет агента в `search all` и в `messages sync --all`.** Поиск начинается с
  `search messages`; заметки и Drive только по просьбе владельца. Если ничего не нашлось, агент сообщает об этом и
  предлагает ограниченную загрузку одного чата, а запускает её после согласия владельца. Те же правки в README и
  в docs (search, usage, index, troubleshooting).

## 0.82.0 — 27.10.2026 [#0820--27102026]

### Что нового [#что-нового-19]

- **Без сессии ошибка предлагает и WireCat Desktop.** `no session`, `has not logged in yet` и истёкший токен теперь
  говорят: команда в терминале или вход в WireCat Desktop (Tools → MAX → Manage). По MCP агенту сказано не просить
  коды и пароли (cli-core 0.452.0; с ним и 0.451.0: поиск по смыслу на нативном ONNX Runtime и в Windows).
- **`max mcp` без профиля обслуживает все профили, по stdio и с `--http` (cli-core 0.450.0).** В AI-приложении нужен
  один коннектор для MAX, а не по одному на профиль. У каждого инструмента (`max_tools_search`, `max_read`,
  `max_write`) есть обязательное поле `profile` (все профили на этом компьютере, без умолчания), и агенту сказано
  спросить, если вы не назвали аккаунт. Вызов идёт в собственный `max <profile> mcp` этого профиля: он запускается
  при первом вызове и закрывается после 10 минут простоя, так что права, сессия и журнал профиля действуют как раньше.
  `max mcp --revoke`, `max mcp config` и `max mcp server start|stop|status` работают без профиля, со своим входом.
  `--public-url` принимает путь, `https://<name>.ts.net/max`. Запись в MCP Registry запускает `max mcp`.
  `max <profile> mcp` не изменился.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-17]

- **max требует cli-base 0.63.0 (cli-core 0.450.0).** Ничего из того, чем пользуется max, в нём не изменилось.

### Исправлено [#исправлено-17]

- **Каждая команда тратит меньше времени на подготовку (cli-base 0.62.0, cli-core 0.449.0).** Проверка общих команд
  описывает каждую команду один раз, а не заново для каждой группы над ней. В tg прогретый `run(["--version"])` стал
  быстрее: 29 мс вместо 49. Почему: проверка занимала около 60% подготовки каждой команды. Что учесть: ничего, проверка
  ловит те же изменения.
- **Поиск по смыслу и `--discover` работают на родной ONNX Runtime и в Windows (cli-core 0.451.0).** После
  `max <профиль> models download` текстовые модели и переранжировщик используют родную библиотеку в Windows x64 и
  arm64, как уже в Linux и macOS: в 2–3 раза быстрее WebAssembly. Загрузка берёт `onnxruntime.dll` из npm-пакета
  `onnxruntime-node` (113,5 МБ, один раз, сверка по sha256). Модели картинок (CLIP, SigLIP2) тоже идут через родную
  библиотеку, где она установлена: примерно вдвое быстрее. Результаты те же.

## 0.81.0 — 26.10.2026 [#0810--26102026]

### Что нового [#что-нового-20]

- **Поиск по смыслу и переранжирование `search messages --discover` работают в 2–3 раза быстрее на Linux и Mac с Apple Silicon (cli-core 0.448.0).** Модели теперь считаются нативной библиотекой ONNX Runtime вместо WebAssembly: на одном архиве `--discover` ускорился с 4,6 до 3,2 с, ответы те же. Библиотеку (10–42 МБ, официальный выпуск Microsoft, проверяется по sha256) ставит `max <профиль> models download`; поиск сам ничего не скачивает. Что учесть: на уже настроенной машине ускорение появится после следующего `models download e5-small` или `models download mmarco`. Windows, Mac на Intel и Alpine по-прежнему работают через WebAssembly.

### Исправлено [#исправлено-18]

- **Переранжирование `--discover` видит само найденное сообщение, а не только то, на которое оно отвечает (cli-core 0.447.0).** Раньше модель читала сначала исходное сообщение целиком и обрезала текст на 512 токенах, так что при длинном исходном ответ выпадал из её окна. Теперь от исходного берутся первые 300 знаков.

## 0.80.0 — 26.10.2026 [#0800--26102026]

### Что нового [#что-нового-21]

- **`max <профиль> session start qr --json --answer-stdin` входит без терминала, для WireCat Desktop (cli-core 0.443.0).** Облачный пароль MAX спрашивается строкой `needs` в stderr (`{"event":"needs","field":"password","secret":true,"prompt","hint"}`), а ответ читается одной строкой из stdin; `session start token` так же спрашивает токен. Без `--answer-stdin` запуск без терминала по-прежнему отказывается, чтобы оболочка агента никогда не ждала вопроса. Ответ не печатается и не попадает в записи запусков.
- **`max <профиль> mcp server start|stop|status` держит HTTP-сервер MCP в фоне (cli-core 0.445.0).** `start` принимает `--public-url`, `--port` и `--permission`, как `mcp --http`, и возвращается, когда сервер слушает; `status` показывает порт, адрес, одноразовый код входа и вошедшие приложения; `stop` останавливает только свой сервер. WireCat Desktop запускает и останавливает его из панели Manage.
- **`max <профиль> tasks list claimed_by:<кто>` показывает задачи, которые взял этот исполнитель (cli-core 0.441.0).** `claimed_by:*` — все взятые задачи, `NOT claimed_by:*` — те, за которые никто не взялся; шаблон вроде `claimed_by:claude-code:*` тоже работает. Учитываются только живые захваты: захват с истёкшим сроком ничего не держит.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-18]

- **Справка `--record` говорит, что на самом деле хранит запись запуска.** Было: «ids and timings, never message content», хотя с 0.79.0 запись хранит командную строку так, как вы её набрали. Стало: «with the command as typed and secrets hidden; record_input false leaves the typed words out». Что учесть: меняется текст `max --help` и `docs/commands.md`; проверка, которая сравнивает справку, увидит новую строку.

### Исправлено [#исправлено-19]

- **Код входа для браузерного приложения у `mcp --http` обновляется, когда истекает (cli-core 0.445.0)**, а не только после неверного или опоздавшего ввода. Страница входа говорит, что код показан в WireCat Desktop или в терминале. Второй `mcp --http` для того же профиля теперь отказывается запускаться.
- **`search messages --discover` с переранжированием читает только первые 300 символов сообщения, на которое отвечает найденное (cli-core 0.447.0).** Почему: длинное исходное сообщение занимало всё окно модели, и она оценивала его вместо самого ответа. Что учесть: порядок результатов `--discover` с моделью переранжирования может измениться; модель делает примерно на 40% меньше работы.

### Безопасность [#безопасность-1]

- **Запись запуска скрывает больше секретов по их виду, а не только по имени флага (cli-core 0.440.0–0.444.0).** На `[redacted]` заменяются токены известных форматов (GitHub, OpenAI и Anthropic, Slack, AWS, Google, Stripe, npm, токен бота Telegram, JWT, закрытый ключ PEM), `Bearer` и `Basic`, значение после «секретного» имени (`password=…`, `пароль 1234`, `pin 1234`, `код 123456`), длинные случайные строки и hex-ключи; остальные слова остаются. Номер телефона с «+» или 11–15 цифр подряд скрыт, где бы его ни набрали, в том числе в тексте сообщения. Что учесть: полный хеш коммита и положительный id из 11–15 цифр тоже станут `[redacted]`; номер без «+», записанный группами (`8 912 345-67-89`), не распознаётся.
- **Если настройки не загрузились, запись запуска скрывает набранные слова (cli-core 0.442.0).** Раньше в этом случае `record_input` считался включённым, даже если в настройках записано `record_input: false`.

## 0.79.0 — 26.10.2026 [#0790--26102026]

### Что нового [#что-нового-22]

- **`max skill install --for hermes` ставит навык для Hermes Agent, а `max skill status` говорит, какую копию читает Hermes (cli-base 0.59.0).** Команда добавляет `~/.agents/skills` в `skills.external_dirs` Hermes через `hermes config set`, не трогая уже записанные папки, а если это не вышло — копирует файл в домашнюю папку Hermes. Если Hermes не установлен, команда падает с `not_found` и ничего не пишет. Просто `max skill install` и `--for all` по-прежнему пишут только копии для Claude Code и `~/.agents/skills`. В `skill status --json` рядом с `targets` появился `hermes`.
- **Запуск, начатый OpenClaw или Hermes Agent, называет этого агента (cli-core 0.437.0).** В `runs show` у команды, которую запустил агент OpenClaw, `agent` — `openclaw`, а если её начало сообщение из чата — ещё `from_chat: true`; у запуска Hermes есть его сессия, так что задачу, взятую Hermes, держит одна сессия.
- **Новая настройка `record_input` (cli-core 0.439.0).** `max personal config set record_input false` скрывает в записях запусков то, что вы набрали; `config set` и `config show` её показывают.
- **Навык `max-cli` объявляет для OpenClaw и ClawHub, что ему нужна программа `max` и как её поставить** (`metadata.openclaw`: `requires.bins` и пакет npm `@wirecat/max-cli`). Если `max` нет в PATH, OpenClaw помечает навык как неготовый и предлагает установить пакет. Claude Code и Codex этот блок не читают.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-19]

- **Запись запуска хранит командную строку так, как вы её набрали (cli-core 0.439.0).** В `argv` в `run.json` и в `runs show` теперь видно название чата, поисковый запрос, текст сообщения — раньше вместо них стоял `[redacted]`. Секреты скрыты всегда: значения флагов вроде `--token` и `--password`, пароль в адресе, длинная строка, похожая на ключ, тело `bot api … --body`, номер телефона, набранный после `contacts lookup`. Почему: по записи должно быть видно, что именно запускали. Что учесть: `max personal config set record_input false` возвращает прежнее скрытие для профиля, `max config set record_input false --defaults` — для всех; скрипт или проверка, которая ждёт в `argv` только `[redacted]`, увидит набранные слова. `doctor reports create` по-прежнему скрывает их в отчёте.

### Безопасность [#безопасность-2]

- **Первое слово, которое не может быть профилем, не попадает в запись запуска (cli-core 0.438.0).** Раньше такой запуск хранил его как `profile`, хотя это мог быть текст сообщения или имя человека.
- **Ошибка, которая цитирует `--token=…` или `password=…`, больше не хранит значение (cli-core 0.439.0).**

### Исправлено [#исправлено-20]

- **Навык `max-cli` больше не предлагает агенту `npx @wirecat/max-cli`, если `max` не находится.** Он запускает уже установленный `max` по полному пути: `"$(npm prefix -g)/bin/max" personal doctor` или `"$(pnpm bin -g)/max" personal doctor`. Почему: `npx` скачивает код, а каталоги плагинов могут запрещать такой запуск; обычно `max` установлен, но его нет в PATH агента. Агенты читают навык через `max skill show`.

## 0.78.0 — 26.10.2026 [#0780--26102026]

### Исправлено [#исправлено-21]

- **`max` представляется текущим веб-клиентом MAX: `appVersion` 26.10.7 и Chrome 154** (было 26.9.8 и Chrome 151,
  прочитано 25.09). MAX отказывает версиям клиента, которые больше не поддерживает; `max doctor` показывает дату
  2026-10-26.
- **`npx skills add WireCatLabs/max-cli` предлагает только навык `max-cli`.** Раньше он показывал и четыре навыка для разработчиков max (`add-command`, `parity-audit`, `release`, `test-live`): они лежали в `.claude/skills`, а skills.sh ищет навыки и там. Теперь они в `docs/dev/skills`.
- **Вектор удаляется, как только его не использует ни один текст в базе** (cli-core 0.435.0). Раньше после смены
  картинки у изображения, смены текста расшифровки встречи и очистки чата (`store clear --left`, слияние чата с
  другим) векторы оставались. `conversations embeddings clear --chat` теперь убирает и векторы сообщений чата, не
  только его бесед; `conversations embed --chat` создаёт их снова.
  Что учесть: `store rebuild` удаляет векторы, оставшиеся от прежних версий, и сообщает их число в
  `unused_vectors_dropped`; `store check` считает их в `vectors.unused`.
- **В установке одна копия sherpa-onnx, а не две** (cli-core 0.433.0). В 0.77.0 max перешёл на sherpa-onnx 2.0
  раньше cli-core, и установка выросла примерно на 15 МБ; теперь и cli-core на 2.0. Команды и их вывод не меняются.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-20]

- **Общая база переходит на версию 34: CLI на cli-core 0.433.0 и старше её больше не откроют** (cli-core 0.434.0).
  Поиск по смыслу берёт кандидатов из индекса sqlite-vec в базе, а не перебирает все векторы; ответ тот же, что у
  перебора. Первое открытие базы этой версией строит индекс по уже сохранённым векторам, короткими порциями.
  Почему: перебор всех векторов медленнее с каждым сообщением, у которого есть вектор.
  Что учесть: обновите вместе с max все CLI, которые читают ту же базу (tg, wa, memo, zm, drive), — старые откажутся
  от неё и попросят обновиться. Расширение входит в установку (`@wirecat/cli-core-sqlite` 1.1.0); если оно не
  загрузилось, команда, которой нужна база, завершается ошибкой `store.vector-extension-missing` или
  `store.vector-extension-failed` — переустановите max. `store check` показывает `vector_indexes` и не проходит
  `checks.vector_indexes`, когда индекс расходится с векторами.
- **Справка `max upgrade` показывает только пример `max upgrade --check`** (cli-core 0.433.0).
  Почему: пример `max upgrade` без флага, скопированный и запущенный, сразу обновлял программу.
  Что учесть: в выводе `max upgrade --help` и `max commands --json` меняется только эта строка.
- **Модель Anthropic получает ключ в заголовке `Authorization: Bearer`, а не `X-Api-Key`** (cli-core 0.433.0,
  `@anthropic-ai/sdk` 1.3).
  Почему: так отправляет ключ новая версия библиотеки Anthropic.
  Что учесть: касается только `models.<назначение>.base_url` с провайдером `anthropic`, то есть своего шлюза вместо
  адреса Anthropic: такой шлюз должен читать ключ из `Authorization`.

### Что нового [#что-нового-23]

- **`search messages --discover` переставляет первые 50 результатов моделью-реранкером, когда она скачана**
  (`max models download mmarco`, 136 МБ; cli-core 0.435.0). Модель читает вопрос вместе с каждым результатом, его чатом,
  автором, датой и сообщением, на которое он отвечает; её оценка смешивается с оценкой поиска, а остальные результаты
  сохраняют порядок. У каждого переставленного результата есть `discovery.reranker_score`, а `score` остаётся
  оценкой поиска. Без модели порядок прежний, и поиск говорит об этом: заметка `not reranked: …` в терминале,
  `missing`/`next` (`models.download`) в `--json` и MCP. На перестановку отведено 15 секунд сверх поиска по словам;
  не успела — результаты остаются без неё. Новая настройка профиля `search_reranker` выбирает `bge-reranker-v2-m3`
  (588 МБ) или выключает перестановку (`off`). Ничего не скачивается само, и текст не уходит с компьютера.
  `models list` показывает реранкеры с видом `reranker`.
- **`search all` ищет сообщения и по смыслу**, когда модель e5-small скачана и у сообщений есть векторы (cli-core
  0.435.0). Совпадения по словам и по смыслу сливаются в один список сообщений, а `foundBy` у каждого говорит, какой
  поиск его нашёл. Запрос с NOT или с фильтром внутри OR и групп, а также `--exact` и `--backend server` ищут
  только по словам. Без модели или векторов `search all` ищет по словам, как раньше, и говорит почему: заметка
  `messages: meaning search not used: …`, `missing`/`next` в `--json` и MCP.

## 0.77.0 — 25.10.2026 [#0770--25102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-21]

- **Распознавание голосовых сообщений работает на sherpa-onnx 2.0, а установка стала больше примерно на 15 МБ.**
  Раньше max и cli-core использовали одну копию sherpa-onnx 1.13.8.
  Почему: все зависимости обновлены до последних версий; в 2.0 убраны только части синтеза речи,
  распознавание работает как прежде.
  Что учесть: пока cli-core не перейдёт на sherpa-onnx 2.0, в установке лежат две копии этого пакета.
  Команды и их вывод не меняются. Неиспользуемые `string-width` и `wrap-ansi` больше не ставятся
  вместе с max; если ваш скрипт подключал их из установки max, поставьте их отдельно.
- **Запуск `bot`-команды, который упал, называет вызов Bot API, на котором это случилось.** В `runs show` и `runs list` у `error.http` рядом с HTTP-кодом появились `method` и `endpoint_template`, например `{ "method": "GET", "endpoint_template": "/chats/:id", "status": 403 }`; раньше там был только код.
  Почему: по одному коду не видно, какой из вызовов команды отказал.
  Что учесть: id чата, пользователя и сообщения в пути записаны как `:id`, токен видео — как `:token`, а параметры запроса в шаблон не попадают, поэтому настоящие id и токен в запись не попадают. Те же два поля есть у запросов бота в `--trace` и в записи запуска, а строка `--trace` показывает их после имени операции (`← getMyInfo  GET /me  200 …`). Скрипт, который разбирает текст `--trace`, увидит лишний столбец.

### Что нового [#что-нового-24]

- **`store reset --dry-run` перечисляет, что очистит сброс, и ничего не удаляет** (cli-core 0.429.0): файлы базы и их размер, каждую таблицу с данными и числом строк, будет ли сначала копия и держит ли файл serve или другой процесс.
- **`search messages --discover` находит и сообщения, близкие по смыслу**, когда модель e5-small скачана, а `conversations rebuild` дал сообщениям свои векторы (cli-core 0.432.0). У каждого результата `discovery.found_by` говорит, какой поиск его нашёл. До этого поиск идёт по словам, как раньше, и объясняет почему. Ничего не скачивается, и текст не уходит с компьютера.

### Исправлено [#исправлено-22]

- **Голый `--version` отвечает до загрузки программы**: bin запускается через `@wirecat/cli-core/cli/start` (cli-core 0.429.0).

## 0.76.0 — 25.10.2026 [#0760--25102026]

### Исправлено [#исправлено-23]

- **Сбой посреди команды теперь сообщается как любая другая ошибка.** Раньше печаталась трассировка стека Node, теперь — ошибка `internal_error` (`command.crashed`): одна строка в терминале, JSON-объект ошибки в остальных случаях; код выхода по-прежнему 1.
  Почему: трассировка ничего не говорит скрипту и может вывести на экран текст, которому там не место.
  Что учесть: если скрипт разбирал трассировку в stderr, пусть читает объект ошибки.

### Что нового [#что-нового-25]

- **`max doctor --json` перечисляет все ошибки файла настроек в `config.issues` (cli-core 0.423.0).** Каждая ошибка — `{ kind, file, profile?, key?, line?, column?, what, fix? }`; `kind` — `invalid_json`, `unknown_setting`, `unknown_permission`, `missing_setting` или `invalid_value`. Для неверного JSON `line` и `column` показывают, где разбор остановился; для остальных `fix` — команда `config unset`, которая убирает ключ и выполняется как написана. Значение настройки в ответ не попадает. С ошибками в файле `doctor` отвечает и завершается с кодом `0`, а без имени профиля отвечает с `profile: null`.
- **`config show` работает с файлом, в котором есть ошибки, и называет каждую с командой, которая её убирает.** `config unset` удаляет и ключ, который не знает ни одна схема, в том числе в корне файла (`max config unset <ключ>`).
- **`max skill status` и `max skill show --for claude|agents` (cli-core 0.427.0).** `status` говорит, совпадает ли установленный SKILL.md с этой версией; `show --for` печатает установленную копию.
- **`max store tables list` перечисляет таблицы общего архива, а `store info` показывает больше о файле (cli-core 0.427.0).**
- **Запись запуска говорит, кто его начал и что пошло не так (cli-core 0.425.0).** В `run.json`, `runs list`, `runs show` и `search runs` появились `cli_command`, `argv` (содержимое и секреты — `[redacted]`), `agent` и для упавшего запуска `error`.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-22]

- **`npm install -g` выбирает агента для навыка только по `MAX_INSTALL_AGENT`.** `TG_INSTALL_AGENT` больше не читается.
- **В ответе `doctor` вместо строки `config.error` — список `config.issues`.** Если настройки не удалось разрешить из-за блокировки профиля, флага или переменной окружения, сообщение — в `settings.error`.
- **Старые имена настроек больше не распознаются.** `default_profile`, `analysis_provider`, `analysis_model`, `analysis_base_url` с переменными `MAX_ANALYSIS_*` и имена в camelCase (`sendsPerHour` и другие) — неизвестные настройки, как любые другие: команда отказывает и называет `config unset`, который убирает ключ. Модель анализа задаётся в `models.analysis.provider`, `models.analysis.model` и `models.analysis.base_url`.
- **`messages sync` и `bot messages sync` проверяются по своим ключам `messages.sync` и `bot.messages.sync` (cli-core 0.421.0).** Уровень на `messages` или `bot.messages` по-прежнему действует на них, а запрет, записанный прямо на `messages.sync` или `bot.messages.sync`, теперь останавливает команду. Команды бота проверяют запрет на чтение до подключения.
- **Сохранённый ключ права, который не проверяет ни одна команда, останавливает и команды бота, и `--dry-run`.** Ошибка называет ключ и `config unset`, который его удаляет; `config show`, `set` и `unset` работают, чтобы файл можно было исправить.
- **Прежние имена команд получают обычный ответ «unknown command», без подсказки.** `max personal search mail` больше не называет memo: почту ищет `memo search mail`.
- **Запуск без названного профиля записывается без `profile`, а не с `"profile": "default"` (cli-core 0.424.0).**
- **В записи запуска стек упавшей команды начинается с имени пакета и без строк Node (cli-core 0.425.0).** Строка стека — `MaxClient.connect @wirecat/max-cli/client.js:1497`, а не `client.js:1497`; строк `node:internal` больше нет.
- **`config set` записывает `config.json` с правами `0600`, а не `0644` (cli-base 0.57.0).** В файле — профили, аккаунты и пути владельца. Программа, которая читает настройки от имени другого пользователя, после следующего `config set` их не прочитает.

### Безопасность [#безопасность-3]

- **`max doctor` называет `config.json` и его каталог, если их могут читать другие пользователи, и команду `chmod`, которая это исправляет.** В `--json` это `files`: `{ checked, ok, problems: [{ path, mode, want }] }`, файл должен быть `0600`, каталог — `0700`. Для каждой проблемы на stderr строка `to make it private: chmod 600 '<путь>'`; сам `doctor` права не меняет. Каталог проверяется и тогда, когда его задаёт `MAX_CONFIG_DIR`. Блок есть и без имени профиля, и когда настройки не разрешились; в отчёт `doctor reports create` он тоже попадает. В Windows права не проверяются: `files` — `{ checked: false, reason }`.

## 0.75.0 — 25.10.2026 [#0750--25102026]

### Что нового [#что-нового-26]

- `max --help` называет `max account list` — список профилей и их вошедших аккаунтов.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-23]

- **Старые имена разрешений статистики и поиска больше не распознаются.** Раньше ключи `messages.stats`, `chats.stats`, `tasks.stats`, `messages.search`, `conversations.search` и `topics.search` останавливали команду с подсказкой, как их переименовать; теперь такой ключ просто не действует, и запрет, сохранённый под старым именем, больше не применяется. Переименуйте их в `stats.messages.show`, `stats.chats.show`, `stats.tasks.show`, `search.messages`, `search.conversations` и `search.topics`.
- **Общая база переходит на версию 33 (cli-core 0.420.0).** Когда эта версия откроет базу, CLI на более старом cli-core откажется с ней работать и попросит обновиться, поэтому обновляйте все CLI WireCat, которые делят базу, вместе.

## 0.74.0 — 25.10.2026 [#0740--25102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-24]

- **`bot store fetch` теперь `bot messages sync`, группы `bot store` больше нет.** Команда делает то же, что личная `messages sync`, поэтому и называется так же; `store` — это локальная база. Старое имя отвечает подсказкой с новым. Если в настройках сохранено `permissions.bot.store.fetch`, команды откажут, пока ключ не переименован в `permissions.bot.messages.sync`.

## 0.73.0 — 25.10.2026 [#0730--25102026]

### Что нового [#что-нового-27]

- **`chats requests confirm|reject <чат> --all` отвечает на все заявки канала сразу.** Количество заявок
  сначала проверяется по правам профиля и лимиту действий в час, затем уходит один запрос MAX.
  Используйте только для канала, где нужно ответить всем ожидающим. Отбор через `--link` недоступен:
  текущий интерфейс MAX не сообщает, по какой ссылке пришла заявка.

- Списки участников бота, комментариев и разрешённых получателей принимают запрос по полям. Идентификаторы участников и комментариев передаются в Bot API до ограничения страницы; список получателей фильтруется при чтении и не меняет права отправки. Комментарий также показывает свой строковый `id`, когда API передал его в `body.mid`.

### Исправлено [#исправлено-24]

- **`watch --jsonl` печатает записи `item` и итоговую `end`.** Ошибка источника завершает поток неполным итогом; `--json` отказывается до подписки. Список разрешённых получателей использует общий нативный запрос.
- **Архивирование не останавливается на событии звонка рядом с файлом.** Файл сохраняется и проходит
  проверку контрольной суммы, сообщения только со звонком не требуют скачивания.
- **Диагностический отчёт использует общий модуль WireCat.** Формат MAX и технические поля событий
  сохраняются; содержимое сообщений исключается, идентификаторы получают метки внутри отчёта.

- **Запрет прав не скрывает команду.** Каталог CLI и MCP сохраняет команды и показывает текущую доступность с причиной запрета; вызов по-прежнему проверяет права. MCP бота также показывает команды настройки в пределах профиля бота.
- **Изменение настроек использует общую реализацию WireCat.** `config set|unset` сохраняет формат ответа,
  настройки MAX и ограничения прав; проверка и запись файла выполняются общим модулем.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-25]

- **Второй адрес webhook добавляется с `--append`.** `--add <chat>` остаётся флагом изменения папки. Неизвестный состав чата и список типов webhook теперь отсутствуют вместо `null`.

- **Общие контракты команд нельзя менять молча.** `commands info --json` показывает исходные определения, схемы, причины ошибок и явные отличия MAX. Для событий контакта вместо флагов времени и области используются `at:` и `scope:`, для записей диагностики — `started_at:`.

### Безопасность [#безопасность-4]

- **Разрешение зависимостей исключает уязвимые версии Vite.** Проверка производственных зависимостей выполняется и для сохранённого, и для нового разрешения.

## 0.72.0 — 24.10.2026 [#0720--24102026]

### Что нового [#что-нового-28]

- **`max serve` после входа запрашивает ещё больше того, что запрашивает вкладка web.max.ru:** карточки и статус
  «в сети» собеседников из личных чатов. После первого входа ещё истории для списка чатов, недостающие чаты
  папок и следующую страницу списка.
  Почему: чем меньше `max` отличается от веб-клиента, тем меньше у MAX поводов его заметить.
  Что учесть: всё это только чтение, ответы не показываются. Подписки на push-уведомления `max` по-прежнему
  не отправляет ([что уходит в сеть](/llms.mdx/docs/ru/max/security/content.md#%D1%87%D1%82%D0%BE-%D1%83%D1%85%D0%BE%D0%B4%D0%B8%D1%82-%D0%B2-%D1%81%D0%B5%D1%82%D1%8C)).

- **При первом обычном запуске в терминале `max` задаёт три общих вопроса:** языки поиска, установка других
  инструментов WireCat и допустимость изменений. Ответ «только чтение» ограничивает все профили, в том числе
  MCP, даже если у профиля есть более точный `allow`. Агентам, конвейерам, JSON-режиму и CI вопросы не задаются.
  Изменить ответы можно через `max setup`.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-26]

- **Общие команды переименованы по единому словарю, старых имён больше нет** (cli-core 0.406.0). Например:
  `contacts profile` → `contacts info`, `contacts timeline` → `contacts events`, `contacts alias` → `contacts aliases`,
  `chats link` → `chats links`, `metadata refresh` → `metadata sync`, `store reindex` → `store rebuild`,
  `commands schema` → `commands info`, `stats messages counters refresh` → `stats messages counters sync`,
  `models text key` → `models keys`, `models audio list` → `models list kind:audio`, `doctor report` → `doctor reports show`.
  Старая команда не запускается и называет новую. Скрытые старые написания опций тоже убраны.
  Что учесть: перенесите скрипты, расписания и сохранённые вызовы MCP. Ключ прав со старым путём
  (например `permissions.metadata.refresh`) теперь останавливает запуск с `configuration_error` и называет новый.
- **`max <profile> watch --json` печатает записи `{ "type": "item", "data": … }` и в конце `{ "type": "end" }`** (cli-core 0.400.0).
  Поля сообщений и событий — snake_case, значения сообщений в каноническом виде со ссылками. Нормальная остановка
  и таймаут завершаются полным `end`, сбой источника — неполным и кодом ошибки.
  Что учесть: читатели прежних сырых строк нужно обновить.
- **Поиск запусков — `max <profile> search runs`, а не `runs search`.** Условия `status:`, `error_code:`, `operation:`
  и `profile:` пишутся в запросе: `search runs status:failed error_code:timeout`. Псевдонима нет; сохранённые
  запросы MCP нужно перенести на `search runs`.
- **Статистика выбирает строки запросом.** Вместо `--chat` и `--exact` — `chat:` и `exact:`; рейтинги — `message_kind:`
  и `min_messages:`, обсуждения — `min_views:` и `max_replies:`, вопросы без ответа — `older_than:`. Сохранённые
  вызовы CLI и MCP нужно перенести; `--source` и `--timezone` остались опциями.
- **Команды, меняющие то, что смогут следующие запуски, доступны агенту через MCP только при
  `permissions.mcp.authority: allow` или `ask`** в профиле (по умолчанию `deny`): `config set|unset`, `recipients add|remove|clear`,
  `replies …`, `schedule command|agent|remove`, `skill install`, `flood clear`, ключи моделей и другие.
  Агент не может сменить этот ключ через `config set`. Подробности — в разделе
  [«Чего нет в MCP»](/llms.mdx/docs/ru/max/mcp/content.md#%D1%87%D0%B5%D0%B3%D0%BE-%D0%BD%D0%B5%D1%82-%D0%B2-mcp).

- **Работа с хранилищем, управление сервером, скачивание моделей и создание отчёта доступны через MCP.**
  У команд появились собственные ключи разрешений, например `store.backup`, `server.start`,
  `models.download`, `doctor.reports.create`; по умолчанию — `ask`. Проверьте права профиля, если
  агент должен выполнять только чтение: в MCP `ask` допускает запрошенную запись без формы подтверждения.
- **Сырые операции `bot api` доступны агенту только при явном `permissions.bot.api: allow` или `ask`.**
  По умолчанию — `deny`; общий `bot: allow` этот доступ не открывает. Агент не может менять `mcp` и `bot.api`
  через настройки или заменять `permissions` целиком; отдельные остальные ключи доступны при разрешённом
  `mcp.authority`. Вызовы Bot API в max сохраняют проверки прав и списка получателей, запись в журнал.
- **Пары похожих задач читаются через `tasks duplicates list [query...]`.** Группа `tasks duplicates`
  больше не выводит список. Перенесите сохранённые вызовы CLI и MCP на явную команду `list`.
- **`events list` возвращает даты ISO 8601 и строковые идентификаторы.** `starts_at`, `ends_at`, `deleted_at`,
  `created_at`, `updated_at` больше не числа миллисекунд; `id` и `event_series_id` больше не числа.
  Обновите обработчики JSON, если они рассчитывали на прежние типы.

- **`doctor reports create` проверяет права до создания файла.** При неверной конфигурации команда
  отказывает с кодом 3, потому что разрешение на запись нельзя проверить. Сначала прочитайте причину
  через `doctor` и исправьте настройку; при корректном файле безопасное создание отчёта доступно и
  под `MAX_READ_ONLY`.

### Исправлено [#исправлено-25]

- **`attachments download` пропускает сервисные события и встроенные клавиатуры.** Такие вложения не содержат
  файла; раньше чат с ними останавливал копирование с кодом 13. Уже сохранённые копии можно проверить
  через `attachments check`; повторное скачивание сохраняет их.

## 0.71.0 — 23.10.2026 [#0710--23102026]

### Что нового [#что-нового-29]

- **Расшифровка голосового находится в любой форме слова и в искажениях распознавания речи** (cli-core 0.396.0).
  `max <profile> search messages риелтор` находит в расшифровке и «риелтору», и «реелтора». Сообщение, найденное
  только через искажение, помечено `match: "corrected"` и `corrections`. Числительные, фразы, `exact:` и
  написанный текст сообщений не расширяются. Текст, который агент записал к голосовому, — тоже расшифровка.
  Хранилище переходит на версию 29 при первом запуске.
- **Через MCP агенту доступно больше команд,** каждая в пределах прав профиля (cli-core 0.398.0): `config show`,
  `doctor report`, `runs list|show|path`, `store status|info|check|export|reindex`, `store jobs cancel|retry|clear`,
  `attachments move`, `attachments jobs status`, `commands schema`, `guide`, `skill show`, списки моделей,
  `replies status|test|consents show`, `schedule list`, `server status|logs`; у бота — `list`, `chats leave`,
  `chats admins add|remove`, `commands set|clear`, `webhooks list|set|delete`. Что агенту недоступно и почему —
  в разделе [«Чего нет в MCP»](/llms.mdx/docs/ru/max/mcp/content.md#%D1%87%D0%B5%D0%B3%D0%BE-%D0%BD%D0%B5%D1%82-%D0%B2-mcp).
- **`max <profile> review --offline` отвечает по локальной копии** вместо отказа (cli-core 0.398.0). Он показывает
  только то, что уже было синхронизировано, и предупреждает об этом (`missing` в JSON).
- **Проверяемые копии файлов.** `attachments download <dir>` сохраняет доступные файлы разных чатов с размером
  и SHA-256; `attachments check <dir>` проверяет копии без сети. `attachments jobs` управляет ежедневным
  копированием в Linux, включаемым явно. Готовые копии переживают прерывания и очистку истории сообщений.
  `attachments move <dir> <archive-dir> --before-time <time>` переносит старые изображения в другой
  проверяемый архив и сохраняет новое расположение, чтобы проверять копии и не скачивать их повторно.

- Поиск по сохранённым расшифровкам голосовых находит формы слов и варианты, искажённые распознаванием речи.
  `text:` ищет только написанный текст; `exact:` отключает расширение поиска для указанного слова.

### Исправлено [#исправлено-26]

- **Пример из `--help` можно вставить и запустить:** строка `Example:` называет профиль `personal`
  (`max personal review "date>2h"`), а не падает с «name a profile» (cli-core 0.398.0).
- Сохранённые поиски встреч больше не показываются и не удаляются командами поиска сообщений.
- Подсказки исправления команд сохраняют явно выбранный профиль; справка показывает краткие описания и примеры.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-27]

- В аргументах MCP удаление сообщений принимает `message`, экспорт чатов — `chat`, операции с дубликатами
  задач — `task` и, для пары, `other_task`. Обновите сохранённые MCP-запросы с ключами `messages`, `chats` или `dup`.
  Порядок позиционных аргументов CLI не изменился.
- Команды справочника `commands` и `commands schema` отклоняют `--jsonl`: используйте `--json` для одного документа.

## 0.70.0 — 23.10.2026 [#0700--23102026]

### Что нового [#что-нового-30]

- **`contacts prepare <person>` готовит сводку перед разговором** из сохранённых сообщений, задач, фактов и заметок, со ссылками на источники. Команда общая с tg и wa и не подключается к MAX (cli-core 0.394.0).
- **В справке команд появились примеры вызова** из cli-core 0.394.0.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-28]

- **Чтение больше не помечает чаты прочитанными.** У `messages list` удалён `--mark-read`, у `inbox` и `review` — `--mark-read` и `--no-mark-read`; настройка `catch_up_marks_read` больше не принимается. Чтобы явно отправить отметку, используйте `chats mark-read`.
- **Неизвестный вложенный ключ разрешений теперь отклоняется** как ошибка конфигурации, до подключения. Исправьте опечатку в ключе вместо прежнего предупреждения.

## 0.69.0 — 22.10.2026 [#0690--22102026]

### Что нового [#что-нового-31]

- **JSON-ответы команд с фильтром по дате называют пояс, в котором прочитана дата, и дают окно в UTC**
  (cli-core 0.385.0): `meta.timezone` — пояс, если в значении его не было, `meta.window` — границы `since` и `until`
  в UTC. Так отвечают `stats chats show`, `stats chats retention`, `stats messages unanswered`,
  `stats messages discussion`, `stats contacts responses`, `stats chats newcomers`, `contacts context`,
  `search conversations`, `runs search`, `messages sync`, `store export`, `replies test`, а также `inbox`, `review`,
  `chats events` и `chats members history` с условием `time:` или `date:` в запросе.
  Почему: по одному ответу было не понять, какое окно команда взяла на самом деле, если дата была без пояса.
  Что учесть: поля новые и необязательные, прежние поля не изменились. `search conversations` с `--timezone` теперь
  читает дату без времени в этом поясе.
- **У чата в JSON появились `muted_until` (когда кончается отключение звука, UTC) и `marked_unread` (чат помечен
  непрочитанным)** (cli-core 0.382.0).

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-29]

- **`inbox` и `review` по сохранённым чатам больше не показывают чаты с отключённым звуком и архивные**
  (cli-core 0.382.0). Раньше в сохранённых чатах этих отметок не было, и такие чаты попадали в выдачу.
  Почему: max присылает отметки в списке чатов, и ответ по сохранённым чатам теперь совпадает с ответом MAX.
  Что учесть: если скрипт ждал такие чаты в `inbox` или `review`, ищите их через `chats list`.
- **Хранилище, в которое процесс не может писать, теперь даёт ошибку прав (`permission_error`, код выхода 5,
  причина `store.not-writable`)** (cli-core 0.381.0). Раньше это была `internal_error` с текстом «this is a bug».
  Что учесть: скрипт, который ловил код выхода этой ошибки, получит 5 вместо прежнего.

### Исправлено [#исправлено-27]

- **Чат или человека теперь находит имя, скопированное вместе с эмодзи** (cli-core 0.381.0). Скопированный эмодзи
  часто несёт невидимый знак, которого нет у набранного, и «Семья❤️» не находила чат «Семья❤».

## 0.68.0 — 22.10.2026 [#0680--22102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-30]

- **Дата или время без пояса в `--since-time`, `--until-time`, `--at-time` и `chats mute --until`
  читаются в поясе компьютера, а дата без времени — как местная полночь** (cli-core 0.379.0, cli-base 0.48.0).
  Раньше `2026-09-01` означало полночь по UTC. Пояс, названный в самом значении (`…Z`, `+02:00`), по-прежнему
  главный; где у команды есть `--timezone`, он важнее пояса компьютера. Как граница «до» дата без времени
  охватывает весь местный день.
  Почему: «сообщения за 1 сентября» — это день владельца, а не день по UTC, который начинается на несколько
  часов раньше или позже.
  Что учесть: скрипт, который передавал дату без пояса и ждал UTC, теперь получит другое окно. Чтобы оно не
  менялось, пишите время с `Z`: `2026-09-01T00:00:00Z`. JSON-ответы по-прежнему дают время в UTC с `Z`.
- **`stats chats retention` и `chats stats show` читают `--since-time` и `--until-time` в поясе `--timezone`**, а
  дата в `--until-time` у retention охватывает весь местный день (cli-core 0.380.0). Ответы `stats charts`,
  `contacts timeline` и MCP `stats` называют пояс в `meta.timezone` и окно в UTC в `meta.window`.

### Исправлено [#исправлено-28]

- **`max watch` пишет время сообщений в поясе компьютера и называет его строкой `times in <пояс>`** перед первым
  сообщением. Раньше пояс нигде не назывался. Строки `--jsonl` не изменились.
- **`max doctor` и отказ во входе после частых попыток пишут время как `2026-10-21 16:03 Europe/Madrid`.**
  Раньше это была строка UTC вида `2026-10-21T14:03:00.000Z`, которую легко прочитать как местное время. В
  `max doctor --json` время осталось в UTC.

## 0.67.0 — 21.10.2026 [#0670--21102026]

### Исправлено [#исправлено-29]

- **Закрытая или недоступная связка ключей Linux теперь даёт предупреждение и переходит на файл учётных данных**
  (cli-base 0.47.5). Связка читается только через Secret Service; раньше сбой мог закончиться тихим сохранением
  в памяти ядра, которое пропадает после выхода из сессии или перезагрузки.

## 0.66.0 — 20.10.2026 [#0660--20102026]

### Что нового [#что-нового-32]

- **Хранилище помнит историю чата (версия хранилища 25, cli-core 0.366.0).** Смена id, названия, участия или
  видимости чата пишется в `chat_revisions` со старым и новым значением; чтение по старому id чата, получившего
  новый, находит его. Хранилище переходит на версию 25 при первом открытии; ничего не отправляется.

### Исправлено [#исправлено-30]

- **Покинутый чат находится по любому своему id** (cli-core 0.368.0): `store export`, `store status`, `messages
  thread`, `--chat` и `chat:` в поиске, теги, задачи и другие чтения сохранённой истории. `chats track` и
  `store gaps plan` отказывают для покинутого чата: «you left chat <id>».
- **`max guide catch-up` и первый экран `max --help` берут фильтр в кавычки: `max review 'date>1d' --unanswered 4h`.**
  Без кавычек оболочка читала `>` как перенаправление: создавала файл `1d`, а `review` шёл без фильтра. На
  cli-core 0.370.0 проверка сценариев в тестах ловит такие символы вне кавычек.
- **«Works with» пишет название сценария memo так же, как memo и остальные инструменты:** «One person across every
  tool», с заглавной.

## 0.65.0 — 19.10.2026 [#0650--19102026]

### Что нового [#что-нового-33]

- **`store clear --left` называет чаты, которые удаляет** (cli-core 0.353.0–0.362.0). Отказ без
  `--allow-dangerous` перечисляет первые 20 по id, названию и числу сообщений; новый `--dry-run` показывает все в
  `left` и ничего не удаляет; ответ после удаления тоже несёт `left`.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-31]

- **Без терминала `session start qr` и `setup` печатают QR-код текстом, а `--qr-file` удалён.** Владелец входил
  через PNG, который агент открывал в просмотрщике картинок, — отдельное окно легко потерять. Теперь код идёт в
  stderr обычным текстом (символы `█▀▄`, без цвета, читается на тёмной теме), агент вставляет его в чат блоком кода.
  С `--json` код ещё и строка `{"event":"qr","qr":{"text","expires_at","scan"}}` в stderr. В терминале код рисуется
  как прежде. Скрипт с `--qr-file` теперь получает ошибку о неизвестной опции. Как агенту войти —
  [sessions.md](/llms.mdx/docs/ru/max/sessions/content.md#%D0%B2%D1%85%D0%BE%D0%B4-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0).

### Исправлено [#исправлено-31]

- **Чат, в который владелец вернулся, больше не остаётся помеченным «покинут»** (cli-core 0.352.0). Неполный
  список чатов и вход снимают эту метку с чатов, которые они называют; «в архиве» и другие состояния остаются.
  Раньше такой чат мог пропасть из `max chats list`, а `store clear --left` удалял его вместе с сообщениями.
  Полный список, как и прежде, помечает «покинут» чаты, которых в нём нет.

## 0.64.0 — 19.10.2026 [#0640--19102026]

### Что нового [#что-нового-34]

- **`session start qr --qr-file <png>` и `setup --qr-file <png>`**, как в tg и wa: QR-код пишется в PNG для агента,
  без терминала. Файл создаётся сразу с режимом `0600` и удаляется после входа. Вход по QR теперь идёт через
  `loginQr` из cli-core 0.347.0, один для всех трёх CLI.
- **Следующий шаг в выводе `--json` и в ошибке несёт `line` — всю команду с профилем** (cli-core 0.348.0):
  `"line": "max personal mcp config"` рядом с `"command": "mcp config"`. Скопированная одна `command` падала с
  «name a profile». `command` не меняется, в ответах MCP `line` нет.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-32]

- **Узкий терминал больше не открывает QR-код в браузере.** Код не рисуется, и `max` пишет, что окно нужно
  расширить или передать `--qr-file`. Почему: вход по QR теперь общий для tg, max и wa, а браузер, открытый сам
  собой, нельзя было перенести в cli-core для всех трёх. MAX выдаёт один код на запуск, поэтому в узком окне
  дождаться нечего: прервите команду и запустите её шире или с `--qr-file`.
- Без терминала `session start qr` и `setup` отвечают так же, как tg и wa: «shows a QR code to scan — run it in a
  terminal, or pass --qr-file <png>».

### Исправлено [#исправлено-32]

- **Шаг входа в `setup` называется «Link this device»** и больше не просит отсканировать QR-код до того, как он
  нарисован. Где сканировать, говорит строка под самим кодом; в узком терминале — только подсказка расширить его.
- **Узкий терминал больше не просит отсканировать QR-код, которого нет** (cli-core 0.350.0). `session start qr` и
  `setup` писали «scan this code with the MAX app on your phone» до кода; если код не помещался, дальше шла только
  подсказка расширить окно или передать `--qr-file`. Теперь строка «scan in the MAX app on your phone» идёт после
  нарисованного кода или заметки о `--qr-file`, а на узком терминале выводится только подсказка.
- **Подсказки в ошибках и заметках называют профиль**: «the store is behind this build — `max personal store
  migrate`» вместо `max store migrate`, которая при копировании падала с «name a profile». Так же подсказка о
  скачивании модели речи: `max personal models audio download gigaam-v3`.

## 0.63.0 — 19.10.2026 [#0630--19102026]

### Что нового [#что-нового-35]

- **`max --help` и `max` без команды показывают короткий первый экран** (cli-core 0.345.0): что умеет max, другие
  инструменты WireCat и куда идти дальше — `max commands`, `max guide`, `max help options`, `max skill show`.
  Полный список команд и все общие опции он больше не печатает.
- **`max guide` — сценарии: какие команды выполнить по порядку для частой задачи.** Четыре сценария: `catch-up`
  (разобрать накопившееся), `find-what-was-said` (найти, что кто-то написал), `agent-on-a-timer` (агент по
  расписанию, который не может отправлять) и `post-as-a-bot` (написать от имени бота). `max guide <имя>` печатает
  шаги, `--json` — то же данными. Сценарий `memo guide person-brief` показан в разделе «Works with».
- **`max help options`** печатает опции всех команд, **`max --help-all`** — прежнюю полную справку.
- **`max commands` без `--json` печатает список команд по разделам** (Read, Write, Organise, Automate, Set up), по
  строке на команду; `max commands <путь>` сужает его.
- **Справка каждой команды заканчивается строками Returns, Next usually и Example**, и те же строки есть в
  [справочнике команд](/llms.mdx/docs/ru/max/commands/content.md).

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-33]

- **`npm install -g` больше не ставит навык агента сам.** Он молча писал в `~/.claude/skills` и `~/.agents/skills`,
  а npm прячет вывод сценария установки. Теперь навык ставит `max <профиль> setup` или `max skill install --for all`;
  `MAX_INSTALL_AGENT=all` (или имя агента) при установке ставит его сразу, как раньше. Установщик для Windows
  передаёт `all` сам и ведёт себя как прежде.
- **`max --help` больше не перечисляет команды и общие опции.** Скрипту, который искал их там, нужен
  `max --help-all` или `max help options`.
- **`max commands` без `--json` печатает текст, даже в канал.** Раньше он печатал весь JSON-документ (сотни
  килобайт); скрипту, который его разбирал, нужно добавить `--json`.
- **Опечатка в опции списка с запросом — ошибка неизвестной опции** (`unknown option '--limt' (Did you mean
  --limit?)`), а не слово запроса. Отрицание вроде `-kind:channel` по-прежнему часть запроса.

### Исправлено [#исправлено-33]

- **`inbox` и `review` объявляют свой вывод** (cli-core 0.345.0): `max commands schema inbox` даёт поля сводки
  сообщения, а `--json=<поля>` с именем, которого у неё нет, отказывает со списком полей, а не возвращает пустые
  записи.
- **`--brief` и `--full` больше не упоминают почту** в справке max.
- **Опечатка в имени профиля больше не создаёт профиль.** `max typoprofile chats list` отказывал, но оставлял файл
  `profiles/typoprofile.json`, и потом ошибка «name a profile» и `max complete` предлагали `typoprofile` как профиль
  на этом компьютере. Теперь файл появляется только при входе; `session end` для такого имени его тоже не создаёт.
  Файлы, оставшиеся от прежних опечаток, можно удалить из `~/.local/share/max-cli/profiles/`.
- **`max <профиль> doctor` без токена советует `max <профиль> setup`**, как README и ошибка «no session», а не
  `session start`.

### Безопасность [#безопасность-5]

- **Запрет записи срабатывает до подключения к MAX** (cli-core). Под `MAX_READ_ONLY=1` или с уровнем `readonly`
  либо `deny` команды `messages send`, `messages edit`, `messages delete --for-everyone`, `reactions add` и другие
  записи сначала подключались к MAX и только потом получали отказ; при сломанном входе выходили с кодом `10`.
  Теперь — код `5`, соединения нет, как и обещает [страница о безопасности](/llms.mdx/docs/ru/max/security/content.md). Отказ остаётся в
  `sends list` короткой строкой: ключ команды и вид, чат — только если указан его id.
- **`--dry-run` под `MAX_READ_ONLY` больше не отвечает «можно»** на запись, которую настоящий запуск запретил бы.
- **`max mcp` под `MAX_READ_ONLY` не предлагает записи в MAX**, а вызов такой команды через `max_write` получает
  отказ запрета, а не «нет такой команды».

## 0.62.0 — 18.10.2026 [#0620--18102026]

### Что нового [#что-нового-36]

- **Агент получает через `max mcp` все команды, которые разрешают уровни профиля** (cli-core 0.341.0). Раньше сервер
  предлагал 141 написанный вручную инструмент; теперь инструменты строятся из самих команд, и агенту доступна 181
  команда — среди них `messages sync`, `contacts sync`, `chats members fetch`, `chats tracking add/remove`,
  `contacts link/unlink`, `mentions confirm/reject/rebuild`, `conversations embed`, `images embed`, `tasks reject`,
  `contacts import`, `account privacy set` и `chats app`. Что агенту нельзя, решают уровни профиля:
  поставьте `readonly` или `deny` нужной области. Полный список закреплён в `contracts/mcp-catalogue.json`.
- **`conversations rebuild`** — собрать заново беседы чатов, которые изменились, и посчитать для них векторы моделью
  на этом компьютере; MAX не спрашивает, модель не скачивает, текст никуда не отправляет. Заменяет инструмент
  агента `conversations_refresh`.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-34]

- **Аргументы инструментов `max mcp` называются как опции команд** в snake_case: `chat`, `limit`, `query`,
  `sync_first` и так далее. Агенту, который запоминал старые имена, нужно заново спросить `max_tools_search`.
- **`search messages` у агента больше не принимает структурный запрос `ast`** — только текст запроса, как в
  командной строке.
- **Агент не может отметить прочитанным и действовать от имени владельца**: `--mark-read` у `messages list`,
  `inbox` и `review`, `--as-owner` и `messages send --allow-any-file` агенту не предлагаются, а настройка `catch_up_marks_read` на его запуски не
  действует. Его отметки `--new` отдельные от ваших.

### Исправлено [#исправлено-34]

- **`max mcp` отвечает на все вызовы, полученные до закрытия stdin**, а не выходит, бросив тот, что ещё
  выполнялся. У `max bot mcp` так пока не сделано.
- **`max tasks --help` больше не обещает, что задачи открывает `serve`.** Справка говорила «review and serve add
  them». Теперь она говорит, что задачи открывают `review`, `inbox` и `messages sync`, а `serve` — только просьбы из
  правил автоответа.
  Почему: `serve` в MAX не проверяет вопросы и упоминания при получении. Кто держал `serve` запущенным и ждал задач,
  видел пустой список до следующего `review` или `messages sync`.
  Что учесть: поведение не изменилось. Пустой `tasks list` теперь говорит то же самое (cli-core 0.341.0).
- **`max mcp --help` подсказывает `claude mcp add max -- max <profile> mcp`** (cli-core 0.341.0). Прежняя подсказка
  без профиля всегда падала с «name a profile», и агент получал неработающий сервер.
- **На Node 22 команды, которые открывают хранилище, больше не печатают `ExperimentalWarning: SQLite is an
  experimental feature`** (cli-core 0.341.0). Агенты принимали эти две строки в stderr за ошибку. Другие
  предупреждения печатаются как раньше.
- **`tags remove` по псевдониму метки снимает её так же, как `tags add` её ставит** (cli-core 0.341.0).
- **Запуск немного быстрее** (cli-base 0.45.0): таблицы словаря и правил больше не разбираются при каждом запуске,
  только когда стартует сервер для агента.

### Безопасность [#безопасность-6]

- **`attachments extract --output-dir` отказывает в папках с ключами, папках самого `max` и папке хранилища**
  (cli-core 0.341.0), как уже отказывал инструмент агента.

## 0.61.0 — 18.10.2026 [#0610--18102026]

### Что нового [#что-нового-37]

- **`tasks agenda` показывает, что должны вам другие** (cli-core 0.328.0): открытые задачи, которые делает кто-то
  другой, — отдельный раздел и `assigned` в `--json`, старые сверху.
- **Агент может выключить и включить звук чата** (cli-core 0.338.0): `chats mute` и `chats unmute` теперь есть среди
  инструментов `max mcp`. Каждый проверяется по своему ключу (`chats.mute`, `chats.unmute`); в чате никто об этом
  не узнаёт.
- **Примеры в справке** у `account privacy show`, `account privacy set`, `chats mute`, `chats unmute`,
  `messages pin`, `messages unpin`, `metadata get` и `metadata refresh` (cli-core 0.336.0, 0.339.0).

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-35]

- **`bot messages send --reply-to` принимает только id сообщения MAX, `mid.…`**, и агент с `reply_to` тоже. Другое
  значение команда отклоняет до отправки (код 2). Раньше оно уходило в MAX как есть.
- **`bot messages show`, `edit`, `delete`, `pin` и `unpin` тоже принимают только `mid.…`**, и агент тоже. Другое
  значение команда отклоняет до первого запроса (код 2). Раньше `delete` с несколькими id удалял сообщения до первого
  неверного и только на нём падал (`not_found`).
- **Команда без терминала, которая ждёт человека, получает 5 минут, а не 30 секунд** (cli-core 0.328.0), например
  `session start` у агента. `--timeout` и `MAX_TIMEOUT` по-прежнему решают, если заданы.
- **Путь команды одним аргументом — ошибка** (cli-core 0.328.0): `max 'chats list' --help` раньше печатал общую
  справку с кодом 0, теперь отвечает `validation_error` и показывает, как написать правильно.
- **Агент больше не видит `offline` у `bot me`, `bot comments list`, `bot comments get` и `bot chats members list`.**
  Эти команды всегда спрашивают MAX и отклоняли `offline`; теперь аргумента нет в описании инструмента (cli-core 0.335.0).
- **`conversations build` и `conversations embed` помечены как меняющие что-то вне этого компьютера** (cli-core
  0.334.0, 0.336.0): с `--analyze` и `--provider` они отправляют текст переписки внешнему сервису, а `search
  conversations` с удалённой моделью отправляет туда запрос. Под `MAX_READ_ONLY` все три отказывают до отправки;
  модель на этом компьютере или на локальном сервере работает как раньше. Через `max serve` они не выполняются. В `docs/commands.md` такая пометка теперь
  звучит «вне этого компьютера: в MAX или во внешнем сервисе», а не «в MAX».
- **Под `MAX_READ_ONLY` `session start`, `session end` и `setup` отказывают ещё до начала работы** (код 5, «it cannot
  log in or out»), а не изнутри команды.
- **Под `MAX_READ_ONLY` отказывают локальные записи, которые удаляют или переписывают то, что вы сохранили**
  (cli-core 0.336.0, 0.337.0): `searches create`, `searches delete`, `searches clear`, `contacts alias set`,
  `contacts alias rm`, `contacts notes add`, `contacts notes edit`, `contacts notes remove`, `contacts link`,
  `contacts unlink`, `tags add`, `tags auto`, `tags remove`, `mentions confirm`, `mentions reject`,
  `attachments text set`, `chats tracking add`, `chats tracking remove`, `conversations links add`,
  `conversations links clear`, `conversations consents revoke`, `tasks reject` и их инструменты у агента — код 5,
  `permission_error`. Работает по-прежнему то, что хранилище восстановит само (`images embed`, `mentions rebuild`,
  `conversations embed clear`, `store jobs …`), синхронизация, `serve` и учёт задач (`tasks add`, `scan`, `close`
  и другие). `tasks close` под замком только предлагает закрыть задачу, а `--as-owner` отклоняется.
- **Пока MAX ограничил аккаунт, не уходит никакая запись** (cli-core 0.334.0): реакция, прочтение чата, тихое
  закрепление, смена названия и профиля тоже отклоняются (`permission_error`); чтение работает. Блокировка без
  срока держит записи, пока вы не выполните `flood clear` или `doctor --online` не увидит, что аккаунт в порядке;
  в `--json` у такой блокировки `until: null`.
- **Отправка, которая не дождалась блокировки файла другим процессом, выходит с кодом 9 (`timeout`), а не 1**
  (cli-core 0.338.0): ничего не отправлено, повторять безопасно. То же у `flood clear`.
- **`upgrade --offline` выходит с кодом 2** (cli-core 0.338.0): `upgrade` спрашивает npm, поэтому с `--offline`
  (и с `--check`) теперь отказывает, а не идёт в сеть вопреки флагу.
- **Инструмент агента `messages list` больше не предлагает `topic:`** (cli-core 0.340.0): в MAX нет тем, и такое
  условие отклоняется, как уже отклонялось в командной строке.

### Исправлено [#исправлено-35]

- **Хранилище, которое не открылось, закрывается** (cli-core 0.332.0): на Windows папку с таким файлом можно удалить.
- **`doctor report create` снова работает под `MAX_READ_ONLY`.** cli-core 0.337.0 запрещает под этим замком любую
  локальную запись, которую не отметили как безопасную; отчёт только добавляет новый файл, и теперь он отмечен.
- **Чужая блокировка файла больше не останавливает `max serve`** (cli-core 0.340.0): раньше serve ждал её до 5 секунд,
  и на это время вставали все команды через него и поддержка соединения с MAX.
- **Два изменения списка получателей одновременно больше не отменяют друг друга** (cli-core 0.338.0):
  `recipients add`, `remove` и `clear` читают и пишут список под одной блокировкой.
- **`store gaps repair --background` выполняет задание**, а не падает сразу (cli-core 0.339.0).
- **Подсказки `server status`, `server …` и обслуживания хранилища называют профиль**: `max <profile> session
  start`, а не `max session start` (cli-core 0.339.0).
- **`upgrade --check` работает под `MAX_READ_ONLY`** (cli-core 0.338.0): он только спрашивает npm о новой версии.
- **Загрузка моделей не идёт через `max serve`** (cli-core 0.336.0): `models … download` и `images models download`
  качают с сервера моделей, а не из MAX.
- **`images embed` при запущенном serve читает картинки через его соединение**, как другие чтения (cli-core
  0.337.0).
- **Ограничение или блокировка, которые остановили `watch` или `serve`, запоминаются** (cli-core 0.334.0):
  следующая команда ждёт, как после такой же ошибки у обычной команды.

### Безопасность [#безопасность-7]

- **`session end` больше не выходит из аккаунта, которым пользуется `max serve`.** Если serve запущен вручную или
  службой, `session end` раньше выходил из того же сеанса MAX, на котором работает serve, и удалял его токен. Теперь
  команда отказывает (код 2) и просит сначала `max <profile> server stop`. Serve, который запустила другая команда,
  она по-прежнему останавливает сама. `session start`, `session end` и `setup` никогда не выполняются через serve
  (cli-core 0.333.0, `logsInOrOut`).
- **`chats.unmute: readonly` теперь останавливает `chats unmute`** (cli-core 0.336.0). Раньше включение звука
  проверялось по ключу `chats.mute`, и свой ключ не действовал. Настройка, в которой есть только `chats.mute`,
  работает как раньше, пока не задан `chats.unmute`.

## 0.60.0 — 17.10.2026 [#0600--17102026]

### Что нового [#что-нового-38]

- **`stats messages top --measure reactions` показывает реакции по эмодзи** (cli-core 0.324.0): рядом с итогом —
  `👍 4 · 😂 3` (до пяти эмодзи, дальше `+N`), а в `--json` у каждой строки есть `reactions: [{reaction, count}]`.
- **`max <profile> contacts link <person> me`** (cli-core 0.323.0): отметить, что контакт — это вы, для вашего аккаунта,
  который хранилище не узнаёт само, например `zoom:<id>`.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-36]

- **Инструменты `max bot mcp` теперь строятся из самих команд `max bot`** (cli-core 0.325.0) и выполняются через
  них. Аргументы называются как у команды: `messages send` и `messages edit` принимают `md` / `html` вместо
  `format`, `messages delete` — список `messages`, `search messages` — `query`, `chats members remove` — `person`.
  Появились `chats rules show`, `offline` у команд, которые читают MAX, и аргументы `page`, `newest`, `notify`,
  `no_block`, `sync_first`. Запись на уровне `ask` агенту разрешена: отвечать на вопрос некому.
- **Агенту не предлагаются**: `session`, `setup`, `config`, `doctor report`, `bot uploads`, а также
  `--allow-dangerous` у `bot comments delete` и у `bot api`. Их по-прежнему запускает только владелец.

### Исправлено [#исправлено-36]

- **Упоминания находят меньше ложных имён** (cli-core 0.323.0). Слово из имени контакта считается само по себе только
  как имя или фамилия; контакт с именем как у компании («Smart Agents») находится только по всему имени, а вежливые
  «Ваш», «Вам», «Вас» не считаются никогда. Имя святого в названии места («Saint Michael's Bridge») и город после
  «в»/«во» («во Владимире») — тоже не имена.
- **Ваши аккаунты — это вы** (cli-core 0.323.0): собственная личность аккаунта связывается с вами при следующей
  синхронизации, и ваше имя в ваших сообщениях больше не принадлежит другому человеку.
- **Адрес сохраняет город** (cli-core 0.323.0): одна улица в двух городах — два места; адрес без города по-прежнему
  находит своё место на этой улице.
- **В группе с меткой `watch-tasks` вопрос закрывает ответ любого участника** (cli-core 0.325.0). Прямой ответ на
  вопрос (ответ с цитатой) от кого-то, кроме спросившего, закрывает задачу с пометкой «answered in the group».
  Раньше задачу закрывал только ваш ответ, и вопросы, на которые уже ответили другие, оставались открытыми.
  Сообщение, которое не отвечает на вопрос, ничего не закрывает. В личных чатах и в группах без метки по-прежнему
  считается только ваш ответ.

После обновления один раз перечитайте старые сообщения: `max <profile> mentions rebuild person-name place`.

### Безопасность [#безопасность-8]

- **`MAX_READ_ONLY` теперь запрещает вход и выход, запись от имени бота и изменения хранилища**: `session start`,
  `session end` и `setup` отказывают с `permission_error` ещё до подключения. Так же отказывают `bot api` (каждая
  операция, которая что-то меняет, и `get-updates`), `bot comments send|edit|delete`, `bot chats members add`,
  `bot uploads put`, а также `store reset`, `restore`, `clear`, `migrate`, `repair`, `copies delete` и `decrypt`.
  Раньше `session end` под этим запретом выходил из MAX и забывал сессию, а эти команды бота отправляли запрос в MAX.
  `store repair --dry-run` под запретом по-прежнему показывает, что было бы исправлено.
- **Запись в Bot API, для которой max не знает, как вести журнал, отказывает** с `configuration_error`, а не уходит
  в MAX мимо списка получателей и журнала отправок. Так операция, которую добавит будущее обновление схемы Bot API,
  не проскочит проверки. Без журнала проходит только `get-updates`: он никому ничего не отправляет.

## 0.59.0 — 17.10.2026 [#0590--17102026]

### Что нового [#что-нового-39]

- **У задачи есть исполнитель** (cli-core 0.320.0): `tasks add --assignee`, `tasks plan --assignee` и фильтр
  `assignee:` в `tasks list` — задача может быть и тем, что кто-то должен вам. Группа с меткой `watch-tasks`
  получает задачу на каждый вопрос без ответа, кому бы он ни был задан.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-37]

- **Профиль по умолчанию больше не выбирается** (cli-core 0.319.0). Настройка `default_profile` не читается:
  если она осталась в файле настроек, команда без имени профиля останавливается и подсказывает, что набрать.
  Называйте профиль первым словом — `max <профиль> …` — или задайте `MAX_PROFILE`, а старую настройку уберите:
  `max config unset default_profile`. `max config set default_profile` теперь отказывает.
- **Профиль с именем `default` — обычное имя.** `max default mcp config` называет MCP-сервер `max-default`, а не
  `max`; запись, сделанная раньше, работает, пока `mcp setup` не перепишет её под новым именем.
- **`tasks apply` теперь `tasks scan`** (cli-core 0.320.0). Инструмент MCP — `tasks_scan`, ключ разрешения —
  `tasks.scan`. Работает так же: показывает, какие задачи откроет история чата, и создаёт их только с `--yes`.
- **Агент больше не может удалить сообщение у всех** (cli-core 0.321.0). MCP-инструмент `messages delete` не
  принимает `for_everyone`: такой аргумент отклоняется как неизвестный. Владелец по-прежнему удаляет у всех через
  `max <профиль> messages delete --for-everyone`.
- **`mcp --permission` только ужесточает права** (cli-core 0.321.0). Переопределение, которое ослабило бы уровень
  профиля, например `messages.send=allow` для профиля с `readonly`, сервер отклоняет при запуске и называет ключ.
  Чтобы разрешить больше, измените права профиля; `--permission messages.send=deny` и другие сужения работают
  как раньше.

### Исправлено [#исправлено-37]

- **Запрет агенту на `chats members list` теперь действует** (cli-core 0.321.0). Через MCP команда брала уровень
  из ключа `chats.members`, и запрет на `chats.members.list` до неё не доходил.
- **`tasks show HRB-12` показывает задачу проекта** (cli-core 0.320.0). Раньше задача проекта, а не аккаунта,
  считалась ненайденной.
- **Задачи открываются только там, где что-то спросили у вас** (cli-core 0.317.0). В личном чате, как и раньше,
  — каждый вопрос без ответа; в группе — только ответ на ваше сообщение и упоминание вас; в канале и «Избранном»
  — ничего. Раньше любой вопрос без ответа в любом чате становился вашей задачей.
- **Правка сообщения не стирает то, чего в ней нет** (cli-core 0.317.0): время отправки, реакции и служебные поля
  сохранённого сообщения остаются прежними.
- **Инструменты `max bot mcp` учитывают окружение сервера.** Раньше вызов шёл мимо переменных, с которыми
  запущен сервер: например, при `MAX_READ_ONLY=1` бот всё равно отправлял сообщение. Теперь вызов через MCP
  ведёт себя так же, как та же команда в терминале.

## 0.58.0 — 17.10.2026 [#0580--17102026]

### Безопасность [#безопасность-9]

- **Внутренние данные вложений не попадают в вывод**, в том числе в поток событий бота (cli-core 0.315.0). Медиа-ключи и токен остаются внутри клиента.

- **Файлы состояния WhatsApp нельзя отправить как вложение** (cli-core 0.314.0). Проверка учитывает стандартные каталоги, переменные окружения и символьные ссылки; обычные файлы рядом по-прежнему разрешены.

### Что нового [#что-нового-40]

- **Имена и адреса можно проверить как упоминания** (cli-core 0.311.0). `mentions rebuild person-name` и `mentions rebuild place` находят их в сохранённом тексте; `mentions places` показывает подтверждённые адреса.
- **`tasks apply <chat...>` показывает задачи из выбранной сохранённой истории.** `--yes` создаёт их с проверкой дубликатов.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-38]

- **Первый sync по умолчанию не открывает задач из старых сообщений** (cli-core 0.311.0). Настройка `task_first_pass_per_chat` включает их создание; `tasks apply` позволяет отдельно проверить выбранные чаты. Следующие sync по-прежнему обрабатывают новые сообщения.

### Исправлено [#исправлено-38]

- **`max doctor report create` пишет отчёт и при неверном файле настроек.** Раньше он завершался с ошибкой
  `configuration_error`, и сообщить о проблеме было нечем. Теперь в отчёте вместо проверки профиля — ошибка
  настроек (названа неверная настройка, значение не показывается), а также последний неудачный запуск.

## 0.57.0 — 17.10.2026 [#0570--17102026]

### Что нового [#что-нового-41]

- **Документы Drive находятся в общем локальном поиске** (cli-core 0.301.0), с Google-ссылкой и временем изменения. `--source drive:<профиль>` выбирает импортированный профиль. `chats documents list <чат>` показывает документы, которыми делились в сохранённых сообщениях, без запроса к MAX.

- **MCP-сервер загружается только тогда, когда max работает как MCP** (cli-core 0.300.0): остальным командам при
  запуске нужно загрузить примерно на десятую часть меньше файлов.
- **Карточка задачи показывает задачи, которые на неё ссылаются** (cli-core 0.304.0): `tasks show` печатает
  `task:<id> follow-up-of this task`, а `--json` и MCP возвращают `linked_from`. Раньше связь видела только новая
  задача, а закрытая — нет.
- **max запускается примерно на четверть быстрее, начиная со второго запуска.** Скомпилированный код Node
  сохраняется в кэше во временной папке системы (её меняет `NODE_COMPILE_CACHE`): `max --help` — около 0,42 секунды
  вместо 0,56.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-39]

- **Ошибка в файле настроек — одна строка, и значение в ней не показывается** (cli-core 0.304.0): первое неверное
  поле, причина и число остальных — `config.json: profiles.default.limitt is an unknown setting (and 2 more
  problems)`. Для поля из старой версии (`clientId`) ошибка подсказывает новое имя (`rename it to client_id`,
  cli-core 0.307.0). Раньше сообщение перечисляло все ошибки и все допустимые поля и цитировало значение, а туда мог по
  ошибке попасть токен.
- **`search notes` выбирает заметки полем `source:internal` или `source:file` в запросе** (cli-core 0.303.0):
  флага `--type` больше нет, у MCP-инструмента `search_notes` нет поля `type`. Имя поля совпадает с полем `source`
  заметки. `--source notes:<папка>` по-прежнему выбирает, какие аккаунты читать.
- **Ежедневная подсказка о новой версии молчит и при `--timeout=5`, `--help=…` и других словах через `=`** — так
  же, как при `--timeout 5`. Проверка теперь общая, из cli-core.
- **Команды, которых в MAX нет, больше не показываются** (cli-core 0.299.0). У `messages send`, `chats mark-read`
  и `polls create` нет `--topic` (в MAX нет тем форума), `messages list` не принимает `topic:`, а у `chats requests
  accept` и `decline` нет `--all` и `--link`: человек указывается всегда. Раньше эти флаги были видны и только
  отказывали.
- **`max doctor` отвечает и при неверном файле настроек.** Раньше он завершался с ошибкой
  `configuration_error` и кодом 3; теперь отвечает `config: {error: …}`, где названа неверная настройка, и
  выходит с кодом 0.
  Почему: `doctor` запускают как раз тогда, когда настройка сломана.
  Что учесть: скрипт, который по коду выхода `doctor` узнавал о неверном файле настроек, теперь должен
  смотреть на `config.error` в ответе.

## 0.56.0 — 16.10.2026 [#0560--16102026]

### Что нового [#что-нового-42]

- **`tasks reject` отклоняет предложение агента закрыть задачу, а `tasks list close:suggested` находит такие
  задачи** (cli-core 0.295.0). `tasks agenda` показывает их с причиной `close-suggested`; владелец подтверждает
  предложение тем же `tasks close <задача>`, `--as` можно не указывать. Насколько агенту можно закрывать задачи,
  задают настройки общего хранилища `task_agent_close` (`on` по умолчанию) и `task_agent_close_min` (0.8);
  `config show` их показывает.
- **Новая задача о задаче, закрытой за последние 14 дней, — продолжение закрытой** (cli-core 0.295.0): `review` и
  `tasks add` связывают её с закрытой связью `follow-up-of`. Закрытая остаётся закрытой и не попадает в
  `tasks duplicates`; `tasks show` показывает связь.
- **59 категорий задач по умолчанию вместо 7, в списке до 80** (cli-core 0.295.0 и 0.296.0): `bills`, `health`,
  `travel`, `fitness`, `subscriptions` и другие. `tasks categories` печатает смысл каждой и слова на английском,
  русском и испанском, по которым её выбирает правило. Хранилище, где список сохранили через
  `config set task_categories.*`, оставляет свой; `config unset task_categories` берёт новый.
- **Категорию, которую убрали из списка, видно** (cli-core 0.296.0): `tasks categories` называет её и сколько у неё
  открытых и всех задач (`unlisted` в JSON), а `tasks agenda` — категории, которые несут открытые задачи
  (`unlisted_categories`).
- **Испанский в задачах** (cli-core 0.296.0): слово-триггер с `es:` находит и другие формы слова (`pagues` —
  `pagar`), когда сообщение написано по-испански, а проверка дублей понимает сроки вроде `mañana`, `el viernes`,
  `15 de noviembre`.
- **Повторная проверка дублей после привязки сообщения** (cli-core 0.295.0): после `tasks link <задача> msg:…`,
  `tasks add --into` и `tasks merge` похожие задачи попадают в `tasks duplicates`, а поле `review` в ответе их считает.
  Связь остаётся, ничего не объединяется само.
- **`commands --json` говорит, сколько работает команда** (cli-base 0.38.0): у `serve` и `watch` поле `lifetime` —
  `persistent`, у `setup` и `session start` — `interactive`. Раньше программа узнавала их по имени.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-40]

- **Агент закрывает задачу только с `--certainty <0..1>`, а неуверенный — уже не закрывает** (cli-core 0.295.0).
  Агента узнаём по `AI_AGENT` или `CLAUDECODE`; `--as-owner` закрывает как владелец.
  Почему: агент может ошибиться, а закрытая задача пропадает из плана владельца.
  Что учесть: `tasks close` агента без `--certainty` отклоняется (`task.certainty-required`); в MCP у
  `tasks_close` новый обязательный аргумент `certainty`. Ниже порога (`task_agent_close_min`, по умолчанию 0.8) или
  при `task_agent_close off` ответ приходит с `state: open` и `close_suggestion`, и задача остаётся открытой.
- **`tasks add` больше не отказывает, если похожи только закрытые задачи** (cli-core 0.295.0): он открывает новую со
  связью `follow-up-of` (`follow_up_of` в ответе). Отказ с кодом 2 остаётся, когда похожа открытая задача.
  Что учесть: скрипт, который ждал кода 2 для закрытой задачи, теперь получает новую задачу.
- **Правило выбирает категорию уже: счёт за свет — `bills`, а не `money`, врач — `health`, а не `personal`**
  (cli-core 0.295.0 и 0.296.0). Старые семь категорий сохранили имена и смысл, задачи в базе не меняются.
  Что учесть: фильтр вроде `tasks agenda category:personal` ловит меньше новых задач. Часть слов перешла в более
  узкие категории: `gym` — в `fitness`, `restaurant` — в `food`, `переезд` — в `moving`.
- **Проверка дублей читает сообщения, на которых стоит задача** (cli-core 0.295.0): исходное и пять последних
  привязанных. Задача правила без своего текста теперь сравнивается по словам сообщения, поэтому `tasks add` может
  отказать (код 2) там, где раньше открывал задачу.
- **`max mcp` и `max <бот> bot mcp` — теперь общий MCP-сервер, тот же, что у `tg`.** Инструменты те же: `max_read`,
  `max_tools_search` и `max_write`. Команды `chats check` в `max_write` больше нет — вместо неё `chats moderate`;
  второго имени `chats rules` тоже нет — только `chats rules show`. `max bot mcp` больше не принимает флаги
  `--allow-send`, `--allow-delete`, `--allow-moderate`, `--confirm-send` и `--allow-dangerous`.
  Почему: у max и tg один сервер для агентов — одно поведение и один код, который проверяют.
  Что учесть: старые флаги `bot mcp` и раньше ничего не включали, но теперь сервер с ними не запускается (код 2,
  «unknown option») — уберите их из настроек приложения; `max <бот> bot mcp config` печатает новую запись. Агенту,
  который звал `chats check` или `chats rules`, нужно новое имя. `max mcp config` больше не переносит в запись
  `--yes`: по MCP запись уровня `ask` и так идёт без вопроса. Голосовое по MCP теперь сначала скачивается, потом
  распознаётся моделью на этом компьютере, как в `tg`. `chats moderate` берёт место последней проверки только из
  файла правил: место, которое очень старые версии хранили в сессии, больше не переносится.
- **`setup --json` предлагает следующие команды в общем списке `next` конверта, а не в `item.next`.** Вместо объекта
  `item.next` с полями `instructions`, `chats`, `history` и `skill` — два шага верхнего уровня: `skill show` и
  `chats list --limit 5`, оба только читают.
  Почему: у всех команд следующие шаги лежат в одном месте, и агент читает их одинаково.
  Что учесть: скрипт, который читал `item.next`, должен читать `next`. Загрузка истории и установка навыка остаются
  только в выводе для человека.
- **`chats media` отвечает сообщениями той же формы, что история чата.** Голосовое там теперь `voice`, а не `audio`,
  как в `messages list`. Id файла и видео MAX лежат в `provider_ref` вложения (`provider_ref.file_id`,
  `provider_ref.video_id`), а не на верхнем уровне вложения.
  Почему: раньше `chats media` отдавал вложения в собственной форме MAX, не так, как все остальные чтения.
  Что учесть: скрипт, который искал в ответе `audio` или читал `file_id` и `video_id`, должен искать `voice` и
  читать их из `provider_ref`. Фильтр `--type audio` по-прежнему выбирает голосовые.
- **`max watch` рисует сообщения тем же кодом, что `messages list`.** Опрос показан вопросом, ответами и числом
  голосов. JSON и `--jsonl` не меняются.
  Что учесть: строки для человека могут выглядеть немного иначе, чем в 0.55.0. Скрипту нужен `--jsonl`.

### Исправлено [#исправлено-39]

- **Отчёт `doctor report create` заменяет метками также id сообщения, на которое отвечали, и id попыток записи.**
  Метки позволяют сопоставить записи внутри одного отчёта и меняются при создании следующего.

### Безопасность [#безопасность-10]

- **Каждая запись проверяется в одном месте — общей защитой, из командной строки, через `max serve` и по MCP.**
  Отправка, правка, удаление, реакции, отметка «прочитано», пересылка, модерация, изменения чатов, контактов и
  аккаунта проходят одни и те же проверки: уровень прав, `MAX_READ_ONLY`, список получателей и журнал отправок, а
  записи, которые видят другие люди (сообщения, пересылки, правки, удаления, новые группы и добавление людей), —
  ещё и лимит в час. `deny` и `readonly` запрещают запись. `ask` в терминале спрашивает или ждёт `--yes`
  (удаление — `--allow-dangerous`), а с `--json` без флага команда отказывает. По MCP отвечать некому, и запись
  уровня `ask` выполняется, как и раньше: решают права профиля, в том числе заданные серверу через `--permission`.
  Почему: раньше для MCP проверки шли отдельным путём внутри max; теперь путь один, и он общий с `tg`.
  Что учесть: для команд в терминале ничего не меняется. Если агент не должен удалять или отправлять без вас,
  задайте этому действию `deny` или `readonly`, а не `ask`: такие инструменты агенту даже не предлагаются.
  `MAX_READ_ONLY=1` запрещает любую запись, в том числе по MCP.

## 0.55.0 — 15.10.2026 [#0550--15102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-41]

- **Флаги общих команд называются по общему словарю, старые имена больше не принимаются** (cli-core 0.288.0):
  `--budget` → `--max-pages`; `messages sync --estimate` → `--dry-run` (в max он по-прежнему отклоняется: id
  сообщений MAX не говорят, сколько их пропущено); `contacts context --refresh`, `bot contacts show --refresh` и
  `tags auto --refresh-metadata` → `--sync-first`; `search conversations --refresh` → `--catch-up`;
  `attachments show --if-sha256` → `--expected-fingerprint`; в `replies edit` `--chats`, `--not-chats`, `--people`,
  `--not-people` → `--allow-chats`, `--deny-chats`, `--allow-people`, `--deny-people` (файл правил не меняется);
  `schedule --once` → `--at-time`; `bot chats moderate --no-ban` → `--no-block`; `chats mark-read --until` →
  `--until-id`; `tasks add|plan --check` → `--remind-time`; `tasks add --attach` → `--into`; `tasks claim --for` →
  `--lease`; `tasks agenda --due` → `--due-within`; `server logs --lines` → `--limit` (`-n` остаётся); в `chats start`
  `--payload` → `--start`, как в `chats app`; `store export --to/--kind` → `--output-dir/--include`.
  Почему: у max, tg и других CLI WireCat одно слово значит одно и то же, и агенту не нужно помнить имя флага для
  каждой программы.
  Что учесть: старое имя завершает команду с кодом 2 («unknown option») до подключения к MAX — проверьте скрипты и
  расписания (`schedule list`). В MCP аргумент — новое имя флага в snake_case, например `max_pages`, `until_id`,
  `expected_fingerprint`, `output_dir`, `allow_chats`, `at_time`. В `search conversations` не меняйте `--refresh` на
  `--sync-first`: этот флаг уже был и сначала читает новые сообщения из MAX, а прежнюю сборку поиска делает
  `--catch-up`.
- **`tasks similar` теперь `tasks related`, а `tasks duplicates unsure` — `tasks duplicates defer`**, без старых имён.
  Почему: тот же общий словарь.
  Что учесть: в MCP ищите команды `tasks related` и `tasks duplicates defer` через `max_tools_search`. Ключ прав —
  `tasks.duplicates.defer`. Старый ключ `tasks.duplicates.unsure` в файле настроек теперь только предупреждает в
  stderr и не действует, так что команда получает уровень `tasks`: уберите его через `config unset` и задайте
  тот же уровень ключу `tasks.duplicates.defer`. В базе решение по-прежнему называется `unsure`.
- **`tasks agenda` и `tasks duplicates` фильтруют полями запроса, а не флагами**: `tasks agenda --tag <имя>` →
  `tag:<имя>`, `--category <имя>` → `category:<имя>`, `--claimed` → `claimed:any` (ещё `none`, `mine`, `others`; по
  умолчанию, как раньше, — ничьи и свои); `tasks duplicates --unsure` → `decision:unsure` (по умолчанию
  `decision:review`).
  Почему: список фильтрует база, как у остальных списков, а не программа после чтения.
  Что учесть: OR или NOT, который смешивает поля задачи с `chat_kind:`, отклоняется (`query.unsupported-placement`).
  В MCP эти команды принимают `query` вместо `tag`, `category`, `claimed` и `unsure`.
- **Каждый ответ `--json` — конверт: `item` для одной вещи или `items` + `page` для списка, и `meta`.** Теперь так
  отвечают и те, что отдавали голый объект: предпросмотр `--dry-run --json` (под `item`, ключи в snake_case:
  `business_rules`, `action_invoked`, `write_reserved`, `messenger_contacted`, `configuration_read`),
  `mentions confirm|reject` и `images embed --json`, `max_tools_search` в MCP (`{items, more}` →
  `{items, page, meta}`) и ресурс MCP `max://chat/<id>` (чат и сообщения под `item`), а также `bot me`, `bot api …` (ответ Bot API — внутри `item` без изменений, пустой ответ —
  `null`), `contacts sync`, `contacts lookup` (`displayName` → `display_name`, `lastMessagedAt` → `last_messaged_at`),
  `doctor report`, `doctor report create` (`sendTo` → `send_to`) и `setup` (`chats.hasMore` → `chats.has_more`).
  Почему: агент разбирает любой ответ одним способом.
  Что учесть: читайте поля из `.item`; вместо `more` — `page.has_more`.
- **Повреждённая локальная копия переписки — ошибка, а не пустая копия** (cli-core 0.286.0). Раньше команда с
  подключением к MAX молча обходилась без неё. Копию пропускают, только если её нет, если аккаунт ещё не записан
  или если другой процесс (`serve`) держит её дольше 5 секунд.
  Почему: ответ без копии выглядел полным, хотя в нём не хватало сохранённого.
  Что учесть: такая ошибка — повод для `max <профиль> store repair --dry-run`.

### Исправлено [#исправлено-40]

- **Подсказка следующего шага содержит профиль** (cli-core 0.286.0): после `max personal …` строка `→ …` тоже
  начинается с `max personal`, и вставленная как есть она работает, а не просит выбрать профиль.

### Удалено [#удалено]

- **Открытие базы больше не удаляет старый файл `messages.db`** и не пишет об этом в stderr (cli-core 0.286.0).
  Если файл остался от давних версий, удалите его сами.

## 0.54.0 — 15.10.2026 [#0540--15102026]

### Что нового [#что-нового-43]

- **Задачи можно занять, пометить тегом и разложить по категориям**: `tasks claim <задача> [--for 30m]`,
  `tasks release`, `tasks categories`, `tags add|remove --task`, `tasks agenda --claimed` (cli-core 0.282.0).
- **Задачи, которые могут быть одной работой** (cli-core 0.285.0): `tasks similar <задача>` оценивает похожие
  задачи; `tasks duplicates [--unsure]` показывает пары, найденные правилами, `tasks merge <задача> --into <другая>`
  объединяет их, `tasks unmerge` отменяет объединение, `tasks duplicates reject|unsure` решает пару. `tasks agenda`
  принимает `--category` и `--tag`, а `config set task_categories.<имя>` меняет список категорий для всей базы.
- **Упоминания** (cli-core 0.285.0): `mentions domains` показывает сайты, на которые ведут ссылки;
  `mentions list --new` — найденное с прошлого просмотра; `mentions confirm|reject <id> --all-in-chat` решает имя во
  всём чате. `config set phone_countries es,ru` читает номера, записанные без `+`.
- **Версия базы 16**: правила упоминаний читают и текст заметок и сохранённых документов, а один `mentions rebuild`
  читает сохранённые раньше; `mentions list` по-прежнему показывает только упоминания в сообщениях. Обновление
  добавляет только триггеры, так что прежняя версия max базу по-прежнему открывает.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-42]

- **Настройки называются только в snake_case** (cli-core 0.283.0): `config set` и `config unset` больше не понимают
  camelCase, а ключ в camelCase в файле настроек считается неизвестным. Общие настройки хранилища теперь
  `search_stemmers.cyrillic`, `search_stemmers.latin` и `account_groups.<имя>`.
- **`tasks add` требует `--category <имя>`** из списка `tasks categories` (`money`, `documents`, `meeting` и другие);
  если ничего не подходит — `--category other`.
- **`MAX_READ_ONLY` теперь запрещает запись и в max**: раньше эта переменная до проверки записи не доходила.
- **`tasks add` отказывает, если задача может быть той же работой**, что открытая или закрытая за последние 14 дней
  (cli-core 0.285.0): выход 2, причина `task.duplicate-candidates`, кандидаты в `details.candidates`. Повторите с
  `--attach <задача>`, чтобы привязать сообщение к ней, или с `--new`, чтобы открыть новую; через MCP `tasks add`
  ведёт себя так же.
- **`phone:` и `value:` находят и сохранённый номер, который кончается национальными цифрами набранного** (от 8;
  cli-core 0.285.0), так что номер, сохранённый до `phone_countries`, находится в любом виде. Российский городской
  номер, записанный группами, `(812) 000-00-01`, теперь хранится как `+78120000001`, а не голыми цифрами.
- **`max search mail` больше нет: почту ищет memo** (решение владельца 14.10.2026, cli-core 0.285.0,
  cli-core#1121). У MCP нет `search_mail`. `max search all` ищет сообщения и заметки (и встречи, если их назвал
  `--source`), но никогда почту; `--only mail` отклоняется. Вместо «unknown command» `max search mail …` отвечает
  подсказкой ``mail is memo's: install @wirecat/cli-memo, then `memo search mail …` ``. Задачи, заметки о контактах,
  метки, `search notes` и `search all` остаются в `max`.

### Исправлено [#исправлено-41]

- Заголовок с заглавными кириллическими буквами находится запросом в нижнем регистре (cli-core 0.285.0).
- **Вредный HTML во вложении больше не подвешивает чтение** (cli-core 0.285.0): страница из незакрытых тегов или
  комментариев читается за время, линейное по её размеру.

### Безопасность [#безопасность-11]

- **`messages send --file`, отправка из MCP и фото профиля или группы не берут файлы из мест с учётными данными**
  (cli-core 0.283.0) — тот же список, что у `bot uploads put` с 0.53.0: ключи SSH и облаков, `.netrc`,
  `.git-credentials`, настройки gh, docker и kube, учётные данные Claude и Codex, связки ключей, профили браузеров,
  хранилища паролей и папки приложений WireCat; на macOS и Windows без учёта регистра. Раньше они отказывали
  только для `.ssh`, `.gnupg`, `.aws`, `.env` и похожих и папок max. Нужен именно такой файл — `--allow-any-file`.
- **Список мест, из которых файл не отправляется, теперь один на все приложения WireCat**: max берёт его из
  cli-core, а не держит свою копию. Если файла ещё нет, ссылки в папках над ним тоже раскрываются.
- **Под `MAX_READ_ONLY` нельзя изменить то, что разрешит запись позже** (cli-core 0.281.0): `schedule
  command|agent|remove`, `config set|unset`, `recipients add|remove|clear`, `flood clear`, `server
  install|uninstall`, `mcp setup`, `skill install`, `upgrade`, ключи моделей и `bot auth` отвечают
  `permission_error`. Агент по расписанию идёт с этой переменной и раньше мог назначить себе отправку на потом;
  теперь не может, а расписание, сохранённое под ней, тоже запускается только на чтение. Чтение, синхронизация,
  задачи и заметки работают как прежде.

### Удалено [#удалено-1]

- **Код совместимости.** `max mcp` и `mcp config|setup|doctor` больше не принимают `--allow-send`, `--confirm-send`,
  `--allow-mark-read`, `--allow-delete`, `--allow-moderate`, `--allow-dangerous` и `--http-confirmation`; доступ
  задают `permissions`. `messages download --output` убран, остаётся `--output-dir`. Команды `config migrate` больше
  нет. Настройки `read_only`, `allow` и `mcp_tools` удалены: файл с ними не читается, вместо них задайте
  `permissions.<ресурс> readonly`. `doctor` не ищет старый файл кэша (`legacy_cache`), а `inbox` больше не переносит
  старую отметку `lastCheckAt`.
- **Перенос папок при запуске** (из `~/Library` и в папку WireCat): он уже сделан.
- **Старый язык поиска**: у `search messages` и `searches create` больше нет `--language` и `--regex`. Сохранённый
  поиск на старом языке сохраните заново.
- **`conversations embed --workers`.**

## 0.53.0 — 15.10.2026 [#0530--15102026]

### Что нового [#что-нового-44]

- **`config set` и `config unset` понимают имя настройки в camelCase** (cli-core 0.279.0): `max <профиль> config set
  senderColors false` пишет `sender_colors`, `max <профиль> config set readOtherBots true --bot` пишет
  `read_other_bots`. Путь команды после `permissions.` пишется как есть.

### Исправлено [#исправлено-42]

- **`max bot uploads put` и отправка файлов из кода не берут файлы из папок с ключами, связкой ключей и профилями
  браузера**, как и остальные отправки; на macOS и Windows имена сравниваются без учёта регистра.
- **Отправку, которую MAX отклонил по лимиту, можно повторить**: если `messages send`, `messages forward` или
  `polls create` получили отказ по лимиту, в ошибке `retry.safe` теперь `true` — сообщение не ушло. Если лимит
  пришёл на повтор после потерянного ответа, это по-прежнему `outcome_unknown` и `retry.safe: false`.

## 0.52.0 — 14.10.2026 [#0520--14102026]

### Что нового [#что-нового-45]

- **Синхронизация продолжается с места остановки**: `store jobs show` показывает `progress`, а `messages sync --all`
  не спотыкается о чат, который уже занят (cli-core 0.276.0).
- **`max watch` не падает со стеком, если обработчик события бросил ошибку**: подписка завершается этой ошибкой,
  связь с сервером остаётся.
- **Файлы и видео уходят с диска по ходу загрузки** (cli-core 0.272.0). `max messages send --file`,
  `--photo`, фото профиля и группы и `max bot` больше не читают файл в память целиком перед отправкой, и отказ
  для файлов от 2 GiB снят. Голосовое по-прежнему читается целиком — по нему считается длина и волна — до 256 MiB.
- **Поиск по картинкам: `max <профиль> images embed` и `max <профиль> images models download|list`.** Включается
  `max <профиль> config set picture_search true` (по умолчанию выключен), модель `clip-b32` скачивается один раз
  (около 155 МБ), `images embed` считает вектор для каждой картинки в архиве. Поиск сообщений по словам тогда
  возвращает `pictures` рядом с находками. Почему: найти картинку по тому, что на ней изображено.
  Что учесть: запрос для картинок только английский, агент переводит его сам. Подробнее — в
  [поиске](/llms.mdx/docs/ru/max/search/content.md#%D0%BA%D0%B0%D1%80%D1%82%D0%B8%D0%BD%D0%BA%D0%B8-%D0%BF%D0%BE%D0%B8%D1%81%D0%BA-%D0%BF%D0%BE-%D1%82%D0%BE%D0%BC%D1%83-%D1%87%D1%82%D0%BE-%D0%BD%D0%B0-%D0%BD%D0%B8%D1%85-%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%BE).

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-43]

- **`max store export --format jsonl` пишет в файлы и папки те же записи, что на экран**: snake_case, `chat_id`;
  строка удаления `{ "id", "chat_id", "deleted": true }` (cli-core 0.276.0). Что учесть: папку, выгруженную раньше,
  новая сборка не дописывает; выгружайте в новую папку.
- **`max watch --jsonl` пишет сообщения в той же форме, что `messages list`**: snake_case, с `ref` (`chat_id`,
  `chat_title`, `sender_name`). Строки `--events` тоже snake_case: `chat_id`, `message_id`, `user_id`, `up_to_time`,
  `unread_count`. Человек видит то же, что раньше. Что учесть: скрипты, читавшие `chatId`, берут `chat_id`.
- **Голосовое без текста попадает в `missing`** у `review`, `inbox`, `messages list` и в MCP, чтобы агент видел, что его
  ещё нужно расшифровать (cli-core 0.275.0).
- **Следующий шаг к команде, которая меняет только этот компьютер, не запускается сам** (cli-core 0.273.0):
  у шагов `server restart` и `store reindex` стоит `safe_to_auto_execute: false`.
- **`mentions rebuild` принимает вид аргументом**: `max <профиль> mentions rebuild person-name`, а не `--kind`
  (cli-core 0.272.0).
- **`max doctor --json`, `session start` и `session end` отвечают конвертом в snake_case**: `{item, meta}`, ключи
  `legacy_cache`, `keyring.moved_by_environment`, `session.state_file`, `revoked_on_server`. Человек по-прежнему
  видит строки. Что учесть: скрипты, читавшие эти ответы, берут поля из `item` в snake_case.
- **`max bot chats members list --cursor` вместо `--marker`**, синонима нет; MCP инструмент бота тоже берёт `cursor`.
  Ответ называет следующий шаг в `page.next`. Свои команды max (`recipients`, `config`, `mcp`, `messages transcribe`,
  `bot comments`, `bot uploads`) отвечают так же, как общие: строка конца `--jsonl` и подсказки на stderr.

## 0.51.0 — 14.10.2026 [#0510--14102026]

### Что нового [#что-нового-46]

- **У каждого `max watch` своя очередь.** Медленный наблюдатель больше не задерживает остальных; буфер — 64 MiB на
  наблюдателя и 256 MiB на всех, `max serve --max-subscriber-buffer-bytes` и `--max-subscriber-total-buffer-bytes`
  меняют их, `0` снимает предел.
- **`max mentions`: телефоны, почта, ссылки и документы Google из сохранённых сообщений** (cli-core 0.264.0,
  версия базы 7). `mentions list kind:phone`, `mentions list domain:google.com`; слово без поля — значение в любой
  записи, `89001234567` найдёт `+79001234567`. `mentions show <id>` показывает текст вокруг. Сообщения, сохранённые
  раньше, читает один `max <профиль> mentions rebuild`; новые читаются при записи.
- **`max mentions confirm|reject`, упоминания в файлах и голосовых, поиск по `phone:`, `email:`, `url:`, `domain:`**
  (cli-core 0.269.0, версия базы 11). `mentions confirm <id> [person:<uid>|organization:<id>]` записывает, чей это
  телефон или адрес (организации тоже), `mentions reject <id>` отклоняет значение насовсем; автор записи — агент
  или владелец (`--as-owner`). Текст из файлов и расшифровки голосовых тоже даёт упоминания (поле `file_text` или
  `transcript`); сохранённые раньше читает один `mentions rebuild`. Поиск сообщений находит их по `phone:"8 900
  000-00-01"`, `domain:docs.google.com`, `email:"ana@example.com"`. Старые сборки базу читают как раньше.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-44]

- **Сборка на `@wirecat/cli-core` 0.269.0: `contacts timeline` листается как остальные списки.** Список, обрезанный
  `--limit`, отвечает `page.has_more: true`, `page.cursor` и шагом `page.next` (`--cursor` продолжает с теми же
  `--scope`, `--since-time` и `--until-time`); раньше было `has_more: false` и `meta.truncated`. `meta.truncated`
  остаётся для изменений, ещё стоящих в очереди. Заметка «cut at --limit» на stderr исчезла. Что учесть: скрипты,
  читавшие `meta.truncated` у `contacts timeline`, читают `page.has_more`.
- **Ключи ошибок — snake_case и у `max bot`, и у отправки без ответа.** Код отказа MAX у бота теперь
  `error.details.max_code` (был `maxCode`); `outcome_unknown` при отправке сообщения отдаёт `send_id` (был `sendId`).
- **На `@wirecat/cli-core` 0.270.0 и `@wirecat/cli-base` 0.27.2.**
- **`--json=<поля>` заменяет `--fields` и `--agent-json`, их больше нет.** `--json=id,text` оставляет эти поля каждого
  элемента. JSON в CLI сохраняет текст как есть; ответы MCP по-прежнему показывают невидимые символы.
- **`tags list`, `tasks list` и `conversations list` принимают запрос вместо флагов-фильтров.**
  `tags list tag:work type:chat`, `tags list sources:auto`; `tasks list state:open kind:promise chat:<id>`;
  `conversations list <чат> started_at>=7d`. Флагов `--tag`, `--type`, `--source`, `--state`, `--chat`, `--before-time`
  и `--since-time` у этих списков больше нет. Элементы — общие сущности: метка называет, на чём она, как `target`,
  разговор отдаёт `messages_count`, `started_at`, `first_message`.

### Исправлено [#исправлено-43]

- **`max serve` не теряет вход, если его закрыли в момент ответа MAX.** Состояние профиля и обновлённый токен
  сохраняются до проверки на закрытие: MAX этот вход уже засчитал, и следующий запуск не входит заново.
- **Переполненный общий буфер `max watch` отключает того, кто держит больше всех**, а не того, кому пишут следующим.
  Отказ приходит в `watch` с кодом `invalid_response` и причиной `output.too-large`, а не `provider_error`.
- **Запись о неудачном запуске снова хранит код отказа MAX** (`providerError`, например `proto.payload`). С cli-core
  0.263.0 он читается из `error.details.provider_error`, а max писал `providerError`, и код терялся; так же опрос
  «уже проголосовали» и повторная попытка после `not.found` смотрят на новый ключ.
- **`MaxClient` называет файл от 2 ГиБ таким, а не «it cannot be read».** Файл по пути в `send({ files })` и фото
  группы или профиля сначала проверяются по размеру: Node не читает файл от 2 ГиБ, и ошибка теперь говорит это.
- **`max <бот> bot chats members add` берёт не больше 100 человек за раз.** Bot API MAX принимает до 100 id в одном
  запросе; список длиннее теперь отказывается до запроса и просит разбить его на несколько запусков.

## 0.50.0 — 14.10.2026 [#0500--14102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-45]

- **Сборка на `@wirecat/cli-core` 0.262.0 (новое имя `@wirecat/cli-messaging`, следует за его 0.261.0; команда сверки
  — `cli-core-parity`) и `@wirecat/cli-base` 0.26.0.** Ключи в машинном выводе — snake_case: в `error.details` —
  `operation_id`, `send_id`, `retry_after_ms`; в `commands --json` — `global_options`, `inherited_options`,
  `exit_codes`, `takes_value` и `contract: 1`. Дерево запроса в MCP-аргументе `ast` пишет `lower_inclusive`,
  `upper_inclusive` и `must_not`.
- **HTML-файлы читаются как основной текст** (cli-core 0.262.0): меню, подвалы и баннеры отбрасываются, заголовки,
  списки, таблицы и ссылки остаются. Уже сохранённый текст HTML-вложений перечитывается при следующем
  `attachments extract` и меняется. `title:`, `site:`, `lang:`, `author:` и `keyword:` ищут по заметкам и файлам.

### Исправлено [#исправлено-44]

- **`max config set defaultProfile <имя>` и `config unset defaultProfile` работают без указания профиля.** Раньше
  команда сначала требовала профиль и падала, если их несколько (cli-core 0.262.0).

## 0.49.0 — 13.10.2026 [#0490--13102026]

### Что нового [#что-нового-47]

- **Сборка на `@wirecat/cli-messaging` 0.259.0 и `@wirecat/cli-base` 0.24.0.** Команда `store fetch` теперь
  называется `messages sync` (те же аргументы, параметры и JSON); старое имя скрыто и считается устаревшим.
- **`--debug`:** при сбое полная запись — причина и стек — идёт следом за ошибкой: в терминале после строки `✗`,
  иначе второй строкой JSON.
- **`runs list` и `runs search` читают индекс по дням** и отвечают за миллисекунды даже на тысячах запусков.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-46]

- **Общая копия сообщений и модели речи один раз переезжают в папку WireCat**, `~/.local/share/WireCat/`
  (Windows: `%LOCALAPPDATA%\WireCat\Data\`), при первом запуске — из `~/.local/share/cli-messaging/` и
  `~/.cache/cli-common/models/`. Переезд ничего не перезаписывает: если в обоих местах лежат разные копии, `max`
  останавливается с кодом `3` и называет оба файла. `WIRECAT_STATE_DIR` заменяет `CLI_COMMON_CACHE_DIR` и
  переносит всю папку. Обновляйте `tg` и `memo` вместе с `max`: старый CLI создаст новую копию на прежнем месте.
  [Где лежат файлы](/llms.mdx/docs/ru/max/installation/content.md).
- **Один объект ошибки:** `{"error":{"code","reason","message","details"}}`. То, что лежало прямо в `error`, —
  `candidates`, `sendId`, `operationId`, `permission` — теперь в `error.details`. `reason` — идентификатор через
  точку (`output_limit` → `output.too-large`, `input_limit` → `input.too-large`); `retryable` есть, только если
  его задал сам сбой, а `actions` — только у неудавшихся элементов частичного результата. Код `1` называется
  `internal_error` (было `generic_failure`), и его сообщение больше не несёт текст самого сбоя — его показывает
  `--debug`. Ключи, которых нет в общем списке cli-messaging, из `details` пропадают: `providerError` остаётся
  только в тексте сообщения, ID неудалённых сообщений `messages delete` тоже перечислены в сообщении.
- **`runs show` показывает только то, что пошло не так** (неудачные ответы, предупреждения, падение) и добавляет
  `eventCount`; все события — с `-v`, как раньше.
- **`max` больше не выбирает профиль сам.** Если профиль не назван ни первым словом, ни `MAX_PROFILE`,
  ни настройкой `defaultProfile`, команда, которой нужен аккаунт, завершается с кодом `2` и перечисляет
  профили этого компьютера — даже когда профиль один. Раньше она молча работала с профилем `default`.
  Первый вход тоже с именем: `max personal setup` (любое имя вместо `personal`); на компьютере без
  профилей ошибка подсказывает именно эту команду. Без профиля по-прежнему работают `--help`,
  `--version`, `commands`, `skill show`, `account list`, `config show`. Подсказки в ошибках теперь
  всегда называют профиль (`max default setup`, а не `max setup`), и `max mcp config` всегда передаёт его серверу.
  Почему: какой аккаунт пишет и читает, решает владелец, и решает явно — иначе агент или скрипт мог
  действовать не от того аккаунта.
  Что учесть: у всех, кто жил на профиле `default` без имени, `max chats list` и скрипты без профиля
  перестанут работать. Ошибка называет профили; одно из трёх: `max default chats list`,
  `export MAX_PROFILE=default` в профиле оболочки или `max config set defaultProfile default`. Записи MCP,
  сделанные через `max mcp config`, переделайте этой же командой. [Профили](/llms.mdx/docs/ru/max/profiles/content.md).

## 0.48.0 — 12.10.2026 [#0480--12102026]

### Что нового [#что-нового-48]

- **`--brief` и `--full` у любой команды.** `--brief` оставляет у найденного сообщения ссылку, чат, время,
  автора, отрывок и оценку; `--full` возвращает всё.
- **`max search all` называет автора каждого найденного** и то, как найдено (по словам или по смыслу).

- **`max schedule`: команда или агент по расписанию** — через systemd (Linux), launchd (macOS) или
  Планировщик заданий (Windows). `max schedule command <имя> --every 2h -- messages list <чат>` запускает
  команду max; чтение сохраняет прочитанное в хранилище. `max schedule agent <имя> claude "<задание>" --at 08:30`
  запускает агента (claude или codex), не чаще раза в час. Агент работает с `MAX_READ_ONLY=1` и не может ничего
  отправить; его ответ лежит в `latest.md` рядом с расписанием, о готовности приходит уведомление на рабочем
  столе. `--once 2h` — один запуск, после него расписание удаляется само. `max schedule list`, `run`, `remove`.
- **`max server install` подсказывает, как включить ежедневный разбор договорённостей**, и ничего не включает сам.
- **`MAX_READ_ONLY=1` запрещает процессу любые отправки**, сильнее файла конфигурации и `--permission`.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-47]

- **`max search messages` отдаёт отрывок, а не весь текст.** У каждого найденного вместо `text` — `excerpt`,
  около 240 символов вокруг первого слова запроса; весь текст — с `--full` или `max messages show <ссылка>`.
  Пустые `editedAt`, `replyTo`, `forwardedFrom` и `reactions` в машинном выводе больше не печатаются.
  Скрипт, который читал `text` у результатов поиска, читает `excerpt` или добавляет `--full`.

## 0.47.0 — 11.10.2026 [#0470--11102026]

### Что нового [#что-нового-49]

- **Задачи получают план, ссылки и повестку дня** (общее хранилище 0.247.0, версия 4). `max tasks add` берёт
  `--title`, `--description`, `--due` и `--check`; `max tasks plan <задача>` меняет их потом, `none` очищает
  дату. Дата проверки — когда агенту снова посмотреть на задачу, это не напоминание: владельцу ничего не
  приходит. `max tasks link` привязывает к задаче сообщения, чаты, людей, документы и ссылки;
  `max tasks show` показывает план со ссылками. `max tasks agenda` без текста сообщений перечисляет
  просроченные и близкие задачи, чаты, где ждут ответа владельца (`owed`), где владелец ждёт ответа
  (`waiting`), и чаты, чьё последнее сообщение ещё не сохранено (`unsynced`). `max skill show follow-ups` —
  ежедневный разбор для агента: только черновики, ничего не отправляет.
- **Поиск понимает сравнение через двоеточие.** `date:>=2026-01-01` (и `:>`, `:<`, `:<=`) — то же, что
  `date>=2026-01-01`; раньше такая запись давала `invalid_syntax`. Отклонённый `after:` или `before:` теперь
  подсказывает замену: на `after:2026-09-01` ответ — используйте `date>=2026-09-01`.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-48]

- Общее хранилище 0.247.0: контекст встречи записывает факты действием `fact.add`; `memory.add` больше не
  принимает вид `fact`.
- Общее хранилище 0.246.0 проверяет новые метки перед созданием. Похожее название требует
  проверки владельцем; можно использовать существующую метку или её явный алиас. Существующие
  записи сохранены; автоматические совпадения имени и алиаса объединяются в одну метку.

## 0.46.0 — 11.10.2026 [#0460--11102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-49]

- **На macOS max хранит файлы там же, где на Linux**: `~/.config/max-cli`, `~/.local/share/max-cli` и
  `~/.cache/max-cli` вместо `~/Library/…`. Первый запуск переносит туда старые папки вместе с общим хранилищем и
  моделями речи и переводит лог установленного агента `max server` на новую папку. Пока работает `max serve` или
  MCP-сервер, max пишет одно предупреждение, в этот раз работает со старыми папками и пробует снова при следующем
  запуске. На Linux и Windows ничего не меняется.
- **max работает на `@wirecat/cli-messaging` 0.242.0**: существующие ключи проектов и задач сохранены; новые
  проекты получают короткие ключи, общее хранилище поддерживает проверяемые зависимости задач.
- **max работает на `@wirecat/cli-messaging` 0.238.0, архив — версии 2.** При первом открытии архив обновляется:
  записи памяти вида `fact` становятся фактами (то, что произошло — отдельно от выводов), а связи «назначено»
  копируются в назначения задач. Предыдущие сборки max открывают обновлённый архив как раньше.
- **Письма для поиска по смыслу режутся на куски по переписке, а не по одному письму.** Цитаты, приветствия и
  подписи в куски не попадают. При первой индексации старые куски удаляются, и вся почта векторизуется заново —
  один раз, это займёт время. Сам текст писем и поиск по словам не меняются.

### Что нового [#что-нового-50]

- `--source` в `search messages`, `search mail` и `search conversations` принимает список аккаунтов и групп:
  `--source group:work,max:default,email:me@work.example`. Группа сохраняется командой
  `max config set accountGroups.<имя> <список>` и видна всем приложениям, работающим с архивом.
- `max search conversations` находит письма почтовых ящиков и по словам, а не только по смыслу.

## 0.45.5 — 11.10.2026 [#0455--11102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-50]

- **Вступление в чат и импорт контактов идут в счёт `sendsPerHour`.** Вступление считается за одно действие, импорт —
  за каждый номер; `max contacts import` отправляет номера по 10 за запрос. Если лимит остановил импорт посередине,
  ошибка говорит, сколько номеров ушло, и повторный импорт безопасен.

### Что нового [#что-нового-51]

- `max search all --backend archive|server|both` и `--server-time` — как у `search messages`; касается только
  сообщений, почта и заметки ищутся локально. По умолчанию `both`.
- `max search mail --account <адрес>` ищет почту одного почтового ящика; без него — во всех.
- Почта ищется по получателям, папке и теме (`to:`, `cc:`, `bcc:`, `mailbox:`, `subject:`), вложения писем — по смыслу.

### Безопасность [#безопасность-12]

- **Поиск больше не возвращает сообщения другого аккаунта.** `search messages --backend server` с `--source all` или
  `in:all` мог показать чужое сообщение с теми же id чата и сообщения; поиск по чату без аккаунта теперь отклоняется.
  Из `@wirecat/cli-messaging` 0.233.0.

## 0.45.4 — 11.10.2026 [#0454--11102026]

### Что нового [#что-нового-52]

- **`max search messages` без чата спрашивает и сервер MAX**, как строка поиска на web.max.ru: один запрос по
  всем чатам, из каждого чата одно лучшее совпадение. Найденное сохраняется в архив и проверяется вашим
  запросом. С `--chat` сервер, как и раньше, ищет в одном чате. `--backend archive` оставляет только архив;
  с `--json` у таких поисков теперь есть блок `server`.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-51]

- **`max search messages` со словами и без чата теперь подключается к MAX** (раньше отвечал только архив) и
  может ждать сервер до 5 секунд. Это же касается поиска через MCP. Чтобы искать только в архиве, как
  раньше, добавьте `--backend archive` (в MCP — `backend: "archive"`).

### Исправлено [#исправлено-45]

- Работает на `@wirecat/cli-messaging` 0.231.0: там же cli-meetings 0.3.0 и пакеты SQLite и ONNX 1.0.1 с файлом
  лицензии; для `max` ничего не меняется.

## 0.45.3 — 11.10.2026 [#0453--11102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-52]

- Поиск в архиве с `--discover` обрабатывает вопросы вроде «Могут подрядчики подключиться к проекту?»:
  знак вопроса больше не превращается в поисковый шаблон. Строгий поиск и фильтры работают как прежде.
- Поиск почты и переписка связанного человека читают также отдельное хранилище писем, наряду с
  прежним импортом. Почта поддерживает фильтры отправителя и цепочки. В поисковой выдаче письмо с одинаковой ссылкой
  показывается один раз.

## 0.45.2 — 11.10.2026 [#0452--11102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-53]

- **Загрузка истории, у которой первая же страница не удалась без надежды на повтор, снова завершается ошибкой**
  (код выхода `2`), как до 0.45.1. Ожидание, о котором просит MAX, и сбой после нескольких страниц по-прежнему
  дают частичный результат с `complete: false` и кодом `0`.

### Исправлено [#исправлено-46]

- **`max store fetch --background` больше не обрывается через 30 секунд.** Фоновая задача получала общий для
  команд предел в 30 секунд и останавливалась примерно после сотни сообщений. Теперь она идёт до конца; явный
  `--timeout` по-прежнему её ограничивает.
- **`max store fetch --all` пережидает короткую паузу**, о которой просит список чатов (до 5 минут, как уже
  делали страницы сообщений), вместо того чтобы сразу завершиться с `rate_limited`.

### Безопасность [#безопасность-13]

- **Старый `messages.db` удаляется** при открытии копии по пути по умолчанию (так с 0.45.1): незашифрованный файл,
  который был до `wirecat.db`, вместе с `-wal` и `-shm`. Одна строка в stderr называет его. Файл остаётся, если
  задан `MESSAGING_STORE`, и пока его держит открытым другой процесс.

## 0.45.1 — 11.10.2026 [#0451--11102026]

### Исправлено [#исправлено-47]

- Названия пакетов, документация и примеры используют пространство имён WireCat.
- Скачивание вложения по HTTP отличает отказ 429 от обычного сетевого сбоя: прекращает новые файлы и передаёт паузу `Retry-After`, если она есть. Отказ 413 предлагает уменьшить входные данные, а не поднимать локальный лимит.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-54]

- Независимый отказ файла или страницы истории сохраняет успешную часть и возвращает `complete: false`, `batch` или `issue` с кодом выхода `0`. Скриптам нужно проверять полноту; JSONL загрузки добавляет `batch_summary`. Ошибки содержат `actions` для восстановления. Повтор загрузки учитывает неудачные ID checkpoint.
- Пакет прекращает новые запросы после десяти попыток, если доля ошибок выше 50%; `MESSAGING_BATCH_MAX_ERROR_PERCENT` меняет процент, а 100 отключает этот процентный останов. Ограничение частоты и отказ авторизации останавливают раньше; запись с неизвестным исходом не повторяется автоматически.

### Что нового [#что-нового-53]

- Размер файла для извлечения и передачи настраивается через `MESSAGING_ATTACHMENT_MAX_MIB` (по умолчанию 50). PDF-превью теперь допускает 4000 пикселей по стороне и 8 МиБ; `MESSAGING_PDF_PREVIEW_MAX_PIXELS` и `MESSAGING_PDF_PREVIEW_MAX_MIB` меняют эти пределы. Большие значения требуют больше памяти; пределы внешнего OCR и распаковки остаются отдельными.
- `max runs search` и команда `runs search` в MCP `max_read` ищут безопасные диагностические записи по тексту, статусу, коду ошибки и времени без подключения к мессенджеру.

## 0.45.0 — 11.10.2026 [#0450--11102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-55]

- **Локальная копия сама чистит растущие журналы при открытии**, не чаще раза в день: вызовы инструментов
  агентом старше 90 дней удаляются, а у обработанного обновления бота старше 30 дней строка остаётся, но
  содержимое стирается. Обновите tg-cli и cli-memo одновременно: копия у них общая.

### Что нового [#что-нового-54]

- `max store reset` — для копии, которую эта сборка не может перенести на новую схему: сохраняет её рядом,
  удаляет и создаёт пустую. Сначала спрашивает; `--yes` пропускает вопрос, `--no-backup` — копию.
- `max search all --meetings [provider:account]` ищет ещё и в одной учётной записи встреч: расшифровки, чат и
  итоги; `--max-meetings <n|all>` задаёт, сколько встреч просмотреть (по умолчанию 100).

### Безопасность [#безопасность-14]

- **Старый `messages.db` удаляется** при открытии копии по пути по умолчанию: незашифрованный файл, который
  был до `wirecat.db`, вместе с `-wal` и `-shm`. Одна строка в stderr называет его. Файл остаётся, если задан
  `MESSAGING_STORE` или пока его держит открытым другой процесс. Из `@wirecat/cli-messaging` 0.222.0.

## 0.44.0 — 10.10.2026 [#0440--10102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-56]

- **Локальная копия теперь в новом файле `wirecat.db` и после обновления пуста.** Он лежит рядом со
  старым `messages.db`, который `max` оставляет как есть: не читает, не переносит, не удаляет.
  `max store fetch --all` заново скачивает сообщения из MAX. То, что есть только на этом компьютере, —
  например заметки, псевдонимы, метки, задачи и расшифровки — остаётся в `messages.db`. Вход
  сохраняется. Обновите tg-cli одновременно, иначе они будут видеть разные архивы.

### Что нового [#что-нового-55]

- `max contacts timeline <человек>`, и через MCP — команда `contacts timeline` в `max_read`: всё, в чём
  участвовал один человек, во всех связанных с ним мессенджерах, новое сверху, из локальной копии.
  `--scope personal|work`, `--since-time`, `--until-time` и `--limit` сужают выдачу.

## 0.43.1 — 10.10.2026 [#0431--10102026]

### Исправлено [#исправлено-48]

- Скачивание вложений использует обычный HTTP(S) и настроенный транспорт без отдельной проверки DNS или запрета локальных адресов. Это сохраняет совместимость с VPN, прокси и частными сетями; поддержку любого конкретного прокси определяет транспорт.
- Локальное чтение текста и просмотр страниц PDF больше не требуют делить документ после 20 страниц; отдельный 30-секундный срок извлечения убран. Общая отмена команды и ограничения размера остаются.
- Локальная расшифровка полной mono/stereo Ogg Opus записи больше не отказывается после 10 минут. Длинная запись потребует больше памяти и времени.
- Вложения из обычных скрытых рабочих папок снова доступны. Известные файлы с учётными данными, папки CLI и хранилище остаются защищёнными.
- Экспорт Markdown сохраняет разметку сообщений; MCP передаёт исходный Unicode при записи, сохраняя видимые управляющие символы в ответах. Настроенные шлюзы моделей допускают обычные перенаправления.
- Обновление и настройка MCP в Windows принимают обычные относительные записи PATH и нестандартное окружение командного процессора. Хранилище сообщений сохраняет прежнюю схему.

- Руководство уточняет, что поиск с `--discover` читает только локальный архив. Обычный поиск
  в одном чате может также спрашивать сервер MAX; режим discovery его не спрашивает.

## 0.43.0 — 10.10.2026 [#0430--10102026]

### Что нового [#что-нового-56]

- Поиск сообщений с `--discover` или MCP `discover: true` находит частичные совпадения слов и
  подходящие прямые ответы в локальном архиве без скачивания моделей. Строгий поиск остаётся
  по умолчанию; отсутствующие слова помогают агенту проверить основания ответа.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-57]

- **Проект теперь распространяется по лицензии Apache 2.0.** Условия использования — в `LICENSE`.

## 0.42.0 — 10.10.2026 [#0420--10102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-58]

- **Пакет называется `@wirecat/max-cli`, репозиторий находится в WireCatLabs.** Используйте этот пакет для установки и обновления.

- **Удаление проверяет результат чтением с сервера.** Если MAX продолжает возвращать сообщение или
  проверить результат не удалось, команда сообщает `outcome_unknown` вместо `deleted`. Прочитайте
  сообщение перед повторной попыткой; подтверждение запроса ещё не означает, что сообщение исчезло.
- **Локальная расшифровка речи принимает полную запись Ogg Opus с одним или двумя каналами до 10 минут.**
  Более длинную запись сначала разделите на части. Извлечение текста из PDF ограничено 20 страницами
  и 30 секундами; большие PDF также разделите перед обработкой.
- **В MCP невидимые управляющие символы становятся видимыми последовательностями** в ответах и
  аргументах записи, включая текст после преобразования разметки. Флаги регионов сохраняются целыми.
  Обычный JSON вывода CLI сохраняет исходные строки.

### Исправлено [#исправлено-49]

- **Загрузка вложений через MCP завершается без зависания.** Локальное извлечение текста больше не
  блокирует подключение, нужное для скачивания файла.

- **`messages delete` принимает список id через запятую**, как и отдельные аргументы через пробел.
- **Руководства MCP описывают права профиля и подтверждение в приложении агента.** Сервер сам не
  показывает формы подтверждения; устаревший неиспользуемый код формы удалён.

### Безопасность [#безопасность-15]

- **Чтение каталога вложений и передача сохранённых файлов проверяют расположение файла.**
  Скрытые файлы и папки, собственные папки CLI и хранилище сообщений не читаются, в том числе через
  ссылки. Загрузка через MCP также не пишет в эти места; используйте обычную папку загрузок.
- **DOCX проходит те же ограничения распаковки, что другие офисные форматы.** До чтения проверяются
  число частей, суммарный распакованный размер и размер текстовой части.

## 0.41.0 — 09.10.2026 [#0410--09102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-59]

- **Автоответы получает каждый, кого выбрали правила, пока вы не ограничите аудиторию; отдельного списка
  `testers` больше нет.** `max replies audience --reply listed --allow-people <id>` оставляет только
  выбранных людей, `--deny-people` и `--deny-chats` исключают некоторых. Ничего не отправляется, пока
  `permissions.replies.send` не `allow`, а новое правило выключено, пока вы его не включите. Раньше ответ
  шёл только тому, кто был и в `testers`, и в аудитории; два списка путали.
  Файл, где ещё есть `testers`, отвечает ровно тем же людям: они становятся разрешёнными (если аудитория
  уже была `listed`, — только те, кого она тоже разрешала). Разрешённые чаты в таком файле убираются,
  иначе ответ получил бы любой участник этих чатов; запреты сохраняются. Без `testers` файл
  перезапишется при следующей правке через `max replies`.
- **В `max replies status --json` больше нет поля `testers`**; кому можно отвечать, показывают счётчики `audience`. В `max replies test` и `serve` отправитель вне аудитории
  пропускается с причиной «not on the allow list» вместо «not a test account».

### Исправлено [#исправлено-50]

- **`max mcp config` переносит в запись клиента `MESSAGING_STORE` и `XDG_RUNTIME_DIR`**, как `tg`. Клиент,
  который запускает сервер с урезанным окружением, на Linux не доходил до связки ключей и отвечал «нет сессии»,
  а с собственным `MESSAGING_STORE` искал в другой копии сообщений. Запустите `max mcp config` ещё раз и замените
  запись в настройках клиента.

## 0.40.0 — 09.10.2026 [#0400--09102026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-60]

- **Хранилище сообщений удаляет копии, которые держало для старых версий** (версия хранилища 28,
  cli-messaging 0.212.0). Заметки, заметки о контактах, связи и сущности, записанные до перехода на новые
  заметки, один раз переносятся в новые таблицы при обновлении. После него старые max, tg и memo отказываются
  открывать хранилище с сообщением «upgrade this tool» — обновляйте все три вместе.

## 0.39.0 — 09.10.2026 [#0390--09102026]

### Что нового [#что-нового-57]

- **`max attachments show --page 1` отдаёт страницу сохранённого PDF как PNG.** Удалённый агент
  может прочитать все страницы своим зрением и сохранить текст для поиска. Нужны необязательные
  `unpdf` и `@napi-rs/canvas`; API OCR и запись в индекс сами не запускаются. Если MCP-клиент
  показывает только метаданные ресурса, запросите `format: base64` и покажите PNG средствами агента.

- **`max search all "<слова>"` ищет сразу во всём, что хранится на этой машине**: сообщения MAX и Telegram, почту,
  импортированную memo, и заметки. У каждой находки указан вид: сообщение, письмо или заметка. `--only notes`
  (или `messages`, `mail`) сужает поиск.
- **`max search mail` и `max search notes`** ищут в одном виде. Заметки находятся по словам и, если скачана
  локальная текстовая модель, по смыслу; `--type internal` (написанные в memo) или `file` (из папки заметок).
- **`max search messages --type voice`** (или `text`, `file`) находит только такие сообщения.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-61]

- **Статистический `--answerer` принимает сохранённые имена, свои имена и @username.**
  Поиск идёт локально в аккаунтах выбранной истории; при неоднозначности возвращаются кандидаты.
  Неизвестное имя теперь вызывает ошибку вместо отчёта по выдуманному ID с нулём ответов.
  Для явно выбранного неизвестного строкового ID используйте `person:provider/account/id`.
  В responses появилось `identityKnown`; ID без наблюдений получает `false` и `status: unknown`.
  Ноль наблюдаемых ответов не доказывает отсутствие активности ([статистика](/llms.mdx/docs/ru/max/rankings/content.md)).

- **Весь поиск переехал в `max search`.** Старых команд больше нет:

  | Было | Стало |
  |---|---|
  | `max messages search` | `max search messages` |
  | `max messages search --source email` | `max search mail` |
  | `max conversations search` | `max search conversations` |
  | `max bot messages search` | `max bot search messages` |

  Для агентов инструменты переехали так же: `search messages`, `search conversations` и новый `search all`,
  с которого стоит начинать.
- **`max search messages` больше не возвращает почту.** Сохранённый поиск с `in:email` теперь просит
  `max search mail`.
- **Права со старыми путями** (`messages.search`, `conversations.search`) останавливают `max search`, пока
  `max config migrate` не переименует их с теми же уровнями.

### Исправлено [#исправлено-51]

- **Справка о заявках явно называет ограничения MAX.** Она больше не предлагает `--all` или
  `--link` как доступные операции и не обещает порядок по времени; проверки отказа остаются.

## 0.38.1 — 08.10.2026 [#0381--08102026]

### Что нового [#что-нового-58]

- **`max chats requests list|accept|decline` показывает и обрабатывает заявки на вступление в канал.**
  `--search` сужает список по имени. MAX не сообщает время заявки: в JSON `requestedAt` равно `null`.
  Фильтр `--link` и массовое действие `--all` не поддерживаются и отклоняются до запроса.

### Исправлено [#исправлено-52]

- Общая библиотека обновлена до 0.205.0, чтобы MAX, Telegram и Memo использовали одну версию
  локального архива. Схема заметок и ссылки не меняются.

## 0.38.0 — 08.10.2026 [#0380--08102026]

### Что нового [#что-нового-59]

- **`max store jobs list --state <состояние>`** показывает только фоновые задачи в этом состоянии:
  `running`, `done`, `failed`, `cancelled` или `died`.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-62]

- **Латинские слова ищутся по основам английского и испанского сразу.** Раньше — только испанского,
  поэтому английские формы слов («budgets» → «budget») находились хуже.
  Что учесть: после обновления индекс основ строится заново сам. Небольшой архив — сразу при открытии,
  большой — понемногу: `max serve` достраивает его в фоне, `max store migrate` — сразу. Пока индекс не
  готов, поиск ищет точные формы слов и пишет об этом в stderr, а в JSON `query.stemming.applied`
  равно `false`. Индекс основ латинского текста примерно вдвое больше. Если вы задавали
  `searchStemmers.latin` сами, ваша настройка остаётся, и её по-прежнему применяет `max store reindex`.
  Обновите и `tg`: старая версия, открыв перестроенный архив, на поиск по основам отвечает «обновите
  программу» ([архив](/llms.mdx/docs/ru/max/archive/content.md#%D0%BE%D0%B1%D1%81%D0%BB%D1%83%D0%B6%D0%B8%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B0%D1%80%D1%85%D0%B8%D0%B2%D0%B0)).

- **Заметки о человеке (`max contacts notes`) видны в каждом профиле, где виден этот человек.** Раньше
  заметка была видна только в профиле, где её написали.
  Почему: заметки — ваши, а не одного аккаунта; общий архив теперь хранит их отдельно от сообщений,
  вместе с заметками из `memo`.
  Что учесть: если у вас несколько профилей MAX, заметки о человеке из всех профилей теперь
  показываются вместе. Свои имена (`contacts alias`) по-прежнему действуют только в своём профиле.

### Исправлено [#исправлено-53]

- **`max chats join` больше не выдаёт заявку за вступление.** Если канал одобряет, кто вступает,
  команда только отправляет заявку и теперь отвечает `requested: true` вместо карточки канала, а при
  запущенном `max serve` такой канал не появляется в списке чатов, пока заявку не примут
  ([группы](/llms.mdx/docs/ru/max/groups/content.md)).

## 0.37.0 — 08.10.2026 [#0370--08102026]

### Что нового [#что-нового-60]

- **Кнопки ботов.** `messages list` и `messages show` показывают кнопки бота под сообщением, с
  номерами: `[1 Да] [2 Нет]`. `max messages press <чат> <сообщение> <кнопка>` нажимает кнопку по номеру
  или по тексту; бот видит, кто нажал. Нажимаются только обычные кнопки бота. «Поделиться телефоном» и
  «поделиться местоположением» не нажимаются никогда; для ссылки, отправки текста, мини-приложения и
  копирования команда говорит, что сделать вместо этого. Кнопки видны, когда сообщение читается из
  MAX; в локальной копии их нет ([использование](/llms.mdx/docs/ru/max/usage/content.md)).

- **Запуск бота.** `max chats start <бот> [--payload]` делает то же, что кнопка «Начать». Принимает и
  ссылку `https://max.ru/<бот>?start=…` — в том числе на бота, которому вы ещё не писали: чат с ним
  появится в списке. Ссылка на человека отклоняется. Бот получает запуск как сообщение от вас, поэтому
  запуск проходит те же проверки, что отправка.

- **Мини-приложение бота.** `max chats app <бот> [--start]` печатает адрес мини-приложения. Адрес сразу
  входит в приложение от вашего имени — не пересылайте его. `max` этот адрес нигде не сохраняет.

- **`max account list`** — все профили на этом компьютере и аккаунт, в который вошёл каждый. В MAX
  команда не обращается.

- **`max bot messages list`** показывает кнопки и в сообщениях самого бота.

- **`max watch --events` показывает прочтения и изменения чатов** (появилось в 0.36.0, там не
  упомянуто): строка `read` — кто-то прочитал чат, в том числе вы на другом устройстве; строка `chat` —
  у чата сменились название, участники, или вы из него вышли. Пометка «непрочитанным» событием не
  считается.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-63]

- **`contacts profile`: в `flags` появилось `bot`** — `true` у бота, `false` у человека. Раньше `flags`
  всегда был пустым.

- **`watch --events`: строка `chat` приходит, только когда у чата правда что-то изменилось** —
  название, описание, участники, статус, фото или владелец. Раньше при запущенном `max serve` она могла
  приходить на каждую отправку.

### Исправлено [#исправлено-54]

- Если MAX не ответил после запуска бота или нажатия его кнопки, результат считается неизвестным
  (`outcome_unknown`, код 14), а не безопасной для повтора ошибкой. Автоматического повтора нет;
  проверьте ответ бота, прежде чем запускать действие снова. Журнал сохраняет неизвестный исход.

- При запущенном `max serve` просмотр группы по ссылке добавлял её в список чатов, хотя вы в ней не
  состоите (исправлено в 0.36.0, там не упомянуто).

- `max` без команды и группа команд без подкоманды (`max chats`) печатали только `✗ (outputHelp)`. Теперь
  в терминале — справка этой команды; в скрипте и с `--json` — ошибка с подсказкой `max --help`.

## 0.36.0 — 08.10.2026 [#0360--08102026]

### Что нового [#что-нового-61]

- **Файлы для удалённого агента:** `attachments show` передаёт сохранённые байты порциями с SHA256.
  MCP возвращает целые изображения или бинарные ресурсы, с запасным JSON/base64. Передача не вызывает
  модель и не меняет индекс; агент читает файл сам и сохраняет текст ([вложения](/llms.mdx/docs/ru/max/attachments/content.md)).

- **Обновление общей библиотеки** также добавляет просмотр папки с названиями чатов,
  `metadata refresh --only-missing`, повтор/очистку фоновых заданий, наблюдаемые когорты удержания
  и счётчики с явной свежестью; неизвестные значения не заменяются нулями.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-64]

- **`max contacts profile` заполняет `seen`** временем последнего появления или `online`, когда MAX
  сообщает присутствие. Поле, которое прежде оставалось пустым, теперь может содержать значение
  ([люди](/llms.mdx/docs/ru/max/people/content.md)).

- JSON рейтингов и доказательств содержит наблюдения счётчиков и их свежесть; evidence также
  поддерживает когорты удержания. Проверяйте поля каждого счётчика и вид selection, прежде чем
  интерпретировать ответ; неизвестное значение или неполный архив не означают ноль.

## 0.35.0 — 08.10.2026 [#0350--08102026]

### Что нового [#что-нового-62]

- **`max chats delete` и `max chats clear` — удалить чат или все его сообщения только у себя.** У остальных участников
  чат и сообщения остаются. Без `--allow-dangerous` команда спросит, а без человека у терминала — откажет.

- **Текст вложений читается локально:** ODT, ODS, XLSX, PPTX, EPUB, UTF-16 с BOM и уверенно
  определённые старые кодировки. Модель не вызывается; формулы не вычисляются, картинки
  остаются для агента. Дополнительные пакеты для этих форматов не нужны; PDF и DOCX
  используют прежние необязательные движки. Возможности и ограничения —
  [в руководстве вложений](/llms.mdx/docs/ru/max/attachments/content.md).
- **Отчёты администратора читают сохранённый архив:** вопросы без наблюдаемого ответа,
  время ответа выбранных людей, помощь новичкам с известной датой вступления и посты
  каналов с просмотрами и малым обсуждением. Выборки и evidence позволяют проверить
  исходные сообщения. Неполные данные остаются неизвестными, поэтому отсутствие
  ответа в отчёте не доказывает его отсутствие в MAX ([рейтинги](/llms.mdx/docs/ru/max/rankings/content.md)).

- **Стикеры: `max stickers list` и `max messages send --sticker <id>`.** Список — ваши наборы, с `--set <id>` — стикеры
  набора с их id. Стикер уходит один, без текста и файлов, как в MAX.
- **`max chats mute` и `max chats unmute` — уведомления из чата**: насовсем или `--until 8h`. Меняется только у
  вас, участники ничего не видят.
- **`max account privacy set`** меняет приватность: `--find-by-phone`, `--phone-number`, `--calls`,
  `--chat-invites` (everyone, contacts, nobody) и `--hide-online on|off`; остальные настройки не трогаются. Найти по
  номеру MAX позволяет всем или только контактам — `nobody` команда отклонит.
- **`max chats media` показывает медиа чата с сервера MAX** — фото, видео, файлы, аудио и ссылки, как галерея;
  `--type`, `--before-id` ([использование](/llms.mdx/docs/ru/max/usage/content.md#%D0%BC%D0%B5%D0%B4%D0%B8%D0%B0-%D1%87%D0%B0%D1%82%D0%B0)).
- **`max calls list` — история звонков**, новые сверху: входящие, исходящие, пропущенные, длительность.
- **`max account privacy show` — настройки приватности**: кто находит по номеру, видит номер, звонит, добавляет в
  чаты, скрыт ли статус «в сети». Читается из ответа на вход, лишних запросов нет.

## 0.34.0 — 08.10.2026 [#0340--08102026]

### Что нового [#что-нового-63]

- **`max chats update --photo` ставит фото группы или канала** ([группы](/llms.mdx/docs/ru/max/groups/content.md)).
- **`max chats folders order` меняет порядок папок.** После обязательной папки «Все чаты» идут названные папки,
  затем остальные в прежнем порядке ([использование](/llms.mdx/docs/ru/max/usage/content.md)).
- **Свои имена и заметки о людях: `max contacts alias` и `max contacts notes`.** Хранятся только на этом
  компьютере, в MAX не уходят; `contacts show --with-notes` и `contacts list --search-notes` их показывают и ищут
  ([использование](/llms.mdx/docs/ru/max/usage/content.md#%D1%81%D0%B2%D0%BE%D0%B8-%D0%B8%D0%BC%D0%B5%D0%BD%D0%B0-%D0%B8-%D0%B7%D0%B0%D0%BC%D0%B5%D1%82%D0%BA%D0%B8-%D0%BE-%D0%BB%D1%8E%D0%B4%D1%8F%D1%85)).
- **Автоматические метки групп и каналов: `max metadata refresh` и `max tags auto`** — по названию и описанию,
  без сообщений; ваши метки не трогаются ([поиск](/llms.mdx/docs/ru/max/search/content.md#%D0%BC%D0%B5%D1%82%D0%BA%D0%B8)).
- **`max store fetch --all` скачивает все чаты** — последние 90 дней каждого; `--background` — в фоне.
  Поиск сообщает, сколько сообщений и чатов просмотрено, сколько чатов не скачано или отстаёт;
  `coverage.next` в JSON подсказывает агенту команду, которую нужно выполнить перед выводом, что сообщения нет.
- **Метрики ответов и обсуждений используют сохранённые reply-связи MAX.** Неполные данные оставляют
  связь неизвестной, вместо предположения о ней.
- [Руководство рейтингов](/llms.mdx/docs/ru/max/rankings/content.md) объясняет метрики, оценки, покрытие, сохранённые подборки и доказательства.
- Новые руководства объясняют [вложения](/llms.mdx/docs/ru/max/attachments/content.md), [распознавание голоса](/llms.mdx/docs/ru/max/audio-recognition/content.md)
  и [настройку внешних моделей](/llms.mdx/docs/ru/max/external-models/content.md).

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-65]

- **`max session end` выходит из MAX, а не только забывает токен здесь** — как `tg session end`.
  `revokedOnServer` теперь `true`. Если токен скопирован из вкладки web.max.ru, вкладка тоже выйдет
  ([сессии](/llms.mdx/docs/ru/max/sessions/content.md)).

- **`max messages search` в одном чате спрашивает и сервер MAX.** С `--chat` или `chat:` и словами по умолчанию
  ищутся архив и сервер (`--backend both`): находится и то, что ещё не скачано. Ответ сервера проверяется тем же
  запросом, у каждого сообщения есть `source`. `--backend archive` — только архив, `--server-time` — сколько ждать
  сервер (5 с). Без чата ищется только архив ([поиск](/llms.mdx/docs/ru/max/search/content.md)).
  Что учесть: поиск в одном чате теперь может подключаться к MAX; `--backend archive` оставляет его локальным.

### Исправлено [#исправлено-55]

- **Готовые MCP-запросы используют доступные `max_read` и `max_write`**, вместо старых названий отдельных
  инструментов. Поиск в них проверяет `coverage.next` перед выводом, что сообщения нет.

- **Сохранённые подборки сохраняют исключительные границы дат при повторном запуске**, чтобы сообщение на
  самой границе не попадало в результат. Недоступные операции с папками больше не предлагаются агенту в MCP.

- **`max serve --timeout` закрывает сервер.** По истечении времени завершаются подключение,
  незаконченный вход и фоновые задачи; процесс выходит с кодом тайм-аута.

## 0.33.0 — 07.10.2026 [#0330--07102026]

### Что нового [#что-нового-64]

- **`max stats messages top` и `max stats contacts top` ранжируют сохранённые сообщения и их авторов**, а
  `evidence` у каждой показывает, из каких сообщений сложилось место в рейтинге. Всё считается по локальной
  копии, в MAX ничего не отправляется. `searches create --selection` сохраняет такой рейтинг как поиск.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-66]

- **У каждого профиля теперь один темп запросов к MAX, общий для всех процессов `max`.** Раньше две
  команды сразу, фоновые `store fetch`, `mcp` и `serve` выдерживали паузы каждый сам по себе, и вместе
  обращались к MAX чаще. Теперь они делят один запас: 10 запросов подряд, дальше 20 в минуту.
  Почему: MAX блокирует аккаунт за слишком частые запросы, а параллельные задания умножали их.
  Что учесть: массовые скачивания, запущенные параллельно, идут дольше; команда, которой ждать очереди
  больше 5 минут, сразу завершается с кодом `8`. Темп меняет `requestsPerMinute` или
  `MAX_REQUESTS_PER_MINUTE`, `0` выключает. Всё об ограничениях — [странице об ограничениях](/llms.mdx/docs/ru/max/limits/content.md).
- **У `max messages send` больше нет ключа `--comment-to`.** В 0.32.0 он появился вместе с общим кодом Telegram, но
  в MAX только отказывал с кодом 2.
  Что учесть: скрипт, который передаёт `--comment-to`, по-прежнему получает код 2, теперь с сообщением о неизвестном
  ключе.

## 0.32.0 — 07.10.2026 [#0320--07102026]

### Что нового [#что-нового-65]

- **Фото и сканы вложений можно распознать пачкой через выбранную модель.** По умолчанию агент по-прежнему
  читает их сам и сохраняет текст через `attachments text set`. Для массовой обработки есть
  `attachments extract --ocr` с моделью из `models.ocr` и `--concurrency`; распознанный текст попадает в
  прежний поиск по `content:`.
  Что учесть: `--ocr` отправляет файлы выбранному провайдеру модели, поэтому включается только явно. Кеш
  учитывает файл и модель; сбой API не затирает текст агента и прежний индекс.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-67]

- **`max contacts profile` показывает прежние имена человека в новом ключе `aliases`.** Раньше локальная
  копия помнила только текущее имя: новое имя из сообщения или синхронизации контактов затирало старое.
  Почему: человека, который сменил имя, проще узнать по прежнему.
  Что учесть: в ответе `--json` появился ключ `aliases` — список `{ name, firstSeenAt, lastSeenAt, source }`
  от старых к новым. `source: messages` — имя из сохранённых сообщений, оно приблизительное. Список пуст, пока
  копия не видела смены имени. Поиск `from:` ищет только по текущему имени. [Люди](/llms.mdx/docs/ru/max/people/content.md).
- **У `max messages send` появился ключ `--comment-to`, но в MAX он не работает: команда отказывает с кодом 2 и
  ничего не отправляет.** Ключ общий с Telegram, где он пишет комментарий под постом канала.
  Что учесть: в MAX комментарии под постами каналов не поддерживаются; не используйте ключ в скриптах.

## 0.31.0 — 07.10.2026 [#0310--07102026]

### Что нового [#что-нового-66]

- **Подготовка поиска и ремонт архива.** Извлечение текста через MCP, `attachments extract --from-dir`
  и `messages download --extract`; проверка изменившихся файлов по хешу. `store fetch --catch-up`
  подготавливает граф и установленные локальные векторы в заданных пределах; по умолчанию выключен.
  `store gaps plan/repair` и MCP показывают записанные внутренние разрывы и явно загружают их
  с лимитами и заданиями. Неизвестные края и неоднозначные страницы не считаются полным архивом.

- **Состав отслеживаемых групп обновляется ежедневно, пока работает MAX server.**
  Доступен `chats members fetch --track`; tracking не продлевает idle timeout сервера.

- **`max setup` проще читать.** Каждый шаг — заголовок `[1/4] This computer`, под ним с отступом то, что
  произошло; вопросы и QR-код стоят под своим шагом, вокруг кода пустая строка. Итог — выровненная таблица,
  первой строкой команда, с которой начать. Вывод `--json` и его ключи не изменились; `--quiet` по-прежнему
  скрывает шаги.

- **Шаблоны автоответов используют Liquid и отдельные блоки `ai`.** `models.replies`
  выбирает провайдера; `replies consents` выдаёт согласие на профиль и endpoint с запретами
  для отдельных чатов. Обычный `replies test` не вызывает модель; `--ai` явно передаёт
  сохранённые данные. Старые шаблоны сохраняют запасной текст с предупреждением.
  Отправка остаётся ограниченной `testers` и `replies.send`; [руководство](/llms.mdx/docs/ru/max/replies/content.md).
- **`max serve` открывает задачи из правил автоответов.** Просматривайте их через
  `max tasks list` или MCP-промпт `open-tasks`; создание задачи ничего не отправляет.
- **Подключение из браузера описано для Windows, macOS и Linux.** Руководство разделяет
  Tailscale и сервер, даёт команды PowerShell и объясняет временные права отправки,
  подключение Codex web, запуск двух мессенджеров и остановку отдельных туннелей.
  [Подключение](/llms.mdx/docs/ru/max/remote/content.md).

- **Настройки, права и профили объясняются отдельно.** Руководства начинаются с обычных задач, расположения файла и примеров; полный справочник остаётся доступен.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-68]

- Контракт SDK 0.161.0: headless-режим, пределы ввода/вывода и времени, схемы команд, выбор полей,
  previews и правила повторения записей. Статистика использует `stats <ресурс> <вид>` без старых алиасов.
- MCP использует три инструмента поиска, чтения и записи вместо отдельных инструментов на команду;
  серверных форм подтверждения нет. Права профиля и отдельные правила модерации сохраняются.
- Настройки разделены на краткое руководство и полный справочник; добавлена пользовательская
  страница о контракте CLI и проверка агентского навыка в CI.

- **Статистика вызывается через `stats messages show`, `stats chats show` и `stats tasks show`.**
  Старые пути `messages stats`, `chats stats`, `tasks stats` удалены; обновите команды
  и точные разрешения на `stats.messages.show`, `stats.chats.show`, `stats.tasks.show`.
  MCP-инструменты теперь называются `max_stats_messages_show`, `max_stats_chats_show`,
  `max_stats_tasks_show`.
- **Ошибки синтаксиса возвращают код 2 и структурированную ошибку JSON.** Скриптам,
  ожидающим прежний код 1 или обычный текст, нужно обновить обработку ошибок.

- **При первой загрузке настроек создаётся config.json.** Существующий файл не перезаписывается; переменные и параметры команды в него не сохраняются. config show теперь может создать файл, а обычные значения показывают источник defaults файла.
- **Поиск слов и фраз находит формы слов.** Запросы в скриптах могут вернуть больше сообщений. Для прежнего точного сопоставления используйте exact: или --exact; явно указанное text: продолжает искать формы. Настройки языка архива определяют сопоставление.

### Исправлено [#исправлено-56]

- **Подготовка поиска соблюдает запрет на запись связей.** `conversations.links: readonly` или `deny`
  останавливает catch-up после загрузки и при ремонте разрывов до подключения или запуска задания.
  Явный `--no-catch-up` по-прежнему разрешает обычное чтение истории по правилам профиля.

- Контекст человека находит личную переписку без записанного состава участников, если ID
  диалога совпадает с ID человека; последние сообщения в обе стороны снова доступны.
- Документация MCP использует текущие пути команд и права без удалённых форм подтверждения.

- При прерывании записи сохраняются исходные `outcome_unknown`, `operationId` и сведения
  о повторении, возвращённые командой: обновлена общая библиотека до 0.161.0.

- **Таймаут команды во время записи Bot API сохраняет неизвестный результат.**
  Операция могла выполниться; перед повтором нужно проверить состояние.

- **MCP MAX не предлагает неподдержанные инструменты форумов.** Поиск команд больше не предлагает изменение и порядок Telegram topics.

## 0.30.0 — 06.10.2026 [#0300--06102026]

### Что нового [#что-нового-67]

- **`max stats charts --output activity.png` сохраняет график в PNG с тёмной темой.**
  SVG остаётся доступен; изображения записываются только в новые файлы. MCP `max_stats_charts`
  с `format: "png"` возвращает изображение вместе с JSON, без подключения к MAX и записи файлов.
  Без `format` MCP по-прежнему возвращает JSON.
- **Правила автоответов можно редактировать через `max replies add|edit|on|off` и `audience`.**
  Новое правило выключено до явного включения; изменения сохраняются только локально, без отправки сообщений.
  Ограничение автоответов тестовыми аккаунтами сохраняется; список `testers` по-прежнему задаётся в файле.
  [Автоответы](/llms.mdx/docs/ru/max/replies/content.md).
- **`max tasks` — что ждёт вашего ответа.** `max review` ведёт в локальной копии задачу на вопрос, на который
  никто не ответил, и на сообщение, где вас упомянули, и закрывает её, когда вы ответили; теперь их видно.
  `max tasks list` показывает их со ссылкой на сообщение; `max tasks add <сообщение> --type promise` добавляет то,
  чего правила не видят; `max tasks close <задача> --as done|dismissed` закрывает навсегда; `max tasks stats`
  считает по чатам. Агенту то же дают MCP `max_tasks_list`, `max_tasks_add`, `max_tasks_close`, `max_tasks_stats`.
  Всё остаётся на этой машине, в MAX ничего не уходит; запись — по правам `tasks.add` и `tasks.close`.
  Что учесть: в MCP стало на четыре инструмента больше; `max serve` в MAX задачи пока не открывает.
  [Что ждёт вашего ответа](/llms.mdx/docs/ru/max/groups/content.md#%D1%87%D1%82%D0%BE-%D0%B6%D0%B4%D1%91%D1%82-%D0%B2%D0%B0%D1%88%D0%B5%D0%B3%D0%BE-%D0%BE%D1%82%D0%B2%D0%B5%D1%82%D0%B0).
- **Длинные сообщения ищутся по смыслу целиком.** Сообщение длиннее примерно 1200 знаков перед эмбеддингом
  делится на перекрывающиеся части, поэтому поиск по смыслу читает его полностью, а не только начало. Чаты,
  собранные раньше, считаются устаревшими: их пересобирают `conversations build` или `search --refresh`
  (cli-messaging 0.153.0; хранилище переходит на версию 21, которую старые сборки продолжают писать).
- **MCP выполняет разрешённые записи из веб-клиентов без серверных форм.** Режим
  `--http-confirmation permissions` следует уровням прав: `allow` не требует серверную форму,
  `ask` требует её. По умолчанию форма остаётся обязательной для каждой записи. Повторяемый
  `--permission ключ=уровень` переопределяет права только на время работы сервера без изменения
  настроек. Подтверждение приложения отдельно и сервером не проверяется.
  Что учесть: в этом режиме всё, что профиль разрешает на уровне `allow`, включая отправку сообщений, агент из
  браузера выполняет без формы; проверьте права перед включением. [Подключение](/llms.mdx/docs/ru/max/remote/content.md).

### Исправлено [#исправлено-57]

- **Описания MCP-инструментов отслеживания участников учитывают ручной сбор в MAX.**
  Агенту больше не обещается ежедневное чтение списков через `serve` и не предлагается недоступный
  `fetch --track`. Список групп и сохранённые снимки по-прежнему читаются из локального хранилища.

## 0.29.0 — 06.10.2026 [#0290--06102026]

### Что нового [#что-нового-68]

- **`max chats tracking list|show|add|remove` управляет списком групп для наблюдения за составом.**
  Можно посмотреть сохранённые снимки числа участников, добавить группу без немедленного чтения
  или убрать её, сохранив историю. Для записи состава используйте `max chats members fetch`.
  В MAX `serve` пока не читает участников ежедневно: повторяйте сбор вручную или по своему расписанию.
- **Профиль человека.** `max contacts profile <человек>` показывает, что MAX сообщает о человеке: имя, ссылку,
  описание, когда создан аккаунт (`registered`, по данным MAX), есть ли своё фото, — и для каждого общего чата,
  сколько его сообщений в локальной копии, первое и последнее. Телефон, если MAX его прислал, — последние четыре
  цифры, целиком с `--show-phone`. Один запрос к MAX сверх `contacts show`. MCP: `max_contacts_profile`.
- **Автоответы по правилам — только тестовым аккаунтам.** `max serve` отвечает на входящие сообщения по
  правилам из `<профиль>.replies.json`, но лишь тем, кто назван в `testers`; отправка — только при
  `permissions.replies.send allow`. Команды `max replies test`, `pause`, `resume`, `status`. Страница —
  [автоответы](/llms.mdx/docs/ru/max/replies/content.md).
- `max contacts context <человек> --chat <чат>` (можно повторять) даёт его последние сообщения в каждом чате — только
  время и текст, чтобы агент пересказал; `-v` добавляет номера и ссылки, `--limit` — на чат, `--refresh` сначала читает
  последнюю страницу чата у MAX.
- Использует cli-messaging 0.152.0.
- **`max contacts check <человек>` — похож ли человек на бота.** Оценка по профилю и по сохранённым сообщениям
  (ничего не писал, первое сообщение — ссылка, один текст в нескольких чатах), у каждой причины — источник.
  Публичные списки спамеров ведут только Telegram, поэтому для MAX они не запрашиваются. `max chats members audit
  --deep <n>` так же проверяет первых n участников, по одному в секунду.

- **`max chats members fetch` сохраняет снимки участников, а `history` показывает изменения.**
  Чтение истории доступно offline, с фильтром `--since-time`. Снимок ограничивается `--budget`;
  выходы фиксируются только после полного чтения. Ежедневное отслеживание ждёт поддержки
  фоновой службы MAX. [Работа с участниками](/llms.mdx/docs/ru/max/groups/content.md#%D1%81%D0%BD%D0%B8%D0%BC%D0%BA%D0%B8-%D1%83%D1%87%D0%B0%D1%81%D1%82%D0%BD%D0%B8%D0%BA%D0%BE%D0%B2).

- **`max stats charts` строит графики статистики чата.** Команда возвращает нейтральное описание в JSON,
  а по `--output` сохраняет SVG с тёмной темой: сообщения, активные авторы, вступления и выходы по дням или неделям.
  Пропущенные даты остаются разрывами, неполные данные отмечаются явно. Существующий файл не перезаписывается.
  MCP `max_stats_charts` возвращает описание из локального хранилища; PNG появится отдельно.
  Новая библиотека добавляет около 61,6 MiB распакованных файлов до дедупликации; она загружается в процесс
  только при запросе изображения. [Как пользоваться](/llms.mdx/docs/ru/max/usage/content.md#%D0%B3%D1%80%D0%B0%D1%84%D0%B8%D0%BA%D0%B8-%D1%81%D1%82%D0%B0%D1%82%D0%B8%D1%81%D1%82%D0%B8%D0%BA%D0%B8).

- **Реакции на посты канала сохраняются и при `max store fetch`.** MAX присылает число реакций вместе с историей
  канала, и теперь `max` его не теряет: `max chats stats` может ранжировать посты канала по реакциям без отдельного
  запроса.

- **`max chats stats <чат>` — цифры группы или канала за период.** Сообщения, сколько людей писало, ответы,
  реакции, лучшие посты, вопросы и как быстро на них отвечали, кто вошёл и вышел. Считается по локальному хранилищу;
  входы и выходы спрашиваются у MAX. Если в хранилище не вся история чата, числа — нижняя граница, и команда
  подсказывает, какой `store fetch` её дополнит.

- **Поиск читает текст файлов.** `attachments extract` сохраняет текст TXT, DOCX и PDF с текстовым слоем;
  `content:` находит его. Для DOCX/PDF нужны необязательные `mammoth`/`unpdf`; фото и сканы читает агент
  и сохраняет результат через `attachments text set`. По умолчанию читаются только скачанные файлы;
  `--download --output-dir` явно скачивает их сначала.
- **Поиск можно сначала обновить и показать цепочку ответов.** `--sync-first` ограничивает скачивание
  пятью чатами, 500 сообщениями и 30 секундами; неполное обновление не прячет локальную выдачу.
  `--thread` добавляет ограниченный граф ответов с источниками связей; без графа используется контекст по времени.
- **Поиск бесед принимает строгий фильтр и явный охват аккаунтов.** `--filter` ограничивает беседы до
  ранжирования; весь фильтр должен совпасть хотя бы у одного сообщения. `--source` расширяет охват
  явно. Агент может связать сообщения целиком через MCP: инструкция `link-conversations`, пачки,
  сохранение связей и перестройка графа.
- **Модели векторов и анализа настраиваются отдельно по профилям.** Локальные векторы и ваш агент
  остаются по умолчанию. Внешний сервис получает текст только при явном выборе; `build --analyze --chat`
  спрашивает согласие и запоминает его для аккаунта, чата и сервиса до отзыва.

- **Свои метки: `max tags add`, `remove` и `list`.** Метку можно повесить на чат (`--chat`), человека
  (`--contact`) или одно сообщение (`--message`), а `tag:<метка>` в поиске находит помеченное. Метки
  хранятся только в архиве на этой машине и в MAX не уходят. Метка — от 1 до 32 латинских букв, цифр и
  дефисов. Агенту доступны те же действия через MCP. См. [Поиск сообщений](/llms.mdx/docs/ru/max/search/content.md).
- **Сохранённые запросы: `max searches` и `--saved`.** `max searches create <имя> [запрос]` сохраняет
  запрос с его опциями, `max messages search --saved <имя>` и `max messages stats --saved <имя>`
  запускают его. Слова, добавленные к `--saved`, сужают запрос, а опции в командной строке заменяют
  сохранённые. `searches list`, `show`, `history`, `delete` и `clear` показывают и чистят сохранённое
  и историю. Поэтому запрос у `messages search` теперь необязателен, если есть `--saved`.
- **`max contacts context <человек>` — что архив знает об одном человеке.** Общие чаты, последние
  сообщения в обе стороны, его недавние сообщения и где его упоминали. Команда читает только архив и
  ничего не отмечает прочитанным. `max contacts link` записывает, что аккаунт в MAX и аккаунт в
  Telegram — один человек, тогда `context` показывает обоих; `max contacts unlink` отменяет это.
  Что учесть: `context` возвращает тексты сообщений, поэтому `permissions.messages: deny` его тоже
  запрещает.
- **`max store repair` чинит структуру архива, ничего не удаляя.** Таблицу другой формы он оставляет
  копией рядом с новой и называет её в ответе; `--dry-run` показывает, что будет сделано, и ничего не
  меняет. `max store copies delete <имя>` удаляет одну такую копию. См. [Архив](/llms.mdx/docs/ru/max/archive/content.md).
- **Поиск учитывает основы слов, если включить.** `max config set searchStemmers.cyrillic russian` и
  `searchStemmers.latin spanish` (или `english`) — настройка одна на весь архив, все профили и оба
  мессенджера. После неё нужен `max store reindex`.
- **`max flood clear` забывает запомненные ожидания и снимает удержание отправок.** Их видно в
  `max server status`, в новом поле `flood`. Что учесть: MAX пока не называет, сколько ждать, поэтому
  для личного аккаунта MAX там будет пусто; от частых входов по-прежнему защищает пауза входа, которую
  показывает `max doctor`. В MCP этой команды нет намеренно: агент не должен снимать ограничение.
- **У поиска три руководства.** [Поиск сообщений](/llms.mdx/docs/ru/max/search/content.md) — поиск на каждый день по словам,
  людям, датам, файлам, ссылкам и меткам; [поиск по темам](/llms.mdx/docs/ru/max/topic-search/content.md) — беседы, векторы и
  что уходит внешней модели; [язык запросов](/llms.mdx/docs/ru/max/query-language/content.md) — справка.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-69]

- **Поиск по смыслу у локальной e5-small отбрасывает слабые совпадения до объединения со словами.**
  Косинусная близость должна быть выше 0,80; совпадения по словам остаются. Выдача может быть короче,
  а результат, найденный обоими способами, может стать только совпадением по словам.
- **Архив получает таблицы текста вложений и согласий на анализ.** Это локальная миграция при первом
  открытии; старые сообщения сохраняются. Перед обновлением большого архива сделайте резервную копию.

- **Архив теперь хранит каждый удачный запрос `messages search` и `messages stats` — и из командной
  строки, и из MCP.** Хранятся сам запрос и опции, но не найденные сообщения; последние 1000 запусков.
  Почему: из этой истории работают `searches history` и `--saved`.
  Что учесть: если запросы не должны оставаться на диске, запускайте с `--no-record` или поставьте
  `max config set record false`; `max searches clear` стирает историю, сохранённые запросы остаются.
- **При первом запуске архив переходит на новую схему.** Появляются таблицы меток, сохранённых
  запросов и основ слов, `max store migrate` достраивает индекс основ для старых сообщений. Что учесть:
  на большом архиве `store migrate` и `store reindex` идут дольше прежнего. Архив общий с `tg`, и
  прежние версии `max` и `tg` продолжают его открывать.
- **`max inbox`, `inbox --new`, `review` и `chats list --unread` (а также `--search` и `--kind`)
  смотрят все чаты, которые MAX прислал при входе, а не только 200 самых свежих.** Раньше чат с
  непрочитанным ниже по списку пропускался молча. По-прежнему обрабатывается не больше 20 чатов за
  запуск, остальные названы в заметке `skipped N chats`. Что учесть: `partial: true` теперь значит
  только одно — MAX прислал при входе не все чаты.
- **`max chats list` говорит `hasMore: true` на последней непустой странице, если MAX прислал не все
  чаты.** Раньше список выглядел полным. Что учесть: скрипт, который листает до `hasMore: false`,
  остановится на пустой странице.
- **`max messages list` и `max store fetch` больше не принимают короткую страницу за начало чата.** MAX
  не сообщает, есть ли сообщения старше, а страница может прийти короче `--limit` и в середине
  переписки. Теперь после короткой страницы `max` запрашивает одно более старое сообщение: если оно
  есть, `hasMore: true`, если нет — это начало чата. Что учесть: это один лишний запрос к MAX на каждую
  короткую страницу, и `hasMore` чаще бывает `true`.
- **`max config set` и `config unset` принимают `searchStemmers.cyrillic` и `searchStemmers.latin`, а
  `config show --json` показывает их в новом поле `storeSettings`.** Эти настройки хранятся в архиве,
  а не в файле настроек, поэтому `--defaults`, `--personal` и `--bot` с ними отказывают, а под
  `MAX_PROFILE_LOCK` их менять нельзя.

### Исправлено [#исправлено-58]

- Ошибка в файле правил автоответов больше не выводит фрагменты этого файла в журнал службы.

- **`max mcp --http`: Claude и ChatGPT теперь могут завершить вход.** Страница входа заставляла браузер отправлять
  форму как будто ниоткуда, и `max` отвечал «Origin not allowed». Теперь вход работает (cli-messaging 0.152.0).

- **Ссылка на сообщение из другого аккаунта больше не открывает одноимённое сообщение текущего.**
  `messages show/context` отказывает; MCP принимает `offline: true` для обычного локального контекста.

- **Строгий поиск по регулярному выражению `text:/…/` находит слова так же, как поиск по словам.**
  Раньше `text:/Квартир.*/` или `text:/счёт/` не находили слова, которые есть в архиве, из-за регистра
  и буквы «ё». `body:` по-прежнему различает регистр.
- **Ошибки строгого поиска говорят, что делать.** `~` подсказывает `--language legacy` и `слово*`;
  слишком короткий префикс вроде `к*` называет предел в 10 000 слов и просит префикс длиннее;
  `index_not_ready` говорит, сколько индекса готово, и точную команду `max store migrate`.
- **MCP не пишет историю поиска, если запись выключена.** Раньше `record: false` выключал историю
  только в командной строке.
## 0.28.0 — 04.10.2026 [#0280--04102026]

### Что нового [#что-нового-69]

- MCP `max_chats_stats` считает активность группы или канала из локального архива; вступления и выходы
  не запрашиваются. `max chats members audit` показывает признаки подозрительных участников, никого не удаляя.
- MCP `max_inbox` и `max_review` принимают `kinds` и `new` с отдельными от CLI отметками по чатам.

- **`max messages stats` считает сообщения из локального архива по чату, отправителю, дню или часу.**
  Запрос использует строгий Lucene; без него считаются все сохранённые сообщения текущей учётной
  записи. Сеть не используется, `--source max` явно включает другие профили. В неполном архиве
  результат остаётся нижней границей; проверьте `coverage` и `completeness`.
- **`max mcp --http --public-url https://<имя>.ts.net` открывает `max` для ChatGPT и Claude в браузере.**
  Инструменты MCP отдаются на `127.0.0.1` за вашим собственным туннелем, со своим входом: приложению нужен
  одноразовый код, который `max` печатает в терминале. Каждое изменение сначала спрашивает через форму в
  приложении. Вход действует 30 дней; `max mcp --revoke` завершает все. [Страница о подключении из браузера](/llms.mdx/docs/ru/max/remote/content.md) заменяет
  схему со сторонним прокси.

- Личный MCP использует общий с Telegram набор схем: устройства, поиск контакта по телефону,
  папки, участники, приглашения, настройки группы, опросы, локальные доказательства и беседы.
  Топики Telegram в MAX не поддерживаются. Старые имена проверки и правил группы сохранены.
- Подтверждённая отложенная отправка использует время из формы, даже если ответ пришёл позже.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-70]

- `coverage.inventoryComplete` теперь отражает получение полного списка чатов, а `lastSyncedAt` — старейшую
  загрузку в охвате; записи `completeness` содержат `fetchedAt`. Существующий архив получает эти сведения
  после следующего полного списка и загрузки истории. `/catch-up` принимает `kind` и `mode` вместо `since`.
- `config set permissions` отклоняет неизвестные команды, в том числе опечатки внутри целого объекта,
  с кодом 2. `config unset` позволяет их удалить; чтение существующего файла предупреждает и продолжается.

- Аргументы MCP приведены к общим именам: `at_time`, `md`, `since_time`, `before_n`, `after_n`,
  `unanswered`; `send_id` теперь строка. Неизвестные аргументы отклоняются до выполнения.
  Обновите вызовы по схеме из `tools/list`. У `max_inbox` и `max_review` параметр `all: true`
  включает чаты без звука и архив; без него остаются упоминания владельца.

### Исправлено [#исправлено-59]

- Поиск и статистика показывают фактический охват локального архива и время последней загрузки.
  `wordsReady` больше не обещает готовый словесный индекс для поиска только по фильтрам или regex.
  `store fetch` игнорирует отметку начала истории, если в архиве обнаружились более старые сообщения.
- `server status` сообщает код штатного завершения службы и причину остановки без повторного запуска.

## 0.27.0 — 04.10.2026 [#0270--04102026]

### Что нового [#что-нового-70]

- **Глобальная установка через npm настраивает Windows PATH и навык агента.** Пакет сохраняет
  существующие записи PATH и делает `max` доступным в новых терминалах. Уже работающему агенту
  нужно обновить своё окружение. Навык устанавливается до входа; `MAX_INSTALL_AGENT=none`
  отключает его установку. Локальная установка и npx окружение пользователя не меняют.

- **`max commands messages search --json` описывает одну команду, а `max commands messages --json` — группу.**
  Агенту больше не нужно читать всё дерево перед каждой задачей; глобальные опции и коды завершения
  сохраняются. Слова после `commands` задают один путь, разные группы смотрите отдельными вызовами.
  Вызов без пути по-прежнему возвращает всё дерево.

- **`max messages link` и MCP `max_messages_link` возвращают locator сообщения из локального архива.**
  Сообщение проверяется в текущей учётной записи; locator другой учётной записи отклоняется.
  Личный MAX пока не предоставляет подтверждённый permalink: `url` равен `null`, причина указана
  в ответе. `--offline` не подключается к MAX. См. [сообщения](/llms.mdx/docs/ru/max/usage/content.md).

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-71]

- **CLI и MCP используют `permissions` с уровнями `deny`, `readonly`, `ask`, `allow`.**
  Один набор прав действует для команд и агентов. Большинство записей через MCP теперь доступно
  по умолчанию; удаление сообщений и завершение других сессий требуют подтверждения, если не задан
  явный `allow`. Например, `messages: readonly` и `messages.delete: allow` разрешают чтение и
  удаление без вопроса, запрещая другие записи в сообщения; остальные ресурсы не ограничиваются.
  Перед обновлением проверьте права агента и задайте `readonly` или `deny` нужным ресурсам.
  `--confirm-send` требует форму перед каждой записью; в JSON-режиме `ask` требует явного флага.

- **`config migrate` переводит старые настройки доступа и уровни правил модерации.**
  `--dry-run` показывает изменения без записи; миграция сохраняет действовавшие уровни, настройки
  MAX и сохранённые места проверки групп. После появления `permissions` менять `readOnly`, `allow`
  и `mcpTools` нельзя. Старые MCP-флаги `--allow-send`, `--allow-mark-read`, `--allow-delete`,
  `--allow-moderate` пока принимаются с предупреждением, но не дают прав. Список получателей и
  лимит в час продолжают действовать. См. [настройки](/llms.mdx/docs/ru/max/configuration/content.md) и [MCP](/llms.mdx/docs/ru/max/mcp/content.md).

### Исправлено [#исправлено-60]

- **Параллельное открытие локального архива ждёт краткую блокировку SQLite при запуске.**
  Раньше настройка журнала могла встретить занятую базу до включения ожидания и отказать сразу.
  Длительная блокировка по-прежнему завершается ошибкой; изменение не запускает загрузку истории.

## 0.26.0 — 03.10.2026 [#0260--03102026]

### Что нового [#что-нового-71]

- **`max skill show link-conversations` печатает общий навык связывания разговоров.**
  Команда доступна без сессии; без имени по-прежнему выдаётся основной навык MAX.

- **`max messages evidence` выдаёт ограниченный пакет из локального архива**, с locator,
  сведениями о полноте и продолжением через `--before-id`. Команда не подключается к MAX.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-72]

- **Скачанные фото получают расширение по HTTP MIME**, например `.webp` для WebP,
  а не JPEG по типу вложения. Исходные имена файлов сохраняются; лишних предварительных запросов нет.

- **`max account show` использует общий формат аккаунта с Telegram.** JSON добавляет
  `username: null`; прежние поля MAX, маскирование номера и `--show-phone` сохраняются.

- **`max sends list` учитывает настроенный `limit`, как Telegram.** Раньше без флага всегда
  выбирались 20 попыток. Поле JSON `limit` содержит выбранный предел;
  `items`, `page`, `hasMore` сохраняются. `--limit` имеет приоритет над настройкой.

- **`max messages download` поддерживает `--all`, `--output-dir` и `--pause`, как Telegram.**
  Каталог создаётся автоматически; повторный обход всего чата продолжает сохранённый прогресс.
  `--output` остаётся совместимым именем каталога. JSON одного сообщения теперь содержит `{items}`,
  без искусственных `page`, `limit`, `hasMore`; скриптам следует читать `items`.
  Для голосовых поле `kind` теперь `voice`, как Telegram, вместо прежнего `audio`.
  Файлы скачиваются потоком с прежними проверками адресов и размера; голосовые сохраняют предел 32 MiB.

### Безопасность [#безопасность-16]

- **`max contacts lookup` не повторяет номер, ошибочно переданный аргументом.**
  Команда отказывает до запроса номера и подключения; номер следует вводить по запросу или через stdin.

### Исправлено [#исправлено-61]

- **`messages list`, `inbox` и `review` с `--transcribe` скачивают запись через соединение чтения.**
  Раньше открывался второй вход в MAX. Запись скачивается до закрытия соединения, а локальное
  распознавание запускается после закрытия. Без явного `--mark-read` ничего не отмечается прочитанным.
- **`review --unanswered` учитывает сохранённые и новые расшифровки голосовых вопросов.**
  Раньше вопрос с пустым текстом отбрасывался до расшифровки. То же исправление действует в MCP;
  исходный текст сообщения не меняется, а нераспознанные записи оставляют обзор неполным.

- **`max chats show` объясняет расхождение числа участников корректно.** Список может
  исключать собственный аккаунт или быть неполным; команда показывает оба числа без утверждения
  об ошибке загрузки. JSON и исходный список участников сохраняются.

- **Отказ `poll.already.voted` объясняет смену голоса.** Если опрос разрешает её, сначала
  выполните `polls vote <chat> <message> --retract` в том же профиле, затем выберите новый ответ.

- **`max messages download --timeout` закрывает и HTTP-поток вложения.**
  Раньше после таймаута команды он мог продолжать скачивание до отдельного лимита зависания;
  теперь adapter close отменяет свои потоки, а незавершённый файл удаляется.

## 0.25.0 — 03.10.2026 [#0250--03102026]

### Что нового [#что-нового-72]

- `bot api` использует общий с Telegram конструктор команд и проверку входных данных.
  Генераторы остаются в cli-core; параметры, нативные ответы и действующие разрешения MAX
  сохранены. Общая опция `--store-token <profile>` предназначена для операций, возвращающих
  учётные данные; остальные операции её отклоняют.

### Исправлено [#исправлено-62]

- **`messages list`, `inbox` и `review` с `--transcribe` скачивают запись через соединение чтения.**
  Раньше открывался второй вход в MAX. Запись скачивается до закрытия соединения, а локальное
  распознавание запускается после закрытия. Без явного `--mark-read` ничего не отмечается прочитанным.
- **`review --unanswered` учитывает сохранённые и новые расшифровки голосовых вопросов.**
  Раньше вопрос с пустым текстом отбрасывался до расшифровки. То же исправление действует в MCP;
  исходный текст сообщения не меняется, а нераспознанные записи оставляют обзор неполным.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-73]

- **`max models audio list --json` добавляет `directory`:** общий каталог моделей, который
  используют MAX и Telegram. Команды моделей, каталог и проверка скачивания теперь общие;
  существующие файлы, порядок моделей и настройка `transcribeModel` сохраняются. Повторно
  скачивать модели не нужно. JSONL по-прежнему выдаёт одну модель на строку.

- **`--md` разбирает собственный форматтер MAX** для send/edit и подписей: вложенные стили, `__жирный__`, `++подчёркнутый++`, ссылки и код. Боты поддерживают выделение, заголовки и цитаты через безопасный HTML; личный протокол явно отказывает неподтверждённым типам. Telegram имеет другой синтаксис. Неизвестные wire-типы больше не отправляются молча.

## 0.24.0 — 03.10.2026 [#0240--03102026]

### Что нового [#что-нового-73]

- **`max setup` проводит через первый запуск личного аккаунта:** проверяет локальные каталоги,
  предлагает QR-вход, проверяет аккаунт и до пяти чатов и подключает навык выбранного агента.
  Повторный запуск использует существующую сессию. История скачивается отдельно; setup не
  запускает фоновый сервис. Справка, установка и инструкция для агента объясняют следующие шаги
  и запуск на Windows без PATH. `max skill show` доступен до входа.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-74]

- **`max chats check` заменён на `max chats moderate`:** общие правила и модерация с Telegram.
  `--since-time` принимает время или `30m`/`2h`/`1d`, вместо прежнего `--since` с номером сообщения;
  JSON теперь `{ chatId, rows }`. За запуск читается до 1000 сообщений.
  Уровни правил — `deny|readonly|ask|allow`; старые `forbid` и `flag|confirm` читаются как `deny` и
  `ask`. Сохранённое место проверки переносится из сессии в прежний файл правил, поэтому первый
  запуск продолжает с него. CLI и личный MCP используют одно место; имена MCP-инструментов
  и их флаги сохранены. Событие вступления по ссылке в `chats events` называется `join`.

- **`max upgrade --json` всегда содержит список `restarted`.** В MAX это пустой массив:
  политика запуска серверов при обновлении сохранена. Проверка версии и отсутствие обновления
  возвращают ту же форму ответа, что установка; прежние поля остаются. Скриптам с точной проверкой
  набора ключей нужно учесть добавленное поле.

- **Локальный поиск использует строгий профиль Lucene:** скобки, поля, диапазоны дат и
  `--timezone`, ограниченные шаблоны и regex. Префикс задаётся явно как `слово*`; прежний
  поиск с исправлениями доступен через `--language legacy`. JSON сообщает охват даже без
  результатов. Руководство и навык описывают миграцию; JS `--regex` выполняется в отдельном
  worker с пределами размера и времени.

- **`max commands --json` возвращает версию JSON-контракта в поле `contract`.** Значение `0`
  совпадает с Telegram CLI; прежние поля справочника сохранены. Скриптам, сравнивающим весь JSON
  с сохранённой строкой, нужно учесть новое поле; выбор отдельных полей менять не требуется.

- **Чтения групп используют общие опции и форматы.** `chats events` принимает `--since-time`
  вместо `--since` и `--type` вместо `--event`; граница — время, а не id сообщения. Событие
  создания теперь называется `create` вместо `new`. `chats members list` показывает страницу
  с `--limit`, `--page` и `--all`; для прежнего объёма добавьте `--all`. JSON больше не содержит
  `chatId` и `rolesKnown`, но роли, даты регистрации и последнего посещения остаются в строках.
  `chats inspect` возвращает `id`, `kind`, `title`, `username`, `participantsCount`, `description`
  и `member` вместо карточки с доступом, ссылкой и настройками. `member` и `username` равны
  `null`, когда MAX их не сообщает. Это единые чтения MAX и Telegram; обновите скрипты и фильтры.
  Предупреждения о неполном списке и неизвестных ролях сохраняются; никакое чтение не отмечает
  сообщения прочитанными. Подробнее: [группы](/llms.mdx/docs/ru/max/usage/content.md#%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D0%B8-%D0%BA%D0%B0%D0%BD%D0%B0%D0%BB%D1%8B).

- **Команды управления группами отвечают общим JSON с `operationId`.** `chats create`, `join`,
  `update` и `link reset` кладут карточку в `chat`; `leave` возвращает `chatId`. У `members add`
  теперь поля `added` и `notAdded`, у `members remove` — `removed`; у команд `admins` —
  `personId`, а при добавлении ещё и `rights`. Это единый формат операций MAX и Telegram;
  скриптам нужно обновить разбор результата. `link show` сохраняет прежний формат.
  Название и настройки по-прежнему меняются двумя запросами: если название или описание
  уже изменено, а запрос настроек не завершился, команда сообщает `outcome_unknown` и
  отмечает неполный результат в журнале. Прочитайте `chats show` перед повторной попыткой.
  Подробнее: [управление группами](/llms.mdx/docs/ru/max/usage/content.md#%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D0%B8-%D0%BA%D0%B0%D0%BD%D0%B0%D0%BB%D1%8B).

- **`max account update` и `max account sessions end` возвращают общий формат с `operationId`.**
  Изменение профиля отвечает `{operationId, account}` с полями `id`, `name`, `username`, `phone`,
  завершение сеансов — `{operationId, sessions}` вместо массива. Это единый формат операций
  MAX и Telegram; скриптам нужно читать данные из `account` либо `sessions`. Описание профиля
  больше не возвращается после изменения: его показывает `account show`. Номер телефона
  остаётся замаскированным; `sessions end` по-прежнему требует `--others --yes`.
  Для фото профиля теперь принимаются JPG, JPEG, PNG и WebP; GIF нужно преобразовать в один
  из этих форматов. Подробнее: [профиль и сеансы](/llms.mdx/docs/ru/max/usage/content.md#%D0%BA%D0%BE%D0%BD%D1%82%D0%B0%D0%BA%D1%82%D1%8B-%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8C-%D0%BF%D0%B0%D0%BF%D0%BA%D0%B8).

- **`max chats folders create|update|delete` возвращают `operationId` вместе с результатом.**
  Создание и изменение отвечают `{operationId, folder}`, удаление — `{operationId, folderId}`,
  вместо самой карточки папки. Это общий формат операций MAX и Telegram; скриптам нужно
  читать карточку из `folder` и использовать `folderId` после удаления. `update` без `--title`,
  `--add` или `--remove` теперь отказывается вместо повторной записи той же папки.
  Список папок сохраняет прежний формат. Подробнее: [папки](/llms.mdx/docs/ru/max/usage/content.md#%D0%BA%D0%BE%D0%BD%D1%82%D0%B0%D0%BA%D1%82%D1%8B-%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8C-%D0%BF%D0%B0%D0%BF%D0%BA%D0%B8).

- **`max contacts add|remove|block|unblock|rename|import` возвращают общий формат с `operationId`.**
  Добавление и переименование отвечают `{operationId, person}`, удаление и блокировка —
  `{operationId, personId}`, импорт — `{operationId, sent, recognised}`. В `recognised` теперь
  карточки людей (`id`, `name`, `username`), которые MAX вернул, вместо номеров телефонов; если
  карточек нет, список пуст. `sent` считает строки файла, включая повторяющиеся номера.
  Это единый формат операций MAX и Telegram; скриптам нужно обновить разбор ответа.
  Ошибка номера, отклонённого MAX, больше не указывает строку файла; ошибка структуры строки
  по-прежнему указывает её номер. Подробнее: [контакты](/llms.mdx/docs/ru/max/usage/content.md#%D0%BA%D0%BE%D0%BD%D1%82%D0%B0%D0%BA%D1%82%D1%8B-%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8C-%D0%BF%D0%B0%D0%BF%D0%BA%D0%B8).

- **Команда `max cache clear` удалена.** Все чтения и имена используют общую локальную копию;
  `max store clear --left --allow-dangerous` удаляет данные покинутых чатов. Удаления всей общей
  копии команда не предлагает. Старый файл не переносится и не открывается; его путь показывает
  `max doctor`, а историю можно заново скачать через `max store fetch`.

### Исправлено [#исправлено-63]

- **`max conversations embed status` точнее оценивает время для e5-small.** Расчёт использует
  измеренные 31 фрагмент/с вместо 15; на ноутбуке из измерения прежняя оценка была вдвое длиннее.
  Реальное время зависит от компьютера и длины текста. Три рабочих потока дают измеренные
  1,04–1,1× при заметном расходе памяти; распределение потоков не менялось.

- **`max_messages_search` через MCP сохраняет сведения об охвате архива и использует параметры
  того же поиска, что CLI.** Доступны `language`, `timezone`, versioned `ast`, имя чата и фильтры
  `source`, `newest`, `context`. Запрос из одного символа допускается стандартным профилем.
  Раньше часть параметров отсутствовала, а ответ терял `query`, `coverage` и `completeness`;
  пустая выдача не объясняла охват локальной копии. Прежние поля ответа и имя инструмента сохранены.

- **`max runs list --limit` предлагает увеличить лимит, если показаны не все записи.**
  Подсказка не предлагает отсутствующую опцию `--page`. Чтение списка и отдельной записи
  не создаёт нового запуска; JSON-список по-прежнему содержит `hasMore`.

- **`chats show` показывает записанную группу, даже если её нет в последней дельте входа.**
  Раньше чтение могло закончиться ошибкой «нет чата». Неизвестные настройки и ссылка теперь
  остаются пустыми; чтение ничего не меняет в группе.

- **`max messages transcribe` находит сохранённую расшифровку и по имени чата, когда модель не скачана.**
  Раньше команда искала текст по введённому имени вместо id чата и предлагала скачать модель заново.
  Полное имя и его однозначный фрагмент теперь возвращают сохранённый текст без скачивания записи
  и повторного распознавания. Подробнее: [голосовые сообщения](/llms.mdx/docs/ru/max/usage/content.md).

- На Windows генератор использует Node вместо прямого запуска `.cmd`; проверки документации
  распознают пути Windows. Тесты Unix-прав не требуют их от Windows, где доступ задаётся ACL.

- **Ошибки `max bot` до запуска действия учитывают настройки записи bot-профиля,
  даже если перед командой указан `--timeout`.** Раньше при глобальной опции перед `bot`
  могли применяться настройки личного аккаунта. Если запись выключена для bot-профиля,
  ошибка разбора команды теперь не создаёт запись вопреки этой настройке.

## 0.23.0 — 03.10.2026 [#0230--03102026]

### Что нового [#что-нового-74]

- **`max serve` и команды управления чатами сохраняют имена и чаты в общей локальной копии.**
  Старый кэш профиля больше не открывается. Полный список отмечает покинутые чаты;
  пустой ответ сохраняет предыдущий список.

- **Команды контактов и общие команды чтения сохраняют данные в общей локальной копии.**
  Поиск человека по имени и `contacts sync` больше не требуют старого кэша профиля; синхронизация
  по-прежнему возвращает только счётчики. Удаление старого файла не сбрасывает точку синхронизации;
  чтобы получить полный список заново, выполните `max contacts sync`.

- **`max mcp` отпускает модель поиска через 10 минут без поиска** — `conversations_search` у агента
  больше не держит около 1 ГБ памяти всю сессию. Следующий поиск загрузит модель снова, примерно за
  секунду (cli-messaging 0.110.0).
- **Автодополнение чатов и людей берёт подсказки из общего хранилища выбранного аккаунта.**
  Старый кэш больше не нужен. Tab по-прежнему не подключается к MAX; команды бота предлагают
  чаты из своего локального списка.
- **`max mcp setup codex|claude-code` и `max mcp doctor`** добавляют локальный MCP в выбранный
  клиент и проверяют запуск и список инструментов. Если профиль предлагает запись, установка
  требует `--allow-writes`; это подтверждение не меняет права и не проверяет вход в MAX.
- **`max <бот> bot store fetch <чат>`** — скачать историю чата в локальную копию бота, новые сначала;
  повторный запуск продолжает. `--last`, `--since-time`, `--limit`, `--page-size`, `--pause` — как у
  `max store fetch`.
- **`--yes` для любой команды** — согласие на вопрос, который уровень `ask` задаёт перед записью;
  `max account sessions end --others --yes` работает как раньше.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-75]

- **`messages send --topic` и `polls create --topic` возвращают понятный отказ для MAX.**
  Это общая опция адресации тем Telegram, которых MAX не поддерживает; сообщение или опрос
  при таком вызове не отправляется. Обычные вызовы без `--topic` работают как прежде.

- **`max doctor --json` сообщает об общем хранилище в `store`, а старый файл — в `legacyCache`.**
  Проверка больше не открывает старую локальную копию и не проверяет её схему.
  Скриптам, которые читали `cache`, нужно перейти на `store`; старый файл можно удалить вручную,
  а историю снова получить через `max store fetch`.
- **MCP читает общую локальную копию сообщений.** Поиск, контакты, ресурсы чатов и расшифровки
  используют `messages.db` под аккаунтом профиля; отдельный кэш профиля больше не открывается.
  Чтение истории сохраняет сообщения для последующего поиска. Голосовые вложения в ответах
  чтения имеют `kind: "voice"`. Имена инструментов и их параметры прежние.
- **`inbox` и `review` используют общий формат команд и сообщений.** Вместо `--since` укажите
  `--since-time`; `review --unanswered` принимает длительность с единицей (`4h`, `1d`), а не число
  часов. Голосовые вложения в JSON имеют `kind: "voice"` вместо `"audio"`; есть `--all` для тихих и
  архивных чатов. Проверка входящих переносит прежнюю точку `inbox --new` при первом запуске.
  Обзор читает историю страницами назад и показывает не больше 300 сообщений на чат, отмечая
  неполный результат. Обновите команды в скриптах и проверки JSON.
- **Расшифровки личного аккаунта сохраняются в общей локальной копии сообщений.**
  `messages transcribe`, `inbox`, `review` и MCP используют тот же текст, что `messages list`,
  под тем же аккаунтом. Старые расшифровки из отдельного кэша профиля не переносятся: при следующем
  явном запросе с `--transcribe` они создаются заново; модель должна быть скачана.
- **`max <бот> bot people show` теперь `max <бот> bot contacts show`**, инструмент MCP —
  `max_bot_contacts_show`. Вместе с `bot messages search|between` команды общие с `tg`; опции и ответы
  прежние.
- **`max <бот> bot chats check` теперь `max <бот> bot chats moderate`** — имя и команда общие с
  `tg`. `--since` теперь `--since-time` (ещё принимает `2h`, `1d`); ответ `--json` — `{ chatId, rows }`
  вместо списка; инструмент MCP — `max_bot_chats_moderate`. Правила и точка прошлой проверки остались в
  тех же файлах. Уровень согласия `flag` теперь значит то же, что `confirm`: спросить вас, а с
  `--allow-dangerous` — сделать.
- **`max <бот> bot mcp` даёт агенту то, что разрешает профиль бота**, а не флаги. Без флагов агент
  теперь может и писать от имени бота, если у профиля нет `readOnly: true` или `allow`; удаление —
  после вашей формы, `--allow-dangerous` её убирает. `--allow-send`, `--allow-delete` и
  `--allow-moderate` принимаются с предупреждением и ничего не решают. Чтобы осталось только чтение,
  поставьте профилю бота `readOnly: true`. Сервер теперь общий с `tg`.
- **`max bot messages search` ищет по словам, лучшие совпадения сверху** — раньше искал кусок текста
  и показывал новые сверху; прежний порядок — `--newest`. Нужны все слова; работают `"фраза"`, `-слово`,
  `а OR б` и фильтры `from:`, `chat:`, `after:`, `before:`, `has:`; опечатка исправляется (об этом —
  строка в stderr). Слова можно писать без кавычек. `--from` по-прежнему можно повторять. `in:` в
  поиске бота не работает: бот ищет только в своей копии и в копиях, разрешённых `readOtherBots`.

### Исправлено [#исправлено-64]

- **При отказе в записи бот называет действующую команду настройки с `--bot`.** Если профиль
  только для чтения, подсказка предлагает выключить `readOnly`; если действие отсутствует в `allow`,
  предлагает добавить его, сохранив уже разрешённые действия. Раньше называла несуществующий `bot config`.

## 0.22.0 — 02.10.2026 [#0220--02102026]

Большая часть команд личного аккаунта теперь общая с tg: те же опции, те же ответы `--json`, одна
общая локальная копия. Поэтому многое переименовано — смотрите «Изменено — может сломать скрипты».
Прежняя локальная копия max в общую не переносится: после обновления запустите команды без
`--offline`, а историю скачайте заново через `max store fetch`.

### Что нового [#что-нового-75]

- **`max conversations search "<запрос>"`** — разговоры, близкие по смыслу, в одном чате или во всех.
  Сначала один раз `max models text download e5-small` (135 МБ, общая папка с `tg`), потом
  `max conversations embed --chat <чат>` считает векторы на этом компьютере; `embed status` — сколько
  осталось, `embed clear` — стереть. С `--provider openai` и своим ключом (`max models text key set
  openai`) векторы считает внешний сервис — `embed` сначала называет число токенов и цену и ждёт «да».
- **У личного чата в `chats list --json` есть `providerMetadata.partnerId`** — id собеседника. По нему общие
  команды узнают человека за личным чатом: у MAX id чата и id собеседника разные.
- **`max messages search` ищет и в других аккаунтах общей копии**: `in:max`, `in:personal`,
  `in:bots`, `in:all` в запросе или `--source`. Без них — как раньше, в аккаунте, от которого
  запущена команда.
- **`max conversations build|list|show` и `max messages links`** — разговоры внутри группы, найденные в
  локальной копии по ответам, упоминаниям и тому, кто написал следом; MAX не спрашивается. **`conversations
  batches status|next` и `conversations links add|clear`** — пачки для вашего агента и его ответы.
- **`max server logs`, `max server install`, `max server uninstall`** — как в tg. `install` пишет службу
  systemd (Linux) или launchd (macOS) для профиля и ничего не запускает; дальше `max server start`
  и `stop` идут через неё. Если MAX не принял вход, служба сервер не перезапускает: каждый повтор
  был бы новым входом в аккаунт. `max server start --idle` и `restart --idle` остаются.
- **`max store status`** — сколько сообщений каждого чата хранится и какие куски скачаны целиком.
  **`store fetch --background`** и **`store jobs list|show|cancel`** — скачивание в фоне.
  **`store info|check|migrate|backup|restore|reindex`** — уход за файлом общей копии. **`store clear --left
  --allow-dangerous`** удаляет из неё чаты, из которых вы вышли, с их сообщениями.
- **`max bot auth`, `max bot list`, `max bot chats list`, `max bot recipients` и `max bot sends list`
  теперь общие с tg** (cli-messaging): ответы и подсказки те же. Токен, список получателей и журнал
  лежат там же, где лежали.
- **`max cache clear --left`** стирает из локальной копии профиля только чаты, из которых вы вышли,
  вместе с их сообщениями. Остальная копия не трогается.
- **`max messages search --regex`** — одно регулярное выражение по всему сохранённому тексту.
  **`messages show|context msg:…`** — сообщение по ссылке из `search`, без id отдельно.
- **`max polls show <чат> <сообщение>`** — опрос с id вариантов и числом голосов, ничего не меняя.
- **`max polls create --send-id`** — повторить создание опроса, ответ на которое не пришёл, без
  второго опроса.
- **`max messages send --photo <путь>`** — отправить `.jpg .png .webp` фотографией, как в tg.
  `--no-preview` у `send` тоже есть, но MAX его не поддерживает, и команда откажет.
- **`max skill install`** ставит навык для агентов одной командой: в `~/.claude/skills/max-cli/`
  для Claude Code и в `~/.agents/skills/max-cli/` для Codex и Gemini CLI, с номером версии `max`.
  `--for claude` или `--for agents` — только в одну папку. `max skill show` печатает то же, что раньше.
- **Агент узнаёт о навыке сам.** Если задана переменная `AI_AGENT` или `CLAUDECODE`, а навыка нет
  или он старше `max`, раз в сутки в stderr выходит одна строка про `max skill install`. В stdout
  ничего не добавляется. Выключается `max config set skillHint false --defaults`.
- **`max mcp` и `max bot mcp` отдают навык ресурсом `max://skill`** и называют его в своих
  инструкциях для агента.
- **`max messages delete` отвечает с `operationId`** — номером этого удаления; тот же номер стоит в
  журнале отправок (`max sends list`). Инструмент MCP `max_messages_delete` отвечает так же. Сама
  команда и её опции не меняются.
- **У каждой записи в журнале отправок есть `operationId`** — номер одного действия. Все строки об
  одной отправке, правке, удалении или изменении чата несут один и тот же номер, так что по нему
  видно, чем действие кончилось. У отправки сообщения это её `sendId`.
- **Установка легче примерно на 16 МБ**: слой базы данных теперь встроен в пакет, а не ставится
  отдельно. Команды `max` не меняются.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-76]

- **`max messages search` ищет по словам, лучшие совпадения первыми** — раньше самые новые первыми,
  теперь для этого `--newest`. В запросе работают `"фраза"`, `-слово`, `OR` и фильтры `from:`, `chat:`,
  `after:`/`before:` и `has:`. Опечатка исправляется, и об этом пишется в stderr. `--context <n>`
  показывает сообщения вокруг каждого совпадения. В JSON у каждого совпадения появились `match` и `score`.
- **`max bot updates watch` теперь `max bot watch`**, как в tg и как личный `max watch`. Без `--events`
  печатаются только новые сообщения, с `--events` — всё, и каждая строка называет своё событие
  (`{ "event": "message" | "edit" | "delete" | "callback" | "joined" | … }`) вместо сырого события MAX.
  `--timeout` завершает его обычным образом, с кодом `0`. Профилю бота «только чтение» `watch` теперь
  разрешён: получать события — это чтение. Отметка, с которой продолжать, осталась прежней.
- **`bot webhooks list` отвечает `{ url, types }`**, а не полями MAX. `bot callbacks answer --text`
  больше не читает текст из stdin по `-`. `bot commands`, `bot callbacks` и `bot webhooks` теперь
  общие с tg; секрет `webhooks set --secret-stdin` спрашивается только после проверки прав.
- **Нужен Node 22.16 или новее** (или Bun, как раньше). Если Node на Linux взял системный SQLite,
  а тот слишком стар для локальной копии, `max` перезапускается на своём SQLite из
  `@wirecat/cli-messaging-sqlite` до того, как что-то прочитать или отправить. Официальные сборки
  Node и Bun ничего не замечают.
- **`max store` — общая группа команд tg и max.** `store fetch` пишет в общую локальную копию, ту же,
  что у tg, и листает MAX как раньше: по 30 сообщений, 5–10 с между страницами, до 40 страниц за
  запуск.
  Почему: одна копия и одни команды для обоих мессенджеров; `messages`, `conversations` и `store`
  читают одно и то же.
  Что учесть: копия, которую max вёл раньше, не переносится — историю скачайте заново. Кроме того:
  - `store fetch --estimate` для MAX отказывает: id сообщений MAX не позволяют сосчитать, сколько
    не хватает;
  - `store fetch|export --since` теперь `--since-time`, и только время, не id сообщения;
  - `store fetch --max-pages <n>` теперь `--limit <сообщений>` (по умолчанию 1200, то есть 40 страниц
    по 30); размер страницы — `--page-size`;
  - `store export --format md` теперь `--format markdown`; `jsonl` как был. Выгрузка больше не
    перечисляет в stderr куски, которых нет в копии, — их показывает `store status`; существующий
    файл она не перезаписывает;
  - `store fetch` в конце не печатает готовую команду выгрузки.
  - если два сообщения отправлены в одну и ту же миллисекунду и граница страницы прошла между ними,
    `store fetch` может пропустить более раннее из них. Это редкость.
- **`max messages list|show|context|search` — общие команды tg и max.** `--offline` и `search`
  отвечают из общей локальной копии, той же, что у tg.
  Почему: те же опции и ответы, что у tg, и одна копия для чтения.
  Что учесть: инструменты `max mcp` для чтения сообщений и чатов пока читают прежнюю копию max, так
  что агент через MCP и команда в терминале с `--offline` могут ответить по-разному. Копия заполняется с первого запуска без `--offline` после обновления; прежняя копия max
  в неё не переносится — и с ней расшифровки голосовых, услышанных до обновления. Кроме того:
  - голосовое — вложение `"kind": "voice"`, а не `"audio"` (в `inbox` и `review` пока `"audio"`);
  - `messages list --before` и `--after` разделились на `--before-id`, `--before-time`, `--after-id`,
    `--after-time`, а у `messages context` — `--before-n` и `--after-n`, как в tg. Скрипт со старым
    именем получит ошибку «неизвестный параметр»;
  - `messages list --before-id` не включает само это сообщение; с `--offline` годится только
    `--before-id`, и только с id сообщения из локальной копии;
  - `messages list --transcribe --json` больше не отвечает полем `transcribeProblem`: причина — в
    stderr; с `--offline` `unheard` пуст. Голосовое скачивается на отдельном соединении — с
    `--no-serve` это второй вход в MAX;
  - модели речи `max` ищет в `~/.cache/cli-common/models/audio`, одной папке с tg; скачанную в
    `~/.cache/max-cli/models/audio` нужно скачать заново или перенести;
  - `messages search` ищет слова и их начала (`квартир` найдёт «квартира»), а не любые три буквы
    подряд; `--chat` принимает и имя сохранённого чата.
- **`max chats list|show` и `max contacts list|show` — общие команды tg и max.** Их `--offline`
  отвечает из общей локальной копии, той же, что у tg.
  Почему: те же опции и ответы, что у tg.
  Что учесть: копия заполняется с первого запуска без `--offline` после обновления; прежняя копия max
  в неё не переносится, и до того `--offline` ответит `not_found`. Кроме того:
  - `chats list --search|--kind|--unread` без `--offline` ищет в 200 самых свежих чатах и пишет в
    stderr, если были старше; с `--offline` — во всех сохранённых;
  - `chats show --offline` отвечает без `description`, `access` и `settings`: их знает только MAX;
  - неверный `--kind` отвергается другими словами: `--kind is one of dialog, group, channel, saved`;
  - `cache clear` забывает и то, что этот аккаунт хранит в общей копии, а `contacts sync` забирает
    всё и туда.
- **`max messages send|edit|forward` — общие команды tg и max.** Ответы `--json`: `send` —
  `{sendId, operationId, message}` (с `scheduledFor`, если с `--at-time`), `forward` — тоже
  `{sendId, operationId, message}`, `edit` — `{operationId, message}`, вместо сообщения без обёртки. Так же отвечают инструменты MCP
  `max_messages_send`, `max_messages_edit` и `max_messages_forward`; у `max_messages_edit` больше нет
  `markdown`, у `max_messages_forward` — `send_id`.
  Почему: те же опции и ответы, что у tg, и номер действия, как в журнале отправок.
  Что учесть: скрипт, который читал сообщение из корня ответа, теперь берёт его из `message`. У
  `send` больше нельзя приложить несколько `--file` к одному сообщению: одно вложение из `--file` и
  одно из `--photo`. Если отправка с `--at-time` не получила ответа, ошибка советует
  `messages scheduled`, не называя чат.
- **`max polls` — общие команды tg и max.** `polls vote|close --json` отвечают `{operationId, poll}`,
  где `poll` — `{chatId, messageId, question, answers: [{id, text, voters, chosen}], closed, multiple,
  anonymous, voters}`; `polls create` — `{sendId, operationId, message}`. Так же отвечают инструменты
  MCP `max_polls_vote`, `max_polls_close`, `max_polls_create`.
  Почему: те же ответы, что у tg.
  Что учесть: у `max_polls_create` вместо `revote` теперь `silent`.
- **Ответы `--json` у реакций, закрепления и отметки прочитанным — общие с tg**, и в каждом есть
  `operationId`, номер этого действия, как в журнале отправок:
  - `reactions add|remove`: `{operationId, chatId, messageId, reaction}` — ваша реакция или `null`,
    без счётчиков реакций на сообщении (их показывает `messages list`);
  - `messages pin|unpin`: `{operationId, chatId, messageId, pinned}`, где `pinned` — `true` или `false`;
  - `chats mark-read`: `{operationId, chatId, until}` — до какого сообщения, или `null`, если до
    последнего.

  Так же отвечают инструменты MCP `max_reactions_add`, `max_reactions_remove`, `max_messages_pin`,
  `max_messages_unpin`, `max_chats_mark_read`.
- **`max messages unpin <чат> <сообщение>`** — теперь нужен номер сообщения, как у `pin` и в tg.
  В чате MAX закреплено одно сообщение, и открепляется оно, какой бы номер ни был указан. Инструмент
  MCP `max_messages_unpin` тоже просит `message`.
  Что учесть: `messages unpin <чат>` без номера получит ошибку — добавьте любой номер сообщения этого
  чата.
- **`max serve --detach` и `max serve --stop` убраны**: это `max server start` и `max server stop`.
  Почему: `serve` — только работа на переднем плане, а фоновым сервером управляет `max server`, как в tg.
  Что учесть: замените их в скриптах и службах, написанных вручную.
- **`max server status --json` отвечает теми же полями, что tg**: `byHand` стал `by` (`hand` — руками,
  `command` — его запустила команда, `server` — `max server start`, `unit` — служба); добавлены
  `log`, `unit` и `stale` (сервер упал и оставил метку). `max server start`, `stop` и `restart`
  отвечают как в tg: `{ started, by, pid, startedAt, log }` и `{ stopped, by, pid }`; поля `socket`
  больше нет.
- **`max messages send --at` теперь `--at-time`** — как во всех командах tg и max, где опция
  принимает время. Скрипт с `--at` получит ошибку «неизвестный параметр» — замените на `--at-time`.
  Параметр `at` у `max_messages_send` в MCP не меняется.
- **`--markdown` больше нет, только `--md`** — в `messages send`, `messages edit` и везде, где
  разметка читается. Так названо во всех командах tg и max; скрипт с `--markdown` получит ошибку
  «неизвестный параметр» — замените на `--md`.
- **`max sends list --json`: поле `cid` → `sendId`, и это строка, а не число** — то же имя, что в
  ошибке `outcome_unknown` и у `--send-id`. Строки, записанные раньше, показываются так же.
- **Записи запусков (`--trace`, `--record`, `max runs show`) — в общем формате tg и max.** Номер
  отправки в событии называется `send`, а не `cid`; ключ отказа MAX — `providerError`, а не
  `maxError`, в событиях, в `run.json` и в `details` ошибки `--json`.
- **`max bot` отвечает `outcome_unknown` (код `14`), если на отправку или другое изменение пришёл
  ответ 502, 503 или 504.** Раньше это был отказ `provider_unavailable` (код `12`).
  Почему: такой ответ даёт шлюз перед MAX, и он не говорит, выполнил ли MAX запрос. Сообщение могло
  уйти.
  Что учесть: скрипт, который повторял изменение после кода `12`, мог отправить его дважды. После
  кода `14` сначала проверьте, выполнилось ли оно. Чтение по-прежнему повторяется само и отвечает
  `provider_unavailable`.
- **Команды бота — под общими с tg именами, старых имён нет.** `max bot messages get <сообщение>` →
  `messages show <чат> <сообщение>`; `messages edit|delete` тоже берут чат первым; `bot chats get` →
  `chats show`; `bot chats pin|unpin` → `messages pin|unpin <чат> <сообщение>`. `--format markdown|html`
  → `--md` или `--html`; `--type` больше нет: картинку — `--photo`, голосовое — `--voice`, видео файлом
  — `--as-file`. `chats action` берёт `typing`, `photo`, `video`, `voice`, `file`. Отправка и правка
  отвечают `{ operationId, message }`, а не сообщением. Удаление спрашивает подтверждение,
  `--allow-dangerous` отвечает «да». Инструменты MCP бота переименованы так же: `max_bot_chats_show`,
  `max_bot_messages_show`, `max_bot_messages_pin`, `max_bot_messages_unpin`.
- **`max bot members` и `max bot admins` теперь `max bot chats members` и `max bot chats admins`**,
  как в tg. `admins add` берёт `--can` со словами `max chats admins add` (`read`, `members`, `admins`,
  `info`, `pin`, `link`, `edit`, `delete`) вместо `--permissions`, и `--title` вместо `--alias`.
  Прав «звонки» и «статистика» в `--can` нет. `admins list` отвечает `{ id, name, username, role,
  rights, title }`. Инструменты MCP: `max_bot_chats_members_list|add|remove`, `max_bot_chats_admins_list`.
- **Команды, которые меняют только этот компьютер, теперь отмечены как записи.** `config set` и
  `unset`, `chats rules set` и `unset`, `recipients add`, `remove` и `clear`, а у бота `auth set` и
  `remove`, `chats rules set` и `unset`, `recipients add`, `remove` и `clear` пишут файл настроек,
  файл правил групп, списки получателей или связку ключей — и ничего в MAX. В
  [списке команд](/llms.mdx/docs/ru/max/commands/content.md) у них строка «Меняет что-то только на этом компьютере.», а
  `max commands` показывает их в колонке `writes`. Раньше они не были отмечены вовсе.
  Что учесть: агент или скрипт, который по `max commands --json` отбирает только чтение, теперь
  не увидит их среди безопасных команд.

### Исправлено [#исправлено-65]

- **`max store fetch` по времени больше не пропускает сообщение на границе страницы** и
  останавливается, если MAX раз за разом отдаёт одну и ту же страницу.
- **`max messages list --before-time` не показывает сообщение, отправленное ровно в эту миллисекунду**:
  «до» значит «раньше».
- **`max messages list --after-id` (в 0.21.0 — `--after <id>`) говорит, что есть следующая страница,
  когда она есть.** Раньше при чтении вперёд от сообщения команда всегда отвечала, что дальше ничего нет.
- **`max messages send --voice` теперь уходит и через `max serve`.** Раньше через сервер MAX
  отказывал (`proto.payload`, код `11`): полоска громкости голосового терялась по дороге. Без
  сервера (`--no-serve`) голосовое уходило и раньше.
- **`max chats list` и `max chats show` больше не показывают чаты, из которых вы вышли.** Раньше
  такой чат оставался в списке навсегда, с устаревшим числом участников. Теперь он исчезает при
  следующем входе, если max получил от MAX полный список ваших чатов; сообщения остаются в копии до
  `max cache clear --left`. `max serve` узнаёт о выходе только при следующем полном входе.
- **`max serve` больше не путает ответы после долгой работы.** Номер запроса занимает два байта и
  после 65 536 запросов начинается заново. Если запрос с тем же номером ещё ждал ответа, новый
  запрос мог получить чужой ответ. Теперь такой номер пропускается.

## 0.21.0 — 30.09.2026 [#0210--30092026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-77]

Команды названы по одному правилу: сначала предмет, потом действие. Старые имена больше не
работают — `max` отвечает «unknown command» или «unknown option» с кодом `1` и ничего не делает.

- **`max backup messages` → `max store fetch`.** Теперь команда **скачивает сразу**; только
  посчитать — `--estimate` (раньше наоборот: без `--run` только считала). Каждый запуск по-прежнему
  не больше `--max-pages` страниц (40) с той же паузой. `--pause` принимает длительность: `5s`,
  `500ms` — число без единицы теперь отказ. `--since` и `--last` необязательны: без них запуски идут
  до начала чата, каждый — с места, где остановился прошлый.
- **`max export messages` → `max store export`.**
- **`--cid` → `--send-id`** у `messages send` и `messages forward`. В ошибке `outcome_unknown`
  номер теперь в поле `sendId`; у инструментов MCP `max_messages_send` и `max_messages_forward`
  аргумент `cid` → `send_id`.
- **`max chats read` → `max chats mark-read`**; инструмент MCP `max_chats_read` →
  `max_chats_mark_read`.
- **`max chats settings` больше нет.** Настройки группы показывает `max chats show` (поля
  `settings`, `description`, `access`; ссылку-приглашение — по-прежнему `max chats link show`), меняет `max chats update <чат> --all-can-pin on|off`
  и остальные флаги настроек.
- **`max update` → `max upgrade`**, и строка о новой версии называет `max upgrade`.
- **`max recipients off` → `max recipients clear`**, в ответе `off` → `cleared`;
  **`max bot recipients off` → `max bot recipients clear`**.
- **`max account sessions end-others` → `max account sessions end --others`**; без `--others` —
  отказ.

### Что нового [#что-нового-76]

- **`max complete` виден в `max --help`** — чтобы найти, как включить дополнение по Tab.
- **Страница [«ChatGPT или Claude в браузере»](/llms.mdx/docs/ru/max/remote/content.md)** — через прокси со входом по
  паролю и публичный адрес Tailscale без своего домена. Схема собрана по документации этих
  инструментов и целиком не проверена.

## 0.20.0 — 30.09.2026 [#0200--30092026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-78]

- **Общее хранилище сообщений переходит на версию 6** (cli-messaging 0.49.0). Первый запуск `max`
  обновляет `messages.db`; после этого `tg` старше выпущенного в тот же день отказывается открывать
  файл и просит обновиться — `npm install -g @wirecat/tg-cli@latest`. Команды `max` не меняются.
- **`--all-bots` работает, только если боту разрешено читать других ботов.** Настройка
  `readOtherBots` в разделе `bot`: `max <имя> config set --bot readOtherBots true` — всех, или список
  профилей. Без неё команда отказывает с кодом `5` и называет, как разрешить.
- **Когда имя подходит нескольким людям, кандидаты перечислены по имени**, люди без имени — первыми;
  раньше — в том порядке, в каком лежали в кэше. Текст ошибки тот же.

### Что нового [#что-нового-77]

- **`--bots news,support`** у `bot messages search`, `bot people show` и `bot messages between` —
  прочитать копии только этих ботов, если `readOtherBots` их разрешает. `bot messages search`
  теперь понимает и `--all-bots`.
- **Агент через `bot mcp` получает `all_bots` и `bots`** у тех же трёх инструментов — только когда
  бот может читать других.
- **Люди — у каждого бота свои.** Человек, которого видел один бот, не находится у другого без
  `--all-bots` или `--bots`.
- **Поиск по тексту сообщений бота находит любые три буквы внутри слова** (`вартир` находит
  «квартиру»), как поиск личного аккаунта.

## 0.19.0 — 28.09.2026 [#0190--28092026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-79]

- **Агент через `max mcp` закрывает опрос, только если профилю разрешено `edit`.** Раньше хватало
  `reaction`.
  Почему: закрытие правит сообщение с опросом, и команда `max polls close` всегда требовала `edit` —
  агент и человек получали на одно действие разные права.
  Что учесть: если в `allow` профиля есть `reaction`, но нет `edit`, агент больше не видит инструмент
  `max_polls_close`; чтобы он мог закрывать опросы, добавьте `edit`. Если `allow` не задан, ничего не
  меняется. Подробнее — [MCP-сервер](/llms.mdx/docs/ru/max/mcp/content.md).

### Исправлено [#исправлено-66]

- **`max mcp --confirm-send` запускается, когда изменения аккаунта включены только настройкой
  `mcpTools`.** Раньше флаг требовал ещё одного из `--allow-*`, иначе сервер не запускался.
  Почему это важно: из-за этого сервер с одной `mcpTools` работал без формы подтверждения — агент мог
  добавлять и удалять контакты, создавать группы и менять профиль, не спрашивая вас.
  Что учесть: без `--confirm-send` всё как раньше. Чтобы видеть форму перед каждым изменением,
  добавьте флаг в команду запуска сервера.
- **`max <бот> bot messages search --limit N` говорит, что найдено больше.** Раньше в ответе всегда
  было `hasMore: false`, а в `limit` — значение из настроек, а не ваше `N`.
  Что учесть: скрипт или агент, который по `hasMore` решал, искать ли дальше, останавливался на первой
  странице и пропускал совпадения. Теперь он получит `hasMore: true`, когда совпадений больше `N`.

## 0.18.1 — 28.09.2026 [#0181--28092026]

### Исправлено [#исправлено-67]

- **После `max contacts rename` новое имя видно сразу** — в `contacts show` и в названии личного
  чата с этим человеком. Раньше там оставалось прежнее имя, пока фоновый `max serve` не входил в MAX
  заново: MAX присылает переименованный контакт в ответе, а сервер его не применял.
  Что учесть: если после переименования имя всё ещё старое, у вас работает сервер прежней версии —
  его заменит первая же команда 0.18.1.

## 0.18.0 — 28.09.2026 [#0180--28092026]

### Что нового [#что-нового-78]

- **Агенту можно разрешить менять аккаунт через `max mcp`.** Появились инструменты для контактов
  (добавить, удалить, переименовать, заблокировать), для закрытия своего опроса, для групп (вступить,
  выйти, создать, назначить и снять админа) и для имени и описания профиля. Раньше агент через MCP
  мог только читать и писать сообщения.
  Почему только в настройках: эти действия видят другие люди, и включить их должен владелец, а не сам
  агент — дописав флаг в свою же команду запуска.
  Что учесть: всё выключено, пока группа не названа в настройке `mcpTools`, например
  `max config set mcpTools contacts,polls`. Флагом это не включается. Каждое действие проходит те же
  проверки `readOnly`, `allow` и журнал, что и команда. Подробнее — [MCP-сервер](/llms.mdx/docs/ru/max/mcp/content.md).
- **Загрузка файла ботом видна в `--trace` и в записи запуска.** `bot messages send --file` и
  `bot uploads put` показывают загрузку двумя строками: вид файла, размер, HTTP-код и время. Раньше
  загрузка в запись не попадала.
  Что учесть: адрес загрузки и имя файла не пишутся — ни на экран, ни в запись.

### Исправлено [#исправлено-68]

- **`max contacts rename` переименовывает.** Раньше MAX отвечал «успешно», а имя оставалось прежним.
  Почему: без поля `lastName` MAX молча ничего не меняет. Теперь `lastName` уходит всегда (`null`,
  если фамилии нет) — так делает и веб-клиент.
  Что учесть: имена, «изменённые» через 0.17.x, на самом деле не изменились — переименуйте ещё раз.

## 0.17.1 — 28.09.2026 [#0171--28092026]

### Исправлено [#исправлено-69]

- **Ошибка в `--limit`, `--last` и `--max-pages` повторяет то, что вы набрали.** Это касается
  `messages list`, `inbox`, `backup`, `sends list` и команд бота. Раньше на `--limit abc` они называли
  введённое `NaN`; в 0.17.0 это исправили только у списков со страницами.
- **`runs list` и `sends list`, обрезанные по `--limit`, говорят `hasMore: true`.** Раньше в ответе
  было `hasMore: false`, а в `limit` — не то число, что вы просили.
  Что учесть: скрипт, который по `hasMore` решал, читать ли дальше, раньше останавливался на первой
  странице.
- **Контакт, которого вы переименовали, показывается под вашим именем**, как в приложении MAX. Раньше
  `max` показывал имя, которое человек дал себе сам, даже если вы переименовали его в `contacts
  rename` или в приложении.

## 0.17.0 — 28.09.2026 [#0170--28092026]

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-80]

- **Любой список в `--json` — объект `{items, page, limit, hasMore}`, а не массив.** Так теперь
  отвечают `account sessions list`, `chats members list`, `chats folders list`, `messages scheduled`,
  `messages download`, `messages context`, `models audio list`, `recipients list`, `sends list`,
  `runs list`, `chats check`, `chats events` и все списки бота. Раньше часть из них отдавала массив, а
  `chats events` — `{events, more}`.
  Почему: списки приходили в трёх разных формах, и скрипту или агенту приходилось помнить форму
  каждой команды.
  Что учесть: скрипт, который читал массив, теперь должен брать `.items`. У списка без страниц `page`
  равен 1, а `limit` — числу пришедших строк. `bot members list` и `bot admins list` кладут рядом
  `marker`, а `user_id` у них теперь строка. `bot messages get` отвечает самим сообщением, а не
  массивом из одного. `--jsonl` и таблица для человека не изменились. В MCP — то же самое.

### Что нового [#что-нового-79]

- **`max doctor` и `max config show` видят ботов.** Список профилей — все профили на этом компьютере,
  с пометкой: личный аккаунт, бот или оба. Раньше профили ботов в нём не появлялись.
  `doctor` показывает, откуда взят токен бота (без самого токена), сколько чатов бот видел и где
  лежат файлы профиля; `doctor --online` спрашивает у Bot API, чей это токен.
  Что учесть: для профиля бота `doctor` и личные команды больше не советуют `session start`, а
  называют нужную команду `max <имя> bot …`.
- **Инструменты `max_status` и `max_bot_status` в MCP.** Агент видит, за какой профиль говорит
  сервер, есть ли токен и какие пишущие инструменты включены. Они ничего не отправляют, а
  `max_status` даже не входит в MAX.
- **Дополнение по Tab знает о ботах.** Для команд бота оно предлагает чаты, которые видел бот, а не
  чаты личного аккаунта; в первом слове — все профили, в том числе профили ботов.
- **Команды бота записываются, как личные.** `max <имя> bot … --trace` показывает в stderr каждый
  запрос к Bot API: операцию, чат или сообщение, HTTP-код и время. `--record` сохраняет запуск, а
  упавший запуск бота сохраняется сам, вместе с запросами. Смотреть — `max runs list` и
  `max runs show`.
  Что учесть: загрузка файлов (`--file`) в эту версию записи ещё не попадала — это добавлено в 0.18.0.
- **Настройки отдельно для личных аккаунтов и для ботов.** В файле настроек появились разделы
  `personal` и `bot`, у каждого свои `defaults` и `profiles`. `max config set --personal|--bot`
  пишет в раздел, `max config show --bot` показывает настройки бота и называет ключ, из которого
  прочитано значение, например `config file: bot.profiles.test`.
  Почему: у одного человека бывают и личный аккаунт, и боты, и одни и те же правила им не подходят.
  Что учесть: побеждает самая точная запись — профиль в разделе, затем профиль, затем раздел, затем
  общие `defaults`. Прежний файл читается как раньше. Подробнее —
  [руководство по настройке](/llms.mdx/docs/ru/max/configuration/content.md).
- **У бота может быть лимит отправок в час.** `max <имя> config set --bot sendsPerHour 200` задаёт
  его. По умолчанию лимита у бота по-прежнему нет.
- **`max config set defaultProfile <имя>` — какой профиль берётся, если первое слово не профиль.**
  Раньше это всегда был `default`.
- **Фото профиля, своё имя для контакта, блокировка.** `max account update --photo <файл>` ставит
  новое фото профиля. `max contacts rename <кто> <имя> [фамилия]` даёт человеку имя, которое видите
  только вы. `max contacts block <кто>` и `unblock` блокируют и разблокируют — даже того, кого нет в
  контактах.
  Что учесть: всё проходит те же проверки, что `account update` и `contacts add`. В этой версии
  `contacts rename` на деле не менял имя — исправлено в 0.18.0.
- **Каналы.** `max chats create <название> --channel` создаёт закрытый канал.
  Что учесть: людей в канал зовут ссылкой-приглашением (`max chats link show`) — добавить человека
  напрямую MAX может не дать.
- **Права админа на чтение и на ссылку.** `max chats admins add <чат> <кто> --can read,link` даёт
  читать все сообщения группы и менять ссылку-приглашение.
  Что учесть: бот-админ без права `read` сообщений группы не видит.
- **Время можно задать как «столько назад».** `--since`, `--before` и `--after` понимают `30m`, `2h`,
  `1d`: `max review --since 1d`. Раньше нужно было писать точное время.

### Исправлено [#исправлено-70]

- **Ваше же изменение чата видно сразу.** После `max chats update`, `chats settings` и `chats link
  reset` команды `chats show` и `chats list` несколько минут показывали старое название.
  Почему: MAX не присылает ваше изменение обратно, а фоновый `max serve` не применял чат из ответа
  MAX. Теперь применяет — как уже делал с отправленными сообщениями.
- **`max export messages` не предупреждает о пропуске «до 1970-01-01» после полного `backup`.**
  Раньше выгрузка чата, прочитанного до самого начала, всё равно говорила, что начало не прочитано.
- **Ошибка в `--limit` и `--page` повторяет то, что вы набрали.** Раньше на `--limit abc` она
  называла введённое `NaN`.
- **Сброшенная ссылка-приглашение в `chats inspect` и `chats join` — ошибка «ссылка никуда не ведёт»**
  (`not_found`, код 6). Раньше это был непонятный отказ MAX с номером операции.
  Что учесть: скрипт, который ждал другой код выхода, теперь получит 6.
- **`max config show` и `max doctor` не показывают лишний профиль `<имя>.moderation`.** Раньше они
  принимали файл правил модерации группы за профиль.
- **Ошибка в подкоманде называет неизвестное слово, а не профиль.** Раньше `max work bot auth status`
  говорил, что `work` прочитано как имя профиля, хотя неизвестным было слово `status`.
- **`max config show` показывает `transcribeModel`** — модель распознавания речи. Раньше эта
  настройка не выводилась.

### Удалено [#удалено-2]

- **Заявки на вступление: `max chats requests list|accept|decline`, правило `requests` и уровни
  `consent.accept` и `consent.decline` в правилах группы.**
  Почему: в MAX группа либо открытая, либо в неё входят по ссылке-приглашению; одобрять новых
  участников негде, поэтому заявок не бывает. Команды обещали то, чего MAX не делает.
  Что учесть: файл правил, где эти ключи остались, читается как прежде; при следующей записи они из
  него уходят. Скрипт, который вызывал `chats requests`, получит ошибку «нет такой команды».

## 0.16.0 — 27.09.2026 [#0160--27092026]

### Что нового [#что-нового-80]

- **Люди и переписка бота.** `max <имя> bot people show <кто>` показывает, где человек писал, и его
  личный чат с ботом. `bot messages search --from <кто>` — что писал один или несколько человек.
  `bot messages between <кто> <кто>` — их переписка в чатах, где писал каждый.
  Что учесть: всё берётся из копии на этом компьютере, то есть только из того, что бот уже видел.
  `--all-bots` смотрит копии всех ботов.
- **Бот проверяет группу по её правилам.** `max <имя> bot chats check <чат>` сверяет новое в группе с
  правилами (`bot chats rules show|set|unset`) и действует от имени бота: удаляет сообщения и
  удаляет людей. Вступления берёт из `bot updates watch`.
  Что учесть: удалённый человек не сможет вернуться по ссылке-приглашению, если не указан
  `--no-ban`; снять этот запрет через Bot API нельзя. Возраст аккаунта через Bot API не виден, и
  правила о нём здесь не срабатывают.
- **Опросы.** `max messages list` показывает опрос словами: вопрос, варианты с id в `[скобках]`,
  голоса и ✓ у вашего варианта. `max polls vote <чат> <сообщение> <вариант>…` голосует, `--retract`
  снимает голос, `max polls close` закрывает свой опрос, `max polls create` создаёт новый. В MCP —
  `max_polls_vote` и `max_polls_create`, только с `--allow-send`.
  Что учесть: что отказал бы веб-клиент — закрытый опрос, лишние варианты, второй голос без права
  переголосовать, — `max` отказывает сам, ничего не отправляя. web.max.ru опросы не показывает, и
  `polls create` об этом напоминает.
- **`max <имя> bot mcp` — MCP-сервер бота для агента.** По умолчанию только чтение; запись — по флагам
  `--allow-send`, `--allow-delete`, `--allow-moderate`, `--confirm-send`.
  Что учесть: каждая запись идёт через ту же команду, что набрали бы вы, — со списком получателей и
  журналом. Действия проверки по правилам, которые нужно подтвердить, агент показывает вам одной
  формой. Подробнее — [бот для агента](/llms.mdx/docs/ru/max/bot/content.md#%D0%B1%D0%BE%D1%82-%D0%B4%D0%BB%D1%8F-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82%D0%B0-mcp).

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-81]

- **Параметр `timeout` у `max bot api get-updates` теперь задаётся флагом `--poll-timeout`.** Раньше
  флаг `--timeout` этой операции до MAX не доходил: `--timeout` — это общий срок самой команды.
  Что учесть: скрипт, который передавал `--timeout` для долгого опроса, должен перейти на
  `--poll-timeout`.

### Исправлено [#исправлено-71]

- **Фоновый `max serve` прежней версии заменяется при первой же команде новой версии.** Раньше, пока
  старый сервер отвечал, он оставался работать и отказывал в новых операциях — например, в голосе в
  опросе, — пока его не останавливали через `max server stop`.
- **Сервер из другой сборки с тем же номером версии тоже заменяется.** Раньше он оставался работать.
  Что учесть: сервер, запущенный вручную, на незнакомую операцию отвечает отказом с подсказкой
  `max server stop`.
- **`max bot api get-updates --limit …` работает.** Раньше `--limit` операции принимался за
  настройку самого `max`, и команда отказывала.

## 0.15.0 — 27.09.2026 [#0150--27092026]

### Что нового [#что-нового-81]

- **`max chats check <чат>` — модерация группы по её правилам.** Команда читает, что пришло с
  прошлой проверки (сообщения и новых участников), сверяет с правилами группы (`max chats rules`) и
  делает то, что они разрешают: сообщает, удаляет сообщение, удаляет человека из группы.
  Что учесть: по умолчанию команда только сообщает; `--dry-run` только планирует; за раз — не больше
  10 действий. Удаление и исключение проходят те же проверки, что любое другое изменение. Заявки на
  вступление в этой версии только планировались — в 0.17.0 их убрали совсем, потому что в MAX их нет.
  Подробнее — [группы, которые вы ведёте](/llms.mdx/docs/ru/max/groups/content.md).
- **Модерация через агента.** `max mcp --allow-moderate` даёт инструмент `max_chats_check` — ту же
  проверку. Всегда доступны три инструмента только для чтения: `max_chats_events`,
  `max_chats_members`, `max_chats_rules`.
  Что учесть: без флага инструмента проверки нет. Действия, которые правила велят подтвердить, агент
  показывает вам одной формой.
- **Роли и ссылка.** `max chats members list` помечает каждого участника `owner`, `admin` или
  `member`. `max chats link show <чат>` печатает ссылку-приглашение.
- **Видео и голосовые с личного аккаунта.** `max messages send <чат> --file ролик.mp4` отправляет
  видео, которое смотрят прямо в чате (`.mp4 .mov .webm .mkv`). `max messages send <чат> --voice
  заметка.ogg` отправляет голосовое с полоской громкости и длительностью.
  Что учесть: раньше видео уходило файлом; чтобы отправить его файлом и теперь, добавьте
  `--as-file`. Голосовое — только Ogg Opus; для другого звука команда подскажет строку `ffmpeg`.
  Подробнее — [повседневная работа](/llms.mdx/docs/ru/max/usage/content.md).
- **Голосовые текстом прямо в списке.** `max messages list <чат> --transcribe` и `max inbox
  --transcribe` расшифровывают показанные голосовые на этом компьютере; текст стоит под сообщением
  со значком 🎤, в `--json` — в поле `transcript`. В MCP — `transcribe: true` у `max_messages_list` и
  `max_inbox`.
  Что учесть: уже расшифрованные голосовые показывают текст и без флага. Для расшифровки нужна
  скачанная модель.
- **Остальные команды бота.** `max <имя> bot messages send --file <путь>` прикладывает картинку,
  видео, звук или файл, а `bot uploads put` только загружает его. `bot members list|add|remove` и
  `bot admins list|add|remove` — участники и админы чата; `bot comments list|get|send|edit|delete` —
  комментарии под постом канала; `bot callbacks answer` — ответ на нажатую кнопку; `bot commands
  list|set|clear` — меню команд бота; `bot webhooks list|set|delete` — вебхуки. Всё —
  в [руководстве по боту](/llms.mdx/docs/ru/max/bot/content.md).
  Что учесть: `webhooks set` отказывает, пока задан другой адрес: MAX не заменяет старый вебхук, а
  шлёт события на оба.
- **Локальная копия переписки бота.** Всё, что бот прочитал, отправил или получил, сохраняется на
  этом компьютере. `max <имя> bot messages list <чат> --offline` и `messages get --offline` читают её
  без сети, `bot messages search <текст>` ищет по ней.
  Что учесть: сообщение, удалённое ботом или удаление которого заметил `updates watch`, из копии
  пропадает. Копия содержит тексты сообщений.
- **`max <имя> bot updates watch`** печатает события бота по мере прихода, до Ctrl-C, и сохраняет их
  сообщения в копию. Следующий запуск продолжает с того места, где остановился прошлый.
  Что учесть: пока у бота настроен вебхук, команда не работает. Она забирает события у других
  читателей бота — запускайте её, только если бот больше никому не нужен.
- **Люди в копии бота.** `max <имя> bot people show <кто>` — чаты, где человек писал, и последние
  сообщения из его личного чата с ботом; `--refresh` перечитывает этот чат у MAX. `bot messages
  search --from <кто>` — всё, что он написал. `bot messages between <кто> <кто> …` — переписка
  нескольких людей в чатах, где писал каждый. `--all-bots` смотрит копии всех ботов. Кто — номер,
  `@username` или часть имени.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-82]

- **`max bot messages list` печатает старые сообщения сверху**, как `max messages list`. Раньше сверху
  были новые. Отправленное ботом сообщение теперь помечено как своё.
  Что учесть: скрипт, который брал первую строку как самое новое сообщение, теперь получит самое
  старое.

### Исправлено [#исправлено-72]

- **`max review --transcribe` не держит соединение с MAX открытым, пока работает модель.** Записи
  скачиваются заранее, соединение закрывается, и только потом идёт распознавание.
- **`max bot api edit-my-commands`, `subscribe`, `unsubscribe` и `get-upload-url` работают.** Раньше
  они падали с «an account change without a known action» и ничего не отправляли.
- **Отправка ботом на положительный номер без `user:` подсказывает, что это, скорее всего, человек**,
  и что писать ему надо как `user:<номер>`.
- **Примеры в [руководстве по боту](/llms.mdx/docs/ru/max/bot/content.md) не содержат выдуманного номера чата**, и там же сказано, как
  узнать настоящий.

## 0.14.0 — 27.09.2026 [#0140--27092026]

### Что нового [#что-нового-82]

- **`max bot` — работа с ботом через официальный Bot API.** `max bot auth set` проверяет токен бота у
  MAX и сохраняет его в ключнице, отдельно от личного аккаунта. Профиль — первое слово, как везде:
  `max рабочий bot me`. `max bot me` показывает бота, а `max bot api <операция>` вызывает любую из 33
  операций API с флагами для параметров и JSON-телом. Команды сгенерированы из официальной схемы
  ([список](https://github.com/WireCatLabs/max-cli/blob/v0.111.0/docs/dev/bot-api-coverage.md)).
  Что учесть: идентификатор больше 2^53 печатается строкой, чтобы не потерять цифры, — скрипт должен
  читать его как строку.
- **Удобные команды бота.** `max <имя> bot messages send <чат> <текст>` пишет в чат по номеру,
  человеку — как `user:<номер>`, или по названию чата, который бот уже видел; есть и `edit`,
  `delete`, `list`, `get`. `max <имя> bot chats list` — чаты, которые бот видел, и
  `chats get|pin|unpin|leave|action`. `max bot list` — все имена с токеном бота.
  Почему «которые видел»: у MAX нет списка чатов бота, поэтому `max` запоминает чаты сам.
- **Список получателей и журнал отправок бота.** `max <имя> bot recipients add|list|remove|off` и
  `max <имя> bot sends list`. Список проходит любая запись бота, в том числе через `bot api`.
  Что учесть: лимита отправок в час у бота в этой версии нет (появился в 0.17.0). Всё о боте —
  [руководство по боту](/llms.mdx/docs/ru/max/bot/content.md).
- **Модерация групп: что происходит.** `max review --unanswered [часы]` — вопросы в группах, на
  которые ни вы, ни админы ещё не ответили; `max review --chat <чат>` — обзор одного чата.
  `max chats events <чат>` — кто вступил, вышел, кого добавили и удалили. `max chats members list
  <чат>` — все участники группы или канала, с датой регистрации и последним появлением. `max chats
  rules show|set|unset <чат>` — правила модерации группы, в одном файле, как `config set`.

### Исправлено [#исправлено-73]

- **Когда MAX закрывает соединение, ошибка называет код и причину закрытия.**

## 0.13.0 — 26.09.2026 [#0130--26092026]

### Что нового [#что-нового-83]

- **`max review` — кто кому что должен.** Одним вызовом — все сообщения, ваши тоже, во всех чатах,
  где что-то было с прошлого обзора (без `--since` — за 3 дня). `--transcribe` расшифровывает
  голосовые. В конце ответа — с какого момента начинать следующий обзор.
  Что учесть: если что-то не прочитано, ответ прямо говорит «неполный» — не принимайте такой обзор
  за полный ([обзор: кто кому что должен](/llms.mdx/docs/ru/max/usage/content.md#%D0%BE%D0%B1%D0%B7%D0%BE%D1%80-%D0%BA%D1%82%D0%BE-%D0%BA%D0%BE%D0%BC%D1%83-%D1%87%D1%82%D0%BE-%D0%B4%D0%BE%D0%BB%D0%B6%D0%B5%D0%BD)).
- **Инструмент `max_review` и команда `/review` в MCP.** Агент раскладывает переписку на «я должен»,
  «жду от других» и «нужно уточнить», проверяет рабочие группы, прежде чем назвать что-то
  просроченным, и готовит напоминания.
  Что учесть: напоминания уходят только после вашего «да» ([готовые запросы MCP](/llms.mdx/docs/ru/max/mcp/content.md#%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D1%8B-%D0%B8-%D1%87%D0%B0%D1%82%D1%8B-%D0%BF%D0%BE-)).
- **`max mcp config` печатает готовую запись для Claude Desktop, Cursor и других клиентов.**
  Почему: запись содержит полные пути, поэтому работает и на Windows, и в приложениях, которые не
  видят `PATH` терминала ([подключение MCP](/llms.mdx/docs/ru/max/mcp/content.md#%D0%BF%D0%BE%D0%B4%D0%BA%D0%BB%D1%8E%D1%87%D0%B5%D0%BD%D0%B8%D0%B5)).
- **`max doctor` проверяет установку:** чем запущен `max`, куда поставлен, найдёт ли его новый
  терминал, загружаются ли ключница и SQLite, скачана ли модель речи.
  Что учесть: если каталог команды не на `PATH`, `doctor` печатает команду, которая это исправит, —
  для PowerShell на Windows и `export` на Linux и macOS. Если сама `max` не находится, запустите
  `npx @wirecat/max-cli doctor` ([max не находится после установки](/llms.mdx/docs/ru/max/troubleshooting/content.md#max-%D0%BD%D0%B5-%D0%BD%D0%B0%D1%85%D0%BE%D0%B4%D0%B8%D1%82%D1%81%D1%8F-%D0%BF%D0%BE%D1%81%D0%BB%D0%B5-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B8)).
- **`max doctor --online` проверяет связь с MAX:** один вход, один чат и запуск MCP-сервера. Ничего
  не отправляет.
- **`max models audio download` после скачивания проверяет, что модель работает.** Если модель не
  скачана, сообщение называет её язык и другие модели с размерами.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-83]

- **MCP-инструмент `max_messages_attachment` переименован в `max_messages_photo`.**
  Что учесть: если в клиенте MCP было сохранено разрешение на старое имя, дайте его заново.
- **Профиль больше нельзя назвать `review`**, потому что это теперь команда.
  Что учесть: профиль с таким именем придётся переименовать.

### Безопасность [#безопасность-17]

- **Отчёт о проблеме на Windows скрывает домашний каталог в любом написании.** Раньше имя
  пользователя оставалось в части путей.

## 0.12.0 — 26.09.2026 [#0120--26092026]

### Что нового [#что-нового-84]

- **MCP-сервер умеет больше:** `max_inbox` — всё новое одним вызовом; ответ на сообщение и
  оформление текста при отправке; реакции; фото — как картинка, которую агент видит
  ([инструменты MCP](/llms.mdx/docs/ru/max/mcp/content.md#%D0%B8%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82%D1%8B)).
- **Команды `/catch-up`, `/reply`, `/find` и чаты по `@` в Claude Code**
  ([готовые запросы MCP](/llms.mdx/docs/ru/max/mcp/content.md#%D0%BA%D0%BE%D0%BC%D0%B0%D0%BD%D0%B4%D1%8B-%D0%B8-%D1%87%D0%B0%D1%82%D1%8B-%D0%BF%D0%BE-)).

### Исправлено [#исправлено-74]

- **`max serve` работает на Windows.** Там сервер теперь слушает именованный канал, а не файл.
- **Слишком длинный путь к сокету на macOS и Linux даёт понятную ошибку**, а не `EINVAL`. Путь
  становится длинным из-за длинного имени профиля или `MAX_STATE_DIR`.

## 0.11.0 — 26.09.2026 [#0110--26092026]

### Что нового [#что-нового-85]

- **`max watch --events` показывает не только новые сообщения, но и правки, удаления и реакции**; у
  каждой строки есть поле `event`. Без флага вывод прежний
  ([новые сообщения сразу](/llms.mdx/docs/ru/max/archive/content.md#%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D1%8F-%D1%81%D1%80%D0%B0%D0%B7%D1%83-max-serve-%D0%B8-max-watch)).
- **Отчёт о проблеме уходит в задачу на GitHub, а не письмом.** `max doctor report create` печатает
  ссылку на новую задачу с заполненным заголовком и заготовкой текста; файл отчёта прикладывается к
  задаче.
  Что учесть: задача на GitHub и приложенный файл видны всем
  ([как сообщить о проблеме](/llms.mdx/docs/ru/max/troubleshooting/content.md#%D0%BA%D0%B0%D0%BA-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B8%D1%82%D1%8C-%D0%BE-%D0%BF%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC%D0%B5)).
- **Любая ошибка любой команды сохраняется в запись запуска** — и неверный флаг, и проверка до начала
  работы, и команды, которые в MAX не ходят (`models`, `server`, `watch`). Раньше сохранялись только
  ошибки команд, дошедших до MAX.
  Что учесть: сохраняются только слова команды, без того, что написано после них, — текст сообщения
  в запись не попадает ([диагностика](/llms.mdx/docs/ru/max/diagnostics/content.md)).
- **`max backup messages --run` говорит, где сохранённое и что дальше.** Сообщения лежат в локальной
  копии, а файл делает `max export messages`: готовая команда стоит в конце вывода и в поле `export`.
- **Фоновый сервер `max serve` сам проверяет ограничения на отправку и ведёт журнал отправок:**
  профиль только для чтения, разрешённые действия, список получателей, лимит в час. Изменение через
  `config set` действует без перезапуска сервера.
  Что учесть: с переменной `MAX_TOKEN` сервер не запускается.
- **`max serve` после входа запрашивает то же, что вкладка web.max.ru:** папки, баннеры, историю
  звонков, наборы стикеров и реакций. **И входит повторно так же:** передаёт MAX время прошлого входа
  и спрашивает только изменившиеся чаты, а не весь список.
  Почему: чем меньше `max` отличается от веб-клиента, тем меньше у MAX поводов его заметить.
  Что учесть: всё это только чтение; ответы не показываются и не сохраняются. Одноразовые команды
  это не делают ([что уходит в сеть](/llms.mdx/docs/ru/max/security/content.md#%D1%87%D1%82%D0%BE-%D1%83%D1%85%D0%BE%D0%B4%D0%B8%D1%82-%D0%B2-%D1%81%D0%B5%D1%82%D1%8C)).
- **Фоновый сервер переживает повреждённое входящее сообщение от MAX:** пропускает его, пишет об этом
  одну строку и работает дальше. Раньше такое сообщение могло остановить сервер.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-84]

- **Защиты для агентов строже.**
  - `max mcp --confirm-send` спрашивает перед любой записью — правкой, пересылкой, закреплением,
    отметкой о прочтении, удалением, — а не только перед отправкой. «Да» действует один раз и 5 минут.
  - В часовой лимит `sendsPerHour` теперь идут правки, закрепления с уведомлением и каждый
    добавленный человек. Отложенное сообщение считается в час, когда уйдёт. Две одновременные
    отправки у предела больше не проходят обе.
  - Если включён список получателей, группа создаётся и люди добавляются, только если личный чат с
    каждым из них есть в списке.
  - `chats members add` не показывает новичку старые сообщения без `--history`; флаг
    `--hide-history` убран.
  - `MAX_PROFILE_LOCK` запирает процесс на одном профиле.
  - `--file` не берёт скрытые файлы и папки и папки самого `max` без `--allow-any-file`.

  Что учесть: лимит в час теперь исчерпывается быстрее, чем раньше. Скрипт с `--hide-history` получит
  ошибку — уберите флаг. Скрипт, который отправлял скрытый файл, должен добавить `--allow-any-file`.

### Исправлено [#исправлено-75]

- **`max watch` не выдаёт правку или удаление за новое сообщение.** MAX присылает их тем же
  сообщением с пометкой, и раньше такое могло появиться в выводе как новое.
- **Точное название чата больше не выигрывает молча.** Если оно входит и в название другого чата,
  команда покажет оба и попросит выбрать по id.
  Почему: отправку в не тот чат нельзя отменить.

### Безопасность [#безопасность-18]

- **Токен из `MAX_TOKEN` остаётся только там.** Если MAX выдаёт сессии новый токен, `max` не пишет
  его ни в ключницу, ни в файл, а говорит об этом в stderr. `max doctor` называет файл
  `credentials.json`, если токен хранится в нём, а не в ключнице.
- **`max session start` показывает номер телефона скрытым**, как `max account show`. Ctrl-C на
  вопросе о токене завершает команду с кодом `130`.
- **Фоновый сервер не отдаёт токен** командам, которые спрашивают у него вход: им он не нужен, они
  сверяются с ключницей.
- **Пределы для сети.** Кадр MAX распаковывается не больше чем в 32 МиБ. Подключение к MAX и
  скачивание файла не висят бесконечно, если сеть замолчала. `max messages download` скачивает только
  по https, не ходит по ссылкам на этот компьютер и в локальную сеть — в том числе после
  перенаправления — и не качает больше 4 ГиБ; голосовое для расшифровки — не больше 32 МиБ.
  Почему: ссылка в сообщении приходит от чужого человека и может вести куда угодно.
- **Права на локальную копию.** База и её журналы `-wal` и `-shm` создаются с правами `0600`,
  каталог — `0700`; права старых файлов выставляются так же при следующем открытии. В отчёте о
  проблеме номера чатов и сообщений заменены метками.
- **Чужой текст печатается в одну строку, а управляющие символы — видимыми** — в ленте, таблицах,
  списке кандидатов, выгрузке Markdown и путях `messages download`. Из имени скачанного файла
  убираются управляющие символы и символы смены направления текста. В Markdown ссылками становятся
  только адреса `http` и `https`.
- **Автодополнение на месте чата или человека подставляет только номер**, а название или имя
  показывает рядом. Почему: название и `@имя` задаёт кто-то другой, и оболочка не должна получать от
  него ничего, кроме цифр.
- **`max cache clear` без имени профиля очищает профиль по умолчанию и учитывает `MAX_PROFILE`.**
- **Выпуск строже.** Версии зависимостей закреплены точно; пакет собирается с нуля перед каждой
  упаковкой, без тестовых помощников; публикует отдельный шаг, который не ставит и не запускает
  зависимости.

## 0.10.0 — 25.09.2026 [#0100--25092026]

### Что нового [#что-нового-86]

- **`max doctor report` и `max doctor report create` — отчёт о проблеме для автора.** Первая команда
  объясняет, что попадёт в отчёт; вторая пишет файл без текстов сообщений и печатает, что сделать по
  шагам. В этой версии отчёт отправлялся письмом; с 0.11.0 — задачей на GitHub
  ([как сообщить о проблеме](/llms.mdx/docs/ru/max/troubleshooting/content.md#%D0%BA%D0%B0%D0%BA-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B8%D1%82%D1%8C-%D0%BE-%D0%BF%D1%80%D0%BE%D0%B1%D0%BB%D0%B5%D0%BC%D0%B5)).
- **`max backup messages <чат> --since <дата> | --last <n>` дочитывает историю чата в локальную
  копию.**
  Что учесть: без `--run` команда только показывает расчёт и ничего не отправляет. С `--run` она
  листает назад по 30 сообщений с паузами, не больше 40 страниц за запуск, и при повторе продолжает с
  места ([скачать историю](/llms.mdx/docs/ru/max/archive/content.md#%D1%81%D0%BA%D0%B0%D1%87%D0%B0%D1%82%D1%8C-%D0%B8%D1%81%D1%82%D0%BE%D1%80%D0%B8%D1%8E)).
- **`max doctor` показывает, какой версией веб-клиента MAX представляется `max`**, и предупреждает,
  если её прочитали больше 60 дней назад.
  Почему: MAX может перестать принимать старую версию клиента
  ([решение проблем](/llms.mdx/docs/ru/max/troubleshooting/content.md)).
- **`max server start|stop|status|restart` — фоновый сервер как отдельная вещь**, как `max session`.
  `status` показывает, работает ли сервер, с какого времени, какой версии и подключён ли к MAX, и
  подсказывает `restart`, если версия сервера отстала от `max`. `max serve --detach` и `--stop`
  по-прежнему работают ([новые сообщения сразу](/llms.mdx/docs/ru/max/archive/content.md#%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D1%8F-%D1%81%D1%80%D0%B0%D0%B7%D1%83-max-serve-%D0%B8-max-watch)).
- **Чтение истории шлёт те же пять полей, что веб-версия**, и вход просит у MAX 15 чатов, как вкладка
  web.max.ru, а остальные дочитывает одним запросом. Раньше `max` добавлял к запросу поле, которого
  веб-версия не шлёт, и просил 40 чатов за раз.
  Почему: чем меньше `max` отличается от веб-клиента, тем меньше у MAX поводов его заметить.
  Что учесть: список чатов тот же. Проверено на канале с непрочитанными: чтение по-прежнему ничего не
  отмечает прочитанным.
- **Описание устройства берётся с вашего компьютера:** часовой пояс, язык системы и операционная
  система — свои у каждой установки, как у браузера. Раньше каждая установка `max` называла себя одним
  и тем же Chrome на Linux в часовом поясе Мадрида.
- **`max serve` шлёт MAX одно служебное событие, как скрытая вкладка веб-версии:** «показан список
  чатов», через 20 секунд после входа.
  Что учесть: в событии номер аккаунта и время — ни сообщений, ни названий. Одноразовые команды его не
  шлют ([что уходит в сеть](/llms.mdx/docs/ru/max/security/content.md#%D1%87%D1%82%D0%BE-%D1%83%D1%85%D0%BE%D0%B4%D0%B8%D1%82-%D0%B2-%D1%81%D0%B5%D1%82%D1%8C)).
- **Слишком длинное название папки `max` отклоняет сам** — не длиннее 20 знаков, сколько принимает
  MAX. Раньше запрос уходил в MAX и возвращался с его отказом.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-85]

- **Отказ MAX во входе из-за частых попыток больше не ведёт к новым попыткам.** Команда выходит с
  кодом `8`, а профиль сам не входит какое-то время: 1 минуту после первого отказа, дальше 5 минут,
  30 минут, час, 6 часов, сутки. Фоновый сервер на любом отказе во входе останавливается; раньше он
  пробовал снова раз в минуту без конца.
  Что учесть: скрипт, который повторял команду сразу после отказа, теперь получит тот же код `8` до
  конца паузы — ждите время из ошибки ([решение проблем](/llms.mdx/docs/ru/max/troubleshooting/content.md)).

### Исправлено [#исправлено-76]

- **Недоступная ключница больше не выдаётся за отсутствие входа.** Если профиль уже входил на этом
  компьютере, а токена не видно — например, из cron, — `max` и `max doctor` говорят, что дело,
  вероятно, в ключнице. Раньше они советовали войти заново.
  Почему это важно: новый вход в этом случае — лишнее новое устройство в аккаунте
  ([рецепты](/llms.mdx/docs/ru/max/recipes/content.md)).
- **Запуск, который кончился ошибкой, сохраняется и без `--record`.** В записи теперь есть ключ ошибки
  MAX (например `login.token`), предупреждения кодом, место падения, версия среды и система. Тексты
  по-прежнему не пишутся. Лог фонового сервера — строками JSON со временем
  ([диагностика](/llms.mdx/docs/ru/max/diagnostics/content.md)).
- **`max chats read --until` отмечает прочитанным только до указанного сообщения.** Раньше отметка
  уходила с текущим временем, и MAX считал прочитанным всё до «сейчас», включая более новые сообщения.
  То же исправлено у `messages list --mark-read`.
  Что учесть: собеседники могли видеть «прочитано» у сообщений, которых вы не читали.

## 0.9.0 — 25.09.2026 [#090--25092026]

### Что нового [#что-нового-87]

- **`max` говорит с MAX так же, как веб-версия:** тот же адрес, двоичные кадры и сжатие, что у
  web.max.ru, и то же описание устройства с обновлёнными версиями приложения и браузера. Раньше `max`
  слал текстовые кадры в старом формате.
  Почему: по старому формату `max` отличить от веб-клиента было проще всего. Кроме того, голосовым и
  кружкам нужно поле с байтами, которое старый формат передать не мог.
  Что учесть: команды и их вывод не изменились. Отправка голосовых — в следующих версиях. Пока при
  каждом входе MAX присылает список чатов целиком, а не только изменения: это работает, но даёт
  лишний трафик.
- **Фоновый `max serve`, запущенный командой, после обновления `max` перезапускается сам.**
  Что учесть: сервер, запущенный вами вручную, продолжает работать по-старому, пока вы его не
  остановите: `max serve --stop`, затем запустите снова.

## 0.8.0 — 25.09.2026 [#080--25092026]

### Что нового [#что-нового-88]

- **`max messages transcribe <чат> <id>` — голосовое в текст прямо на вашем компьютере.** Запись
  никуда не уходит, её распознаёт локальная модель. `max models audio list` покажет, какая модель
  подходит для каких языков, `max models audio download <id>` скачает её и сверит контрольную сумму.
  Для MCP — `max_messages_transcribe` ([голосовые в текст](/llms.mdx/docs/ru/max/usage/content.md#%D0%B3%D0%BE%D0%BB%D0%BE%D1%81%D0%BE%D0%B2%D1%8B%D0%B5-%D0%B2-%D1%82%D0%B5%D0%BA%D1%81%D1%82)).
  Что учесть: модель скачивается один раз и только по вашей команде. Текст сохраняется в локальной
  копии, так что повторно ни MAX, ни модель не нужны.
- **Одно подключение к MAX на профиль.** Все команды, `max mcp` и `max watch` одного профиля ходят в
  MAX через один фоновый `max serve`, а не каждая своим подключением.
  Почему: меньше входов с одним токеном — меньше поводов для MAX завершить ваши сеансы.
  Что учесть: `max session start` останавливает сервер, входит и запускает его снова
  ([новые сообщения сразу](/llms.mdx/docs/ru/max/archive/content.md#%D0%BD%D0%BE%D0%B2%D1%8B%D0%B5-%D1%81%D0%BE%D0%BE%D0%B1%D1%89%D0%B5%D0%BD%D0%B8%D1%8F-%D1%81%D1%80%D0%B0%D0%B7%D1%83-max-serve-%D0%B8-max-watch)).
- **`max serve --detach` запускает сервер в фоне** и отвечает, когда он подключился; **`max serve
  --stop` его останавливает.**
  Что учесть: сервер, запущенный вами вручную, останавливается только Ctrl-C или `--stop` — `max
  session end` его не трогает.
- **Настройка `allow` — что профилю можно.** `max work config set allow send,reaction` разрешает
  профилю только писать и ставить реакции. Имён двенадцать, от `send` до `sessions`.
  Что учесть: без списка разрешено всё, как раньше. Запрещённое отказывает с кодом `5` ещё до
  подключения, и ошибка называет команду, которая это разрешит. В `max mcp` агент не видит
  инструментов, которых профиль не разрешает ([что профилю можно](/llms.mdx/docs/ru/max/usage/content.md#%D1%87%D1%82%D0%BE-%D0%BF%D1%80%D0%BE%D1%84%D0%B8%D0%BB%D1%8E-%D0%BC%D0%BE%D0%B6%D0%BD%D0%BE)).
- **`max messages send … --at <время>` — отправить позже.** Сообщение ждёт на сервере MAX и уйдёт,
  даже если компьютер выключен. Время — `2026-09-25T09:00` (местное) или `30m`, `2h`, `1d`.
  `max messages scheduled <чат>` — что ждёт отправки. Для MCP — `at` у `max_messages_send` и
  `max_messages_scheduled`.
  Что учесть: отменить отложенное можно только в приложении MAX
  ([отправить позже](/llms.mdx/docs/ru/max/usage/content.md#%D0%BE%D1%82%D0%BF%D1%80%D0%B0%D0%B2%D0%B8%D1%82%D1%8C-%D0%BF%D0%BE%D0%B7%D0%B6%D0%B5)).
- **`max chats read <чат>` и `max messages list … --mark-read` отмечают чат прочитанным** — только
  когда вы это попросили. Для MCP — `max mcp --allow-mark-read`.
  Что учесть: собеседник видит отметку. Без этих команд чтение по-прежнему ничего не отмечает
  ([чтение](/llms.mdx/docs/ru/max/usage/content.md#%D1%87%D1%82%D0%B5%D0%BD%D0%B8%D0%B5)).
- **`max export messages <чат> --format jsonl|md` выгружает переписку из локальной копии** в JSONL или
  Markdown, с `--since` и `--output`. В MAX не ходит.
  Что учесть: чего в копии нет, команда называет в stderr. Файл из `--output` доступен только вам
  ([выгрузить в файл](/llms.mdx/docs/ru/max/archive/content.md#%D0%B2%D1%8B%D0%B3%D1%80%D1%83%D0%B7%D0%B8%D1%82%D1%8C-%D0%B2-%D1%84%D0%B0%D0%B9%D0%BB)).
- **`max messages delete <чат> <id…> --allow-dangerous` удаляет сообщения**, до 10 за раз. По умолчанию
  только у вас; с `--for-everyone` — у всех в чате. Для MCP — `max mcp --allow-delete`, только
  «у меня».
  Что учесть: без `--allow-dangerous` команда отказывает. Каждое удалённое сообщение считается в
  `sendsPerHour` ([удаление](/llms.mdx/docs/ru/max/usage/content.md#%D1%83%D0%B4%D0%B0%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5)).

### Исправлено [#исправлено-77]

- **Обновление `max` больше не стирает прочитанную историю.** Раньше каждая новая версия с другим
  устройством локальной копии выбрасывала все сохранённые сообщения. Теперь сообщения переносятся в
  новую копию.
  Что учесть: этот выпуск сам меняет устройство копии, и история сохранится. Чаты и люди, как и
  раньше, приходят заново при следующем входе.
- **Если MAX отказал фоновому серверу во входе, команды 10 минут не запускают новый сервер.** Раньше
  каждая команда поднимала сервер, который снова пытался войти и снова получал отказ. `max session
  start` снимает это ожидание сразу.
- **`max watch` видит сообщения, которые отправил сам `max`.** Раньше они проходили мимо: MAX не
  присылает сообщение обратно тому подключению, которое его отправило.
- **Несколько команд `max` разом больше не теряют вход в локальной копии.** Раньше из трёх
  одновременных команд две писали «the local record did not take this login» и не сохраняли чаты,
  участников и отметку синхронизации. Теперь вторая ждёт, пока допишет первая.

### Безопасность [#безопасность-19]

- **Текст ошибки тоже не управляет терминалом.** В 0.7.0 это сделали для сообщений, имён и таблиц;
  теперь управляющие символы показываются как `\x1b` и в тексте ошибки.
  Почему: ошибка часто повторяет то, что вы ввели или что ответил MAX.

## 0.7.0 — 24.09.2026 [#070--24092026]

### Что нового [#что-нового-89]

- **`max reactions remove <чат> <id>` снимает вашу реакцию.**
- **Группы и каналы под `max chats`:** посмотреть ссылку, вступить, выйти, создать группу, добавить и
  удалить людей, назначить и снять админа, переименовать, поменять настройки, перевыпустить ссылку.
  Здесь же были заявки на вступление — их убрали в 0.17.0, потому что в MAX их нет.
  Что учесть: всё это видят другие люди, и каждое действие проходит те же проверки, что отправка
  ([группы и каналы](/llms.mdx/docs/ru/max/usage/content.md#%D0%B3%D1%80%D1%83%D0%BF%D0%BF%D1%8B-%D0%B8-%D0%BA%D0%B0%D0%BD%D0%B0%D0%BB%D1%8B)).
- **`max update` обновляет `max` тем же менеджером пакетов, которым он поставлен;** `--check` только
  говорит, есть ли версия новее.
  Что учесть: раз в сутки человек в терминале видит строку о новой версии; агент и скрипт — никогда.
  Выключается `updateCheck: false` в `defaults`
  ([обновление](/llms.mdx/docs/ru/max/installation/content.md#%D0%BE%D0%B1%D0%BD%D0%BE%D0%B2%D0%BB%D0%B5%D0%BD%D0%B8%D0%B5)).
- **Дополнение по Tab в zsh, bash, fish и PowerShell:** `source <(max complete zsh)`. Предлагает
  команды, флаги, их значения, а также чаты и людей из локальной копии — без подключения к MAX
  ([справка по `max complete`](/llms.mdx/docs/ru/max/commands/content.md#max-complete)).
- **`max mcp` — тот же профиль для агентов по MCP**, для клиентов без терминала (Claude Desktop,
  Cursor). Подключение — [MCP-сервер](/llms.mdx/docs/ru/max/mcp/content.md).
  Что учесть: сервер только читает, пока не запущен с `--allow-send`; отправка проходит те же
  проверки, что `max messages send`.
- **`max mcp --allow-send --confirm-send` показывает форму перед каждой отправкой:** в какой чат
  (название и id) и что.
  Что учесть: без вашего «да» ничего не уходит; клиент, который не умеет показывать формы, получает
  ошибку ([что может агент](/llms.mdx/docs/ru/max/mcp/content.md#%D1%87%D1%82%D0%BE-%D0%BC%D0%BE%D0%B6%D0%B5%D1%82-%D0%B0%D0%B3%D0%B5%D0%BD%D1%82)).
- **`max messages send … --file <путь>` отправляет фото и файлы;** несколько фото уходят одним
  сообщением.

### Безопасность [#безопасность-20]

- **Чужой текст больше не управляет терминалом.** Сообщение, имя отправителя, название чата, имя
  файла или реакция с управляющими символами могли стереть строку и напечатать поверх того, что
  `max` уже вывел. Теперь такие символы показываются как `\x1b` — в ленте, в таблицах, в
  сообщениях об ошибках и в подсказках по Tab.
  Что учесть: JSON не меняется — он и раньше их экранировал.

## 0.6.0 — 24.09.2026 [#060--24092026]

### Что нового [#что-нового-90]

- **`max commands --json` описывает все команды, аргументы, флаги и коды выхода одним ответом.**
  Команды, которые что-то меняют в MAX, помечены `mutates: true`.
  Почему: агенту не нужно звать `--help` для каждой команды.
  Что учесть: работает без входа в MAX и даже со сломанным файлом настроек.
- **`max messages send … --reply-to <id>` — ответ на сообщение.**
- **`max messages send … --markdown` (или `--md`) оформляет текст:** `**жирный**`, `_курсив_`,
  `~~зачёркнутый~~` и `` `код` ``. Без флага текст уходит как набран.
- **`max reactions add <чат> <id> <эмодзи>` ставит реакцию;** прежняя ваша заменяется.
- **Реакции видны при чтении:** `messages list`, `show` и `context` печатают под сообщением
  `👍 3  🔥 1  (you: 🔥)`, в JSON — поле `reactions`.
  Что учесть: это один дополнительный запрос на страницу, только чтение. С `--offline` реакций нет
  (`null`), потому что они не хранятся.
- **Журнал отправок и список разрешённых получателей.** Каждая попытка отправки пишется в журнал без
  текста — `max sends list`. Необязательный список получателей — `max recipients add|remove|list|off`;
  отправка в чат не из списка отказывает с кодом `7`. Профиль только для чтения (`readOnly`)
  отказывает с кодом `5`. Что это защищает и что нет — [безопасность](/llms.mdx/docs/ru/max/security/content.md).
- **`max session start qr | qr-chrome | sms | token` — вход без копирования токена из браузера.**
  `qr` рисует QR-код в терминале (в узком терминале откроет его в браузере); `qr-chrome` и `sms`
  открывают настоящий web.max.ru в отдельном окне Chrome, Chromium, Edge или Brave. Без способа — как
  раньше: токен вручную или из трубы.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-86]

- **Отправка ограничена лимитом в час: по умолчанию 30 сообщений (`sendsPerHour`).** Сверх лимита
  `max messages send` отказывает с кодом `8`. Раньше лимита не было.
  Что учесть: скрипту, который шлёт больше, нужно поднять `sendsPerHour` в настройках.

## 0.5.0 — 24.09.2026 [#050--24092026]

### Что нового [#что-нового-91]

- **`max messages download <чат> <id> [--output <каталог>]` сохраняет фото, файлы, видео и аудио из
  сообщения.** Существующий файл не перезаписывается.
- **`max config set <настройка> <значение>` и `max config unset <настройка>` меняют файл настроек без
  редактора;** с `--defaults` — для всех профилей сразу. Новый раздел `defaults` в файле действует на
  каждый профиль, у которого нет своей настройки.
- **`max chats list --unread` — только чаты с непрочитанным.**
- **`max messages list <чат> --after <id|время>` читает вперёд** — то, что пришло после сообщения или
  момента. Подсказка следующей страницы — `--after <id самого нового>`.
- **`max chats show <чат>` — один чат с участниками; `max contacts show <человек>` — один человек** по
  id, @username или части имени, с общими чатами.
  Что учесть: неоднозначное имя не угадывается — команда перечисляет подходящих.
- Всё новое в этой версии только читает: ничего не отправляет и не отмечает прочитанным.

### Исправлено [#исправлено-78]

- **`--offline` работает.** Раньше флаг не доходил ни до одной команды: чтение всё равно шло в MAX, а
  `max --offline messages send` **отправлял сообщение**. Теперь чтение отвечает из записанного, а
  отправка и скачивание с `--offline` отказываются.
  Что учесть: если вы запускали `--offline messages send` на 0.4.0 или раньше, сообщение ушло.
- **Ошибка в файле настроек объясняется словами:** какая настройка неизвестна и какие есть, что
  допускает значение. Раньше это было сообщение библиотеки проверки.
- **Сломавшийся посреди команды журнал запуска (`--record`) больше не роняет команду.** Вместо этого —
  одна строка предупреждения в stderr, а ответ и код выхода прежние. Предупреждение видно и с
  `--quiet`.

### Безопасность [#безопасность-21]

- **Версии публикуются из GitHub Actions, и npm прикладывает к ним подтверждение происхождения.** По
  нему можно проверить, что пакет собран из этого репозитория.

## 0.4.0 — 23.09.2026 [#040--23092026]

### Что нового [#что-нового-92]

- **`max messages show <чат> <id>` — одно сообщение по id; `max messages context <чат> <id>` с
  `--before` и `--after` — окно вокруг него.** Искомое помечено `◀` в ленте и `"anchor": true` в JSON.
  Что учесть: если сообщения нет, команда говорит «не найдено», а не показывает соседнее.
- **`max skill show` печатает инструкцию для агента из установленного пакета:**
  `max skill show > ~/.claude/skills/max-cli/SKILL.md`.
- **`max config show` показывает, какой профиль действует и что его выбрало**, файл настроек и есть
  ли он, все профили — включая те, что есть только в состоянии и в файл настроек не записаны, — и
  каждую настройку с тем, откуда она взялась: флаг, переменная, файл или встроенное значение.
  Что учесть: если задан `MAX_CONFIG_DIR` или соседние переменные, команда предупреждает, что
  используется не та запись в ключнице, что обычно.
- **Текст сообщения можно передать через pipe:** `echo "текст" | max messages send <чат>` — без
  аргумента с текстом он читается из stdin.
  Почему: так текст не видят `ps` и история оболочки, и в нём могут быть переводы строк.
- **`--timeout <срок>` ограничивает всю команду целиком** — подключение, вход и сам запрос, а не
  ожидание одного ответа.
- **`max doctor` показывает, от чего зависит каждая команда, без обращения к MAX:** откуда берётся
  токен (сам токен не печатается), сколько было входов и когда последний, какие профили входили,
  схему локальной копии против той, что знает эта версия, и какая запись ключницы используется.
  Что учесть: команда отвечает и тогда, когда всё сломано: «сессии нет» — это поле ответа, а не
  ошибка.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-87]

- **Флаг `--query` у списков переименован в `--search`.** Изменение вошло ещё в 0.3.0, но в его
  описании его не было.
  Что учесть: скрипт с `--query` получит ошибку — замените на `--search`.

### Исправлено [#исправлено-79]

- **`messages list --before <id>` больше не требует, чтобы сообщение было прочитано раньше:** время
  отправки берётся из самого id.
- **Участники групп показываются по имени, а не числом.** Раньше имя было только у тех, кто есть в
  контактах, и в групповом чате почти все были номерами. Имена берутся одним запросом и сохраняются,
  так что следующее чтение их уже не спрашивает. То же — для авторов ответов и пересылок.
- **Выпуск версии больше не останавливается сразу после публикации, не поставив тег.** Так было
  дважды; теперь версия проверяется в обход кэша npm, с ожиданием до трёх минут.

## 0.3.0 — 22.09.2026 [#030--22092026]

### Что нового [#что-нового-93]

- **Переписка читается лентой:** разделитель при смене дня, строка `время  автор` и текст под ней,
  выровненный по колонке, с переносами по ширине терминала. `вы` — ваши сообщения; автор без имени
  показан номером. `↳` — на что ответ, `↪` — чья пересылка: MAX присылает их целиком, и они
  сохраняются в локальной копии.
- **`-v` и `-vv` — подробнее:** id сообщения, отправителя, чата и адреса вложений; затем всё, что
  известно о сообщении.
- **`--jsonl` — по объекту JSON на строку**, для потока и `jq`.
- **Вложения показываются ссылками:** `📎 photo`, `📎 photo ×3 1 2 3`, `📎 файл.pdf · 24 MB`. В JSON —
  `url`, `width`, `height`, `title`.
  Что учесть: ссылка на фото открывается без входа — кому её переслали, тот и увидит фото.
- **`senderColors: true` в настройках профиля — свой цвет у каждого автора.** По умолчанию выключено.

### Изменено — может сломать скрипты [#изменено--может-сломать-скрипты-88]

- **`-v` теперь означает подробность вывода, а версия — `max -V`.** Строки о запросах на stderr
  включает **`--trace`** — это бывший `--verbose`.
  Что учесть: скрипт, который звал `max -v` за версией или `--verbose` за трассировкой, должен
  перейти на `-V` и `--trace`.
- **Флаг `--query` у списков переименован в `--search`** (в описании этой версии изначально не был
  указан).
- **Локальная копия переходит на схему 4 и при первом запуске собирается заново.**
  Что учесть: прочитанная история в этой версии не сохраняется — её придётся прочитать снова.

### Исправлено [#исправлено-80]

- **Имя, подходящее к нескольким чатам, выводит их списком с id**, а в JSON — полем `candidates`.
- **Предупреждение о локальной копии называет схему и что делать.** Раньше причина называлась словом
  `Error`.
- **Подсказка о следующей странице у `messages list` советует `--before <id>`.** Раньше она советовала
  несуществующий `--page`.

## 0.2.0 — 22.09.2026 [#020--22092026]

### Что нового [#что-нового-94]

- **`max messages send --silent` — отправить без уведомления у получателя.**
  Что учесть: что именно MAX делает с этим флагом, пока не наблюдали — для этого пришлось бы написать
  живому человеку.
- **Токен обменивается при первом входе.** MAX отвечает на вход своим токеном, и `max` сохраняет его в
  ключницу вместо вставленного из браузера. Это происходит один раз.

### Исправлено [#исправлено-81]

- **`max session start` больше не портит рабочий токен.** Раньше новый токен записывался до проверки,
  и опечатка заменяла рабочий токен мёртвым. Теперь сначала вход, потом запись.
- **Профиль привязан к своему аккаунту.** Токен чужого аккаунта в профиле — отказ с объяснением.
  Почему: иначе команды профиля пошли бы от чужого имени.
- **Подсказка после неясного исхода отправки называет существующую команду.** Раньше она называла
  несуществующую `max send`.
- **Сообщения из ответа на вход больше не выбрасываются** из-за неверно описанной формы ответа.

## 0.1.0 — 21.09.2026 [#010--21092026]

Первая версия, которой можно поделиться.

### Что нового [#что-нового-95]

- **Семь команд против настоящего MAX:** `session start|end`, `account show`, `chats list`,
  `contacts list`, `messages list`, `messages send`.
- **Профиль — первое слово:** `max personal chats list`. Несколько аккаунтов живут рядом, у каждого
  свой токен, своё состояние и своя локальная копия. То же задаёт `MAX_PROFILE`.
- **Токен хранится в ключнице операционной системы**, а не в файле и не в аргументе команды.
  Что учесть: своего входа по номеру телефона пока нет — `max session start` берёт токен из
  официального клиента.
- **Машинный режим:** `--json` кладёт на stdout ровно одно значение JSON и ничего больше; то же
  включается само, когда stdout не терминал. Ошибка уходит на stderr, stdout остаётся пустым.
  Ветвиться можно по коду выхода — таблица в [справочнике команд](/llms.mdx/docs/ru/max/commands/content.md).
- **Диагностика без содержимого:** `--verbose` показывает по строке на запрос, `--record` кладёт их в
  каталог запуска на 30 дней, `max runs list|show|path` читает обратно. По умолчанию не записывается
  ничего.
- **Локальная копия:** прочитанное сохраняется рядом; `--offline` отвечает из неё, не подключаясь, а
  `max cache clear` её забывает.
- **Настройки в `~/.config/max-cli/config.json`**, с порядком «флаг → переменная окружения → файл →
  встроенное значение». Опечатка в имени поля — ошибка с именем поля, а не молчаливое умолчание.
- **Два рантайма:** Node 22+ и Bun 1.3+; собранная команда выполняется под обоими в CI.
- **Чтение ничего не помечает прочитанным.** «Получить историю» и «отметить прочитанным» — разные
  операции протокола; вторая не отправляется никогда, и это проверяется тестом.
- **Отправка не врёт об исходе.** Если ответ не пришёл — `outcome_unknown` (код `14`), а не «ошибка» и
  не «отправлено».
  Что учесть: повторять такую отправку можно только с тем же `--cid`, иначе сообщение может уйти
  дважды.
- **Протокол MAX неофициальный и разобран обратной инженерией:** это не Bot API.
  Что учесть: он может измениться без предупреждения; тогда команда скажет об этом одной строкой в
  stderr, а не сломается молча.
- **Пока не умеет:** входить по номеру телефона, работать с вложениями, реакциями, правками, группами,
  историями и звонками — только текст. Массовой рассылки не будет: это инструмент для личного
  аккаунта.
