# TgWitness: Telegram Export, OSINT & Verification

Canonical page: https://phishdestroy.github.io/TgWitness/docs/reference/overview/

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

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

[Documentation index](https://phishdestroy.github.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.github.io/TgWitness/zh-Hant/docs/reference/installation/) 說明了本地存取、伺服器、更新以及檢查已下載版本的方法。

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

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

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

適用範圍、權限設定及最小化分享副本，可協助操作人員選擇應 收集與揭露的內容。管轄權指引與報告設定皆有助於 此決策；選擇特定設定檔本身並不代表已符合法律規範或 具備證據採納性。請[參閱帳戶匯出](https://phishdestroy.github.io/TgWitness/zh-Hant/docs/reference/account-export/)、[存取權限](https://phishdestroy.github.io/TgWitness/zh-Hant/docs/reference/access/)及 [報告設定](https://phishdestroy.github.io/TgWitness/zh-Hant/docs/reference/case-reports/)。

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

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

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

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

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

這些檢查機制可協助驗證內容的完整性與來源。它們並不會將 訊息內容轉化為真命題，亦無法還原未曾見過的已刪除 訊息。請使用獨立取得的金鑰指紋，並依照[《信任指南》及《](https://github.com/phishdestroy/TgWitness/blob/main/docs/TRUST.md)[證據格式》](https://phishdestroy.github.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 毫秒 | 本地搜尋基準測試；非即時 Telegram 傳送 |
| 6 年 11 月 2026 | 兩份最新的真實 Telegram 匯出檔案 | 27,030 則訊息與 29,299 則訊息；兩次執行共計 56,329 則 | 每次透過 WARP 執行時，僅處理兩個帳戶（包含文字與元資料），不下載任何附件 |
| 6 年 11 月 2026 | 相同的兩項匯出作業，包含前置準備與封裝 | 每秒 127.713 及 141.781 則訊息 | 已測量完整匯出率；兩份檔案均已透過固定金鑰進行驗證 |

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

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

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

## 精確解讀功能狀態

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

請綜合參考[當前的功能](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md)、[特性與限制](https://phishdestroy.github.io/TgWitness/zh-Hant/docs/reference/features/)、 [驗證](https://phishdestroy.github.io/TgWitness/zh-Hant/docs/reference/verification/)結果及[變更紀錄](https://phishdestroy.github.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.github.io/TgWitness/zh-Hant/docs/reference/mcp/) 及[命令列存取功能](https://phishdestroy.github.io/TgWitness/zh-Hant/docs/reference/cli/)，允許經授權的工具讀取 選定的儲存紀錄。訊息內容仍屬不可信的輸入。摘要應 引用來源、區分觀察到的事實與推論，並保留不確定性。 全文搜尋、OCR 及 AI 輸出均不會變更原始的簽名觀察結果。