参考文献 / セットアップ
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 出力は、元の署名付き観察結果を変更することはありません。