加载源代码历史记录

当前主分支：可从源代码获取；未包含在 0.7.0 便携版预览版中。

在“来源”中，查看已启用的聊天，开始监控，然后选择“加载完整 历史记录”。该操作会锁定该来源列表，并将可用的历史消息 读取到“聊天”和已签名的监控日志中。媒体文件将使用现有的附件 设置和持久化下载队列。这与按聊天生成的已签名 JSON/HTML 导出文件是分开的。

若需收集整个账户的数据，请选择“整个账户”，开始监控以加载其 来源列表，并在开始记录历史记录前审查该列表。对话列表的限制仍 适用（默认1,000条，可在“参数”中调整）。 运行成功并不意味着 每个账户的对话都已列入列表。后续发现或启用的聊天需要再次运行。

暂停、重启和部分结果#

• 暂停操作将停止读取历史记录。继续操作将从每个来源中最后一条已提交的 消息开始恢复；重新启动应用后，运行状态也将保持暂停，直至手动恢复。 请先重新启动监控。恢复操作需要使用相同的 Telegram 账户。
• 消息观察、附件处理和光标提交在一笔事务中完成。 恢复运行时不会重复已提交的观察结果。实时捕获或 单独、显式启动的运行可独立观察同一条消息。
• 每个数据源在首次读取时会设定一个消息 ID 上限。较新的消息属于 实时监控，而不属于该数据源剩余的历史页面。
• 无法访问的来源以及在采集过程中被禁用的来源仍会显示为 “失败”或“跳过”。其他来源将继续采集；最终结果将不完整。
• FloodWait 会遵循已保存的账户回退策略。传输超时和磁盘空间不足 将暂停运行，同时保持光标位置不变。解决原因后可恢复运行。
• 结束本次历史记录运行将保留已保存的观察结果。此操作不会删除这些观察结果，也不会 取消已排入队列的附件下载。新一轮运行将重新读取已启用的消息源。

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

传输与验证#

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

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

请独立保存预期的签名密钥指纹。验证器将检查 报告签名、证据存档、报告检查点、来源计划、账户 以及已保存/不可用消息的数量。若未使用--evidence，则仅检查 已签名的报告及其内部一致性。 进度阶段、标题、光标位置及 附件摘要均为经签名的采集声明，并非由本报告验证器 独立重建。证据验证器仍需对归档的媒体数据字节进行核查。

无论是对可用历史记录进行签名还是完成签名，均不能证明其源自 Telegram、属于原子 快照，或具有历史完整性。消息在阅读过程中可能会发生变化；已删除的 消息、未被察觉的中间编辑以及秘密聊天内容均无法恢复。控制签名密钥的操作员 可在外部承诺存在之前伪造日志。 请使用单独保留的检查点或独立见证人来验证所记录的 防篡改特性。

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