參考資料 / 收集
Telegram · 載入來源歷史紀錄
從已啟用的來源載入過往訊息、暫停與恢復操作,並驗證經簽署的進度報告。
在「更多工具」→「來源」→「範圍內的聊天室」中,檢視已啟用的聊天室,選擇「標準 API」或 「Takeout 匯出」,然後選擇「載入完整歷史紀錄」。此操作會修正該來源清單,並將其可用的過往訊息 讀入「聊天室」及簽名觀察日誌中。媒體檔案會使用現有的附件 設定及持久性下載佇列。此功能與各聊天室的簽名 JSON/HTML 匯出功能是分開的。
若要進行全帳戶範圍的資料收集,請選取「整個帳戶 」並儲存範圍。歷史紀錄 會在簽署其來源 清單之前,重新整理所有可存取的對話視窗,包括已歸檔的聊天紀錄。此發現過程不會受限於「選取聊天」選單的清單數量限制。稍後發現的 聊天紀錄將被監測,並取得其設定的初始快照;另一次完整執行可 載入其較早的歷史紀錄。請保持「在歷史紀錄載入期間及之後維持監測」 功能啟用,以便在歷史紀錄載入時記錄新訊息、編輯及刪除通知。 每次歷史記錄執行或匯出都會佔用一個擷取時槽;即時監測則會與其並行執行。
選擇一至三個並行聊天、一至五名附件處理人員,並決定是否保留可用的「最近操作」 以及是否比較先前儲存的版本。在 Telegram 中,提取操作可能需要經批准,並需 經過伺服器指定的等待時間。這些選項在恢復時將保持不變。有關傳輸、重試和信任的詳細資訊,請參閱「回填行為」及 「證據合約」。
暫停、重新開始與部分結果#
- 「暫停」歷史紀錄將停止讀取。「繼續」歷史紀錄則會從每個來源中最後一則已提交的 訊息開始恢復;重新啟動應用程式時,執行程序亦會保持暫停狀態,直至手動恢復為止。 恢復執行需使用相同的閒置 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 參數,則僅檢查
已簽名的報告及其內部一致性。舊版進度欄位與附件
摘要仍屬已簽名的收集器陳述。證據驗證器會檢查已存檔的媒體位元組。
請一併查閱經驗證的歷史紀錄及其擷取間隔、覆蓋範圍與 可用的「近期操作」。此工作流程會讀取目前可存取的歷史紀錄; 即時監控會保留版本 並在通知送達時進行記錄,而「秘密聊天」則使用 已啟用的端點整合功能。進行驗證時,請使用保留的檢查點、 見證記錄以及各驗證模式中所述的 適用擷取證明。
擷取游標代表本地工作區的狀態。僅還原證據 ZIP 檔案並 不會還原待處理的擷取工作或 Telegram 會話。若需繼續執行原始工作, 請保留工作區備份。