# Telegram · Format bukti

Canonical page: https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/

Kandungan ZIP yang disahkan, jenis rekod, resit proses, profil orang, salinan luar tapak dan pengesahan luar talian.

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

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

Translation coverage: this edition includes material from the English original.

Kandungan ZIP yang disahkan, jenis rekod, resit proses, profil orang, salinan luar tapak dan pengesahan luar talian.

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

![Bukti & pengesahan](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

TgWitness mengekalkan pemerhatian Telegram yang boleh dilihat oleh akaun dalam jurnal yang disahkan. Penerima boleh mengesahkan rekod yang disimpan, lampiran dan laporan berbanding kunci pengumpul yang dipercayai, menyemak masa luaran daripada pihak ketiga untuk rekod terakhir, dan membandingkan jurnal dengan titik pemeriksaan yang mereka simpan sebelum ini. Halaman ini menerangkan format, semakan dan bahan untuk diserahkan.

Penerima boleh memulakan dengan **VERIFY.cmd** pada Windows: ia meminta ZIP asal dan cap jari kunci yang diperoleh secara bebas, memaparkan keputusan yang dijelaskan, dan menyimpan transkrip pengesahan berasingan. Lihat [pelancar pengesahan dan persekitaran larian mudah alih](https://github.com/phishdestroy/TgWitness/blob/main/docs/VERIFICATION_LAUNCHER.md) untuk penyediaan dan had kepercayaan.

**Pada halaman ini**

- [Apa yang ditandatangani](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#what-is-signed)
- [Membandingkan eksport sembang](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#comparing-chat-exports)
- [Serahan siasatan](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#investigation-handoff)
- [Petikan penyerahan](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#handover-extract)
- [Laporan yang boleh dibaca](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#readable-reports)
- [Kanonalisasi acara](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#event-canonicalization)
- [Semantik pelaku](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#actor-semantics)
- [Liputan: kesinambungan, jurang dan ID yang tidak diperhatikan](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)
- [Pengeluar](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#producer)
- [Profil orang](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#people-profiles)
- [Saksi bebas](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#independent-witness)
- [Manifest dan checkpoint](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#manifest-and-checkpoints)
- [Skop pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#verification-scope)
- [Lampiran](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#attachments)
- [Koleksi dan resit proses tahan lama (0.2)](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#durable-collection-and-process-receipts-02)
- [Persiapan RFC 3161 dan pengesahan respons (0.2)](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#rfc-3161-preparation-and-response-verification-02)
- [Rekod pilihan dalam mod bukti: drand dan peranti Telegram](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)

## Apa itu ditandatangani

| Bahan | Perlindungan | Apa yang perlu disimpan |
| --- | --- | --- |
| Setiap pemerhatian jurnal, termasuk peristiwa operasi | Rantaian SHA-256 dan tandatangan Ed25519 bagi setiap peristiwa | `events.jsonl` asal, cap jari kunci yang dipercayai, dan checkpoint yang dikekalkan |
| Kandungan ZIP bukti | `manifest.sig` menandatangani manif kanonik, yang menyenaraikan hash fail kandungan | Fail ZIP lengkap, termasuk manifes dan tandatangan |
| Lampiran yang disimpan | SHA-256 dan kiraan bait dalam acara `media.saved` yang ditandatangani; hash fail dalam manifes ZIP yang ditandatangani | Byte asal di dalam ZIP yang disahkan |
| Pemeriksaan | Tandatangan Ed25519 merangkumi keseluruhan jurnal, hash kepala, kunci awam, dan masa penciptaan | Salinan bebas yang disimpan sebelum perubahan yang dipertikaikan |
| Resit pelaksanaan | Rekod berasingan versi pengumpul, hash fail sumber dan tetapan permulaan, juga disertakan dalam `process.started` | Resit, jurnal berkaitan dan bukti persekitaran untuk mod pengesahan yang dipilih |
| Laporan yang boleh dibaca: `report.html` dan bahagian-bahagiannya, `report.json`, `report.pdf`, `chat.pdf` | Setiap fail disegel dengan cap Ed25519; PDF juga membawa tandatangan piawai PDF (lihat [Laporan boleh dibaca](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#readable-reports)) | Fail seperti yang diterima dan cap jari kunci dipercayai; ZIP yang diterangkan |
| CSV berdiri sendiri | Tiada tandatangan kriptografi berdiri sendiri; hash peristiwa sahaja tidak mencukupi | Gunakan salinan tepat di dalam fail ZIP yang disahkan untuk pemeriksaan integriti |
| Skrinshot, cetakan, atau PDF yang dihasilkan oleh pelayar | Tiada tandatangan TgWitness pada derivatif | Simpan pakej asal yang disahkan dan dokumentasikan bagaimana derivatif itu dibuat |

Pengumpul mengesahkan tandatangan jurnal sebelum menjana setiap format eksport. Laporan HTML dan PDF yang boleh dibaca mempunyai meterai masing-masing; CSV berdiri sendiri diperiksa sebagai sebahagian daripada ZIP yang ditandatangani. Simpan ZIP untuk mengekalkan bait lampiran dan manifes, serta titik pemeriksaan berasingan untuk menyemak jurnal dengan sempadan terdahulu.

## Format dan laluan pengesahan

Mod pemerolehan dan format keluaran menjawab soalan yang berbeza. Mod ini menyediakan bukti pengumpulan dan persekitaran; setiap format mengekalkan atau mempersembahkan sebahagian daripada rekod tersebut dengan pemeriksaan di bawah.

| Keluaran | Pengesahan dan penggunaan |
| --- | --- |
| Bukti ZIP | Acara kanonik, manif tersurat, liputan, entri pemeliharaan, lampiran dan resit luaran yang tersedia; semak arkib dan mod pemerolehan terpilihnya. |
| Kontena ASiC-E | Bukti ZIP sebagai bekas ETSI ASiC-E (EN 319 162-1) dengan entri `mimetype` dan `META-INF/ASiCManifest.xml`, ditandatangani CAdES dengan sijil ruang kerja sendiri pada tahap B-B, atau B-T apabila cap masa diaktifkan. Pemvalid seperti EU DSS memeriksa format dan integriti dan, kerana sijil dikeluarkan sendiri, melaporkan tiada titik rujukan kepercayaan. EU DSS 6.3 dengan tetapan lalai menolak bekas yang mempunyai lebih daripada 1000 fail ("Terlalu banyak fail dikesan"). `verify.py` memeriksa manifest Ed25519 dan setiap fail yang disenaraikan, nilai SHA-256 dalam `META-INF/ASiCManifest.xml` dan dalam `ASiCManifestNNN.xml` atau `ASiCEvidenceRecordManifest.xml` yang ditambah, dan gagal pada entri `META-INF/` yang tiada satu pun daripadanya merangkumi. Ia tidak memeriksa tandatangan CAdES dan melaporkannya. |
| Laporan HTML dan JSON | Paparan yang disegel secara berasingan dengan rujukan sumber, juga disenaraikan dalam manifes ZIP. Jumlah yang direkodkan merumuskan jenis peristiwa jurnal. |
| Laporan PDF | Segel Ed25519 ditambah tandatangan PDF asas PAdES merangkumi julat bait: B-B, atau B-T dengan cap masa tandatangan apabila cap masa diaktifkan. Pemeriksa TgWitness menggunakan kunci Ed25519 yang dipercayai; paparan kepercayaan sijil pemirsa adalah semakan berasingan. |
| CSV | Paparan hamparan dilindungi oleh manifes ZIP. Pelarian formula melindungi penggunaan hamparan; teks yang ditandatangani asal kekal dalam jurnal. |
| JSONL | Rekod peristiwa yang ditandatangani, termasuk rujukan lampiran. ZIP bukti juga mengandungi bait lampiran yang dipelihara. |
| Eksport sembang dan paparan serasi Desktop | Pendapatan sejarah dan rekod log pentadbir yang tersedia, dengan paparan yang diminta dan arkib yang disahkan. Versi yang disimpan oleh pemantauan langsung adalah laluan perolehan berasingan. |
| Rekod media dan hanya hash | Bait yang disimpan disemak menentang SHA-256 mereka dan rujukan mesej. Pengambilan hanya-hash mengekalkan metadata hash yang tersedia untuk perbandingan kemudian dengan bait fail. |
| STIX/MISP dan profil orang | Perhatian yang diekstrak dan dipautkan kepada sumber, ID akaun dan padanan analitik. Tandatangan profil dan hash rekod boleh disemak menentang bukti asal; asal-usul cache avatar dilabel secara berasingan. |
| Petikan penyerahan | Peraturan pendedahan yang disahkan, rekod yang tidak berubah dan rekod yang ditandakan dikurangkan mengekalkan hash/tandatangan asal. Gunakan rekod asal yang dikekalkan untuk perbandingan yang memerlukan medan yang disembunyikan. |
| Saksi dan resit masa | Batas jurnal terdahulu, kesinambungan dan tuntutan masa terverifikasi individu. Mereka disertakan bersama pemeriksaan pemerolehan dan arkib. |
| Penghantaran yang dilindungi kata laluan | Melindungi pakej yang disertakan semasa pemindahan. `.tgwpw` menggunakan penyulitan disahkan AES-GCM, termasuk rekod akhir yang disahkan; jurnal yang disertakan mengekalkan tandatangan dan resit pemerolehan. |

Keluaran cetak atau tangkapan skrin adalah penyampaian bahan yang disahkan. ID laporan, cap jari kunci dan rujukan QR membantu mengesan fail asal untuk pengesahan. Pernyataan pemilikan merekodkan pemeriksa yang dibekalkan dan maklumat pemindahan; keputusan pengesah dan resit pemerolehan disimpan sebagai bukti berasingan.

### Tandatangan luaran

Tandatangan juga boleh berasal daripada kunci yang tidak pernah dipegang oleh TgWitness, seperti tandatangan elektronik bertauliah penyiasat atau meterai organisasi. Pada **Eksport**, **tandatangan luaran** pada eksport yang telah disediakan tanpa kata laluan menyerahkan bait untuk ditandatangani: satu yang baru `META-INF/ASiCManifestNNN.xml` menyenaraikan setiap fail dengan SHA-256 untuk bekas ASiC-E, atau eksport tersebut `manifest.json` untuk ZIP. Penandatangan mengembalikan CMS (CAdES) `.p7s`, terpisah atau dengan kandungan disematkan.

TgWitness memeriksa bahawa tandatangan merangkumi bait-bait tersebut dengan tepat dan mengesahkannya menggunakan sijil penandatangan (RSA PKCS#1 v1.5, RSASSA-PSS, ECDSA, Ed25519, Ed448). Rantaian hanya disemak menentang sijil akar yang dibekalkan oleh pengendali; pembatalan, senarai dipercayai dan status berkelayakan tidak disemak. Panel menunjukkan satu keadaan bagi setiap tandatangan: menunggu tandatangan, dilampirkan dan belum disemak, disahkan, algoritma tidak disokong, tandatangan tidak sah, bait yang ditandatangani tidak sepadan, atau sijil tidak berantai kepada akar yang dibekalkan. Mengubah suai eksport selepas bait diberikan akan menetapkan semua tandatangan padanya kepada "bait yang ditandatangani tidak sepadan".

**Muat turun dengan tandatangan** menambah tandatangan dan manifes mereka di bawah `META-INF` dalam bekas ASiC-E. Untuk ZIP, ia meletakkan ZIP yang tidak berubah, `.p7s` fail dan `SIGNATURES.txt` ke dalam ZIP luaran. Tandatangan yang tidak sah dan tandatangan yang terletak di atas bait lain diabaikan. Tandatangan dengan algoritma TgWitness yang tidak dapat disahkan disertakan; panel menunjukkan statusnya, begitu juga `SIGNATURES.txt` untuk ZIP.

### Imej sembang bertandatangan

**Muat turun ZIP yang ditandatangani** dalam pratonton imej menyimpan halaman PNG, `pages.sig.json` dan `README.txt`. Setiap halaman diakhiri dengan nombor rekod jurnal yang dipaparkan, sembang, masa pemprosesan, cap jari kunci ruang kerja dan arahan yang menyemaknya. Panel hanya menghantar SHA-256 dan nombor rekod setiap halaman; pelayan mengesahkan bahawa rekod-rekod itu milik sembang tersebut, menandatangani pernyataan (`tgwitness-image-attestation-v1`) dengan kunci ruang kerja dan merekodkan penandatanganan sebagai `export.image_attested`.

```
python verify.py page-01.png page-02.png pages.sig.json
python verify.py page-*.png pages.sig.json --fingerprint TRUSTED_SHA256 --evidence evidence.zip
```

Pemverifikasi memeriksa tandatangan, memadankan setiap PNG dengan halaman yang ditandatangani dan melaporkan cap jari kunci. `--fingerprint` membandingkan penandatangan dengan cap jari yang diperoleh daripada penghantar secara berasingan. `--evidence` membaca ZIP bukti yang ditandatangani daripada ruang kerja yang sama dan memerlukan setiap rekod imej hadir dengan hash yang sama. Pixel yang berubah, pernyataan yang berubah atau kunci lain menyebabkan pemeriksaan gagal. Imej-imej tersebut menunjukkan rekod yang disimpan dalam susun atur TgWitness sendiri; ia tidak menunjukkan apa yang dipaparkan Telegram kepada sesiapa pun.

## Membandingkan eksport sembang

Sahkan dan bandingkan dua ZIP eksport sembang yang ditandatangani dengan cap jari penandatangan yang disimpan secara berasingan:

```
python -m tgwitness.verify first.zip --compare second.zip \
  --fingerprint FIRST_TRUSTED_KEY_SHA256 --compare-fingerprint SECOND_TRUSTED_KEY_SHA256
```

`--require` dan `--require-tier` ditolak bersama dengan `--compare`; semak profil yang diperlukan bagi setiap arkib dengan pengesahan masing-masing.

Apabila kedua-dua arkib merekodkan ID akaun dan sembang numerik yang sama, rekod dipadankan oleh ID mesej. **Tidak berubah** bermaksud kesamaan rekod JSON yang disimpan sepenuhnya: teks penuh, pengarang, tarikh, sasaran balasan, metadata bersarang dan medan tidak diketahui semuanya disertakan. Susunan kunci objek JSON tidak penting; medan yang tiada, nilai null, jenis nilai dan susunan senarai adalah penting. Pratonton 300 aksara hanya untuk paparan. Kemasukan yang diubah dinamakan `changed_fields` aras atas yang berbeza, termasuk perubahan yang tidak kelihatan dalam pratonton tersebut. ID mesej ganda ditolak dan bukannya saling menimpa semasa padanan.

Perbezaan boleh berupa nama paparan yang diubah, bilangan tontonan, anotasi koleksi atau metadata pemerhatian lain. Suntingan Telegram muncul sebagai acara suntingan tersendiri, dan pengesahan setiap arkib menunjukkan sama ada arkib tersebut utuh. Rekod yang tidak diparsing kekal dalam perbandingan dan dibandingkan berdasarkan representasi yang disimpan.

Untuk identiti akaun/perbualan yang berbeza atau tiada, alat ini mencari padanan calon menggunakan penghantar, teks lengkap, hash fail, jenis media dan toleransi masa lima saat, dan melaporkannya sebagai **Matched** dan bukannya **Unchanged**. Rekod yang tidak diparsing kekal tidak sepadan. Perbezaan dalam rekod berpasangan disenaraikan dalam `changed`, termasuk dalam mod kandungan. Dengan `--json`, `matched` mengira pasangan calon dan `unchanged` mengira pasangan yang rekod penyimpanan lengkapnya sama. Keluaran `changed_fields` dan integer `unchanged` sedia ada kekal serasi dengan keputusan perbandingan terdahulu. Format arkib dan pengesahan tandatangan tidak berubah.

## Penyerahan siasatan

1. Rakam rujukan kes, pengendali, ID akaun Telegram berangka yang dipilih, dasar pengumpulan, dan tempoh pengumpulan dalam nota kes anda. TgWitness memelihara pemerhatian dan menyokong nota serta koleksi yang dipautkan kepada sumber dalam [Case Board](https://phishdestroy.io/tgwitness/ms/docs/reference/case-board/). Simpan rekod pemindahan dan pemilikan bersama bahan kes anda. Semak tetapan pengumpulan yang dimaksudkan dengan [prosedur penerimaan secara langsung](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/LIVE_ACCEPTANCE.md).
2. Simpan cap jari kunci awam ruang kerja secara bebas sebelum bergantung pada eksportnya. Kekalkan mod bukti (lalai) supaya titik pemeriksaan menerima resit RFC 3161 dan OpenTimestamps. Simpan titik pemeriksaan yang ditandatangani di luar pengumpul semasa pengumpulan. Catatkan gangguan dan had keterlihatan akaun.
3. Eksport **ZIP** yang **ditandatangani** dan simpan resit pelaksanaan yang ditandatangani. Gunakan titik pemeriksaan pada atau sebelum sempadan jurnal yang dieksport. Titik pemeriksaan kemudian boleh menolak dengan betul eksport sebelumnya sebagai terlalu pendek. Eksport merangkumi keseluruhan jurnal ruang kerja, tanpa mengira penapis panel; semak bahan sebelum berkongsi.
4. Minta penerima mengesahkan ZIP dengan salinan verifier yang dipercayai, cap jari yang dibekalkan secara berasingan dan sijil akar pihak berkuasa cop masa yang diperoleh secara berasingan. Daripada checkout yang dipercayai dengan persekitaran Python aktif:

   ```
   python -m tgwitness.verify evidence.zip --fingerprint TRUSTED_PUBLIC_KEY_SHA256 --tsa-ca TSA-ROOT.pem --checkpoint retained-checkpoint.json --require evidence
   ```

   Cap jari dan cap masa yang disemak pada rekod terakhir memenuhi minimum untuk bukti; `--require evidence` keluar dengan kod 2 jika tidak. Titik pemeriksaan adalah pemeriksaan sokongan, kerana ia ditandatangani dengan kunci pengumpul. Keluaran berjaya melaporkan `key_pinned: true` dan `checkpoint_checked: true` apabila kedua-dua input dibekalkan dan diterima. Pelihara keputusan pengesahan.

   ```
   For a handover requiring the final exported record to be witnessed, use
   `--witness witness.zip --witness-fingerprint TRUSTED_WITNESS_SHA256 --require-witness`.
   This refuses an export with an unwitnessed tail. Add
   `--channel https://t.me/s/WITNESS_CHANNEL` to read the dates Telegram set on the
   witness posts as external time. See the
   [witness handover procedure](WITNESS.md#require-a-witnessed-export-boundary).
   ```

   1. Rakam SHA-256 arkib, sempadan eksport, tarikh pemindahan, penghantar, dan penerima dalam rekod pemilikan anda. Kekalkan bungkusan asal utuh dan kerjakan salinan. Kongsi fail bukti dan bukannya direktori data peribadi aplikasi, yang juga mengandungi sesi akaun dan rahsia penandatanganan. Untuk pemindahan, pilih ZIP AES-256 yang dilindungi kata laluan atau bekas `.tgwpw` yang lebih kuat. ZIP menggunakan penghasilan kata laluan kos rendah WinZip; gunakan frasa laluan rawak yang panjang. `.tgwpw` menggunakan scrypt dan AES-256-GCM dan dibuka dengan arahan `unseal-password` pemverifikasi berdiri sendiri. Kata laluan tidak disimpan dan hanya melindungi kerahsiaan; penerima menyahsulit arkib tersebut dan mengesahkan eksport yang ditandatangani di dalamnya, yang tidak berubah.
   2. Untuk mencopatkan masa pada titik pemeriksaan di luar mod bukti, ikuti [prosedur RFC 3161](https://phishdestroy.io/tgwitness/ms/docs/reference/timestamp/) dan simpan permintaan, titik pemeriksaan, maklumat CA dipercayai, dan respons pihak berkuasa yang disahkan. Menyediakan permintaan sahaja tidak memperoleh cop masa.

Untuk `.tgwpw`, gunakan pengesah yang diperoleh secara bebas dan pilih fail keluaran baru dengan sambungan asal: `python verify.py unseal-password export.tgwpw --out evidence.zip`. Arahan ini meminta kata laluan; `--password-stdin` membaca satu baris untuk automasi. Ia tidak pernah menimpa fail sedia ada dan menerbitkan teks biasa hanya selepas semua rekod disahkan. Jalankan pengesahan tandatangan biasa pada fail yang telah disulitbalikkan kemudian. Kontener ini menggunakan scrypt (`N=131072`, `r=8`, `p=1`, garam 16 bait; kira-kira 128 MiB RAM) dan AES-256-GCM dengan rekod 1 MiB dan satu rekod akhir yang disahkan. Satu rekod metadata yang disulitkan menyimpan nama fail dalaman, supaya kontener yang dimuat turun boleh dinamakan semula.

Pengesahan yang berjaya menetapkan integriti berbanding kunci pengumpul yang dipercayai dan sempadan yang dikekalkan. Lihat [skop pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#verification-scope) untuk andaian kepercayaan dan [keputusan pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/verification/) bagi semakan yang dijalankan.

## Petikan penyerahan

Fail ZIP yang disahkan memuatkan keseluruhan jurnal ruang kerja. Apabila mahkamah, peguam atau meja penyalahgunaan hanya memerlukan beberapa perbualan, tempoh tertentu atau individu tertentu, **Eksport → Ekstrak Penyerahan** menyediakan salinan minimum (`tgwitness-handover-v1`) mengikut peraturan pendedahan yang dipilih. Pengendali menyatakan tujuan dan memilih sembang, tempoh pilihan (UTC), orang yang berkaitan dengan ekstrak, apa yang berlaku kepada orang lain (dipaparkan, digantikan dengan nama palsu P01, P02… atau diabaikan), teks mesej mana yang kekal, lampiran dan foto profil mana yang disertakan, dan sama ada nombor telefon dan alamat e-mel dalam teks disamarkan. Tujuan dan peraturan ini terdapat dalam manifes yang ditandatangani dan dalam laporan; jurnal merekodkan `handover.exported` dengan akses yang menyediakan ia dan SHA-256 fail, bukan kandungannya.

`verify.py` memeriksa petikan dengan dua cara. Rekod yang ditunjukkan tidak berubah disahkan sepenuhnya: kandungannya dengan hash-nya, tandatangan Ed25519-nya dan pautannya kepada pendahulu yang disertakan. Rekod yang diminiaturkan mengekalkan hash dan tandatangan asal, jadi tandatangan itu masih sah, tetapi medan yang disembunyikan tidak dapat dikira semula daripadanya; rekod tersebut menyatakan apa yang disembunyikan dan laporan menandakannya. Rekod perkhidmatan merentas akaun (permulaan dan hentian, jurang liputan, pemberitahuan sambungan, rangkaian dan penyimpanan, perubahan skop dan tetapan) hanya mengekalkan medan yang disenaraikan untuk jenisnya: senarai sembang di dalamnya dipotong kepada yang dipilih perbualan dan jumlahnya dikira semula, dan jurang probe-langsung dalam perbualan di luar pilihan akan menyebabkan kehilangan perbualan itu, nombor mesejnya dan akaun saksi; dalam perbualan probe pilihan, akaun saksi digantikan dengan nama samaran kecuali jika semua orang dapat dilihat atau ia adalah salah seorang daripada orang yang dipilih. Manifesto menamakan panjang jurnal dan kepala dengan tandatangan pengumpul di atas kepala itu, dan mengira rekod yang terlepas; `coverage.json` menerangkan sembang yang dipilih. Ekstrak baru juga mengandungi `proofs.jsonl`: untuk setiap rekod yang disertakan dan untuk kepala jurnal, laluan Merkle dari hash asal rekod tersebut ke akar jurnal yang dinamakan dalam manifesto yang ditandatangani. `verify.py` memeriksa setiap laluan, jadi setiap rekod dipaparkan sebagai milik jurnal yang sama dengan panjang dan kepala tersebut, tanpa keseluruhan jurnal; petikan 100 mesej memeriksa dalam kira-kira satu saat tanpa mengira saiz jurnal. `--range=CHAT:FROM-TO` juga mengesahkan bahawa mesej DARI ke kepada TO dalam sembang tersebut terdapat dalam ekstrak dan melaporkan berapa banyak rekod yang telah diperiksa untuknya. Nama di dalam nama fail tidak dikesan. Semak fail akhir sebelum dikongsi: teks bebas, nama fail dan lampiran terpilih masih boleh mengenal pasti individu. Simpan ZIP penuh yang ditandatangani: ekstrak adalah pendedahan, bukan pengganti.

## Laporan yang boleh dibaca

Bukti bertandatangan, handover dan fail ZIP sembang mengandungi laporan HTML dan JSON yang boleh dibaca, serta PDF apabila fon yang diperlukan tersedia, dalam bahasa laporan yang dipilih. Setiap laporan disegel dengan kunci Ed25519 ruang kerja dan boleh disahkan secara berasingan: `python -m tgwitness.verify FILE --fingerprint KEY [--evidence ZIP]`.

- `report.html` / `chat.html`: pernyataan meterai (`tgwitness-report-seal-v1`) menutup fail dan menandatangani SHA-256 bagi setiap bait sebelumnya. Jurnal dan sembang panjang dibahagikan kepada bahagian bersaiz boleh laras (Tetapan Laporan, 500 hingga 100,000 rekod; 5,000 secara lalai): `records/records-0001.html` atau `messages/messages-0001.html`, masing-masing disegel dengan nombornya, julat dan jumlahnya, serta disenaraikan bersama SHA-256 dalam manifes yang ditandatangani. Susunan degupan jantung pengumpul dipaparkan sebagai satu baris melainkan tetapan Laporan menyenaraikannya satu per satu.
- `report.json` (`tgwitness-report-json-v1`, kunci `format`, `report`, `seal`): meterai menandatangani SHA-256 bagi JSON kanonik `report`, supaya fakta boleh dibaca oleh sistem kes dan skrip dan pilihan untuk perlindungan data boleh dibuat daripadanya sementara fail yang disahkan kekal utuh.
- `report.pdf` / `chat.pdf`: dokumen formal untuk mencetak dan menyimpan, ditandatangani dua kali pada bytes yang sama, keseluruhan fail kecuali nilai tandatangan (`/ByteRange`). Tandatangan PDF piawai adalah PAdES baseline (ETSI EN 319 142-1, `/SubFilter /ETSI.CAdES.detached`: CMS dengan SHA-256 dan ECDSA P-256, signing-certificate-v2, tiada cap masa penandatanganan CMS; masa yang didakwa adalah `/M`) pada tahap B-B, atau B-T dengan cap masa tandatangan RFC 3161 dalam CMS apabila cap masa diaktifkan dan pihak berkuasa cap masa menjawab melalui laluan untuk permintaan di luar Telegram. Ia menggunakan sijil tandatangan dokumen yang dikeluarkan sendiri dan disimpan dalam peti keselamatan ruang kerja; nombor siri subjeknya ialah cap cap jari kunci Ed25519. Segel Ed25519 bergerak di dalam CMS sebagai atribut tidak ditandatangani `2.25.240684792623320047764573196045913242332` dan menamakan SHA-256 sijil dengan `"content": "pdf-byte-range"`, jadi kunci Ed25519 menjamin sijil itu. Sijil itu tidak disahkan: pembaca PDF memaparkan tandatangan sebagai sah dan penandatangan sebagai tidak dikenali atau tidak dipercayai sehingga sijil itu dipercayai; bandingkan sebaliknya cap jari Ed25519. PDF Cina, Jepun dan Korea memerlukan fon pada pelayan (atau dalam `TGWITNESS_FONT_DIR`); tanpa fon tersebut, ZIP hanya mengandungi laporan HTML dan JSON sahaja.
- `report.en.html`, `report.en.pdf` / `chat.en.html`, `chat.en.pdf`: asal Bahasa Inggeris bagi laporan yang sama apabila bahasa laporan bukan Bahasa Inggeris, dimeterai dan ditandatangani dengan cara yang sama serta dinamakan di bawah `report.original` dalam manifes yang ditandatangani. Laporan dalam bahasa yang dipilih dibuka dengan cadangan untuk memfailkan asal Bahasa Inggeris bersama terjemahan yang disahkan atau bersumpah; lihat [Menterjemah laporan untuk mahkamah](https://phishdestroy.io/tgwitness/ms/docs/reference/translation/).

Dalam saluran atau superkumpulan, Telegram menyusun nombor mesej 1, 2, 3… mengikut urutan. Eksport sembang menyenaraikan nombor pertama dan terakhir, berapa banyak yang hadir dan setiap siri nombor yang tiada dalam `message-ids.json` , manifes dan tajuk `chat.json` , serta menandakan setiap jurang di mana ia terletak dalam transkrip. `verify.py` menyenaraikannya semula daripada `chat.json` . Nombor yang tiada ialah mesej yang tidak dikembalikan oleh Telegram (dihapuskan sebelum eksport, atau tidak dapat dilihat oleh akaun); dalam sembang peribadi dan kumpulan asas, nombor dikongsi oleh semua sembang dalam akaun dan jurang tidak dikira.

Selepas membaca sejarah, eksport bertanya semula kepada Telegram untuk setiap nombor yang tiada, mengikut nombor (`channels.getMessages`, sehingga 10,000 nombor termasuk 1,000 di bawah mesej pertama, diedarkan secara sama rata ke atas semua jurang apabila terdapat lebih banyak). Keputusannya adalah dalam `message-ids.json` dan laporan. Jawapan kosong merekodkan bahawa nombor itu tidak tersedia untuk akaun ini pada masa semakan semula; ia tidak menyatakan puncanya. Sebarang mesej yang dikembalikan semasa semakan semula ditambah ke dalam eksport dan ditandakan `found_on_recheck`.

Apabila ruang kerja pemerhatian mendapati mesej perbualan telah dipadam, hilang semasa semakan semula atau diubah suai, eksport perbualan menambah `journal-changes.jsonl`: rekod jurnal tersebut, setiap versi yang disimpan dan pemberitahuan, masing-masing dengan suai hujar dan tandatangan Ed25519 yang diterimanya dalam jurnal. `verify.py` mengira semula hash setiap rekod, memeriksa tandatangan terhadap kunci eksport dan membandingkan kiraan dengan manifes yang ditandatangani; eksport bukti memegang rantaian hash lengkap. Laporan menyenaraikan mesej-mesej ini di bawah **Pemadaman dan versi terdahulu**.

Setiap laporan dibuka dengan **Secara ringkas**: satu perenggan, kemudian apa yang ditunjukkan oleh bahan tersebut dan kandungan rekod. Cop meterai pada halaman itu sendiri bertukar menjadi amber apabila pelayar mengesahkan tandatangan meterai, bukan halaman: pelayar tidak memberikan halaman itu baitnya sendiri. Ia bertukar hijau hanya apabila pembaca meletakkan fail ke dalam pemeriksaan di hujung halaman dan setiap bait sepadan, dan hanya jika halaman yang dipaparkan adalah fail tersebut; jika tidak, ia bertukar merah.

Setiap laporan menamakan program dengan tepat: komit git apabila pengumpul dijalankan daripada checkout atau pemasang menetapkan `TGWITNESS_COMMIT`, dan SHA-256 bagi fail sumbernya (`source_tree_sha256`, JSON kanonik bagi laluan → SHA-256 setiap `.py`, `.js`, `.css`, `.html` dan `.svg` dalam pakej), yang dihasilkan semula oleh checkout komit tersebut melainkan fail telah diubah. Klien Telegram dinamakan mengikut perpustakaan, lapisan API dan pusat datanya. Apabila pemerhatian bermula dan apabila eksport sembang bermula dan berakhir, pengumpul meminta masa daripada Telegram (`updates.getState`, saat penuh) dan merekod masa Telegram tolak jam pengumpul, dengan ketidakpastian daripada perjalanan pergi dan balik; laporan menunjukkan ukuran ini di bawah Rantaian Pemilikan. Eksport sembang juga merekodkan bila ia membaca sejarah, selain tarikh mesej-mesej.

### Pemapar laporan luar talian dan panduan arkib

Ekstrak keseluruhan fail ZIP sebelum membuka `chat.html` atau `report.html`. Pemapar menyediakan carian, penapis, peserta, penunjuk, butiran rekod dan pilihan JSON/CSV tanpa pelayan. Simpan `viewer/` dan `media/` di sebelah laporan. Pilihan adalah turunan: gunakan `verify.py SELECTION.json
--evidence ARCHIVE.zip` untuk membandingkannya dengan arkib yang ditandatangani. Pemverifikasi memeriksa ID laporan, kunci penandatanganan, sempadan arkib dan setiap item yang dipilih; item yang disunting, hilang dan berganda akan gagal. Nota pemilihan dan masa penciptaan kekal sebagai metadata tanpa tandatangan.

Jurang nombor mesej hanya dipaparkan untuk aliran sembang menaik yang lengkap dan tidak disaring. Menyembunyikan kategori atau kegagalan memuatkan ketulan data tidak boleh menjadikan baris yang diabaikan sebagai bukti mesej yang hilang. Sorotan carian dijalankan pada teks biasa sebelum pelarian HTML, mengekalkan penandaan literal.

Pelayar memeriksa tandatangan manifest, ID dan kunci laporan, serta semua has ratus fail yang disenaraikan. Ia menolak struktur ZIP yang samar atau cacat, nama berganda dan laluan tidak selamat, serta mengehadkan saiz fail kepada 256 MiB dan jumlah keseluruhan kandungan kepada 4 GiB. Gunakan pengesah berdiri sendiri untuk arkib yang lebih besar. Semakan pelayar ini melengkapi semakan pengesah terhadap rantaian jurnal dan semantik data.

`README.txt` mengandungi panduan permulaan, inventori fail yang diselaraskan, arahan pengesahan dan nota format data dalam bahasa laporan, diikuti dengan panduan lengkap Bahasa Inggeris. `SHA256SUMS` merangkumi fail-fail yang disenaraikan di dalamnya, kecuali dirinya sendiri, `manifest.json` dan `manifest.sig`; manif tersurat juga merangkumi `SHA256SUMS`. Kekalkan ZIP asal tanpa diubah dan simpan fail kerja di luar folder yang diekstrak. Laporan PDF termasuk penanda buku seksyen dan pengecaman kes/laporan pada halaman kemudian.

### Perbualan pada masa eksport

Eksport sembang merekodkan apa yang dikatakan oleh Telegram tentang sembang apabila eksport bermula: label Telegram sendiri (`scam`, `fake`, `restricted` dengan sebabnya, `verified`), nama pengguna, keterangan, bilangan ahli dan pentadbir, perbincangan yang dipautkan, perlindungan kandungan, sama ada ahli baru melihat mesej terdahulu dan dari mesej mana dalam akaun ini melihat sejarah (`available_min_id`), tarikh mesej 1 apabila ia adalah penciptaan sembang, dan SHA-256 gambar sembang (disimpan dalam `media/`). Ia merekodkan kedudukan akaun yang mengeksport dalam sembang: peranan, tarikh sertai, siapa yang menjemputnya dan, untuk pentadbir, haknya. Sebarang permintaan yang ditolak oleh Telegram dinamakan sebaliknya.

Apabila akaun yang mengeksport adalah pentadbir, eksport akan membaca log pentadbir sembang (Telegram menyimpan selama kira-kira 48 jam) ke dalam `admin-log.json`: pemadaman dan suntingan dengan kandungan yang dibekalkan, akaun yang bertindak dan tarikh tindakan sumber. Kemasukan ini melengkapi versi yang dirakam dalam jurnal langsung dan rekod penerimaan pemadaman.

### Petunjuk

Laporan menyenaraikan, dan arkib menyimpan sebagai `indicators.csv` , `indicators.stix.json` (STIX 2.1 ) dan `indicators.misp.json` (peristiwa MISP ), apa yang boleh diambil tindakan oleh meja penyalahgunaan dalam mesej yang dirakam: pautan dan domain (juga disembunyikan di sebalik teks, dalam butang dan dalam pratonton pautan), alamat mata wang kripto, nama pengguna Telegram dan pautan jemputan, nombor telefon, alamat e-mel dan gambar yang disimpan. Alamat Bitcoin, Litecoin, Dogecoin dan TRON disenaraikan hanya apabila checksum base58 mereka sah, alamat segwit apabila checksum bech32 atau bech32m mereka sah dan alamat TON apabila CRC mereka sah; alamat EVM dan Solana ditandakan sebagai tidak disemak. Gambar mempunyai hash persepsi SHA-256 (dHash, 64 bit) yang kekal hampir tidak berubah pada salinan yang dimampatkan semula atau diubah saiznya. Laporan menulis penunjuk supaya ia tidak terbuka secara tidak sengaja (`hxxps[://]example[.]com` ); fail mengekalkan nilai seperti sediakala. Setiap penunjuk ditandakan sebagai tidak diketahui dan bukan untuk pengesanan automatik (STIX `indicator_types: unknown` , MISP `to_ids: false` , pengedaran kepada organisasi sendiri): disenaraikan menunjukkan bahawa mesej itu mengandungkannya, bukan bahawa ia berniat jahat. Pautan yang teksnya menunjukkan alamat berbeza daripada yang dibuka akan ditandakan dalam laporan.

Laporan PDF diakhiri dengan deklarasi pemeriksa untuk ditandatangani dengan tangan, senarai semak untuk notari atau pakar mahkamah, dan kod QR (juga pada halaman pertama) dengan ID laporan, cap jari kunci dan SHA-256 data berkuasa, supaya cetakan boleh menjejak kembali ke arkibnya.

## Kanonalisasi acara

Input hash terdiri daripada tepatnya medan-medan ini:

```
seq, observed_at, source_at, kind, chat_id, message_id, actor_id, payload, previous_hash
```

Memerialisasikan menggunakan JSON serasi Python dengan UTF-8, kunci objek disusun, tiada pelarian ASCII, tiada ruang kosong tidak penting, dan tiada NaN/infiniti:

```
json.dumps(value, ensure_ascii=False, sort_keys=True,
           separators=(",", ":"), allow_nan=False).encode("utf-8")
```

SHA-256 bagi bait-bait tersebut menjadi hash peristiwa. Tandatangan adalah Ed25519 ke atas 32 bait hash mentah, kemudian disulitkan dalam base64. previous_hash pertama ialah 64 sifar. Nombor urutan bermula pada 1 dan bertambah 1. Semua peristiwa, termasuk peristiwa operasi, berkongsi satu rantaian. Tiada penindasan penghantaran dwi: pemerhatian berulang adalah resit berasingan, bukan tuntutan tindakan Telegram berasingan.

Tarikh Telegram mentah adalah rentetan ISO; medan binari menjadi objek yang mengandungi bytes_base64. Teks mesej, entiti, penderia media, metadata balasan, reaksi, dan tindakan perkhidmatan dikekalkan dalam metadata mesej mentah apabila dibekalkan. Mesej langsung juga mengekalkan kemas kini Telegram yang menghantarnya dalam `transport_update`; apabila kemas kini itu membawa mesej yang sama seperti `raw`, `message` bidang adalah `{"same_as": "raw"}` daripada salinan kedua.

`observed_at` adalah masa UTC pengumpul ketika menulis rekod; `source_at` adalah tarikh yang dibekalkan oleh acara Telegram tersebut. Rekod yang ditulis semasa memproses kemas kini secara langsung menambah `payload.received_at`, masa UTC di mana kemas kini tiba di pengumpul, dan `payload.processing_delay_ms`. Suntingan secara langsung mengekalkan tarikh suntingan yang diberikan, potret sejarah mengekalkan tarikh mesej dengan masa pemerhatian semasa, dan pemberitahuan pemadaman biasa merekodkan masa penerimaan dengan tarikh sumber sifar. Kemasukan log pentadbir mengekalkan tarikh tindakan yang diberikan secara berasingan. Susunan penerimaan dan susunan peristiwa sumber adalah garis masa berasingan, dengan pemerhatian jam dan resit luaran tersedia untuk perbandingan.

## Semantik pelaku

Penetapan atribut mengikut sumber peristiwa. `message.new.actor_id` dan `message.edited.payload.sender_id` mengekalkan penghantar mesej. Notifikasi biasa `message.deleted` mengandungi ID mesej dan mempunyai medan pelaku null; entri log pentadbir yang tersedia mengandungi tindakan, pelaku dan tarikh yang disertakan. Mesej perkhidmatan keahlian mengekalkan penghantar dan jenis tindakan, kemas kini peserta mentah mengekalkan `actor_id` yang disertakan, dan snapshot reaksi mengekalkan kiraan dan identiti yang dapat dilihat yang disertakan. Baca rekod-rekod ini bersama versi yang dirakam dan [resit interaksi panel](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#own-actions).

Notifikasi pemadaman untuk sembang peribadi dan kumpulan biasa hanya mengandungi ID mesej. Sembang-sembang tersebut berkongsi satu urutan ID untuk seluruh akaun, jadi satu ID mengenal pasti satu mesej daripada akaun ini. Apabila mesej dengan ID itu disimpan lebih awal dalam jurnal ini, pemadaman itu direkodkan dalam sembang tersebut sebagai message.deleted dengan payload.chat_resolution yang menamakan kaedah. ID yang tidak pernah disimpan disimpan sebagai `deletion.unscoped`: satu notifikasi pemadaman sebenar yang sembangnya belum dikaitkan. Ini berbeza dengan `message.missing_on_recheck`, yang merekodkan hasil pertanyaan yang tidak tersedia, dan daripada jurang dalam ID mesej yang disimpan. Saluran dan superkumpulan menyusun nombor mesej bagi setiap sembang dan tidak pernah dipadankan dengan cara ini. Apabila mesej yang dipadam dihantar oleh akaun yang diperhatikan, payload.deleted_message_was_outgoing adalah benar; penghapus masih tidak disertakan.

Notis tanpa skop mengekalkan labelnya sendiri kerana sembang yang sepadan mungkin berada di luar skop pemerhatian semasa atau tiada padanan unik. Semakan semula ketiadaan kekal sebagai pemerhatian berasingan daripada pemberitahuan pemadaman dalam kiraan laporan, penapis dan label. Pemulihan kemudian membersihkan keadaan hilang semasa sambil mengekalkan semakan yang tidak berjaya sebelum ini dalam sejarah yang disahkan; pemberitahuan pemadaman kekal sebagai jenis peristiwa berasingan.

ID berbilang yang diselesaikan kepada chat yang sama daripada satu pemberitahuan digolongkan sebagai `deletion.batch`, tanpa mengira bilangannya, dengan ID mesej tepat seperti yang dihantar oleh Telegram dan berapa banyak daripadanya yang telah dihantar oleh akaun ini. Senarai pemberitahuan Telegram menyenaraikan mesej-mesej tersebut; log pentadbir chat menamakan pentadbir bertindak di mana akaun boleh membacanya. Pautan (`message.deletion_attributed`) dibuat mengikut yang tiba dahulu: sebuah tinjauan yang mencatat kemasukan log pentadbir sebelum notis pemadaman dipadankan apabila notis itu direkodkan.

## Liputan: kesinambungan, jurang dan ID yang tidak diperhatikan

Setiap fail ZIP yang disahkan mengandungi `coverage.json`; laporan HTML dibuka dengan ringkasan yang sama, dan `verify.py` mengira semula ia daripada `events.jsonl` dan bukannya mempercayai fail tersebut:

- **Diperhatikan secara berterusan dari X hingga Y.** Satu tempoh bermula dengan `observation.started` dan berakhir pada jeda, pemberhentian, kehilangan sambungan Telegram, log keluar, permulaan proses tanpa pemberhentian yang teratur, atau lebih daripada tiga minit tanpa sebarang rekod semasa memerhati (denyutan jantung direkodkan setiap minit, jadi kesunyian bermakna proses telah berhenti, beku atau komputer berehat). Apabila selang degupan jantung diubah dalam **Alat tambahan → Parameter**, setiap degupan jantung merekodkannya dan ketenangan yang dibenarkan menjadi tiga selang, tidak pernah kurang daripada tiga minit.
- **Kekosongan** menyenaraikan masa antara tempoh beserta sebab. Kekosongan yang masih terbuka pada rekod terakhir ditandakan sebagai`not_resumed_by_last_record`.
- **ID mesej yang tidak diperhatikan.** Bagi saluran dan superkumpulan, yang menyenaraikan bilangan mesej bagi setiap sembang, ID yang hilang di antara mesej yang diperhatikan disenaraikan sebagai julat. Mereka dilaporkan sebagai tidak*diperhatikan* — dipadam, tidak pernah dihantar, atau di luar sejarah yang disimpan — tetapi tidak pernah dilaporkan sebagai dipadam. Sembang peribadi dan kumpulan biasa berkongsi urutan di seluruh akaun, jadi jurang dalam salah satu sembang tersebut tidak bermakna apa-apa dan tidak disenaraikan di situ.
- Notis jurang pada peringkat sembang (contohnya Telegram meminta pemulihan perbezaan dalam satu saluran) dikira sebagai nota; ia tidak mengganggu liputan global.
- **Rekod sesi.** Tingkap di mana pengira kemas kini Telegram meningkat sedangkan tiada kemas kini sampai ke sesi ini (`updates_diverted`), sesi ini dikeluarkan daripada senarai sesi Telegram sementara hubungannya terus berfungsi (`session_revoked_externally`), atau jawapan siasatan saksi hanya tiba daripada sejarah (`probe_ack_missed_live`) disenaraikan secara berasingan. Pemverifikasi juga melaporkan dari mana kunci sesi Telegram berasal, sesi lain yang ditandatangani semasa pemerhatian bermula, sesi yang ditambah semasa pemerhatian, notis keselamatan Telegram (777000), sesi lain yang berakhir dari ruang kerja, tempoh sesi tunggal, kiraan siasatan saksi dan kemas kini panggilan telefon. Lihat [akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/accounts/#witness-probe). Semasa [pilihan sembang terhad](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#strict-chosen-chats) diaktifkan (`scope.strict` dalam `observation.started`), senarai sesi (kecuali apabila ini adalah satu-satunya sesi, atau apabila **peranti Telegram** diaktifkan), notis keselamatan dan kemas kini panggilan telefon tidak dikumpul, jadi ketiadaan mereka tidak bermakna apa-apa, dan pemadaman dipadankan dengan sesi semak hanya jika satu dijalankan dalam 10 minit sebelumnya.

### Kemas kini urutan (`pts`)

Telegram menjejak kemas kini berkaitan mesej dengan `pts`: satu urutan untuk akaun (perbualan peribadi dan kumpulan asas bersama) dan satu untuk setiap saluran atau superkumpulan. Pengumpul merekodkan setiap rentangan yang diterimanya tanpa lubang sebagai `coverage.sequence` rekod: yang pertama dan terakhir `pts`, bilangan kemas kini setiap jenis, dan sama ada ia disiarkan secara langsung atau dikembalikan oleh `getDifference` atau `getChannelDifference`. Satu rehat adalah `coverage.gap` menamakan rekod, dan `coverage.gap_closed` menamakan `pts` daripada mana urutan itu menjadi lengkap semula.

Satu rentetan tanpa putus menunjukkan bahawa setiap kemas kini Telegram bernombor dalam urutan itu antara yang pertama dan terakhir `pts` telah sampai ke klien Telegram pengumpul ini. Ia tidak mengatakan apa-apa tentang kandungan yang tidak pernah dihantar oleh Telegram ke akaun ini, tentang masa sebelum yang pertama dicatatkan `pts`, atau tentang rentetan yang tidak dicatat oleh pengumpul. A `pts` menerangkan bahawa tiada rentetan yang direkodkan atau perbezaan yang diliputi dipaparkan sebagai gangguan.

`GET /api/continuity` jawapan untuk selang (`since`, `until`, `chat_id`) sama ada setiap urutan tidak terputus dan menyenaraikan putusnya beserta sebabnya. `verify.py` mencetak yang sama daripada rekod arkib di bawah **kesinambungan urutan**.

### Nombor mesej yang hilang (`gap_summary`)

For a reader's guide to this section and to observation periods and gaps, see [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md).

**Pratinjau.** `coverage.json` → `gap_summary` mengukur nombor yang diberikan oleh Telegram dan yang tidak pernah dilihat oleh pengumpul ini. Telegram menombor mesej sekali bagi setiap saluran atau superkumpulan, dan sekali bagi setiap akaun merentasi sembang peribadi, bot dan kumpulan biasa. Nombor antara dua mesej yang diperhatikan sama ada diperhatikan atau hilang; julat bersebelahan adalah kenyataan positif bahawa setiap mesej yang bernombor di dalamnya telah diperhatikan. Kelompongan tidak menyatakan sebarang pelaku atau sebab.

| Medan | Maksud |
| --- | --- |
| `status` | `on` atau `off` apabila dimatikan di **Lebih banyak alat → Parameter → Analisis jurang** |
| `parameters` | Parameter yang menghasilkan keputusan, supaya ia boleh diulang |
| `chats[]` | Satu entri bagi setiap saluran atau superkumpulan, masing-masing bernombor sendiri |
| `account` | Susunan merentas akaun bagi sembang peribadi, bot dan kumpulan biasa |
| `status` (per urutan) | `applicable`, atau `not_applicable` dengan `reason` |
| `observed_from`, `observed_to`, `span` | Nombor pertama dan terakhir yang diperhatikan dan saiz julat |
| `observed`, `observed_without_content` | Nombor yang diperhatikan; nombor yang hanya diketahui melalui rekod pemadaman atau semakan semula |
| `missing`, `density`, `gap_ranges`, `largest_gap` | Nombor yang tidak pernah diperhatikan, bahagian mereka dalam julat, berapa banyak larian, larian terpanjang |
| `clusters[]` | Jurang yang disenaraikan: `low`, `high`, `missing`, dan nombor jiran yang diperhatikan `after` / `before` dengan masa pemerhatian mereka |
| `service_estimate` | Hanya apabila diaktifkan: berapa banyak nombor yang hilang akan menjadi mesej perkhidmatan pada bahagian yang diperhatikan. Tidak pernah ditolak daripada `missing` |

Kesahihan diperoleh daripada jurnal, tidak pernah diandaikan:

- **Saluran dan superkumpulan** diukur bagi setiap sembang, juga dalam eksport sembang terpilih. Rekod yang dipilih oleh penghantar membentuk ukuran `not_applicable`.
- **Susunan peringkat akaun** diukur hanya dari mesej pertama hingga mesej terakhir yang telah diterima semasa pengumpulan seluruh akaun diaktifkan dan merangkumi sembang peribadi, bot, kumpulan biasa serta mesej akaun itu sendiri, tanpa sebarang sembang dikecualikan (`scope.changed`). Nombor yang dinamakan oleh `deletion.unscoped` dikira sebagai diperhatikan tanpa kandungan. Eksport atau penyerahan sembang terpilih tidak dapat mengukurnya. Jika pengumpulan seluruh akaun dipadamkan dan dihidupkan semula, satu nota menyatakan bahawa nombor yang digunakan dalam tempoh tersebut akan muncul sebagai jurang.
- Mesej perkhidmatan adalah rekod jurnal dengan nombor mereka sendiri, jadi ia menutup jurangnya sendiri; anggaran pilihan hanyalah konteks.

`verify.py` mengira semula `gap_summary` daripada `events.jsonl` dengan parameter dalam jurnal yang ditandatangani `coverage.json` ahli (tetapan lalai untuk arkib lama) dan mencetak baris merentas akaun dalam ringkasan liputannya. Arkib tersebut `get_capture_status`(MCP dan baris perintah) mengembalikan ukuran yang sama untuk sembang yang boleh dibaca oleh capaian; urutan merentas akaun hanya untuk capaian yang merangkumi keseluruhan ruang kerja.

Pengamatan berulang bagi satu mesej perkhidmatan dikira sekali, dan anggaran perkhidmatan akaun hanya menggunakan nombor dalam julat yang diukur. Skop terpakai mesti mengekalkan mesej akaun itu sendiri secara eksplisit sebelum pengukuran seluruh akaun diaktifkan; pengukuran bermula daripada rekod yang membawa maklumat tersebut. Julat yang diukur merangkumi pengamatan semasa, dan pemulihannya dicatatkan. Permintaan arkib langsung mempunyai bajet masa, termasuk imbasan pangkalan datanya, dan menandakan pengukuran yang belum selesai sebagai separa.

Telegram mendokumentasikan [urutan ID mesej yang berasingan](https://core.telegram.org/api/updates#message-id-sequences). Nombor-nombor ini menerangkan pemerhatian; notis pemadaman, semakan semula dan log pentadbir merekodkan mengapa sesuatu nombor tiada di mana Telegram melaporkannya.

Apabila Telegram berhenti menerima akaun, rekod `coverage.gap` yang menamatkan pemerhatian membawa `cause` (`account_banned`, `account_frozen`, `account_deleted`, `session_duplicated`, `session_revoked`, `session_expired`, `session_ended` atau `not_authorized`) dan ralat Telegram; `verify.py` menamakan punca di mana tempoh itu berakhir.

Liputan menggabungkan tempoh pemerhatian yang direkodkan, gangguan dan hasil mesej. Nilai ia bersama sembang terpilih, tempoh dan dasar lampiran; semak semula hasil dan jurang yang direkodkan menunjukkan sejauh mana kemas kini akaun itu diperhatikan sepenuhnya.

## Pengeluar

Manifester berasingan bagi ZIP bukti, eksport sembang, jurnal saksi dan kenyataan fail profil-orang mengandungi `producer`: perisian, versi, projek (PhishDestroy), laman utama dan repositori sumber. Laporan HTML dan pengesah memaparkan rekod pengeluar berasingan ini. Hash fail sumber mengenal pasti pokok sumber yang dirakam untuk dibandingkan dengan semakan keluar yang dipercayai. Asal usul pelaksanaan disemak secara berasingan melalui [pengesahan pemerolehan GitHub](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) atau [pengukuran Intel TDX](https://phishdestroy.io/tgwitness/ms/docs/reference/high-assurance/), apabila diaktifkan. Arkib yang dibuat sebelum medan pengeluar wujud terus disokong dan dikenal pasti sebagai rekod warisan.

Setiap rekod `observation.started` juga menamakan klien Telegram yang memerhati: `api_id` nya (bukan hash), sama ada ia pasangan awam terbina dalam atau aplikasi pengendali sendiri, deskripsi klien yang dihantar dalam permintaan sambungan Telegram, dan jenis laluan sambungan dengan mod IP (tiada alamat proksi atau rahsia). Laporan dan `custody.json` menyenaraikan setiap klien dan laluan berbeza beserta masa ia direkodkan, dan masa di mana tiada proksi yang disenaraikan memberi respons dan Telegram melihat alamat pelayan. Jurnal yang direkodkan sebelum ini menyatakan demikian.

## Profil orang

Fail profil (`tgwitness-dossier-v1`, JSON) dibina atas permintaan daripada rekod yang sudah ada dalam jurnal untuk satu sembang; tiada apa-apa dimuat daripada Telegram dan kandungan profil tidak pernah ditulis ke dalam jurnal (pengaktifan dan pematikan profil direkodkan sebagai `dossier.changed`). Untuk setiap individu yang mempunyai mesej yang disimpan, ia menyenaraikan nama dan sejarah nama pengguna, penanda aras Telegram (bot, penipuan, palsu, premium, disahkan, terhad, dipadam) seperti yang dilihat semasa penyimpanan, profil ID foto, SHA-256 dan hash persepsi (pHash, serasi dengan `imagehash.phash`) avatar daripada cache avatar tempatan dengan avatar serupa, aktiviti (mesej pertama dan terakhir, bilangan, perkongsian yang disunting dan dipadam, mesej mengikut jam UTC), siapa yang membalas kepada siapa, sembang lain dalam jurnal ini di mana orang tersebut menulis, dan menyebut dompet (BTC, EVM, TRON, TON, LTC, DOGE, XMR, SOL; alamat Base58Check disahkan checksum), nombor telefon, nama pengguna dan pautan, termasuk pautan yang disembunyikan di sebalik teks.

Setiap fakta menyenaraikan rekod jurnal (`seq`) yang menjadi sumbernya, dan `record_hashes` menyimpan hash bagi setiap rekod yang dirujuk. Pernyataan itu ditandatangani dengan kunci ruang kerja:

```
python verify.py tgwitness-dossier-CHAT.json --fingerprint TRUSTED_SHA256 --evidence tgwitness-evidence.zip
```

memeriksa tandatangan, mengesahkan eksport bukti itu sendiri (tandatangan, rantaian hash dan fail) dan bahawa setiap rekod yang dirujuk wujud tanpa diubah dalam eksport yang sama daripada ruang kerja tersebut. Hash avatar dilabel sebagai berasal daripada cache tempatan (bukan rekod jurnal). Sebutan ialah padanan corak dan petunjuk untuk disemak. Profil diaktifkan bagi setiap sembang, boleh dieksport sebagai fail ZIP AES-256 dengan kata laluan, dan dihapuskan apabila dilumpuhkan atau apabila sembang dikeluarkan daripada sumber.

## Saksi bebas

Jurnal saksi (`tgwitness-witness-v1`) dan kiriman saluran nya disemak menentang eksport bukti dengan `verify.py --witness … --channel …`; lihat [saksi bebas](https://phishdestroy.io/tgwitness/ms/docs/reference/witness/). Dengan alamat awam `https://t.me/s/…` atau `https://telegram.me/s/…`, pengesah membaca tarikh setiap kiriman daripada Telegram, dan tarikh terawal kiriman sedemikian di bahagian atas eksport adalah masa luaran untuk rekod terakhir. Tarikh daripada mana-mana sumber lain adalah metadata yang dibekalkan.

## Manifest dan checkpoint

manifest.json merangkumi format, masa eksport, kunci awam, cap jari, panjang jurnal, hash kepala, skop, pengeluar, had, dan SHA-256 setiap ahli kandungan selain `manifest.json` dan `manifest.sig` itu sendiri. manifest.sig ialah tandatangan Ed25519 base64 ke atas JSON manifest kanonik. Pemverifikasi menolak ahli yang tidak dijangka/hilang, nama duplikat, fail rosak, urutan/rantaian terputus, tandatangan tidak sah, dan ketidakpadanan dengan titik pemeriksaan yang disediakan. Ia tidak pernah mengekstrak laluan arkib. Ia mengehadkan saiz tidak dimampatkan yang diisytiharkan sepenuhnya kepada 4; `--max-gib N` membenarkan arkib yang lebih besar dibuat dengan had **Parameter → Alat Lain** yang dinaikkan.

Satu arkib besar diperiksa oleh beberapa proses sekaligus: ahli di-hash secara selari, dan selepas 5,000 rekod pertama, hash kandungan dan tandatangan setiap rekod diperiksa oleh proses pekerja manakala proses utama mengikuti rantaian, liputan dan pengikatan mengikut turutan. `--jobs N` menetapkan bilangan proses; lalai `auto` menggunakan satu bagi setiap CPU, maksimum 16, dan `--jobs 1` menjaga semuanya dalam satu proses. Jawapannya sama tidak kira cara mana, dan sebarang perubahan ditolak dengan mesej yang sama. Hah di posisi yang dinamakan oleh checkpoint yang disimpan dan sauh cop masa dikekalkan sepanjang satu pusingan itu, jadi setiap sauh dibandingkan tanpa membaca jurnal semula. Pada komputer 32-benang, arkib bersaiz 10.8 GB dengan 400,000 rekod mengambil masa 58.9 saat dalam satu proses, 15.2 saat dengan 4 dan 8.4 saat dengan 16; satu pusingan ke atas rekod mengikut susunan kemudian menetapkan had.

Jalankan pengesahan daripada versi TgWitness yang dipasang atau keluaran semakan. Salinan yang disertakan dalam arkib menyokong penggunaan mudah alih; semak salinan itu dengan pemasangan anda yang dipercayai sebelum menjalankannya.

Satu checkpoint menandatangani satu kenyataan yang mengandungi kunci awam, panjang jurnal, hash kepala, dan masa penciptaan. Ia juga membawa pusingan drand terbaru yang diperoleh oleh ruang kerja (`drand_anchor` ): pengumpul meminta relai drand melalui laluan luar ruang kerja sebelum setiap checkpoint berkala, jadi Hide IP, proksi dan laluan luar yang dimatikan terpakai, dan penciptaan checkpoint itu sendiri tidak pernah membuat sambungan keluar. Pemverifikasi boleh memeriksa bahawa arkib kemudian mengandungi pendahuluan yang sama. Dengan `--checkpoint` dan `--check-drand` ia mengesahkan pusingan itu dengan relai drand dan melaporkan bahawa checkpoint itu ditandatangani tidak lebih awal daripada masa pusingan; pusingan itu tidak menukar peringkat jaminan. Simpan checkpoint di luar pengumpul, supaya pengesahan kemudian membandingkan arkib dengan rujukan yang disimpan secara berasingan daripadanya. Kunci pengumpul menandatangani arkib tersebut, maka ia mengikat rekod-rekod kepadanya hanya jika penerima memperolehinya sebelum arkib itu, melalui saluran lain; dengan sendirinya ia tidak memenuhi minimum untuk bukti.

## Membaca keputusan pengesahan

Pemverifikator melaporkan integriti arkib, pengekangan penandatangan dan pemeriksaan jaminan secara berasingan. Tandatangan yang sah menunjukkan bahawa bait tidak berubah sejak ia ditandatangani. Pengendali memberikan cap jari kunci kepada penerima melalui saluran berasingan. Tanpa `--fingerprint`, arkib yang utuh lulus pemeriksaan tandatangan dan format dengan `signer_pinned: false`, dan baris terakhir bermula dengan `EVIDENCE: minimum not met · missing: confirmed signer key`.

Untuk dasar arkib tempatan automatik yang memerlukan penandatangan terpaku dan minimum untuk bukti:

```
python -m tgwitness.verify evidence.zip --strict --json --fingerprint TRUSTED_KEY_SHA256 --tsa-ca TSA-ROOT.pem --require evidence
```

Gunakan cap jari yang disimpan melalui saluran dipercayai penerima. Saksi dipercayai juga boleh menetapkan pengeksplor melalui jurnal yang disaksikan secara konsisten; sediakan `--witness`, `--witness-fingerprint` dan `--require-witness`. `--strict` akan keluar dengan status 2 untuk penandatangan yang belum ditetapkan; `--require-tier` atau `--require evidence` yang tidak dipenuhi juga akan keluar dengan status 2. `--require evidence` memerlukan `--fingerprint` dan masa luaran daripada pihak ketiga yang merangkumi rekod terakhir. Baca `signer_pinned`, `requirements_met` dan keputusan jaminan, bukan hanya kod keluar. [Perolehan disegel](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md#sealed-evidence) sebaliknya menggunakan pengesah pengesahan dan dasar yang diluluskan untuk mengesahkan mampatan perolehan.

## Skop pengesahan

Pengesahan memeriksa arkib dan mod pengumpulan yang digunakan untuk menjana ia. Pilih mod yang sempadan kepercayaannya sepadan dengan kes, kemudian simpan input pengesahannya.

| Mod pengumpulan | Apa yang diperiksa oleh pengesah | Input pengesahan dan sempadan kepercayaan |
| --- | --- | --- |
| Ruang kerja tempatan | Rekod tandatangan, rantaian hash, manifes dan bait lampiran | Cap jari pengumpul yang disimpan oleh penerima dan masa luaran daripada pihak ketiga: resit RFC 3161 yang disahkan atau OpenTimestamps, atau kiriman saksi yang dibaca dari t.me. Titik pemeriksaan yang disimpan dan rekod saksi adalah pemeriksaan sokongan |
| Ruang kerja tempatan dengan saksi bebas | Arkib memeriksa dan memadankan dengan awalan jurnal terdahulu yang disimpan oleh saksi | Cap jari dan rekod saksi; rekod kawalan kunci penjaga menunjukkan siapa yang memegang kunci saksi. Dengan `--channel https://t.me/s/…`, tarikh yang ditetapkan Telegram pada siaran memberikan masa luaran |
| [Tangkapan GitHub Actions](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md) | Pengesahan GitHub bagi digest arkib, aliran kerja yang diluluskan dan komit pengumpul, pelaksana hos, asal sesi/kunci baharu dan integriti arkib dalaman | Dasar pengesah dipercayai, repositori penelefon dan bundel pengesahan GitHub; pengumpulan dijalankan di bawah aliran kerja yang dipin |
| [Penyebaran awan](https://phishdestroy.io/tgwitness/ms/docs/reference/high-assurance/) | Kitar hayat penyedia dan rekod akses, status firewall dan Cloudflare, serta rekod larian berasingan pengumpul yang disahkan | Permintaan baca sahaja kepada penyedia dan Cloudflare; ketersediaan pemeriksaan individu bergantung pada penyedia |
| [VM sulit Intel TDX](https://phishdestroy.io/tgwitness/ms/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx) | Petik tandatangan dan status platform, pengikatan kepada pernyataan pengumpul, susun dan pengukuran OS | Rantaian kepercayaan Intel dan ukuran penyebaran yang dijangka; kekalkan keputusan setiap pemeriksaan TDX yang diperlukan |

Dalam pemerolehan bermeterai, pengumpul yang diluluskan menerima data melalui sambungan Telegram yang disahkan dalam persekitaran yang disahkan. Pengesahan mengikat arkib kepada pelaksanaan tersebut, jadi pengesahan merangkumi pemerolehan serta integriti fail kemudian. Ini bergantung pada kod yang diluluskan dan rantaian kepercayaan platform yang disenaraikan di atas. Pengesahan tangkapan GitHub memerlukan sesi yang dibuat dalam pelaksanaan dan menolak tangkapan sesi yang diimport.

Resit pelaksanaan merekodkan versi pengumpul, hash fail dan tetapan permulaan. Provenans GitHub dan pengukuran TDX menyediakan semakan persekitaran; [rekod pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/verification/) mengenal pasti konfigurasi yang diuji.

### Daripada mana mesej-mesej itu berasal

Telegram menghantar mesej kepada setiap klien, termasuk aplikasi rasmi, dalam sesi MTProto. Kunci kebenaran sesi itu dirundingkan dengan kunci pelayan tetap Telegram, dan setiap kemas kini tiba disulitkan dan diperiksa integritinya di bawah kunci tersebut. Pengumpul menerima mesej melalui sesi berotentikasi akaun dan menandatangani setiap pemerhatian ke dalam jurnal sebaik ia tiba, dengan pengecam sembang, mesej dan penghantar serta tarikh yang ditetapkan oleh Telegram pada setiap mesej. Di GitHub Tindakan merakam dan penyebaran Intel TDX, pengesahan juga mengikat sesi dan kunci penandatanganan tersebut kepada pelaksanaan pengumpul yang diluluskan.

Jurnal merekodkan dari mana kunci kebenaran berasal. Log masuk dengan telefon atau QR, atau log masuk bebas daripada fail sesi, menulis `account.authorized` dengan `key_origin: "created"`; pengumpulan pada kunci `.session` yang diimport, TData atau JSON menulis `imported`. Kunci yang diimport juga wujud di mana ia berasal. Penyebaran yang disahkan menolak kunci yang diimport.

Asal usul rekod Telegram bergantung pada sambungan berotentikasi akaun, rekod sambungan dan tangkapan dalam jurnal, bingkai MTProto yang dirakam yang dipadankan dengan entri jurnal ([`tgwitness/forensics/`](https://github.com/phishdestroy/TgWitness/tree/main/tgwitness/forensics)), tarikh Telegram setiap mesej dan, untuk tangkapan disahkan, persekitaran pelaksanaan yang disahkan. Tandatangan arkib mengekalkan rekod tersebut untuk semakan kemudian. Titik pemeriksaan yang disimpan menetapkan sempadan jurnal terdahulu, rekod liputan menunjukkan hasil pengumpulan, dan cap masa luaran yang disahkan meletakkan bait yang disimpan pada masanya.

Untuk ruang kerja tempatan, penerima menyediakan input pengumpul atau saksi yang dipercayai. Untuk pemerolehan disegel, dasar yang dipercayai dan pengesahan mengikat ringkasan arkib kepada pelaksanaan pengumpul yang diluluskan. Ini adalah laluan pengesahan yang berbeza; laporkan semakan yang telah diselesaikan untuk laluan yang dipilih.

## Lampiran

Fail dialamatkan oleh SHA-256 di bawah media/. Acara media.saved memautkan hash dan panjang bait kepada peristiwa mesej tertentu. Nama fail mentah adalah metadata, bukan laluan tempatan. Bait media dimuat turun secara asinkron, jadi pemadaman segera mungkin menghalang perekodan. Pengumpulan dilumpuhkan, fail bersaiz besar/saiz tidak diketahui, kegagalan muat turun, dan muat turun yang terganggu akan dipaparkan sebagai hasil. Kegagalan proses boleh meninggalkan fail separa yang tidak dirujuk; ia tidak disertakan dalam eksport.

Pengeksport ZIP mengesahkan media yang disimpan mengikut nama mereka. Eksport JSONL, CSV, dan HTML mengesahkan tandatangan peristiwa tetapi tidak mengandungi bait media. Laporan turunan disediakan untuk kemudahan; events.jsonl adalah representasi peristiwa yang sah.

Eksport sembang penuh menyimpan lampiran dalam tetapan lampiran ruang kerja ke dalam media/, dinamakan oleh SHA-256. Setiap rekod mesej dalam chat.json menamakan failnya (`file`, `file_sha256`) atau sebab ia tiada (`file_status`), bersama apa yang dilihat pembaca di sekeliling teks: pautan di belakang teks, asal penghantaran, butang bot, tandatangan, jumlah tontonan dan pemasa padam automatik. `verify.py` memeriksa bahawa setiap fail yang dinamakan terdapat dalam manifes berasingan di bawah hash tersebut.

## Koleksi tahan lama dan resit proses (0.2)

Satu job media dan acara pesannya disimpan dalam satu transaksi. Tugas ini menyimpan deskriptor mesej TL asal; pemerhatian yang disahkan mengikat SHA-256, akaun, dan dasar saiznya. Pemulihan mengesahkan ikatan tersebut sebelum memuat turun. Ia tidak pernah mengambil mesej semasa dan secara senyap menggantikan lampiran yang lebih baru. Tugas yang terhenti akan dicuba semula, manakala kegagalan kekal kekal sebagai hasil yang nyata.

Setiap ruang kerja mempunyai jurnal dan identiti tandatangan tersendiri. Peristiwa process.started merangkumi ID larian, jam tempatan, versi kebergantungan, has ratah sumber, akaun/skop awal, dan tetapan rakaman. Denyutan jantung merangkumi ID larian, masa monotonik, dan status barisan. Risit pelaksanaan juga boleh dimuat turun sebagai kenyataan yang ditandatangani secara berasingan. Untuk pengesahan persekitaran pelaksanaan, padankan ia dengan pengesahan GitHub atau semakan TDX yang diterangkan dalam [Skop Pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#verification-scope).

Simpanan semak automatik disimpan secara tempatan semasa permulaan, setiap lima minit semasa memerhati (**Alat lain → Parameter → Simpanan semak yang ditandatangani setiap**), dan semasa hentian teratur. Pengesahan permulaan dan eksport membandingkan jurnal dengan simpanan semak tempatan terkini yang disimpan. Ini boleh mengesan pengunduran pangkalan data apabila simpanan semak itu masih wujud. Penyimpanan bebas memastikan rujukan itu tersedia di luar ruang kerja; cap masa luaran yang disahkan juga menjadikannya berlabuh pada masa.

Selepas memulakan semula, kedudukan kemas kini Telegram yang disimpan akan disambung semula (`catch_up_from` dalam `observation.started`) dan kemas kini yang terlepas akan diminta. Kedudukan yang disimpan hanya merangkumi kemas kini yang pengendaliannya telah selesai, jadi kemas kini yang masih menunggu apabila sambungan ditutup atau proses dihentikan akan diminta semula. Semakan semula berkala merekod `message.recovered` untuk mesej yang terlepas dan `message.missing_on_recheck` apabila Telegram tidak lagi memulangkan mesej yang disimpan; yang terakhir ini bukan notis pemadaman dan tidak menyatakan nama pemadam atau masa.

### Salinan dan pemulihan luar tapak (S3)

Salinan luar tapak (**Tetapan → Pemberitahuan dan salinan luar tapak → Salinan luar tapak**, atau **Alat lanjut → Ekstra → Bukti & sandaran**; diaktifkan secara lalai) memuat naik segmen jurnal, fail terpelihara, titik pemeriksaan dengan cop masa mereka dan eksport sembang yang selesai ke storan serasi S3, disulitkan dengan AES-256-GCM sebelum dimuat naik di bawah kunci yang disimpan dalam peti besi ruang kerja; Penahanan Kunci Objek terpakai apabila baldi menyokongnya. Tanpa kunci yang dimuat turun, salinan tersebut tidak dapat dibaca. Pulihkan dan sahkan dengan `python -m tgwitness.replica restore --key-file KEY.json --out DIR`.

Pemulihan memerlukan direktori biasa yang kosong. Fail yang dimuat turun dan objek yang telah disahsulit kekal dalam storan sementara peribadi sehingga keseluruhan jurnal dan setiap penanda aras yang disimpan disahkan. Laluan objek yang tidak selamat, julat segmen yang tidak konsisten dan jurnal yang lebih pendek daripada satu penanda aras akan ditolak; pengesahan yang gagal tidak menerbitkan sebarang fail yang dipulihkan. Semakan pengekalan membandingkan mod dan tarikh Kunci Objek yang dikembalikan dengan tarikh akhir yang dihantar semasa pemunggahan (toleransi pemutaran satu saat). Tarikh akhir yang telah tamat tempoh, tidak sah atau dipendekkan tidak dikira sebagai disahkan. Status melaporkan objek sampel yang pengekalanannya dibaca balik untuk pas pemunggahan tersebut.

Media tempatan yang hilang atau rosak dilaporkan sebagai ralat pada pusingan tersebut dan mengekalkan penunjuk media di hadapannya, supaya fail itu dicuba semula pada pusingan seterusnya; fail, titik pemeriksaan dan eksport selepasnya masih disalin. Pemulihan menyemak semua rujukan media yang dipelihara menentang hashes yang telah didekripsi dan saiz yang direkodkan. Segmen jurnal yang bertindih dan identik daripada muat naik yang terhenti akan dipadankan; tumpang tindih yang bercanggah ditolak. Titik pemeriksaan yang dibuat semasa muat naik ditangguhkan sehingga rekod jurnal yang diliputinya disalin, jadi satu pusingan yang selesai tidak menerbitkan titik pemeriksaan di hadapan jurnalnya.

### Snapshot eksport penstriman

Eksport penstriman menggunakan snapshot baca SQLite yang stabil. Snapshot ini mungkin lebih lama daripada jurnal langsung semasa apabila muat turun selesai. Titik pemeriksaan yang dibuat selepas snapshot tersebut boleh melaporkan dengan betul bahawa arkib itu lebih pendek; bandingkan dengan titik pemeriksaan pada atau sebelum awalan yang dieksport, bukan titik pemeriksaan sewenang-wenang yang kemudian.

## Persiapan RFC 3161 dan pengesahan respons (0.2)

Mod bukti menghantar hanya SHA-256 setiap titik pemeriksaan yang ditandatangani kepada pihak berkuasa RFC 3161 yang disenaraikan dan kalendar OpenTimestamps, melalui laluan ruang kerja dan tidak pernah melalui MTProxy. Cap masa diaktifkan secara lalai dalam setiap matlamat penyediaan; **Bukti untuk sesuatu kes** juga merekod drand. Jawapan disimpan dalam `checkpoints/anchors/`, dieksport sebagai `.tsr` dan `.ots` fail di bawah `anchors/`, dan disemak oleh `verify.py` (`--tsa-ca` menyemak tandatangan TSA; mengesahkan bukti OpenTimestamps dengan `ots upgrade` dan `ots verify`).

Satu pihak berkuasa RFC 3161 yang gagal dua kali berturut-turut akan menunggu sebelum cubaan seterusnya: satu selang, kemudian dua, empat dan seterusnya sehingga enam jam, atau selama mana `Retry-After` nya meminta, sehingga sehari. Satu pusingan yang hanya menemui pihak berkuasa yang menunggu tidak menulis sebarang rekod; sebaliknya `anchor.completed` menyenaraikan mereka di bawah `deferred` dengan `retry_at`. Sehingga mereka menjawab semula, panel memaparkan cap masa sebagai **Terjejas**.

Panel menyediakan arkib permintaan yang mengandungi bait checkpoint.json kanonik, cap mesej SHA-256 dan nonse rawak dalam timestamp.tsq, checksum, dan arahan. Tiada permintaan rangkaian dibuat; token yang dikembalikan oleh pihak berkuasa untuk permintaan ini ialah timestamp.

`python -m tgwitness.anchor verify` menyemak respons berbanding bait titik semak dan permintaan asal tanpa OpenSSL. Fail CA yang dipercayai mesti dinyatakan secara jelas; sijil yang disertakan tidak dipercayai secara automatik. Semakan permintaan adalah pilihan dalam CLI, jadi simpan permintaan dan berikan --request untuk menyemak nonce. Keputusan menyatakan sama ada ia disemak. Tandatangan titik semak pengumpul dan jurnal masih perlu disahkan secara berasingan dengan cap jari pengumpul yang dipercayai.

Pengesahan memeriksa tandatangan respons, bait titik pemeriksaan dan, apabila dibekalkan, permintaan asal di bawah kepercayaan CA yang dinyatakan. Untuk cop masa yang diperoleh dalam mod bukti, `verify.py` juga memeriksa bukti OCSP atau CRL yang disimpan ([pembatalan sijil tandatangan](https://phishdestroy.io/tgwitness/ms/docs/reference/timestamp/#signing-certificate-revocation)). Lihat [prosedur](https://phishdestroy.io/tgwitness/ms/docs/reference/timestamp/) dan [keputusan pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/verification/).

## Rekod pilihan dalam mod bukti: peranti drand dan Telegram

Dua rekod lagi boleh dijalankan pada pas yang sama seperti cap masa. Kedua-duanya hanya berkuat kuasa semasa mod bukti diaktifkan. **Bukti untuk satu kes** akan mematikan drand; sebaliknya kedua-duanya akan bermula. Tukar tetapan di bawah Alat tambahan → Ekstra → Bukti & sandaran → **Saksi tambahan · pilihan**, atau `"drand": true` dan `"devices": true` dalam `POST /api/evidence`. Satu kegagalan tidak menghentikan yang lain atau cap masa; panel menunjukkan keputusan terkini bagi setiap satu di bawah borang.

**drand** (`beacon.drand` ). Setiap pusingan menulis pusingan terkini drand quicknet, kebolehubahan rawak awam Liga Entropi (sepusingan setiap 3 saat), ke dalam jurnal: `chain` , `round` , `randomness` , `signature` , `round_time` dan `relay` yang menjawab. Pusingan yang disahkan dan tidak dapat diramalkan menyediakan rujukan masa bawah untuk bahan pautan-hash seterusnya. Cap masa yang disahkan pada titik pemeriksaan kemudian menyediakan rujukan masa atas. Semakan ini mengehadkan bahan yang dipautkan. Pengumpul bertanya kepada `drand.cloudflare.com` terlebih dahulu, kemudian kepada relai Protocol Labs, melalui laluan ruang kerja, satu permintaan setiap pusingan.

`verify.py` memeriksa bahawa setiap kebetulan adalah SHA-256 tandatanganannya dan bahawa masa pusingan adalah tepat, dan melaporkan pusingan-pusingan, rentetan terpanjang tanpa satu dan sejauh mana jam kolektor ketinggalan di belakang drand. `--check-drand` membandingkan pusingan dengan relai Cloudflare dan relai Protocol Labs, kesemuanya atau sampel rawak seratus dalam jurnal panjang; pusingan yang berbeza akan gagal pengesahan.

**Peranti Telegram** (`account.devices`). Setiap pusingan membaca sesi akaun dengan `account.getAuthorizations`, senarai yang dipaparkan oleh Telegram dalam Tetapan → Peranti, dan merekamnya: secara penuh apabila ia berubah sejak pusingan sebelumnya, dengan `added` dan `removed` hash sesi, jika tidak hanya kiraannya dan SHA-256. Model peranti, platform, aplikasi dan versi, penciptaan dan aktiviti terakhir, negara dan rantau disimpan; alamat IP tidak, kerana pembuangan bukti keluar dari tangan anda. Sesi pengumpul sendiri sentiasa aktif, jadi hanya aktiviti sesi lain dikira sebagai perubahan. `verify.py` melaporkan berapa kerap senarai itu direkodkan dan setiap sesi baharu dan yang berakhir. Ia membaca senarai hanya semasa pemerhatian dijalankan.

Apa yang ditunjukkan: drand menyusun rekod mengikut masa awam, dan senarai peranti adalah kenyataan Telegram melalui pengumpul, ditandatangani oleh pengumpul seperti setiap rekod lain.

Log Gateway **Cloudflare** (`cloudflare.gateway_dns`). Untuk pelayan yang menyelesaikan melalui Cloudflare Gateway ([Gateway DNS](https://phishdestroy.io/tgwitness/ms/docs/reference/high-assurance/#cloudflare-as-an-outside-witness)), setiap salinan menyalin apa yang direkodkan oleh Gateway sejak salinan sebelumnya: satu rekod bagi setiap tingkap maksimum tiga jam dengan `from`, `until`, `location_id`, `address` pelayan apabila ditetapkan, dan `queries` sebagai `[at, name, type, rcode, decision, colo]`, juga apabila tiada. Aturkannya di bawah log Gateway Cloudflare ****: akaun, lokasi, alamat pilihan dan token baca sahaja (Akaun Analitik Dibaca; PII Amanah Sifar Dibaca untuk menyimpan satu alamat lokasi kongsi). Panel memeriksa mereka dengan satu permintaan sebelum menyimpan; token kekal disulitkan dan tidak pernah dimasukkan ke dalam jurnal. `verify.py` menyenaraikan tetingkap, nama yang paling kerap dicari dan sebarang masa tiada salinan merangkumi; rekod yang bilangannya tidak sepadan dengan cariannya akan gagal. Sebuah tetingkap yang memuat lebih daripada satu halaman pertanyaan dalam satu saat akan menyimpan halaman tersebut dan menyatakan baki pertanyaan yang hilang. Salinan itu ialah jawapan Cloudflare melalui pengumpul, yang ditandatangani oleh pengumpul; dalam masa 24 jam, sesiapa sahaja yang mempunyai token baca sahaja boleh membandingkannya dengan Cloudflare.
