# Telegram · 面板指南

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

面板的每个界面：聊天、日志、来源、导出、扩展功能、保护模式和代码检查。

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

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

Translation coverage: this edition includes material from the English original.

面板的每个界面：聊天、日志、来源、导出、扩展功能、保护模式和代码检查。

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

![入门指南](https://phishdestroy.io/tgwitness/assets/chapter-start.svg?v=443547f9bcd2)

[初始设置与配置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/) · [账户](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/) · [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) · [案例报告](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/)

每个界面的功能、其向签名日志写入的内容以及详细 指南的位置。面板每次仅显示一个工作区：一个拥有独立 消息源、日志和签名密钥的 Telegram 账户。顶部栏中的账户选择器用于切换 工作区。地址中包含工作区信息（`?ws=…`）；当地址、 选择器与已加载的账户不一致时，操作将保持被阻止状态。

使用[比较收集方法](https://github.com/phishdestroy/TgWitness/blob/main/docs/COLLECTION-MODES.md)在实时 观察、完整历史记录、新账户/聊天记录导出以及已保存记录移交之间进行选择。 导出页面在下载控件上方包含与上述相同的比较功能。

**本页内容**

- [导航指南](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#find-your-way)
- [从这里开始](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#start-here)
- [聊天记录](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#chats)
- [日志](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#journal)
- [来源](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#sources)
- [导出功能](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#exports)
- [设置、账户和连接](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#settings-accounts-and-connection)
- [附加内容](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#extras)
- [保护模式](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#protection-modes)
- [更多工具](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#more-tools)

## 快速入门

侧边栏将六个日常板块整合在一起：**首页**、**聊天**、**日志**、 **导出**、**账户**和**设置**。您无权访问的板块 将被省略。**更多工具**包含调查和管理工具。 打开侧边栏底部的**外观**以更改语言、主题、 时区或界面级别：

| 级别 | 侧边栏中的部分 |
| --- | --- |
| 简单 | 每日章节 |
| 标准 | 此外，在更多工具下还包括案例板、来源、访问和文档。 |
| 专家 | 此外，在更多工具下还包括系统地图、网络拓扑、扩展功能、查询存档、参数、账户、系统日志和集成。 |

各层级的章节名称保持不变。层级仅用于隐藏章节。隐藏功能仍会正常运行，且服务器会自行检查 每一项权限。层级、语言、主题和时区会按 操作员和工作区分别保存；请参阅[设置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/)。

使用侧边栏顶部的**转到功能**（Ctrl+K，Mac 上为 ⌘K）通过 `#number` 查找 聊天记录、参数或日志记录。方向键用于移动，Enter 键打开， Esc 键关闭。

顶部栏包含：

- **通知**：根据日志生成的故障和聊天变更信息。 **“全选已读**”会清零计数器，“**通知规则**”可打开规则设置。 在 [“扩展功能” → “通知”](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#notifications) 中可设置将通知发送至 Telegram、Discord 或电子邮件。
- 一个包含开始/暂停控制、连接设置以及 Telegram 健康诊断、事件接收、数据源和附件队列的收集状态菜单。 在窄屏上，可通过活动图标打开该菜单。
- **锁定**：关闭当前浏览器中的面板。Collection 仍会在服务器上继续运行。

版本和保护模式位于**“外观**”下；请参阅[保护模式](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#protection-modes)。 安装程序会在登录后打开**主页**；显式链接会打开其请求的 屏幕。聊天范围内的审阅者会打开**聊天**。地址 `/home`, `/case-board`, `/pseudo-secret` 和 `/network-topology` 也会打开相应的屏幕。 未知页面地址将返回 HTTP 404 状态码，并提供附近的页面建议。

演示工作区包含虚构的消息，且绝不会连接到 Telegram。 任何可能更改真实工作区的操作都会被拒绝。

[系统地图](https://github.com/phishdestroy/TgWitness/blob/main/docs/SYSTEM-MAP.md)显示了该部署的账户路径、代理状态、 套接字端点、加密保险库、证据服务以及被观察到的网络请求。 选择一个账户以查看其路径。可用但已禁用的服务仍会显示。

## 从这里开始

当您切换账户 或重新登录时，概览页面会清除该账户对应的图表和摘要。加载状态、读取失败以及没有保存记录的时段 各有不同的状态。**重试会**重复执行失败的读取操作；如果服务器要求等待， 则会显示下一次尝试的时间。刷新失败时，系统会保留同一工作区中 上次成功获取的数据，并标注其最后更新时间。

每个已连接的账户都会分别显示**“收集器心跳** ”和**“收到的最后一个事件** ”。前者表示收集器的活动状态；后者表示收到的最新 Telegram 更新。如果数据源处于静默状态，后者显示的时间将保持不变，而 收集器仍会继续运行。打开“收集状态”菜单，可查看连接、数据摄入、 数据源和附件的诊断信息。

选择一项任务。**导出我的账户**会下载该账户当前可读取的内容。 **跟踪调查**会记录您所选聊天中的新消息、观察到的编辑操作以及删除通知。 当观察处于暂停状态时，“聊天”、“日志”和“来源” 会显示设置卡片：连接账户、选择来源、开始观察。 当目标为**案件证据**，或处于“见证”、“案件准备”、 “GitHub 验证”或“最高[保护”模式](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#protection-modes)时，开始监视 会首先读取 Telegram 的会话列表（但当**严格：仅读取选定聊天**模式开启时除外）。 如果还有其他会话已登录，面板会显示 其数量，并提供**仍要开始**或**打开该账户的会话**选项。其他 目标和模式则无需此提示即可开始。 目标提示将一直显示在此页面，直到您 回答或跳过它。否则，将打开一个新工作区并进入[首次设置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/)。

## 聊天

已保存的对话，默认仅限查看。

聊天行显示收集状态、待处理和失败的文件下载、初始历史记录 加载情况，以及Telegram对话元数据中返回的限制信息。丢失或未确认的 访问状态并不意味着内容被禁。打开**过滤器**以选择这些状态 或按文件队列排序；页面重新加载时，选定内容将保留在URL中。 **重试**筛选器可查找因错误而处于等待状态的初始聊天加载任务。其图标会显示 错误类型，并在收集过程中显示下次尝试时间。“首页”汇总了需要 再次尝试的加载任务数量。暂停的收集任务将保留相关任务，直至恢复。

In **Simple** mode Home also shows **Can be handed to a court: yes** or **no · missing: …**. Yes means timestamps are on with an RFC 3161 authority and that authority recently returned a timestamp that validated against its root certificate; each export asks for a new one for its last record. The line names the missing item otherwise. It does not check the signing key: the recipient confirms its fingerprint, received separately, and runs `verify.py` with `--tsa-ca` and the authority's root certificate. A Bitcoin proof, a witness post or an attested collection run can also meet the minimum there but are not counted here.

保留关联的日志条目会显示已观察到的类型、名称和字节大小。 新的下载结果在 Telegram 提供时，也会保留媒体类型和时长。 较早的已签名记录保持不变；缺失的元数据不会被重建。

- 按名称或ID搜索列表。多个词语按任意顺序匹配，包括 名称与ID的一部分组合。点击**+**按钮可打开**添加聊天或频道**（添加或移除 关注的聊天）、**打开Telegram链接**和**伪秘密 · 开始聊天**。 **打开 Telegram 链接**功能支持输入 用户名或邀请链接，并将预览保存至日志；若搜索 @用户名 或 t.me 链接未 找到匹配结果，也会显示相同操作。**选择加入/打开并观察**将加入该聊天并将其添加到您的来源中； 打开机器人时，系统会向其发送 `/start` 指令。
- 伪秘密聊天会显示在同一列表中，图标为绿色并带有锁形标记，且会在“伪秘密”模式下打开。 当观察功能关闭时，列表中会显示**“观察**已关闭”以及**开始观察**选项。
- 快速过滤器以单行标签页的形式呈现：**全部**、**伪秘密**、**优先级**、**更改**（已保存的编辑 或删除通知）以及**需要关注**（访问丢失或未确认、重新检查时未找到消息、 媒体文件失败、历史记录重试或 Telegram 限制）。 没有内容的标签页会被隐藏。计数会遵循 搜索和类型过滤器；快速过滤器将取代状态过滤器。这些选项 会保留在 URL 中，以便重新加载以及“后退/前进”导航。 **需要关注**不会将消息标记为已删除。当**筛选器**折叠时，类型、状态和自定义 排序仍作为可移除的卡片显示。
- 大型列表每次显示 80 条匹配结果；**点击显示更多**可加载下一批 80 条。当匹配结果出现时，已打开的 聊天窗口和当前选中的行仍会保持可见，即使该结果不在当前批次中也是如此。 计数器显示的是所有匹配结果中已显示的聊天数量。搜索范围覆盖整个 列表，包括尚未显示的聊天。
- 来自搜索， **↓** 跳转到第一个搜索结果， **↑** 到最后显示的结果， 并且 **输入** 打开第一场比赛。在列表中， **↑/↓** 和 **首页/结束** 移动焦点； **输入** 打开当前选中的聊天窗口。 **逃脱** 返回搜索界面，在该界面中 再次按下该按钮可清除搜索查询。 **清除筛选条件** 重置列表，同时 不更改集合或已打开的对话。
- 聊天标题会统计**已删除、保留文本**、**保存前已删除**和**重新检查时未找到**的消息。每个计数都是一个按钮，只显示这些消息；再按一次即显示全部。消息上的**已删除**和**重新检查后未找到**会打开一条注释，包含时间和观察到的内容。聊天列表和通知使用相同的定义。已删除的消息显示为红色并保留已保存的文本；已编辑的消息保留所有已保存的版本。
- **搜索已保存的消息**会检索完整的保留聊天记录，包括早期的 文本版本。已删除、已编辑、媒体和作者过滤器同样涵盖完整的 保留聊天记录。**重新检查时未找到**的结果与收到的删除通知无关。 搜索不会向 Telegram 请求消息；请使用**加载历史记录**来获取更多内容。 若在早期版本中找到匹配项，将打开保存的版本及其日志链接。 **显示版本**标识了用于该消息的记录及其书签； 历史记录的延迟响应无法替代屏幕上更新的实时编辑内容。
- 在消息之间，聊天会显示两种缺口标记。**未观察到的消息编号**列出日志中没有记录的编号，仅限频道和超级群组：其他聊天共用整个账号的一套编号，因此那里的跳号无法说明该聊天的任何情况。**覆盖缺口**标出一次已记录的中断与下一次已记录的恢复之间的时段，如日志中有原因则一并显示。显示全部消息时会出现这些标记，启用消息筛选时则隐藏。
- 在消息上方**点击生成报告**按钮，将打开报告工作室，并选中该聊天记录。 在发帖者的个人卡片中点击同一按钮，则会选中该聊天记录及该发帖者。 这两种操作均仅修改草稿；导出前请先保存。
- 点击作者姓名会在消息旁边打开一张人物卡片：保存的个人资料、 简介、头像、礼物、链接、消息数量以及包含 日志记录的活动时间线，此外还有**刷新个人资料**和**生成报告**选项。**点击关闭**、按 Esc 键或 进入其他聊天窗口可关闭该卡片；聊天窗口的位置保持不变。 卡片中的**节奏** 统计该作者在此聊天中已保存的消息（以UTC时间为准）：活跃天数（在 沉默6小时后开始计算）、24小时内回复他人的中位时间、 最长连续消息串、00:00至06:00之间发送的消息比例，以及 工作日×小时的热力图。
- 消息上方的**选择**会开启消息选择：点按消息即可标记，按住 Shift 点按可标记一个范围，或使用**选择显示内容**，然后点**生成报告**。报告工作室打开时已填好**已选消息**。报告涵盖通过其他筛选器的这些消息的记录（观察、编辑、删除通知）；作者筛选会排除不带发送者的删除通知。最多可选择 1,000 条消息；工作室中的标签可移除单条消息，也可在旁边添加整个聊天。缺失的消息编号仅针对整体选中的聊天报告。
- **加载历史记录**功能会将最近的 100、250 或 500 条消息加载到此视图和 日志中。您可以在**聊天操作**中找到该功能，其旁边还有录音设置、只读和 秘密消息隐藏控制选项。按 Esc 键或点击菜单外区域即可关闭该菜单。 加载较早的消息时，当前阅读位置将保持不变。如果在 Telegram 响应期间查询或页面 发生变化，加载完成后会更新已保存的日志，而不会 替换较新的视图。自动加载失败时，系统会提供**重试选项**。 要加载所有已启用的消息源，请使用[消息源→完整历史记录](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#sources)。
- **“导出聊天”**功能将整个可见聊天记录下载为一个已签名的 `chat.json` 且 `chat.html`文件。多个关联账户可协同完成此任务：每个账户下载其对应的 消息编号范围并对其部分进行签名，而发起 导出的账户则对整个存档进行签名。参见[“导出单个聊天](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md)”。
- **“人员”**列表显示了该聊天中所有保存了消息的用户。人员个人资料默认处于 关闭状态，因为它们涉及第三方个人数据。当某次聊天中 启用该功能时，个人资料会显示姓名和用户名历史、Telegram标记、头像哈希值、活动记录、 谁回复了谁、其他被观察的聊天，以及被提及的钱包、手机号、用户名 和链接。 每项信息都指向其对应的记录。**导出个人资料**会保存一个签名文件， 可选地设置密码ZIP；关闭个人资料会删除该文件。参见 [“人员个人资料](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#people-profiles)”。
- **“将所有作者汇集** 到同一标签页”功能会向Telegram请求获取聊天中所有已保存消息的用户的个人资料、简介、 头像、礼物和简介链接。在频道 或超级群中，其他已连接的账户可以共同参与此操作。每个选中的账户都会 被预留用于该集合，完整收录该用户信息，并通过该作者 其中一条已保存的消息联系到该作者。 正在处理其他任务的账号不会被干扰， 待其空闲后即加入。若无法联系到某位作者，则返回聊天室的自有账号。 进度条显示百分比、剩余时间及各账号的贡献份额；**点击暂停** 可释放账号。每条已保存的记录都会标注阅读该记录的账号，且 日志会记录每个账号的加入和退出时间。
- **“保存个人资料”功能现可**记录聊天或机器人个人资料的快照：描述、 成员、邀请链接、机器人命令。

### 只读、发送和密钥

消息上方有两个开关，用于保护账户和读者：

- 打开聊天时**，“只读”模式**处于开启状态。 若要发送消息或点击机器人 按钮，请将其关闭。每次操作时都会提示**“以 @account 身份发送？**”或**“以 @account 身份点击此机器人按钮？**”，这表明聊天成员会看到该操作，且该操作将进入已签名的 日志。**选择“在此聊天中 10 分钟内不再提示**”可暂时跳过该提示。在**“案件证据**”目标中，无论是面板还是 API，发送功能均处于关闭状态。
- **“隐藏机密”功能可**隐藏看似密码、登录码、API 密钥或 哈希值、机器人令牌、会话字符串、私钥、JWT 或支付卡号 （卡号会通过 Luhn 和校验）的内容。**点击“显示”**将揭示一个值；该揭示操作 会被记录在日志中。为该浏览器关闭隐藏功能的操作也会被记录下来。 仅显示内容发生变化：原始记录和所有导出文件均保留完整文本。

### 将选中的消息保存为图片

在云端聊天中，选择**“选择**”，勾选消息，然后选择**“另存为图片**”。 要截取整个聊天记录，请在聊天工具菜单中选择**“将聊天保存为图片**”；该功能 会加载最近保存的最多 2,000 条消息，并提示哪些较早的消息未被包含。 预览界面提供**“浅色**”、**“深色**”和“**经典**”三种样式；对于较长的聊天记录，请使用“上一页”和“下一页” 进行截取。**下载带签名的 ZIP 文件**，该文件将每页保存为 PNG 格式，并附带 `pages.sig.json` 以及 `README.txt` （[已签名的聊天图片](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#signed-chat-images)）。 最多可选择 50 条消息，且所有消息必须仍位于已加载的聊天 窗口中。操作面板会提示您缩减过大选择范围，而非默认 省略消息。

每页末尾都包含一个真实性块：其中显示的日志记录编号、 聊天记录、渲染时间、工作区密钥指纹、该 `verify.py` 该页面的 命令，以及一个包含聊天记录、密钥和渲染时间的二维码。签名需要导出 权限，并会在日志中添加一条 `export.image_attested` 日志条目。

该图像包含已保存的文本、作者、消息编号、UTC时间、回复编号、 附件标签以及已保存的编辑/删除状态。它显示的是最新保存的文本 及其保留的版本数量；附件内容、内联按钮、 点赞和早期文本版本均未显示。 长消息将延续至 下一页，并显示其消息编号和分段数量。每页均标明 其内容源自已保存的消息。该 PNG 文件仅为视觉摘要；在移交签名记录及附件时， 请使用存档文件及其验证码。

渲染过程在浏览器中完成，无需向Telegram发送请求；在签名时， 仅将每页的SHA-256哈希值和记录编号发送至控制面板。现有的密文遮罩功能可保护文本、作者姓名和 附件标签。预览窗口会保留快照直至关闭，并在控制面板 锁定或切换工作区/聊天时清空。已签名的日志和报告选择保持 不变。有关完整报告导出的信息，请参阅[病例报告](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/)。

### 转发消息

关闭该聊天的**只读**状态，然后在某条消息下方选择**转发**，或者 **选择**并标记最多 100 条消息，然后选择**转发**。按 名称选择目的地：列表中包含已保存的聊天以及该账号可在其中发布消息的 Telegram 聊天（包括群组、私聊、机器人及其管理的频道）。 面板会要求 确认，随后通过 Telegram 原生功能进行转发，并遵循该账号的 消息发送频率。请求及其结果均为带签名的日志记录，其中注明了源聊天、 消息编号和目标。只有当目标 聊天被监听时，副本才会保存在目标端。如果聊天禁止转发，则会返回拒绝响应，且不会发送任何内容。

### 将聊天内容转发到频道或群组

The main administrator can open a saved cloud chat and choose **Forward chat** from its tools menu. Choose **New channel**, **New group**, or **Existing channel or group**. New destinations are private. For an existing destination, **Choose a chat** lists the account's groups and the channels it administers; search by name. The destination must allow this account to post. Forum destinations are not supported.

在预览之前，请暂停观察或其他正在运行的账户任务，并启用 Telegram 操作。 只读账户以及**案件证据**目标会阻止转账操作。 **预览功能**会读取可访问的 Telegram 聊天记录范围并验证目标地址。 该功能不会创建目标地址或发送消息。**开始**将启动转账； 预览将在十分钟后失效。每个工作区仅可进行一次转账操作。

该传输功能会按从最旧到最新的顺序读取 Telegram 聊天记录，直至预览中显示的最后一条消息。 它并不局限于已保存在 TgWitness 中的消息。 超出该范围的消息将被排除在外。原生转发功能可保留 Telegram中可用的发件人信息和媒体内容，无需下载和上传 副本。范围内的相册将保持完整。通知为静默模式。回复、 主题结构、点赞、编辑以及已删除或无法访问的消息均不会 被重建。秘密聊天不属于此工作流范围。Telegram的内容保护 和发布限制仍然有效。

该面板显示已确认的发送、跳过操作、状态以及下一次允许尝试的时间。 服务消息和单独受保护的消息会被跳过，并记录 跳过原因。账户消息间隔和每小时限制适用于每条消息；专辑 将等待其预留时段到期。FloodWait 和慢速模式暂停会更新 账户的共享 RPC 退避时间。账户现有的限速默认设置保持不变。

**暂停**会中断当前请求；**取消**会停止剩余操作，但不会移除 已发送的消息或删除已创建的目标。正在处理中的请求可能会 在上述任一操作生效前完成。关闭对话框不会取消任务。 进程重启后，未完成的工作需要显式**继续**操作。若发送响应丢失或 不完整，工作将暂停以便审查：在 继续之前请检查目标。重试会保留存储的 Telegram 随机 ID 和已确认计数； 但这不能保证 Telegram 会无限期地进行去重。未知创建 结果无法自动继续：请检查 Telegram，并在 向已创建的目标（如有）开始新传输之前，取消旧的工作。

如果保存作业或其日志条目失败，工作者将恢复上次保存的 状态并释放该账户。可能已到达 Telegram 的发送或创建操作仍会被标记为待审核。当存储空间再次可用时，重试失败的启动或恢复操作； 已确认的进度仅随其日志条目一起推进。

已签署 `interaction.forward.*` 日志条目记录了边界、目标位置、 已确认的源/目标消息ID以及跳过项。它们记录了传输过程； 但不能替代原始的已签名观测数据和导出数据。

## 日志

工作区已签名的所有记录，按时间倒序排列（最新在最前）。

- **“概览”**统计了已观察到的消息、记录的编辑、删除通知以及 选定的来源。
- **事件时间轴**可按事件类型（全部、编辑、删除、点赞、 成员资格、报道范围）、文本内容及来源进行筛选。可回**载较早的事件**页面。
- 打开一条记录可查看其详细信息、哈希值和有效载荷。**该记录的链接**是一个 可直接打开同一记录的地址。此预览中可能包含的机密信息已被屏蔽； 导出文件则保留原始内容。
- 日志为仅追加模式：面板中没有任何操作可以编辑或删除记录。请通过 **“导出”→“验证日志**”或 `python -m tgwitness.verify`；参见 [“导出与验证”部分](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/)。

## 来源

该工作区会记录哪些对话，以及从中保留哪些内容。更改 仅适用于未来的活动；已保存的记录保持不变。

**“刷新聊天列表”**功能会读取该账户的聊天记录和文件夹，但不会下载消息内容。

### 范围

- **该账户记录的内容** ：**选定的聊天** （仅您添加的聊天）， **Telegram 文件夹** （该账户的一个文件夹，包括后续添加到其中的 聊天）或 **完整账户** （所有聊天，以及每个新出现的聊天、群组、私聊或 机器人）。**调查模式** 适用于专用账户：它记录 该账户所见的一切内容、其自身发送的消息和按键操作，并立即保存每个新 聊天的配置文件及先前可见的消息。 [专用账户指南](https://phishdestroy.io/tgwitness/docs/dedicated-account/) 解释了为何绝不能使用你的主账号。
- **严格模式：仅读取选定的聊天**（仅限选定聊天，默认关闭）将停止读取 Telegram 的服务通知、会话列表以及已启用该模式的聊天中的早期消息， 同时保持敏感内容设置不变，并跳过电话通话 更新。参见[严格选定聊天](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/#strict-chosen-chats)。
- **源类型**将文件夹模式和整个账户模式限制为频道、群组、私聊 和机器人。**自有操作**会添加该账户自身的消息、编辑操作以及 回复时的键盘按键记录。
- **当出现新的聊天或机器人时**：保存其资料，并保存最多（根据所选数量） 其最新的可见消息。
- **已选聊天**被标记为推荐。**点击丢弃更改**将表单恢复到 已保存的范围，直到您点击**保存范围**。

[伪秘密聊天](https://phishdestroy.io/tgwitness/zh/docs/reference/secret-chats/)是内置的秘密聊天界面，安装其协议模块后， 只需点击一个按钮即可为每个账户启用。云端监控 和聊天记录使用各自的设置。 当 TgWitness 未 运行时，系统不会记录任何内容；重启后，它仅会补录 Telegram 仍能返回的数据，而 报告中会显示数据缺口。超出聊天列表限制（除非在 “参数”中更改，否则为 1,000 个对话）的聊天记录，将在其下次变为活跃状态时被添加进来。在 其他应用中点击的内嵌机器人按钮不会被记录；但机器人的回复会被记录下来。

### 涵盖的聊天

可按状态（**已启用**、**已暂停**、**优先级**、**已排除**、**未确认 访问**、**已忽略**）和类型进行筛选，然后对选定项执行操作：启用、暂停、标记或移除 优先级、从范围中排除或删除。状态图标仅显示当前状态；操作 位于每行菜单中，并附有功能说明。 暂停和排除操作需要 确认，批量操作时同样如此。删除来源时需输入其名称，并会删除其人员 个人资料；其保存的记录仍保留在日志中。

若某来源未显示在该账户的聊天列表中，则表示该来源正在**接收更新，但未出现在聊天 列表中**，同时记录仍在持续到达；否则，**访问状态未确认**。**“可用 聊天**”会添加通过**“添加所选**”或**“添加所有匹配项**”操作选中的聊天。

### 完整历史

将每个已启用来源的可用历史记录加载到“聊天”和日志中。 进度在重启后仍会保留；附件遵循您的媒体设置。参见 [来源历史记录](https://phishdestroy.io/tgwitness/zh/docs/reference/history/)。

### 记录

- **选择要保留的变更**：新消息、编辑、删除通知、 可见的点赞、加入和退出。预设会更改表单； **“保存记录设置**”会应用该预设。重新启用某类别不会恢复 已错过的事件。
- **在可能的情况下保留媒体文件**：下载单个文件大小不超过指定限值的附件，设置 每种类型的限值范围为 1 至 2,000 MiB，并限制视频时长（以秒为单位，0 表示无限制）。 每次下载尝试都会记录结果。
- **重新检查**：每隔几分钟检查一次优先级聊天，其他聊天则很少检查，因此该账户 不会触发 Telegram 的 FloodWait 限制。设置为 0 可关闭该组。在列表中用星号标记优先级聊天； 每次检查的聊天数量以及聊天之间的暂停时间可在 “参数”中设置。参见[集合](https://phishdestroy.io/tgwitness/zh/docs/reference/collection/)。
- “保存”栏会显示这些设置是否与推荐设置一致。**点击返回 推荐设置**将填入推荐值；**点击保存录制设置**将应用这些设置 ；**点击放弃更改**则恢复已保存的设置。

## 导出功能

**“下载**”用于准备文件；**“构建报告**”用于选择报告的显示样式。

| 内容 | 用途： | 指南 |
| --- | --- | --- |
| 账户导出 | 该账户当前可读取内容的最新快照 | [账户导出](https://phishdestroy.io/tgwitness/zh/docs/reference/account-export/) |
| 共享副本 | 一个已完成的账户导出功能的精简版 | [披露声明](https://phishdestroy.io/tgwitness/zh/docs/reference/account-export/#prepare-a-disclosure-for-a-lawyer-or-another-recipient) |
| 已签名 ZIP | 日志、报告、附件和验证工具，均位于固定的日志边界内 | [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) |
| HTML、PDF、JSON 报告 | 一份密封的可读报告 | [案例报告](https://phishdestroy.io/tgwitness/zh/docs/reference/case-reports/) |
| JSONL、CSV | 带有签名的原始记录；一个支持公式的电子表格 | [导出与验证](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/) |
| 交接摘要 | 仅包含收件人所需的聊天记录、时间段和联系人 | [证据](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#investigation-handoff) |
| 聊天记录导出 | 一个已签名的聊天记录 `chat.json` 以及 `chat.html` | [导出一个聊天记录](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md) |

- **使用密码对上述下载文件进行加密**（12 个字符或以上）会保存一个 AES-256 ZIP，该文件可由 7-Zip 或 WinRAR 打开。其中的已签名文件保持不变。 密码不会被存储。
- 导入此工作区的会话密钥时，账户导出和聊天 导出对话框中会有一行提示：该密钥的副本可能存在于 Telegram 的 会话列表之外。同一行还提供了**创建独立授权**选项， 点击后将打开登录页面并默认选中该选项。参见 [账户部分](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#create-an-independent-authorization)。
- 失败或被取消的聊天导出将保留其已保存的范围。**捕获或导出 单个聊天**后，系统将提供**继续导出**和**重新开始选项**；请参阅 [导出单个聊天](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Chat-Export.md)。
- 虽然聊天记录导出功能显示为**下载迄今已读的消息**，但实际上保存的是一个 ZIP 文件，其中各页面 在写入时即被签名；其下方的行显示了已签名消息的数量。
- **预先准备的导出包**会保留最多 20 个文件（每个文件大小不超过 2 GiB），外加最新的一个文件，以便 重复下载；每个文件都附有相应的 SHA-256 校验值，供接收方进行比对。每张卡片都会注明文件的内容： **已签名存档**（完整的日志及其记录数量）、**报告**、**日志记录**或**交接 摘要**，案件标题和ID，以及生成该文件时选定的报告内容（聊天记录、选定消息、日期）。当列表包含多种类型时， **点击显示**可将列表筛选为单一类型。
- 当浏览器拒绝显示保存对话框时，该面板将回退为普通下载。
- **您的签名身份**会显示密钥指纹。**“保存检查点**”和 “下载**已签名的运行收据**”功能可为您提供存储在收集器之外的记录。 “准备**时间戳请求**”会在不联系任何服务的情况下构建一个 RFC 3161 请求。

## 设置、账户和连接

- **设置**：目标、连接、记录内容及界面。请参阅 [首次设置和配置](https://phishdestroy.io/tgwitness/zh/docs/reference/settings/)。
- **账户**：每个工作区及其状态、消息源、事件和附件队列。 可通过 **需要关注**、**收集**、**离线或已暂停** 或 **未连接** 进行筛选，暂停或恢复选定操作，批量导入账户文件并管理 群组。参见 [账户](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/)。
- **账户**：登录及该账户的连接路径。直接连接、WireGuard 配置文件、您自己的代理、公共 MTProto 池或 WARP；准备并检查路径， 然后将其应用于该账户、一个组或所有账户。 参见 [连接和代理及](https://phishdestroy.io/tgwitness/zh/docs/reference/connection/)[代理](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Proxies.md)。 **账户安全→此账户的会话**列出了 Telegram 的会话，可结束其中 一个或所有会话，并且——对于在此工作区中创建的密钥——**当 Telegram 允许时，提供将其设为 唯一会话选项**，该操作将在24小时后 后自动重复该操作，并显示其设置的一次性双步验证密码。参见 [账户安全](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#create-an-independent-authorization)。 **账户安全→见证探测**会使用第二个工作区来验证该 会话是否能实时接收更新；参见[见证探测](https://phishdestroy.io/tgwitness/zh/docs/reference/accounts/#witness-probe)。

批量暂停和恢复操作会将已确认的选择保留在最初 打开该操作的会话中。在等待确认或执行期间，控件将保持禁用状态； 切换工作区或锁定面板将取消剩余的命令。 执行完成后，面板会刷新账户状态。失败的请求将 被报告为请求失败，因为服务器可能已经应用了该命令。 命令不会自动重试。

## 附加功能

可选：只需一个账户和来源即可开始收集。只有您 选择的选项才会打开其设置，系统不会自动连接任何内容。顶部的“ **保护级别**”卡片显示当前的[保护模式](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#protection-modes)。

| 卡片 | 新增功能 | 指南 |
| --- | --- | --- |
| 存储与磁盘空间 | 备份、将旧文件移至您的云端、一份无法被删除的证据副本 | [存储](https://phishdestroy.io/tgwitness/zh/docs/reference/storage/) |
| 目标与保护级别 | 针对您的目标及两个量表的建议设置 | [下方](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#goal-and-protection-level) |
| 通知 | 问题、已修改的消息和每日摘要；您专属的控制机器人 | [下方](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#notifications) |
| 证据与备份 | 时间戳、更多见证人以及加密的异地副本 | [下方](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#evidence-and-backups) |
| 服务器全天候运行 | 一个不支持 SSH 的云服务器，可通过控制面板进行创建和删除 | [高可信度](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#from-the-panel) |
| 独立见证者 | 已签名的检查结果将发布到您的 Telegram 频道或 Discord 上 | [见证人](https://phishdestroy.io/tgwitness/zh/docs/reference/witness/) |
| 代码检查 | 将正在运行的程序与 GitHub 上的公开提交进行比较 | [下方](https://phishdestroy.io/tgwitness/zh/docs/reference/panel/#code-check) |

### 目标与保护级别

四个问题：

1. **用途是什么？**个人记录、调查，或是案件证据。
2. **您打算监控多少内容？**少量聊天（最多约 50 个）、大量聊天（最多约 500 个）还是整个账户？这将把聊天列表的上限设置为 1,000、3,000 或 20,000。
3. **照片和文件？**仅限文本、照片和短媒体（照片 20 MB，视频 100 MB），或全部（视频和文档各不超过 1 GB）。选择“全部”并包含完整 账户时，还会保留 4 GiB 的可用磁盘空间。
4. **它将在何处运行？**这台电脑，或者一台始终处于运行状态的服务器。

建议列表中列出了独立时间戳、drand 以及 Telegram 的设备列表，每项 均附有一行说明其作用。时间戳可设置为每 60、30 或 10 分钟生成一次，适用于个人 记录、调查或证据；drand 和设备列表需要时间戳。仅需 **应用**以下更改：这些内容、附件策略以及上述两个参数。每次 更改都是一条日志记录，此外 `setup.applied`。通知、站外副本、 服务器、网关DNS、代码校验和见证人作为后续步骤提供，并配有 各自的表单。

两个指标是根据当前设置计算得出的，而非基于目标：

| 规模 | 要点 |
| --- | --- |
| 可信度 | 签名日志 1、时间戳 3、drand 1、设备列表 1、代码校验匹配 1、见证人轮询 1、经过认证的服务器 2、网关 DNS 日志 1 |
| 可靠性 | 常驻服务器 3 个，异地副本 3 个，对象锁定 1 个，问题通知 1 个 |

**最高**阅读量为 80% 或以上，50% **为高**，25% **为中等**，低于此为**基本**。 可靠性目前根据问题 4 的答案中“始终在线”的服务器进行计算， 在检查任何服务器之前。

### 通知

通知通过 Apprise 发送至 Telegram、Discord、Slack、ntfy、电子邮件、Matrix 以及 100 多种其他服务。选择一项服务，填写一两个字段并发送测试消息，或者 直接粘贴 Apprise 地址。

- **问题**：磁盘空间几乎已满、账户已注销、收集、复制或时间戳 错误、使用该设备、应用程序和 Telegram 国家列表的新会话登录到该账户、Telegram 在 观察期间报告的登录码或新登录，以及在**将此设为唯一会话**之后出现的另一个会话。在密封的 服务器上，打开的 SSH 端口或登录操作也会构成问题。
- **变更**：在被监视的聊天中，已删除、已编辑和缺失的消息将按 每次检查一条通知进行汇总（除非在“参数”中更改，否则每分钟检查一次）。
- **已完成的功能**：历史记录、导出和存储副本。
- **监控列表匹配项**：来自已设置为发送警报的监控列表中的匹配项。
- **每日摘要**将于服务器时间设定的指定时间发送。

通知中包含聊天名称和消息数量。消息摘要默认处于关闭状态；若 开启该功能，消息正文将从本机发送出去。

**您的操作员机器人**是您通过 @BotFather 创建的专属机器人，用于回答 `/status` 并 `/stats`，并可选地 `/pause`, `/resume` 和 `/copy`。仅列出的聊天和 Telegram 用户 ID 可以使用它；对话内容保存在工作区中。如果另一个应用程序已经接收其命令，请使用一个单独的 机器人。请参阅 [通知](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Notifications.md)和[操作员机器人](https://phishdestroy.io/tgwitness/zh/docs/reference/storage/#operator-bot-and-completion-notices)。

### 证据与备份

- **独立时间戳**仅将每个签名检查点的 SHA-256 值发送至 RFC 3161 权威机构和 OpenTimestamps 日历，间隔为每 5 至 1,440 分钟。接收方需要 此类第三方时间戳作为证据的最低要求。**Anchor 目前** 正在运行一个通过。参见[时间戳](https://phishdestroy.io/tgwitness/zh/docs/reference/timestamp/)。
- **更多见证记录**（在被选中前均处于关闭状态）：最新一轮的 drand 轮次、Telegram 的 已登录设备列表（不含 IP 地址），以及 Cloudflare Gateway 记录的服务器 DNS 查询日志。参见[可选记录](https://phishdestroy.io/tgwitness/zh/docs/reference/evidence/#optional-records-in-evidence-mode-drand-and-telegram-devices)。
- **加密备份**会将日志、文件、检查点和聊天记录导出到 S3兼容存储（Wasabi、Amazon S3、Backblaze B2、Cloudflare R2、MinIO）。 所有内容都会先在此机器上进行加密。**请下载加密密钥**并将其 单独保存：没有该密钥，备份副本将无法被读取。在“治理”或“合规”模式下启用“对象锁定”功能， 可确保对象在设定的天数内不会被删除。参[见异地备份](https://github.com/phishdestroy/TgWitness/blob/main/docs/wiki/Off-site-Copy.md)。

### 代码检查

检查已安装的程序是否与已发布的版本匹配。

1. 输入一个 GitHub 仓库（官方仓库已预填）以及一个标签、分支或提交。
2. **“Check now**” 通过该工作区的外部请求路由，向 GitHub API 查询 该提交的文件列表。它将每个被测程序文件的 git blob ID 与该提交进行比对。即使在 Windows 环境中检出时换行符已被转换，仍能匹配成功。
3. 结果列表会显示已更改、新增和缺失的文件（每类最多 50 个），并保存为 一份 `source.checked` 日志记录。

结果仅在运行中的程序文件未发生变更时才视为有效： 更新后请重新检查。无需令牌，且仅支持公共仓库； 聊天记录和凭据不会被上传。匹配操作用于识别磁盘上的代码。这并非 硬件认证；有关硬件认证，请参阅 [Phala Cloud](https://phishdestroy.io/tgwitness/zh/docs/reference/high-assurance/#confidential-vm-on-phala-cloud-intel-tdx)。

## 保护模式

版本号旁边的切换器显示所选模式以及 18 层 保护层中有多少层处于激活状态，例如 `🟠 Witnessed 9/18`。在 **“扩展功能”→“保护级别”**中**切换模式**可打开选项。每种模式描述一个目标，并列出 尚缺的内容；记录、签名和保存的设置在所有模式下均保持一致。

| 模式 | 用于 | 新增功能 |
| --- | --- | --- |
| 🟢 简单 | 监视聊天并保留副本 | “聊天”功能用于导出日志和聊天记录；签名操作在后台运行 |
| 🟡 已签名 | 向平台、主机或滥用处理部门提交报告 | 签名存档、日志检查、检查点、交接摘要 |
| 🟠 已见证 | 可能有人声称记录被篡改的情况 | 一个独立见证人发布经签名的日志头 |
| 🔴 符合法庭要求 | 供律师、警方或法院使用的证据 | 时间戳、加密的异地副本、报告中的案件详情 |
| 🟣 GitHub 认证 | 任何人都能验证其软件的记录 | 代码检查与 GitHub Actions 捕获 |
| ⚫ 最大值 | 针对资金雄厚的对手展开的高风险案件 | 一个全天候运行的密封服务器、一个隐藏的 IP 地址，以及全部 18 层防护 |

各层结构：每条记录均经过签名并链式连接；带签名的运行收据；通过 SHA-256保存的附件；带签名的检查点；重新检查；问题警报；只读见证访问； 按计划进行的见证检查；RFC 3161 时间戳；OpenTimestamps 证明；经过验证的 最新时间戳；加密的异地副本；报告中的案例详情；匹配代码 检查； Telegram 永远不会看到这台机器的 IP；外部请求通过代理进行；副本上的 对象锁定；一个封存的、包含提供商记录的服务器。处于关闭状态的层设有 **“设置”选项**，点击后会打开其表单。选择较低模式时会要求确认，且 不会删除任何内容。

## 更多工具

**附加功能 → 独立捕获**：连接一个 独立的浏览器或AyuGram记录器，固定其签名密钥，选择捕获选项， 开始/暂停，拍摄快照并下载经过验证的签名存档。每个记录器都有 独立的手动登录、路由、日志和密钥。这两条连接初始状态均为禁用。 请参阅英文版《[独立捕获指南](https://github.com/phishdestroy/TgWitness/blob/main/docs/OPTIONAL-CAPTURE.md)》。

- **查询存档**：搜索已保存的观察记录，审查来源，然后决定 是否将其发送给 AI 模型。参见[存档分析和](https://phishdestroy.io/tgwitness/zh/docs/reference/analysis/) [本地 OCR 及转录功能](https://phishdestroy.io/tgwitness/zh/docs/reference/media-analysis/)。
- **参数**：数据收集的限制与频率、复核、下载、配置文件、 通知和导出。支持按名称搜索，显示 **仅显示已更改的** 中的值，并使用 **恢复默认值…** 将 默认值保存为草稿。**保存参数** 会从下次使用时起应用这些值， 每次更改都会生成一条日志记录。
- **访问权限**：审阅员、分析师和操作员拥有各自独立的令牌，访问范围仅限于选定的 工作区、聊天群组及权限。详见[“访问权限”部分](https://phishdestroy.io/tgwitness/zh/docs/reference/access/)。
- **系统日志** ：该进程自启动以来执行的操作（连接、代理变更、 登录、登录失败、设置变更），其中 IP 地址已被隐藏。**“跟随新行** ”功能可将最新一行始终保持在视图中。消息仅保存在日志中。
- **集成**：AI 服务提供商、[只读 MCP](https://phishdestroy.io/tgwitness/zh/docs/reference/mcp/) 连接以及 [已签名的 webhook](https://phishdestroy.io/tgwitness/zh/docs/reference/webhooks/)。
- **Case Board**：位于证据旁边的团队私有笔记、书签和片段。参见 [Case Board](https://phishdestroy.io/tgwitness/zh/docs/reference/case-board/)。
- **文档**：[调查模式](https://github.com/phishdestroy/TgWitness/blob/main/docs/INVESTIGATION-MODE.md)抽屉。当 正在记录的会话处于记录状态时，它会移至主侧边栏。
- “导出”中的 **GitHub Actions capture**：从您的分支中捕获的一段聊天记录。参见 [密封捕获](https://github.com/phishdestroy/TgWitness/blob/main/docs/SEALED-ACTIONS.md)。
