TgWitness / 文档

已测试的内容 →

参考 / 收集

Telegram · 加载源代码历史记录

从已启用的来源加载历史消息,暂停和恢复操作,并验证带签名的进度报告。

TgWitness / 文档 · 收藏集

集合

在更多工具→数据源→范围内的聊天中,查看已启用的聊天,选择“标准 API”或 “Takeout 导出”,然后选择加载完整历史记录。该操作会修正该数据源列表,并将其中可用的历史消息 读入“聊天”和已签名的观察日志中。媒体内容将使用现有的附件 设置和持久化下载队列。这与按聊天进行的已签名 JSON/HTML 导出是分开的。

若要进行全账户范围的收集,请选择“整个账户 ”并保存该范围。历史记录 会在签署其源 列表之前刷新所有可访问的对话框,包括已归档的聊天记录。此发现过程不受“已选聊天”选择器列表限制的约束。随后发现的 聊天记录将被监视,并获取其配置的初始快照;再次执行完整运行可 加载其早期历史记录。请保持在历史记录加载期间及之后保持监视选项 启用,以便在历史记录加载时记录新消息、编辑和删除通知。 每次历史记录运行或导出都会占用一个采集槽;实时监视则与其并行运行。

选择一到三个并发聊天、一到五个附件处理器,并决定是否保留可用的“最近操作” 以及是否比较先前保存的版本。在 Telegram 中,数据导出可能需要获得批准,并需 等待服务器指定的时间。这些选项在恢复时保持不变。有关传输、重试和信任的详细信息,请参阅补全行为和 证据合约。

暂停、重启和部分结果#

  • 暂停历史记录将停止读取。继续历史记录将从每个来源中最后一条已提交的 消息开始恢复;重新启动应用也会使运行状态保持暂停,直至恢复。 恢复时需要使用同一闲置的 Telegram 账户。
  • 消息观察、附件处理和光标提交在一笔事务中完成。 恢复运行时不会重复已提交的观察结果。实时捕获或 单独、显式启动的运行可独立观察同一条消息。
  • 每个数据源(Takeout 中的每个 Telegram 拆分范围)在首次读取时会固定一个最高消息 ID。较新的消息属于 实时观察,而不属于该数据源剩余的历史页面。
  • 无法访问的来源以及在采集过程中被禁用的来源仍会显示为 “失败”或“跳过”。其他来源将继续采集;最终结果将不完整。
  • Telegram 仅向群组管理员显示聊天记录的管理员日志。对于普通成员, 读取管理员日志的操作会被记录为 `history.admin_log.unavailable`,reason: not_admin, 且不会导致历史记录不完整;而管理员读取管理员日志失败时,则会导致历史记录不完整。
  • FloodWait 的延迟会遵循已保存的账户退避策略。对于瞬时故障,最多重试 五次;资源耗尽或磁盘空间不足时,操作将暂停,光标位置保持不变。
  • 结束本次历史运行会保留已保存的观察结果。该操作不会删除这些观察结果,也不会 取消标准 API 附件任务。结束Takeout会将其剩余的Takeout 文件标记为已跳过;暂停则会保留其可恢复状态。新运行会重新读取已启用的来源。

历史记录补全仅指历史记录的读取操作。附件可能仍处于待处理状态、 处理失败,或被配置的策略排除。请在日志 和附件队列中检查媒体回执;只有字节数据完整且已保存的回执才构成 已保存的附件。历史记录操作是一项显式的快照请求,与 用于选择未来实时事件类别的开关独立。

传输与验证#

保存已签名的进度报告,然后使用“导出证据”功能下载 日志和已保存的附件。后续的证据导出可能包含额外记录; 该报告将其计数器与创建时的日志前缀绑定。 请从此版本的可信代码检出中运行验证器:

python tgwitness/verify.py tgwitness-history-report.json --evidence evidence.zip --fingerprint TRUSTED_FINGERPRINT

请将预期的签名密钥指纹单独保留。验证器会检查 报告签名、证据存档、报告检查点、源计划、账户 以及已保存/不可用消息的计数。新运行还会将源进度和 选项绑定到已签名的光标事件中。若未指定--evidence,则仅检查 已签名的报告及其内部一致性。旧版进度字段和附件 摘要仍为已签名的收集器声明。证据验证器会检查存档的媒体字节。

读取经过验证的历史记录及其采集间隔、覆盖范围和 可用的“最近操作”。此工作流读取当前可访问的历史记录; 实时监控会在版本 生成时保留版本及通知,而秘密聊天则使用 已启用的端点集成。进行验证时,请使用保留的检查点、 见证记录以及 验证模式中所述的适用采集证明。

采集光标代表本地工作区的状态。仅恢复证据 ZIP 文件并 不会恢复待处理的采集任务或 Telegram 会话。若需继续执行原始任务, 请保留工作区备份。