TgWitness: Telegram Export, OSINT & Verification

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ó#

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 hạn và các bản sao chia sẻ được tối thiể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 pháp lý và cài đặt báo cáo hỗ trợ quyết định đó; việc chọn một cấu hình không tự nó đảm bảo tuân thủ pháp luật hoặc tính hợp lệ của bằng chứng. Xem xuất tài khoả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 dữ liệu 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ó các yêu cầu tài nguyên riêng. Cần định cỡ 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; việc cài đặt dễ dàng không đảm bảo dung lượng bộ nhớ cố định cho mọi tải công việc.

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ý.

Các kiểm tra này hỗ trợ việc đánh giá tính toàn vẹn và nguồn gốc. Chúng không biến nội dung của một tin nhắn thành một tuyên bố đúng sự thật hoặc tái tạo các tin nhắn đã bị xóa mà người dùng chưa từng xem. Sử dụng dấu vân tay khóa được thu thập độc lập và các bước xác minh 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.

Bản ghi Verification cung cấp danh sách máy chủ, kiểm tra thu thập dữ liệu thời gian thực và đo lường tìm kiếm. Export performance công bố hai lần chạy thực tế, phần cứng, thời lượng, băm tệp lưu trữ và tệp đo lường đã ký. Chúng xác định kết quả cho các phiên bản và điều kiện đã ghi lại, chứ không phải là tốc độ chung hay giới hạn dung lượng.

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

Người duy trì báo cáo đã thực hiện thử nghiệm trong hơn sáu tháng tính đến ngày 6 tháng 11 năm 2026. Phần này mô tả lịch sử thử nghiệm của dự án. Các kết quả đo lường công khai có ghi ngày tháng ở trên ghi lại các lần chạy riêng lẻ; chúng không chứng minh được một chu kỳ thu thập dữ liệu liên tục trong sáu tháng đã được xác minh độc lập. Thời gian tồn tại của các tin nhắn được xuất ra cũng khác với thời gian bộ thu thập đã hoạt độ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.