參考資料 / 設定

TgWitness: Telegram Export, OSINT & Verification

透過單一指令安裝，或於 GitHub Actions 上進行擷取。了解調查選項、已發布的規模，以及檔案庫所驗證的內容。

TgWitness 是一款開源的 Telegram 資料匯出工具及調查工作區。只需一則指令即可安裝，連接帳戶、選擇聊天室，並匯出經簽名的壓縮檔。它亦支援透過 GitHub Actions 進行臨時資料蒐集，並可透過儲存的編輯記錄、刪除記錄、搜尋及報告功能，持續進行調查。

從您手邊的任務開始#

您的任務	最短路徑	您將收到
儲存對話或帳戶	安裝、連結帳戶、選擇匯出範圍	一個經過簽名的存檔，內含選定的歷史紀錄、蒐集結果及驗證資料
在臨時執行環境中進行收集	使用 GitHub Actions 進行擷取、授權新的會話並選擇範圍	一個包含 GitHub 工作流程來源資訊的加密存檔
追蹤隨時間的變更	讓觀察功能持續運作於選定的聊天室中	已儲存版本、刪除通知、附件及記錄的涵蓋範圍
調查並分享調查結果	搜尋檔案庫、使用「案例看板」，並設定報告或分享副本	附有來源連結的發現結果，以及適合收件者的可驗證交接流程

安裝程式包含 Python 及其依賴項。原始碼檢出、Docker、AI 服務提供者以及獨立見證人皆為可選項目，並非設定的先決條件。

Linux / macOS：

curl -fsSL https://get.destroy.tools/install.sh | bash

Windows 系統，於 PowerShell 或命令提示字元中：

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"

開啟控制面板，連結您的 Telegram 帳戶，並選擇資料蒐集範圍。安裝程序本身不會自動啟動資料蒐集。安裝指南說明了本地存取、伺服器、更新以及檢查已下載版本的方法。

若要使用臨時執行程式，請參照 GitHub Actions 的擷取流程。該工作流程需要 GitHub 分支、授權以及存檔密碼。擷取頁面會說明這些步驟，以及執行前的會話時間預算。請下載並保留生成的存檔及其驗證資料。

單一聊天室的匯出功能需具備帳號並選定範圍。持續監測、多帳號、代理伺服器、附件政策、報告設計、審閱者存取權限、外部時間戳記及站外儲存，皆可滿足不同的調查與交接需求。請於相關情況下配置這些功能。

適用範圍、權限設定及最小化分享副本，可協助操作人員選擇應收集與揭露的內容。管轄權指引與報告設定皆有助於此決策；選擇特定設定檔本身並不代表已符合法律規範或具備證據採納性。請參閱帳戶匯出、存取權限及報告設定。

本應用程式運行於選定的電腦或伺服器上。基本資料蒐集功能無需 GPU 或大型語言模型 (LLM)。可選用的 OCR、轉錄及 AI 分析功能各有其資源需求。請根據訊息傳輸率、附件、保留的歷史紀錄及同時運作的帳戶數量來規劃部署規模；簡易的安裝流程並不保證每種工作負載的記憶體佔用量皆固定不變。

其目的是保存所觀察到的資料、背景及變更，無論這些內容支持何方的立場。證據可能會挑戰蒐集者自身對事件的敘述。請確保原始觀察結果、遺漏的涵蓋範圍及分析結論均可辨識，以便他人能評估相同的資料。

其運作邏輯為：帳戶可見的觀察紀錄 → 簽名日誌 → 匯出 → 收件者驗證。儲存的編輯會新增版本。刪除的觀察紀錄仍會保留先前擷取的內容。覆蓋記錄會揭露已知的中斷情況。報告與 AI 分析會回溯至儲存的來源；某項詮釋不會僅因出現在簽名報告中，就成為來源觀察紀錄。

驗證檢查	收件者可確認的事項
檔案雜湊值、簽名與日誌鏈	所提供的記錄與檔案符合預期的金鑰與日誌邊界
一個獨立保留的檢查點或見證	此存檔與先前保留的日誌狀態一致
經驗證的外部時間戳記	在所述的信任假設下，所引用的位元組於該時間戳記時點確實存在
GitHub 擷取證明	該存檔符合核准的工作流程、收集器版本及記錄的摘要

這些檢查機制可協助驗證內容的完整性與來源。它們並不會將訊息內容轉化為真命題，亦無法還原未曾見過的已刪除訊息。請使用獨立取得的金鑰指紋，並依照《信任指南》及《證據格式》中的驗證步驟進行操作。

以下結果描述了不同的工作負載與日期。計數值不可互換：日誌事件未必等同於一則唯一的 Telegram 訊息。

日期	工作量	發布結果	測量內容
1 年 11 月 2026	運行中的伺服器，十個工作區資料庫	1,610,818 筆日誌記錄；900,232 則新訊息事件、80,683 則編輯事件及 400,536 則刪除事件	唯讀清單；非吞吐量測試，亦非新的全鏈驗證
5 年 11 月 2026 日	在 200 個聊天室中搜尋超過 1,000,000 則合成訊息	索引建立時間為 71 秒；單次查詢的中位數搜尋時間為 9–190 毫秒	本地搜尋基準測試；非即時 Telegram 傳送
6 年 11 月 2026	兩份最新的真實 Telegram 匯出檔案	27,030 則訊息與 29,299 則訊息；兩次執行共計 56,329 則	每次透過 WARP 執行時，僅處理兩個帳戶（包含文字與元資料），不下載任何附件
6 年 11 月 2026	相同的兩項匯出作業，包含前置準備與封裝	每秒 127.713 及 141.781 則訊息	已測量完整匯出率；兩份檔案均已透過固定金鑰進行驗證

驗證記錄提供伺服器清單、即時資料蒐集檢查及搜尋效能測量。效能匯出報告包含兩次實際執行結果、硬體規格、執行時間、存檔雜湊值以及簽名的測量檔案。這些結果僅針對記錄中的特定版本與執行條件而定，並非普遍適用的速率或容量上限。

維護者報告截至 6 十一月 2026. 此處描述了該專案的測試歷史。上述附有日期的公開測量數據僅記錄了個別執行次數；它們並未構成經獨立驗證、且持續六個月不中斷的資料蒐集運行。此外，匯出訊息的存檔時間也與資料蒐集器實際運行時間不同。

針對每個工作流程，依據其實作、已發布的建置版本及記錄的測試結果進行評估。原始碼目前標示為「預覽版」。該發布標籤與可運作的資料集、匯出功能、獨立驗證及已發布的規模測量結果並存。預覽功能與已驗證的工作流程可同時存在於同一應用程式中；請描述評估背後所依據的具體功能與證據。

請綜合參考當前的功能、特性與限制、驗證結果及變更紀錄。引用結果時，請記錄已測試的修訂版本。6年11月1日的測量快照亦保留了失敗與跳過的測試；這些不屬於通過的測試。

該網站提供簡明版本的 llms.txt、完整的英文手冊 llms-full.txt 及 llms-full.md，以及各頁面的 Markdown 版本。這些是文件格式，並非運行 TgWitness 所需的 AI 要求。

可選的 MCP 及命令列存取功能，允許經授權的工具讀取選定的儲存紀錄。訊息內容仍屬不可信的輸入。摘要應引用來源、區分觀察到的事實與推論，並保留不確定性。全文搜尋、OCR 及 AI 輸出均不會變更原始的簽名觀察結果。