# Telegram · Bagaimana pengumpulan berfungsi

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

Skop pemerhatian, kemas kini langsung, semakan semula, lampiran, tindakan sendiri dan maksud jurang, rekod demi rekod.

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

Skop pemerhatian, kemas kini langsung, semakan semula, lampiran, tindakan sendiri dan maksud jurang, rekod demi rekod.

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [Dokumentasi](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [Koleksi](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md)

![Koleksi](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69)

TgWitness merekodkan apa yang diperhatikan oleh akaun Telegram yang disambungkan. Pemantauan langsung mengekalkan mesej, suntingan yang dirakam, pemberitahuan pemadaman dan lampiran dengan masa pemerhatian dan konteks sumber mereka. Sejarah bacaan, semakan semula dan rekod log pentadbir yang tersedia menambah pemerhatian yang dikenal pasti secara berasingan kepada rekod tersebut.

**Pada halaman ini**

- [Dari log masuk ke jurnal](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#from-login-to-a-journal)
- [Skop pemerhatian: sembang terpilih, satu folder atau keseluruhan akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account)
- [Skop dan pemilihan acara](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#scope-and-event-selection)
- [Tindakan sendiri](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#own-actions)
- [Mod siasatan: menyertai pasukan dan bercakap dengan bot](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots)
- [Semak semula peringkat](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#recheck-tiers)
- [Sejarah mesej dan atribusi](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#message-history-and-attribution)
- [Sisipan sejarah](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#history-snapshots)
- [Pengendalian lampiran](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#attachment-handling)
- [Pause, kunci, putuskan sambungan, dan mulakan semula](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#pause-lock-disconnect-and-restart)
- [Pengasingan dan pengesahan akaun](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#account-isolation-and-verification)

## Dari log masuk ke jurnal

Untuk foto dan fail yang musnah sendiri, lihat [Media yang musnah sendiri](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md). Ia menerangkan pekerja keutamaan, hasil yang disimpan dan yang tidak tersedia, serta had penapisan resit dibaca dalam pengumpul API.

Diyagram aliran · Memberi kebenaran kepada akaun pengguna → Pilih kumpulan dan saluran yang boleh diakses; Pilih kumpulan dan saluran yang boleh diakses → Simpan tetapan acara dan lampiran; Simpan tetapan acara dan lampiran → Mulakan pemerhatian; Mulakan pemerhatian → Terima kemas kini daripada klien aktif; Terima kemas kini daripada klien aktif → Terapkan dasar sumber dan peristiwa; Terapkan dasar sumber dan peristiwa → Lampirkan pemerhatian yang disahkan; Lampirkan pemerhatian yang disahkan → Semak atau eksport jurnal; Lampirkan pemerhatian yang disahkan → Proses sebarang lampiran yang beratur; Proses sebarang lampiran yang beratur → Lampirkan hasil muat turun · Memberi kebenarankepada akaun pengguna · Pilih kumpulan dansaluran yang bolehdiakses · Simpan tetapan acaradan lampiran · Mulakan pemerhatian · Terima kemas kinidaripada klien aktif · Terapkan dasar sumberdan peristiwa · Lampirkan pemerhatianyang disahkan · Semak atau eksportjurnal · Proses sebaranglampiran yang beratur · Lampirkan hasil muatturun

**Diagram sebagai teks**

1. Memberi kebenaran kepada akaun pengguna → Pilih kumpulan dan saluran yang boleh diakses
2. Pilih kumpulan dan saluran yang boleh diakses → Simpan tetapan acara dan lampiran
3. Simpan tetapan acara dan lampiran → Mulakan pemerhatian
4. Mulakan pemerhatian → Terima kemas kini daripada klien aktif
5. Terima kemas kini daripada klien aktif → Terapkan dasar sumber dan peristiwa
6. Terapkan dasar sumber dan peristiwa → Lampirkan pemerhatian yang disahkan
7. Lampirkan pemerhatian yang disahkan → Semak atau eksport jurnal
8. Lampirkan pemerhatian yang disahkan → Proses sebarang lampiran yang beratur
9. Proses sebarang lampiran yang beratur → Lampirkan hasil muat turun

Kebenaran, akses kepada sumber, pengumpul yang sedang berjalan, dan penghantaran lengkap adalah persoalan yang berbeza. Log masuk yang berjaya tidak memberi akses kepada setiap kumpulan. Penghantaran dijejaki secara berasingan: rekod liputan, pemulihan jurang kemas kini dan semakan semula menunjukkan apa yang telah sampai.

## Skop pemerhatian: sembang terpilih, satu folder atau keseluruhan akaun

**Lebih banyak alat → Sumber → Skop** menentukan sembang mana yang direkodkan oleh ruang kerja.

Penyediaan baharu bermula dengan **Pilih sembang**. Pilihan yang telah disimpan sebelum ini dikekalkan. Memilih **Semua sembang** dalam wizard penyediaan akan meminta pengesahan apabila senarai yang dimuat mengandungi lebih daripada 50 sembang; anggaran saiz kekal sebagai operasi berasingan yang berasaskan sampel.

| Mod | Merekod | Sembang baharu |
| --- | --- | --- |
| Perbualan terpilih (laluan lalai) | Hanya sembang yang anda tambah secara manual | Tidak pernah ditambah secara automatik |
| folder Telegram | Perbualan dalam salah satu folder akaun: perbualan yang disertakan mengikut nama, ditambah kategori folder (kenalan, bukan kenalan, kumpulan, saluran, bot), tolak perbualan yang dikecualikan dan, jika folder menyatakannya, perbualan yang diarkibkan | Perbualan yang sepadan ditambah sebaik sahaja ia menjadi aktif; perbualan yang anda tambahkan ke dalam folder di Telegram akan dikesan dalam masa sejam |
| Keseluruhan akaun | Setiap sembang yang dilihat oleh akaun | Setiap sembang baru, kumpulan, sembang peribadi atau bot ditambah sebaik sahaja kemas kini pertamanya tiba |

- **Jenis sumber** (saluran, kumpulan, sembang peribadi, bot) mengehadkan folder dan mod akaun keseluruhan. Sembang terpilih boleh menjadi apa jua jenis, termasuk sembang peribadi dan bot; jenis sumber tidak pernah menghentikan sembang yang anda tambah secara manual. Menyahaktifkan jenis, pengecualian atau beralih kepada sembang terpilih akan menghentikan sumber yang ditambah secara automatik sebaik sahaja ia disimpan, sebelum senarai sumber dikira semula dan juga apabila Telegram tidak dapat dihubungi: mesej baru mereka, sejarah lalu, sejarah sembang baru, tetapan rakan sebaya dan pemerhatian profil.
- **Perbualan yang anda tambah secara manual** kekal direkod dalam mod folder dan mod akaun keseluruhan walaupun apabila ia berada di luar folder; hanya *Pengecualian*, *Penghapusan* atau jeda yang dapat menghentikannya. Perbualan yang ditambah secara *automatik* mengikut skop folder: mana-mana yang keluar daripadanya akan dijeda pada pengiraan semula seterusnya.
- **Perbualan yang dikecualikan** tidak pernah direkodkan, dalam apa jua mod. Dalam mod folder dan keseluruhan akaun, *Menolak* dan *Mengalihkan* pada sumber meletakkannya dalam senarai ini, supaya skop tidak menambahnya semula. Memilih semula sembang secara manual (dalam Sumber, daripada Sembang atau di bawah Tetapan → **Sembang mana?**) akan mengeluarkan sembang itu daripada senarai. Senarai boleh memuat sehingga 5,000 sembang; melebihi had itu, *Remove* akan ditolak dan sembang tersebut boleh ditangguhkan sebaliknya.
- **Tindakan sendiri** (diaktifkan secara lalai): mesej yang dihantar oleh akaun ini, suntingannya dan tekanan butang papan kekunci balasan. Apabila dimatikan, mesej keluar dan suntingan akan diabaikan.
- Beralih ke folder atau keseluruhan akaun memerlukan pengesahan: mod-mod ini merekodkan sembang peribadi dan mesej pihak ketiga dan hanya sesuai untuk akaun khusus. Pengesahan dan setiap perubahan skop ditandatangani dan direkodkan sebagai rekod `scope.changed`. Pada akaun yang ditetapkan sebagai akaun utama anda, borang skop dan Penyiasatan menolak folder atau keseluruhan akaun, seperti yang dilakukan oleh start; hanya salinan sekali sahaja tanpa rakaman boleh menggunakannya.
- Sembang yang ditambah oleh skop muncul sebagai sumber yang ditandakan *auto*, direkodkan sebagai `scope.applied` (pada permulaan dan setiap jam) atau `source.discovered` (sembang baru semasa memerhati). Apabila beralih kembali ke sembang yang dipilih, semua sumber yang ditambah secara automatik akan dihentikan serta-merta, tanpa membaca semula senarai sembang akaun. Sembang yang dikecualikan berhenti direkod sebaik sahaja skop disimpan, dan sumbernya digantung walaupun Telegram tidak mengembalikan senarai sembang. Semasa memerhati, menyimpan skop akan menerapkannya semula, juga apabila nilai tidak berubah.

Skop mod-mod ini:

- **Bualan Rahsia** menggunakan [integrasi pseudo-rahsia](https://phishdestroy.io/tgwitness/ms/docs/reference/secret-chats/) yang disertakan, dengan modul protokol yang dipasang dari panel dan suis pengaktifan bagi setiap akaun. Sejarah Awan dan Takeout menggunakan laluan pemerolehan berasingan.
- **Tempoh luar talian.** Selepas dihidupkan semula, TgWitness meneruskan kedudukan kemas kini yang disimpan, meminta kemas kini yang terlepas daripada Telegram dan menyemak semula sembang. Telegram mengekalkan senarai tunggu yang terhad, jadi selepas masa henti yang panjang, laporan dan `verify.py` menyenaraikan selang masa yang tinggal sebagai jurang (lihat [liputan](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)).
- Hanya 1,000 dialog pertama disenaraikan pada permulaan (hadnya berada di bawah **Alat lain → Parameter**); sembang yang lebih lama akan ditambah apabila ia menjadi aktif semula. Sejarah awal sembang yang ditambah tidak dimuat — ambil tangkapan sejarah atau eksport sembang penuh apabila anda memerlukannya.
- Kondisi folder yang berubah-ubah (dibisukan, dibaca) tidak diterapkan: sembang seperti ini tetap dipantau.
- **Butang bot inline (callback)** yang ditekan dalam aplikasi lain tidak kelihatan kepada sesi kedua; balasan atau suntingan bot direkodkan. Tekanan kekunci papan kekunci balasan tiba sebagai mesej keluar dan dilabelkan `button_press`.
- Lebih banyak sembang bermakna lebih banyak permintaan. Telegram mengehadkan akaun untuk jumlah yang dianggap berlebihan, yang merupakan satu lagi sebab untuk menggunakan akaun khusus.

### Sembang terpilih yang ketat

**Ketat: hanya sembang yang dipilih** akan dipaparkan di bawah **Sembang Pilihan** dan ia dimatikan secara lalai. Ia bertujuan untuk kebenaran yang hanya merangkumi sembang yang dipilih. Apabila ia diaktifkan:

- Notifikasi perkhidmatan Telegram (777000) tidak dibaca: tidak semasa pemerhatian bermula atau berhenti dan tidak setiap minit semasa memerhati. Tiada rekod `session.security_baseline` atau `account.security_event` ditulis.
- The account's session list is not read: not when observation starts or stops (the panel's question about other sessions for **Evidence for a case** and the evidence protection modes is skipped too), not every two minutes while observing, not when a connection opens, and not by the connection check, whose *Current authorization* entry is shown as skipped. The two-step verification status used by the takeover check is not read either. So `account.sessions`, `session.concurrent_at_start` and `session.takeover_risk` are not written, and a session ended from another device is not reported as `session_revoked_externally`.
- Walaupun ini adalah satu-satunya sesi akaun (**Jadikan ini satu-satunya sesi** atau versi automatiknya), senarai sesi masih dibaca setiap dua minit semasa memantau dan apabila sambungan dibuka, supaya `session.exclusive_ended` direkodkan apabila sesi lain muncul. 777000 kekal tidak dibaca dalam tempoh itu, walaupun rekod `session.exclusive_from` menyatakan pemberitahuan log masuk Telegram terus direkodkan.
- Notis pemadaman hanya dibandingkan dengan pemeriksaan sesi jika satu dijalankan dalam 10 minit terakhir (sambil ini adalah sesi tunggal, atau selepas membuka **Sesi akaun ini**). Jika tidak, melainkan pemeriksaan hak terakhir menunjukkan bahawa akaun ini tidak dapat memadam mesej itu (tidak pernah berlaku dalam sembang peribadi dan kumpulan biasa), ia akan berbunyi: *Tidak diketahui siapa yang memadamnya: akaun ini sendiri, daripada sesi atau peranti lain, juga mungkin telah memadamnya.*
- Dengan kunci sesi yang diimport, tiada apa-apa dalam jurnal yang menunjukkan masa sesi ini log masuk sehingga senarai sesi dibaca (contohnya dalam **Sesi akaun ini**). Sehingga ketika itu, eksport sembang dan eksport akaun **automatik** menggunakan sesi biasa dan bukannya Takeout, dengan sebab `session_age_unknown`.
- Menghidupkan sembang tidak membacanya mesej-mesej awalnya. Tanpa suis, setiap sembang yang dihidupkan (dalam Sumber, dalam Perbualan, sama ada disertai dari panel atau dalam wizard persediaan) akan mendapat satu snapshot `baseline` bagi mesej terbarunya, sehingga **More tools → Parameters → Largest history snapshot** (500 secara lalai), apabila pengawasan seterusnya dijalankan. Satu snapshot yang sedang menunggu yang tiba sementara suis dihidupkan akan diabaikan. Sembang yang disertai dari panel tidak akan dibaca mesej terbarunya sebagai sembang baru (kiraan **Apabila sembang atau bot baru muncul**, 100 secara lalai), dan membuka sembang terpilih yang tiada mesej disimpan dalam Sembang tidak akan memuatkan 100 mesej terbarunya secara automatik. **Memuat sejarah** dan snapshot yang anda mulakan sendiri masih membaca sejarah.
- Tetapan kandungan sensitif akaun tidak dibaca mahupun diubah. Tanpa suis itu, log masuk dan setiap sambungan baharu mengaktifkannya apabila ia dimatikan dan Telegram membenarkan perubahan tersebut (`account.content_settings`); tetapan ini milik akaun dan terpakai dalam setiap aplikasi Telegram. Kandungan yang ditandakan sebagai sensitif oleh Telegram mungkin kekal tersembunyi.
- Kemas kini panggilan telefon tidak direkod sebagai `account.phone_call`.
- Menhentikan penulisan pemerhatian hanya menulis cap jejak kunci sesi; ia tidak membaca senarai sesi atau 777000.

It does not narrow what Telegram sends: updates of every chat still reach this session, and only the chosen chats are recorded. The account's chat list (up to **Chats read from the account's list**) and its folders are still read at start, and again when the scope is saved while observing, to find the chosen chats. Deletion notices without a chat (`deletion.unscoped`) are still recorded: they carry message IDs only and may belong to a chosen private chat or ordinary group. The frozen-account check (`help.getAppConfig`), the other connection checks, and features you turn on yourself (ending other sessions automatically, the witness probe, pseudo-secret chats, **Sessions of this account**, and Telegram's list of signed-in devices under **More witnesses**, which reads the session list at each timestamp pass and which setup ticks for the **Follow chats** and **Evidence for a case** goals) keep working.

Aktifkannya sebelum log masuk; jika tidak, proses log masuk itu sendiri akan memeriksa kebenaran semasa dan mengaktifkan kandungan sensitif. Setiap perubahan direkodkan sebagai rekod `scope.changed` yang ditandatangani, dan `observation.started` membawa nilai sebagai `scope.strict`. Beralih ke folder atau ke seluruh akaun akan menamatkannya.

## Skop dan pemilihan acara

Setiap ruang kerja mempunyai sumbernya sendiri. TgWitness tidak menyertai kumpulan, menerima jemputan, atau menyenaraikan setiap ahli secara automatik. Sumber mesti sudah boleh diakses oleh akaun. Semasa permulaan, pengumpul menyemak sumber terpilih menentang dialog yang boleh dilihat oleh akaun; 1,000 dialog pertama diperiksa melainkan **Lebih banyak alat → Parameter → Bualan yang dibaca daripada senarai akaun** menyatakan sebaliknya. Sumber yang tidak hadir akan ditandakan **sebagai akses belum disahkan**, bukan dianggap telah menyingkirkan anda.

| Persetelan | Mengumpul | Kesan apabila dilumpuhkan |
| --- | --- | --- |
| Mesej baru | Mesej biasa yang dihantar | Suntingan/pembuangan kemudian mungkin tidak mempunyai teks yang dirakam sebelum ini untuk dibandingkan. |
| Suntingan | Menyampaikan versi mesej yang telah disunting | Perubahan pertengahan tidak direkonstruksi kemudian. |
| Pembuangan | Notis pemadaman berskop dan notis peringkat akaun tanpa skop | Notis pemadaman tidak dimasukkan ke dalam jurnal. |
| Reaksi | Siaran tangkapan reaksi | Kemas kini reaksi berasingan tidak ditambah. |
| Keahlian | Mesej perkhidmatan keahlian dan kemas kini peserta disampaikan | Perhatian keahlian tersebut tidak ditambah. |

Tetapan terpakai kepada semua sumber yang dipilih dalam ruang kerja. Simpan borang untuk menerapkan perubahan; perubahan direkodkan dengan nilai sebelum/selepas yang disahkan. Mematikan sesuatu kategori tidak akan memadam rekod terdahulu. Mengaktifkannya semula tidak akan mengisi semula kemas kini yang terlepas.

Rekod operasi dan acara perkhidmatan kumpulan lain kekal berasingan daripada suis ini. Mesej perkhidmatan keahlian boleh mencipta rekod mesej apabila keahlian diaktifkan walaupun tangkapan mesej biasa dimatikan. Objek Telegram yang dirakam mengekalkan metadata terbenam; suis bukan peraturan redaksi.

**Pemadaman dalam sembang peribadi dan kumpulan biasa** muncul sebagai ID mesej tanpa sembang. Sembang-sembang ini berkongsi satu urutan ID mesej untuk seluruh akaun, jadi apabila mesej dengan ID itu disimpan lebih awal, sembangnya diketahui: pemadaman itu direkodkan dalam sembang itu dengan `chat_resolution` yang menerangkan bagaimana. ID yang tidak pernah disimpan kekal sebagai **pemadaman tanpa skop** dengan sembang yang tidak diselesaikan secara eksplisit. Ini adalah pemberitahuan pemadaman Telegram, yang dipelihara walaupun sembangnya belum dapat dikaitkan. Skema pemberitahuan mengandungi ID; jurnal menambah masa penerimaan dan sebarang konteks mesej yang disimpan, termasuk `deleted_message_was_outgoing`. Kemasukan log pentadbir yang tersedia menyediakan sumber berasingan bagi tindakan, pelaku dan masa sumber.

## Tindakan sendiri

Mesej yang dihantar oleh akaun yang diperhatikan dilabelkan `outgoing`. Suntingan pada mesej keluar mencatat bahawa dalam sembang peribadi dan kumpulan hanya penulisnya boleh menyuntingnya, manakala pos saluran boleh disunting oleh pentadbir lain. Apabila mesej keluar mengulangi teks butang daripada papan kekunci balasan tersimpan terbaru dalam sembang itu, ia membawa `button_press` dengan pautan ke rekod papan kekunci tersebut.

Pengecualian tindakan sendiri juga terpakai pada semakan semula latar belakang dan sejarah sembang baru secara automatik. Mesej keluar yang dilangkau akan memajukan kedudukan semakan semula supaya ia tidak dapat menyekat mesej masuk kemudian. Tindakan panel yang jelas dan potret sejarah yang diminta secara manual kekal direkodkan.

## Mod siasatan: menyertai pasukan dan bercakap dengan bot

**Lebih banyak alat → Sumber → Skop → Mod siasatan** menyediakan skop untuk akaun khusus yang menyertai sembang pasukan, memulakan bot dan menulis kepadanya: keseluruhan akaun, setiap jenis sumber, tindakan sendiri, dan untuk setiap sembang atau bot yang muncul, profilnya dan 200 mesej visibel terbarunya. Semak borang dan tekan **Simpan skop**; suis ke keseluruhan akaun meminta pengesahan biasa.

- **Butang.** Butang di bawah mesej disimpan bersamanya dan dipaparkan dalam **Perbualan**: pautan, aplikasi web, pautan log masuk, teks untuk disalin, data callback, pertanyaan dalam talian, permintaan nombor telefon atau lokasi. Pautan dipaparkan sebagai teks dan tidak pernah dibuka oleh panel. Apabila bot menukar hanya butang (contohnya pautan pembayaran baru), itu adalah versi baru mesej tersebut, sama ada daripada kemas kini langsung atau semakan semula.
- **Sembang dan bot baru.** Dalam mod folder dan akaun keseluruhan, **apabila sembang atau bot baru muncul**, disimpan, sejurus selepas ia muncul:

  - profilnya sebagai rekod `source.profile`: bot description and commands, teks tentang pengguna, kumpulan atau saluran, ahli, chat yang dipautkan dan pautan jemputan apabila Telegram memulangkan satu;
  - mesej terkini yang kelihatan (sehingga 1,000) sebagai potret sejarah yang ditandakan `new_chat`: mesej-mesej awal dalam sembang pasukan yang baru disertai, atau apa yang dikatakan oleh bot sebelum pemerhatian menyedari sembang itu. Mesej yang telah disimpan secara langsung tidak diulang.

  Sembang yang baru dipilih menggunakan tetapan ini apabila skop diterapkan, termasuk sembang yang sudah ada dalam senarai dialog akaun. Pemuatan awal profil dan sejarah dijalankan untuk sehingga tiga sembang serentak; kerja untuk sembang yang sama kekal mengikut turutan. Setiap peringkat sejarah/profil menggunakan had masa operasi yang dikonfigurasikan, jadi permintaan yang terhenti akan membebaskan pekerjaannya. Sejarah disimpan sebelum bacaan profil pilihan; kegagalan profil tidak menghalang tangkapan sejarah tersebut. Tahap yang gagal akan dicuba semula selepas 5 saat, dengan tempoh berganda sehingga maksimum 5 minit tanpa menggunakan pekerja semasa tempoh kelewatan. ID yang menunggu, tarikh akhir percubaan semula dan tahap yang telah selesai disimpan secara tempatan. Mula semula hanya akan menyambung tahap yang belum selesai; percubaan semula profil tidak akan mengulangi bacaan sejarah yang telah selesai. Sumber yang dilumpuhkan sebelum giliran mereka akan dilangkau. Gambaran keseluruhan memaparkan muat turun sembang aktif, yang menunggu dan yang sedang dicuba semula secara berasingan daripada muat turun lampiran. FloodWait menangguhkan kerja ini dan ia akan disambung semula selepas itu; kegagalan direkodkan dan rakaman langsung sembang diteruskan. Ini termasuk menunggu semasa menyelesaikan identiti sembang baru: tugas profil/sejarah yang tertangguh dikekalkan untuk dicuba semula, dan menunggu yang lebih lama di seluruh akaun yang sedia ada tidak dipendekkan. Para pekerja berkongsi menunggu ini; keserentakan tidak memintas had permintaan Telegram. - **Profil atas permintaan.** **Bualan → Profil → Simpan profil kini** menyimpan profil semasa daripada mana-mana sumber; yang terbaru dipaparkan di atas mesej. - **Snapshot status bualan (pratinjau).** Status di luar aliran mesej berubah tanpa mesej: menanggalkan setiap mesej tidak meninggalkan sebarang jejak pada peringkat mesej, pentadbir kehilangan hak, hadiah disembunyikan, ditukar, dinaik taraf atau dikembalikan. Semasa memerhati, setiap sumber yang diaktifkan dibaca secara berkala dan disimpan sebagai yang disahkan `chat.state` rekod: tajuk, nama pengguna, keterangan, bilangan ahli dan pentadbir, sembang berkait, mod perlahan, ID mesej terpacak (sehingga 100), pentadbir dengan hak dan gelaran mereka, dan hadiah yang dipaparkan pada saluran dan profil pengguna (sehingga 100). Setiap rekod menyenaraikan perbezaan daripada snapshot sebelumnya: medan yang diubah dengan sebelum dan selepas, mesej pin yang ditambah atau dialih keluar, pentadbir dan hadiah yang ditambah, diubah atau tidak lagi disenaraikan. - Sebahagian yang ditolak oleh Telegram (contohnya senarai pentadbir saluran untuk ahli yang bukan pentadbir) dinamakan dalam `errors`; nilai sebelumnya disimpan dan disenaraikan dalam `carried_forward`, tidak pernah dilaporkan sebagai dipadam. - Rekod yang hanya mempunyai perubahan pada kiraan, dan semakan yang tidak menemui sebarang perubahan, merujuk kepada keadaan penuh terakhir dengan `state_seq` dan kumulatif `state_overrides`. Keadaan penuh ditulis sekurang-kurangnya setiap tujuh hari dan setiap kali apa-apa selain kiraan berubah. - `parts_complete` menandakan senarai terhad. Penambahan memerlukan senarai sebelumnya yang lengkap, penghapusan memerlukan senarai semasa yang lengkap, dan nilai kosong yang eksplisit merekod pembersihan. - **Alat lain → Parameter → Status sembang** menetapkan selang (12 jam secara lalai, 0 mematikan snapshot), jeda antara sumber, bahagian mana yang dibaca, dan sama ada pemeriksaan yang tidak menemui sebarang perubahan direkodkan. `FLOOD_WAIT` dan `FLOOD_PREMIUM_WAIT` menhentikan baki permintaan snapshot, mengekalkan sebarang tarikh akhir seluruh akaun yang lebih lama, dan membolehkan sembang yang terganggu layak untuk percubaan lain selepas tempoh menunggu itu. - **Tidak kelihatan.** Butang dalam talian (callback) yang ditekan di aplikasi Telegram lain, pop timbul atau pautan yang dijawab oleh bot untuk tekan sedemikian, dan pautan jemputan yang digunakan di aplikasi lain tidak sampai ke TgWitness. Apa yang dihantar atau disunting oleh bot selepas itu akan direkodkan.

### Tindakan daripada panel

**Perbualan** kini merangkumi klien mini yang menggunakan akaun Telegram ruang kerja yang dipilih:

- Tulis mesej teks biasa atau pilih **Balas** di bawah mesej yang disimpan. Mesej keluar yang dihantar akan direkodkan walaupun skop mengecualikan kemas kini keluar.
- Tekan**butang** di bawah callback semasa atau butang teks. Pelayan memuat semula mesej itu dan menolak tindakan jika papan kekunci berbeza daripada versi yang disimpan. Resit callback mengekalkan teks pop timbul Telegram, bendera amaran dan URL; jawapan juga dipaparkan di bawah perbualan. URL kekal sebagai teks yang boleh dipilih dan tidak dibuka secara automatik.
- Tekan **+** → **Buka pautan Telegram**, masukkan `@username`, pautan `https://t.me/name` awam, `https://t.me/+invite` / `joinchat/invite`, atau pautan bot dengan `?start=parameter`, dan tekan **Simpan pratonton**. Pautan asal dan pratonton Telegram ditandatangani sebelum menyertai. **Sertai / buka dan perhatikan** kemudian menyertai kumpulan/saluran atau membuka pengguna/bot, menambah sembang sebagai sumber yang diaktifkan, dan menghantar `/start` kepada bot, termasuk parameter permulaannya. Permintaan untuk menyertai yang menunggu kelulusan pentadbir direkodkan sebagai tertangguh, bukan sebagai keahlian.

Dayakan **Mula pemerhatian** untuk merakam balasan yang masuk secara langsung. Tindakan panel berfungsi semasa pemerhatian ditangguhkan; panel kemudian menyimpan respons langsung mereka, dan pemerhatian langsung merakam baki perbualan. Sumber yang baru ditambah menggunakan pengambilan profil/sejarah yang dikonfigurasikan apabila pemerhatian dijalankan. Apabila sesuatu sumber ditangguhkan, aktifkan ia di **Alat lain → Sumber** sebelum menghantar atau menekan butangnya.

`interaction.preview`, `interaction.requested` dan `interaction.result` adalah acara jurnal berasingan biasa yang disertakan dalam eksport bukti. Permintaan mengenal pasti akaun, mesej/butang atau rekod pratonton dan sama ada pemerhatian sedang dijalankan. Resit membezakan antara kejayaan, penolakan, kelulusan menunggu dan keputusan yang tidak diketahui. Permintaan yang terganggu mungkin telah sampai ke Telegram: semak sembang sebelum memulakan tindakan baru. Menggunakan semula ID permintaan akan memulihkan resit yang disimpannya tanpa mengulangi tindakan, termasuk selepas memulakan semula. Panel mengekalkan ID itu selepas respons yang samar untuk tindakan yang sama semasa sesi halaman semasa. Ia juga mengekalkan ID tersebut apabila menyegarkan paparan gagal selepas tindakan yang berjaya: resit kekal kelihatan, dan mengklik sekali lagi akan memulihkannya. Callback dan RPC sertai mempunyai satu percubaan aplikasi; bacaan yang boleh dicuba semula mengekalkan dasar percubaan semula yang dikonfigurasikan. Menukar sembang segera membersihkan draf dan sasaran balasan dan menyekat penghantaran sehingga perbualan baru dimuat.

Mini-klien ini mengendalikan butang teks dan panggilan balik. Butang aplikasi mini membuka **aplikasi mini Terbuka**, yang merekodkan aplikasi dalam pelayar terasing ([Aplikasi Mini](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md)). Log masuk, permintaan telefon dan lokasi, pembayaran, pertanyaan dalam talian dan lampiran masih memerlukan klien Telegram; metadata butang yang disimpan kekal dapat dilihat. Kawalan baharu menggunakan teks Bahasa Inggeris.

## Semak semula peringkat

Semakan semula meminta semula Telegram untuk mesej yang terlepas, suntingan dan mesej yang tidak lagi dipaparkannya. Sumber yang ditandakan dengan bintang adalah sumber **keutamaan**, disemak semula setiap 15minit secara lalai; semua sumber lain setiap 6jam. Perbualan yang dipilih bermula sebagai sumber keutamaan, manakala perbualan yang ditambah melalui folder atau keseluruhan akaun dianggap sebagai perbualan biasa. Sebanyak 30 sumber akan diperiksa semula setiap pusingan dan baki akan menunggu sehingga minit seterusnya; selepas menyambung semula, sumber keutamaan akan diutamakan. Kedua-dua selang masa ditetapkan di bawah **More tools → Sources → Recording → Recheck** (0 mematikan peringkat tersebut) dan direkodkan sebagai `recheck.changed`.

Mesej yang terlepas diambil semula dari tempat sesi sebelumnya berhenti, dengan had maksimum **Alat lain → Parameter → Mesej terlepas yang dipulihkan setiap sembang dan sesi** (1,000 secara lalai). Selepas hentian yang lama, semakan semula oleh itu mengisi keseluruhan jurang, walaupun mesej langsung yang lebih baru daripada jurang telah disimpan terdahulu. Sembang yang masih mengejar ketinggalan akan disemak semula pada minit berikutnya, bukannya menunggu selang lapisan; `recheck.completed` memaparkan `continues_after` sehingga ia selesai.

Perbandingan merangkumi teks mesej, entiti, papan kekunci (termasuk penyingkiran), dan kandungan/identiti lampiran. Mengubah suai hash capaian fail atau rujukan fail sahaja tidak mencipta suntingan, begitu juga apa yang diisi secara automatik oleh Telegram: pratonton pautan yang dimuat, paparan cerita, media berbayar yang dibuka oleh akaun ini, resit invois. Setiap versi yang disimpan dalam Chats memautkan kepada rekod jurnal penuh, termasuk metadata media.

## Sejarah mesej dan atribusi

Andai pengumpul memerhati "Mesyuarat pada pukul 10:00," kemudian melihat "Mesyuarat pada pukul 11:00," dan seterusnya menerima notis pemadaman. Ia menyelitkan tiga pemerhatian berbeza. Teks asal kekal, suntingan adalah versi berasingan, dan notis merekodkan bahawa pemadaman telah diperhatikan.

Jika pengumpulan bermula selepas versi pertama hilang, teks tersebut tidak tersedia. Jika beberapa suntingan berlaku semasa proses tidak dalam talian, hanya versi yang diperhatikan kemudian boleh disimpan. Notis pemadaman tidak dapat memulihkan kandungan yang tidak pernah dirakam.

Rekod ini menggabungkan beberapa sumber:

| Sumber | Maklumat yang dipelihara |
| --- | --- |
| Mesej langsung atau kemas kini suntingan | ID Mesej, metadata penghantar, versi yang dirakam, masa penerimaan dan tarikh mesej/suntingan Telegram yang disediakan. |
| Notifikasi pemadaman secara langsung | ID mesej yang dilaporkan, masa penerimaan, pemberitahuan mentah dan pautan ke kandungan yang disimpan sebelum ini. |
| Log pentadbir tersedia | Tindakan, pelaku, tarikh sumber dan kandungan mesej yang dibekalkan, dibaca oleh akaun dengan hak yang diperlukan. |
| Interaksi panel | Tindakan yang diminta dan hasilnya yang direkodkan di bawah akaun yang dipilih. |
| Semak semula | Tindak balas Telegram semasa berbanding mesej yang disimpan sebelum ini. |

`observed_at` adalah masa rekod ditulis pada jam pengumpul dan meningkat dengan `seq`. Rekod yang ditulis semasa mengendalikan kemas kini langsung juga membawa `received_at`, masa kemas kini tiba di pengumpul, dan `processing_delay_ms`, masa dari penerimaan hingga penulisan; kemas kini yang ditangguhkan sementara permulaan pemerhatian diproses mengikut susunan ketibaan sebelum yang kemudian. `source_at` menjaga tarikh sumber apabila acara tersebut menyediakannya. Pengamatan selisih jam telegram, rekod ketidakterusan jam dan [pemeriksaan masa luaran](https://phishdestroy.io/tgwitness/ms/docs/reference/timestamp/) menyediakan konteks masa yang berkaitan. Medan pemberitahuan mesej biasa menerangkan pemberitahuan tersebut; rekod log pentadbir dan interaksi mengekalkan atribusi mereka sendiri.

## Snapshot sejarah

Satu snapshot meminta mesej terkini yang boleh dilihat daripada sumber yang diaktifkan, sehingga 500 setiap permintaan. Keputusan dilabel sebagai pemerhatian sejarah. Snapshot manual dijalankan serentak dengan pemerhatian. Pemerhatian berulang disimpan sebagai rekod berasingan. Menghidupkan sumber juga mengambil satu snapshot `baseline` daripadanya, melainkan mod ['chats terpilih ketat](https://phishdestroy.io/tgwitness/ms/docs/reference/collection/#strict-chosen-chats)' diaktifkan.

Snapshot akan berhenti jika sumber dilumpuhkan semasa bacaan. Balasan mesti tergolong dalam sembang yang diminta dan mengandungi ID mesej positif yang secara ketat semakin berkurang di bawah sempadan yang diminta. Balasan yang tidak sah akan mengganggu snapshot sebelum mesej itu disimpan; mesej yang telah disimpan akan kekal dalam jurnal yang disahkan dengan rekod gangguan.

Snapshot mematuhi dasar lampiran tetapi kekal berasingan daripada suis acara langsung. Ia tidak membina semula mesej yang telah dipadam atau versi perantaraan yang terlepas. Anda boleh meminta satu semasa berehat; sebarang lampiran yang ia susun menunggu sehingga pemerhatian bermula dan pekerja muat turun berjalan.

Proses **Sejarah** ialah tugas eksklusif berasingan: membaca sumber dipilih dan memuat turun lampiran dalam gilirannya secara berturutan tanpa memulakan pemantauan. Jeda melepaskan akaun; sambung meneruskan proses tersimpan. Untuk penapis tarikh, bahasa dan balasan merentas beberapa akaun terbiar, lihat [Eksport sembang teragih](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md).

## Pengendalian lampiran

Muat turun lampiran diaktifkan secara lalai dan akan terhenti apabila ruang cakera bebas turun di bawah 1 GiB. Pengumpul melaksanakan pemerhatian mesej dan kerja muat turun serentak. Kerja tersebut mengekalkan penderia media asal dan dasar saiz, jadi lampiran yang disunting kemudian tidak akan digantikan secara senyap.

Muat turun dijalankan selepas tangkapan mesej. Satu muat turun yang lengkap mencipta rekod `media.saved` dengan SHA-256 dan kiraan baitnya. Kerja yang dilangkau, gagal, dicuba semula, dan terganggu mempunyai hasil yang berasingan; satu fail dikira sebagai terpelihara apabila rekod `media.saved` wujud. Fail yang lengkap juga mesti sepadan dengan kiraan bait dalam penderia lampiran asal yang diperhatikan. Tindak balas yang pendek atau panjang secara tidak dijangka tidak direkodkan sebagai media terpelihara.

Fail dan entri foldernya dipadamkan ke cakera sebelum`media.saved`ditulis. Apabila proses pengumpul sebelumnya berakhir tanpa pemberhentian yang teratur, permulaan seterusnya akan membaca setiap fail yang direkodkan sebagai disimpan semasa larian tersebut. Sebuah fail yang hilang atau bytesnya berbeza daripada SHA-256 yang direkodkan akan mendapat rekod `media.missing_after_restart`, muat turunnya disenaraikan semula dalam barisan, dan bytes yang berbeza dipindahkan ke `media-damaged/`. Fail yang dipindahkan ke storan luar tapak tidak dibaca.

Dalam satu ruang kerja, kerja-kerja berbaris serentak untuk representasi lampiran yang sama menunggu pemindahan aktif, kemudian menyemak semula bait yang disimpan sebelum digunakan semula. Setiap kerja menyimpan hasil berasingan dan rujukan kepada rekod fail yang disimpan sebelum ini. Membatalkan kerja yang sedang menunggu tidak membatalkan pemindahan aktif; jika pemindahan itu gagal atau dibatalkan, kerja seterusnya boleh mencuba lagi. Lampiran yang berbeza boleh dimuat turun secara serentak.

Jobs dengan akaun yang sama, perwakilan, saiz yang dijangka dan tindakan tangkapan kekal dalam barisan sementara satu job yang sepadan sedang dijalankan. Mereka tidak menduduki slot muat turun, jadi fail lain boleh bermula walaupun barisan bermula dengan banyak salinan satu fail yang perlahan. Menyiapkan percubaan akan membangunkan semula barisan. Lorong keutamaan, kelewatan percubaan semula yang disimpan dan pemilikan sejarah masih terpakai; setiap pemerhatian menerima keputusannya sendiri.

Eksport sembang juga berkongsi pemindahan aktif untuk representasi fail berulang dalam direktori eksport yang sama. Setiap mesej mengekalkan rujukan lampirannya, dan penggunaan semula memerlukan saiz dan semakan SHA-256 baharu. Fail yang berbeza boleh disemak secara selari tanpa mengekalkan kunci pemindahan bersama. Laluan muat turun dan salinan sementara adalah unik untuk setiap operasi; pembatalan menunggu sebarang pembaca fail tempatan aktif sebelum pembersihan. Indeks fail eksport hanya menyusun mengikut urutan akses metadata, bukan pengesanan hash fail atau muat turun.

Bacaan hash pelayan untuk lampiran berbeza juga dijalankan serentak, berkongsi tiga slot permintaan fail klien dengan muat turun bait. Bacaan berulang bagi representasi yang sama hanya menggunakan semula hasil cache yang lengkap. Bacaan fail membebaskan barisan permintaan biasa; tarikh akhir FloodWait yang disimpan akan disemak semula apabila permintaan mendapat slot.

Had ditetapkan **mengikut jenis**: foto, video, GIF dan animasi, mesej video bulat, mesej suara, muzik dan audio, pelekat, dan fail. Setiap jenis boleh dimatikan dan mempunyai had saiz tersendiri dari 1 hingga 2,000 MiB; ruang kerja baharu bermula dengan 20 MiB untuk foto, 100 MiB untuk video, 50 MiB untuk fail, audio dan video bulat, 20 MiB untuk mesej suara dan GIF dan 5 MiB untuk pelekat. Ruang kerja baru mematikan GIF dan pelekat sehingga diaktifkan. Ruang kerja dengan dasar yang disimpan sebelum had setiap jenis mengekalkan semua jenis diaktifkan dan mengekalkan satu had tunggal untuk setiap jenis. *Saiz fail maksimum* menetapkan setiap jenis sekaligus. Jenis yang dilumpuhkan menghasilkan rekod `media.skipped`; fail saiz tidak diketahui atau terlalu besar tidak akan dimuat turun. Fail besar mendapat masa muat turun tambahan berdasarkan saiznya dan kelajuan asas 256 KiB/s. Tugas akan kekal selepas permulaan semula, tetapi rujukan yang tamat tempoh, kehilangan capaian, atau fail yang dipadam masih boleh menghalang pemulihan. Tugas yang menunggu mengekalkan had yang disimpan bersamanya, jadi had yang dinaikkan hanya terpakai pada fail baharu. Menutup satu jenis atau menurunkan hadnya juga akan melangkau fail menunggu yang dikecualikannya, masing-masing dengan rekod `media.skipped`; menutup muat turun akan menangguhkan barisan sehingga ia dihidupkan semula.

## Pause, kunci, putuskan sambungan, dan mulakan semula

| Tindakan atau keadaan | Kesan |
| --- | --- |
| Tukar ruang kerja | Menukar paparan panel; pengumpul lain mengekalkan keadaan mereka. |
| Kunci panel atau tutup tab | Membiarkan pelayan dan pemantauan terus berjalan. |
| Jeda pemerhatian | Menghentikan pengumpul tersebut dan memelihara kerja lampiran yang sedang menunggu. |
| Lumpuhkan sumber | Menghentikan tangkapan skop masa depan; kerja media yang beratur untuknya menunggu sementara ia dilumpuhkan. |
| Hapus sumber | Melupakannya sebagai sumber dan memadam profil orangnya; rekod yang telah disimpan kekal dalam jurnal hanya-tambah. Lampirannya yang masih menunggu direkod sebagai gagal (`source_removed`). Dalam mod folder dan akaun keseluruhan, ia juga dikecualikan. |
| Ubah laluan sambungan | Memerlukan jeda, menutup klien lama, dan membatalkan log masuk yang belum selesai. |
| Hentikan proses Python | Menhentikan semua ruang kerja; tiada pemerhatian dibuat semasa ia tidak dalam talian. |
| Mulakan semula selepas pemerhatian aktif | Cubaan untuk menyambung semula skop yang disimpan menggunakan sesi yang disimpan. Paus manual membatalkan niat tersebut. |

Pengumpul merekodkan pemutusan sambungan yang dikesan, percubaan semula, ralat, permulaan/pemberhentian, dan degupan jantung. Gangguan pendek boleh terlepas oleh pemeriksaan sambungan berkala. Selepas mula semula, kemas kini yang terlepas akan diminta daripada kedudukan kemas kini yang disimpan dan sembang yang diperhatikan akan disemak semula secara berkala; lihat [format bukti](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#durable-collection-and-process-receipts-02). Snekap menambah keadaan semasa sebagai konteks, dan jurangnya kekal direkodkan.

## Pengasingan dan pengesahan akaun

Setiap ruang kerja mempunyai jurnal, kebenaran, kunci penandatangan, dasar, dan barisan tunggu tersendiri. Hanya klien aktifnya boleh menyumbang pemerhatian secara langsung. Klien yang ditolak, menunggu, digantikan, dan ujian sambungan tidak dapat menulis kemas kini langsung ke dalam jurnalnya. Akaun yang berbeza boleh memerhati kumpulan yang sama, tetapi jurnal mereka kekal berasingan.

Setiap peristiwa merangkumi hash sebelumnya dan tandatangan Ed25519. Eksport merangkumi keseluruhan jurnal ruang kerja melalui nombor urutan tetap. Penapis panel tidak menapis eksport; pengumpulan mungkin diteruskan melebihi sempadannya semasa ia sedang disediakan.

**Semak jurnal** memeriksa rantaian peristiwa dan tandatangan melalui sempadan yang dipaparkan. Keputusannya dipadamkan apabila ruang kerja berubah, dan panel mengenal pasti rekod baharu yang ditambah selepas pemeriksaan. Eksport ZIP juga mengesahkan media yang dikumpul.

Pelihara cap jari dan titik pemeriksaan secara berasingan. Lihat [skop pengesahan](https://phishdestroy.io/tgwitness/ms/docs/reference/evidence/#verification-scope) untuk pemeriksaan pemerolehan dalam setiap mod, dan [operasi harian](https://phishdestroy.io/tgwitness/ms/docs/reference/operations/) untuk pengumpulan rutin.
