Справочник / Сбор
Запись секретных чатов Telegram в 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 и политику доступа.
Исторический аудит сохраняет исходные результаты моментальных снимков. Информацию о текущей доступности и реализации следует извлекать из указанной выше версии пакета и сведений о текущих возможностях.
Демонстрация интерфейса#
В сценарии веб-сайта используются вымышленные запросы, сообщения и файлы для демонстрации рабочего процесса панели. Это пример интерфейса; проверки протокола и сбора данных имеют собственные датированные результаты в записи валидации.