TgWitness / 文件說明

已測試的內容 →

參考資料 / 收集

Telegram · 秘密聊天:設定與記錄

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

TgWitness / 文件說明

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

通訊協定模組#

模組 kiaro-telethon-secret-chat 0.2.0
作者 KiaroSama
授權條款 GPL-3.0 或更新版本;其 LICENSE 且 NOTICE 保留在已儲存的壓縮檔內
來源 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 處進行驗證, 發行版本 b35f8e18f3d1-1ff85ec98bb2 ,0.9.1 預覽版。 不可變的 wheel 檔案及其依賴項鎖定已通過 SHA-256 及 RSA 發行簽名驗證。 封裝後的後端與介面與該原始碼修訂版本完全字節對字節一致。 該套件亦包含 API 註冊與收集器掛鉤。

該套件並未包含該通訊協定函式庫,且該函式庫亦未出現在 依賴項鎖定中。 secret-chats pyproject.toml 中的 extra 設定所鎖定的 提交版本,與面板按鈕所對應的提交版本相同。

此套件檢查用以確定哪些檔案及依賴項宣告會隨套件發佈。 驗證記錄標示了各自獨立的執行時檢查項目。 先前 11 月 6 日的指南描述的是開發版快照;該指南已不再 描述上述套件。

使用此介面#

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

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

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

尋找已儲存的訊息#

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

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

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

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

持久性與互動控制#

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

若已解密訊息的日誌寫入失敗,該訊息將保留在儲存庫中以供重試。 系統會根據附件大小及可用磁碟空間進行檢查,在保留相關工作任務的同時暫緩下載。 此模組會重複使用該帳號的現有連線。讀取與輸入通知僅會 根據 「對方所見內容」中的設定發送;截圖 通知則絕不會發送。請參閱 secret_chats.py、 API 路由及 存取政策。

歷史稽核保留其原始 快照結果。當前的可用性與實作應參閱 上方的套件修訂版本及當前功能說明。

介面示範#

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