TgWitness / Dokumentasi

Apa yang telah diuji →

Rujukan / Kumpulkan

Telegram · Perbualan Rahsia: persediaan dan rakaman

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

TgWitness / Dokumentasi

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 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, keluaran b35f8e18f3d1-1ff85ec98bb2, versi 0.9.1 pra-tonton. The roda tidak berubah 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 menetapkan komit yang sama seperti butang panel.

Pemeriksaan pakej ini menetapkan fail dan deklarasi kebergantungan yang dihantar. Rekod pengesahan 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'; pemberitahuan tangkapan skrin tidak pernah dihantar. Rujuk secret_chats.py, laluan API dan dasar akses.

Audit bersejarah mengekalkan penemuan snapshot asal. Ketersediaan dan pelaksanaan semasa hendaklah dibaca daripada semakan pakej di atas dan keupayaan semasa.

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.