TgWitness文档 / 14
查找问题所在
从症状入手。逐层排查。
面板要求输入令牌
请使用启动器显示的本地文件中的面板令牌。对于 Docker，请运行 docker compose exec tgwitness cat /data/panel-token.txt。Telegram 登录码、BotFather 令牌和只读见证令牌各自具有不同的用途。
Telegram 无法连接
打开连接设置并运行连接检测。如果使用公共代理，请尝试其他条目并显式保存路由。检查代理类型和支持的密钥格式。刷新公共列表不会切换该账户的路由。
已连接，但无新消息
- 请确认观察任务正在正确的作业空间中运行。
- 请确认该来源已被选中且对该账户可见。
- 在受控群组中发送一条唯一的新消息，并查找该消息中完全相同的文本内容。
- 请查阅操作日志，以确认是否存在中断、工作延迟或 Telegram 错误。
历史快照与新消息事件有所不同。静默源可在不产生新消息的情况下连接。当完整性至关重要时，请使用受控交付测试。
重启后出现 FloodWait 或间隔
“FloodWait” 表示 Telegram 需要暂停。请等待指定时间并检查数据采集工作量；反复重新连接不会解除该限制。保存的更新状态有助于在重启后补上进度，但过期的更新和某些中断时段仍会造成限制。请记录数据缺口，而非将日志视为完整。
该机器人已配置完毕，但尚未发布任何内容
请确保见证进程正在运行，机器人能够向频道发布消息，且见证服务能够连接到收集器和机器人 API。检查其日志中是否存在发布失败的情况。仅成功轮询收集器并不能证明已成功向频道发布消息。
GitHub 令牌集成功能在哪里？
计划中。“扩展功能”部分描述了拟议的分叉和构建验证工作流。目前尚无 GitHub 令牌表单，也无法自动验证运行中的安装是否与代码库匹配。请参阅当前功能状态。
报告问题时，请提供版本号、操作系统、操作步骤以及经过遮蔽处理的错误信息。请勿在公开问题中透露会话信息、令牌、私信及数据目录。