# TgWitness: Telegram Export, OSINT & Verification

Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/

Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions.

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

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

Pasang dengan satu perintah atau tangkap pada GitHub Actions. Faham pilihan penyiasatan, skala yang diterbitkan dan apa yang disahkan oleh arkib.

TgWitness ialah pengeksport Telegram sumber terbuka dan ruang kerja siasatan. Pasang ia dengan satu arahan, sambungkan akaun, pilih sembang dan eksport arkib yang disahkan. Ia juga menyokong pengumpulan sementara di GitHub Actions dan meneruskan siasatan dengan suntingan yang disimpan, pemerhatian pemadaman, carian dan laporan.

## Mulakan dengan tugasan yang anda ada

| Tugas anda | Jalan terpendek | Apa yang anda terima |
| --- | --- | --- |
| Simpan perbualan atau akaun | Pasang, sambungkan akaun, pilih skop eksport | Arkib bertandatangan dengan sejarah terpilih, hasil koleksi dan bahan pengesahan |
| Kumpulkan pada pelari sementara | Gunakan GitHub Actions untuk menangkap, memberi kebenaran sesi baharu dan memilih skop | Arkib yang disulitkan dengan asal usul aliran kerja GitHub |
| Ikuti perubahan dari semasa ke semasa | Teruskan pemantauan untuk sembang terpilih | Versi yang disimpan, notis pemadaman, lampiran dan liputan yang direkodkan |
| Siasat dan kongsi penemuan | Cari dalam arkib, gunakan Papan Kes dan konfigurasikan laporan atau salinan perkongsian | Penemuan yang dipautkan kepada sumber dan penyerahan yang boleh disahkan sesuai untuk penerima |

### Pemasangan satu arahan

Pemuat turun termasuk Python dan kebergantungan. Pengambilan sumber, Docker, penyedia AI dan saksi bebas adalah pilihan pilihan, bukan prasyarat persediaan.

Linux / macOS:

```
curl -fsSL https://get.destroy.tools/install.sh | bash
```

Windows, dalam PowerShell atau Command Prompt:

```
powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"
```

Buka panel, sambungkan akaun Telegram anda dan pilih skop pengumpulan. Pemasangan tidak memulakan pengumpulan secara automatik. Panduan pemasangan menerangkan akses tempatan, pelayan, kemas kini dan memeriksa binaan yang dimuat turun.

Untuk pelaksana sementara, ikuti [GitHub Actions capture](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md). Aliran kerja itu memerlukan fork GitHub, kebenaran dan kata laluan arkib. Halaman capture menerangkan langkah-langkah tersebut dan bajet masa sesi sebelum pelaksanaan. Muat turun dan simpan arkib yang terhasil dan bahan pengesahannya.

## Lagi tetapan apabila tugasan memerlukannya

Eksport sembang tunggal memerlukan akaun dan skop yang dipilih. Pengawasan berterusan, pelbagai akaun, proksi, dasar lampiran, reka bentuk laporan, akses penilai, cap masa luaran dan penyimpanan luar tapak memenuhi keperluan penyiasatan dan penyerahan yang berbeza. Konfigurasikan ciri-ciri tersebut apabila ia relevan.

