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

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

Tham khảo / Thiết lập

TgWitness: Telegram Export, OSINT & Verification

Cài đặt bằng một lệnh hoặc thực hiện trên GitHub Actions. Nắm rõ các tùy chọn điều tra, phạm vi đã công bố và những gì mà kho lưu trữ xác minh.

TgWitness là một công cụ xuất dữ liệu Telegram mã nguồn mở và không gian làm việc điều tra. Cài đặt nó chỉ với một lệnh, kết nối tài khoản, chọn các cuộc trò chuyện và xuất một tệp lưu trữ đã được ký. Nó cũng hỗ trợ thu thập dữ liệu tạm thời trên GitHub Actions và tiếp tục các cuộc điều tra với các chỉnh sửa đã lưu, ghi nhận việc xóa, tìm kiếm và báo cáo.

Bắt đầu với nhiệm vụ bạn đang có#

Nhiệm vụ của bạn Đường đi ngắn nhất Những gì bạn sẽ nhận được
Lưu cuộc trò chuyện hoặc tài khoản Cài đặt, kết nối tài khoản, chọn phạm vi xuất dữ liệu Một tệp lưu trữ đã được ký số chứa lịch sử đã chọn, kết quả thu thập và tài liệu xác minh
Thu thập trên một trình chạy tạm thời Sử dụng GitHub Actions để thu thập dữ liệu, ủy quyền cho một phiên mới và chọn phạm vi Một tệp lưu trữ được mã hóa kèm theo nguồn gốc quy trình làm việc trên GitHub
Theo dõi các thay đổi theo thời gian Tiếp tục quá trình quan sát đối với các cuộc trò chuyện đã chọn Các phiên bản đã lưu, thông báo xóa, tệp đính kèm và phạm vi ghi lại
Nghiên cứu và chia sẻ kết quả Tìm kiếm trong kho lưu trữ, sử dụng Bảng trường hợp và cấu hình báo cáo hoặc bản sao để chia sẻ Các phát hiện có liên kết đến nguồn và quy trình chuyển giao có thể xác minh, phù hợp với người nhận

Cài đặt bằng một lệnh duy nhất#

Trình cài đặt bao gồm Python và các phụ thuộc. Việc tải mã nguồn, Docker, nhà cung cấp AI và nhân chứng độc lập là các tùy chọn, không phải là điều kiện tiên quyết để cài đặt.

Linux / macOS:

curl -fsSL https://get.destroy.tools/install.sh | bash

Windows, trong PowerShell hoặc Command Prompt:

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"

Mở bảng điều khiển, kết nối tài khoản Telegram của bạn và chọn phạm vi thu thập. Quá trình cài đặt không tự động bắt đầu thu thập dữ liệu. Hướng dẫn cài đặt giải thích về truy cập cục bộ, máy chủ, cập nhật và kiểm tra bản dựng đã tải xuống.

Để sử dụng trình chạy tạm thời, hãy làm theo hướng dẫn Github Actions capture. Quy trình này yêu cầu một bản fork trên GitHub, quyền truy cập và mật khẩu tệp lưu trữ. Trang hướng dẫn capture giải thích các bước này cùng với thời gian phiên được phân bổ trước khi chạy. Tải xuống và lưu giữ tệp lưu trữ kết quả cùng tài liệu xác minh của nó.

Các thiết lập bổ sung khi nhiệm vụ yêu cầu#

Việc xuất dữ liệu từ một cuộc trò chuyện duy nhất yêu cầu có tài khoản và phạm vi được chọn. Quan sát liên tục, nhiều tài khoản, máy chủ proxy, chính sách tệp đính kèm, thiết kế báo cáo, quyền truy cập của người đánh giá, dấu thời gian bên ngoài và lưu trữ ngoài trang web phục vụ các yêu cầu điều tra và chuyển giao khác nhau. Cấu hình các tính năng này khi chúng có liên quan.

Phạm vi, quyền truy cập và các bản sao chia sẻ được tối ưu hóa giúp người vận hành lựa chọn những gì cần thu thập và tiết lộ. Hướng dẫn về thẩm quyền và cài đặt báo cáo ghi lại quy trình đã chọn và các bước chuẩn bị. Xem xuất tài khoản, quyền truy cập và cấu hình báo cáo.

