參考資料 / 收集
Telegram · 秘密聊天:設定與記錄
安裝秘密聊天協定擴充,依帳戶啟用,並記錄 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 路由及 存取政策。
歷史稽核保留其原始 快照結果。當前的可用性與實作應參閱 上方的套件修訂版本及當前功能說明。
介面示範#
網站情境使用虛構的請求、訊息和檔案來展示 面板的工作流程。這僅為介面範例;協定與擷取檢查 的具體結果已記錄於驗證紀錄中,並附有日期標示。