-
Notifications
You must be signed in to change notification settings - Fork 11
Home
Gentlesprite edited this page Mar 20, 2025
·
22 revisions
🚨 问题原因
- 旧版客户端（pyrogram）被Telegram官方淘汰，触发强制登出机制。
🔧 解决方案
-
更新软件 → 升级至
≥v1.1.9版本。 - 重新登录 → 在手机设备上完成Telegram账号验证。
-
清理缓存 → 删除软件目录下的
sessions文件夹。 - 版本控制 → 禁止回退旧版本客户端，避免重复触发。
🚨 问题原因
- 登录会话失效。（如用户主动终止所有会话）
🔧 解决方案
-
升级软件 → 使用
≥v1.1.9版本。 -
重置会话 → 删除
sessions文件夹。 - 重新认证 → 输入手机验证码完成登录。
🚨 问题原因
- 多开软件时,已完成的实例没有被关闭,导致进程冲突。
🔧 解决方案
- 关闭所有已下载完成的软件实例 → 确保当前进程运行正常。
🚨 问题原因
- 系统时间未同步，消息ID异常。
🔧 解决方案
-
时间校准（
Windows）：-
Win + R→ 输入timedate.cpl - 打开
Internet时间。 - 找到
time.windows.com点击同步。 - 再次打开软件重试。
-
- 重启生效 → 重新运行软件。
- 该问题已在
>=V1.5.2版本出现该类型错误时新增了捕获提示。
🚨 问题原因
- 视频文件无标题导致下载失败。
- 中文路径引发Nuitka兼容性问题。
🔧 解决方案
-
版本升级 → 更新至
≥v1.2.8版本。 - 路径规范 → 媒体保存路径改为全英文。
🚨 问题原因
- 软件内部BUG导致下载异常。
🔧 解决方案
-
修复更新 → 升级至
≥v1.2.9版本。
🚨 问题原因
- 配置文件检测逻辑BUG。
🔧 解决方案
-
逻辑优化 → 更新至
≥v1.3.0版本。
🚨 问题原因
- 网络连接超时或代理问题。（非软件缺陷）
🔧 解决方案
- 重试策略 → 多次重启软件直至进入验证界面。
🚨 问题原因
- 旧版本不支持多任务下载。
🔧 解决方案
-
功能升级 → 更新至
≥v1.3.7版本。（支持非会员多任务）
🚨 问题原因
- 只是显示问题，并不会重复下载这个媒体，由于软件最初未做文件名显示长度的截断，在文件名过长时就会导致进度条强制换行。
🔧 解决方案
-
修复更新 → 更新至
≥v1.4.1版本。
🚨 问题原因
-
旧版本不支持类似
https://t.me/xxx/xxx/111或https://t.me/c/xxxxxxxxxx/xxx/111话题频道的下载。
🔧 解决方案
-
功能升级 → 更新至
≥v1.4.8版本。（已全面支持话题频道的下载）
🚨 问题原因
- 由于
v1.4.6存在正常频道的私密链接(/c)解析错误问题，v1.4.7存在话题频道的私密链接(/c)解析错误问题，请优先排查当前使用的版本是否为v1.4.6或v1.4.7。 - 当前账号可能并未加入当前下载的私密频道。
🔧 解决方案
-
修复更新 → 更新至
≥v1.4.8版本。（已全面支持话题频道的下载） - 确保登录账号已加入该私密群组当中，尝试将当前用于登录的账号加入该私密频道中再次尝试下载。
🔍 问题汇总
- 转发功能需要使用版本
>=v1.5.1。 - 目前转发功能暂不支持从
话题频道与评论区转发。 - 消息能否转发，在于频道是否开启了
限制保存内容功能。 - 如果无法转发，机器人会在聊天框提供一个下载按钮。
🚨 问题原因
- 当前使用的
本地网络异常。 - 当前使用的
VPN异常。 - 当前在
软件配置的代理可能是错误的,以及VPN软件是否允许当前设置的代理端口连接。
🔧 解决方案
- 检查
本地网络是否正常。 - 检查
VPN是否可用。 - 检查
软件代理是否配置正确,并且在VPN软件中检查,当前设置的代理端口是否允许连接。 - 该问题已在
>=V1.5.3版本出现该类型错误时新增了捕获提示。
🚨 问题原因
- 如果是下载评论区文件时候出现的,排查是否版本是否
<1.5.7。 - 如果是指定了特定下载类型出现的:
- 链接统计表仅会统计所有支持的类型，并不会只统计用户当前所选择的类型。
- 当用户未选择下载所有支持的类型时，在用户所选择的类型下载完成后(或使用机器人发送链接统计表)，尽管所有用户指定类型的文件已经下载完成，当链接统计表显示
完成率不为100%时，代表该链接还存在其他用户未指定的文件类型，但实际用户所指定的类型已经下载完成了，是正常情况。 - 可能会在后续版本完善这个问题。
🔧 解决方案
-
修复更新 → 更新至
≥v1.5.7版本。
- 版本管理 → 定期检查更新，优先解决版本依赖问题。
- 路径规范 → 避免中文路径，防止解析异常。
- 网络优化 → 使用稳定代理，确保低延迟连接。
- 时间同步 → 定期校准系统时间，避免ID异常。
🔗 扩展阅读：
注：若问题仍未解决，可参考原文中的联系方式获取进一步支持。
符号说明
- ✦ 问题分类标识。
- → 操作步骤引导。
- 🚨 问题原因强调。
- 🔧 解决方案图标。
- 📌 关键注意事项。
- 🔍 问题汇总图标。