TgWitness / Документация

Что проверено →

Справочник / Сбор

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

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

TgWitness / Документация

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

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

Модуль kiaro-telethon-secret-chat 0.2.0
Автор Киаро-сама
Лицензия GPL-3.0 или более поздней версии; её LICENSE и NOTICE остаются внутри сохраненного архива
Источник 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 , релизу b35f8e18f3d1-1ff85ec98bb2 и версии 0.9.1 (предварительная). Неизменяемый файл wheel и его блокировка зависимостей прошли проверку SHA-256 и проверку подписи релиза по алгоритму RSA. Упакованный бэкенд и интерфейс полностью совпали с этой ревизией исходного кода байт за байтом. Пакет также содержит регистрацию API и хуки коллектора.

В этом пакете не было библиотеки протоколов, и её нет в файле lock зависимостей. Дополнительный secret-chats Параметр «extra» в файле pyproject.toml фиксирует тот же коммит, что и кнопка на панели.

Данная проверка пакета определяет, какие файлы и декларации зависимостей поставляются. Запись валидации определяет отдельные проверки во время выполнения. В предыдущем руководстве от 6 ноября описывался снэпшот разработки; оно больше не описывает вышеуказанный пакет.

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

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

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

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

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

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

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

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

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

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

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

Расшифрованные сообщения, запись которых в журнал завершилась неудачей, хранятся в хранилище для повторной попытки. Проверки размера вложений и свободного места на диске приостанавливают загрузку, сохраняя при этом соответствующие задания. Модуль повторно использует существующее соединение учетной записи. Уведомления о прочтении и вводе текста отправляются только в соответствии с настройками в разделе Что видит собеседник; уведомления в виде скриншотов никогда не отправляются. См. secret_chats.py, маршруты API и политику доступа.

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

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

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