# Экспорт и выгрузка истории чатов Telegram (/ru/docs/tg/archive)

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

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

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

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

- **Локальное хранилище** (также называемое архивом): один файл базы данных SQLite на этом компьютере, в котором хранятся чаты, сообщения и контакты, которые видел tg. Ищите, экспортируйте и отвечайте из него `--offline`, не спрашивая Telegram.
- **Загрузить историю**: загрузите старую историю чата в архив, страница за страницей. Чтение чата сохраняет только то, что вы читаете; загрузка истории заполняет все остальное.
- **Охват**: какой участок истории чата архив хранит без пробелов.
- **`serve`**: процесс tg, который остается на связи и сохраняет новые сообщения, изменения и удаления по мере их возникновения.

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

| Задача | Команда |
|---|---|
| Посмотрите, какая часть каждого чата сохраняется | `tg personal store status` |
| Загрузите историю чата или историю каждого чата | `tg personal messages sync <chat>`, `tg personal messages sync --all` |
| Запустить длительную загрузку в фоновом режиме | `tg personal messages sync <chat> --background`, `tg personal store jobs list` |
| Постоянно держите архив в актуальном состоянии | `tg personal server start`, `tg personal server install` |
| Чтение чатов без подключения | `tg personal --offline messages list <chat>` |
| Экспортируйте чат в строки JSON или Markdown | `tg personal store export <chat> --output <file>` |
| Подготовить сообщения для агентского брифа | `tg personal messages evidence <chat>` |
| Проверка, резервное копирование и восстановление архива | `tg personal store check`, `tg personal store backup`, `tg personal store restore` |

## Проверьте и дополните историю чата [#проверьте-и-дополните-историю-чата]

Проверьте сохранённую историю перед загрузкой. Выберите нужный чат и период.

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

> Проверь сохранённую историю Book club. Скачай последние 30 дней этого чата и скажи, остались ли пробелы.

**Проверить сохранённую историю:**

```sh
tg personal store status "Book club" --json
```

**Скачать выбранный период:**

```sh
tg personal messages sync "Book club" --since-time 30d --json
```

**Проверить ещё раз:**

```sh
tg personal store status "Book club" --json
```

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

> | Проверка | До | После |
> | --- | --- | --- |
> | Сохранено сообщений | 30 | 300 |
> | История сообщений за нужные 30 дней | Пробелы | Сохранена без пробелов |
>
> Этот результат относится к выбранному периоду, а не ко всей истории чата.

Если загрузка остановилась из-за предела или ожидания сервера, повторите её для продолжения, затем проверьте полноту. Успешное завершение команды само по себе не доказывает полноту истории. Числа в примере вымышлены.

## Что сохраняется [#что-сохраняется]