Ứng dụng chạy trên máy tính hoặc máy chủ đã chọn. Việc thu thập cơ bản không yêu cầu GPU hoặc mô hình ngôn ngữ lớn (LLM). Các tính năng tùy chọn như OCR, chuyển đổi văn bản và phân tích AI có yêu cầu tài nguyên riêng. Cân đối quy mô triển khai dựa trên tốc độ tin nhắn, tệp đính kèm, lịch sử lưu trữ và số lượng tài khoản đồng thời.

Giữ nguyên bản ghi, dù nó có giúp ích cho ai đi chăng nữa#

Mục đích là bảo tồn tài liệu quan sát, bối cảnh và các thay đổi bất kể chúng ủng hộ quan điểm của ai. Bằng chứng có thể thách thức chính bản tường trình của bộ thu thập về các sự kiện. Giữ cho các quan sát nguồn, phạm vi chưa được bao phủ và kết luận phân tích có thể nhận diện được để người khác có thể đánh giá cùng một tài liệu.

Quy trình như sau: quan sát hiển thị trên tài khoản → nhật ký có chữ ký → xuất → xác minh của người nhận. Các chỉnh sửa được lưu sẽ tạo ra các phiên bản mới. Các quan sát bị xóa vẫn giữ lại nội dung đã được ghi lại trước đó. Hồ sơ phạm vi bao phủ cho thấy các sự gián đoạn đã biết. Các báo cáo và phân tích AI tham chiếu trở lại các nguồn đã lưu; một cách diễn giải không trở thành một quan sát nguồn chỉ vì nó xuất hiện trong một báo cáo có chữ ký.

Kiểm tra xác minh Những gì người nhận có thể xác định
Hashes tệp, chữ ký và chuỗi nhật ký Các bản ghi và tệp được cung cấp phù hợp với khóa dự kiến và ranh giới nhật ký
Một điểm kiểm tra hoặc chứng cứ được lưu giữ riêng biệt Tập tin lưu trữ này khớp với trạng thái nhật ký đã được lưu giữ trước đó
Dấu thời gian bên ngoài đã được xác minh Các byte được tham chiếu tồn tại tại thời điểm được ghi nhận theo các giả định tin cậy đã nêu
Chứng nhận ghi lại trên GitHub Tập tin lưu trữ phù hợp với quy trình làm việc đã được phê duyệt, phiên bản trình thu thập và bản tóm tắt đã ghi lại
Chứng thực Intel TDX Trích dẫn, trạng thái nền tảng, các chỉ số dự kiến của hệ điều hành/ứng dụng, độ mới và danh tính bộ thu thập đều vượt qua các kiểm tra đã được cấu hình

Trong quá trình thu thập được chứng thực, kết nối Telegram đã được xác thực của bộ thu thập được phê duyệt và đầu ra được liên kết với môi trường thực thi đã được kiểm tra. Kho lưu trữ giữ lại nội dung và bối cảnh đã thu thập; các báo cáo và phân tích tham chiếu trở lại các bản ghi đó. Sử dụng các bước xác minh cụ thể theo chế độ và các đầu vào đáng tin cậy trong hướng dẫn tin cậy và định dạng bằng chứng.

Quy mô đã công bố và hiệu suất đo được#

Các kết quả sau đây mô tả các khối lượng công việc và ngày tháng khác nhau. Số lượng không thể hoán đổi cho nhau: một sự kiện nhật ký không nhất thiết là một tin nhắn Telegram duy nhất.

Ngày Khối lượng công việc Kết quả đã công bố Những gì đã được đo lường
1 tháng 1 năm 2026 Máy chủ đang chạy, mười cơ sở dữ liệu không gian làm việc 1,610,818: bản ghi nhật ký; 900,232: sự kiện tin nhắn mới; 80,683: sự kiện chỉnh sửa; và 400,536: sự kiện xóa Danh mục chỉ đọc của các nhật ký được lưu trữ
5 tháng 11 năm 2026 Tìm kiếm trong các tin nhắn tổng hợp 1,000,000 trong các cuộc trò chuyện 200 Chỉ mục được xây dựng trong 71 giây; thời gian tìm kiếm trung vị cho mỗi truy vấn là 9–190 ms Tiêu chuẩn đánh giá tìm kiếm cục bộ
Ngày 6 tháng 11 năm 2026 Hai tệp xuất dữ liệu Telegram mới nhất Tin nhắn 27,030 và 29,299; 56,329 trong cả hai lần chạy Mỗi lần chạy qua WARP chỉ bao gồm hai tài khoản, bao gồm văn bản và siêu dữ liệu, không tải xuống tệp đính kèm
Ngày 6 tháng 11 năm 2026 Hai tệp xuất giống nhau, bao gồm cả quá trình chuẩn bị và đóng gói 127.713 và 141.781 tin nhắn/giây Tỷ lệ xuất dữ liệu hoàn chỉnh đã được đo lường; cả hai kho lưu trữ đều đã được xác minh bằng các khóa được ghim

