# Telegram · Tajne czaty: konfiguracja i zapis

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

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

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

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

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

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentacja](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

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](https://github.com/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`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) , wersja `b35f8e18f3d1-1ff85ec98bb2` , wersja 0.9.1 (wersja zapoznawcza). [Niezmienny plik wheel](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) 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](https://github.com/phishdestroy/TgWitness/blob/main/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](https://phishdestroy.io/tgwitness/pl/docs/reference/verification/) 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](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees); powiadomienia w formie zrzutów ekranu nie są nigdy wysyłane. Zobacz [plik secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py), [trasy API](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py) oraz [politykę dostępu](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py).

[Audyt historyczny](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) zachowuje swoje pierwotne wyniki migawek. Aktualną dostępność i implementację należy odczytać z powyższej wersji pakietu oraz [aktualnych możliwości](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md).

## 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.
