# Telegram · 加载源代码历史记录

Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/history/

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

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

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

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

[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)

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

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

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

## 暂停、重启和部分结果

- **暂停历史记录**将停止读取。**继续历史记录**将从每个来源中最后一条已提交的 消息开始恢复；重新启动应用也会使运行状态保持暂停，直至恢复。 恢复时需要使用同一闲置的 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`，则仅检查 已签名的报告及其内部一致性。旧版进度字段和附件 摘要仍为已签名的收集器声明。证据验证器会检查存档的媒体字节。

读取经过验证的历史记录及其采集间隔、覆盖范围和 可用的“最近操作”。此工作流读取当前可访问的历史记录； [实时监控](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#message-history-and-attribution)会在版本 生成时保留版本及通知，而[秘密聊天](https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/)则使用 已启用的端点集成。进行验证时，请使用保留的检查点、 见证记录以及 [验证模式中](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#verification-scope)所述的适用采集证明。

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