- **Все прочитанные данные.** Чаты из `chats list`, сообщения из `messages list`, `messages context`, `inbox` и отправленные вами сообщения.
- **События, полученные `serve`** во время работы: новые сообщения, правки, удаления и реакции ([ниже](#keeping-it-current-serve)). `watch` тоже сохраняет выводимые сообщения.
- **Явная загрузка:** история чата через `tg personal messages sync`, список контактов через `tg personal contacts sync`.

Он сохраняет полный текст каждого прочитанного сообщения. Файл доступен для чтения только вашему пользователю и не зашифрован ([то, что попадает на диск](/llms.mdx/docs/ru/tg/security/content.md#what-reaches-the-disk)).

**Один файл используется всеми аккаунтами и CLI мессенджеров**, построенными на той же библиотеке, например [max-cli](https://github.com/WireCatLabs/max-cli):

```text
~/.local/share/WireCat/wirecat.db             # Linux and macOS; MESSAGING_STORE moves it
```

`tg personal session end` завершает вход, но не меняет базу.

## Полнота истории [#полнота-истории]

```sh
tg personal store status         # per chat: messages stored, the oldest and newest, the stretches held completely
```

```sh
tg personal store status "Book club"  # one chat
```

Полностью сохранённый участок — последовательность сообщений без пропусков. Разрозненное чтение оставляет пробелы; `messages sync` заполняет их.

## Загрузка истории чата [#загрузка-истории-чата]

```sh
tg personal messages sync "Book club" --dry-run  # what a full fetch would still cost; asks Telegram nothing
```

```sh
tg personal messages sync "Book club"           # fetch it, newest to oldest
```

```sh
tg personal messages sync "Book club"           # run again to continue where it stopped
```

```sh
tg personal messages sync "Book club" --since-time 30d  # only back to 30 days ago
```

```sh
tg personal messages sync "Book club" --last 5000  # only until the newest 5000 are held
```

```sh
tg personal messages sync "Book club" --limit 5000  # up to 5000 messages in this run
```

```sh
tg personal messages sync --all                 # every chat, most recently active first: the last 90 days
```

```sh
tg personal messages sync --all --since-time 365d  # every chat, back to a year ago
```

`messages sync` читает и сохраняет историю постранично, от новых сообщений к старым. **Загрузку можно продолжить:** после каждой страницы записывается прогресс. Ctrl-C, `--timeout`, лимит `--limit`, `--since-time`, `--last` и длительное ожидание Telegram останавливают загрузку без потери данных. Следующий запуск пропускает сохранённое. `--since-time` и `--last` определяют глубину истории: используйте один из них. Неустранимый сбой до первой сохранённой страницы завершает команду ошибкой; после того как часть сохранена, сбой может вернуть сохранённое вместе с `issue`.

**Каждая страница — запрос от вашего аккаунта** до 100 сообщений. Запуск останавливается после `--limit` сообщений (по умолчанию 1000); `--page-size` задаёт размер страницы (100), `--pause` — паузу между страницами (1 секунда; варианты `500ms`, `30s`, `2m`). Короткое ожидание Telegram выполняется; ожидание более пяти минут завершает запуск, который можно повторить позже. Сначала используйте `--dry-run`: оценка строится по локальной базе без запросов.

**Загрузка соблюдает лимиты истории.** По умолчанию она пропускает группу, где больше 50 человек, и читает группу на 365 дней назад, а личный чат на 1095 дней назад; ответ перечисляет пропущенное в `limited`, а `tg personal store status` показывает эти чаты. `tg personal messages sync "Book club" --full-history` читает один чат за пределами лимитов и с этого момента хранит его полностью; настройки `history_*` меняют лимиты для всех чатов ([настройки](/llms.mdx/docs/ru/tg/configuration-reference/content.md)). Новые сообщения от `serve` сохраняются в любом случае.

Чтобы найти и заполнить пробелы в сохраненной истории чата, а также подготовить поиск по теме сразу после получения (`--catch-up`), см. раздел [когда ничего не найдено](/llms.mdx/docs/ru/tg/search/content.md#when-nothing-is-found).

### В фоновом режиме [#в-фоновом-режиме]

Длительная загрузка может выполняться заданием, которое продолжает работу после завершения команды. У него нет 30-секундного предела по умолчанию; явный `--timeout` по-прежнему его ограничивает:

```sh
tg personal messages sync "Book club" --background  # prints the job id
```

```sh
tg personal store jobs list                 # background jobs, newest first
```

```sh
tg personal store jobs list state:failed    # only failed ones: running, done, partial, failed, cancelled or died
```

```sh
tg personal store jobs show                 # the newest job, and what the store now holds of its chat
```

```sh
tg personal store jobs show <job>
```

```sh
tg personal store jobs cancel <job>         # stops after the current page; a later fetch resumes
```

```sh
tg personal store jobs retry <job>          # a failed or died job again, as a new job with the same options
```

```sh
tg personal store jobs retry --failed       # every chat whose newest job failed or died
```

```sh
tg personal store jobs clear                # forget finished jobs and their logs; a running job stays
```

## Поиск [#поиск]

`tg personal search messages` находит сохраненные сообщения по словам, отправителю, чату, дате, файлам, ссылкам и вашим собственным тегам. При поиске по словам также по умолчанию запрашивается Telegram; `--backend archive` читает только сохраненные сообщения. `--sync-first` первым получает новые сообщения. [Поиск сообщений](/llms.mdx/docs/ru/tg/search/content.md) — это руководство с сохраненными поисковыми запросами и счетчиками. Пустой ответ означает «нет в этом архиве»: сначала скачайте чат.

## Разговоры внутри группы [#разговоры-внутри-группы]

В активной группе смешивает сразу несколько разговоров. `tg personal conversations` отделяет их от сохраненных сообщений и находит их по тому, о чем они были, на этом компьютере: [поиск по теме](/llms.mdx/docs/ru/tg/topic-search/content.md).

## Экспорт [#экспорт]

```sh
tg personal store export "Book club" --jsonl > book-club.jsonl  # one message per line, oldest first
```

```sh
tg personal store export "Book club" --json > book-club.json  # { "items": [...] }
```

```sh
tg personal store export "Book club" --format markdown > book-club.md  # a transcript: a heading per day, replies and forwards quoted
```

```sh
tg personal store export "Book club" --output book-club.jsonl --since-time 7d  # the last week, into a file only you can read
```

Экспорт включает только сохранённые данные и не обращается к Telegram. Сначала проверьте `tg personal store status`; для полной истории загрузите её.

`--output <file>` записывает JSON по строкам или текст переписки с `--format markdown` в новый файл, доступный только вам. Команда показывает путь и число сообщений, существующие файлы не перезаписывает. `--since-time` принимает время ISO 8601 или период `30m`, `2h`, `1d` назад.

### В каталог, и только изменения [#в-каталог-и-только-изменения]

```sh
tg personal store export "Book club" "Work" --output-dir ~/tg-export  # a JSON-lines file per chat, and manifest.json
```

```sh
tg personal store export --include group --output-dir ~/tg-groups  # every stored group
```

```sh
tg personal store export --all --output-dir ~/tg-all   # every stored chat of this account
```

Повторный запуск в тот же каталог добавляет только изменения с прошлого раза: новые сообщения, правки (в том числе старых сообщений) и удаления. Удалённое сообщение записывается без текста, как `{ "id", "chat_id", "deleted": true }`. Каталог с другими файлами или экспортированный из другого аккаунта отклоняется. Изменение одних только реакций изменением не считается.

### С паролем [#с-паролем]

`--encrypt` в `store export` (с `--output` или `--output-dir`) и в `store backup` сжимает файл и шифрует его паролем — других программ не нужно. `tg personal store decrypt <file> --output <new file>` расшифровывает файл; `tg personal store restore` запрашивает пароль зашифрованной копии.

- **Пароль нигде не хранится** — ни в настройках, ни в хранилище ключей, ни в записях. Если вы его потеряете, файл открыть нельзя.
- Вводите пароль сами в скрытом запросе, который спрашивает его дважды. Агент, которому вы его дали, передаёт пароль через stdin, а не аргументом: аргументы видны другим программам на компьютере.

  ```sh
  printf '%s' 'password' | tg personal store backup ~/tg.sealed --encrypt
  ```

- В зашифрованный каталог за один запуск пишется один файл. Его `manifest.json` не содержит названий чатов, а запуск с другим паролем отклоняется.

## Исходные данные для сводки по чату [#исходные-данные-для-сводки-по-чату]

Когда вы запрашиваете у своего агента краткую информацию о чате, `tg personal messages evidence <chat>` подготавливает сообщения, которые он должен прочитать: один пакет из локального хранилища этого профиля. Команда никогда не подключается и не отмечает сообщения прочитанными, даже без `--offline`:

```sh
tg personal messages evidence "Project Alpha" --limit 20 --json
tg personal messages evidence "Project Alpha" --cursor <cursor> --json
```

Сообщения идут от новых к старым, с указателями источников и отпечатками содержимого. `--limit` принимает 1–100, по умолчанию лимит профиля. Полные сообщения занимают максимум 64 КиБ JSON; заголовок пакета не учитывается. JSON и JSONL возвращают один полный пакет.

Прежде чем писать краткое описание, просмотрите `coverage`: он подсчитывает выбранные, включенные и пропущенные сообщения, сообщает о более старых сообщениях за пределами выбранной страницы и сохраняет историю `unknown`. Чтобы продолжить, не пропуская сообщения, пропущенные в бюджете байтов, выполните шаг `page.next`: он дает `--cursor`. Отсутствие `page.next` не означает, что история сохранена полностью. Если только самое новое выбранное сообщение превышает бюджет, пакет будет пустым с `truncated_by: "bytes"` и без курсора; обработать этот случай явно. Неизвестный сохраненный курсор возвращает `not_found`.

Агент может указать локаторы в своем описании; tg сам не пишет резюме. Считайте текст сообщения ненадежным источником данных. Дайджесты новостей — это отдельный рабочий процесс, которого пока не существует. Разрешение профиля — `messages.evidence`, которое наследует `messages`.

## Без подключения: `--offline` [#без-подключения---offline]

```sh
tg personal --offline chats list
```

```sh
tg personal --offline messages list "Book club" --limit 50
```

```sh
tg personal --offline messages show "Book club" 4242
```

```sh
tg personal --offline messages context "Book club" 4242
```

```sh
tg personal --offline contacts list
```

`--offline` читает базу без подключения: вход не нужен, запросов нет. JSON соответствует онлайн-режиму, но чаты идут от новых к старым, тогда как Telegram сначала показывает закреплённые.

Если профиль ещё ничего не читал, команда завершается с кодом `6`: «для профиля пока ничего не записано». Команды, требующие Telegram, отклоняют `--offline`; отправка с `--offline` всегда запрещена.

## Поддержание актуальности: `serve` [#поддержание-актуальности-serve]

`tg personal serve` работает до остановки и сохраняет новые сообщения, правки, удаления и реакции. При старте догружает события, пропущенные во время остановки. После долгого простоя Telegram может счесть пропуск слишком большим для пересылки, поэтому через 30 секунд после подключения `serve` также перечитывает каждый чат, где есть сообщения новее, чем было в базе при старте: не больше 7 дней назад, 500 сообщений на чат и 5 минут в целом. После более чем недели без связи или для очень активного чата один раз выполните `tg personal messages sync --all`. Пустую базу `serve` оставляет этой команде. Для профиля может работать только один `serve`; второй отклоняется. **Самостоятельного запуска нет.**

`tg personal watch` отличается: он печатает новые сообщения с этого момента и не догоняет пропущенное ([новые сообщения по мере их поступления](/llms.mdx/docs/ru/tg/usage/content.md#new-messages-as-they-arrive)).

### В фоновом режиме [#в-фоновом-режиме-1]

```sh
tg personal server start  # start serve in the background; answers once it listens
```

```sh
tg personal server status  # whether it runs, since when, who started it
```

```sh
tg personal server logs -n 50  # its latest log lines
```

```sh
tg personal server stop
```

```sh
tg personal server restart
```

### Как системная служба [#как-системная-служба]

Для работы между входами в систему установите пользовательскую службу: systemd в Linux или launchd в macOS.

```sh
tg personal server install  # writes ~/.config/systemd/user/tg-serve-<profile>.service and enables it; starts nothing
```

```sh
tg personal server start  # starts it — through the unit, now that there is one
```

```sh
tg personal server status  # starts_at_login says whether it starts at the next login
```

В macOS агент находится в `~/Library/LaunchAgents/`. `install` включает службу, поэтому она запускается при каждом входе в систему и после перезагрузки; служба, установленная старой версией tg, не включена, пока вы снова не выполните `server install`. Служба, установленная из рабочей копии для разработки (со своими папками `TG_*_DIR`), записывается, но не включается.

- Служба запускает те `node` и `tg`, которыми установлена. После переноса или смены версии Node установите её заново.
- Она получает профиль, `TG_*_DIR` и `MESSAGING_STORE` из оболочки, запустившей `server install`, и больше ничего.
- **После `server start` проверьте журнал:** `tg personal server logs`. Служба читает данные приложения из хранилища ключей. Если оно заблокировано до входа пользователя, запуск не сработает; systemd повторяет попытку каждые 30 секунд, причина будет в журнале.
- **Уже отозванный вход не даёт службе запуститься.** `serve` проверяет его до сообщения о готовности и завершается с кодом 4; после этого установленная служба остаётся остановленной. Войдите через `tg personal session start`, затем выполните `tg personal server start`. Вход, отозванный во время работы службы, тоже завершает её с кодом 4 — примерно в течение 15 минут. Если данные приложения недоступны, а сохранённая сессия есть, serve завершается с кодом 12, и systemd повторяет запуск. В macOS агент не перезапускается ни после какой ошибки, поскольку launchd не умеет исключить один код завершения; запустите его снова через `tg personal server start`. Чтобы обновить старую службу, снова выполните `tg personal server install`.
- `tg personal server uninstall` отключает и удаляет службу. Сначала остановите её.
- В macOS `server stop` выгружает агент до следующего входа в систему, как и в Linux; `server uninstall` не даёт ему запуститься снова.
- `tg upgrade` перезапускает работающий сервер для перехода на новую версию.

Автоответы из `serve` следуют вашим правилам и выбранной аудитории; см. [автоответы](/llms.mdx/docs/ru/tg/replies/content.md).

## Проверка, резервная копия и восстановление [#проверка-резервная-копия-и-восстановление]

```sh
tg personal store info                 # where the file is, its size, its schema, how many rows; changes nothing
```

```sh
tg personal store check                # integrity, search indexes, disk, and which chats are behind; changes nothing
```

```sh
tg personal store backup ~/tg-store.db  # a copy of the store, while it is in use; --encrypt for a password
```

```sh
tg personal store restore ~/tg-store.db  # put a backup in place of the store
```

```sh
tg personal store migrate              # bring the store up to this version's schema
```

```sh
tg personal store clear --left --allow-dangerous  # delete the chats you have left, with their messages
```

- **`backup` не перезаписывает файлы:** укажите новый путь. Копирование возможно во время работы команд и `serve`.
- **`restore` сохраняет заменяемую базу** рядом и показывает путь. Восстановление запрещено, пока работает `serve` любого профиля; сначала `tg personal server stop`. Проверяются доступность и целостность копии. После восстановления перезапустите все `serve` и `mcp serve` обоих CLI, чтобы они читали восстановленную базу.
- **Чат, из которого вы вышли, исчезает из `chats list --offline`** после следующего полного чтения списка через `tg personal chats list`; сообщения остаются. При повторном вступлении чат возвращается. **`store clear --left`** удаляет эти чаты с сообщениями. Без `--allow-dangerous` команда только показывает объём удаления. Историю покинутого чата нельзя загрузить повторно.
- **`migrate`** нужен, только если `info` или `check` сообщает об устаревшей структуре. Сначала сделайте копию. Старые сообщения нормализуются пакетами; остановка не теряет прогресс.

## Восстановление и обслуживание индексов [#восстановление-и-обслуживание-индексов]

`tg personal store migrate` строит незавершенные индексы; `tg personal store rebuild` восстанавливает их. `store info` и `store check` показывают, готовы ли индекс слова и индекс основы слова. Поиск использует основы (часть слова, форма которой остается неизменной) для поиска форм слов; `exact:` и `--exact` выбирают точные формы.

`tg config set search_stemmers.cyrillic russian` и `search_stemmers.latin english,spanish` устанавливают стеммеры общего хранилища: латиница принимает `english`, `spanish` или оба (по умолчанию, поэтому латинское слово соответствует основам обоих), а `none` отключает один; запустите `store rebuild` по вашему выбору. Когда обновление tg меняет значение по умолчанию, основы перестраиваются сами: пока они не будут готовы, поиск соответствует точным словоформам и говорит об этом, `tg personal serve` завершает их в фоновом режиме, а `store migrate` сразу. Настройка затрагивает как мессенджеры, так и каждый профиль; процесс, заблокированный профилем, не может его изменить.

`tg personal store repair --dry-run --json` просматривает структурный ремонт и откатывает его. `store repair` применяет его без удаления данных: несовпадающие таблицы сохраняются как копии, а оставшиеся там строки или столбцы именуются в ответе. Проверьте копии перед удалением одной с помощью `store copies delete <exact name>`; `store repair` называет их в своем ответе. Перед восстановлением остановите процессы, использующие хранилище.

## Совместимость версий базы [#совместимость-версий-базы]

Структура базы имеет версию. Новая версия `tg` или другого CLI может обновить файл. Старый `tg` работает с ним, пока изменения совместимы; иначе любая команда, открывающая базу, сообщает:

```text
the message store was written by a newer version (schema N, needs at least M; this one speaks K) — upgrade this tool
```

**Общая локальная копия хранится в `wirecat.db`.** Старый `messages.db` не переносится: при открытии копии по умолчанию он удаляется вместе с `-wal` и `-shm`.
Если в старом файле нужны заметки, псевдонимы, метки, задачи или расшифровки, остановите использующие его программы и скопируйте файл со служебными файлами в другую папку **до первого запуска новой версии**.
При заданном `MESSAGING_STORE` очистка не выполняется; открытый другим процессом файл остаётся до следующего открытия копии.
Сообщения из Telegram можно заново получить через `tg personal messages sync --all`; данные, существовавшие только локально, с сервера не вернутся. Вход сохраняется отдельно.
Обновляйте `max` и `tg` вместе, чтобы они использовали одну копию.

Если нужно обновить схему `wirecat.db`, выполните `tg upgrade` после сохранения нужного старого файла.

## Правила ответа [#правила-ответа]

[Автоматические ответы](/llms.mdx/docs/ru/tg/replies/content.md) — это руководство по правилам ответа. Этот раздел представляет собой подробную информацию о том, как `serve` их применяет.

`tg personal replies test [rule] --since-time 7d --json` имитирует то, что будут получать сохраненные сообщения; он никогда не отправляет. Правила находятся в файле ответов профиля. `replies status`, `pause` и `resume` проверяют/контролируют их. Фактические общие ответы `serve` требуют явного разрешения `replies.send:allow` и отправляются всем, кому соответствует правило, если только аудитория не ограничивает их. По умолчанию отправка запрещена. Изменения, сообщения до запуска и уже отвеченные сообщения игнорируются. `ask` не может отправить сообщение из автоматической службы.

Создайте отключенное правило с помощью `tg personal replies add away`, отредактируйте его с помощью `replies edit away --template`, затем используйте `replies on away` или `off away`. Для включенных правил ответа требуется непустой шаблон. Редактирование изменяет только именованные поля; списки представляют собой замены, разделенные запятыми, пустая строка очищает одну. Варианты включают `--do reply,task`, `--kinds`, `--allow-chats`, `--deny-chats`, `--words`, `--question` / `--no-question`, `--mentions-me` / `--no-mentions-me`, `--allow-people`, `--deny-people`, `--contacts-only` / `--no-contacts-only`, `--as-reply` / `--no-as-reply`, `--per-chat`, `--per-person` и поля часов `--outside`, `--days`, `--timezone` (`--no-hours` очищает их). Для первой настройки часов требуются все три поля. Недопустимые изменения сохраняют файл, другие правила, аудиторию и историю ответов.

`tg personal replies audience` показывает аудиторию профиля; `--reply all|listed`, `--allow-people`, `--allow-chats`, `--deny-people` и `--deny-chats` заменяют именованные поля. Отрицание побеждает; указан с пустым списком разрешенных, никому не отвечает; новый файл отвечает всем, кому соответствует правило. Локальная задача правила может открыться даже там, где ответ запрещен.

Шаблоны используют переменные Liquid `sender.firstName`, `sender.name`, `chat.title`, `chat.kind` и
`now` в часовом поясе рабочего интервала правила (без него — UTC), с фильтрами вроде `default` и
`date`. Неизвестные переменные и фильтры отклоняются; файловые теги и доступ к прототипам запрещены, а
время обработки, выделение памяти и длина вывода ограничены. Входящее сообщение никогда не является переменной.
Только блок ai может вызывать модель; его содержимое — инструкция, а сообщение передаётся отдельно как данные:

```liquid
Thanks, {{ sender.firstName | default: "there" }}.
{% ai %}Briefly acknowledge this; I will answer tomorrow.{% else %}I will answer tomorrow.{% endai %}
```

Вывод модели заменяет только свой блок и не разбирается повторно. При отсутствии конфигурации или согласия,
ошибках вызова и отклонённом выводе используется ветка else; без неё ответ пропускается. Текст вне
блока остаётся текстом владельца с обычными подстановками. Старые заполнители и файлы may-reword
сохраняют заполненный буквальный запасной ответ с предупреждениями; новым файлам поле model не нужно.

Выберите `models.replies.provider`, `.model` и необязательно `.base_url`; `models.default` служит
запасным вариантом, а `provider off` отключает назначение. Прежние настройки анализа остаются поддерживаемыми.
`config set` / `unset` принимают поля с точечной записью; `config show` сообщает источник каждого. Ключи остаются в
`models keys set`; пользовательские адреса API используют ключ своего хоста и порта, а не ключ публичного провайдера.

`tg personal replies consents show|grant|revoke` управляет согласием на модель отдельно от разрешения отправлять.
Grant явно разрешает передачу входящих данных настроенному провайдеру для всего профиля,
кроме собственных идентификаторов чатов, исключённых через `replies consents deny`; `allow` снимает исключение без
предоставления согласия. Исключения сохраняются после grant/revoke. Другому адресу API нужно новое согласие.
Изменения согласия, конфигурации, паузы, правил и аудитории во время вызова модели проверяются перед отправкой.

`tg personal replies test` показывает инструкции и запасной ответ без вызовов модели. `tg personal replies test --ai` явно
отправляет сохранённые данные сообщений модели, на которую дано согласие, но не отправляет ответ в мессенджер и не меняет
историю ответов; его нельзя сочетать с `--offline`.

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

- [Поиск сообщений](/llms.mdx/docs/ru/tg/search/content.md): найдите, что есть в архиве.
- [Рецепты](/llms.mdx/docs/ru/tg/recipes/content.md): поиск и экспорт в повседневной работе вашего агента.
- [Безопасность](/llms.mdx/docs/ru/tg/security/content.md): что архив означает для конфиденциальности ваших сообщений.

## Независимые копии файлов [#независимые-копии-файлов]

Независимый архив файлов нужен, когда файлы должны пережить удалённые сообщения или истёкшие ссылки на загрузку. Он хранит
байты в выбранной вами папке, а манифест записывает для каждого файла его идентификатор, размер и контрольную сумму SHA-256.
Попросите своего агента: «Сохрани файлы из группы Example group в мой архив файлов, затем проверь копии».

Telegram возвращает только те сообщения и файлы, которые всё ещё доступны вашей учётной записи. Удалённые сообщения и недоступные файлы эта команда восстановить не может.

Сохраните все доступные чаты или повторите `--chat`, чтобы выбрать несколько. `--since-time` включает сообщения с указанной
ISO-меткой времени (с часовым поясом) и позже:

```sh
tg personal attachments download ~/media-archive --chat "Example group" --since-time 2026-10-01T00:00:00Z --timeout 6h
tg personal attachments check ~/media-archive --offline --json
```

Результат сообщает число сохранённых файлов, проверенных существующих копий и просмотренных чатов. Повторный запуск проверяет
каждую существующую копию и скачивает недостающие. У файлов имена вида `.bin`, построенные по идентификатору; их манифесты
указывают чат, сообщение и позицию вложения. Ссылка для загрузки, ключ медиа и исходное имя файла в манифесте не сохраняются.
Эти независимые копии не регистрируются как сохранённые пути в базе сообщений; для файлов, которые должны находить
`attachments show` или извлечение текста, используйте обычную команду `messages download`.

Прерванный запуск сохраняет завершённые файлы. Запустите ту же команду снова: прерванный файл начнётся с нулевого байта,
потому что потоки мессенджера не дают данных, нужных для безопасного дозаписывания. Неудачная загрузка останавливается
с ошибкой; недоступный файл не считается сохранённым. Если архивный файл пропал или изменился, проверка завершается
с ненулевым кодом выхода и дальнейшее архивирование останавливается. Выберите новое место назначения; существующие
файлы никогда не перезаписываются. `complete: true` означает всю историю, доступную выбранному читателю, а не доказательство
того, что все старые исходные файлы ещё существуют.

### Ежедневная копия в Linux [#ежедневная-копия-в-linux]

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

```sh
tg personal attachments jobs install ~/media-archive --chat "Example group" --at 03:00 --timezone UTC
tg personal attachments jobs start ~/media-archive
tg personal attachments jobs status ~/media-archive
```

Таймер запускается с зафиксированным исполняемым файлом, профилем и расположением файлов, шестичасовым ограничением
и правами доступа только для владельца. По умолчанию время 03:00 UTC; `--timezone Europe/Madrid` задаёт это время по местному поясу.
Будет ли служба работать, пока вы не вошли в систему, определяет конфигурация пользовательских служб вашей системы; пропущенные запуски
выполняются при следующем старте таймера. В macOS и Windows команду загрузки можно запускать вручную.

```sh
tg personal attachments jobs stop ~/media-archive
tg personal attachments jobs uninstall ~/media-archive
```

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

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

### Перенос старых изображений в другой архив [#перенос-старых-изображений-в-другой-архив]

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

```sh
tg personal attachments move ~/media-archive /mnt/archive/older-images --before-time 2026-10-01T00:00:00Z --dry-run
tg personal attachments move ~/media-archive /mnt/archive/older-images --before-time 2026-10-01T00:00:00Z --timeout 6h
tg personal attachments check ~/media-archive --offline
```

Граница определяется датой сообщения, а не датой загрузки, и изображения ровно на границе не включаются.
Переносятся фотографии и файлы с MIME-типом изображения; остальные файлы остаются. Назначение копируется и проверяется,
прежде чем локальные байты изображений удаляются. В исходной папке остаются небольшие записи о переносе, чтобы проверки
следовали за копиями, а последующие загрузки не скачивали их снова. Мессенджер не затрагивается.

Держите другой архив доступным по записанному пути. Если он недоступен или копия изменилась, проверки завершаются
ошибкой, а загрузки останавливаются, вместо того чтобы молча дублировать файлы. Повторите прерванный перенос, чтобы завершить его.
Изображения из ранних черновых архивов без даты сообщения остаются на месте и учитываются как `undated`;
`complete: false` означает, что эти изображения нельзя выбрать по возрасту. Время изменения файлов никогда не используется
как замена. Предварительный просмотр показывает число файлов и байты, не создавая папку назначения.
