TgWitness / Tài liệu hướng dẫn

Những nội dung đã được kiểm thử →

Tham khảo / Thu thập

Telegram · Trò chuyện bí mật: thiết lập và ghi lại

Cài đặt tiện ích giao thức Trò chuyện bí mật, bật cho từng tài khoản và ghi lại các cuộc trò chuyện mà TgWitness tạo hoặc chấp nhận.

TgWitness / Tài liệu

Ứng dụng đã được phát hành bao gồm phần nền tảng của Secret Chat, tích hợp bộ thu thập dữ liệu, các tuyến API và giao diện Pseudo-secret. Thư viện giao thức là một mô-đun riêng biệt: mở Pseudo-secret, nhấn Cài đặt và bật tính năng. Tính năng tự động chấp nhận tin nhắn đến sẽ ở trạng thái tắt cho đến khi bạn bật nó lên.

Mô-đun giao thức#

Mô-đun kiaro-telethon-secret-chat 0.2.0
Tác giả KiaroSama
Giấy phép GPL-3.0-hoặc-phiên bản-mới-hơn; LICENSE và NOTICE giữ nguyên trong tệp lưu trữ đã lưu
Nguồn KiaroSama/Telethon-Secret-Chat tại commit d87bf037b90060383c7b704d8a06ebb98c621c6f
Kiểm tra SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c trên danh sách các tệp gói và các giá trị SHA-256 tương ứng của chúng

Chức năng cài đặt và kích hoạt chỉ dành cho quản trị viên chính. TgWitness tải xuống tập tin lưu trữ nguồn của bản cam kết đó từ GitHub thông qua đường dẫn của không gian làm việc dành cho các yêu cầu bên ngoài Telegram, so sánh từng tệp trong gói với giá trị đã được cố định trong bản phát hành TgWitness, lưu tập tin lưu trữ vào modules/telethon-secret-chat-<commit>.zip trong thư mục dữ liệu và tải mã từ bộ nhớ. Không cần khởi động lại. Quá trình kiểm tra sẽ được thực hiện lại mỗi khi khởi động; tệp lưu trữ có sự khác biệt sẽ không được tải và trang sẽ hiển thị thông báo về điều này. Tệp gói bị thay đổi, thiếu hoặc được thêm vào sẽ khiến quá trình kiểm tra không thành công.

Mô-đun này là một tác phẩm độc lập với giấy phép riêng. TgWitness không cung cấp sẵn mô-đun này: mỗi lần cài đặt sẽ tải xuống mô-đun từ kho lưu trữ của tác giả. Thông tin chi tiết trên trang hiển thị mô-đun đã được tải, tác giả, giấy phép, commit và mã SHA-256 của mô-đun đó.

Một người quản trị không có quyền truy cập GitHub có thể cài đặt cùng một commit vào môi trường Python thay thế; sau đó, bảng điều khiển sẽ sử dụng bản sao đó:

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

TgWitness trở thành điểm cuối cho các cuộc trò chuyện mà nó tạo ra hoặc chấp nhận. Nó ghi lại các tin nhắn, tệp đính kèm có sẵn, thay đổi bộ đếm thời gian và thông báo xóa trong nhật ký đã ký. Nội dung đã lưu trước đó vẫn có sẵn sau khi có thông báo xóa sau này.

Tình trạng sẵn có của gói#

Vào ngày 8 tháng 11 năm 2026 , gói cài đặt đã được công bố đã được kiểm tra tại mã nguồn b35f8e18f3d1 , bản phát hành b35f8e18f3d1-1ff85ec98bb2 , phiên bản 0.9.1 bản xem trước. Gói wheel bất biến và khóa phụ thuộc của nó đã vượt qua quá trình xác minh chữ ký phát hành SHA-256 và RSA. Phần backend và giao diện được đóng gói khớp từng byte với phiên bản mã nguồn đó. Gói này cũng chứa đăng ký API và các hook của bộ thu thập dữ liệu.

Gói đó không chứa thư viện giao thức, và nó cũng không có trong tệp lock phụ thuộc. Phần secret-chats phần extra trong pyproject.toml cố định cùng một commit như nút trên bảng điều khiển.

Việc kiểm tra gói này xác định các tệp và khai báo phụ thuộc nào được phân phối. Bản ghi xác thực xác định các kiểm tra thời gian chạy riêng biệt. Hướng dẫn ngày 6 tháng 11 trước đó mô tả một bản chụp nhanh phát triển; nó không còn mô tả gói trên nữa.

Sử dụng giao diện#

Mở Pseudo-secret, cài đặt mô-đun nếu trang web cung cấp, bật tính năng này cho tài khoản và kết nối. Các yêu cầu đến sẽ chờ được chấp nhận trừ khi tính năng chấp nhận tự động đã được bật. Các thao tác khởi động, chấp nhận, gửi và đóng sẽ sử dụng quyền tương tác của tài khoản và chế độ bảo vệ chỉ đọc.

