# Telegram · Perbualan Rahsia: persediaan dan rakaman

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

Pasang tambahan protokol Perbualan Rahsia, dayakan bagi setiap akaun dan rakam perbualan yang dicipta atau diterima oleh TgWitness.

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

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

Pasang tambahan protokol Perbualan Rahsia, dayakan bagi setiap akaun dan rakam perbualan yang dicipta atau diterima oleh TgWitness.

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

Aplikasi yang diterbitkan merangkumi backend Secret Chat, integrasi pengumpul, laluan API dan antara muka **Pseudo-secret**. Perpustakaan protokol adalah modul berasingan: buka **Pseudo-secret** dan tekan **Pasang dan hidupkan**. Penerimaan masuk automatik kekal dimatikan sehingga anda menghidupkannya.

## Modul protokol

|  |  |
| --- | --- |
| Modul | `kiaro-telethon-secret-chat` 0.2.0 |
| Pengarang | KiaroSama |
| Lesen | GPL-3.0 atau yang lebih baru; miliknya `LICENSE` dan `NOTICE` tetap di dalam arkib yang disimpan |
| Sumber | [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) pada commit `d87bf037b90060383c7b704d8a06ebb98c621c6f` |
| Semak | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` atas senarai fail pakej dan nilai SHA-256 mereka sendiri |

**Pasang dan hidupkan** tersedia untuk pentadbir utama. TgWitness memuat turun arkib sumber bagi komit tersebut daripada GitHub melalui laluan ruang kerja untuk permintaan di luar Telegram, membandingkan setiap fail dalam pakej dengan nilai yang ditetapkan dalam keluaran TgWitness, menyimpan arkib sebagai `modules/telethon-secret-chat-<commit>.zip` dalam direktori data dan memuatkan kod dari memori. Tiada permulaan semula diperlukan. Semakan dijalankan semula pada setiap permulaan; arkib yang berbeza tidak akan dimuatkan dan halaman akan memaparkan maklumat tersebut. Fail pakej yang diubah, hilang atau ditambah akan menyebabkan semakan gagal.

Modul ini adalah satu karya berasingan di bawah lesennya sendiri. TgWitness tidak membekalkannya: setiap pemasangan memuat turunnya daripada repositori pengarangnya. **Butiran** pada halaman menunjukkan modul yang dimuat, pengarangnya, lesen, komit dan SHA-256.

Host tanpa akses ke GitHub boleh memasang commit yang sama ke dalam persekitaran Python; panel kemudian menggunakan salinan tersebut:

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

TgWitness menjadi titik hujung untuk sembang yang dihasilkannya atau diterimanya. Ia merekodkan mesej, lampiran yang tersedia, perubahan pemasa dan notis pemadaman dalam jurnal yang disahkan tandatangan. Kandungan yang disimpan sebelum ini kekal tersedia selepas notis pemadaman kemudian.

## Ketersediaan pakej

Pada 8 November 2026, pakej pemasang yang diterbitkan telah diperiksa di sumber [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c), keluaran `b35f8e18f3d1-1ff85ec98bb2`, versi 0.9.1 pra-tonton. The [roda tidak berubah](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) dan kunci kebergantungannya lulus pengesahan tandatangan keluaran SHA-256 dan pengesahan tandatangan keluaran RSA. Backend dan antara muka yang dibungkus sepadan dengan semakan sumber itu bait demi bait. Pakej itu juga mengandungi pendaftaran API dan hook pengumpul.

Pakej itu tidak mengandungi perpustakaan protokol, dan ia tidak terdapat dalam kunci kebergantungan. The `secret-chats` extra dalam [pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) menetapkan komit yang sama seperti butang panel.

Pemeriksaan pakej ini menetapkan fail dan deklarasi kebergantungan yang dihantar. [Rekod pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/verification/) mengenal pasti pemeriksaan runtime yang berasingan. Panduan 6 November sebelum ini menerangkan snapshot pembangunan; ia tidak lagi menerangkan pakej di atas.

## Gunakan antara muka

Buka **Pseudo-rahsia**, pasang modul jika halaman menawarkannya, aktifkannya untuk akaun dan sambungkannya. Permintaan masuk menunggu penerimaan melainkan penerimaan automatik diaktifkan. Permulaan, penerimaan, penghantaran dan penutupan menggunakan kebenaran interaksi akaun dan perlindungan baca sahaja.

| Tindakan | Keputusan terpelihara |
| --- | --- |
| Mulakan sembang dengan nama pengguna atau ID pengguna | Permintaan keluar; rakan sebaya menerimanya pada peranti mereka. |
| Terima permintaan | TgWitness menjadi titik akhir penerima. |
| Hantar atau terima mesej | `secret_chat.message` dengan arahannya, kandungannya dan pemasa yang dibekalkan. |
| Terima fail | Bait yang telah didekripsi disimpan oleh SHA-256 dan resit `secret_chat.file`; disertakan dalam eksport bukti. |
| Terima pemberitahuan pemasa atau pemadaman | Rekod tindakan berasingan di samping mesej dan fail yang disimpan. |
| Semak sembang | Perbualan, resit fail, notis dan visualisasi kunci. |

Perbualan Rahsia sedia ada pada peranti lain mengekalkan kunci khusus peranti mereka. Sesi awan yang diimport tidak memindahkan kunci tersebut. Bahan kunci perbualan rahsia dan pengira menggunakan peti keselamatan ruang kerja; mesej yang disimpan dan fail yang disahsulit menggunakan perlindungan storan ruang kerja biasa.

## Cari mesej yang disimpan

Gunakan **Cari** dalam sembang terbuka untuk mencari frasa tepat, tanpa mengira huruf besar kecil. **Butang Sebelum** dan **Seterusnya**, atau Enter dan Shift+Enter di medan carian, bergerak antara mesej yang sepadan. Pengira mengira mesej; frasa sepadan pertama dalam setiap mesej diserlahkan. Tekan Esc untuk memadam carian.

Carian mengekalkan perbualan sekeliling, fail yang disimpan dan notis pemadaman dapat dilihat. Ia mencari rekod yang telah dimuatkan dalam panel. Apabila rekod terdahulu masih ada, panel akan memberitahu; **memuatkan rekod lama** akan memanjangkan sejarah dan mengemas kini hasil carian sambil mengekalkan mesej semasa di tempatnya.

Setiap sembang mengekalkan cariannya semasa anda beralih dalam ruang kerja yang sama. Mengunci panel atau menukar ruang kerja akan memadam carian tersebut. Istilah carian kekal dalam memori halaman dan tidak disimpan dalam storan pelayar atau dihantar sebagai pertanyaan API. Mencari tidak menghantar mesej Telegram atau pemberitahuan menaip/membaca. Tetapan keterlihatan sedia ada masih mengawal pembukaan sembang dan tindakan lain.

**Laporan bina** mengekalkan skop laporan sembang yang dipilih; carian paparan tidak mengehadkan rekod yang dieksport secara senyap. Pratonton pemilihan laporan sebelum memuat turunnya.

## Kawalan ketahanan dan interaksi

Pelaksanaan bersepadu menggunakan carian jurnal tahan lama untuk pengesanan duplikat, mengekalkan kerja lampiran dalam status tertangguh selepas muat turun gagal, dan mengarahkan penutupan melalui pengawal interaksi yang sama seperti tindakan jauh lain. Ini menggantikan tiga laluan yang dilaporkan dalam audit snapshot pembangunan bersejarah 6 November.

Mesej yang telah didekripsi tetapi gagal ditulis ke jurnal akan disimpan dalam peti besi untuk dicuba semula. Saiz lampiran dan semakan ruang cakera kosong menangguhkan muat turun sambil mengekalkan tugasan mereka. Modul ini menggunakan semula sambungan akaun yang sedia ada. Pemberitahuan baca dan taip hanya dihantar seperti yang dipilih di bawah ['Apa yang dilihat pihak lawan'](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees); pemberitahuan tangkapan skrin tidak pernah dihantar. Rujuk [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py), [laluan API](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py) dan [dasar akses](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py).

[Audit bersejarah](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md) mengekalkan penemuan snapshot asal. Ketersediaan dan pelaksanaan semasa hendaklah dibaca daripada semakan pakej di atas dan [keupayaan semasa](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md).

## Demonstrasi antara muka

Senario laman web menggunakan permintaan, mesej dan fail rekaan untuk menunjukkan aliran kerja panel. Ia adalah contoh antara muka; pemeriksaan protokol dan pemerolehan mempunyai keputusan masing-masing yang sudah lapuk dalam rekod pengesahan.
