# Telegram · 収集の仕組み

Canonical page: https://phishdestroy.io/tgwitness/ja/docs/reference/collection/

記録範囲、リアルタイム更新、再確認、添付ファイル、自身の操作、および「ギャップ」の意味について、記録ごとに解説しています。

[Project context and measured scale](https://phishdestroy.io/tgwitness/docs/reference/overview/)

[Documentation index](https://phishdestroy.io/tgwitness/ja/llms.txt)

Translation coverage: this edition includes material from the English original.

記録範囲、リアルタイム更新、再確認、添付ファイル、自身の操作、および「ギャップ」の意味について、記録ごとに解説しています。

[TgWitness](https://github.com/phishdestroy/TgWitness/blob/main/README.md) / [ドキュメント](https://github.com/phishdestroy/TgWitness/blob/main/docs/README.md) · [コレクション](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md)

![コレクション](https://phishdestroy.io/tgwitness/assets/chapter-collect.svg?v=adb3306d1f69)

TgWitnessは、接続されたTelegramアカウントが観測した内容を記録します。ライブモニタリングでは、 メッセージ、キャプチャされた編集内容、削除通知、および添付ファイルを、 その観測時刻とソースコンテキストとともに保持します。履歴の読み取り、再確認、および利用可能な 管理ログレコードにより、個別に識別された観測結果がそのレコードに追加されます。

**このページでは**

- [ログインからジャーナルまで](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#from-login-to-a-journal)
- [監視範囲：選択したチャット、フォルダ、またはアカウント全体](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#observation-scope-chosen-chats-a-folder-or-the-whole-account)
- [適用範囲とイベントの選択](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#scope-and-event-selection)
- [自身のアクション](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#own-actions)
- [調査モード：チームへの参加とボットとの対話](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#investigation-mode-joining-teams-and-talking-to-bots)
- [階層の再確認](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#recheck-tiers)
- [メッセージ履歴と出典](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#message-history-and-attribution)
- [履歴のスナップショット](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#history-snapshots)
- [添付ファイルの取り扱い](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#attachment-handling)
- [一時停止、ロック、切断、再起動](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#pause-lock-disconnect-and-restart)
- [アカウントの分離と検証](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#account-isolation-and-verification)

## ログインからジャーナルまで

自己消滅型写真およびファイルについては、「[自己消滅型メディア」](https://github.com/phishdestroy/TgWitness/blob/main/docs/EPHEMERAL-MEDIA.md)を参照してください。 ここでは、優先度ワーカー、保存済みおよび利用不可の結果、およびAPIコレクターにおける 既読通知ブロックの制限について説明しています。

フローチャート · ユーザーアカウントの認証 → アクセス可能なグループおよびチャンネルを選択してください; アクセス可能なグループおよびチャンネルを選択してください → イベントおよび添付ファイルの設定を保存する; イベントおよび添付ファイルの設定を保存する → 監視を開始する; 監視を開始する → アクティブなクライアントからの更新情報を受け取る; アクティブなクライアントからの更新情報を受け取る → 情報源およびイベントに関するポリシーを適用する; 情報源およびイベントに関するポリシーを適用する → 署名付き観測記録を追加する; 署名付き観測記録を追加する → ジャーナルの確認またはエクスポート; 署名付き観測記録を追加する → キューに格納された添付ファイルを処理する; キューに格納された添付ファイルを処理する → ダウンロード結果を追加してください · ユーザーアカウントの認証 · アクセス可能なグループおよびチャンネルを選択してください · イベントおよび添付ファイルの設定を保存する · 監視を開始する · アクティブなクライアントからの更新情報を受け取る · 情報源およびイベントに関するポリシーを適用する · 署名付き観測記録を追加する · ジャーナルの確認またはエクスポート · キューに格納された添付ファイルを処理する · ダウンロード結果を追加してください

**図表をテキストで記述**

1. ユーザーアカウントの認証 → アクセス可能なグループおよびチャンネルを選択してください
2. アクセス可能なグループおよびチャンネルを選択してください → イベントおよび添付ファイルの設定を保存する
3. イベントおよび添付ファイルの設定を保存する → 監視を開始する
4. 監視を開始する → アクティブなクライアントからの更新情報を受け取る
5. アクティブなクライアントからの更新情報を受け取る → 情報源およびイベントに関するポリシーを適用する
6. 情報源およびイベントに関するポリシーを適用する → 署名付き観測記録を追加する
7. 署名付き観測記録を追加する → ジャーナルの確認またはエクスポート
8. 署名付き観測記録を追加する → キューに格納された添付ファイルを処理する
9. キューに格納された添付ファイルを処理する → ダウンロード結果を追加してください

認証、ソースへのアクセス、稼働中のコレクター、および完全な配信は それぞれ異なる問題です。ログインに成功しても、すべてのグループへのアクセスが許可されるわけではありません。 配信は個別に追跡されます。カバレッジ記録、更新ギャップの回復、および再チェックにより、 何が届いたかが確認できます。

## 監視範囲：指定したチャット、フォルダ、またはアカウント全体

**その他のツール → ソース → スコープは、**ワークスペースがどのチャットを記録するかを決定します。

新規設定は「**チャットを選択**」から始まります。既存の保存済み設定は引き継がれます。セットアップウィザードで「 **すべてのチャット」**を選択すると、読み込まれたリストに 50件を超えるチャットが含まれている場合に確認のメッセージが表示されます。チャット数の推定は、引き続きサンプルに基づく個別の処理として行われます。

| モード | 記録 | 新しいチャット |
| --- | --- | --- |
| 選択したチャット（デフォルト） | 手動で追加したチャットのみ | 自動的に追加されることはありません |
| Telegramフォルダ | アカウントのフォルダ内のチャット：フォルダに指定されたチャットに加え、そのフォルダのカテゴリ（連絡先、非連絡先、グループ、チャンネル、ボット）に含まれるチャットから、除外されたチャットおよび（フォルダの設定で指定されている場合）アーカイブされたチャットを除いたもの | 該当するチャットは、アクティブになるとすぐに追加されます。Telegramのフォルダに追加したチャットは、1時間以内に取り込まれます。 |
| アカウント全体 | そのアカウントで表示されるすべてのチャット | 新しいチャット、グループ、プライベートチャット、またはボットは、最初の更新が届いた瞬間に追加されます。 |

- **Source types** (channels, groups, private chats, bots) narrow the folder and whole-account modes. Chosen chats can be of any type, including private chats and bots; source types never stop a chat you added by hand. A type turned off, an exclusion or a switch to chosen chats stops automatically added sources as soon as it is saved, before the source list is recalculated and also when Telegram cannot be reached: their new messages, history passes, new-chat history, peer settings and profile observations.
- **手動で追加したチャットは**、たとえフォルダの外にあっても、フォルダモードおよびアカウント全体モードで記録され続けます。 これらを停止させるには、*「除外」*、「*削除*」、または一時停止を行う必要があります。スコープによって （*自動的に*）追加されたチャットはフォルダに追従します。フォルダから外れたチャットは、次回の再計算時に一時停止されます。
- **除外されたチャットは**、どのモードでも記録されることはありません。フォルダモードおよびアカウント全体モードでは、 ソースで*「除外」*または*「削除」*を行うと、そのチャットがこのリストに追加されるため、スコープによって再度追加されることはありません。 手動でそのチャットを再度選択すると（「ソース」内の「チャット」から、または「設定」→「**どのチャット？**」から）、 リストから除外されます。リストには最大5,000件のチャットが保存されます。それを超えると、*「削除」*は拒否され、 代わりにチャットを一時停止することができます。
- **自身の操作**（デフォルトでオン）：このアカウントが送信するメッセージ、その編集、および 返信キーボードのボタン操作。オフにすると、送信メッセージと編集はスキップされます。
- フォルダまたはアカウント全体に切り替える際には確認が求められます。これらのモードでは、 プライベートチャットや第三者のメッセージが記録されるため、専用のアカウントでのみ使用してください。 確認およびすべてのスコープ変更は、`scope.changed`レコードとして記録されます。メインアカウントとして 設定されたアカウントでは、スコープ設定フォームおよび調査機能は、startと同様にフォルダまたはアカウント全体の 選択を拒否します。これらを使用できるのは、記録を行わない1回限りのコピーのみです。
- スコープによって追加されたチャットは、*「auto」*とマークされたソースとして表示され、`scope.applied` （開始時および1時間ごと）または`source.discovered`（監視中に新たに検出されたチャット）として記録されます。選択したチャットに 戻すと、アカウントのチャットリストを再度読み込むことなく、自動的に追加されたすべてのソースが一斉に一時停止されます。 除外されたチャットは、スコープが 保存されるとすぐに記録が停止し、Telegramがチャットリストを返さない場合でもそのソースは一時停止されます。 監視中にスコープを保存すると、値に変更がなくても、スコープが再度適用されます。

これらのモードの適用範囲：

- **「シークレットチャット」**では、付属の「[疑似シークレット」統合](https://phishdestroy.io/tgwitness/ja/docs/reference/secret-chats/)機能を使用しており、 パネルからプロトコルモジュールをインストールし、アカウントごとに有効化スイッチを設定します。クラウド履歴 および「テイクアウト」では、別の取得パスが使用されます。
- **オフライン期間。**再起動後、TgWitnessは保存された更新位置から再開し、 Telegramに欠落した更新を問い合わせ、チャットを再確認します。Telegramはバックログに上限を設けているため、 長時間の停止後には、レポートおよび`verify.py`が、残りの期間をギャップとして表示します（[カバレッジを](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#coverage-continuity-gaps-and-unobserved-ids)参照）。
- 開始時には最初の1,000件のダイアログのみが表示されます（制限値は「**その他のツール」→「パラメータ」**で確認可能）。それより古い チャットは、次にアクティブになった時点で追加されます。追加されたチャットのそれ以前の履歴は取得されません。必要な場合は、履歴の スナップショットまたはチャットの完全なエクスポートを行ってください。
- 常に変化するフォルダの状態（ミュート、既読）は適用されません。そのようなチャットは 引き続き監視対象となります。
- 別のアプリで押された**インライン（コールバック）ボットボタンは**、2つ目の セッションからは認識されません。ボットの返信や編集は記録されます。返信用のキーボード入力は送信 メッセージとして届き、「`button_press`」というラベルが付けられます。
- チャットが増えれば、リクエストも増えます。Telegramは、同社が 過剰と判断した通信量に対してアカウントを制限するため、専用のアカウントを使用すべき理由がまた一つ増えます。

### 厳選されたチャット

**「厳格」：選択したチャットのみを読み取ることができ**、「**選択したチャット**」の下に表示されます。デフォルトではオフになっています。これは、 選択したチャットのみを対象とする権限を意図したものです。オンになっている場合は：

- Telegramのサービス通知（777000）が読み取られていません。観測の開始時や終了時にも、観測中の毎 分にも読み取られていません。`session.security_baseline`や`account.security_event`の記録は一切書き込まれていません。
- The account's session list is not read: not when observation starts or stops (the panel's question about other sessions for **Evidence for a case** and the evidence protection modes is skipped too), not every two minutes while observing, not when a connection opens, and not by the connection check, whose *Current authorization* entry is shown as skipped. The two-step verification status used by the takeover check is not read either. So `account.sessions`, `session.concurrent_at_start` and `session.takeover_risk` are not written, and a session ended from another device is not reported as `session_revoked_externally`.
- While this is the only session of the account (**Make this the only session** or its automatic version), the session list is still read every two minutes while observing and when a connection opens, so that `session.exclusive_ended` is recorded when another session appears. 777000 stays unread in that period, although the `session.exclusive_from` record says Telegram's sign-in notices keep being recorded.
- 削除通知は、過去10分以内にセッションチェックが実行された場合のみ（そのセッションが 唯一のセッションである場合、または**このアカウントの「セッション」**を開いた後）、セッションチェックと比較されます。 それ以外の場合は、前回の権限チェックで このアカウントがメッセージを削除できなかったことが示されていない限り（プライベートチャットや通常のグループチャットではそのようなことは決してありません）、次のように表示されます：「*誰が 削除したかは不明です。このアカウント自体が、別のセッションやデバイスから削除した可能性もあります。」*
- With a session key that was imported, nothing in the journal gives the time this session signed in until the session list is read (for example in **Sessions of this account**). Until then chat exports and **Automatic** account exports use the regular session instead of Takeout, with the reason `session_age_unknown`.
- Turning a chat on does not read its earlier messages. Without the switch, each chat turned on (in Sources, in Chats, by joining from the panel or in the setup wizard) gets one `baseline` snapshot of its latest messages, up to **More tools → Parameters → Largest history snapshot** (500 by default), when observation next runs. A waiting snapshot that comes due while the switch is on is dropped. A chat joined from the panel does not get its latest messages read as a new chat either (the **When a new chat or bot appears** count, 100 by default), and opening a chosen chat with no saved messages in Chats does not load its last 100 messages by itself. **Load history** and snapshots you start yourself still read history.
- アカウントの「機密コンテンツ」設定は、読み取られたり変更されたりすることはありません。このスイッチがない場合、サインイン時や新しい 接続のたびに、設定がオフの状態でオンになり、Telegram はこの変更を許可します（`account.content_settings`）。この設定は アカウントに紐づいており、すべての Telegram アプリで適用されます。Telegram が「機密」とマークしたコンテンツは、非表示のままになる場合があります。
- 電話による更新情報は、`account.phone_call` として記録されません。
- 観察を停止しても、セッションキーのフィンガープリントのみが書き込まれ、セッションリストや777000は読み込まれません。

It does not narrow what Telegram sends: updates of every chat still reach this session, and only the chosen chats are recorded. The account's chat list (up to **Chats read from the account's list**) and its folders are still read at start, and again when the scope is saved while observing, to find the chosen chats. Deletion notices without a chat (`deletion.unscoped`) are still recorded: they carry message IDs only and may belong to a chosen private chat or ordinary group. The frozen-account check (`help.getAppConfig`), the other connection checks, and features you turn on yourself (ending other sessions automatically, the witness probe, pseudo-secret chats, **Sessions of this account**, and Telegram's list of signed-in devices under **More witnesses**, which reads the session list at each timestamp pass and which setup ticks for the **Follow chats** and **Evidence for a case** goals) keep working.

サインインする前に有効にしてください。そうしないと、サインイン処理そのものが現在の権限を確認し、機密 コンテンツを有効にしてしまいます。変更があるたびに、署名付きの `scope.changed` レコードが生成され、`observation.started` には `scope.strict` としてその値が格納されます。フォルダまたはアカウント全体に切り替えると、この機能は無効になります。

## 適用範囲とイベントの選択

各ワークスペースには独自のソースがあります。TgWitnessはグループに参加したり、 招待を受け入れたり、すべてのメンバーを自動的に列挙したりすることはありません。ソースは、 アカウントからすでにアクセス可能なものでなければなりません。起動時、コレクターは選択されたソースを アカウントの表示可能なダイアログと照合します。「**その他のツール → パラメータ → チャット」でアカウントのリストから読み取る設定**に別段の指定がない限り、 最初の1,000件のダイアログが検査されます。 存在しないソースは「**アクセス未確認」**とマークされ、あなたが削除されたとはみなされません。

| 設定 | 収集します | 無効にした場合の影響 |
| --- | --- | --- |
| 新しいメッセージ | 通常配信されたメッセージ | 後から行われた編集や削除については、比較対象となる以前に記録されたテキストが存在しない場合があります。 |
| 編集 | 編集済みのメッセージ版を提供 | 途中での変更内容は、後から復元されることはありません。 |
| 削除 | 範囲指定された削除通知と、範囲指定のないアカウントレベルの通知 | 削除通知はジャーナルには追加されません。 |
| 反応 | 送信された反応のスナップショット | 個別の反応に関する更新情報は追加されません。 |
| メンバーシップ | 会員向けサービスのお知らせや参加者への最新情報を配信しました | これらの会員に関する観察事項は追加されていません。 |

設定は、ワークスペース内で選択されたすべてのソースに適用されます。変更を適用するには、フォームを保存してください。 変更内容は、署名付きの「変更前」および「変更後」の値とともに記録されます。カテゴリを無効にしても、 それ以前の記録は削除されません。また、再度有効にしても、見逃した更新内容は遡って反映されません。

運用記録やその他のグループサービス関連のイベントは、これらの 設定とは別個に扱われます。メンバーシップサービスメッセージについては、通常の 新規メッセージのキャプチャが無効になっている場合でも、メンバーシップが 有効になっているとメッセージ記録が生成されることがあります。キャプチャされたTelegram オブジェクトには埋め込まれたメタデータが保持されます。設定は、情報の黒塗りルールではありません。

**プライベートチャットや通常のグループでの削除は**、チャットを伴わないメッセージIDとして届きます。 これらのチャットはアカウント全体で共通のメッセージIDシーケンスを共有しているため、そのIDを持つメッセージが 以前に保存されていた場合、そのチャットは特定されます。削除は、そのチャットに `chat_resolution`でその方法を説明して記録されます。保存されたことのないIDは、 明示的に未解決のチャットを持つ**スコープ未指定の削除**として残ります。これらはTelegramの削除通知であり、 そのチャットとの関連付けがまだできない場合でも保存されます。 通知のスキーマにはIDが含まれており、 ジャーナルには受信時刻と、保存されたメッセージのコンテキスト（ `deleted_message_was_outgoing` を含む）が追加されます。利用可能な管理者ログのエントリは、 アクション、実行者、および発生時刻に関する別の情報源となります。

## 自身の行動

監視対象アカウントから送信されたメッセージには「`outgoing`」というラベルが付与されます。送信済み メッセージの編集については、プライベートチャットやグループチャットでは作成者本人がのみ編集可能であるのに対し、チャンネルへの 投稿は他の管理者も編集できることが明記されています。 送信メッセージが、そのチャット内で最も新しく保存された返信キーボードのボタン のテキストを繰り返し使用している場合、そのメッセージには`button_press`というラベルが付けられ、 そのキーボードの記録へのリンクが添付されます。

自身の操作を除外する処理は、バックグラウンドでの再チェックや、新しいチャット履歴の自動記録にも適用されます。 スキップされた送信メッセージは、再チェックの位置を先へ進めるため、それ以降の受信メッセージの記録を妨げることはありません。 パネルでの明示的な操作や、手動で要求された履歴のスナップショットは、引き続き記録されます。

## 調査モード：チームへの参加とボットとの対話

**その他のツール → ソース → スコープ → 調査モードでは**、チームチャットに参加し、ボットを起動してそこに書き込みを行う専用 アカウントのスコープを準備します。対象は、アカウント全体、すべての ソースタイプ、自身のアクション、および表示されるすべてのチャットやボットのプロフィールと最新の 200件の表示可能なメッセージです。フォームを確認し、**「スコープを保存」**を押してください。アカウント全体への切り替えには、 通常の確認が求められます。

- **ボタン。**メッセージの下にあるボタンはメッセージと共に保持され、「**チャット**」に表示されます：リンク、Web アプリ、ログインリンク、コピー用のテキスト、コールバックデータ、インラインクエリ、電話番号や 位置情報の要求などです。 リンクはテキストとして表示され、パネルによって開かれることはありません。ボットが ボタンのみ（新しい支払いリンクなど）を変更した場合、それはメッセージの新しいバージョンとみなされ、 ライブ更新および再確認の双方において適用されます。
- **新しいチャットとボット。**フォルダモードおよびアカウント全体モードにおいて、**新しいチャットやボットが 出現すると**、出現直後に保存されます：

  - `source.profile`レコードとしてのプロファイル：ボットの説明とコマンド、ユーザー、グループ、またはチャンネルの「概要」テキスト、 メンバー、リンクされたチャット、およびTelegramが返した際の招待リンク ；
  - `new_chat` とマークされた履歴スナップショットとして、最新の表示可能なメッセージ（最大 1,000 件）を保存します。これには、 参加したばかりのチームチャットの以前のメッセージや、監視がチャットに 気付く前にボットが発信した内容などが含まれます。すでに保存済みのメッセージは重複して記録されません。

  新たに選択されたチャットは、スコープが適用された際にこれらの設定を使用します。これには、 アカウントのダイアログリストにすでに存在するチャットも含まれます。プロファイルと履歴の初期読み込みは、 最大3つのチャットで同時に実行されますが、同一チャットに対する処理は順序通りに実行されます。 各履歴／プロファイルの処理段階では、設定された操作タイムアウトが適用されるため、停止したリクエストは ワーカーを解放します。履歴は、オプションのプロファイル読み取りの前に保存されます。プロファイルの 読み取りに失敗しても、その履歴の取得は妨げられません。 失敗した段階は5秒後に再試行され、 遅延中はワーカーを占有することなく、最大5分まで再試行回数が倍増します。 保留中のID、再試行の期限、および完了した段階はローカルに保存されます。再起動時には 未完了の段階のみが再開され、プロファイルの再試行によって完了済みの履歴読み取りが繰り返されることはありません。 順番が回ってくる前に無効化されたソースはスキップされます。概要画面では、アクティブなチャット、保留中の チャット、再試行中のチャットの読み込みが、添付ファイルのダウンロードとは別に表示されます。 FloodWaitが発生するとこの処理は一時停止され、その後再開されます。失敗は記録され、チャットの リアルタイム記録は継続されます。これには、新しいチャットの IDを解決している間の待機時間も含まれます。保留中のプロファイル／履歴タスクは再試行のために保持され、既存の より長いアカウント全体の待機時間は短縮されません。ワーカーはこの待機時間を共有します。並行処理 によってTelegramのリクエスト制限が回避されることはありません。 - **オンデマンドのプロファイル。** **「チャット」→「プロフィール」→「プロフィールを保存」では**、任意のソースの現在のプロフィールを 保存できるようになり、メッセージの上部に最新のプロフィールが表示されます。 - **チャット状態のスナップショット（プレビュー）。**メッセージストリーム以外の状態は、 メッセージがなくても変化します。すべてのメッセージの固定を解除するとメッセージレベルの痕跡は残らず、管理者は 権限を失い、ギフトは非表示、変換、アップグレード、または返金されます。監視中は、有効になっている すべてのソースが定期的に読み取られ、署名付き `chat.state` レコードとして保存されます：タイトル、ユーザー名、 説明、メンバー数および管理者数、リンクされたチャット、スローモード、固定メッセージID （最大100件）、権限と肩書きを持つ管理者、およびチャンネルや ユーザープロフィールに表示されているギフト（最大100件）。 各レコードには、前回のスナップショットとの相違点が記載されています： 変更されたフィールド（変更前と変更後）、追加または削除された固定メッセージ、管理者および ギフトの追加、変更、またはリストから削除されたもの。 - Telegramが拒否する部分（例：管理者ではないメンバーの チャンネル管理者リスト）は `errors`; 以前の値は保持され、 `carried_forward`にリストされ、削除されたものとして報告されることはありません。 - 変更点がカウントのみであるレコード、および変更がないことが確認されたレコードは、 最後の完全な状態を `state_seq` および累積 `state_overrides`で参照されます。完全な状態は、 少なくとも7日ごとに、またカウント以外の何かが変更された際には常に書き込まれます。 - `parts_complete` は上限付きリストを示します。追加には以前の完全なリストが必要で、 削除には現在の完全なリストが必要であり、明示的な空の値はリストのクリアを記録します。 - **[その他のツール] → [パラメータ] → [チャット状態]** で、間隔（デフォルトは12時間、0に設定するとスナップショットが 無効になります）、ソース間の休止時間、読み込む部分、および変更が 見つからなかったチェックを記録するかどうかを設定します。 `FLOOD_WAIT` そして `FLOOD_PREMIUM_WAIT` 残りの スナップショット要求を停止し、アカウント全体の期限がまだ残っている場合はそれを保持し、 中断されたチャットは、その待機時間後に再試行が可能となります。 - **表示されません。**別のTelegramアプリで押されたインライン（コールバック）ボタン、ボットがそのような押下に対して返すポップアップや リンク、および別のアプリで使用された招待リンクは、 TgWitnessには届きません。その後、ボットが送信または編集した内容は記録されます。

### パネルからの発言

**「Chats」**には、選択したワークスペースのTelegramアカウントを使用するミニクライアントが追加されました：

- プレーンテキストのメッセージを入力するか、保存済みのメッセージの下にある**「返信」**を選択してください。送信される メッセージは、送信更新が対象範囲から除外されている場合でも記録されます。
- 「Press**」ボタンは、**現在のコールバックボタンまたはテキストボタンの下にあります。サーバーは メッセージを再度取得し、キーボード入力が保存されたバージョンと異なる場合は、その操作を拒否します。 コールバックの受信確認には、Telegramのポップアップテキスト、アラートフラグ、およびURLが保持されます。また、返信内容は 会話の下にも表示されます。URLは選択可能なテキストのままとなり、自動的に開かれることはありません。
- **「+」**を押して → **Telegramリンクを開き**、`@username`、公開`https://t.me/name`リンク、 `https://t.me/+invite` / `joinchat/invite`、または `?start=parameter` を含むボットリンクを入力し、「 **プレビューを保存**」を押します。参加前に、元のリンクとTelegramのプレビューに署名が行われます。 **参加／開いて確認すると**、グループ／チャンネルに参加するか、ユーザー／ボットが開かれ、 チャットが有効なソースとして追加され、開始パラメータを含む`/start`がボットに送信されます。 管理者の承認待ちの参加リクエストは、メンバーシップとしてではなく「保留中」として記録されます。

「**観測を開始**」をオンにすると、受信する返信をリアルタイムでキャプチャできます。パネルのアクションは、 観測が一時停止している間も機能します。パネルはその場で直接応答を保存し、ライブ 観測が会話の残りをキャプチャします。 新しく追加されたソースは、観測が実行中の場合、設定されたプロファイル/履歴の取り込みを使用します。 ソースが一時停止している場合は、「**その他のツール」→「ソース」**で有効にしてから、送信やボタンの操作を行ってください。

`interaction.preview`、`interaction.requested`、`interaction.result`は、証拠エクスポートに含まれる通常の署名付き ジャーナルイベントです。リクエストには、アカウント、メッセージ／ボタン またはプレビューレコード、および監視が実行されていたかどうかが識別されます。レシートは、成功、 拒否、承認待ち、および不明な結果を区別します。中断されたリクエストはTelegramに到達している可能性があります： 新しい操作を開始する前にチャットを確認してください。 リクエスト ID を再利用すると、 再起動後を含め、アクションを繰り返すことなく保存された受信確認を取得できます。パネルは、 現在のページセッション中に同じアクションに対して曖昧な応答があった場合でも、その ID を保持します。 また、アクションが成功した後でビューの更新に失敗した場合も、その ID を保持します。受信確認は 表示されたままとなり、再度クリックすると取得できます。 コールバックおよび参加 RPC には 1 回の 試行があります。再試行可能な読み取り操作は、設定された再試行ポリシーを維持します。チャットを切り替えると、 下書きと返信先が即座にクリアされ、新しい会話が読み込まれるまで送信が無効になります。

このミニクライアントは、テキストおよびコールバックボタンを処理します。ミニアプリケーションのボタンには**「ミニアプリを開く」**という機能があり、 これにより、アプリケーションが隔離されたブラウザ（[ミニアプリケーション](https://github.com/phishdestroy/TgWitness/blob/main/docs/MINI-APPS.md)）内で実行されます。ログイン、 電話番号や位置情報の要求、支払い、インラインクエリ、添付ファイルについては、引き続きTelegram クライアントが必要となります。これらの機能の保存済みボタンメタデータは引き続き表示されます。新しいコントロールでは英語のテキストが使用されます。

## ティアの再確認

再確認では、Telegramに対し、見逃されたメッセージ、編集内容、およびもはや返されなくなったメッセージについて再度問い合わせを行います。 星印が付いたソースは**優先**ソースであり、デフォルトでは15分ごとに再確認されます。 その他のすべてのソースは6時間ごとに再確認されます。選択されたチャットは当初から優先ソースとして扱われますが、 フォルダまたはアカウント全体から追加されたチャットは通常のソースとして扱われます。 1回のパスで再チェックされるソースは最大30個で、 残りは次の分まで待機します。再接続後は、優先ソースが先に処理されます。両方の 間隔は、**「その他のツール」→「ソース」→「記録」→「再チェック」**（0に設定するとその階層がオフになります）で設定され、 `recheck.changed`として記録されます。

見逃されたメッセージは、前回の処理が停止した地点から上流に向かって取得されます。取得上限は「 **その他のツール → パラメータ → チャットおよびパスごとの見逃されたメッセージの復元数**」（デフォルトは1,000）です。したがって、長期間の停止後、 ギャップよりも新しいライブメッセージが先に保存されていた場合でも、再チェックはギャップ全体を埋めます。 まだ追いついていないチャットは、ティア間隔を待つのではなく、次の分に再度再チェックされます。 `recheck.completed`は、処理が完了するまで`continues_after`を示します。

比較対象には、メッセージ本文、エンティティ、キーボード入力（削除を含む）、および添付ファイルの 内容・識別情報が含まれます。 ファイルへのアクセスハッシュやファイル参照のみを変更しても、 編集とはみなされません。また、Telegramが自動的に入力する項目（リンクプレビューの読み込み、ストーリーの閲覧、このアカウントによってロック解除された有料 メディア、請求書の受領など）も編集とはみなされません。「チャット」に保存された各バージョンは、メディアのメタデータを含む完全なジャーナル記録にリンクされています。

## メッセージ履歴と出典情報

例えば、コレクターが「10:00に会議」という記録を検知し、その後「11:00に会議」という記録を確認し、 さらに削除通知を受け取ったとします。この場合、3つの異なる記録が追加されます。 元のテキストは残され、編集後の内容は別のバージョンとして扱われ、通知には 削除が検知されたことが記録されます。

最初のバージョンが消えた後に収集が開始された場合、そのテキストは利用できません。 プロセスがオフラインの間に複数の編集が行われた場合、その後確認された バージョンのみが保存されます。削除通知では、一度もキャプチャされなかったコンテンツを復元することはできません。

この記録は、以下の複数の情報源を組み合わせています：

| 出典 | 保持される情報 |
| --- | --- |
| ライブメッセージまたは編集更新 | メッセージID、送信者のメタデータ、キャプチャされたバージョン、受信時刻、および提供されたTelegramメッセージ／編集日時。 |
| 削除のリアルタイム通知 | 報告されたメッセージID、受信時刻、生の通知、および以前に保存されたコンテンツへのリンク。 |
| 利用可能な管理ログ | アクション、アクター、送信日時、および送信されたメッセージの内容。これらは、必要な権限を持つアカウントによって読み取られます。 |
| パネル操作 | 選択されたアカウントにおける、要求されたアクションとその記録された結果。 |
| 再確認 | Telegramの現在の応答と、以前に保存されたメッセージとの比較。 |

`observed_at` これは、レコードがコレクタクロック上で書き込まれた時刻であり、 次のように増加します `seq`とともに増加します。ライブ更新の処理中に書き込まれたレコードには、 `received_at`、つまり更新がコレクターに到達した時刻、および `processing_delay_ms`、受信から書き込みまでの時間が付加されます。観測開始時に保留されていた 更新は、それより後のものよりも先に、到着順に処理されます。 `source_at` は、そのイベントがソース日時を提供している場合に、それを保持します。テレグラムのクロックオフセット観測、 クロック不連続性レコード、[および外部時刻チェックは、](https://phishdestroy.io/tgwitness/ja/docs/reference/timestamp/) 関連するタイミングコンテキストを提供します。通常のメッセージ通知のフィールドは その通知を記述しており、管理ログおよびインタラクションレコードは独自の属性情報を保持します。

## 履歴のスナップショット

スナップショットは、有効化されたソースから最新の表示可能なメッセージをリクエストするもので、1回のリクエストにつき最大 500件まで取得できます。結果は「履歴観測」としてラベル付けされます。手動によるスナップショットは 観測と並行して実行されます。繰り返される観測は 個別の記録として保持されます。ソースを有効にすると、 [「厳格なチャット選択」](https://phishdestroy.io/tgwitness/ja/docs/reference/collection/#strict-chosen-chats)がオンになっていない限り、そのソースの`baseline`スナップショットが1回取得されます。

読み取り中にソースが無効化されると、スナップショットは停止します。返信は、 要求されたチャットに属し、かつ要求された 境界より下で、厳密に降順となる正のメッセージIDを含むものでなければなりません。無効な返信があると、そのメッセージが保存される前にスナップショットが中断されます。 すでに保存済みのメッセージは、中断記録とともに署名付きジャーナルに残ります。

スナップショットは添付ファイルポリシーに従いますが、ライブイベントの切り替えとは別個に処理されます。 削除されたメッセージや見逃された中間バージョンを復元することはありません。 一時停止中にスナップショットをリクエストできますが、キューに入れられた添付ファイルは、監視が開始され、 ダウンロードワーカーが実行されるまで待機します。

**履歴**の実行は独立した排他タスクです。監視を開始せず、選択した取得元の読み取りと待機中の添付ファイルのダウンロードを順番に行います。一時停止するとアカウントを解放し、再開すると保存した処理を続けます。複数の空きアカウントでの日付・言語・返信フィルターについては、[分散チャットエクスポート](https://github.com/phishdestroy/TgWitness/blob/main/docs/DISTRIBUTED-EXPORT.md)をご覧ください。

## 添付ファイルの取り扱い

添付ファイルのダウンロードはデフォルトで有効になっており、空きディスク容量が1 GiB未満になると一時停止します。コレクターは、 メッセージの監視とダウンロードのジョブを同時に実行します。このジョブは元のメディア 記述子とサイズポリシーを維持するため、後から編集された添付ファイルが黙って置き換えられることはありません。

ダウンロードはメッセージのキャプチャ後に実行されます。ダウンロードが完了すると、SHA-256 値とバイト数を伴う`media.saved` レコードが作成されます。スキップ、失敗、再試行、および中断された 処理にはそれぞれ異なる結果が割り当てられます。ファイルは、その`media.saved` レコードが存在する場合に保存済みとみなされます。 また、完了したファイルは、元の観測された添付ファイル 記述子に記載されたバイト数と一致している必要があります。短すぎる、または予期せず長い応答は、保存済みメディアとして記録されません。

`media.saved`が書き込まれる前に、ファイルとそのフォルダエントリがディスクにフラッシュされます。前のコレクタ プロセスが正常に停止せずに終了した場合、次回の起動時に、その実行中に「保存済み」として記録されたすべてのファイルが読み込まれます。 ファイルが 欠落している場合、またはそのバイト内容が記録されたSHA-256と異なる場合、そのファイルには`media.missing_after_restart`レコードが作成され、その ダウンロードは再度キューに入れられ、バイト内容が異なるファイルは`media-damaged/`に移動されます。オフサイトストレージに移動されたファイルは 読み込まれません。

1つのワークスペース内では、同じ添付ファイル表現に対してキューに入れられた並行ジョブは、 アクティブな転送を待機し、再利用する前に保存されたバイトを再確認します。各ジョブは、 独自の符号付き結果と、以前に保存されたファイルレコードへの参照を保持します。待機中の ジョブをキャンセルしても、アクティブな転送はキャンセルされません。その転送が失敗したりキャンセルされたりした場合、 次のジョブが再試行できます。異なる添付ファイルは並行してダウンロードできます。

同じアカウント、表現、予想サイズ、およびキャプチャアクションを持つジョブは、 一致するジョブが1つ実行中の間、キューに残ります。これらはダウンロードスロットを占有しないため、 キューの先頭に処理に時間がかかるファイルのコピーが多数あっても、他のファイルのダウンロードを開始することができます。 試行が完了すると、キューが再開されます。優先レーン、保存された再試行遅延、および 履歴の所有権は引き続き適用され、各観測には独自の結果が割り当てられます。

チャットのエクスポート機能では、同じエクスポートディレクトリ内でのファイルの再表示に際し、 アクティブな転送も共有されます。各メッセージは添付ファイルへの参照を保持しており、再利用には 新たなサイズ確認とSHA-256チェックが必要です。共通の転送ロックを保持することなく、 異なるファイルを並行してチェックすることができます。一時的なダウンロードおよびコピーパスは 各操作ごとに一意であり、キャンセル時には、クリーンアップを行う前に、アクティブなローカルファイルリーダーがすべて終了するのを待ちます。 エクスポートファイルインデックスは、メタデータへのアクセスのみをシリアライズし、ファイルのハッシュ計算やダウンロードは行いません。

異なる添付ファイルに対するサーバー側のハッシュ読み取りも並行して実行され、クライアントの 3つのファイルリクエストスロットをバイト単位のダウンロードと共有します。同じ表現に対する繰り返し読み取りでは、 キャッシュされた完全な結果のみが再利用されます。ファイルの読み取りは通常のリクエストキューを空けたままにし、 リクエストがスロットを取得した際に、保存されていたFloodWaitの期限が再度チェックされます。

制限は、写真、動画、GIFおよびアニメーション、ラウンド動画メッセージ、 音声メッセージ、音楽およびオーディオ、ステッカー、ファイルといった**種類ごとに**設定されています。 各タイプは個別に無効化可能で、 1～2,000 MiBの範囲で独自のサイズ制限が設定されています。新しいワークスペースでは、写真用が20 MiB、 動画用が100 MiB、ファイル・音声・ラウンド動画用が50 MiB、音声およびGIF用が20 MiB、 ステッカーは5 MiBとなります。新しいワークスペースでは、GIFとステッカーは有効に設定されるまで無効のままとなります。タイプごとの制限が導入される前にポリシーが保存されたワークスペースでは、すべてのタイプが有効なままとなり、すべてのタイプに対して単一の 制限が維持されます。*最大ファイルサイズ*を設定すると、すべてのタイプが一括して設定されます。 無効化されたタイプでは `media.skipped`レコードが生成され、サイズ不明または上限を超えるファイルはダウンロードされません。大容量ファイルの ダウンロード時間は、そのサイズと256 KiB/sという基準速度に基づいて追加で割り当てられます。ジョブは 再起動後も存続しますが、有効期限が切れた参照、アクセス不能、または削除されたファイルによって、復元が妨げられる可能性があります。 待機中のジョブは、そのジョブに保存された制限値を維持するため、制限値の引き上げは新しいファイルにのみ適用されます。 タイプを無効にしたり、その制限値を引き下げたりすると、除外対象となる待機中のファイルもスキップされ、それぞれに `media.skipped`レコードが生成されます。ダウンロードを無効にすると、再度有効になるまでキューは一時停止されます。

## 一時停止、ロック、切断、再起動

| 動作または状態 | 効果 |
| --- | --- |
| ワークスペースを切り替える | パネル表示を変更します。その他のコレクターは状態を維持します。 |
| パネルをロックするか、タブを閉じてください | サーバーと監視機能は稼働したままとなります。 |
| 観察の一時停止 | そのコレクターを停止し、キューに格納されている添付ファイルの処理を保持します。 |
| ソースを無効にする | 今後のスコープ指定によるキャプチャを停止します。無効化されている間、それに関連するキューに登録されたメディア処理ジョブは待機状態となります。 |
| 出典を削除する | 情報源として認識されず、ユーザープロフィールは削除されますが、すでに保存された記録は追記専用ジャーナルに残ります。まだ処理待ちの添付ファイルは、失敗（`source_removed`）として記録されます。フォルダモードおよびアカウント全体モードでも、これらは除外されます。 |
| 接続経路を変更する | 一時停止が必要となり、古いクライアントを終了し、未完了のログインをキャンセルします。 |
| Pythonプロセスを停止する | すべてのワークスペースを停止します。オフライン中は、いかなる観測も行われません。 |
| アクティブな監視終了後に再起動します | 保存されたセッションを使用して、保存された範囲の再開を試みます。手動で一時停止すると、その意図は解除されます。 |

コレクターは、検出された接続切断、再試行、エラー、起動／停止、および ハートビートを記録します。短時間の中断は、定期的な接続チェックでは検出されない場合があります。 再起動後、見逃された更新は保存された更新位置から要求され、 監視対象のチャットは定期的に再チェックされます。[証拠形式を](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#durable-collection-and-process-receipts-02)参照してください。スナップショットは現在の状態を コンテキストとして追加し、その間のギャップは記録されたままとなります。

## アカウントの分離と検証

各ワークスペースには、独自のジャーナル、認証、署名鍵、ポリシー、およびキューがあります。 そのワークスペースのアクティブなクライアントのみが、リアルタイムの観測データを記録できます。拒否されたクライアント、保留中のクライアント、 置き換えられたクライアント、および接続テスト中のクライアントは、そのジャーナルにリアルタイムの更新を書き込むことはできません。 異なるアカウントが同じグループを監視することは可能ですが、それぞれのジャーナルは独立したままです。

各イベントには、前回のハッシュ値とEd25519署名が含まれます。エクスポート対象は、 固定のシーケンス番号を通じてワークスペースのジャーナル全体を網羅します。パネルフィルターは エクスポート内容をフィルタリングしません。エクスポートの準備が行われている間も、その範囲を超えて収集が継続される場合があります。

**「ジャーナルの検証」機能は、**表示された 境界を通じてイベントの連鎖と署名を検証します。ワークスペースが変更されると結果はクリアされ、パネルには 検証後に追加された新しい記録が表示されます。ZIP形式でのエクスポートでは、収集されたメディアの検証も行われます。

フィンガープリントとチェックポイントは個別に保持してください。各モードにおける取得チェックについては「 [検証範囲](https://phishdestroy.io/tgwitness/ja/docs/reference/evidence/#verification-scope)」を、 日常的な収集については「[日常業務](https://phishdestroy.io/tgwitness/ja/docs/reference/operations/)」を参照してください。
