# Telegram · 秘密聊天：設定與記錄

Canonical page: https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/secret-chats/

安裝秘密聊天協定擴充，依帳戶啟用，並記錄 TgWitness 建立或接受的聊天。

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

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

安裝秘密聊天協定擴充，依帳戶啟用，並記錄 TgWitness 建立或接受的聊天。

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [文件說明](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md)

已發佈的應用程式包含「秘密聊天」後端、收集器整合、 API 路由以及 **Pseudo-secret** 介面。通訊協定函式庫是一個獨立的模組： 開啟 **Pseudo-secret，**按下**「安裝」並啟用**。自動接受來訊 功能預設為關閉狀態，需手動開啟後才會生效。

## 通訊協定模組

|  |  |
| --- | --- |
| 模組 | `kiaro-telethon-secret-chat` 0.2.0 |
| 作者 | KiaroSama |
| 授權條款 | GPL-3.0 或更新版本；其 `LICENSE` 且 `NOTICE` 保留在已儲存的壓縮檔內 |
| 來源 | [KiaroSama/Telethon-Secret-Chat](https://github.com/KiaroSama/Telethon-Secret-Chat) 於提交時 `d87bf037b90060383c7b704d8a06ebb98c621c6f` |
| 檢查 | SHA-256 `c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c` 針對套件檔案清單及其自身的 SHA-256 值 |

**「安裝並啟用」**功能僅限主要管理員使用。TgWitness 會透過工作區用於處理 Telegram 外部請求的路徑，從 GitHub 下載該提交的 原始碼壓縮檔，將套件中的每個檔案與 TgWitness 發行版中設定的值進行比對，並將壓縮檔儲存至 `modules/telethon-secret-chat-<commit>.zip` 至 資料目錄中，並從記憶體中載入程式碼。無需重新啟動。每次啟動時都會 再次執行檢查；若檔案與 TgWitness 發布版不符，則不會被載入，且頁面會顯示相關提示。 若套件檔案發生變更、遺失或新增，檢查即會失敗。

該模組是一項獨立作品，擁有自己的授權條款。TgWitness 並未隨附此模組：每次 安裝時，系統都會從其作者的儲存庫中下載該模組。頁面上的**詳細資訊**會顯示 已載入的模組、其作者、授權條款、提交記錄及 SHA-256 值。

若主機無法存取 GitHub，則可將相同的提交安裝至 Python 環境中；控制面板隨後會使用該副本：

```
python -m pip install ".[secret-chats]"
```

TgWitness 會成為其建立或接受的聊天室之端點。它會將 訊息、可用的附件、計時器變更以及刪除通知記錄在已簽名的 日誌中。先前儲存的內容在日後收到刪除通知後仍可取得。

## 套件可用性

8 年 2026 月 8 日，已發布的安裝程式套件於原始碼 [`b35f8e18f3d1`](https://github.com/phishdestroy/TgWitness/commit/b35f8e18f3d13c329af12e0036f50e0c8f340a2c) 處進行驗證， 發行版本 `b35f8e18f3d1-1ff85ec98bb2` ，0.9.1 預覽版。 [不可變的 wheel](https://get.destroy.tools/releases/b35f8e18f3d1-1ff85ec98bb2/tgwitness-0.9.1-py3-none-any.whl) 檔案及其依賴項鎖定已通過 SHA-256 及 RSA 發行簽名驗證。 封裝後的後端與介面與該原始碼修訂版本完全字節對字節一致。 該套件亦包含 API 註冊與收集器掛鉤。

該套件並未包含該通訊協定函式庫，且該函式庫亦未出現在 依賴項鎖定中。 `secret-chats` [pyproject.toml](https://github.com/phishdestroy/TgWitness/blob/main/pyproject.toml) 中的 extra 設定所鎖定的 提交版本，與面板按鈕所對應的提交版本相同。

此套件檢查用以確定哪些檔案及依賴項宣告會隨套件發佈。 [驗證記錄](https://phishdestroy.io/tgwitness/zh-Hant/docs/reference/verification/)標示了各自獨立的執行時檢查項目。 先前 11 月 6 日的指南描述的是開發版快照；該指南已不再 描述上述套件。

## 使用此介面

開啟 **Pseudo-secret，**若頁面提供該模組，請安裝它，並為該帳戶啟用該模組，最後進行連線。 除非已啟用自動接受功能，否則傳入的請求將處於等待接受狀態。 啟動、接受、傳送及關閉等操作均會使用該帳戶的互動權限 以及唯讀保護設定。

| 操作說明 | 保留的結果 |
| --- | --- |
| 透過使用者名稱或使用者 ID 建立聊天 | 發出的請求；對等方在其裝置上接受該請求。 |
| 接受請求 | TgWitness 將成為接收端點。 |
| 傳送或接收訊息 | `secret_chat.message`，包含其方向、內容及提供的計時器。 |
| 接收檔案 | 經 SHA-256 及 `secret_chat.file` 收據加密的解密位元組；包含於證據匯出檔案中。 |
| 接收計時器或刪除通知 | 除保留的訊息與檔案外，另有一份獨立的動作記錄。 |
| 檢視聊天紀錄 | 對話、檔案收據、通知及金鑰可視化。 |

其他裝置上的現有「秘密聊天」將保留其裝置專屬金鑰。 匯入的雲端會話不會傳輸這些金鑰。「秘密聊天」的金鑰素材與 計數器使用工作區金庫；保留的訊息與解密檔案則採用 一般工作區儲存保護機制。

## 尋找已儲存的訊息

在已開啟的聊天視窗中使用**「搜尋訊息」**功能，可尋找字面上的短語，且不區分 大小寫。在搜尋欄位中按下**「上一則」**和「**下一則**」，或按下「Enter」及「Shift+Enter」， 即可在符合條件的訊息之間切換。計數器會顯示訊息數量；每則訊息中第一個符合條件的 短語會被標示出來。按下「Esc」可清除搜尋內容。

「搜尋」功能會讓周邊的對話、已儲存的檔案及刪除通知 保持可見。它會搜尋面板中已載入的記錄。若仍有較早的 記錄，面板會顯示相關提示；**點選「載入較舊的記錄」**可擴展歷史紀錄， 並更新搜尋結果，同時保持當前訊息的位置不變。

在同一工作區內切換時，每個聊天室都會保留其搜尋記錄。鎖定 面板或切換工作區會清除這些搜尋記錄。搜尋詞彙僅保留在 頁面的記憶體中，不會儲存於瀏覽器儲存空間，也不會作為 API 查詢發送出去。 搜尋操作不會發送 Telegram 訊息，也不會觸發輸入或已讀通知。現有的 隱私權設定仍會規範開啟聊天室及其他操作。

**建立報表時**會保留所選聊天室的報表範圍；顯示搜尋結果 並不會在未經提示的情況下限制匯出的記錄。請在下載報表前 預覽其選取範圍。

## 持久性與互動控制

此整合式實作採用持久性日誌查詢進行重複檢測， 在下載失敗後將附件任務保持為待處理狀態，並將關閉操作路由至 與其他遠端動作相同的互動守護機制。這些機制取代了 歷史上 11 月 6 日開發快照稽核報告中所提及的三條路徑。

若已解密訊息的日誌寫入失敗，該訊息將保留在儲存庫中以供重試。 系統會根據附件大小及可用磁碟空間進行檢查，在保留相關工作任務的同時暫緩下載。 此模組會重複使用該帳號的現有連線。讀取與輸入通知僅會 根據 [「對方所見內容」](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md#what-the-other-side-sees)中的設定發送；截圖 通知則絕不會發送。請參閱 [secret_chats.py](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/secret_chats.py)、 [API 路由](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/api/secret_chats.py)及 [存取政策](https://github.com/phishdestroy/TgWitness/blob/main/tgwitness/access.py)。

[歷史稽](https://github.com/phishdestroy/TgWitness/blob/main/website/validation/audit/REPORT.md)核保留其原始 快照結果。當前的可用性與實作應參閱 上方的套件修訂版本及[當前功能](https://github.com/phishdestroy/TgWitness/blob/main/docs/STATUS.md)說明。

## 介面示範

網站情境使用虛構的請求、訊息和檔案來展示 面板的工作流程。這僅為介面範例；協定與擷取檢查 的具體結果已記錄於驗證紀錄中，並附有日期標示。