Skop, kebenaran dan salinan perkongsian yang diminimumkan membantu pengendali memilih apa yang hendak dikumpul dan didedahkan. Panduan bidang kuasa dan tetapan laporan merekodkan prosedur yang dipilih dan langkah penyediaan. Lihat [eksport akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/account-export/), [capaian](https://phishdestroy.io/tgwitness/ms/docs/reference/access/) dan [konfigurasi laporan](https://phishdestroy.io/tgwitness/ms/docs/reference/case-reports/).

Aplikasi ini dijalankan pada komputer atau pelayan yang dipilih. Pengumpulan asas tidak memerlukan GPU atau LLM. OCR pilihan, transkripsi dan analisis AI mempunyai keperluan sumber mereka sendiri. Saizkan penyebaran untuk kadar mesej, lampiran, sejarah yang disimpan dan akaun serentak.

## Pelihara rekod itu, sesiapa pun yang dibantunya

Tujuannya adalah untuk memelihara bahan yang diperhatikan, konteks dan perubahan tanpa mengira siapapun yang disokong olehnya. Bukti mungkin mencabar akaun pengumpul sendiri mengenai peristiwa. Pastikan pemerhatian sumber, liputan yang hilang dan kesimpulan analitik boleh dikenal pasti supaya orang lain dapat menilai bahan yang sama.

Logikanya ialah: pemerhatian yang boleh dilihat oleh akaun → jurnal yang disahkan → eksport → penerima pengesahan. Suntingan yang disimpan menambah versi. Pemerhatian yang dipadam mengekalkan kandungan yang telah dirakam sebelum ini. Rekod liputan mendedahkan gangguan yang diketahui. Laporan dan analisis AI merujuk kembali kepada sumber yang disimpan; satu tafsiran tidak menjadi pemerhatian sumber hanya kerana ia muncul dalam laporan yang disahkan.

| Semakan pengesahan | Apa yang boleh disahkan oleh penerima |
| --- | --- |
| Hash fail, tandatangan dan rantaian jurnal | Rekod dan fail yang disediakan selari dengan sempadan kunci dan jurnal yang dijangkakan |
| Satu titik pemeriksaan atau saksi yang disimpan secara berasingan | Arkib ini sepadan dengan keadaan jurnal yang telah disimpan sebelum ini |
| Cap masa luaran yang disahkan | Byte yang dirujuk wujud berdasarkan cop masa di bawah andaian kepercayaan yang dinyatakan |
| Pengesahan tangkapan GitHub | Arkib ini sepadan dengan aliran kerja yang diluluskan, semakan pengumpul dan ringkasan yang direkodkan |
| Pengesahan Intel TDX | Petikan, status platform, ukuran OS/aplikasi yang dijangka, kesegaran dan identiti pengumpul lulus pemeriksaan yang dikonfigurasikan |

Dalam pengambilan yang disahkan, sambungan Telegram berotentikasi dan keluaran pengumpul yang diluluskan diikat kepada persekitaran pelaksanaan yang diperiksa. Arkib mengekalkan kandungan dan konteks yang dirakam; laporan dan analisis merujuk kembali kepada rekod tersebut. Gunakan langkah pengesahan khusus mod dan input yang dipercayai dalam [panduan kepercayaan](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md) dan [format bukti](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/).

## Skala yang diterbitkan dan prestasi yang diukur

Hasil berikut menerangkan beban kerja dan tarikh yang berbeza. Bilangan tidak boleh ditukar ganti: satu peristiwa jurnal tidak semestinya satu mesej Telegram unik.

| Tarikh | Beban kerja | Hasil terbitan | Apa yang diukur |
| --- | --- | --- | --- |
| 1 November 2026 | Pelayan berjalan, sepuluh pangkalan data ruang kerja | 1,610,818 rekod jurnal; 900,232 acara mesej baru, 80,683 acara suntingan dan 400,536 acara pemadaman | Inventori bacaan sahaja jurnal yang disimpan |
| 5 November 2026 | Cari lebih daripad1,000,000 mesej sintetik dalam 200 sembang | Indeks dibina dalam 71saat; masa carian median bagi setiap pertanyaan ialah 9–190ms | Penanda aras carian tempatan |
| 6 November 2026 | Dua eksport Telegram sebenar baharu | 27,030 dan 29,299 mesej; 56,329 mesej merentas kedua-dua larian | Dua akaun setiap pelaksanaan melalui WARP, teks dan metadata, tiada muat turun lampiran |
| 6 November 2026 | Dua eksport yang sama, termasuk penyediaan dan pembungkusan | 127.713 dan 141.781 mesej/saat | Kadar eksport lengkap yang diukur; kedua-dua arkib disahkan menentang kunci yang dipasang |

[Rekod pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/verification/) memberikan inventori pelayan, pemeriksaan pengumpulan langsung dan pengukuran carian. [Eksport prestasi](https://phishdestroy.io/tgwitness/docs/validation/) menerbitkan dua larian sebenar, perkakasan, tempoh, hash arkib dan fail pengukuran yang disahkan, masing-masing dengan semakan dan syarat yang direkodkan.

[Kelayakan sejarah awam](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md) juga merekodkan **48 arkib disahkan dengan 3,598,381 rekod** merangkumi senarai input 50 sumber dan 40 ruang kerja akaun. Sumber A lapan akaun memperoleh **768,007 rekod sejarah dalam 1,117.082 saat**, termasuk masa menunggu: **687.512 rekod/saat**, dengan muat turun lampiran dilumpuhkan. Percubaan lengkap, termasuk pengesahan, mengambil masa 1,574.920 saat. Ukuran ini menerangkan beban kerja tersebut, bersama contoh eksport baharu yang lebih kecil di atas.

### Sejarah dan tempoh ujian

TgWitness telah dibangunkan dan diuji selama kira-kira enam bulan. Pengumpul, jurnal yang disahkan dan pengesah dibina terlebih dahulu; panel web dan modul tambahan dibina di atasnya kemudian. Repositori ini diwujudkan baharu pada 29 Oktober 2026 untuk penerbitan dan bermula dengan kod sedia ada, jadi umurnya bukan umur projek ([sejarah pembangunan](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history)). Jumlah beban kerja yang telah dijalankan adalah sekitar 100 juta, termasuk pelaksanaan terdahulu, kegagalan, pembetulan dan pengesahan berulang. Pelaksanaan terpilih, masing-masing dengan semakan, kaedah dan keputusan sendiri, didokumenkan dalam [ukuran awam bertarikh](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements).

## Baca status kebolehan dengan tepat

Nilai setiap aliran kerja berdasarkan pelaksanaannya, binaan yang diterbitkan dan ujian yang dirakam. Sumber pada masa ini dilabelkan pratonton. Label keluaran itu wujud bersama dengan pengumpulan berfungsi, eksport, pengesahan bebas dan pengukuran skala yang diterbitkan. Ciri pratonton dan aliran kerja yang disahkan boleh wujud dalam aplikasi yang sama; terangkan ciri khusus dan bukti di sebalik penilaian.

Gunakan [keupayaan semasa](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md), [ciri dan had](https://phishdestroy.io/tgwitness/ms/docs/reference/features/), [pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/verification/) dan [log perubahan](https://phishdestroy.io/tgwitness/ms/docs/reference/changelog/) secara serentak. Rekodkan semakan yang diuji apabila memetik keputusan. Snekapukur pengukuran 6 November juga mengekalkan ujian yang gagal dan yang dilangkau; itu bukan lulus.

## Boleh dibaca oleh manusia dan alat AI

Laman web ini menyediakan `llms.txt` yang ringkas, buku panduan lengkap Bahasa Inggeris dalam `llms-full.txt` dan `llms-full.md`, serta edisi Markdown untuk halaman-halamannya. Ini adalah format dokumentasi, bukan keperluan AI untuk menjalankan TgWitness.

Pilihan [MCP](https://phishdestroy.io/tgwitness/ms/docs/reference/mcp/) dan [akses baris perintah](https://phishdestroy.io/tgwitness/ms/docs/reference/cli/) membolehkan alat yang dibenarkan membaca rekod terpilih yang disimpan. Kandungan mesej kekal sebagai input yang tidak dipercayai. Ringkasan harus memetik sumber, membezakan fakta yang diperhatikan daripada inferens dan mengekalkan ketidakpastian. Carian penuh teks, OCR dan keluaran AI tidak mengubah pemerhatian asal yang ditandatangani.
