# Telegram · 证据的运作原理

Canonical page: https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/

通过验证者实际使用的精确公式，详细解释了哈希链、签名、检查点和见证人等概念。

[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://phishdestroy.io/tgwitness/zh/docs/reference/evidence/)

![证据与验证](https://phishdestroy.io/tgwitness/assets/chapter-evidence.svg?v=e49c65feab6c)

TgWitness 保留收集账户所观察到的内容，将这些观察结果 链接到一个经过签名的日志中，并允许其他人根据可信 密钥、来自第三方的外部时间以及先前保留的检查点来验证导出内容。

[本地文档网站](https://github.com/phishdestroy/TgWitness/blob/main/docs/internal/PUBLISHING.md#preview-the-website-locally)新增了 位于 `/docs/concepts/` 的交互式示例、位于 `/docs/witness/` 的检查点决策探索器，以及关于[“案件看板](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/)”、 [报告设计](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/)和[移交摘录](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#handover-extract)的操作指南。 所有示例消息、 计数和延迟均为虚构。链式沙盒中的哈希值是在浏览器中使用 SHA-256 算法计算得出的。没有任何数据会被发送至 Telegram。

**本页内容**

- [消息会发生变化；观察结果会不断积累](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#a-message-changes-observations-accumulate)
- [哈希值的覆盖范围](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#what-a-hash-covers)
- [早期检查点新增的内容](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#what-an-earlier-checkpoint-adds)
- [见证的归属](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#where-a-witness-belongs)
- [针对已知操作进行测试](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#test-delivery-against-known-actions)
- [选择工作流](https://phishdestroy.io/tgwitness/zh/docs/reference/how-it-works/#pick-a-workflow)

## 消息在变；观察在积累

序列图 · Telegram → 收集器: 新消息：10:00 见面; 收集器 → 签名日志: 追加消息.new; Telegram → 收集器: 编辑：11:00 见面; 收集器 → 签名日志: 追加消息.edited; Telegram → 收集器: 删除通知; 收集器 → 签名日志: 追加消息.已删除; 关于签名日志的说明: 原始内容、编辑内容及删除记录均予以保留 · Telegram · 收集器 · 签名日志 · 新消息：10:00 见面 · 追加消息.new · 编辑：11:00 见面 · 追加消息.edited · 删除通知 · 追加消息.已删除 · 原始内容、编辑内容及删除记录均予以保留

**图表转为文本**

1. Telegram → 收集器: 新消息：10:00 见面
2. 收集器 → 签名日志: 追加消息.new
3. Telegram → 收集器: 编辑：11:00 见面
4. 收集器 → 签名日志: 追加消息.edited
5. Telegram → 收集器: 删除通知
6. 收集器 → 签名日志: 追加消息.已删除
7. 关于签名日志的说明: 原始内容、编辑内容及删除记录均予以保留

此简化流程假设 Telegram 已成功发送每条更新，且所选 账户能够查看该更新。操作事件也会被记录在日志中。删除通知 不会提供删除者信息或确切的删除时间。重复发送的 消息被视为独立的记录；日志中不会进行全局重复项过滤。

## 哈希值涵盖的内容

![观察、编码、哈希和签名：每个新事件都包含前一个事件的哈希值。](https://phishdestroy.io/tgwitness/assets/evidence-chain-animated.svg?v=368c25a3be9c)

从内到外解读该公式：**C** 将九个字段转换为精确的字节； **SHA-256** 生成其摘要；**hex** 表示该摘要的存储格式。前一个 哈希值已包含在事件中。**unhex** 将存储的哈希值还原为 32 字节，供 Ed25519 进行签名。

[静态链图](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-chain-static.svg)

设 C(ei) 为九个事件字段的标准 UTF-8 JSON 格式。第一个 `previous_hash` 由 64 个零字符组成。后续的每条记录都包含前一条 记录的十六进制哈希值：

hi = hex(SHA256(C(ei)))

σi = Ed25519.Sign(sk,unhex(hi))

该签名覆盖了 32 个原始摘要字节。哈希输入包含 `seq`、`observed_at`、`source_at`、`kind`、`chat_id`、`message_id`、`actor_id`、 `payload` 和 `previous_hash` 这 8 个值。对象键按顺序排列；省略空格和 ASCII 转义符；NaN 和无穷大值被排除。请参阅 [确切的编码](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#event-canonicalization)规则。

流程图 · 64个零字符 → 记录 1 / 哈希值 h1; 记录 1 / 哈希值 h1 → 记录 2 包含 h1 / 哈希 h2; 记录 2 包含 h1 / 哈希 h2 → 记录 3 包含 h2 / 哈希 h3; 记录 3 包含 h2 / 哈希 h3 → 签名检查点：计数 3，标题 h3 (保留在其他地方) · 64个零字符 · 记录 1 / 哈希值 h1 · 记录 2 包含 h1 / 哈希h2 · 记录 3 包含 h2 / 哈希h3 · 签名检查点：计数3，标题 h3 · 保留在其他地方

**图表转为文本**

1. 64个零字符 → 记录 1 / 哈希值 h1
2. 记录 1 / 哈希值 h1 → 记录 2 包含 h1 / 哈希 h2
3. 记录 2 包含 h1 / 哈希 h2 → 记录 3 包含 h2 / 哈希 h3
4. 记录 3 包含 h2 / 哈希 h3 → 签名检查点：计数 3，标题 h3 (保留在其他地方)

| 更改为提供的日志 | 检测依据 |
| --- | --- |
| 修改记录 2，同时保留其已保存的哈希值 | 重新计算的事件哈希值不同；其签名不再涵盖已更改的事件 |
| 重建被篡改的记录及其后的每个哈希值 | 原始签名验证失败；受影响边界处保留的检查点也显示不一致 |
| 删除尾部内容，但保留前缀部分不变 | 在给定前缀之后的某个较早保留检查点显示，导出内容过短 |
| 使用另一把密钥对替换后的日志进行重新签名 | 一个独立的可信密钥指纹会拒绝该替换身份 |

![修改已保存的字段会改变其摘要；重新生成哈希值无法恢复原始签名。](https://phishdestroy.io/tgwitness/assets/evidence-tamper-animated.svg?v=5ca92399bea5)

**请在记录 2 上尝试以下逻辑：**将已保存事件中的 `Meet at 11:00` 更改为 `Meet at 12:00`。 其重新计算的哈希值将不再匹配。重新计算后续链 可以修复其链接，但无法使原始签名覆盖新的摘要。 相比之下，被观察到的 Telegram 编辑操作将生成一条新的日志记录。

[静态变更图](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-tamper-static.svg)

仅凭哈希链接无法阻止他人重新计算替代链。 信任来源于使用独立可信密钥验证签名，外部 时间来源于将日志头固定的第三方，以及保留在 收集器外部的引用。

## 早期检查点新增的内容

![保留计数 3 和 h3 标题；在位置 3 处会检查后续导出的 4 条记录。](https://phishdestroy.io/tgwitness/assets/evidence-checkpoint-animated.svg?v=e68f4e7be4b9)

**随着日志的增长，引用位置保持不变。**如果检查点显示 “3 条记录，头部 h3”，则包含四条记录的导出文件可以通过匹配第 3 位处的 h3 来通过验证。 其最新头部为 h4，预计会有所不同。仅包含两条记录的导出文件将无法通过验证。

[静态检查点图](https://github.com/phishdestroy/TgWitness/blob/main/docs/assets/presentation/evidence-checkpoint-static.svg)

在验证检查点签名后，需执行以下操作：

Nexport ≥ Ncheckpoint and hexport[Ncheckpoint] = Hcheckpoint

导出内容可能超出检查点的范围，但必须在保留的边界处保持一致。 收集器密钥对检查点进行签名，因此收集器可以对另一个检查点进行签名。 只有当接收方在归档之前通过 其他渠道获取该检查点时，它才会将记录绑定在一起；证据的最低要求还需第三方提供的外部时间戳。 真正的验证者还会检查每个事件的序列、前一个链接、哈希值和 签名。如果仅比较最终存储的头部，可能会遗漏被篡改的内部 记录——因为其保存的哈希值并未更新。

## 证人的归属之地

流程图 · 采集器 / 账户会话 / 密钥 A → 只读检查点端点; Witness / 固定收集器密钥 / 自有密钥 B → 独立的签名证人日志; Witness / 固定收集器密钥 / 自有密钥 B → 只读检查点端点 (申请审核); 只读检查点端点 → Witness / 固定收集器密钥 / 自有密钥 B (已签名的回答); Witness / 固定收集器密钥 / 自有密钥 B → 包含带签名的 TGW1 帖子的频道 (机器人 API / 专属令牌) · 主机 A · 主机 B · 采集器 / 账户会话 / 密钥 A · 只读检查点端点 · Witness / 固定收集器密钥 /自有密钥 B · 独立的签名证人日志 · 包含带签名的 TGW1帖子的频道 · 申请审核 · 已签名的回答 · 机器人 API / 专属令牌

**图表转为文本**

1. 采集器 / 账户会话 / 密钥 A → 只读检查点端点
2. Witness / 固定收集器密钥 / 自有密钥 B → 独立的签名证人日志
3. Witness / 固定收集器密钥 / 自有密钥 B → 只读检查点端点 (申请审核)
4. 只读检查点端点 → Witness / 固定收集器密钥 / 自有密钥 B (已签名的回答)
5. Witness / 固定收集器密钥 / 自有密钥 B → 包含带签名的 TGW1 帖子的频道 (机器人 API / 专属令牌)

见证者会记录回滚、同一计数下的不同头部、更换的密钥、无效回答和缺失的响应。要确认之前的每条记录都未改变，请将导出与保留的检查点进行比较。位于另一台主机上的见证者不会与采集器主机同时宕机；独立的运营方可提供额外的独立性。验证器会检查见证者密钥与采集器密钥不同；保管方的密钥控制记录表明该密钥由谁持有。Telegram 会为公开频道中的每条帖子标注日期，`verify.py --channel https://t.me/s/…` 会将这些日期读取为外部时间。

见证人会验证采集器报告的日志状态。使用受控 投递测试来检测哪些 Telegram 操作已到达采集账户。 请参阅[见证人设置](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/)。

## 针对已知操作的测试交付

请使用受控组、独立的采集账户以及新的标记。有目的地发送、 编辑和删除消息，并在各阶段之间检查捕获情况。在检查结果之前，请明确定义 预期操作及截止条件。

R = |observed∩expected| / |expected| Δ t = treceipt - taction

仅计入与预期操作匹配的情况；重复的收据不会增加 分子。分母必须不为零。缺失的收据不计入 延迟测量。需记录时间不确定性；请使用您自己控制的删除操作时间， 因为 Telegram 无法提供确切的删除时间。 诸如 5/6 (83.3%) 之类的结果描述的是测试操作，而非所有 Telegram 流量的完整性。

## 选择工作流程

[完整的调查流程演示](https://phishdestroy.io/tgwitness/zh/docs/reference/investigation/)将围绕一起 涉及频道、群组、机器人和私聊的事件展开：

1. 在专用采集账户中，启用“整个账户”调查模式并 清点可访问的聊天记录。可选择特定聊天记录或文件夹作为主账户。
2. 获取日志快照、按聊天分列的完整历史记录以及已保存的附件。
3. 保留实时更改以及任何有意的面板交互及其操作记录。
4. 通过引用的记录和用户资料，追踪数字发件人 ID、回复关系、重复收件人和文件 哈希值。
5. 在“案件看板”中添加与来源关联的注释和集合。重建跨聊天 时间线，其中应包含时间戳和明确的间隔。
6. 在保持各账户的来源和密钥相互独立的同时，比较其他账户的工作区。
7. 汇总并验证带签名的日志、用户资料及历史数据导出文件，并附上案件备注。

网站上的 `/docs/cases/` 指南包含交互式案件地图，并针对 机器人纠纷、已删除消息以及参与者更改名称等情况提供了多种处理方案。Case Board 将笔记和收集内容保存在工作区内。批量导出功能可收集独立的 工作区包；跨工作区关联分析及合并时间线仍由 分析师负责。

[已完成验证及剩余工作](https://phishdestroy.io/tgwitness/zh/docs/reference/verification/) · [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#investigation-handoff) · [从一个账户开始](https://phishdestroy.io/tgwitness/zh/docs/reference/quickstart/)
