参考 / 设置

TgWitness: Telegram Export, OSINT & Verification

通过一条命令安装，或在 GitHub Actions 上进行捕获。了解调查选项、已发布的规模以及存档所验证的内容。

TgWitness 是一款开源的 Telegram 数据导出工具及调查工作区。只需一条命令即可安装，连接账户，选择聊天记录并导出经过签名的归档文件。它还支持在 GitHub Actions 上进行临时数据收集，并可通过保存的编辑记录、删除观察记录、搜索和报告功能继续开展调查。

从您手头的任务开始#

您的任务	最短路径	您将收到
保存对话或账户	安装、连接账户、选择导出范围	一个包含所选历史记录、收集结果和验证材料的签名存档
在临时运行器上收集	使用 GitHub Actions 进行数据捕获、授权新会话并选择作用域	一个包含 GitHub 工作流溯源信息的加密存档
跟踪随时间推移的变化	保持对选定聊天室的观察功能持续运行	已保存版本、删除通知、附件及记录的覆盖范围
调查并分享调查结果	搜索存档、使用案例板，并配置报告或共享副本	附有来源链接的发现结果，以及适合接收方的可验证交接流程

安装程序包含 Python 及其依赖项。源代码检出、Docker、AI 提供商和独立见证人均为可选项，并非安装的先决条件。

Linux / macOS：

curl -fsSL https://get.destroy.tools/install.sh | bash

Windows 系统，在 PowerShell 或命令提示符中：

powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "irm https://get.destroy.tools/install.ps1 | iex"

打开控制面板，连接您的 Telegram 账户并选择数据采集范围。安装过程不会自动启动数据采集。安装指南中详细说明了本地访问、服务器配置、更新以及如何验证已下载的构建版本。

若需临时运行程序，请按照 GitHub Actions 捕获指南操作。该工作流需要 GitHub 分支、授权以及归档密码。捕获页面详细说明了这些步骤以及运行前的会话时间限制。请下载并保留生成的归档文件及其验证材料。

单个聊天记录的导出需要一个账户和选定的范围。持续观察、多个账户、代理服务器、附件策略、报告设计、审核员访问权限、外部时间戳和异地存储可满足不同的调查和移交需求。在相关情况下配置这些功能。

范围、权限和最小化共享副本有助于操作员选择需要收集和披露的内容。管辖权指南和报告设置为该决策提供支持；选择配置文件本身并不构成法律合规性或可采纳性。请参阅账户导出、访问和报告配置。

该应用程序在选定的计算机或服务器上运行。基本数据采集无需 GPU 或大型语言模型（LLM）。可选的 OCR、转录和 AI 分析功能各有其资源需求。请根据消息速率、附件、历史记录保留时长和并发账户数量来规划部署规模；简便的安装并不意味着每种工作负载的内存占用量都固定不变。

其目的是保留所观察到的材料、背景及变更，无论这些内容支持何方立场。证据可能会对收集者自身对事件的叙述提出质疑。请确保原始观察结果、遗漏内容及分析结论均可被识别，以便他人能够对同一材料进行评估。

其逻辑流程为：账户可见的观察结果 → 签名日志 → 导出 → 收件人验证。保存的编辑操作会生成新版本。已删除的观察结果仍保留先前捕获的内容。覆盖记录会揭示已知的中断情况。报告和 AI 分析会回溯至已保存的来源；一种解释不会仅仅因为出现在签名报告中就成为来源观察结果。

验证检查	接收方可确认的内容
文件哈希值、签名和日志链	提供的记录和文件与预期的密钥和日志边界一致
单独保留的检查点或见证	该存档与先前保留的日志状态一致
一个经过验证的外部时间戳	在所述信任假设下，所引用的字节在时间戳时点上确实存在
GitHub 捕获证明	该归档文件符合已批准的工作流程、采集器版本及记录的摘要

这些检查支持对完整性和来源的审查。它们不会将消息内容转化为真命题，也不会还原未被查看的已删除消息。请使用独立获取的密钥指纹，并遵循《信任指南》和《证据格式》中的验证步骤。

以下结果描述了不同的工作负载和日期。计数不可互换：日志事件不一定是唯一的 Telegram 消息。

日期	工作量	发布结果	测量内容
1 11月 2026	运行中的服务器，十个工作区数据库	1,610,818条日志记录；900,232条新消息事件、80,683条编辑事件和400,536条删除事件	仅限读取的库存；并非吞吐量测试或新的全链验证
5年11月2026日	在200个聊天群组中搜索超过1,000,000条合成消息	索引构建耗时 71 秒；每次查询的中位数搜索时间为 9–190 毫秒	本地搜索基准测试；非实时 Telegram 消息投递
6年11月2026日	两份最新的真实 Telegram 导出数据	27,030和29,299条消息；两次运行共计56,329条	每次通过 WARP 运行时处理两个账户，包括文本和元数据，不下载附件
6年11月2026日	相同的两个导出操作，包括准备和打包	127.713 和 141.781 条消息/秒	测得的完整导出率；两个存档均已通过固定密钥验证

验证记录提供了服务器清单、实时数据采集检查及搜索性能指标。性能导出报告包含两次实际运行情况、硬件配置、持续时间、存档哈希值以及已签名的测量文件。这些数据仅反映特定版本和条件下的测试结果，并非普遍适用的速率或容量上限。

维护者报告称，截至 6 11月 2026. 这描述了该项目的测试历史。上文中带日期的公开测量数据记录的是单次运行情况；它们并不能证明存在经过独立验证的、连续六个月的数据收集运行。导出消息的生成时间也与收集器运行的时间不同。

针对每个工作流，结合其实现、已发布的构建版本和记录的测试结果进行评估。源代码当前标记为预览版。该发布标签与可运行的数据集、导出功能、独立验证以及已发布的规模测量结果并存。同一应用程序中可能同时存在预览功能和经过验证的工作流；请描述评估所依据的具体功能及证据。

请综合参考当前功能、特性与限制、验证信息及变更日志。引用测试结果时，请记录所测试的版本号。11月6日的测量快照中还保留了失败和跳过的测试；这些不属于通过项。

该网站提供了一份简明扼要的llms.txt文件、一份完整的英文手册（ llms-full.txt和llms-full.md），以及各页面的 Markdown 版本。这些是文档格式，并非运行 TgWitness 所需的 AI 要求。

可选的 MCP 和命令行访问功能允许授权工具读取选定的已保存记录。消息内容仍被视为不可信输入。摘要应注明来源，区分观察到的事实与推论，并保留不确定性。全文搜索、OCR 和 AI 输出不会更改原始的已签名观察结果。