TgWitness / Dokumentacja

Co zostało przetestowane →

Odniesienie / Zbieraj

Telegram · Tajne czaty: konfiguracja i zapis

Zainstaluj dodatek protokołu tajnych czatów, włącz go dla konta i zapisuj czaty, które TgWitness tworzy lub akceptuje.

TgWitness / Dokumentacja

Opublikowana aplikacja zawiera zaplecze funkcji „Secret Chat”, integrację z modułem zbierającym dane, trasy API oraz interfejs Pseudo-secret. Biblioteka protokołów stanowi oddzielny moduł: otwórz Pseudo-secret, naciśnij Zainstaluj i włącz. Automatyczne przyjmowanie połączeń przychodzących pozostaje wyłączone, dopóki nie włączysz tej funkcji.

Moduł protokołu#

Moduł kiaro-telethon-secret-chat 0.2.0
Autor KiaroSama
Licencja GPL-3.0 lub nowsza; jej LICENSE i NOTICE pozostań w zapisanym archiwum
Źródło KiaroSama/Telethon-Secret-Chat w commit d87bf037b90060383c7b704d8a06ebb98c621c6f
Sprawdź SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c nad listą plików pakietów i ich własnymi wartościami SHA-256

Funkcja Zainstaluj i uruchom jest dostępna dla głównego administratora. TgWitness pobiera archiwum źródłowe danego commitu z serwisu GitHub poprzez ścieżkę obszaru roboczego przeznaczoną dla żądań poza Telegramem, porównuje każdy plik pakietu z wartością ustaloną w wydaniu TgWitness, zapisuje archiwum jako modules/telethon-secret-chat-<commit>.zip w katalogu danych i ładuje kod z pamięci. Nie jest wymagane ponowne uruchomienie. Sprawdzanie odbywa się ponownie przy każdym uruchomieniu; archiwum, które się różni, nie jest ładowane, a strona wyświetla odpowiedni komunikat. Zmieniony, brakujący lub dodany plik pakietu powoduje niepowodzenie sprawdzania.

Moduł ten stanowi odrębne dzieło objęte własną licencją. TgWitness nie dostarcza go w pakiecie: przy każdej instalacji jest on pobierany z repozytorium autora. Szczegóły na stronie zawierają informacje o załadowanym module, jego autorze, licencji, commitcie oraz skrócie SHA-256.

Użytkownik bez dostępu do serwisu GitHub może zamiast tego zainstalować ten sam commit w środowisku Pythona; panel korzysta wówczas z tej kopii:

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

TgWitness staje się punktem końcowym dla czatów, które tworzy lub akceptuje. Rejestruje wiadomości, dostępne załączniki, zmiany czasu oraz powiadomienia o usunięciu w podpisanym dzienniku. Wcześniej zapisana treść pozostaje dostępna nawet po późniejszym powiadomieniu o usunięciu.

Dostępność pakietu#

8 listopada 2026 r. opublikowany pakiet instalacyjny został sprawdzony w źródle b35f8e18f3d1 , wersja b35f8e18f3d1-1ff85ec98bb2 , wersja 0.9.1 (wersja zapoznawcza). Niezmienny plik wheel i jego blokada zależności przeszły weryfikację podpisu wydania za pomocą algorytmów SHA-256 i RSA. Zapakowany backend i interfejs były identyczne z tą rewizją źródła bajt po bajcie. Pakiet zawiera również rejestrację API oraz haki kolektora.

Ten pakiet nie zawierał biblioteki protokołu i nie ma jej w pliku lock zależności. Dodatkowy wpis secret-chats Dodatek w pliku pyproject.toml wskazuje ten sam commit, co przycisk na panelu.

Ta kontrola pakietu określa, które pliki i deklaracje zależności są dostarczane. Rekord walidacji identyfikuje poszczególne kontrole wykonywania. Wcześniejszy przewodnik z 6 listopada opisywał migawkę rozwojową; nie odnosi się już do powyższego pakietu.

Korzystaj z interfejsu#

Otwórz Pseudo-secret, zainstaluj moduł, jeśli strona go oferuje, włącz go dla konta i połącz. Przychodzące żądania oczekują na akceptację, chyba że włączono automatyczną akceptację. Uruchamianie, akceptowanie, wysyłanie i zamykanie wykorzystują uprawnienia interakcji konta oraz ochronę tylko do odczytu.