Bản ghi xác minh cung cấp danh mục máy chủ, kiểm tra thu thập thời gian thực và số liệu tìm kiếm. Báo cáo hiệu suất xuất ra hai lần chạy thực tế, phần cứng, thời lượng, băm lưu trữ và tệp số liệu đã ký, mỗi tệp kèm theo phiên bản và điều kiện ghi lại.

Chứng nhận lịch sử công khai cũng ghi nhận 48 kho lưu trữ đã được xác minh với 3,598,381 bản ghi trên danh sách đầu vào gồm 50 nguồn và 40 không gian làm việc tài khoản. Nguồn A với tám tài khoản đã thu thập được 768,007 bản ghi lịch sử trong 1,117.082 giây, bao gồm thời gian chờ: 687.512 bản ghi/giây, với tính năng tải xuống tệp đính kèm bị vô hiệu hóa. Toàn bộ quá trình thử nghiệm, bao gồm cả việc xác thực, mất 1,574.920 giây. Các số liệu này mô tả khối lượng công việc đó, cùng với các ví dụ xuất dữ liệu mới có quy mô nhỏ hơn ở trên.

Lịch sử và thời gian thử nghiệm#

TgWitness đã được phát triển và thử nghiệm trong khoảng sáu tháng. Bộ thu thập, nhật ký có chữ ký và bộ xác minh được phát triển trước tiên; bảng điều khiển web và các mô-đun bổ sung được xây dựng dựa trên chúng sau đó. Kho lưu trữ này được tạo mới vào ngày 29 tháng 10 năm 2026 nhằm mục đích công bố và bắt đầu từ mã nguồn hiện có, do đó tuổi của kho lưu trữ này không phải là tuổi của dự án (lịch sử phát triển). Tổng khối lượng công việc đã thực hiện vào khoảng 100 triệu, bao gồm các lần chạy trước đó, các sự cố, các bản sửa lỗi và quá trình xác thực lặp lại. Các lần chạy được lựa chọn, mỗi lần có phiên bản, phương pháp và kết quả riêng, được ghi chép trong các báo cáo đo lường công khai có ghi ngày tháng.

Đọc chính xác trạng thái khả năng#

Đánh giá từng quy trình làm việc dựa trên việc triển khai, bản dựng đã công bố và các bài kiểm tra đã ghi lại . Nguồn hiện được gắn nhãn là bản xem trước. Nhãn phát hành đó tồn tại song song với bộ sưu tập đang hoạt động, các bản xuất, xác minh độc lập và các phép đo quy mô đã công bố. Một tính năng xem trước và một quy trình làm việc đã được xác thực có thể tồn tại trong cùng một ứng dụng; hãy mô tả tính năng cụ thể và bằng chứng đằng sau mỗi đánh giá.

Sử dụng khả năng hiện tại, tính năng và giới hạn, xác minh và nhật ký thay đổi cùng nhau. Ghi lại phiên bản đã được kiểm thử khi trích dẫn kết quả. Bản 6 Bản chụp nhanh đo lường tháng 11 cũng lưu giữ các bài kiểm tra thất bại và bị bỏ qua; những bài kiểm tra đó không được coi là đã vượt qua.

Dễ đọc cho cả con người và các công cụ AI#

Trang web cung cấp bản tóm tắt llms.txt, cẩm nang tiếng Anh đầy đủ ở llms-full.txt và llms-full.md, cùng các phiên bản Markdown của các trang. Đây là các định dạng tài liệu, không phải yêu cầu của AI để chạy TgWitness.

Tùy chọn MCP và (truy cập dòng lệnh) cho phép các công cụ được ủy quyền đọc các bản ghi đã lưu được chọn. Nội dung tin nhắn vẫn là đầu vào không đáng tin cậy. Các bản tóm tắt nên trích dẫn nguồn, phân biệt sự kiện quan sát được với suy luận và giữ nguyên mức độ không chắc chắn. Tìm kiếm toàn văn, OCR và kết quả đầu ra từ AI không thay đổi các quan sát đã ký ban đầu.