# TgWitness · 简体中文

> Documentation edition: 简体中文. Project version: `0.9.1`. Source branch: `main`.

This index links the Markdown editions of the public pages. The complete handbook is built from the same page content, including source URLs. Untranslated sections retain the English original; a language edition is not a claim that every section has been translated.

- [Project context, installation, measured scale and verification limits](https://phishdestroy.github.io/TgWitness/docs/reference/overview/index.md)

- [English project summary](https://phishdestroy.github.io/TgWitness/llms.txt)

- [Complete handbook · 简体中文](https://phishdestroy.github.io/TgWitness/zh/llms-full.txt)

- [Complete handbook as Markdown · 简体中文](https://phishdestroy.github.io/TgWitness/zh/llms-full.md)

- [Source code and release history](https://github.com/phishdestroy/TgWitness)

- [Collection modes and evidence levels](https://phishdestroy.github.io/TgWitness/zh/guides/modes.md)

- [Published checks and measurements](https://phishdestroy.github.io/TgWitness/docs/validation/index.md)


## Complete documentation map

### Guides

- [浏览存档](https://phishdestroy.github.io/TgWitness/zh/docs/archive/index.md): 加载历史记录、搜索已保存记录、审查 AI 来源并连接您的工具。
- [GitHub Actions 捕获](https://phishdestroy.github.io/TgWitness/zh/docs/capture/index.md): 在临时 GitHub runner 上选择 Takeout、常规 API 导出或聊天日志．
- [专用账号](https://phishdestroy.github.io/TgWitness/zh/docs/dedicated-account/index.md): 请准备一个单独的 Telegram 账号用于数据采集。
- [几分钟内即可开始使用](https://phishdestroy.github.io/TgWitness/zh/docs/start/index.md): 通过一条命令安装，连接 Telegram 账号，即可在 Windows、Linux 或 macOS 上导出可验证的存档。
- [连接账户](https://phishdestroy.github.io/TgWitness/zh/docs/accounts/index.md): 可通过二维码、电话号码或会话导入连接 Telegram。选择消息来源，并确认新消息已成功记录到您的日志中。
- [选择代理](https://phishdestroy.github.io/TgWitness/zh/docs/proxies/index.md): 维护自动 MTProxy 路由，或使用您自己的代理。选择 IP 模式、备用规则以及外部请求的路由。
- [导出与验证](https://phishdestroy.github.io/TgWitness/zh/docs/exports/index.md): 导出捕获的 Telegram 聊天记录，验证签名，并将日志与独立见证人保留的检查点进行比对。
- [了解证据如何运作](https://phishdestroy.github.io/TgWitness/zh/docs/concepts/index.md): 追踪一条消息从捕获到检查点的全过程。修改一条示例记录，重新计算其 SHA-256 链，并查看保留的检查点会检测到什么。
- [跨所有聊天记录进行调查](https://phishdestroy.github.io/TgWitness/zh/docs/cases/index.md): 在频道、群组、私聊和机器人中开展端到端的 Telegram 调查：包括整个账户的捕获、历史记录、联系人、链接、文件、时间线以及经过验证的证据。
- [创建案件看板](https://phishdestroy.github.io/TgWitness/zh/docs/case-board/index.md): 在私人看板上收集已保存的观察结果、精确标注和操作片段，与团队讨论并提交证据集合。
- [设计报告](https://phishdestroy.github.io/TgWitness/zh/docs/reports/index.md): 选择报告数据、八种设计模板之一及内容，然后预览并导出 HTML、带签名的 PDF 或完整的证据包。
- [准备一份共享副本](https://phishdestroy.github.io/TgWitness/zh/docs/handover/index.md): 选择收件人可接收的记录和字段，检查最终副本，并验证其已签名的清单及源日志边界。
- [管理一组账户](https://phishdestroy.github.io/TgWitness/zh/docs/groups/index.md): 比较群组工作区、查找来源、审查观察时段，并应用共享设置（可针对每个账户设置例外）。
- [确保安全](https://phishdestroy.github.io/TgWitness/zh/docs/security/index.md): 了解会话、密钥和证据的存储位置，哪些数据会离开您的设备，保护措施涵盖哪些内容，以及如何加强系统安全性。
- [分享案例](https://phishdestroy.github.io/TgWitness/zh/docs/access/index.md): 为审查员和分析师提供对选定账户和聊天的访问权限，并设置独立的权限、会话限制和可撤销的令牌。
- [设置 Witness 机器人](https://phishdestroy.github.io/TgWitness/zh/docs/witness/index.md): 通过独立的见证节点（配备专属密钥及只读收集器访问权限），将签名的日志检查点发布至您的 Telegram 频道。
- [保持其运行](https://phishdestroy.github.io/TgWitness/zh/docs/server/index.md): 请在配备持久化存储、私有控制面板访问权限、备份功能以及重启后自动检查机制的服务器上运行 TgWitness。
- [查找问题所在](https://phishdestroy.github.io/TgWitness/zh/docs/troubleshooting/index.md): 请使用针对各问题的正确信号，检查控制面板访问权限、Telegram 连接状态、消息缺失情况、FloodWait 状态以及见证状态。

### Reference

- [秘密聊天：实现与演示](https://phishdestroy.github.io/TgWitness/zh/docs/reference/secret-chats/index.md): 了解独立的秘密聊天实现方式，试用虚构的界面，并审查未解决的缺陷。
- [TgWitness：开始、规模与证据](https://phishdestroy.github.io/TgWitness/zh/docs/reference/overview/index.md): 通过一条命令安装，或在 GitHub Actions 上进行捕获。了解调查选项、已发布的规模以及存档所验证的内容。
- [加载源代码历史记录](https://phishdestroy.github.io/TgWitness/zh/docs/reference/history/index.md): 从已启用的来源加载历史消息，暂停和恢复操作，并验证带签名的进度报告。
- [存档分析](https://phishdestroy.github.io/TgWitness/zh/docs/reference/analysis/index.md): 搜索已保存的消息、审查 AI 输入内容，并保存附有来源参考信息的分析报告。
- [命令行](https://phishdestroy.github.io/TgWitness/zh/docs/reference/cli/index.md): 支持通过脚本和代理进行搜索、阅读上下文、统计活动以及导出已保存的消息，提供 --json 输出格式、稳定的退出代码以及作用域限定的只读令牌。
- [全文搜索](https://phishdestroy.github.io/TgWitness/zh/docs/reference/search/index.md): 根据词形、精确短语、域名和 @用户名 查找已保存的消息，按最匹配结果优先排序，索引与签名日志绑定。
- [只读 MCP](https://phishdestroy.github.io/TgWitness/zh/docs/reference/mcp/index.md): 将 MCP 客户端连接到选定的工作区和聊天群组，并授予具有时效性且可撤销的访问权限。
- [本地 OCR 和转录](https://phishdestroy.github.io/TgWitness/zh/docs/reference/media-analysis/index.md): 通过本地工作进程识别捕获的图像和音频；将生成的文本与源文件保持关联。
- [外发 webhook](https://phishdestroy.github.io/TgWitness/zh/docs/reference/webhooks/index.md): 将带 HMAC 签名的指定范围事件发送至 HTTPS 接收端，支持重试并提供投递状态。
- [运营商兼容性通知](https://phishdestroy.github.io/TgWitness/zh/docs/reference/notice/index.md): 关于 Taylor Wessing 及其来源记录的操作员通告。
- [许可协议与架构不兼容声明](https://phishdestroy.github.io/TgWitness/zh/docs/reference/license/index.md): TgWitness 采用 MIT 许可证向所有人开放，并解释了其架构为何与 Taylor Wessing 的工作流程不兼容。
- [快速入门](https://phishdestroy.github.io/TgWitness/zh/docs/reference/quickstart/index.md): 安装和启动 TgWitness 的所有方法：Windows 安装包、Python、Docker 以及综合演示，并附带初步测试。
- [账户与会话格式](https://phishdestroy.github.io/TgWitness/zh/docs/reference/accounts/index.md): 支持通过手机、二维码或授权密钥登录，可导入 Telethon、Pyrogram 或 Telegram Desktop 的会话数据，并同时管理多个账户。
- [访问与权限](https://phishdestroy.github.io/TgWitness/zh/docs/reference/access/index.md): 设置账户和聊天室的访问权限范围，选择权限类型，限制会话和 IP 地址，并撤销访问权限。
- [连接、代理和数据保护](https://phishdestroy.github.io/TgWitness/zh/docs/reference/connection/index.md): 身份验证、自动代理池、IP 模式、备用策略、外部请求及密钥存储。
- [部署](https://phishdestroy.github.io/TgWitness/zh/docs/reference/deployment/index.md): 可在 Windows、Linux、macOS 或 Docker 环境中将 TgWitness 作为服务运行，通过 HTTPS 访问，并支持备份和更新。
- [数据采集原理](https://phishdestroy.github.io/TgWitness/zh/docs/reference/collection/index.md): 观察范围、实时更新、复核、附件、用户操作以及“缺口”的含义，逐条记录。
- [工作流程与操作](https://phishdestroy.github.io/TgWitness/zh/docs/reference/operations/index.md): 控制面板的日常操作：模式、监控类别、参数、通知、导出、备份及容量。
- [调查模式](https://phishdestroy.github.io/TgWitness/zh/docs/reference/investigation/index.md): 涵盖频道、群组、私聊和机器人的全账户调查，从调查范围到经过验证的案件资料包。
- [“案件看板”参考](https://phishdestroy.github.io/TgWitness/zh/docs/reference/case-board/index.md): 书签、精确高亮、操作片段、讨论、范围访问以及“案件看板”所使用的签名注释历史记录。
- [报告配置与验证](https://phishdestroy.github.io/TgWitness/zh/docs/reference/case-reports/index.md): 报告过滤器、八种设计模板、内容预设、已保存的变更历史记录以及评估结果均包含在已签名的导出文件中。
- [功能与限制](https://phishdestroy.github.io/TgWitness/zh/docs/reference/features/index.md): TgWitness 的当前采集模型、多账户工作流、导出功能及操作边界。
- [证据的运作原理](https://phishdestroy.github.io/TgWitness/zh/docs/reference/how-it-works/index.md): 通过验证者实际使用的精确公式，详细解释了哈希链、签名、检查点和见证人等概念。
- [证据格式](https://phishdestroy.github.io/TgWitness/zh/docs/reference/evidence/index.md): 签名 ZIP 文件的内容、记录类型、操作收据、用户资料、异地副本及离线验证。
- [独立见证者](https://phishdestroy.github.io/TgWitness/zh/docs/reference/witness/index.md): 运行一个带有独立密钥和机器人的 Witness 实例，将签名后的检查点发布到频道中，并据此验证导出数据。
- [时间戳](https://phishdestroy.github.io/TgWitness/zh/docs/reference/timestamp/index.md): 签名检查点采用 RFC 3161 时间戳：向认证机构发送的内容以及如何验证响应。
- [安全与数据处理](https://phishdestroy.github.io/TgWitness/zh/docs/reference/security/index.md): 威胁模型、访问模型、静态机密、网络暴露、会话导入以及如何报告漏洞。
- [架构](https://phishdestroy.github.io/TgWitness/zh/docs/reference/architecture/index.md): 收集器、控制面板、日志、工作进程和见证程序的组成部分，以及数据在它们之间如何流动。
- [已测试的内容](https://phishdestroy.github.io/TgWitness/zh/docs/reference/verification/index.md): Telegram 实时测试、自动化检查、浏览器检查以及尚未经过验证的内容。
- [更新日志](https://phishdestroy.github.io/TgWitness/zh/docs/reference/changelog/index.md): 按版本列出的所有变更，包括尚未发布的变更。
- [面板指南](https://phishdestroy.github.io/TgWitness/zh/docs/reference/panel/index.md): 面板的每个界面：聊天、日志、来源、导出、扩展功能、保护模式和代码检查。
- [初始设置与配置](https://phishdestroy.github.io/TgWitness/zh/docs/reference/settings/index.md): 设置向导、目标、界面层级、连接路径以及账户组共享的设置。
- [安装、验证和更新](https://phishdestroy.github.io/TgWitness/zh/docs/reference/installation/index.md): 只需一条命令即可完成安装、验证签名和哈希值，以及更新和卸载该工具。
- [存储与恢复](https://phishdestroy.github.io/TgWitness/zh/docs/reference/storage/index.md): 备份、将旧文件移至云端、Object Lock 下的副本以及在新设备上的恢复。
- [账户导出](https://phishdestroy.github.io/TgWitness/zh/docs/reference/account-export/index.md): 导出该账户当前可读取的内容：范围、可恢复的任务、经签名的存档以及已缩减的共享副本。
- [公开展示](https://phishdestroy.github.io/TgWitness/zh/docs/reference/showcase/index.md): 通过有效期有限且可撤销的链接，发布所选公共频道的已保存消息和已签名的快照。
- [高可信度部署](https://phishdestroy.github.io/TgWitness/zh/docs/reference/high-assurance/index.md): 部署在 Hetzner 或 Phala Cloud 上的全天候密封服务器、网关 DNS 以及第三方可复现的验证机制。