Hành động Kết quả được bảo toàn
Bắt đầu cuộc trò chuyện bằng tên người dùng hoặc ID người dùng Yêu cầu đi ra; đối tác chấp nhận yêu cầu đó trên thiết bị của họ.
Chấp nhận yêu cầu TgWitness trở thành điểm cuối nhận dữ liệu.
Gửi hoặc nhận tin nhắn secret_chat.message cùng với hướng, nội dung và bộ đếm thời gian được cung cấp.
Nhận tệp Các byte đã được giải mã được lưu trữ bằng SHA-256 và biên nhận secret_chat.file; được bao gồm trong tệp xuất bằng chứng.
Nhận thông báo về thời gian đếm ngược hoặc thông báo xóa Một bản ghi hành động riêng biệt cùng với các tin nhắn và tệp tin được lưu giữ.
Xem lại cuộc trò chuyện Cuộc trò chuyện, biên nhận tệp, thông báo và trực quan hóa khóa.

Các Cuộc trò chuyện bí mật hiện có trên thiết bị khác vẫn giữ nguyên các khóa dành riêng cho thiết bị đó. Một phiên đám mây được nhập vào sẽ không chuyển các khóa đó. Vật liệu khóa và bộ đếm của cuộc trò chuyện bí mật sử dụng kho lưu trữ không gian làm việc; các tin nhắn được lưu giữ và các tệp đã được giải mã sử dụng các biện pháp bảo vệ lưu trữ không gian làm việc thông thường.

Tìm các tin nhắn đã lưu#

Sử dụng tính năng Tìm kiếm tin nhắn trong một cuộc trò chuyện đang mở để tìm một cụm từ chính xác, không phân biệt viết hoa hay viết thường. Nhấn Trước và Tiếp theo, hoặc nhấn phím Enter và Shift+Enter trong ô tìm kiếm, để chuyển giữa các tin nhắn phù hợp. Bộ đếm hiển thị số tin nhắn; cụm từ phù hợp đầu tiên trong mỗi tin nhắn sẽ được đánh dấu. Nhấn phím Escape để xóa tìm kiếm.

Tính năng Tìm kiếm giúp hiển thị các cuộc trò chuyện xung quanh, các tệp đã lưu và thông báo xóa. Tính năng này tìm kiếm trong các bản ghi đã được tải sẵn trong bảng điều khiển. Khi còn các bản ghi cũ hơn, bảng điều khiển sẽ thông báo điều này; tùy chọn Tải các bản ghi cũ hơn sẽ mở rộng lịch sử và cập nhật kết quả tìm kiếm trong khi vẫn giữ nguyên tin nhắn hiện tại.

Mỗi cuộc trò chuyện sẽ giữ lại lịch sử tìm kiếm khi bạn chuyển đổi trong cùng một không gian làm việc. Việc khóa bảng điều khiển hoặc chuyển sang không gian làm việc khác sẽ xóa các lịch sử tìm kiếm đó. Các từ khóa tìm kiếm được lưu trong bộ nhớ của trang và không được lưu trữ trong bộ nhớ trình duyệt cũng như không được gửi dưới dạng các yêu cầu API. Việc tìm kiếm không gửi tin nhắn Telegram hay thông báo gõ phím/đã đọc. Các cài đặt hiển thị hiện có vẫn áp dụng cho việc mở cuộc trò chuyện và các thao tác khác.

Báo cáo xây dựng sẽ giữ nguyên phạm vi báo cáo của cuộc trò chuyện đã chọn; việc tìm kiếm trên giao diện hiển thị sẽ không tự động giới hạn các bản ghi được xuất ra. Hãy xem trước phạm vi lựa chọn của báo cáo trước khi tải xuống.

Kiểm soát tính bền vững và tương tác#

Việc triển khai tích hợp sử dụng tính năng tra cứu nhật ký bền vững để phát hiện trùng lặp, giữ các tác vụ đính kèm ở trạng thái chờ sau khi tải xuống thất bại, và định tuyến việc đóng qua cùng một bộ bảo vệ tương tác như các hành động từ xa khác. Những điều này thay thế ba lộ trình được báo cáo trong cuộc kiểm toán bản chụp phát triển ngày 6 tháng 11 trước đây.

Các tin nhắn đã được giải mã nhưng không ghi vào nhật ký thành công sẽ được lưu giữ trong kho để thử lại. Việc kiểm tra kích thước tệp đính kèm và dung lượng đĩa trống sẽ tạm hoãn quá trình tải xuống trong khi vẫn giữ nguyên các tác vụ tương ứng. Mô-đun này tái sử dụng kết nối hiện có của tài khoản. Các thông báo đã đọc và đang gõ chỉ được gửi theo lựa chọn trong phần Những gì phía bên kia nhìn thấy; thông báo chụp màn hình không bao giờ được gửi. Xem secret_chats.py, các tuyến API và chính sách truy cập.

Báo cáo kiểm toán lịch sử vẫn giữ nguyên các phát hiện từ bản chụp nhanh ban đầu. Tình trạng sẵn có và triển khai hiện tại nên được tham khảo từ phiên bản gói ở trên và các tính năng hiện tại.

Demo giao diện#

Kịch bản trang web sử dụng các yêu cầu, tin nhắn và tệp giả định để minh họa quy trình làm việc của bảng điều khiển. Đây là một ví dụ về giao diện; các kiểm tra giao thức và thu thập dữ liệu có kết quả được ghi ngày tháng riêng trong bản ghi xác thực.