参考 / 收集
Telegram · 秘密聊天:设置与记录
安装秘密聊天协议扩展,按账户启用,并记录 TgWitness 创建或接受的聊天。
已发布的应用程序包含“秘密聊天”后端、收集器集成、 API 路由以及 Pseudo-secret 接口。协议库是一个独立的模块: 打开 Pseudo-secret,点击安装并开启。自动接受来信 功能默认处于关闭状态,需手动开启。
协议模块#
| 模块 | kiaro-telethon-secret-chat 0.2.0 |
| 作者 | KiaroSama |
| 许可协议 | GPL-3.0-or-later;其 LICENSE 且 NOTICE 保留在保存的归档文件中 |
| 来源 | KiaroSama/Telethon-Secret-Chat 在提交时 d87bf037b90060383c7b704d8a06ebb98c621c6f |
| 检查 | SHA-256 c80feb9b5bc28201677c140d20930fbd730d7efdebb8ca789a19040c3f00ce5c 对软件包文件列表及其各自的 SHA-256 值进行校验 |
安装并启用功能仅对主管理员开放。TgWitness 会通过工作区用于处理
Telegram 外部请求的通道,从 GitHub 下载该提交的
源代码归档包,将包中的每个文件与
TgWitness 发布版本中固定的值进行比对,将归档包保存至 modules/telethon-secret-chat-<commit>.zip 数据目录中,
并从内存中加载代码。无需重启。每次启动时都会
重新运行检查;若归档文件存在差异,则不会被加载,页面上会显示相应提示。
若包文件发生更改、缺失或被添加,检查将失败。
该模块是一个独立作品,拥有自己的许可协议。TgWitness 并不随软件分发该模块:每次 安装时,系统都会从作者的代码库中下载该模块。页面上的详细信息会显示 已加载的模块、其作者、许可协议、提交信息和 SHA-256 值。
如果主机无法访问 GitHub,则可以将相同的提交安装到 Python 环境中;随后,控制面板将使用该副本:
python -m pip install ".[secret-chats]"
TgWitness 成为其创建或接受的聊天窗口的端点。它将 消息、可用附件、计时器变更及删除通知记录在已签名的 日志中。先前保存的内容在后续收到删除通知后仍可访问。
软件包可用性#
2026
年11月8
日,已发布的安装包在源代码
b35f8e18f3d1
处经过验证,
发布版本b35f8e18f3d1-1ff85ec98bb2
,版本0.9.1
预览版。
不可变的
Wheel及其依赖项锁已通过SHA-256
和RSA发布签名验证。
打包后的后端和接口与该源代码修订版本字节对字节完全一致。
该包还包含API注册和收集器挂钩。
该软件包中不包含协议库,且该库也不在依赖项
锁定文件中。pyproject.toml 文件中 secret-chats pyproject.toml 文件中的 extra 项锁定了与
面板按钮相同的提交。
此软件包检查确定了哪些文件和依赖项声明被包含在内。 验证记录标识了各自独立的运行时检查。 此前 11 月 6 日的指南描述了一个开发快照;它不再 描述上述软件包。
使用该接口#
打开 Pseudo-secret,如果页面提供该模块,请安装它,然后为该账户启用并连接。 除非启用了自动接受功能,否则传入的请求将等待接受。 启动、接受、发送和关闭操作均使用该账户的交互权限 和只读保护。
| 操作 | 保留的结果 |
|---|---|
| 通过用户名或用户 ID 发起聊天 | 出站请求;对等方在其设备上接受该请求。 |
| 接受请求 | TgWitness将成为接收端点。 |
| 发送或接收消息 | secret_chat.message,包括其方向、内容及提供的计时器。 |
| 接收文件 | 由 SHA-256 和 secret_chat.file 收据保护的解密字节;包含在证据导出中。 |
| 接收计时器或删除通知 | 除保留的消息和文件外,还包含一份独立的操作记录。 |
| 审查聊天记录 | 对话、文件收据、通知和密钥可视化。 |
在另一台设备上现有的秘密聊天将保留其设备专属密钥。 导入的云会话不会传输这些密钥。秘密聊天的密钥素材和 计数器使用工作区保险库;已保存的消息和解密后的文件则采用 常规的工作区存储保护机制。
查找已保存的消息#
在已打开的聊天窗口中使用搜索消息功能查找精确短语,且不区分 大小写。在搜索框中点击上一条和下一条,或按下“Enter”和“Shift+Enter”, 可在匹配的消息之间切换。计数器显示消息数量;每条消息中第一个匹配的 短语会被高亮显示。按“Esc”键可清除搜索内容。
“搜索”功能会将周围的对话、已保存的文件和删除提示 保持在可见状态。它会搜索面板中已加载的记录。如果还有 更早的记录,面板会予以提示;加载更早的记录会扩展历史记录并 更新搜索结果,同时保持当前消息的位置不变。
在同一工作区内切换时,每个聊天窗口都会保留其搜索记录。锁定 面板或切换工作区会清除这些搜索记录。搜索词保存在 页面的内存中,不会存储在浏览器存储中,也不会作为 API 查询发送出去。 搜索操作不会发送 Telegram 消息,也不会触发输入/已读通知。现有的 可见性设置仍将控制打开聊天窗口及其他操作。
生成报告时将保留所选聊天的报告范围;显示搜索 不会在后台限制导出的记录。请在下载报告前 预览报告的选定范围。
持久化与交互控制#
该集成实现采用持久日志查询进行重复检测, 在下载失败后将附件任务保持为待处理状态,并将关闭操作通过 与其他远程操作相同的交互守护程序进行路由。这些机制取代了 历史上的 11 月 6 日开发快照审计中报告的三条路径。
解密后但日志写入失败的消息将保存在保险库中以供重试。 系统会根据附件大小和可用磁盘空间进行检查,在保留相关任务的同时推迟下载。 该模块会复用该账户的现有连接。阅读和输入通知仅在 对方可见内容中选定的情况下发送;截图 通知绝不会发送。参见 secret_chats.py、 API 路由和 访问策略。
历史审计保留其原始 快照结果。当前的可用性和实现情况应参考 上方的软件包修订版本及当前功能说明。
界面演示#
网站场景使用虚构的请求、消息和文件来演示 面板的工作流程。这是一个界面示例;协议和采集检查 在验证记录中各有其带日期的结果。