TgWitness / ドキュメント

テスト済みの内容 →

参考文献 / セットアップ

TgWitness: Telegram Export, OSINT & Verification

1つのコマンドでインストールするか、GitHub Actionsでキャプチャしてください。調査オプション、公開されている規模、およびアーカイブが何を検証するのかを理解してください。

TgWitnessは、オープンソースのTelegramエクスポートツールおよび調査ワークスペースです。1つのコマンドで インストールし、アカウントを連携させ、チャットを選択して、署名付き アーカイブをエクスポートします。また、GitHub Actionsでの一時的なデータ収集や、保存された編集履歴、削除記録の監視、検索、レポート機能を活用した継続的な 調査にも対応しています。

手元にあるタスクから始めてください#

あなたのタスク 最短経路 納品内容
会話またはアカウントを保存する インストール、アカウントの連携、エクスポート範囲の選択 選択された履歴、収集結果、および検証資料を含む署名付きアーカイブ
一時的なランナーで収集する GitHub Actions を使用してキャプチャを行い、新しいセッションの認証を行い、スコープを選択してください GitHubワークフローの来歴が記録された暗号化アーカイブ
経時的な変更を追跡する 選択したチャットに対して監視を継続する 保存されたバージョン、削除通知、添付ファイル、および記録されたカバレッジ
調査を行い、その結果を共有する アーカイブを検索し、ケースボードを使用し、レポートや共有用コピーを設定してください 出典が明記された調査結果と、受信者に適した検証可能な引き継ぎ

1つのコマンドでインストール#

インストーラーには、Python および依存関係が含まれています。ソースコードのチェックアウト、Docker、AI プロバイダー、および独立したウィットネスはオプションであり、セットアップの前提条件ではありません。

Linux / macOS:

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

Windows(PowerShell またはコマンドプロンプト):

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

パネルを開き、Telegramアカウントを連携させ、収集範囲を選択してください。 インストールだけでは収集は開始されません。インストールガイド では、ローカルアクセス、サーバー、更新、およびダウンロードしたビルドの確認について説明しています。

一時的なランナーを使用する場合は、GitHub Actionsのキャプチャ手順に従ってください。この ワークフローには、GitHubのフォーク、認証、およびアーカイブのパスワードが必要です。キャプチャ ページでは、これらの手順と、実行前のセッション時間制限について説明しています。生成された アーカイブとその検証用資料をダウンロードし、保管してください。

タスクに応じて追加の設定が必要になる場合があります#

単一のチャットをエクスポートするには、アカウントと選択した範囲が必要です。継続的な監視、 複数のアカウント、プロキシ、添付ファイルポリシー、レポートの設計、レビュー担当者のアクセス権、 外部タイムスタンプ、およびオフサイトストレージは、それぞれ異なる調査および 引き継ぎの要件に対応しています。該当する場合は、これらの機能を設定してください。

適用範囲、権限、および共有コピーの最小化により、オペレーターは何を 収集し、開示するかを選択できます。管轄権に関するガイダンスとレポート設定には、 選択された手順と準備ステップが記録されます。アカウントのエクスポート、アクセス、および レポート設定を参照してください。

このアプリケーションは、選択したコンピュータまたはサーバー上で実行されます。基本的な収集には、 GPUやLLMは必要ありません。オプションのOCR、文字起こし、AI分析には、 それぞれ独自のリソース要件があります。メッセージレート、添付ファイル、 保持される履歴、および同時接続アカウント数に応じて、デプロイメントの規模を決定してください。

誰の役に立つにせよ、記録は残しておくべきです#

その目的は、 どの立場を支持するかにかかわらず、観察された資料、文脈、および変更点を保存することにあります。証拠は、収集者自身の 出来事に関する説明に異を唱える場合もあります。他の人が同じ資料を評価できるよう、 元の観察内容、網羅されていない部分、および分析上の結論が 識別できるようにしてください。

そのロジックは、アカウント上で可視化された観測 → 署名付きジャーナル → エクスポート → 受信者による 検証、という流れです。保存された編集によりバージョンが追加されます。削除された観測については、以前に キャプチャされた内容が保持されます。カバレッジ記録は、既知の中断を明らかにします。レポートおよび AI 分析は保存されたソースを参照します。解釈は、単に署名付きレポートに表示されたという理由だけで、ソース 観測となるわけではありません。

検証チェック 受信者が確認できること
ファイルのハッシュ、署名、およびジャーナルチェーン 提供されたレコードおよびファイルは、想定されるキーおよびジャーナルの境界と一致しています。
別途保持されるチェックポイントまたはウィットネス このアーカイブは、以前に保持されていたジャーナルの状態と一致しています
検証済みの外部タイムスタンプ 参照されたバイトは、記載された信頼前提の下で、タイムスタンプ時点において存在していました。
GitHub キャプチャの認証 アーカイブは、承認済みのワークフロー、コレクターのリビジョン、および記録されたダイジェストと一致しています。
Intel TDX アテステーション 引用、プラットフォームの状態、予想されるOS/アプリケーションの測定値、最新性、およびコレクターの識別情報は、設定されたチェックに合格しています。

