# Telegram · 帳戶匯出

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

匯出該帳號當前可讀取的內容：範圍、可恢復的任務、經簽名的存檔，以及已最小化的共享副本。

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

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

Translation coverage: this edition includes material from the English original.

匯出該帳號當前可讀取的內容：範圍、可恢復的任務、經簽名的存檔，以及已最小化的共享副本。

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文件說明](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [證據與驗證](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/evidence/)

![證據與驗證](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

匯出帳戶會預留該帳戶的資料擷取時段。在檔案被檢索、下載、驗證及封裝期間， 即時觀測仍可繼續進行。 在開始另一項競爭性的資料擷取作業之前，請先暫停其他歷史紀錄或匯出作業。 暫停檔案作業會讓觀測繼續運行，而暫停觀測則會保留檔案作業。

不同帳戶的匯出作業可同時執行。僅限「擷取」的作業在 等待核准期間會釋放該帳戶，因此可在核准待定時 啟動另一項常規會話匯出作業。而正在進行的資料擷取作業則仍會保留該帳戶。

身為安裝管理員，請選擇「**首頁」→「匯出我的帳戶**」，或「**匯出」→「Telegram 帳戶」→「設定帳戶匯出」**。 如有需要請先登入，檢視權限範圍，並明確啟動匯出程序。無需持續進行監測。「**已儲存的觀察結果」**是對現有日誌的獨立匯出；其 ZIP 檔案包含所有來源，不受日誌篩選器限制。每個工作區皆擁有專屬的任務、簽名身分及儲存空間。已授予的控制面板存取權限（包括無限制的普通匯出授權）無法開啟這些全帳戶範圍的路徑。

「**依發送者或訊息內容篩選**」下可展開發送者與文字篩選器。「**帳戶資料與連線方式」**包含可選的帳戶類別以及「Takeout／一般會話」選項；其摘要區塊即使在關閉時，仍會顯示當前的選項。關閉這些區段後，其設定將予以保留。在切換檢視模式時，「匯出」與「報告草稿」會保留在當前面板會話中；但重新載入瀏覽器後，這些內容將不會被保存。無論選擇哪種匯出方式，皆可存取現有的工作項目。

此工作流程會匯出目前連線帳戶可存取的資料。預設的**「自動」**模式會先執行 [Telegram Takeout](https://core.telegram.org/api/takeout)，該功能會回傳當前狀態下可存取的歷史紀錄，包括已離開的頻道、已儲存的聯絡人及其他帳戶資料。若 Telegram 在 Takeout 開始前設有等待期，「自動」模式會立即繼續進行常規會話；日誌會記錄 `account_export.transport` ，而簽名清單則會標明所使用的方法，並將此變更列為「遺漏」項目。相較之下，**「Telegram Takeout 會話」僅**等待批准，而**「常規會話**」則從不要求執行 Takeout。「秘密聊天」由「[秘密聊天](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/secret-chats/)」[模組](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/secret-chats/)即時記錄，編輯操作則透過即時監控記錄。常規會話的涵蓋範圍不同，並會記錄不受支援的類別。

**首頁 → 「匯出所有內容」**將啟動匯出程序，涵蓋所有聊天類型、所有附件類型、個人檔案、聯絡人、個人頭像、限時動態、會話元資料及其他帳戶資料，並以所有格式提供：包含 Telegram Desktop JSON 及 HTML 檢視介面的簽名 TgWitness 存檔。**選擇「匯出項目」**將開啟下方表單，預設值與上述相同。

Takeout 是 Telegram Desktop 亦採用的官方匯出 API。TgWitness 可直接從其自身擷取資料中寫入 與 Desktop 相容的 JSON；無需匯入他人的 存檔。兩種傳輸方式均可取得聊天室與訊息 ID。 匯出速度及 Takeout 的審核延遲取決於 Telegram 對該帳戶的限制， 以及聊天室是否為公開或可轉發的。在比較速度前，請先測量相同範圍與媒體設定。

對於最多20個明確選定的聊天 ID，標準 API 匯出功能會在考量該帳號完整的對話清單之前， 直接解析這些對等節點。因此，即使該公開頻道未出現在對話清單中， 仍可將其匯出，無需加入該頻道。 未緩存的對等方將回退至普通對話清單。 歸檔篩選器仍會生效：若 Telegram 未返回對話，且已歸檔 的聊天室被排除在外，則未知歸檔狀態將被記錄為遺漏。 Takeout 維持其分段範圍清單處理程序。兩種路徑均不會加入聊天室或 變更轉發權限。 在與桌面版相容的 JSON 格式中，Telegram 標記為 `left` 的頻道會出現在 `left_chats` 下，包括該帳號尚未加入的可讀取公開頻道。

`FLOOD_WAIT` 與 `FLOOD_PREMIUM_WAIT` 都會在伺服器要求的完整 時段內暫停請求。該帳戶的截止期限會於重新連線與重新啟動後持續保留；之後設定的 較短等待時間無法縮短此期限。重試次數設有上限，取消操作會保留已封存的頁面， 且 API 憑證不會因規避速率限制而輪替。不會進行任何 Premium 購買。

## 選擇要收集的內容

| 設定 | 含義 |
| --- | --- |
| 目的 | 請記錄此次收購的必要性。請勿在此處列出不必要的姓名或敏感的案件細節。 |
| 報告語言 | 選擇可讀報告中標籤的語言。原始訊息內容保持不變；未翻譯的範本標籤將使用英文。語言設定將透過已簽署的工作選項固定。 |
| 聊天類型 / 聊天 ID | 可選取所有類型，或僅選取列出的聊天室；「已儲存訊息」屬於私人聊天室。歸檔的聊天室可單獨選取。 |
| 日期 | UTC。面板中的「起始」與「結束」日曆日期均包含在內。API 使用包含 `from_utc` 與不包含 `to_utc`；面板會將「至」之後的次日作為起始日。若邊界為空，則該側不受限制。 |
| 發送者 ID | 僅顯示清單中發送者的訊息；若清單為空，則包含所有發送者的訊息。 |
| 文字內容包含 | 不區分大小寫的字面短語，以「或 (OR)」進行匹配。發送者／日期／自有訊息等條件則以「且 (AND)」進行組合。 |
| 自己的訊息 | 僅保留外發訊息。 |
| 媒體類型 | 請選擇附件類別，或清除所有選項以避免下載訊息檔案。 |
| 檔案／媒體總量限制 | 每檔檔案的 MiB 及已下載媒體的總量（以 GiB 為單位）。文字、收據、可讀報告以及 ZIP 的開銷會佔用額外的磁碟空間。 |
| 帳戶類別 | 個人檔案、聯絡人、個人頭像、動態、連線元資料及其他 Takeout 資料均設有獨立的控制選項。 |

「**最小化」**收集預設會停用檔案及帳戶元資料。發送者／內容過濾器會在保留訊息頁面及媒體下載之前生效。Telegram 仍會傳輸包含評估這些過濾器所需訊息的 API 歷史紀錄頁面：過濾功能並不能保證未被選中的訊息絕不會進入處理記憶體。工作區中其他持續進行的監測，則有其獨立的範圍與保留設定。

個人頭像歷史紀錄、限時動態、通訊會話元資料及其他帳戶資料預設皆會被選中。若案件僅需訊息內容，請停用這些項目，並將個人檔案與聯絡人一併排除。若附件或元資料非必要，於擷取過程中將其排除，可避免在此匯出檔案中保留另一份私有副本。

照片載荷採用其元資料與雜湊清單中識別出的靜態影像變體，包含帶有動畫頭像變體的照片。該動畫不會取代所選的靜態影像。若載荷長度短於或長於觀察到的尺寸，將被記錄為附件失敗；若在檔案參照更新期間表示形式發生變更，則會被拒絕。這些失敗情況會導致檔案庫不完整，但仍會保留訊息記錄。 獨立驗證機制亦會拒絕那些簽名長度與實際大小或表示形式不符的已儲存附件，包括存於較舊歸檔中的附件。

若專用媒體連線暫時中斷，附件讀取將改用 標準檔案連線。一分鐘後，系統會在 後台重新嘗試專用路徑，同時下載作業仍會繼續進行。此復原機制會維持已設定的 連線限制，並針對每個資料中心分別適用。Telegram 洪流 等待及授權失敗的情況仍會傳播。

## 訊息編號與活動地圖

每個帳戶存檔皆包含 `message-gaps.json` 以及 `map.html`。頻道和超級群組會針對每個聊天室對訊息進行編號，因此從第一則至最後一則匯出訊息之間，任何缺失的編號皆代表該聊天室中的一則訊息。 私人聊天、機器人及基本群組在整個帳戶中共享一組編號序列：若該處出現缺失的編號，則代表該編號原本屬於某個聊天室。當匯出的回覆或固定訊息指向該編號時，即可證實其所屬聊天室；否則，系統會根據相鄰訊息之間哪些聊天室處於活躍狀態來估算，其餘部分則歸因於未包含在匯出範圍內的聊天室。 每次運行皆包含其時間區間、相鄰訊息、各聊天室的分享比例以及信賴度標籤。會明確標示有限範圍（篩選條件、未選中的聊天室），因為若未標明範圍，缺失的編號便會包含選取範圍外的訊息。

`map.html` 顯示日曆、隨時間變化的聊天紀錄，以及按星期幾與小時劃分的訊息與缺失號碼網格，並附有每則聊天的表格及最長連續訊息串。聊天頁面會顯示專屬的日曆、群組隨時間變化的參與者清單，並在對話紀錄中標示訊息缺失的位置。 `verify.py` 重新計算 `message-gaps.json` 並從已簽名的頁面重新計算，同時拒絕已變更的檔案。

活動地圖列出了最大的頻道與超級群組缺口，包括其 號碼範圍及相鄰訊息的時間。點開某個範圍即可跳轉至分頁對話紀錄中對應的 標記位置。這些標記記錄了已儲存的相鄰號碼之間 缺失的號碼；刪除事件、其時間及訊息內容僅來自 已儲存的紀錄。在小螢幕上，寬幅表格會在其卡片內捲動。

長篇對話紀錄包含一個頁面索引，其中列有訊息日期範圍及日曆。 選擇某個月份，即可依擷取頁面的順序開啟該月份的第一筆紀錄。月份計數採用 以 UTC 為基準的記錄訊息日期；未標註日期的紀錄仍會保留在對話紀錄中。頁面 導覽功能包含首頁、末頁及相鄰頁面，並可直接開啟訊息 區段。此索引即使在離線且無 JavaScript 的情況下仍可運作。

## 簡介、涵蓋範圍與驗證

每個工作任務都會凍結其選項與帳戶身分。清單與擷取的頁面均經過簽名；頁面收據會記錄雜湊值、游標位置、時間、附件結果及其前一筆收據。僅已提交的頁面才會推進進度。重新啟動／恢復時，系統會在繼續執行前檢查這些記錄。若帳戶變更、已簽名頁面變更或收據鏈不一致，則會被拒絕。在擷取過程中無法編輯選項：若需處理其他範圍的內容，請啟動另一個工作任務。

「暫停」會中止正在執行的帳戶操作。重新啟動應用程式後，未完成的工作仍會保留，可供使用者明確地繼續執行。過期的 Takeout 會話需要明確地繼續執行；變更 Telegram 分割範圍可能需要重新進行擷取。繼續執行會保留先前的觀察結果，因此長時間執行的匯出並非單一原子快照。在擷取期間，其他變更帳戶的操作以及衝突的匯出作業都會被阻擋。請等待封裝完成後再刪除工作區。

「恢復」功能會立即顯示**「正在驗證已儲存的匯出資料…」**，並在聯繫 Telegram 之前於背景檢查已儲存的內容。驗證期間，控制面板仍可正常使用。「暫停」功能會等待驗證工作程序安全完成後，才釋放該帳戶；即使在啟動或恢復後立即按下此按鈕，該功能亦能正常運作。若儲存裝置速度較慢，此等待時間可能會較長。若完整性檢查失敗，系統會留下一個附有說明的失敗任務，並保留其檔案。

若 Telegram 在清點、檢視歷史紀錄或取得附件的過程中終止該帳號的授權，該任務將暫停，且不會將未完成的頁面標記為已完成。請重新連線至同一帳號並繼續執行，即可從上次儲存的頁面繼續。不可用的訊息佔位符會推進歷史紀錄游標，但不會結束閱讀：系統仍會請求較舊的可用訊息，且佔位符不會被視為已擷取的訊息或已確認刪除的訊息。

The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: [Coverage and missing material](https://github.com/phishdestroy/TgWitness/blob/main/docs/COVERAGE.md). Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed.

已完成的 ZIP 檔案仍可供重複下載及透過 HTTP 範圍下載。一個帳戶存檔包含 `manifest.json`、`manifest.sig`、已簽署的 `job.json`、`inventory.json`、`receipts/`、權威性 `data/*.jsonl`、選定的 `media/`、可讀取的 HTML 以及一個驗證器。請透過獨立通道固定收集器的指紋，然後使用可信的安裝環境進行驗證。 控制面板會將存檔儲存為 `tgwitness-account-export-EXPORT_ID.zip`；密封擷取則會將其作為 `account-export.zip` 包含在其證據存檔中。請使用您手邊檔案的名稱：

```
python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256
```

對於展開後內容超過 4 GiB 的存檔，請明確設定適當的 `--max-gib`。該面板會根據已宣告的展開大小及已發布的 ZIP 摘要，驗證其已驗證且完整的本地存檔；外部 CLI 則維持其獨立的大小限制。請在開啟可讀取的 HTML 之前進行驗證。存檔內建的驗證器雖方便，但使用獨立取得的驗證器可避免信任隨證據一併傳遞的可執行程式碼。

Ed25519 簽名與 SHA-256 雜湊值可偵測收集器提交相關位元組後所發生的變更。請將該結果與已記錄的收集範圍、擷取間隔、外部時間戳記收據，以及所選部署可用的來源驗證一併審查。後續的觀察結果將另行記錄，並保留先前擷取的版本。

## 為律師或其他收件人準備一份資訊披露文件

下載完成的匯出檔後，請保留原始的 ZIP，並從 `index.html` 從解壓縮後的副本中開啟。該報告說明其範圍、可用的涵蓋內容及 限制。其記錄參考結合了存檔參考、文件路徑和 記錄編號，因此收件者可在 HTML 或列印本中找到相同的條目。 如需實際範例，請參閱 [開啟虛構報告](https://phishdestroy.github.io/TgWitness/demo/report/)。

從已完成的帳戶匯出檔案中，選擇**「準備分享副本**」。此操作將建立一個獨立的簽名衍生檔。原始檔 ZIP 保持不變且為私有；除非收件者獲授權接收完整內容，否則請勿將其與已精簡的衍生檔一併傳送。請另行選擇報告語言。若要變更語言或任何選取設定，必須在建立前再次預覽。

1. 輸入披露目的，並選擇日期、發送者 ID 及文字內容篩選條件。
2. 您可以選擇保留真實身分、僅顯示列出的參與者，或對所有人進行假名化處理。在任何假名化模式下，聊天 ID／標題和訊息 ID 也會被替換。假名在單一披露範圍內保持不變，但在獨立準備的披露之間會發生變化。
3. 可保留訊息內容、完全省略，或新增具體名稱／短語以進行遮蔽。在私密模式下，本工具還會遮蔽已知的隱藏發訊者名稱與替代使用者名稱、完整代碼的發訊者 ID、私訊名稱、連結、電子郵件地址及類似電話號碼的字串。已知名稱比對功能會處理 Unicode 大小寫轉換，包括 `Straße`/`STRASSE`。通用群組／頻道名稱不會自動從訊息文字中移除。若已知身分遮蔽限制被超過，請縮小來源匯出範圍或省略文字；本工具不會在未提示的情況下跳過後續的名稱。這些規則僅為盡力而為，並非普遍性的匿名化處理。
4. 除非收件者需要，否則請勿包含檔案。所包含的原始檔案會保留其像素、音訊、文字及元資料。本工具**不會**對其進行匿名化處理。
5. 預覽計數、警告及轉換後的訊息範例後，請明確確認建立。每個範例限 12 則訊息，且每則訊息的文字長度不得超過 2,000 個字元。此為範例，並非對結果的完整檢視。變更設定需再次進行預覽。預覽將於 15 分鐘後失效，且綁定於該管理員會話及原始的 ZIP；建立後無法重複使用。建立新的預覽將使同一工作與會話中的先前預覽失效。
6. 檢視完整的結果 `index.html` 並 `messages.jsonl` 檔案。若發現其中包含不必要的資訊，請建立新的披露文件並設定更嚴格的排除條件。請勿直接編輯已簽名的 ZIP。

### 篩選後未包含的訊息

**預覽。**若揭露內容尚未完整，則顯示為不完整狀態。在每個至少包含一則已揭露訊息的聊天室中，選取範圍未涵蓋的訊息會以標記形式顯示， `[withheld by selection — rule: sender]` （或 `text`, `period`)。選擇**「選取範圍中未包含的訊息**」：每組連續未包含的訊息顯示一個標記（預設），或每則訊息顯示一個標記。標記僅包含規則與計數，絕不包含文字、發送者、日期或檔案。未包含任何已揭露內容的聊天室將被完全排除，因此本套件不會揭露其存在。

已披露的回覆會說明其回應的對象：是本副本中包含的訊息、被選取範圍排除的訊息，或是原始匯出檔中不存在的訊息（可能是在匯出前已被刪除，或從未被匯出；匯出檔無法區分兩者）。 若已公開的回覆所回應的是一則被隱藏的訊息，該訊息將始終擁有專屬標記，因此該回覆會指向一則說明其為何為空的記錄。這三種狀態有別於刪除與資料收集缺口，後兩者屬於原始匯出資料的範疇。

在 `messages.jsonl` （格式 `tgwitness-account-disclosure-v2`）中，每則訊息皆包含 `state`: `disclosed`，或 `withheld` 搭配 `rules` 以及 `count`。一則已公開的回覆包含 `reply_to` 與目標 `id` 以及 `state` (`disclosed`, `withheld`, `not_in_source`）。該清單會統計已公開的訊息、聊天紀錄、媒體檔案及 `withheld` 訊息。 `verify.py` 會拒絕攜帶內容的標記，以及指向封包中缺失記錄的回覆；版本 1 的封包驗證方式與先前相同。

精簡格式省略了結構化的帳號個人資料、聯絡人、頭像、會話、動態、原始 Telegram 物件、轉發標頭、回覆引文、聯絡人卡片及位置元資料。它不包含原始的 JSONL 檔案、私人篩選設定、化名金鑰及身分映射。選取的文字、明確保留的身分資訊及包含的檔案仍可能包含與該篩選器中相同的名稱、ID 或短語；這些內容需要另行審查。 隱私政策與化名金鑰會以加密形式保留於該任務的本地金庫中；刪除任務將清除其相關的隱私披露記錄。公開政策記錄的是篩選次數，而非篩選值。聲明之目的在清單與 HTML 中屬公開資訊：明確的隱私標準，以及在化名模式下已知的隱藏身分，均會在此處被遮蔽，即使訊息文字被省略亦然。請確保目的陳述中不包含不必要的個人細節；未知的身分識別背景則可保留。

其清單檔會將衍生檔案、公開政策及原始 ZIP 檔的雜湊值綁定在一起。透過驗證可確認檔案的完整性，若本地端提供原始檔，亦可驗證來源連結是否吻合。該面板會將共享副本儲存為 `tgwitness-disclosure-DISCLOSURE_ID.zip`：

```
python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256
python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip
```

來源連結顯示披露內容來自哪個封存與哪把收集器金鑰。披露僅包含所選內容；請對照原始匯出檢查所選範圍以及可識別細節的移除情況。

## 分享與託管擷取

請選取收件者所需的訊息與檔案，檢視完整的分享副本，並將原始檔另行保留。記錄已傳送 ZIP 檔案的雜湊值，以便收件者能識別並驗證該精確副本。選定的識別碼將經過假名化處理；所包含的文字及原始檔案仍屬檢視範圍。

GitHub Actions 支援透過 Takeout 或標準 API 匯出整個帳戶或選定聊天室的內容，並提供單一聊天室的事件日誌。[託管擷取指南](https://phishdestroy.io/tgwitness/docs/capture/)說明了設定驗證及 120 分鐘的限制。若要驗證源自託管擷取的共享副本，請將其來源雜湊值與原始存檔進行比對，並透過[特定模式的檢查](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/evidence/#verification-scope)來驗證該存檔的認證。

[證據格式](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/evidence/) · [案例報告](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/case-reports/)