Działanie Zachowany wynik
Rozpocznij czat, podając nazwę użytkownika lub identyfikator użytkownika Żądanie wychodzące; partner akceptuje je na swoim urządzeniu.
Zaakceptuj żądanie TgWitness staje się punktem końcowym odbiorczym.
Wysyłanie lub odbieranie wiadomości secret_chat.message wraz z kierunkiem, treścią i podanym zegarem.
Otrzymaj plik Odszyfrowane bajty przechowywane przy użyciu algorytmu SHA-256 oraz potwierdzenia secret_chat.file; zawarte w eksporcie dowodów.
Otrzymaj powiadomienie o upływie czasu lub usunięciu Oddzielny zapis akcji obok zachowanych wiadomości i plików.
Przejrzyj czat Wizualizacja rozmów, potwierdzeń odbioru plików, powiadomień i kluczy.

Istniejące tajne czaty na innym urządzeniu zachowują klucze specyficzne dla tego urządzenia. Zaimportowana sesja w chmurze nie przenosi tych kluczy. Materiał kluczy tajnych czatów oraz liczniki korzystają ze skarbca obszaru roboczego; zachowane wiadomości i odszyfrowane pliki korzystają z standardowych zabezpieczeń pamięci masowej obszaru roboczego.

Znajdź zapisane wiadomości#

Skorzystaj z funkcji wyszukiwania wiadomości w otwartej rozmowie, aby znaleźć dokładnie tę samą frazę, bez uwzględniania wielkości liter. Przyciski Poprzednia i Następna lub klawisze Enter i Shift+Enter w polu wyszukiwania pozwalają przechodzić między pasującymi wiadomościami. Licznik pokazuje liczbę wiadomości; pierwsza pasująca fraza w każdej wiadomości jest podświetlona. Klawisz Escape kasuje wyszukiwanie.

Funkcja wyszukiwania wyświetla otaczającą rozmowę, zapisane pliki oraz powiadomienia o usunięciu. Przeszukuje ona rekordy już załadowane do panelu. Jeśli istnieją wcześniejsze rekordy, panel wyświetla odpowiedni komunikat; opcja Załaduj starsze rekordy rozszerza historię i aktualizuje wyniki wyszukiwania, pozostawiając bieżącą wiadomość na swoim miejscu.

Każdy czat zachowuje wyniki wyszukiwania podczas przełączania się w obrębie tego samego obszaru roboczego. Zablokowanie panelu lub zmiana obszaru roboczego powoduje wyczyszczenie tych wyników. Terminy wyszukiwania pozostają w pamięci strony i nie są zapisywane w pamięci przeglądarki ani wysyłane jako zapytania API. Wyszukiwanie nie powoduje wysyłania wiadomości w Telegramie ani powiadomień o wpisywaniu/przeczytaniu. Dotychczasowe ustawienia widoczności nadal regulują otwieranie czatu i inne działania.

Raport kompilacji zachowuje zakres wybranego czatu; wyszukiwanie w widoku nie ogranicza w sposób niewidoczny eksportowanych rekordów. Przed pobraniem raportu należy sprawdzić jego zawartość.

Kontrola trwałości i interakcji#

Zintegrowana implementacja wykorzystuje trwałe wyszukiwanie w dzienniku do wykrywania duplikatów, utrzymuje zadania związane z załącznikami w stanie oczekującym po nieudanym pobraniu oraz kieruje zamykanie poprzez ten sam mechanizm kontroli interakcji, co inne działania zdalne. Zastępują one trzy ścieżki opisane w historycznym audycie migawki rozwojowej z 6 listopada.

Odszyfrowane wiadomości, których zapis w dzienniku nie powiódł się, są przechowywane w skarbcu w celu ponownej próby. Sprawdzanie rozmiaru załączników i wolnego miejsca na dysku powoduje wstrzymanie pobierania, przy czym zadania pozostają aktywne. Moduł ponownie wykorzystuje istniejące połączenie konta. Powiadomienia o przeczytaniu i wpisywaniu są wysyłane wyłącznie zgodnie z ustawieniami w sekcji Co widzi druga strona; powiadomienia w formie zrzutów ekranu nie są nigdy wysyłane. Zobacz plik secret_chats.py, trasy API oraz politykę dostępu.

Audyt historyczny zachowuje swoje pierwotne wyniki migawek. Aktualną dostępność i implementację należy odczytać z powyższej wersji pakietu oraz aktualnych możliwości.

Prezentacja interfejsu#

Scenariusz na stronie internetowej wykorzystuje fikcyjne żądania, wiadomości i pliki w celu zademonstrowania przebiegu pracy panelu. Jest to przykład interfejsu; kontrole protokołu i pozyskiwania danych mają własne, opatrzone datą wyniki w rejestrze walidacji.