# Поиск сообщений и переписки в MAX (/ru/docs/max/search)

Найдите старое сообщение, договорённость, ссылку или файл в сохранённой переписке. Здесь описаны способы поиска и проверка исходных сообщений. Если нужной истории ещё нет на компьютере, сначала загрузите её.

Нужно найти то, что было написано: сообщение, договорённость, присланный файл, код многомесячной
давности. Эта страница показывает, как искать во всём, что `max` сохранил на этом компьютере, —
в сообщениях MAX и в заметках, — и как заодно спросить сервер MAX. Почту ищет
[memo](https://github.com/WireCatLabs/cli-memo): `memo search mail`.

Прочитав её, вы сможете находить сообщения по словам, людям, чатам, датам, файлам и ссылкам,
сохранять поиск и запускать его снова, считать совпадения и отличать настоящее «не найдено» от
пробела в сохранённой истории. Прочитанным поиск ничего не помечает.

Термины этой страницы:

- **Локальная копия** (её ещё называют архивом) — база на этом компьютере, где `max` хранит каждое
  прочитанное или скачанное сообщение ([локальная копия](/llms.mdx/docs/ru/max/archive/content.md)). Большинство поисков читают
  только её.
- **Запрос** — то, что вы ищете: обычные слова или слова с полями вроде `from:` и `date:`. Запросы за
  вас пишет ИИ-агент; весь язык — в [справке по языку запросов](/llms.mdx/docs/ru/max/query-language/content.md).
- **Покрытие** (`coverage`) — что поиск мог увидеть: сколько чатов и сообщений сохранено и какие чаты
  ни разу не скачаны или отстали.

## Если помните вопрос, а не точные слова [#если-помните-вопрос-а-не-точные-слова]

Попросите ИИ-агента найти сообщения, отвечающие на вопрос, и показать основания ответа. Например:
«Найди время ежедневной выгрузки проекта Маяк в его чате и проверь, менялось ли расписание».
Агент может искать частичные совпадения слов и прямые ответы, затем проверить найденные сообщения.
Для этого нужна скачанная история; модель скачивать не требуется.

Для управления из командной строки:

```sh
max personal search messages 'Во сколько ежедневная выгрузка проекта Маяк? chat:990' --discover --json
```

Это поиск только в локальном архиве. Ограничения чата, автора и даты сохраняются. В MCP передайте
`discover: true` инструменту поиска сообщений. `items[].discovery.missing_terms` показывает отсутствующие слова, а `parent` связывает прямой ответ
с подходящим родителем. У первых пяти находок `items[].follow_ups` — до двух более поздних сообщений с редким
общим словом, отрывком, как сама находка (в терминале строки `later, shares a rare word`; целиком —
`messages context <ref>`): в них часто видно, что решение потом отменили или
поменяли, даже если отмена не была ответом. Высокая оценка не означает уверенность в ответе: первым может оказаться
вопрос, предложение или старое решение. Прочитайте основания и проверьте
[покрытие архива](/llms.mdx/docs/ru/max/archive/content.md), прежде чем считать факт отсутствующим.

Без `--discover` действует обычный строгий поиск. Boolean-синтаксис, фразы в кавычках, wildcard,
AST, `--exact` и `--newest` сохраняют строгую семантику. Режим не совмещается с `--backend server`. Поиск разговоров по смыслу остаётся отдельным
[поиском по темам](/llms.mdx/docs/ru/max/topic-search/content.md).

## Что можно сделать [#что-можно-сделать]

Весь поиск — в одной группе команд, `max personal search`. Начинайте с `search messages`; `search all` — когда
нужно искать шире сообщений.

| Задача | Команда |
|---|---|
| Искать сообщения мессенджеров; в одном чате (без `--discover`) — и на сервере MAX | `max personal search messages '<запрос>'` |
| Искать шире, и в заметках тоже | `max personal search all '<запрос>'` |
| Искать почту | `memo search mail '<запрос>'` — у `max` этой команды нет |
| Искать заметки из memo или из папки | `max personal search notes '<запрос>'` |
| Найти обсуждение по тому, о чём оно было | `max personal search conversations '<вопрос>'` ([поиск по темам](/llms.mdx/docs/ru/max/topic-search/content.md)) |
| Посчитать совпадения по чатам, людям, дням или часам | `max personal stats messages show '<запрос>'` |
| Сохранить поиск и запускать его снова | `max personal searches create`, `max personal search messages --saved <имя>` |

```sh
max personal search all 'договор аренды'                 # сообщения и заметки, лучшее первым
```

```sh
max personal search messages 'договор chat:Друзья'     # только сообщения мессенджеров
```

```sh
memo search mail 'счёт'                                  # почта — это memo
```

```sh
max personal search notes 'бюджет source:internal'       # только заметки, написанные в memo
```

```sh
max personal search conversations 'переезд на дачу'      # разговоры, близкие по смыслу
```

`search all` у каждой находки пишет, что это — сообщение (`msg:…`) или заметка (`note:…`).
Почту `max` не ищет: ни `search messages`, ни `search all`. В `search messages` `NOT has:attachment`, `has:voice` и `has:file` в запросе
оставляют только текст, голосовые или файлы; `source:internal` и `source:file` в запросе `search notes` — заметки из memo или из папки. Если поле не подходит — например, `chat:`/`from:` для заметок — `search all`
пропускает этот источник и объясняет почему.

Заметки попадают в архив через memo: `memo sync --only notes`. Без них `search all` ищет только сообщения.

Дальше на этой странице — поиск сообщений, `max personal search messages`. Без `--discover` поиск в одном чате спрашивает ещё и
сервер MAX ([ниже](#поиск-на-сервере-max---backend)).

## Попробуйте поиск в одном чате [#попробуйте-поиск-в-одном-чате]

Начните с фразы и одного чата. В примере поиск читает сохранённую историю, не обращаясь к мессенджеру.

**Ваш запрос:**

> Найди сообщение «счёт оплачен» в чате Книжный клуб. Покажи совпадение и пробелы в истории.

**Команда:**

```sh
max personal search messages '"счёт оплачен" chat:"Книжный клуб"' --backend archive --json
```

**Пример ответа агента:**

> **Найдено одно сообщение в сохранённой истории.**
>
> | Участник | Сообщение |
> | --- | --- |
> | Алиса Тестова | Счёт оплачен вчера. |
>
> История неполная: другие совпадения могут отсутствовать. Могу открыть это сообщение и переписку вокруг него.

Пустой результат не доказывает, что сообщения никогда не было. Проверьте пробелы в истории, прежде
чем расширять поиск. Все примеры на странице вымышлены.

## Сначала подготовьте архив [#сначала-подготовьте-архив]

Хороший поиск возможен, только когда чаты скачаны. Сервер MAX ищет лишь в одном названном чате, а всё
остальное читает только архив: поиск по всем чатам, подсчёт `stats`, поиск по темам, `has:`, `filename:`,
regex, presets, метки и формы слов. Скачивание идёт с вашего аккаунта, поэтому его запускаете вы (агент —
только с вашего согласия и по одному чату). Чтобы скачать все чаты сразу:

```sh
max personal messages sync --all --background     # последние 90 дней каждого чата, в фоне
```

```sh
max personal store jobs show                    # сколько уже скачано
```

Один запуск скачивает не больше 1200 сообщений на чат по умолчанию; повторите команду, чтобы
продолжить. `--since-time 365d` — дальше в прошлое; один чат — `max personal messages sync Друзья`
([скачать историю чата](/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 personal serve`.

Каждый поиск говорит, что он просмотрел. Если архив мог бы держать больше или ничего не нашлось, в терминале
одна строка: сколько сообщений и чатов просмотрено, сколько чатов не скачано или отстаёт, и команда, которая
это исправит:

```text
searched 12,430 messages in 37 chats — 5 never fetched; `max personal messages sync <chat>` fetches one
```

С `--json` то же — запись `coverage` в `missing` и шаг `messages.sync` в `next`. Если ничего
не нашлось, а `next` задан, выполните эту команду (или попросите агента), прежде чем решать, что
сообщения нет.

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

## Слова и фразы [#слова-и-фразы]

```sh
max personal search messages счёт
```

```sh
max personal search messages '"счёт оплачен"'             # слова подряд
```

```sh
max personal search messages 'кафе OR библиотека'
```

```sh
max personal search messages '(кафе OR библиотека) NOT шумно'
```

```sh
max personal search messages 'квартир*'                   # все слова, которые начинаются на «квартир»
```

Слова рядом должны быть в сообщении все. Поиск находит формы слов: `квартира` найдёт «квартиру».
Кавычки сохраняют порядок слов, но тоже допускают другие формы. Для точной формы используйте
`exact:квартира` или добавьте `--exact` для слов без указанного поля. Явное `text:` по-прежнему ищет
формы. Регистр, ударения, `ё` и `е` не различаются. Опечатки в написанном тексте сообщений не исправляются. Формы определяются настройками языка архива.

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

## Люди и чаты [#люди-и-чаты]

```sh
max personal search messages 'from:"Алиса Тестова" счёт'
```

```sh
max personal search messages 'from:("Алиса Тестова" OR "Борис Тестов") библиотека'
```

```sh
max personal search messages 'from:me date:7d'            # что вы писали за неделю
```

```sh
max personal search messages 'chat:"Книжный клуб" библиотека'
```

```sh
max personal search messages 'паспорт kind:private'       # только личные переписки
```

`kind:` принимает `private` (личные), `group`, `channel`, `saved` (Избранное) и `bot`. Искать во всех
аккаунтах архива — `--source all`.

## Даты [#даты]

```sh
max personal search messages 'date:today'
```

```sh
max personal search messages 'библиотека date:yesterday'
```

```sh
max personal search messages 'счёт date:7d'               # от 7 дней назад до сейчас; также 30m, 2h
```

```sh
max personal search messages 'счёт date:[2026-01-01 TO 2026-02-01}' --timezone Europe/Madrid
```

`today`, `yesterday` и календарные даты — это дни в часовом поясе компьютера; `--timezone` выбирает
другой. В диапазоне `[` и `]` включают этот день, `{` и `}` исключают.

## Файлы и ссылки [#файлы-и-ссылки]

```sh
max personal search messages 'has:file'
```

```sh
max personal search messages 'filename:*.pdf'
```

```sh
max personal search messages 'filename:*договор*'         # часть имени
```

```sh
max personal search messages 'size>10MB'
```

```sh
max personal search messages 'size:[1KB TO 300KB]'
```

```sh
max personal search messages 'has:photo chat:"Книжный клуб"'
```

```sh
max personal search messages 'has:link AND "github.com"'  # ссылка на сайт
```

Файл находится по имени и размеру, даже если в сообщении нет текста. `filename:` сравнивает имя
целиком, без учёта регистра, ударений и `ё`. Размеры — в KB, MB и GB по 1024. MAX не сообщает тип
файла, поэтому ищите по расширению: `filename:*.pdf`, а не `mime:`. `has:` принимает ещё `attachment`,
`video`, `audio`, `voice`, `sticker`, `contact`, `location` и `poll`. Ссылка считается, если она в
тексте или только в карточке ссылки. Телефон, адрес почты, сайт ссылки или подтверждённого человека из
текста находят поля `phone:`, `email:`, `url:`, `domain:` и `mentions:`; см.
[Упоминания](/llms.mdx/docs/ru/max/query-language/content.md#%D1%83%D0%BF%D0%BE%D0%BC%D0%B8%D0%BD%D0%B0%D0%BD%D0%B8%D1%8F).

## Текст внутри файлов [#текст-внутри-файлов]

`content:` ищет текст внутри вложений: PDF, документа Word, скана. Сначала текст нужно извлечь в архив —
это делает `max` или ваш агент. Подробнее о файлах — [вложения](/llms.mdx/docs/ru/max/attachments/content.md).

```sh
max personal attachments extract --chat "Книжный клуб" --download --output-dir ./files
```

```sh
max personal search messages 'content:договор'
```

```sh
max personal attachments list 'chat:"Книжный клуб" is:needs_text'
```

```sh
max personal attachments update "Книжный клуб" 204 --text-file ./scan.txt
```

`attachments extract` читает на этом компьютере обычные текстовые файлы, DOCX и PDF с текстовым слоем.
`--download` требует `--output-dir`; без них извлечение читает уже скачанные файлы. Если в сообщении
несколько вложений, укажите одно через `--attachment`, начиная с 1.

Локальное извлечение читает также UTF-16 с BOM, уверенно определённые старые кодировки, ODT, ODS,
XLSX, PPTX и EPUB — без модели и без дополнительной установки. Порядок листов, слайдов и глав
сохраняется, как и сохранённые значения ячеек; формулы не вычисляются, текст внутри картинок не
читается. Неоднозначную кодировку должен проверить или перевести ваш агент. Исходные файлы не меняются.
Для DOCX, ODT, ODS, XLSX, PPTX и EPUB предел — 1000 частей архива и 50 МиБ в распакованном виде, не больше
10 МиБ на одну текстовую часть XML/HTML; испорченный или неполный результат не индексируется как полный
текст. Неудачное локальное чтение можно повторить; текст агента и прежний хороший индекс защищены.

Для PDF нужен необязательный пакет `unpdf`, для DOCX — `mammoth`, установленный там же, где `max`. При
глобальной установке npm: `npm install -g unpdf mammoth`. Если пакета нет, команда сообщает об этом;
текст может записать агент.

**Фото и сканы** текстового слоя не имеют. Агент по умолчанию читает их своими средствами OCR или
зрения и записывает текст через `attachments update`. `attachments list is:needs_text` даёт ему
сохранённый путь, ссылку на сообщение и номер вложения; команда показывает пути и состояние текста, но
не сам текст. Проверьте запись поиском `content:`. Если агент работает на другом компьютере, путь на
MCP-сервере не передаёт ему файл: для чтения нужен доступ к файлу. Такой агент может получить байты
сохранённого файла частями и проверить их хеш через [attachments show](/llms.mdx/docs/ru/max/attachments/content.md); сама передача
текст не распознаёт и не индексирует, поэтому текст всё равно записывается через `attachments update`.

**Много сканов сразу** можно передать выбранному вами сервису моделей. Укажите провайдера и модель со
зрением в `models.ocr`; ключ хранится обычной командой `models keys set`. В примере замените
`your-vision-model` именем своей модели.

```sh
max personal config set models.ocr.provider openai
```

```sh
max personal config set models.ocr.model your-vision-model
```

```sh
max personal models keys set openai
```

```sh
max personal attachments extract --chat "Книжный клуб" --ocr --concurrency 4 --limit 100 --json
```

`--ocr` передаёт изображения выбранному сервису; без него модель не вызывается. Одновременно — от 1 до
8 запросов, по умолчанию 4. Лимит файлов — 1–500, по умолчанию 100; `cursor` из ответа продолжает
ограниченный обход. Сканы PDF требуют необязательных `unpdf` и `@napi-rs/canvas`; за один документ
обрабатывается не больше 20 страниц. Страницы с текстовым слоем остаются локальными. Повтор использует
хеш файла и выбранную модель. Текст агента и прежний индекс сохраняются при ошибке или отмене OCR.
Проверьте `failed` и статусы отдельных файлов; после ограничения провайдера новые запросы этого запуска
прекращаются. `--offline` с `--ocr` несовместим.

**Файлы, которые у вас уже есть.** `max personal attachments extract --chat <чат> --from-dir ./files` читает
одну папку, без вложенных папок. Нужен однозначно совпадающий исходный файл или полный набор файлов с
именами загрузчика. Не сочетайте `--from-dir` с `--download` или `--output-dir`.
`max personal messages download <чат> <id> --extract` извлекает текст только из файлов, скачанных этим запуском;
`--all --extract` делает то же для всего запуска. Изменившиеся файлы видны по хешу, а текст, записанный
агентом, сохраняется. Через MCP ограниченное извлечение возвращает `cursor` для продолжения и сведения
о файлах, без их текста.

Из `--from-dir` нельзя читать известные файлы и папки с учётными данными, собственные папки CLI
и хранилище сообщений; обычные скрытые рабочие папки разрешены. При загрузке через MCP `output_dir`
также должен быть вне защищённых мест. У чтения текста PDF нет отдельного предела страниц или
30-секундного срока; действуют отмена команды и ограничения размера файла и текста.

## Пароли, коды и карты [#пароли-коды-и-карты]

```sh
max personal search messages 'preset:secret kind:saved'   # что-то похожее на пароль или токен в Избранном
```

```sh
max personal search messages 'preset:card'
```

Preset находит сообщения, которые *похожи* на пароль, код входа, ключ API, номер карты или IBAN,
паспорт, телефон, email или ссылку. Проверяется только вид: это не доказывает, что пароль работает
или карта настоящая. Полный список — в [языке запросов](/llms.mdx/docs/ru/max/query-language/content.md#preset).

## Метки [#метки]

```sh
max personal tags add work --chat "Книжный клуб"
```

```sh
max personal tags add work --contact "Борис Тестов"
```

```sh
max personal tags list tag:work type:chat
```

```sh
max personal search messages 'tag:work счёт'
```

```sh
max personal search messages 'счёт NOT tag:work'
```

```sh
max personal tags remove work --chat "Книжный клуб"
```

Метка — ваша собственная пометка на чате, человеке или одном сообщении (`--message <id> --chat <чат>`).
Она хранится только в локальном архиве и в MAX не отправляется. `tag:work` находит сообщения с меткой
`work`, сообщения в чате с этой меткой и сообщения от человека с этой меткой. Метка — 1–32 символа: латинские
буквы a–z, цифры и дефис.

Метки групп и каналов можно получить автоматически — по названию, имени и описанию, без сообщений и без
модели:

```sh
max personal metadata sync --chat "Книжный клуб"   # прочитать описание чата из MAX (сам чат не меняется)
```

```sh
max personal metadata sync --only-missing          # все сохранённые группы и каналы, у которых описание ещё не читалось
```

```sh
max personal tags rebuild --dry-run                      # что получилось бы, без записи
```

```sh
max personal tags rebuild                                # записать автоматические метки
```

```sh
max personal tags list sources:auto                  # только автоматические
```

Автоматическая метка не трогает ваши: повторный запуск убирает только устаревшие автоматические. Если вы
сами поставите метку, которую уже дала автоматика, она станет вашей.

`max personal tags rebuild` обрабатывает до 50 чатов за запуск; `--limit` поднимает предел до 500, а `--chat`
выбирает чаты (его можно повторить). `--dry-run` берёт сохранённые описания. Чтобы перед разметкой
прочитать свежие, добавьте `--sync-first` без `--dry-run`. Сохранённое описание показывает
`max personal metadata show --chat <чат>`.

## Сохранённые поиски и история [#сохранённые-поиски-и-история]

```sh
max personal searches create meetings 'библиотека OR кафе' --chat "Книжный клуб"
```

```sh
max personal search messages --saved meetings
```

```sh
max personal search messages --saved meetings 'date:today'   # слова добавляются через AND
```

```sh
max personal stats messages show --saved meetings --by day
```

```sh
max personal searches list
```

```sh
max personal searches history --limit 10
```

```sh
max personal search messages --saved 42                   # строка истории, по её номеру
```

`searches create` сохраняет запрос с опциями и ничего не запускает; занятое имя — только с
`--replace`. Опции, набранные вместе с `--saved`, заменяют сохранённые. Сохранённый текст разбирается
заново при каждом запуске, поэтому `date:7d` всегда значит последние 7 дней. `searches show` печатает
один поиск, `searches delete` удаляет.

Каждый успешный поиск и подсчёт попадает в историю: запрос и опции, но не найденные сообщения.
Хранятся последние 1000 запусков. `--no-record` не записывает один запуск, в MCP — `record: false`;
`searches clear` очищает историю, сохранённые поиски остаются. Эта история отдельна от записей
`max personal runs`.

Сохранённые поиски и история лежат в архиве, общем для `max` и `tg`: обе программы видят одни и те
же, и `delete` или `clear` в одной меняет их и в другой. Метки остаются при своём аккаунте.

## Подсчёт: `stats messages show` [#подсчёт-stats-messages-show]

```sh
max personal stats messages show счёт                          # сколько в каждом чате
```

```sh
max personal stats messages show 'date:7d' --by sender
```

```sh
max personal stats messages show 'from:me' --by day --timezone Europe/Madrid
```

```sh
max personal stats messages show --by hour                     # все сохранённые сообщения
```

`stats messages show` считает сообщения, которые нашёл бы `search messages` с тем же запросом, каждое один
раз. `--by chat` (по умолчанию) и `--by sender` — больше всего сверху; `--by day` и `--by hour` — по
порядку. Если часть чатов сохранена не целиком, числа — нижняя граница, и stderr говорит, сколько
таких чатов.

## Поиск на сервере MAX: `--backend` [#поиск-на-сервере-max---backend]

Когда в запросе есть слова и не задан `--discover`, `max` по умолчанию спрашивает и сервер, и архив
(`--backend both`). `--discover` всегда читает только архив, в том числе с `--backend both`.

С чатом (`chat:` в запросе) сервер ищет в этом чате. Без чата сервер ищет во всех чатах так же, как строка
поиска на web.max.ru: одним запросом, и из каждого чата возвращает одно сообщение — лучшее совпадение. Остальные
совпадения в этих чатах находит архив, если они в нём есть. Название чата и публичные каналы в ответ не попадают.

```sh
max personal search messages 'счёт chat:"Книжный клуб"'                    # архив и сервер MAX, один чат
```

```sh
max personal search messages 'счёт'                                          # архив и сервер MAX, все чаты
```

```sh
max personal search messages 'счёт chat:"Книжный клуб"' --backend server   # только то, что нашёл сервер
```

```sh
max personal search messages 'счёт' --backend archive                        # только архив
```

Сервер находит слово и по началу, но не другие его формы: `книгу` не найдёт «книга». Поэтому `max` берёт его
ответ как кандидатов: сохраняет их в архив и проверяет вашим запросом по правилам архива. `exact:`, `-слово`,
кавычки и порядок результатов значат то же, что и без сервера, а сообщение не повторяется. `max` ждёт сервер
не дольше 5 секунд (`--server-time`, до 60 с) и ничего не помечает прочитанным.

С `--json` у каждого сообщения есть `found_in` (`archive`, `server` или `both`). При поиске в обоих источниках недоступный сервер или профиль только для чтения оставляют ответ
из архива. Явный `--backend server` отказывает, если профиль не разрешает серверный поиск. Разрешение —
`messages.server-search`.

## Сначала скачать новое: `--sync-first` [#сначала-скачать-новое---sync-first]

```sh
max personal search messages 'счёт chat:"Книжный клуб"' --sync-first
```

`--sync-first` сначала скачивает новые сообщения, ничего не помечая прочитанным: не больше 5 чатов,
500 сообщений и 30 секунд. Пределы меняют `--max-chats`, `--max-messages`, `--sync-time`. Если
скачивание не удалось или кончилось раньше, вы всё равно получаете результат из архива — с отметкой об
устаревшем покрытии и сведениями о скачивании.

## Сообщения вокруг находки [#сообщения-вокруг-находки]

`--newest` упорядочивает по времени, а не по близости, а `--context 2` показывает по два сообщения до и
после каждого найденного (по умолчанию 2 в терминале и 0 в остальных режимах).

`--thread` показывает вокруг каждой находки цепочку ответов и ответы на неё вместо соседей по времени.
Он идёт по связям ответов, сохранённым в архиве, а у `messages context` тоже заменяет соседей по
времени. Пределы: 8 переходов, 50 сообщений, 65 536 байт и сутки по обе стороны. Их меняют
`--thread-hops`, `--thread-messages`, `--thread-bytes`, `--thread-within`. Если связей нет, используется
контекст по времени; устаревшие связи помечаются и не обходятся. `messages context` с `--offline`
читает только сохранённое.

## Результат в JSON [#результат-в-json]

В терминале `max` печатает ленту для чтения. `--json` возвращает один объект с сообщениями и тем, где
искали; `--jsonl` — только сообщения, построчно. Поля ответа — в
[справке по языку запросов](/llms.mdx/docs/ru/max/query-language/content.md#%D0%BE%D1%82%D0%B2%D0%B5%D1%82).

## Если ничего не нашлось [#если-ничего-не-нашлось]

Пустой ответ значит «нет в архиве, где искали», а не «никогда не отправлялось». Что сохранено,
покажет `max personal store status`, дополнить — `max personal messages sync`. С `--json` ответ говорит, какие чаты
просмотрены и насколько они полны, даже без совпадений. Если `max` просит `max personal store migrate`, индекс
слов ещё строится; поиск без слов (`has:file`, `date:today`) работает уже сейчас.

**Пробелы в истории чата.** `max personal store gaps show <чат>` на этом компьютере показывает разрывы между
сохранёнными кусками истории. Пропуски номеров сообщений и тишина сами по себе не означают потерянную
историю; края сохранённой истории остаются `unknown`. Проверьте план, затем
`max personal store gaps repair <чат> --fingerprint <хеш>` скачает разрывы. По умолчанию — до 5 разрывов, 500
сообщений и 30 секунд; пределы задают `--max-gaps`, `--limit`, `--repair-time`, `--page-size` и
`--pause`. Повторный запуск проверяет оставшиеся разрывы и не удаляет сообщение только потому, что MAX
его не вернул. Неоднозначные страницы с одинаковым временем остаются незавершёнными. `--background`
запускает задание, за которым следят `store jobs show`, `store jobs list` и `store jobs cancel`. Для
ремонта нужны разрешение `store.gaps.repair` и чтение сообщений; план к серверу не подключается. Через
MCP эти команды находятся через `max_tools_search`, план и задания читаются через `max_read`, ремонт —
через `max_write`.

**Подготовить поиск по темам при скачивании.** `max personal messages sync <чат> --catch-up` сразу после загрузки
строит разговоры и локальные векторы только этого чата — для [поиска по темам](/llms.mdx/docs/ru/max/topic-search/content.md). По
умолчанию это выключено; настройка профиля `search_catch_up: true` включает, а `--no-catch-up` отменяет на
один запуск. Границы: `--catch-up-chunks 500 --catch-up-messages 10000 --catch-up-time 30s`. Модель
автоматически не скачивается, удалённый сервис не вызывается. Поле `prepared` отдельно сообщает,
завершилась ли подготовка; скачанная история сохраняется в любом случае.

## Дальше [#дальше]

- [Поиск по темам](/llms.mdx/docs/ru/max/topic-search/content.md) — найти обсуждение по тому, о чём оно было, когда слов не помните.
- [Язык запросов](/llms.mdx/docs/ru/max/query-language/content.md) — каждое поле, оператор, предел и ответ в JSON.
- [Как устроен поиск](/llms.mdx/docs/ru/search-architecture/content.md) — техническая страница: индекс
  слов, граф разговоров, векторы и порядок результатов.

## Картинки: поиск по тому, что на них изображено [#картинки-поиск-по-тому-что-на-них-изображено]

Поиск по картинкам выключен, пока вы его не включили. Он работает отдельно для каждого профиля, на
этом компьютере: картинка скачивается через MAX по одной, превращается в вектор из 512 чисел и
удаляется; в архиве остаются только вектор и контрольная сумма файла.

```sh
max personal config set picture_search true
max personal images models download clip-b32
max personal images embed
```

`images models download clip-b32` скачивает модель один раз (около 155 МБ). `images embed` обрабатывает
картинки, у которых ещё нет вектора, и продолжает с того места, где остановился; `--chat <чат>` и
`--limit <n>` ограничивают объём. Ничего не помечается прочитанным.

После этого поиск по словам возвращает рядом с находками список `pictures`: сообщения, чья картинка
ближе всего к запросу (`ref`, `score`). Он не смешивается с ранжированием по тексту. Запрос для
картинок должен быть **английским**: текстовая часть модели не знает других языков, поэтому агент
сначала переводит запрос. Без `picture_search` списка `pictures` нет; если настройка включена, а модели нет,
`pictures_skipped` говорит об этом.
