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 キャプチャの認証 アーカイブは、承認済みのワークフロー、コレクターのリビジョン、および記録されたダイジェストと一致しています。

これらのチェックは、完全性および出所の検証をサポートするものです。これらは、 メッセージの内容を真の記述に変えたり、未閲覧の削除済み メッセージを復元したりするものではありません。独立して取得したキーフィンガープリントと、 「信頼ガイド」および「証拠フォーマット」に記載されている検証手順を使用してください。

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

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

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

検証記録 には、サーバーのインベントリ、リアルタイムの 収集チェック、および検索測定結果が記載されています。パフォーマンスのエクスポートには 、2回の実稼働結果、ハードウェア、実行時間、アーカイブのハッシュ値、および署名付き 測定ファイルが掲載されています。これらは、記録されたリビジョンおよび 条件における結果を示すものであり、普遍的なレートや容量の上限を示すものではありません。

テストの履歴と期間#

メンテナーは、2026年11月6日時点で6ヶ月以上にわたるテストを実施したと報告しています。 6 11月 2026. これはプロジェクトのテスト履歴について記述したものです。上記の日付付き公開測定結果は 個々の実行を記録したものであり、独立して検証された、 6ヶ月間にわたる中断のない収集実行を立証するものではありません。また、エクスポートされたメッセージの経過時間は、 コレクターの稼働時間とは異なります。

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

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

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

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

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

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