認証済み取得において、承認されたコレクターの認証済みTelegram接続 および出力は、検証済みの実行環境に紐付けられます。アーカイブには キャプチャされたコンテンツとコンテキストが保持され、レポートや分析ではそれらの記録が参照されます。 信頼ガイドおよび証拠フォーマットに記載されている、モード固有の検証手順と信頼できる入力を使用してください。

公表されたスケールおよび測定されたパフォーマンス#

以下の結果は、異なるワークロードおよび日付に関するものです。カウントは 互換性がないことに注意してください。ジャーナルイベントは、必ずしも一意のTelegramメッセージとは限りません。

日付 作業量 公開された結果 測定対象
1年11月2026日 サーバーの稼働、10個のワークスペースデータベース 1,610,818件のログレコード、900,232件の新規メッセージイベント、80,683件の編集イベント、400,536件の削除イベント 保存されたジャーナルの読み取り専用インベントリ
5年11月2026日 200のチャットに含まれる1,000,000件以上の合成メッセージを検索 インデックスの構築に71秒を要し、クエリごとの検索時間の中央値は9~190ミリ秒でした。 ローカル検索ベンチマーク
6年11月2026日 2つの最新の実際のTelegramエクスポートデータ 27,030件および29,299件のメッセージ;両実行を合わせて56,329件 WARP経由の実行ごとに2つのアカウント(テキストおよびメタデータ)、添付ファイルのダウンロードはなし
6年11月2026日 準備およびパッケージングを含む、同じ2つのエクスポート 127.713および141.781メッセージ/秒 完全エクスポート率を測定。両方のアーカイブについて、固定鍵を用いて検証済み

検証記録 には、サーバーのインベントリ、リアルタイムの 収集チェック、および検索測定結果が含まれます。パフォーマンスのエクスポートには 、2つの実際の実行結果、ハードウェア、実行時間、アーカイブのハッシュ、および署名付き 測定ファイルが公開され、それぞれに記録されたリビジョンと条件が付与されます。

パブリック履歴の検証結果には、 50件のソース入力リストおよび 40のアカウントワークスペースにまたがる、3,598,381件のレコードを含む48の検証済みアーカイブも記録されています。8つのアカウントからなるソースAは、待機時間を含め1,117.082秒で768,007件の履歴 レコードを取得しました。これは1秒あたり687.512レコードに相当し、 添付ファイルのダウンロードは無効化されていました。 検証を含む試行全体には 1,574.920秒を要しました。これらの測定結果は、上記の 小規模な新規エクスポートの例と併せて、当該ワークロードを説明するものです。

テストの履歴と期間#

TgWitnessは約6か月間にわたり開発およびテストが行われました。 コレクター、署名付きジャーナル、および検証ツールが最初に開発され、その後、これらを基盤としてウェブパネルとアドオンモジュールが構築されました。このリポジトリは、公開を目的として2026年10月29日に新規に作成され、既存のコードを基に開始されたため、その作成日はプロジェクトの年齢(開発履歴)とは異なります。 累積実行ワークロードは、過去の実行、失敗、修正、および繰り返し検証を含め、1億件規模です。それぞれ独自のリビジョン、方法、結果を持つ選択された実行については、日付付きの公開測定結果に記録されています。

機能の状態を正確に読み取る#

各ワークフローについて、その実装、公開済みビルド、および記録された テストと照らし合わせて評価してください。ソースは現在「プレビュー」とラベル付けされています。このリリースラベルは、 機能するコレクション、エクスポート、独立した検証、および公開済みのスケーリング 測定値と共存しています。プレビュー機能と検証済みのワークフローが同じ アプリケーション内に共存する場合があります。評価の根拠となる具体的な機能と証拠について記述してください。

現在の機能、特徴、制限、 検証、および変更履歴を併せて記載してください。 結果を引用する際は、テスト対象となったリビジョンを明記してください。11月6日の測定 スナップショットには、失敗したテストやスキップされたテストも記録されていますが、これらは「合格」とはみなされません。

人間およびAIツールが読み取れる形式#

このウェブサイトでは、簡潔なllms.txt、完全な英語版マニュアルである llms-full.txtおよびllms-full.md、ならびに各ページのMarkdown版が提供されています。これらは ドキュメント形式であり、TgWitnessを実行するためのAI要件ではありません。

オプションの MCP およびコマンドラインアクセスにより、承認されたツールは 選択された保存済みレコードを読み取ることができます。メッセージの内容は、依然として信頼できない入力として扱われます。要約では、 出典を明記し、観察された事実と推論を区別し、不確実性を保持する必要があります。 全文検索、OCR、および AI 出力は、元の署名付き観察結果を変更することはありません。