# Telegram · 載入來源歷史紀錄

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

從已啟用的來源載入過往訊息、暫停與恢復操作，並驗證經簽署的進度報告。

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

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

從已啟用的來源載入過往訊息、暫停與恢復操作，並驗證經簽署的進度報告。

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

在「**更多工具」→「來源」→「範圍內的聊天室**」中，檢視已啟用的聊天室，選擇「標準 API」或 「Takeout 匯出」，然後選擇**「載入完整歷史紀錄**」。此操作會修正該來源清單，並將其可用的過往訊息 讀入「聊天室」及簽名觀察日誌中。媒體檔案會使用現有的附件 設定及持久性下載佇列。此功能與各聊天室的簽名 JSON/HTML 匯出功能是分開的。

若要進行全帳戶範圍的資料收集，請選取「**整個帳戶** 」並儲存範圍。歷史紀錄 會在簽署其來源 清單之前，重新整理所有可存取的對話視窗，包括已歸檔的聊天紀錄。此發現過程不會受限於「選取聊天」選單的清單數量限制。稍後發現的 聊天紀錄將被監測，並取得其設定的初始快照；另一次完整執行可 載入其較早的歷史紀錄。請保持**「在歷史紀錄載入期間及之後維持監測」** 功能啟用，以便在歷史紀錄載入時記錄新訊息、編輯及刪除通知。 每次歷史記錄執行或匯出都會佔用一個擷取時槽；即時監測則會與其並行執行。

選擇一至三個並行聊天、一至五名附件處理人員，並決定是否保留可用的「最近操作」 以及是否比較先前儲存的版本。在 Telegram 中，提取操作可能需要經批准，並需 經過伺服器指定的等待時間。這些選項在恢復時將保持不變。有關傳輸、重試和信任的詳細資訊，請參閱[「回填行為」及 「證據合約」](https://github.com/phishdestroy/TgWitness/blob/main/docs/BACKFILL.md)。

## 暫停、重新開始與部分結果

- **「暫停」歷史紀錄**將停止讀取。**「繼續」歷史紀錄**則會從每個來源中最後一則已提交的 訊息開始恢復；重新啟動應用程式時，執行程序亦會保持暫停狀態，直至手動恢復為止。 恢復執行需使用相同的閒置 Telegram 帳號。
- 訊息監測、附件處理及游標提交均於單一交易中完成。 恢復執行的任務不會重複已提交的監測結果。即時擷取或 另一項明確啟動的獨立執行任務，可獨立監測同一則訊息。
- 每個來源（Takeout 中的每個 Telegram 分割範圍）會在首次讀取時設定一個最高訊息 ID。較新的訊息屬於 即時觀察，而非該來源剩餘的歷史頁面。
- 無法存取的來源，以及在擷取過程中被停用的來源，仍會顯示為 「失敗」或「跳過」。其餘來源則會繼續運作；整體結果將不完整。
- Telegram 僅向管理員顯示聊天室的管理員日誌。對於一般成員而言， 讀取管理員日誌的記錄將顯示為`history.admin_log.unavailable`，`reason: not_admin`， 且不會導致歷史紀錄不完整；但若管理員讀取管理員日誌失敗，則會導致歷史紀錄不完整。
- FloodWait 的延遲設定會遵循已儲存的帳戶退避策略。對於暫時性失敗，系統將重試最多 五次；若重試次數用盡或磁碟空間不足，系統將暫停操作，同時保留游標位置。
- **「結束此歷史執行」**會保留已儲存的觀察結果。此操作不會移除這些觀察結果，亦不會 取消標準 API 的附件處理任務。結束「Takeout」會將其剩餘的 Takeout 檔案標記為已跳過；暫停則會保留其可恢復狀態。新的執行會重新讀取已啟用的來源。

歷史記錄完成僅指歷史記錄的讀取操作。附件可能仍處於待處理狀態、 失敗，或因設定的政策而被排除。請檢查日誌中的媒體回執 及附件佇列；僅當回執已完成且位元組內容完整保留時， 才構成已儲存的附件。歷史記錄操作屬於明確的快照請求， 與用於篩選未來即時事件類別的開關設定相互獨立。

## 傳輸與驗證

儲存**已簽署的進度報告**後，請使用**「匯出證據」**功能下載 日誌及已儲存的附件。後續的證據匯出可能包含額外記錄； 該報告會將其計數器與日誌建立當下的前綴綁定。 請從此版本的可信賴版本中執行驗證器：

```
python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT
```

請將預期的簽名金鑰指紋獨立保留。驗證器會檢查 報告簽名、證據存檔、報告檢查點、來源計畫、帳戶 以及已儲存／不可用訊息的計數。新的執行程序也會將來源進度與 選項綁定至已簽名的游標事件。若未使用 `--evidence` 參數，則僅檢查 已簽名的報告及其內部一致性。舊版進度欄位與附件 摘要仍屬已簽名的收集器陳述。證據驗證器會檢查已存檔的媒體位元組。

請一併查閱經驗證的歷史紀錄及其擷取間隔、覆蓋範圍與 可用的「近期操作」。此工作流程會讀取目前可存取的歷史紀錄； [即時監控](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/collection/#message-history-and-attribution)會保留版本 並在通知送達時進行記錄，而「[秘密聊天」](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/secret-chats/)則使用 已啟用的端點整合功能。進行驗證時，請使用保留的檢查點、 見證記錄以及各驗證[模式](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/evidence/#verification-scope)中所述的 適用擷取證明。

擷取游標代表本地工作區的狀態。僅還原證據 ZIP 檔案並 不會還原待處理的擷取工作或 Telegram 會話。若需繼續執行原始工作， 請保留工作區備份。
