# Запись секретных чатов Telegram в TgWitness

Canonical page: https://phishdestroy.io/tgwitness/ru/docs/reference/secret-chats/

Установите протокольный модуль секретных чатов, включите его для аккаунта и записывайте чаты, которые TgWitness создаёт или принимает.

[Project context and measured scale](https://phishdestroy.io/tgwitness/ru/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/ru/llms.txt)

Установите протокольный модуль секретных чатов, включите его для аккаунта и записывайте чаты, которые TgWitness создаёт или принимает.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Документация](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

Опубликованное приложение включает в себя бэкенд «Секретного чата», интеграцию с коллектором, маршруты API и интерфейс **Pseudo-secret**. Библиотека протоколов представляет собой отдельный модуль: откройте **Pseudo-secret**, нажмите **Установить и включите его**. Автоматический прием входящих сообщений останется отключенным, пока вы его не включите.

## Модуль протокола

|  |  |
| --- | --- |
| Модуль | `kiaro-telethon-secret-chat` 0.2.0 |
| Автор | Киаро-сама |
| Лицензия | GPL-3.0 или более поздней версии; её `LICENSE` и `NOTICE` остаются внутри сохраненного архива |
| Источник | [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) в коммите `d87bf037b90060383c7b704d8a06ebb98c621c6f` |
| Проверить | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` над списком файлов пакетов и их собственными значениями SHA-256 |

Функция**Установить и включить** доступна главному администратору. TgWitness загружает исходный архив данной фиксации с GitHub через маршрут рабочей области для запросов за пределами Telegram, сравнивает каждый файл пакета со значением, зафиксированным в релизе TgWitness, сохраняет архив в `modules/telethon-secret-chat-<commit>.zip` в каталог данных и загружает код из памяти. Перезапуск не требуется. Проверка выполняется заново при каждом запуске; архив, содержащий отличия, не загружается, и на странице отображается соответствующее сообщение. Измененный, отсутствующий или добавленный файл пакета приводит к сбою проверки.

Этот модуль представляет собой отдельное произведение, распространяемое по собственной лицензии. TgWitness не включает его в состав дистрибутива: при каждой установке он загружается из репозитория его автора. На странице **Подробности** отображаются сведения о загруженном модуле: его автор, лицензия, коммит и SHA-256.

Пользователь, не имеющий доступа к GitHub, может вместо этого установить тот же коммит в среду Python; в этом случае панель будет использовать именно эту копию:

```
python -m pip install ".[secret-chats]"
```

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

## Доступность пакета

8 ноября 2026 года опубликованный установочный пакет был проверен по исходному коду [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) , релизу `b35f8e18f3d1-1ff85ec98bb2` и версии 0.9.1 (предварительная). [Неизменяемый файл wheel](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) и его блокировка зависимостей прошли проверку SHA-256 и проверку подписи релиза по алгоритму RSA. Упакованный бэкенд и интерфейс полностью совпали с этой ревизией исходного кода байт за байтом. Пакет также содержит регистрацию API и хуки коллектора.

В этом пакете не было библиотеки протоколов, и её нет в файле lock зависимостей. Дополнительный `secret-chats` Параметр «extra» в [файле pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) фиксирует тот же коммит, что и кнопка на панели.

Данная проверка пакета определяет, какие файлы и декларации зависимостей поставляются. [Запись валидации](https://phishdestroy.io/tgwitness/ru/docs/reference/verification/) определяет отдельные проверки во время выполнения. В предыдущем руководстве от 6 ноября описывался снэпшот разработки; оно больше не описывает вышеуказанный пакет.

## Используйте интерфейс

Откройте **Pseudo-secret**, установите модуль, если он предлагается на странице, включите его для учетной записи и подключите. Входящие запросы ожидают подтверждения, если не включена функция автоматического подтверждения. Запуск, подтверждение, отправка и закрытие осуществляются с учетом прав взаимодействия учетной записи и защиты от чтения.

| Действие | Сохраненный результат |
| --- | --- |
| Начать чат по имени пользователя или ID пользователя | Исходящий запрос; узел принимает его на своём устройстве. |
| Принять запрос | TgWitness становится конечной точкой приема. |
| Отправить или получить сообщение | `secret_chat.message` с указанием направления, содержания и заданного таймера. |
| Получить файл | Расшифрованные байты, хранящиеся с помощью SHA-256 и квитанции `secret_chat.file`; включены в экспорт доказательств. |
| Получить уведомление с таймером или уведомление об удалении | Отдельная запись о действии наряду с сохраненными сообщениями и файлами. |
| Просмотрите чат | Визуализация переписки, подтверждений получения файлов, уведомлений и ключей. |

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

## Найти сохраненные сообщения

Используйте **функцию Поиск сообщений** в открытом чате, чтобы найти точную фразу с игнорированием регистра. **Кнопки Назад** и **Вперед** или комбинации клавиш Enter и Shift+Enter в поле поиска позволяют перемещаться между сообщениями, содержащими искомую фразу. Счетчик показывает количество сообщений; первая совпадающая фраза в каждом сообщении выделяется. Клавиша Escape очищает поле поиска.

Функция поиска позволяет видеть окружающий диалог, сохраненные файлы и уведомления об удалении. Она осуществляет поиск по записям, уже загруженным в панель. Если имеются более ранние записи, панель отображает соответствующее сообщение; **команда Загрузить более старые записи** расширяет историю и обновляет результаты поиска, при этом текущее сообщение остается на месте.

При переключении между чатами в пределах одного рабочего пространства поисковые запросы сохраняются. Блокировка панели или смена рабочего пространства приводит к очистке этих запросов. Поисковые запросы остаются в памяти страницы и не сохраняются в хранилище браузера, а также не отправляются в виде запросов API. При поиске не отправляются сообщения в Telegram, а также уведомления о вводе текста и прочтении. Существующие настройки видимости по-прежнему регулируют открытие чата и другие действия.

**Отчет о сборке** сохраняет область охвата выбранного чата; поиск в окне просмотра не ограничивает экспортируемые записи без уведомления. Просмотрите выбор данных для отчета перед его загрузкой.

## Механизмы обеспечения сохранности данных и управления взаимодействиями

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

Расшифрованные сообщения, запись которых в журнал завершилась неудачей, хранятся в хранилище для повторной попытки. Проверки размера вложений и свободного места на диске приостанавливают загрузку, сохраняя при этом соответствующие задания. Модуль повторно использует существующее соединение учетной записи. Уведомления о прочтении и вводе текста отправляются только в соответствии с настройками в разделе [Что видит собеседник](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees); уведомления в виде скриншотов никогда не отправляются. См. [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py), [маршруты API](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py) и [политику доступа](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py).

[Исторический аудит](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) сохраняет исходные результаты моментальных снимков. Информацию о текущей доступности и реализации следует извлекать из указанной выше версии пакета и сведений о [текущих возможностях](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md).

## Демонстрация интерфейса

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