本页面部分内容仍为英文:英文原文在翻译后发生了变更。
参考 / 证据
Telegram · 账户导出
导出该账户当前可读取的内容:范围、可恢复的任务、经签名的存档以及已缩减的共享副本。
导出账户会保留该账户的采集槽位。在归档文件被检索、下载、验证和打包期间, 实时观测仍可继续进行。 在启动另一个采集任务之前,请先暂停其他历史数据或导出任务。 暂停归档任务时,观测仍会继续运行;而暂停观测时,归档任务将保持运行状态。
不同账户的导出任务可以同时运行。仅限导出的任务在等待 审批期间会释放其账户,因此,在审批待定期间,另一个常规会话导出任务可以 开始运行。而正在进行的采集任务仍会保留该账户。
作为安装管理员,请选择主页→导出我的账户,或导出→Telegram 账户→配置账户导出。 如有需要请登录,审查权限范围,并明确启动导出。无需持续进行观测。“已保存的观测结果”是对现有日志的单独导出;其 ZIP 文件包含所有源数据,不受日志过滤器限制。每个工作区都有独立的任务、签名身份和存储空间。已授予的控制面板访问权限(包括无限制的普通导出权限)无法访问这些全账户范围的路径。
“按发件人或消息文本过滤”下可展开发件人和文本过滤器。“账户数据与连接方式”包含可选的账户分类以及“Takeout”与“常规会话”选项;其摘要会显示当前选中的选项,即使关闭后依然可见。关闭这些部分后,其设置将得以保留。在切换视图时,导出和报告草稿仍保留在当前面板会话中;重载浏览器后,这些草稿不会被保存。无论选择哪种导出方式,均可访问现有任务。
此工作流将导出当前已连接账户可访问的数据。默认的“自动”方法首先运行 Telegram Takeout,该操作会返回当前状态下可访问的历史记录,包括已退出的频道、已保存的联系人及其他账户数据。如果 Telegram 在 Takeout 开始前设置了等待期,“自动”模式会立即转入常规会话;日志会记录 account_export.transport ,而签名清单会标明所用方法,并将该变更列为遗漏项。Telegram Takeout会话仅等待批准,而“常规会话”则永远不会请求Takeout。秘密聊天由“秘密聊天”模块实时记录,编辑操作则通过实时观察记录。常规会话的覆盖范围不同,并会记录不受支持的类别。
主页 → 导出全部将启动导出操作,涵盖所有聊天类型、所有附件类型、个人资料、联系人、头像、动态、会话元数据及其他账户数据,并以所有格式导出:带签名的 TgWitness 归档文件,以及 Telegram Desktop 的 JSON 和 HTML 视图。选择选择要导出的内容将打开下方表单,其中默认设置与上述相同。
Takeout 是 Telegram Desktop 也使用的官方导出 API。TgWitness 可以 直接从其自身的采集数据中写入与 Desktop 兼容的 JSON;无需导入他人的 存档。两种传输方式均可获取聊天和消息 ID。 导出速度和 Takeout 的审批延迟取决于 Telegram 对该账户的限制, 以及聊天是否为公开或可转发。在比较速度之前,请先测量相同范围和媒体设置下的情况。
对于最多20个明确选定的聊天ID,常规API导出会在考虑该账户完整的对话列表之前
直接解析这些对等方。因此,即使该公共频道未出现在对话列表中,
也可以在无需加入该频道的情况下将其导出。 未缓存的对等方将回退到普通对话列表。
归档过滤器仍会生效:如果 Telegram 未返回某个对话,且已归档
的聊天被排除在外,则未知归档状态将被记录为遗漏。
Takeout 保留其分段范围对话列表处理流程。两种路径均不会加入聊天或
更改转发权限。
在与桌面版兼容的 JSON 中,Telegram 标记为 left 的频道将显示在
left_chats 下,包括该账户尚未加入的可读公共频道。
FLOOD_WAIT和FLOOD_PREMIUM_WAIT都会在服务器要求的整个
时段内暂停请求。该账户的截止时间在重新连接和重启后仍会保留;后续设置的
较短等待时间无法缩短该截止时间。重试次数受限,取消操作会保留已密封的页面,
且 API 凭据不会轮换以绕过速率限制。不会进行任何 Premium 购买。
选择要收集的内容#
| 设置 | 含义 |
|---|---|
| 目的 | 请记录此次收购的必要性。请勿在此处填写不必要的姓名或敏感的案件细节。 |
| 报告语言 | 选择可读报告中标签的语言。原始消息文本保持不变;未翻译的模板标签使用英语。该语言通过已签名的任务选项固定。 |
| 聊天类型 / 聊天 ID | 可选择所有类型,或仅选择列出的聊天;“已保存的消息”属于私人聊天。已归档的聊天可单独选择。 |
| 日期 | UTC。面板中的“起始”和“截止”日历日期均包含在内。该 API 使用包含起始日期的 from_utc 和排他 to_utc;面板会发送“截止”日期之后的第一天。若边界为空,则该侧不受限制。 |
| 发送者 ID | 仅显示所列发件人的消息;若列表为空,则包含所有发件人的消息。 |
| 文本包含 | 不区分大小写的字面短语,通过“OR”进行匹配。发件人/日期/自有消息条件则通过“AND”进行组合。 |
| 自己的消息 | 仅保留发送的消息。 |
| 媒体类型 | 选择附件类别,或清除所有选项以避免下载消息文件。 |
| 文件/媒体总量限制 | 按文件计算的 MiB 以及已下载媒体的总容量(GiB)。文本、收据、可读报告以及 ZIP 占用的空间需要额外的磁盘空间。 |
| 账户分类 | 个人资料、联系人、头像、动态、会话元数据及其他 Takeout 数据均设有独立的控制选项。 |
“最小化”集合预设会禁用文件和账户元数据。发送者/内容过滤器会在保留的消息页面和媒体下载之前生效。Telegram 仍会传输包含评估这些过滤器所需消息的 API 历史记录页面:过滤并不保证未选中的消息绝不会进入进程内存。工作区中的其他持续监控项目拥有各自的范围和保留设置。
个人资料照片历史记录、故事、会话元数据及其他账户数据默认被选中。若案件仅需消息内容,请禁用这些选项,并排除个人资料和联系人。若附件或元数据非必需,在采集过程中将其排除可避免在本次导出中保留另一份私有副本。
照片有效载荷采用其元数据和哈希清单中标识的静态图像变体,包括带有动画头像变体的照片。该动画不会替代所选的静态图像。比观察到的大小更短或更长的有效载荷将被记录为附件失败,而在文件引用更新期间发生表示形式变更的情况将被拒绝。这些失败会导致存档不完整,但会保留消息记录。 独立验证还会拒绝那些签名长度与其实际大小或表示形式不符的已保存附件,包括旧存档中的附件。
如果专用媒体连接暂时出现故障,附件读取操作将使用 标准文件连接。一分钟后,系统将在后台重试专用连接, 同时下载操作将继续进行。此恢复机制会保留已配置的 连接限制,并针对每个数据中心分别应用。Telegram 洪水 等待和授权失败仍会传播。
消息编号和活动地图#
每个账户存档包含 message-gaps.json 以及 map.html。频道和超级群组按聊天对消息进行编号,因此从第一条导出消息到最后一条导出消息之间缺失的每个编号,都代表该聊天中的一条消息。 私聊、机器人和基础群组在整个账户中共享一个编号序列:该处缺失的编号原本属于某个聊天。当导出的回复或置顶消息指向该编号时,即可确定其所属聊天;否则,将根据相邻消息之间活跃的聊天进行推算,剩余部分则归因于未包含在导出中的聊天。 每次运行都会包含其时间窗口、相邻消息、每个聊天群组的数据份额以及一个置信度标签。会明确限定分析范围(过滤器、未选中的聊天群组),因为若不限定范围,缺失的编号将包含选定范围之外的消息。
map.html 显示日历、随时间变化的聊天记录,以及按工作日和小时划分的消息和缺失号码网格,并附有每个聊天记录的表格及最长连续记录。聊天页面显示其专属日历、群组中随时间变化的参与者列表,并在聊天记录中用标记标注消息缺失的位置。 verify.py 重新计算 message-gaps.json 基于已签名的页面,并拒绝已更改的文件。
活动地图列出了最大的频道和超级群组缺口,包括其 号码范围及相邻消息的时间。打开某个范围即可跳转至分页记录中 标记的位置。这些标记记录了已保存的相邻号码之间 缺失的号码;删除事件、其时间及消息内容仅来自 已保存的记录。在小屏幕上,宽表可在其卡片内滚动。
长记录包含一个页面索引,其中列出了消息日期范围和日历。 选择一个月份,即可按捕获页面的顺序打开该月份的第一条记录。月份计数基于 记录的消息日期(UTC);未标注日期的记录仍保留在记录中。页面 导航包括首页、末页和相邻页面,并可直接打开消息 部分。该索引无需 JavaScript 即可在离线状态下使用。
简历、报道范围与验证#
每个任务都会锁定其选项和账户身份。清单和捕获的页面均经过签名;页面收据记录了哈希值、光标位置、时间、附件结果及其前一个收据。只有已提交的页面才会推进进度。重启/恢复操作会在继续之前检查这些记录。若账户发生变更、已签名页面发生变更或收据链不一致,则会被拒绝。在捕获过程中无法编辑选项:如需处理其他范围的内容,请启动另一个任务。
“暂停”会中止正在运行的账户操作。重新启动应用程序后,未完成的工作仍可被显式恢复。过期的 Takeout 会话需要显式恢复;更改 Telegram 分段范围可能需要重新进行数据采集。恢复操作会保留之前的观察结果,因此长时间运行的导出并非单个原子快照。在数据采集期间,其他账户切换操作和冲突的导出操作将被阻止。请等待打包完成后再删除工作区。
“恢复”选项会立即显示正在验证已保存的导出数据……,并在联系 Telegram 之前在后台检查已保存的内容。验证期间,该面板仍可正常使用。“暂停”选项会等待验证进程安全完成后再释放账户;即使在启动或恢复后立即点击该选项,它也能正常工作。在存储速度较慢的情况下,等待时间可能会较长。如果完整性检查失败,系统会生成一个带有说明的失败任务,并保留其文件。
如果 Telegram 在进行库存、历史记录或附件获取过程中终止了该账户的授权,任务将暂停,且不会将未完成的页面标记为已完成。请重新连接同一账户并恢复任务,以从上次保存的页面继续。不可用的消息占位符会推进历史记录光标,但不会结束阅读:系统仍会请求较早的可用消息,且占位符不会被视为已捕获的消息或已确认删除的消息。
The panel distinguishes a completed selected scope from a partial archive, and records omissions and failed reads. How the report shows coverage, gaps and missing message numbers: Coverage and missing material. Deliberately excluded files are different from failed or unavailable files. Inspect coverage even when integrity verification succeeds. No local reader can prove Telegram returned every message that ever existed.
已完成的 ZIP 文件仍可供重复下载和 HTTP 范围下载。一个账户归档包含 manifest.json、manifest.sig、已签名的 job.json、inventory.json、receipts/、权威 data/*.jsonl、选定的 media/、可读 HTML 以及一个验证器。通过独立渠道固定收集器的指纹,然后使用可信安装进行验证。 控制面板将归档文件保存为 tgwitness-account-export-EXPORT_ID.zip;密封捕获则将其作为 account-export.zip 包含在其证据归档中。请使用您手头的文件名:
python -m tgwitness.verify tgwitness-account-export-EXPORT_ID.zip --fingerprint TRUSTED_SHA256
对于展开后内容超过 4 GiB 的存档,请显式设置适当的 --max-gib。该面板通过声明的展开大小和已发布的ZIP摘要来验证其经过认证且完整的本地存档;外部命令行界面(CLI)则保持其独立的大小限制。在打开可读的 HTML 文件之前请先进行验证。虽然存档中捆绑的验证器很方便,但使用独立获取的验证器可以避免信任随证据一起提供的可执行代码。
Ed25519 签名和 SHA-256 哈希值用于检测收集器提交相关字节后的变更。请结合记录的收集范围、采集间隔、外部时间戳收据以及所选部署可用的来源验证结果,共同审查该结果。后续观察结果将单独记录,并保留先前捕获的版本。
为律师或其他收件人准备一份披露文件#
下载完成的导出文件后,请保留原始的 ZIP,并从 index.html
解压后的副本。该报告说明了其范围、可用覆盖范围和
限制。其记录引用结合了存档引用、文档路径和
记录编号,因此收件人可以在 HTML 或打印件中找到相同的条目。
有关实际示例,请参见 打开虚构报告。
在完成的账户导出中,选择“准备共享副本”。这将生成一个独立的、经过签名的衍生副本。源文件 ZIP 保持不变且为私有;除非收件人被授权接收其完整内容,否则请勿将其与经过简化的衍生副本一同发送。请单独选择其报告语言。更改语言或任何选择设置后,在创建前需要再次预览。
- 输入披露目的,并选择日期、发送者 ID 以及文本内容条件。
- 您可以选择保留真实身份、仅显示列出的参与者,或对所有人进行化名处理。在任何化名模式下,聊天 ID/标题和消息 ID 也会被替换。化名在同一份披露文件内保持不变,但在独立准备的披露文件之间会发生变化。
- 可保留消息正文、完全省略,或添加具体名称/短语进行屏蔽。在私密模式下,该工具还会屏蔽已知的隐藏发件人名称和别名、完整令牌形式的发件人 ID、私聊昵称、链接、电子邮箱地址以及类似电话号码的字符串。已知名称匹配功能支持 Unicode 大小写转换,包括
Straße/STRASSE。通用群组/频道名称不会自动从消息文本中移除。若已知身份屏蔽限制被超过,请缩小源导出范围或省略文本;该工具不会默认跳过后续的名称。这些规则仅为尽力而为,并非普遍的匿名化处理。 - 除非收件人需要,否则请勿包含文件。包含的原始文件将保留其像素、音频、文本和元数据。该工具不会对这些文件进行匿名化处理。
- 预览计数、警告和转换后的消息示例,然后明确确认创建。示例限制为每条消息 12 条,每条文本长度不超过 2,000 个字符。这仅为示例,并非对结果的完整审查。更改设置需要再次预览。预览在 15 分钟后失效,且与该管理员会话及原始的 ZIP 严格绑定;创建后无法重复使用。新的预览将使同一任务和会话中的先前预览失效。
- 查看生成的完整
index.html并messages.jsonl在本地进行检查。若发现其中包含不必要的信息,请创建一份新的披露文件并设置更严格的排除条款。请勿直接编辑已签名的ZIP。
筛选后未包含的消息#
预览。当披露内容不完整时,其显示效果也会不完整。在每个包含至少一条已披露消息的聊天中,选定范围未包含的消息会以标记形式显示, [withheld by selection — rule: sender] (或 text, period)。选择“被选定范围排除的消息”:每组连续被排除的消息显示一个标记(默认),或每条消息显示一个标记。标记仅包含规则和计数,绝不包含文本、发件人、日期或文件。未披露任何内容的聊天将被完全排除,因此该软件包不会透露其存在。
已披露的回复会说明其回复对象:是本副本中包含的消息、被筛选排除的消息,还是源导出中不存在的消息(在导出前已被删除或从未被导出;导出数据无法区分这两种情况)。 被披露回复所回应的被屏蔽消息始终带有独立标记,因此该回复会指向一条解释其为何为空的记录。这三种状态有别于删除和数据缺失,后者属于源导出数据本身。
在 messages.jsonl (格式 tgwitness-account-disclosure-v2)中,每条消息包含 state: disclosed,或 withheld 带有 rules 和 count。已披露的回复包含 reply_to 与目标 id 和 state (disclosed, withheld, not_in_source)。清单统计了已公开的消息、聊天、媒体和 withheld 消息。 verify.py 会拒绝携带内容的标记,以及指向包中缺失记录的回复;版本 1 的包仍按原有方式进行验证。
精简格式省略了结构化的账户资料、联系人、头像、会话、故事、原始 Telegram 对象、转发头信息、回复引用、联系人卡片和位置元数据。它不包含原始 JSONL 文件、私有过滤器设置、化名密钥和身份映射。选中的文本、明确保留的身份信息以及包含的文件仍可能包含与这些过滤器中相同的名称、ID 或短语;这些内容需要单独审查。 隐私策略和化名密钥以加密形式保存在该任务的本地保险库中;删除任务将清除其关联的隐私披露记录。公共策略记录的是过滤器计数而非过滤器值。声明的目的在清单和 HTML 中是公开的:明确的隐私标准以及在化名模式下已知的隐藏身份也会被遮蔽,包括在省略消息文本的情况下。请确保目的陈述中不包含不必要的个人细节;未知的身份识别上下文可以保留。
其清单包含派生文件、公开政策以及原始 ZIP 文件的哈希值。通过验证可以确认文件的完整性;如果本地提供了源文件,还可以验证源文件的关联性。该面板将共享副本保存为 tgwitness-disclosure-DISCLOSURE_ID.zip:
python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256
python -m tgwitness.verify tgwitness-disclosure-DISCLOSURE_ID.zip --fingerprint TRUSTED_SHA256 --evidence tgwitness-account-export-EXPORT_ID.zip
来源链接表明披露内容来自哪个存档和哪个采集器密钥。披露仅包含所选内容;请对照原始导出检查所选范围以及可识别细节的移除情况。
共享与托管捕获#
选择收件人所需的消息和文件,审查完整的共享副本,并将源文件单独保留。记录已发送 ZIP 文件的哈希值,以便收件人能够识别并验证该确切副本。通过假名化处理替换所选标识符;包含的文本和原始文件仍作为审查内容的一部分。
GitHub Actions 支持通过 Takeout 或常规 API 导出整个账户或选定聊天记录,还支持单个聊天的事件日志。托管捕获指南详细说明了设置验证及 120 分钟的时限。要验证从托管捕获生成的共享副本,请将该副本的源哈希值与原始存档进行比对,并使用特定模式的检查方法验证该存档的认证信息。