# TgWitness: Telegram Export, OSINT & Verification

Canonical page: https://phishdestroy.io/tgwitness/docs/reference/overview/

Explore TgWitness installation, Telegram capture, investigation tools and evidence verification. Read measured workloads with their methods and revisions.

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

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

透過單一指令安裝，或於 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 帳戶，並選擇資料蒐集範圍。 安裝程序本身不會自動啟動資料蒐集。[安裝指南](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/installation/) 說明了本地存取、伺服器、更新以及檢查已下載版本的方法。

若要使用臨時執行程式，請參照 [GitHub Actions 的擷取流程](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)。該 工作流程需要 GitHub 分支、授權以及存檔密碼。擷取 頁面會說明這些步驟，以及執行前的會話時間預算。請下載 並保留生成的存檔及其驗證資料。

## 若任務需要，可提供更多設定選項

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

範圍、權限及最小化共享副本有助於操作員選擇要 收集與揭露的內容。管轄權指引與報告設定會記錄 所選的程序及準備步驟。請參[閱帳戶匯出](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/account-export/)、[存取](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/access/)及 [報告配置](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/case-reports/)。

該應用程式運行於選定的電腦或伺服器上。基本資料收集功能無需 GPU 或大型語言模型 (LLM)。可選的 OCR、轉錄及 AI 分析功能各有 其資源需求。請根據訊息傳輸速率、附件、 保留的歷史紀錄及同時在線帳戶數量來規劃部署規模。

## 無論這能幫助誰，都請保留這份紀錄

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

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

| 驗證檢查 | 收件者可確認的事項 |
| --- | --- |
| 檔案雜湊值、簽名與日誌鏈 | 所提供的記錄與檔案符合預期的金鑰與日誌邊界 |
| 一個獨立保留的檢查點或見證 | 此存檔與先前保留的日誌狀態一致 |
| 經驗證的外部時間戳記 | 在所述的信任假設下，所引用的位元組於該時間戳記時點確實存在 |
| GitHub 擷取證明 | 該存檔符合核准的工作流程、收集器版本及記錄的摘要 |
| Intel TDX 證明 | 引文、平台狀態、預期的作業系統／應用程式測量值、新鮮度及收集器身分均通過其設定的檢查 |

在「經認證的獲取」過程中，經核准的收集器之經身份驗證的 Telegram 連線 及其輸出，均與經檢查的執行環境綁定。存檔會保留 擷取的內容與上下文；報告與分析會回溯至這些記錄。 請使用 [《信任指南》](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md)及[《證據格式》](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/evidence/)中針對特定模式的驗證步驟與可信輸入。

## 已公布的規模與實測效能

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

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

[驗證](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/verification/) 記錄提供伺服器清單、即時 收集檢查及搜尋量測結果。[效能匯出報告](https://phishdestroy.io/tgwitness/docs/validation/) 包含兩次實際執行結果、硬體規格、執行時長、存檔雜湊值及簽名 量測檔案，每項皆附有其記錄的修訂版本與執行條件。

[公開歷史資料擷取驗證](https://github.com/phishdestroy/TgWitness/blob/main/docs/EXPORT-BENCHMARK-2026-11-06.md)亦記錄了使用 50 個來源的輸入清單和 40 個帳號工作區得到的**48 個經驗證的封存檔，共包含 3,598,381 筆紀錄**。來源 A 使用八個帳號，在包含等待時間的 **1,117.082 秒內取得了 768,007 筆歷史紀錄**，速度為**每秒 687.512 筆紀錄**，且未下載附件。包括驗證在內的整個嘗試耗時 1,574.920 秒。這些測量結果描述的是該次工作負載，與上文規模較小的全新匯出範例並列展示。

### 測試歷史與持續時間

TgWitness 已歷經約六個月的開發與測試。 收集器、簽名日誌及驗證器最先完成；網頁控制面板與附加模組則是在此基礎上後續建置的。此儲存庫於 2026 年 10 月 29 日為發布目的而新建立，並以現有程式碼為起點，因此其建立時間不等同於專案的[開發](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#development-history)歷史。 累計執行的工作負載約為 1 億次，其中包含早期執行、失敗、修正及重複驗證。經篩選的執行結果（每項皆有其專屬的修訂版本、方法與結果）已記錄於[標註日期的公開測量](https://github.com/phishdestroy/TgWitness/blob/main/docs/QUESTIONS-AND-CHECKS.md#dates-of-the-published-measurements)報告中。

## 精確解讀功能狀態

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

請綜合參考[當前的功能](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md)、[特性與限制](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/features/)、 [驗證](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/verification/)結果及[變更紀錄](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/changelog/)。 引用結果時，請記錄已測試的修訂版本。6年11月1日的測量 快照亦保留了失敗與跳過的測試；這些不屬於通過的測試。

## 可供人類及 AI 工具閱讀

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

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