TGWITNESS / 参考
Telegram · 参考
本项目所有文档均在此呈现,并附有相应图表。指南提供了快速入门路径;而这些页面则包含所有细节。
设置
TgWitness:开始、规模与证据
通过一条命令安装,或在 GitHub Actions 上进行捕获。了解调查选项、已发布的规模以及存档所验证的内容。
02快速入门
安装和启动 TgWitness 的所有方法:Windows 安装包、Python、Docker 以及综合演示,并附带初步测试。
03安装、验证和更新
只需一条命令即可完成安装、验证签名和哈希值,以及更新和卸载该工具。
04初始设置与配置
设置向导、目标、界面层级、连接路径以及账户组共享的设置。
05账户与会话格式
支持通过手机、二维码或授权密钥登录,可导入 Telethon、Pyrogram 或 Telegram Desktop 的会话数据,并同时管理多个账户。
06访问与权限
设置账户和聊天室的访问权限范围,选择权限类型,限制会话和 IP 地址,并撤销访问权限。
07连接、代理和数据保护
身份验证、自动代理池、IP 模式、备用策略、外部请求及密钥存储。
08部署
可在 Windows、Linux、macOS 或 Docker 环境中将 TgWitness 作为服务运行,通过 HTTPS 访问,并支持备份和更新。
09高可信度部署
部署在 Hetzner 或 Phala Cloud 上的全天候密封服务器、网关 DNS 以及第三方可复现的验证机制。
收集
面板指南
面板的每个界面:聊天、日志、来源、导出、扩展功能、保护模式和代码检查。
11数据采集原理
观察范围、实时更新、复核、附件、用户操作以及“缺口”的含义,逐条记录。
12秘密聊天:设置与记录
安装秘密聊天协议扩展,按账户启用,并记录 TgWitness 创建或接受的聊天。
13加载源代码历史记录
从已启用的来源加载历史消息,暂停和恢复操作,并验证带签名的进度报告。
14工作流程与操作
控制面板的日常操作:模式、监控类别、参数、通知、导出、备份及容量。
15调查模式
涵盖频道、群组、私聊和机器人的全账户调查,从调查范围到经过验证的案件资料包。
16功能与范围
TgWitness 的当前采集模型、多账户工作流、导出功能及操作边界。
存档与集成
“案件看板”参考
书签、精确高亮、操作片段、讨论、范围访问以及“案件看板”所使用的签名注释历史记录。
18存档分析
搜索已保存的消息、审查 AI 输入内容,并保存附有来源参考信息的分析报告。
19全文搜索
根据词形、精确短语、域名和 @用户名 查找已保存的消息,按最匹配结果优先排序,索引与签名日志绑定。
20只读 MCP
将 MCP 客户端连接到选定的工作区和聊天群组,并授予具有时效性且可撤销的访问权限。
21命令行
支持通过脚本和代理进行搜索、阅读上下文、统计活动以及导出已保存的消息,提供 --json 输出格式、稳定的退出代码以及作用域限定的只读令牌。
22本地 OCR 和转录
通过本地工作进程识别捕获的图像和音频;将生成的文本与源文件保持关联。
23外发 webhook
将带 HMAC 签名的指定范围事件发送至 HTTPS 接收端,支持重试并提供投递状态。
24公开展示
通过有效期有限且可撤销的链接,发布所选公共频道的已保存消息和已签名的快照。
证据
证据的运作原理
通过验证者实际使用的精确公式,详细解释了哈希链、签名、检查点和见证人等概念。
26报告配置与验证
报告过滤器、八种设计模板、内容预设、已保存的变更历史记录以及评估结果均包含在已签名的导出文件中。
27账户导出
导出该账户当前可读取的内容:范围、可恢复的任务、经签名的存档以及已缩减的共享副本。
28证据格式
签名 ZIP 文件的内容、记录类型、操作收据、用户资料、异地副本及离线验证。
29为法院翻译报告
哪个文件是原件、应与认证译文一同提交什么,以及译者应保留的术语。
30独立见证者
运行一个带有独立密钥和机器人的 Witness 实例,将签名后的检查点发布到频道中,并据此验证导出数据。
31时间戳
签名检查点采用 RFC 3161 时间戳:向认证机构发送的内容以及如何验证响应。
32存储与恢复
备份、将旧文件移至云端、Object Lock 下的副本以及在新设备上的恢复。