# Telegram · 資料蒐集原理

Canonical page: https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/

觀察範圍、即時更新、重新核對、附件、使用者操作以及「缺口」的含義，皆以逐筆記錄的方式呈現。

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

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

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

觀察範圍、即時更新、重新核對、附件、使用者操作以及「缺口」的含義，皆以逐筆記錄的方式呈現。

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文件說明](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [收藏集](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md)

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

TgWitness 會記錄已連線的 Telegram 帳戶所觀察到的內容。即時監控 會保留訊息、擷取的編輯內容、刪除通知及附件，並附上 其觀察時間與來源上下文。歷史讀取、重新檢查以及可用的 管理日誌記錄，會將分別識別出的觀察結果新增至該記錄中。

**本頁內容**

- [從登入到日誌](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#from-login-to-a-journal)
- [觀察範圍：選定的聊天室、某個資料夾或整個帳戶](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account)
- [範圍與事件選取](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#scope-and-event-selection)
- [自主操作](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#own-actions)
- [調查模式：加入團隊並與機器人對話](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots)
- [重新檢查分級](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#recheck-tiers)
- [訊息歷史紀錄與來源標示](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#message-history-and-attribution)
- [歷史快照](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#history-snapshots)
- [附件處理](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#attachment-handling)
- [暫停、鎖定、斷開連接及重新啟動](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#pause-lock-disconnect-and-restart)
- [帳戶隔離與驗證](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#account-isolation-and-verification)

## 從登入到日誌

關於自動銷毀的照片和檔案，請參閱[「自動銷毀媒體](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md)」。 本文說明優先級工作程序、已儲存與不可用結果，以及 API 收集器中 「已讀回執封鎖」功能的限制。

流程圖 · 授權使用者帳戶 → 選擇可存取的群組與頻道; 選擇可存取的群組與頻道 → 儲存事件與附件設定; 儲存事件與附件設定 → 開始監測; 開始監測 → 透過活躍的客戶端接收更新; 透過活躍的客戶端接收更新 → 適用來源與事件政策; 適用來源與事件政策 → 附加一份經簽署的觀察記錄; 附加一份經簽署的觀察記錄 → 檢視或匯出日誌; 附加一份經簽署的觀察記錄 → 處理任何排程中的附件; 處理任何排程中的附件 → 附上下載結果 · 授權使用者帳戶 · 選擇可存取的群組與頻道 · 儲存事件與附件設定 · 開始監測 · 透過活躍的客戶端接收更新 · 適用來源與事件政策 · 附加一份經簽署的觀察記錄 · 檢視或匯出日誌 · 處理任何排程中的附件 · 附上下載結果

**圖表轉為文字**

1. 授權使用者帳戶 → 選擇可存取的群組與頻道
2. 選擇可存取的群組與頻道 → 儲存事件與附件設定
3. 儲存事件與附件設定 → 開始監測
4. 開始監測 → 透過活躍的客戶端接收更新
5. 透過活躍的客戶端接收更新 → 適用來源與事件政策
6. 適用來源與事件政策 → 附加一份經簽署的觀察記錄
7. 附加一份經簽署的觀察記錄 → 檢視或匯出日誌
8. 附加一份經簽署的觀察記錄 → 處理任何排程中的附件
9. 處理任何排程中的附件 → 附上下載結果

授權、對來源的存取權限、正在運行的收集器，以及完整的傳送， 是不同的問題。成功登入並不代表能存取每個群組。 傳送狀況會另行追蹤：覆蓋率記錄、更新缺口恢復與重新檢查 會顯示哪些資料已送達。

## 監測範圍：指定聊天室、特定資料夾或整個帳戶

**更多工具 → 來源 → 範圍**決定了工作區會記錄哪些聊天室。

新設定將從「**選擇聊天室**」開始。現有的儲存選項將予以保留。若在設定精靈中選擇「 **所有聊天室」**，當載入的清單包含 超過 50 個聊天室時，系統會要求確認；而大小估算仍為一項獨立的、基於樣本的運算。

| 模式 | 記錄 | 新對話 |
| --- | --- | --- |
| 選定的聊天室（預設） | 僅限您手動新增的聊天紀錄 | 絕不會自動新增 |
| Telegram 資料夾 | 某個帳戶資料夾中的對話：包含按名稱列出的對話，加上該資料夾的分類（聯絡人、非聯絡人、群組、頻道、機器人），減去被排除的對話，以及（若資料夾有此設定）已歸檔的對話 | 符合條件的聊天記錄一經啟動即會被加入；您在 Telegram 中加入該資料夾的聊天記錄，將於一小時內被擷取 |
| 完整說明 | 該帳號所見的每則聊天紀錄 | 每當有新的聊天室、群組、私人聊天或機器人出現，只要其首次更新一到，便會立即被加入系統 |

- **來源類型**（頻道、群組、私人聊天、機器人）會限制「資料夾」及 「整個帳號」模式的範圍。選定的聊天可為任何類型，包括私人聊天和機器人； 來源類型絕不會阻擋您手動新增的聊天。 一旦關閉某種類型、設定排除條件或 切換至「選定聊天室」模式，系統會在儲存設定後立即停止自動新增來源，此操作會在 來源清單重新計算之前生效，即使在無法連線至 Telegram 的情況下亦然：其新 訊息、歷史紀錄、新聊天室歷史紀錄、對等設定及個人檔案觀察紀錄皆會受到影響。
- **手動新增的聊天紀錄**，即使位於資料夾之外，仍會保留在資料夾模式和全帳號模式中； 唯有*「排除」*、*「移除*」或暫停操作才會停止記錄。透過範圍 （*自動*）新增的聊天紀錄則會跟隨資料夾：一旦離開資料夾，將在下次重新計算時被暫停。
- **被排除的聊天室**在任何模式下均不會被記錄。在「資料夾」及「整個帳戶」模式下， 若在來源上執行*「排除」*或*「移除」*操作，該聊天室便會被加入此清單，因此範圍設定不會再次將其加入。 若再次手動選取該聊天室（在「來源」中、從「聊天室」或於「設定」→**「哪些聊天室？**」下）， 該聊天室便會從清單中移除。此清單最多可容納 5,000 個聊天室；若超過此數，系統將拒絕*「移除」*操作， 此時可改為暫停該聊天室。
- **自身操作**（預設為開啟）：此帳號發送的訊息、其編輯紀錄以及 回覆鍵盤按鍵的按壓紀錄。若關閉此功能，外發訊息與編輯紀錄將被跳過。
- 切換至某個資料夾或整個帳戶時會要求確認：這些模式會記錄 私人聊天內容及第三方訊息，僅應適用於專用帳戶。 確認操作及每次權限範圍變更，皆會產生簽署過的`scope.changed`記錄。在設定為 主要帳戶的帳戶上，權限範圍表單與「調查」功能會拒絕選取資料夾或整個 帳戶（與「開始」功能相同）；僅可透過不進行記錄的一次性複製來使用這些選項。
- 由範圍新增的聊天室會以標記為*「自動」*的來源顯示，並記錄為 `scope.applied` （在開始時及每小時）或 `source.discovered`（在觀察期間發現的新聊天室）。切換回 已選定的聊天室時，會立即暫停所有自動新增的來源，且不會再次讀取 該帳號的聊天室清單。 一旦範圍被 儲存，被排除的聊天即停止記錄，且即使 Telegram 未返回聊天清單，其來源也會被暫停。在 監測期間，儲存範圍會再次套用該範圍，即使數值未變更亦然。

這些模式的適用範圍：

- **「秘密聊天」**使用內建的 [Pseudo-secret 整合](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/secret-chats/)功能， 需透過控制面板安裝協定模組，並啟用各帳戶的啟用開關。雲端歷史紀錄 與「匯出」功能則採用獨立的取得路徑。
- **離線期間。**重新啟動後，TgWitness 會恢復已儲存的更新位置，向 Telegram 查詢遺漏的更新，並重新檢查聊天記錄。由於 Telegram 會保留有限度的積壓資料，因此 在長時間中斷後，報告和 `verify.py` 會將剩餘的間隔列為缺口（參見[覆蓋率](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)）。
- 初始僅列出前1,000個對話（限制設定位於「**更多工具」→「參數」**中）；較舊的 對話將於下次變得活躍時被加入。已加入對話的早期歷史紀錄不會被擷取——如有需要，請自行 擷取歷史快照或匯出完整對話紀錄。
- 不會套用那些隨時變動的資料夾條件（如靜音、已讀）：此類聊天室 仍會持續被監控。
- 在另一款應用程式中按下的**內嵌（回呼）機器人按鈕**，對第二個 會話而言是不可見的；機器人的回覆或編輯內容會被記錄下來。回覆鍵盤按鍵操作會以發送中的 訊息形式傳送，並標記為 `button_press`。
- 聊天數量越多，發送請求的次數就越多。Telegram 會針對其認為 過量的訊息量限制帳號，這正是使用專用帳號的另一個理由。

### 嚴格篩選的聊天室

**嚴格模式：僅「已選聊天室」**下的**聊天室可被讀取**，且預設為關閉狀態。此模式旨在 提供僅涵蓋已選聊天室的權限。當此模式開啟時：

- Telegram 的服務通知 (777000) 未被讀取：無論是在觀測開始或結束時，亦或是在觀測期間的每 分鐘皆未讀取。未寫入任何 `session.security_baseline` 或 `account.security_event` 記錄。
- 不會讀取該帳戶的連線清單：無論是在觀察開始或結束時（面板中關於 **案件證據**及其他連線的提問，以及證據保護模式的提問也會被跳過），在觀察期間每兩 分鐘也不會讀取，建立連線時不會讀取，連線檢查時也不會讀取——該檢查中的「*當前 授權*項目顯示為「跳過」。接管檢查所使用的兩步驟驗證狀態亦未 被讀取。因此，`account.sessions`、`session.concurrent_at_start` 和 `session.takeover_risk` 均未被寫入， 且從其他裝置終止的會話亦不會被報告為 `session_revoked_externally`。
- 雖然這是該帳戶的唯一會話（**請將其設為唯一會話**或其自動版本），但在監測期間以及建立連線時， 系統仍會每兩分鐘讀取一次會話清單，以便在出現其他會話時 記錄 `session.exclusive_ended`。 在此期間，777000 仍處於未讀狀態，儘管 `session.exclusive_from` 記錄顯示 Telegram 的登入通知持續被記錄。
- 刪除通知僅會在過去 10 分鐘內執行過會話檢查時，才會與該檢查結果進行比對（前提是這 是唯一的會話，或是在開啟**此帳號的「會話」**後）。 否則，除非上次權限檢查顯示 該帳號無法刪除此訊息（在私人聊天和一般群組中絕不會發生這種情況），否則系統會顯示：*無法 確定刪除者：可能是該帳號本身，也可能是透過另一會話或裝置所刪除。*
- 若使用的是已匯入的會話金鑰，在讀取 會話清單（例如在「**此帳戶的會話**」中）之前，日誌中不會顯示該會話的登入時間。在此之前，聊天記錄匯出及**自動** 帳戶匯出功能將使用一般會話而非「Takeout」，並顯示原因為`session_age_unknown`。
- Turning a chat on does not read its earlier messages. Without the switch, each chat turned on (in Sources, in Chats, by joining from the panel or in the setup wizard) gets one `baseline` snapshot of its latest messages, up to **More tools → Parameters → Largest history snapshot** (500 by default), when observation next runs. A waiting snapshot that comes due while the switch is on is dropped. A chat joined from the panel does not get its latest messages read as a new chat either (the **When a new chat or bot appears** count, 100 by default), and opening a chosen chat with no saved messages in Chats does not load its last 100 messages by itself. **Load history** and snapshots you start yourself still read history.
- 該帳戶的敏感內容設定既不會被讀取，也不會被變更。若未啟用此開關，當設定為關閉時，每次登入及建立新的 連線都會自動啟用該設定，且 Telegram 允許進行此變更（`account.content_settings`）；此設定 屬於該帳戶，並適用於所有 Telegram 應用程式。Telegram 標記為敏感的內容可能會保持隱藏狀態。
- 電話通話的更新不會以`account.phone_call`的形式記錄。
- 停止監控時，僅會寫入工作階段金鑰指紋；不會讀取工作階段清單或 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.

請在登入前啟用此功能；否則，系統會在登入過程中檢查當前的授權狀態，並自動啟用敏感 內容。每次變更都會產生一個已簽名的 `scope.changed` 記錄，而 `observation.started` 會將該值作為 `scope.strict` 傳遞。切換至資料夾或整個帳戶時，此功能將被關閉。

## 範圍與事件篩選

每個工作區都有其專屬的來源。TgWitness 不會加入群組、接受 邀請，也不會自動枚舉所有成員。來源必須已 可供該帳號存取。啟動時，收集器會根據該帳號可見的對話視窗， 檢查所選來源；除非 **「更多工具 → 參數 → 從帳號清單讀取的對話**」中有其他設定，否則將檢查前 1,000 個對話視窗。 若來源缺席，系統會標記為「**存取未確認**」，而非假設該來源已將您移除。

| 設定 | 收集 | 停用時的效果 |
| --- | --- | --- |
| 新訊息 | 一般已傳送訊息 | 後續的編輯／刪除操作可能缺乏先前已擷取的文字內容供比對。 |
| 編輯 | 提供經編輯的訊息版本 | 中間的變更內容日後不會被重建。 |
| 刪除記錄 | 範圍限定之刪除通知與非範圍限定之帳戶層級通知 | 刪除通知不會被加入日誌中。 |
| 反應 | 即時反應快照 | 不會另行新增反應更新。 |
| 會員 | 已發送會員服務訊息及參與者最新動態 | 上述會員觀察內容並未被納入。 |

設定將套用至工作區中所有已選取的來源。儲存表單以套用 變更；變更內容將連同簽署的「變更前」與「變更後」數值一併記錄。停用某個類別 並不會刪除較早的記錄。重新啟用該類別也不會補回遺漏的更新。

操作記錄及其他群組服務事件與這些 設定開關無關。當會員功能啟用時，會員服務訊息仍會產生訊息記錄， 即使一般的新訊息擷取功能已停用。擷取的 Telegram 物件會保留內嵌的元資料；設定開關並非內容遮蔽規則。

**私人聊天室與一般群組中的刪除操作，**會以不附帶聊天室的訊息 ID 形式傳送。 這些聊天室共用一個帳戶層級的訊息 ID 序列，因此當具有該 ID 的訊息 先前已被儲存時，其對應的聊天室即已知曉：刪除操作會記錄在該聊天室中，並透過 `chat_resolution` 說明刪除方式。從未被儲存的 ID 則維持**為無範圍的刪除**記錄，並附帶 一個明確的未解析聊天室。這些是 Telegram 的刪除通知，即使 其對應的聊天室尚無法關聯，這些通知仍會被保留。 通知的資料結構包含 ID； 日誌會新增接收時間以及任何已儲存的訊息上下文，包括 `deleted_message_was_outgoing`。可用的管理員日誌條目則提供另一種 來源，用以記錄操作、執行者及來源時間。

## 自身行動

被監測帳號發送的訊息會標記為 `outgoing`。關於外發 訊息的編輯說明指出：在私人聊天室和群組中，僅發送者本人可進行編輯；而頻道 貼文則可由其他管理員進行編輯。 當發送的訊息重複了該聊天室中 最新儲存的回覆鍵盤上某個按鈕的文字時，該訊息會標示為 `button_press`，並附有 該鍵盤記錄的連結。

「排除自身操作」的原則同樣適用於背景重新檢查及自動新增的聊天記錄。 被跳過的發送訊息會使重新檢查的位置向前推移，以避免阻擋後續收到的 訊息。明確的面板操作以及手動請求的聊天記錄快照仍會被記錄下來。

## 調查模式：加入群組並與機器人對話

**更多工具 → 來源 → 範圍 → 調查模式**會為專用 帳戶設定範圍，該帳戶可加入團隊聊天室、啟動機器人並向其發送訊息：包含整個帳戶、所有 來源類型、自身操作，以及每個出現的聊天室或機器人的個人資料及其最新 200則可見訊息。檢視表單並按下**「儲存範圍」**；切換至整個 帳戶時會要求進行慣常的確認。

- **按鈕。**訊息下方的按鈕會與該訊息一併保留，並顯示於「**聊天」**中：連結、網頁 應用程式、登入連結、待複製的文字、回呼資料、內嵌查詢，以及要求提供電話 號碼或位置的請求。 連結以文字形式顯示，且絕不會由面板自動開啟。當機器人 僅變更按鈕內容（例如新的付款連結）時，無論是 即時更新或重新檢查，這都將被視為該訊息的新版本。
- **新聊天室與機器人。**在「資料夾模式」及「整個帳戶模式」下，**當新的聊天室或機器人 出現時**，系統會於其出現的瞬間立即儲存：

  - 其作為 `source.profile` 記錄的檔案：機器人說明與指令、 使用者、群組或頻道的簡介文字、成員名單，以及當 Telegram 提供 時所顯示的關聯聊天室與邀請連結；
  - 其最新的可見訊息（最多 1,000 則）將作為標記為 `new_chat` 的歷史快照： 剛加入的團隊聊天室中的較早訊息，或是觀察者 注意到該聊天室之前，機器人所發的訊息。已即時儲存的訊息不會重複記錄。

  當套用範圍時，新選取的聊天會採用這些設定，包括 該帳號對話清單中已存在的聊天。初始個人檔案與歷史紀錄的載入 最多可同時針對三個聊天進行；針對同一聊天的工作將依序處理。 每個歷史紀錄／個人檔案階段皆採用已設定的操作超時值，因此停滯的請求 會釋放其工作執行緒。歷史紀錄會在可選的個人檔案讀取之前儲存；即使個人檔案 讀取失敗，也不會阻礙該歷史紀錄的擷取。 失敗的階段會在 5 秒後重試， 重試時間會倍增至最多 5 分鐘，且在延遲期間不會佔用工作執行緒。 待處理 ID、重試截止時間及已完成的階段都會儲存於本地端。重新啟動時 僅會恢復未完成的階段；檔案資料重試不會重複已完成的對話紀錄讀取。 在輪到其處理前已被停用的來源將被跳過。概覽畫面會將「活躍」、「待處理」 及「重試中」的聊天室載入狀態，與附件下載區分開顯示。 若觸發 FloodWait，此作業將暫停並於之後恢復；失敗情況會被記錄，而 聊天室的即時擷取仍會持續進行。這包含在解析新聊天室 身分期間的等待：待處理的個人檔案／歷史紀錄任務會保留以供重試，而現有的 較長帳戶級等待時間則不會縮短。工作執行者會共享此等待；並行處理 不會繞過 Telegram 的請求限制。 - **依需求擷取個人檔案。** **「聊天室 → 個人檔案 → 儲存個人檔案」現**可儲存任何來源的 當前個人檔案；最新版本將顯示於訊息上方。 - **聊天室狀態快照（預覽版）。**訊息流外的狀態會在沒有 訊息的情況下發生變化：取消釘選所有訊息不會留下訊息層級的追蹤紀錄、管理員 權限喪失、禮物被隱藏、轉換、升級或退款。在觀察期間，每個已啟用的 來源都會被定期讀取，並以簽名 `chat.state` 記錄：標題、使用者名稱、 描述、成員與管理員人數、關聯聊天室、慢速模式、置頂訊息 ID （最多 100 筆）、管理員及其權限與頭銜，以及顯示於頻道和 使用者個人檔案中的禮物（最多 100 筆）。 每筆紀錄皆列出與前一快照的差異： 變更欄位的「變更前」與「變更後」狀態、新增或移除的置頂訊息，以及新增、變更或不再列出的 管理員與禮物。 - Telegram 拒絕記錄的部分（例如對非管理員的成員而言， 該頻道的管理員清單）會在 `errors`標示；其先前值將保留並列於 `carried_forward`中列出，絕不會被報告為已移除。 - 若某筆記錄的唯一變更僅為計數，或經檢查確認無變更，則會透過 標記為 `state_seq` 與累積 `state_overrides`。完整狀態至少每七天寫入一次， 且每當計數以外的任何內容發生變更時亦會寫入。 - `parts_complete` 標記上限清單。新增項目需有完整的先前清單， 移除項目需有完整的當前清單，而明確的空值則記錄清空操作。 - **更多工具 → 參數 → 聊天狀態** 可設定間隔（預設為 12 小時，設為 0 則關閉快照 功能）、來源之間的暫停時間、讀取哪些部分，以及是否記錄檢查結果顯示無 變更的情況。 `FLOOD_WAIT` 並 `FLOOD_PREMIUM_WAIT` 停止剩餘的 快照請求，保留任何較長的帳戶級截止期限，並讓 中斷的聊天在等待結束後仍可再次嘗試。 - **不可見。**在其他 Telegram 應用程式中按下的內嵌（回呼）按鈕、機器人對此類按壓所回應的彈出視窗或 連結，以及在其他應用程式中使用的邀請連結，均不會傳送至 TgWitness。機器人隨後發送或編輯的內容則會被記錄。

### 從面板執行操作

**「聊天」**功能現已包含一個迷你客戶端，該客戶端使用所選工作區的 Telegram 帳戶：

- 撰寫純文字訊息，或在已儲存的訊息下方選擇**「回覆」**。即使設定範圍排除外發更新，系統仍會記錄回傳的外發 訊息。
- 按下當前回調按鈕或文字按鈕下方的**「Press」按鈕**。若鍵盤輸入內容與儲存版本不符，伺服器將再次擷取 該訊息並拒絕執行此動作。 回調收據會保留 Telegram 的彈出文字、警示標記及網址；回覆內容亦會顯示 於對話下方。網址仍為可選取的文字，且不會自動開啟。
- 按下 **+** → **開啟 Telegram 連結**，輸入 `@username`、一個公開連結 `https://t.me/name`、 `https://t.me/+invite` / `joinchat/invite`，或包含 `?start=parameter` 的機器人連結，然後按下 **「儲存預覽**」。原始連結與 Telegram 的預覽會在加入前經過簽署。 **加入／開啟並觀察**後，系統會加入該群組／頻道或開啟該用戶／機器人，將該 聊天視窗新增為已啟用的來源，並向機器人傳送 `/start` 指令，其中包含其起始參數。 待管理員批准的加入請求將被記錄為「待處理」，而非「成員資格」。

開啟「**開始觀察**」以即時擷取傳入的回覆。當 觀察處於暫停狀態時，面板動作仍可運作；面板會將其直接回應儲存下來，而即時 觀察則會擷取對話的其餘內容。 當觀察正在執行時，新增的來源會使用已設定的設定檔／歷史記錄匯入功能。 當來源處於暫停狀態時，請先在**「更多工具」→「來源」**中啟用該來源，再進行傳送或按下其按鈕。

`interaction.preview`、`interaction.requested` 和 `interaction.result` 是證據匯出中包含的普通簽名 日誌事件。請求會標識帳戶、訊息／按鈕 或預覽記錄，並標示監測是否正在運行。回執則區分成功、 拒絕、待核准及未知結果。中斷的請求可能已傳送至 Telegram：在執行新操作前請先檢查聊天記錄。 重複使用請求 ID 可檢索其 已儲存的收據，而無需重複執行該動作，包括重新啟動後亦然。當在當前頁面會話中針對同一動作收到模稜兩可的回應時，控制面板會保留該 ID。 此外，當成功執行動作後刷新視圖失敗時，控制面板也會保留該 ID：收據 仍會保持可見，再次點擊即可檢索該收據。 回呼與加入 RPC 僅有一次 嘗試機會；可重試的讀取操作則會保留其設定的重試政策。立即切換聊天室 會立即清除草稿與回覆對象，並停用傳送功能，直至新對話載入為止。

此迷你客戶端負責處理文字與回呼按鈕。迷你應用程式按鈕會觸發「**開啟迷你應用程式**」功能， 該功能會在隔離的瀏覽器中載入該應用程式（[迷你應用程式](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md)）。登入、 電話與位置請求、付款、內嵌查詢及附件功能仍需透過 Telegram 客戶端處理；其已儲存的按鈕元資料仍會顯示。新的控制項採用英文文字。

## 重新檢查等級

重新檢查會再次向 Telegram 查詢遺漏的訊息、編輯內容以及 Telegram 不再回傳的訊息。 標有星號的來源為**優先**來源，預設每 15 分鐘重新檢查一次； 其餘來源則每 6 小時重新檢查一次。手動選取的聊天室預設為優先來源，透過 資料夾或整個帳戶新增的聊天室則為一般來源。 每次循環最多重新檢查 30 個來源， 其餘來源則需等待下一分鐘；重新連線後，優先來源會優先處理。這兩種 間隔皆可於「**更多工具」→「來源」→「記錄」→「重新檢查」**中設定（設定為 0 即關閉該層級），並會 以 `recheck.changed` 形式記錄。

遺漏的訊息將從上次掃描中斷處向上回溯擷取，最多可恢復的數量取決於「 **更多工具 → 參數 → 每則聊天與每次掃描可恢復的遺漏訊息數**」（預設為 1,000）。因此，經過長時間中斷後， 重新檢查將填補整個缺口，即使比該缺口更新的即時訊息已被優先儲存 亦然。仍在補齊進度的聊天室將於下一分鐘再次進行重新檢查，而非 等待其層級間隔結束；`recheck.completed` 會顯示 `continues_after`，直至完成為止。

比對項目包含訊息文字、實體、鍵盤輸入（包括刪除紀錄）以及附件 內容／識別資訊。 僅變更檔案存取雜湊值或檔案參照本身並不構成 編輯，Telegram 自動填入的內容亦不構成編輯：例如連結預覽載入、故事瀏覽次數、由該帳號解鎖的付費 媒體，以及發票收據。聊天記錄中的每個儲存版本皆連結至其完整的日誌記錄，包含媒體元資料。

## 訊息歷史紀錄與來源標示

假設收集器先觀察到「10:00 會議」，隨後看到「11:00 會議」， 接著收到刪除通知。系統會將這三項不同的觀察結果追加至日誌中： 原始文字保留不變，編輯後的內容作為獨立版本，而通知則記錄了 已觀察到刪除操作。

若資料蒐集是在首個版本消失後才開始，則該內容將無法取得。 若在離線期間發生多次編輯，僅能儲存後續觀察到的 版本。刪除通知無法恢復從未被擷取的內容。

該記錄整合了多個來源：

| 來源 | 保留的資訊 |
| --- | --- |
| 即時訊息或編輯更新 | 訊息 ID、發送者元資料、擷取版本、接收時間，以及提供的 Telegram 訊息／編輯日期。 |
| 即時刪除通知 | 包含通報的訊息 ID、接收時間、原始通知以及先前儲存內容的連結。 |
| 可用的管理員日誌 | 動作、執行者、來源日期及提供的訊息內容，由具備所需權限的帳戶讀取。 |
| 面板互動 | 在所選帳戶下，所請求的操作及其記錄的結果。 |
| 重新檢查 | Telegram 當前的回應與先前儲存的訊息之比較。 |

`observed_at` 是該記錄在收集器時鐘上寫入的時間，且 會隨著 `seq`而增加。在處理即時更新時寫入的記錄，亦會攜帶 `received_at`，即更新抵達收集器的時間，以及 `processing_delay_ms`，即從接收至寫入所耗費的時間；在 觀測開始時暫存的更新，會依抵達順序優先處理，再處理後續的更新。 `source_at` 若該事件提供來源日期，則會予以保留。電報時鐘偏移觀測、 時鐘不連續記錄及[外部時間檢查](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/timestamp/)，皆提供 相關的時序背景。一般訊息通知的欄位描述 該通知；管理日誌與互動記錄則保留其自身的屬性資訊。

## 歷史快照

快照會從已啟用的來源中擷取最新的可見訊息，每次請求最多 500 則。結果會標記為「歷史觀察紀錄」。手動快照 會與觀察功能並行執行。重複的觀察紀錄 會作為獨立的記錄保存。啟用來源時，系統也會為該來源擷取一個`baseline`快照，除非 已啟用[「嚴格選擇的聊天室」](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#strict-chosen-chats)功能。

若在讀取過程中來源被停用，快照將停止。回覆必須屬於 所請求的聊天室，且包含嚴格遞減的正向訊息 ID，且這些 ID 必須小於所請求的 邊界。若出現無效的回覆，將在中斷該訊息儲存之前終止快照； 已保存的訊息將連同中斷記錄一併保留在簽名日誌中。

快照遵循附件政策，但與即時事件切換機制相互獨立。 它們不會還原已刪除的訊息或遺漏的中間版本。您可以在 暫停狀態下請求快照；任何排入佇列的附件將等待至觀察開始 且下載工作程序執行時才會處理。

**歷史紀錄**是單獨的獨占工作：依序讀取所選來源並下載其佇列中的附件，不啟動監控。暫停會釋放帳號，恢復則繼續已儲存的工作。關於多個閒置帳號上的日期、語言與回覆篩選，請參閱[分散式聊天匯出](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md)。

## 附件處理

附件下載功能預設為啟用狀態，當可用磁碟空間低於 1 GiB 時會暫停下載。收集器會將 訊息監測與下載任務一併提交。該任務會保留原始媒體 描述符及大小政策，因此後續經編輯的附件不會被悄然替換。

下載作業於訊息擷取後執行。完成的下載會建立一個包含 SHA-256 值與位元組數的 `media.saved` 記錄。被跳過、失敗、重試及中斷的 作業各有不同的結果；當檔案的 `media.saved` 記錄存在時，該檔案即被視為已保存。 已完成的檔案還必須與原始觀察到的附件 描述符中的位元組數相符。過短或出乎意料過長的回應不會被記錄為已保存的媒體。

在寫入 ``media.saved`` 之前，該檔案及其資料夾條目會先寫入磁碟。當前一個收集器 程序未經有序停止而結束時，下一次啟動時會讀取該執行期間記錄為已儲存的每個檔案。 若某個檔案 遺失，或其位元組內容與記錄的 SHA-256 值不符，系統會為其建立一個 ``media.missing_after_restart`` 記錄，該檔案的 下載任務將重新排入佇列，而位元組內容不符的檔案則會移至 ``media-damaged/`` 目錄。已移至異地儲存空間的檔案 則不會被讀取。

在同一個工作區內，針對同一附件表示形式的並行排程工作 會等待當前進行中的傳輸完成，然後在重新使用前再次檢查其已儲存的位元組。每個工作都會保留 自己的帶符號結果，以及對先前儲存檔案記錄的參照。取消一個 等待中的工作並不會取消當前進行中的傳輸；若該傳輸失敗或被取消， 下一個工作便可再次嘗試。不同的附件可以並行下載。

當有一個符合條件的任務正在執行時，具有相同帳戶、表示方式、預期大小及擷取動作的任務會 保持在佇列中。這些任務不會佔用下載時槽，因此 即使佇列起始處有大量同一份速度較慢的檔案副本，其他檔案仍可開始下載。 完成一次嘗試會喚醒佇列。優先級通道、儲存的重試延遲以及 歷史記錄所有權仍適用；每個觀察結果都會獲得其專屬的結果。

聊天匯出功能亦在 同一匯出目錄內，針對重複的檔案表示形式共享一個活躍的傳輸。每則訊息皆保留其附件參照，而重新使用 則需進行新的大小檢查與 SHA-256 校驗。不同檔案可並行檢查， 無需持有共同的傳輸鎖定。臨時下載與複製路徑對每項操作而言皆為 唯一；若操作被取消，系統會等待所有活躍的本地檔案讀取程序結束後才進行清理。 匯出檔案索引僅序列化元資料存取，不包含檔案雜湊運算或下載。

針對不同附件的伺服器雜湊讀取也會並行執行，並與位元組下載共享客戶端的 三個檔案請求槽位。重複讀取相同的表示形式 時，僅會重複使用完整的快取結果。檔案讀取不會佔用一般請求佇列的空間； 當請求獲得一個槽位時，系統會再次檢查已儲存的 FloodWait 截止時間。

**各類型皆**設有儲存限制：照片、影片、GIF 及動畫、圓形影片訊息、 語音訊息、音樂與音訊、貼圖，以及檔案。 每種類型皆可關閉，並設有 各自的容量限制（範圍為 1 至 2,000 MiB）；新工作區預設為：照片 20 MiB、 影片 100 MiB、檔案、音訊及圓形影片 50 MiB、語音與 GIF 20 MiB，以及 貼圖為 5 MiB。新工作區預設會關閉 GIF 和貼圖功能，直至手動開啟。若工作區 在「按類型設定限制」政策實施前已儲存相關設定，則所有類型皆保持啟用狀態，並維持其單一 類型限制。*設定最大檔案大小*將同時套用至所有類型。 停用某種類型會產生 `media.skipped` 記錄；未知大小或超出限額的檔案將不會被下載。大型檔案會 根據其大小及 256 KiB/s 的基準速度獲得額外的下載時間。工作會 在重新啟動後保留，但過期的參考、存取權限遺失或已刪除的檔案仍可能導致無法恢復。 待處理工作會保留其儲存的限制值，因此提高的限制僅適用於新檔案。 停用某種類型或降低其限制值，也會跳過該類型所排除的待處理檔案，每個檔案 都會產生一個`media.skipped`記錄；停用下載功能會暫停佇列，直到再次啟用為止。

## 暫停、鎖定、斷開連接及重新啟動

| 動作或狀態 | 效果 |
| --- | --- |
| 切換工作區 | 變更面板檢視；其他收集器將維持其狀態。 |
| 鎖定面板或關閉分頁 | 讓伺服器與監測功能持續運作。 |
| 暫停觀察 | 停止該收集器並保留排程中的附件處理工作。 |
| 停用來源 | 停止未來的範圍內擷取；當此功能停用時，相關的排程媒體處理任務將處於等待狀態。 |
| 移除來源 | 系統會將其視為來源並刪除其使用者檔案；已儲存的記錄仍保留在僅可追加的日誌中。尚待處理的附件則會被記錄為失敗（`source_removed`）。在資料夾模式與整個帳戶模式下，該附件亦會被排除在外。 |
| 變更連線路徑 | 需暫停運作，關閉舊版客戶端，並取消未完成的登入程序。 |
| 停止 Python 程序 | 停止所有工作區；離線期間不會進行任何監測。 |
| 主動監測結束後重新啟動 | 嘗試使用已儲存的會話來恢復先前儲存的範圍。若手動暫停，則會清除該意圖。 |

收集器會記錄偵測到的斷線、重試、錯誤、啟動／停止，以及 心跳訊號。短暫的中斷可能不會被週期性的連線檢查偵測到。 重新啟動後，系統會從儲存的更新位置請求遺漏的更新，並 定期重新檢查已觀察的聊天室；詳見[證據格式](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/evidence/#durable-collection-and-process-receipts-02)。快照會將當前狀態 作為背景資訊加入，且時間間隔仍會被記錄下來。

## 帳戶隔離與驗證

每個工作區皆擁有專屬的日誌、授權、簽署金鑰、政策及佇列。 僅其活躍的客戶端可貢獻即時觀察記錄。遭拒絕、待處理、 已被取代以及進行連線測試的客戶端，均無法將即時更新寫入其日誌。 不同帳戶可觀察同一群組，但其日誌仍保持獨立。

每個事件皆包含前一個雜湊值及 Ed25519 簽名。匯出內容涵蓋 整個工作區日誌，並透過固定序列號進行標記。面板篩選器不會過濾 匯出內容；在匯出檔案準備期間，資料蒐集可能持續進行至其邊界之外。

**「驗證日誌」**會透過顯示的 邊界檢查事件鏈與簽名。當工作區變更時，其結果將被清除，而面板會標示 檢查後新增的記錄。ZIP 匯出功能亦會驗證所收集的媒體檔案。

請分別保留指紋與檢查點。請參閱各模式下的「 [驗證範圍](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/evidence/#verification-scope)」以了解資料擷取檢查， 以及「[日常運作」](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/operations/)以了解例行資料蒐集。
