WINDOWS · 使用指南
Telegram 视频下载失败、登录与后台问题排查
排查 Telegram 视频下载器登录失效、频道访问错误、磁盘不足、下载停滞和后台未启动问题，保留配置与有效断点。
先做安全自检
先查看“运行”页状态并执行“运行自检”，记录脱敏错误信息、软件版本和发生步骤。不要先删除 .runtime、会话文件、数据库或断点目录。
求助时不要发送 API Hash、手机号验证码、二步验证密码或 telegram.session。会话文件具有账号登录权限，不应上传到公开论坛。
提示需要重新登录
进入“账号”页重新扫码，若有二步验证则完成密码确认，再启动后台。扫码不可用时使用手机号验证码备用方式。先确认 Telegram 客户端中该账号仍能正常使用。
后台健康运行时程序会复用登录状态。不要同时运行多个副本去反复打开同一个会话数据库。
群组或频道访问错误
在 Telegram 官方客户端中确认相同账号仍在群内或订阅频道，并能读取目标消息。加入账号不具备权限的链接不能让下载器获得权限。
单个目标访问失败不会终止其他目标扫描。程序按退避间隔重试；长期被移除、消息被删除或频道不可访问时，无法保证补回视频。
下载列表为空或历史没有开始
确认已保存至少一个监听目标。新目标默认关闭历史；如只需旧视频，可用“视频检索”手动选择。检索结果为空时检查目标、关键词和日期范围，单次结果有上限。
加入队列不等于后台已经启动；到“运行”页检查后台状态和授权是否有效。图片、GIF 和圆形视频不在当前支持范围内。
磁盘不足或移动盘断开
检查当前任务绑定的磁盘、盘符和目录是否仍可写。开始或续传前需要剩余文件大小之外的 512 MiB 安全余量。
释放原目标盘空间或重新接好移动盘，任务会保留并重试。更改保存目录不会将已有断点任务自动迁往新盘，也不会自动搬运已完成文件。
下载进度长时间没有变化
先确认网络、后台心跳和 Telegram 访问情况。连续 120 秒没有新字节时，程序会取消当前请求并进入重试，合法断点尽量保留。
速度受网络和 Telegram 服务状态影响，不建议通过反复重启或删除临时文件处理。需要人工停止时用“停止后台”，再正常启动恢复队列。
窗口关闭、重启电脑与授权到期
右上角关闭窗口会隐藏到托盘。“退出托盘”只关闭配置器和图标，不会停止后台；停止下载应先点击“停止后台”。重启电脑后需手动启动程序及后台。
授权到期后不会领取新下载任务，但不会因此删除配置、队列、断点或已下载文件。恢复有效授权后再检查运行状态；卸载重装不能重置试用。
开始使用
本工具是独立第三方软件，非 Telegram 官方产品。请遵守内容权利及群组、频道规则。