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

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

Вам нужно найти что-то написанное: сообщение, соглашение, отправленный кем-то файл, код, полученный несколько месяцев назад. На этой странице показано, как искать все, что tg сохранил на этом компьютере — сообщения Telegram и заметки, импортированные [memo](https://github.com/WireCatLabs/cli-memo), — и как одновременно обратиться к поиску Telegram.

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

Термины, используемые на этой странице:

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

## Когда помните вопрос, а не точную формулировку [#когда-помните-вопрос-а-не-точную-формулировку]

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

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

```sh
tg personal search messages 'What time does Helix export run? chat:990' --discover --json
```

Это поиск только в локальном архиве. Ограничения чата, автора и даты сохраняются. В MCP передайте `discover: true` инструменту поиска сообщений. `discovery` у каждого элемента говорит, какая часть запроса совпала: `missing_terms` показывает отсутствующие слова, а `parent` связывает прямой ответ с подходящим родителем. Высокая оценка не означает уверенность в ответе: первым может быть вопрос, предложение или старое решение. Прочитайте основания и проверьте [покрытие архива](/llms.mdx/docs/ru/tg/archive/content.md), прежде чем считать факт отсутствующим.

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

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

Каждый поиск выполняется одной группой команд `tg personal search`. Если вы не знаете, где что-то было написано, начните с `search all`.

| Задача | Команда |
|---|---|
| Поиск сообщений и заметок в одном ответе; без `--offline` также на сервере Telegram | `tg personal search all '<query>'` |
| Искать только сообщения Telegram; без `--discover` — также на сервере Telegram | `tg personal search messages '<query>'` |
| Поиск почты | В Memo: установите @wirecat/cli-memo и выполните `memo search mail '<query>'` |
| Поиск заметок, созданных в memo или импортированных из папки | `tg personal search notes '<query>'` |
| Найдите обсуждение по тому, о чем оно было | `tg personal search conversations '<question>'` ([поиск по теме](/llms.mdx/docs/ru/tg/topic-search/content.md)) |
| Найдите тему в группе форума по ее названию | `tg personal search topics <chat> '<words>'` |
| Подсчитайте совпадения по чату, отправителю, дню или часу | `tg personal stats messages show '<query>'` |
| Сохранить поиск и запустить его позже | `tg personal searches create`, `tg personal search messages --saved <name>` |

```sh
tg personal search all 'lease agreement'          # messages and notes, best match first
```

```sh
tg personal search all 'lease' --only notes       # notes only
```

```sh
tg personal search messages 'lease chat:"Book club"'  # Telegram messages only, never mail
```

```sh
tg personal search notes 'budget source:internal'  # only notes written in memo
```

```sh
tg personal search conversations 'moving to the country'  # conversations close in meaning
```

```sh
tg personal search topics "Hiking" "gear"         # topic titles in one forum group
```

Как и `search messages`, `search all` по умолчанию тоже отправляет слова запроса во встроенный поиск Telegram
(`--backend both`, [ниже](#asking-telegram-too---backend)); заметки ищутся только здесь. Чтобы запрос остался на этом
компьютере, добавьте `--offline` (тогда tg вообще не подключается) или `--backend archive`.

```sh
tg personal search all 'lease agreement' --offline  # the store only; nothing is sent to Telegram
```

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

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

Остальная часть этой страницы посвящена поиску сообщений, `tg personal search messages`. Без `--discover` он читает локальный архив и запрашивает собственный поиск Telegram ([ниже](#asking-telegram-too---backend)).

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

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

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

> Найди сообщение «invoice paid» в чате Book club. Покажи совпадение и пробелы в истории.

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

```sh
tg personal search messages '"invoice paid" chat:"Book club"' --backend archive --json
```

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

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

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

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

Хороший поиск требует, чтобы ваши чаты были загружены. Поиск Telegram находит сообщение по словам, даже если tg его так и не получил, а все остальные операции читают только архив: подсчет по `stats`, поиск по теме, `has:`, `filename:`, регулярное выражение, пресеты, теги и ранжирование словоформ. Начните с загрузки каждого чата:

```sh
tg personal messages sync --all --background  # the last 90 days of every chat, as a background job
```

```sh
tg personal store jobs show           # how far it got
```

По умолчанию при каждом запуске загружается не более 1000 сообщений в чате; повторите это, чтобы продолжить загрузку активного чата. Добавьте `--since-time 365d`, чтобы вернуться назад, или получите один чат с `tg personal messages sync "Book club"` ([загрузить историю чата](/llms.mdx/docs/ru/tg/archive/content.md#fetch-a-chats-history)). После этого `tg personal serve` поддерживает актуальность хранилища.

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

```text
searched 12,430 messages in 37 chats — 5 never fetched; `tg personal messages sync --all --background` fetches them
```

С `--json` `coverage` содержит то же самое: `messages`, `chats`, до десяти чатов `attention` и `next`. Если ничего не найдено и установлен `next`, запустите эту команду или попросите об этом своего агента, прежде чем вы решите, что сообщение не существует.

Заключайте запрос в одинарные кавычки, чтобы оболочка не трогала его кавычки и скобки. Имена ниже —
примеры; подставляйте свои чаты и людей.

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

```sh
tg personal search messages invoice
```

```sh
tg personal search messages '"invoice paid"'     # words together
```

```sh
tg personal search messages 'cafe OR library'
```

```sh
tg personal search messages '(cafe OR library) NOT loud'
```

```sh
tg personal search messages 'invoic*'            # every word that starts with "invoic"
```

Все слова, записанные в запросе рядом, должны присутствовать в сообщении. Поиск включает формы слов в соответствии с языковыми настройками архива: `piso` может найти `pisos`. Кавычки объединяют слова в фразу, но тоже допускают словоформы. Используйте `exact:piso` или добавьте `--exact` для слов без явного поля. Явный `text:` по-прежнему соответствует формам. Регистр и акценты игнорируются. Опечатки в написанном тексте сообщений не исправляются.

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

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

```sh
tg personal search messages 'from:"Alice Synthetic" invoice'
```

```sh
tg personal search messages 'from:("Alice Synthetic" OR "Bob Synthetic") library'
```

```sh
tg personal search messages 'from:me date:7d'    # what you wrote this week
```

```sh
tg personal search messages 'chat:"Book club" library'
```

```sh
tg personal search messages 'passport kind:private'  # one-to-one chats only
```

`kind:` принимает `private`, `group`, `channel`, `saved` (сохраненные сообщения) и `bot`. `topic:` придерживается одной темы форума группы; ему нужна эта группа в `chat:`. Для поиска по каждому аккаунту в архиве добавьте `--source all`.

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

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

```sh
tg personal search messages 'library date:yesterday'
```

```sh
tg personal search messages 'invoice date:7d'    # from 7 days ago until now; also 30m, 2h
```

```sh
tg personal search messages 'invoice date:[2026-01-01 TO 2026-02-01}' --timezone Europe/Madrid
```

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

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

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

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

```sh
tg personal search messages 'filename:*contract*'  # part of the name
```

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

```sh
tg personal search messages 'mime:image'         # any picture sent as a file
```

```sh
tg personal search messages 'mime:"application/pdf"'  # quote a full type
```

```sh
tg personal search messages 'has:photo chat:"Book club"'
```

```sh
tg personal search messages 'has:link AND "github.com"'  # a link to a site
```

Файл находится по имени, размеру и типу, даже если в сообщении нет текста. `filename:` сравнивает
имя целиком, без учёта регистра и диакритических знаков. Размеры — в KB, MB и GB по 1024. `has:` также принимает `attachment`,
`video`, `audio`, `voice`, `sticker`, `contact`, `location` и `poll`. Ссылка учитывается, если она есть в
тексте или только в карточке предпросмотра. Чтобы найти телефон, адрес почты, сайт ссылки или подтверждённого человека,
упомянутых в тексте, используйте `phone:`, `email:`, `url:`, `domain:` и `mentions:`; см.
[Упоминания](/llms.mdx/docs/ru/tg/query-language/content.md#mentions).

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

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

```sh
tg personal attachments extract --chat "Book club" --download --output-dir ./files
```

```sh
tg personal search messages 'content:invoice'
```

```sh
tg personal attachments list 'chat:"Book club" is:needs_text'
```

```sh
tg personal attachments update "Book club" 204 --text-file ./scan.txt
```

`attachments extract` читает на этом компьютере обычный текст, файлы Word и 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`; Word требуется `mammoth`, установленный там, где находится `tg`. Для глобальной установки npm: `npm install -g unpdf mammoth`. Сообщается об отсутствующем пакете; Вместо этого ваш агент может предоставить текст.

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

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

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

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

```sh
tg personal models keys set openai
```

```sh
tg personal attachments extract --chat "Book club" --ocr --concurrency 4 --limit 100 --json
```

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

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

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

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

Поиск по картинкам выключен. Он смотрит картинки на этом компьютере с помощью небольшой модели и никуда их не отправляет.
Включите его для одного профиля, один раз скачайте модель (около 155 МБ, общая для всех профилей), затем прочитайте
сохраненные картинки:

```sh
tg personal config set picture_search true
```

```sh
tg personal images models download clip-b32
```

```sh
tg personal images embed --chat "Book club" --limit 100
```

`images embed` скачивает каждую сохраненную картинку через Telegram, по одной, и ничего не отмечает прочитанным. Он хранит только
вектор и хеш картинки. После этого поиск сообщений со словами также возвращает список `pictures` рядом с
обычными результатами, никогда не смешивая его с ранжированием текста. Если настройка включена, а модели нет, сообщение в stderr говорит, что картинки не искались, и почему.

**Пишите запросы к картинкам по-английски.** Другие языки модель не знает. Агент сначала переводит запрос
(«собака на пляже» становится «dog on a beach»). `tg personal images models list` показывает, какие модели скачаны.

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

```sh
tg personal search messages 'preset:secret kind:saved'  # something that looks like a password or token
```

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

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

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

```sh
tg personal tags add work --chat "Book club"
```

```sh
tg personal tags add work --contact "Bob Synthetic"
```

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

```sh
tg personal search messages 'tag:work invoice'
```

```sh
tg personal search messages 'invoice NOT tag:work'
```

```sh
tg personal tags remove work --chat "Book club"
```

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

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

```sh
tg personal metadata sync --chat "Book club"  # read the chat's description from Telegram; the chat is not changed
```

```sh
tg personal metadata sync --only-missing  # every stored group and channel with no description read yet
```

```sh
tg personal tags rebuild --dry-run          # what it would tag, without writing
```

```sh
tg personal tags rebuild                    # write the automatic tags
```

```sh
tg personal tags list sources:auto      # only the automatic ones
```

`--sync-first` перед классификацией читает из Telegram актуальные описания; вместе с
`--dry-run` этот флаг не принимается, потому что `--dry-run` берёт сохранённые описания. Один запуск обрабатывает не больше 500 чатов, по умолчанию 50 (`--limit`).

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

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

```sh
tg personal searches create meetings 'library OR cafe' --chat "Book club"
```

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

```sh
tg personal search messages --saved meetings 'date:today'  # extra words are added with AND
```

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

```sh
tg personal searches list
```

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

```sh
tg personal search messages --saved 42           # a row of the history, by its number
```

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

Каждый успешный поиск и подсчет записываются в историю: запрос и его параметры, а не найденные сообщения. Сохраняются самые новые 1000 запусков. `--no-record` пропускает запись одного запуска; для MCP `tg personal mcp serve --no-record` или `record`, установленный в `false`, пропускает запись вызовов сервера. `searches clear` очищает историю и сохраняет сохраненные поисковые запросы. Эта история отделена от записей запуска `tg personal runs`.

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

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

```sh
tg personal stats messages show invoice               # how many in each chat
```

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

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

```sh
tg personal stats messages show --by hour             # every stored message
```

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

## Поиск также в Telegram: `--backend` [#поиск-также-в-telegram---backend]

Telegram может выполнять поиск в собственной копии ваших чатов, включая сообщения, которые никогда не получались. Без `--discover` по умолчанию tg запрашивает Telegram и архив за один проход (`--backend both`). `--backend server` показывает только результаты Telegram, а `--backend archive` выполняет поиск только в архиве. `--discover` всегда читает только архив, в том числе с `--backend both`.

```sh
tg personal search messages 'invoice' --backend both
```

```sh
tg personal search messages 'invoice chat:"Book club" from:Olga' --backend both
```

```sh
tg personal search messages 'invoice date:2026-09' --backend server --server-time 10s
```

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

Telegram получает только обязательные слова вашего запроса, один чат, отправителя вместе с чатом и даты.
`OR` создаёт до трёх поисковых запросов. Отрицания, подстановочные знаки, `has:`, `tag:` и предустановки tg применяет
после этого. Запрос без слов не обращается к Telegram. tg ждёт не более 5 секунд (`--server-time`,
до 60 с) и получает до 100 сообщений на поисковый запрос; более поздний ответ отбрасывается. Сообщения не помечаются прочитанными.

В `--json` в каждом сообщении указано, откуда оно пришло (`source`: `archive`, `server` или `both`), а в блоке `server` указано, что Telegram вернул, а что не удалось. `--backend both` никогда не выходит из строя из-за Telegram: оффлайн, без разрешения или без слов отвечает из архива и говорит почему. Вместо этого `--backend server` отказывается. Разрешение — `messages.server-search`; профиль, доступный только для чтения, отвечает из архива. `stats messages show` учитывает только архив: подсчет Telegram следует своим собственным правилам, а не вашему запросу.

## Сначала получить новые сообщения: `--sync-first` [#сначала-получить-новые-сообщения---sync-first]

```sh
tg personal search messages 'invoice chat:"Book club"' --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]

На терминале tg печатает читаемую расшифровку. `--json` возвращает один объект с сообщениями и тем, что было найдено; `--jsonl` выводит по одному элементу на строку, затем итоговую запись с полнотой результата и данными о страницах. Поля ответа находятся в [справке по языку запроса](/llms.mdx/docs/ru/tg/query-language/content.md#the-answer).

## Если ничего не найдено [#если-ничего-не-найдено]

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

**Пробелы в истории чата.** `tg personal store gaps show <chat>` ищет на этом компьютере пробелы между участками истории, хранящимися в архиве. Отсутствующие идентификаторы сообщений и периоды молчания сами по себе не доказывают отсутствие истории; края сохраненной истории остаются `unknown`. Проверьте план, затем запустите `tg personal store gaps repair <chat> --fingerprint <hash>`, чтобы загрузить пробелы. По умолчанию — пять пробелов, 500 сообщений и 30 секунд; `--max-gaps`, `--limit`, `--repair-time`, `--page-size` и `--pause` устанавливают границы. Повтор исправляет оставшиеся пробелы и никогда не удаляет сообщение, потому что Telegram его не вернул. Страницы, на которых несколько сообщений имеют одну временную метку, остаются в ожидании. `--background` запускает его как задание, за которым следуют `store jobs show`, `store jobs list` и `store jobs cancel`. Для восстановления требуется разрешение на запись `store.gaps.repair` и разрешение на чтение сообщений. В MCP те же команды можно найти через `tg_tools_search` и запустить через `tg_read` или `tg_write`; задания относятся к одному профилю.

**Подготовьте поиск по теме во время загрузки.** `tg personal messages sync <chat> --catch-up` строит разговоры в этом чате и вычисляет его локальные векторы сразу после получения для [поиска по теме](/llms.mdx/docs/ru/tg/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/tg/topic-search/content.md): найдите обсуждение по тому, о чем оно было, когда вы не помните его слов.
- [Язык запроса](/llms.mdx/docs/ru/tg/query-language/content.md): каждое поле, оператор, предел и ответ в формате JSON.
- [Как работает поиск](/llms.mdx/docs/ru/search-architecture/content.md): техническая страница — индекс слов, граф обсуждений, векторы и порядок ранжирования результатов.
