快速入门
主界面功能概览
1
消息下载
下载单个或多个 Telegram 消息中的文件
2
频道下载
批量下载整个频道、群组或私聊内容
3
配置管理
设置下载路径、代理和 API 凭据
4
个性化设置
切换语言、主题，自定义界面
✅ 支持的聊天类型 (v2.0.0.6)
- ✅ 频道消息下载
- ✅ 超级群组消息下载
- ✅ 普通群组消息下载
- ✅ 私聊消息下载
- ✅ 机器人对话消息下载
所有类型的聊天都可以通过"频道下载"标签页访问和下载文件，实现了完整的 Telegram 消息下载覆盖。
消息下载
新建下载任务
1
点击"新建下载"按钮
在主界面找到"新建下载"按钮并点击
2
输入消息链接
支持以下格式：
https://t.me/channel_name/123- 公开频道/群组链接msg://chat_id/message_id- 程序内部链接（普通群组、私聊、机器人）
💡 可以输入多个链接，每行一个或用逗号分隔
3
配置重命名规则（可选）
- 作者名称：添加作者名称到文件名
- 时间戳：添加下载时间戳
- 自定义信息：添加自定义文本
- 保留原文件名：保留原始文件名
文件命名示例：
张三_20251204_120000_会议录像.mp44
高级选项
- 下载评论区媒体：同时下载消息评论区的所有媒体文件
- 强制去重：基于文件唯一标识自动跳过重复文件
链接类型说明
| 聊天类型 | 公开链接 | 程序内部链接 | 说明 |
|---|---|---|---|
| 频道 | ✅ https:// | - | 可复制公开链接分享 |
| 超级群组 | ✅ https:// | - | 可复制公开链接分享 |
| 普通群组 | ❌ 无 | ✅ msg:// | 仅程序内使用 |
| 私聊 | ❌ 无 | ✅ msg:// | 仅程序内使用 |
| 机器人 | ❌ 无 | ✅ msg:// | 仅程序内使用 |
管理下载任务
任务状态
- 等待中 - 任务已添加，等待下载
- 正在下载 - 任务正在执行
- 已暂停 - 已被用户暂停
- 已完成 - 下载完成
- 失败 - 下载出错
- 已取消 - 已被用户取消
批量操作
- 全选当前页：全选当前标签页中所有任务
- 暂停下载：暂停选中的正在下载任务
- 开始下载：恢复暂停的下载任务
- 删除选中：删除选中任务（会清理已下载文件）
- 清空当前状态：删除当前标签页所有任务
频道下载
⚠️ 会员专属功能
频道批量下载功能需要高级会员权限。消息下载功能对所有用户开放。
加载和筛选频道
1
刷新频道列表
点击"刷新频道"按钮加载您的所有聊天（包括频道、群组、私聊、机器人）
2
搜索和选择
使用搜索框查找特定频道，然后选择要下载的频道
3
设置筛选条件
点击"筛选"按钮，可以设置：
- 关键字：搜索包含特定关键字的消息
- 文件类型：视频、音频、图片、文档、其他
- 日期范围：设置起始和结束日期
- 文件大小：设置最小和最大文件大小（MB）
下载普通群组/私聊消息（v2.0.0.6 新增）
现在支持下载无公开链接的聊天内容！
- 在频道列表中选择普通群组、私聊或机器人对话
- 设置筛选条件（可选）
- 点击消息行的"下载"按钮或勾选多条后点击"下载选中"
- 程序会自动识别并添加到下载队列
批量下载
下载筛选结果
点击"下载筛选结果"按钮可批量下载所有符合筛选条件的消息：
- 确认筛选条件
- 配置下载规则（重命名、评论区、去重）
- 点击"开始获取并下载"
下载选中消息
- 勾选要下载的消息（或点击"全选"）
- 点击"下载选中"按钮
- 配置下载规则
- 确认添加到下载列表
配置管理
基本配置
下载路径设置
设置文件的下载保存位置（默认为系统下载文件夹）。点击"浏览"按钮选择其他文件夹。
手机号配置
绑定 Telegram 账号手机号，格式：+86 138XXXXXXXX
💡 首次使用时需要登录 Telegram 账号
API 配置
使用默认凭据（推荐）
- ✅ 使用助手提供的 API 配置
- ✅ 简单易用、无需配置
- ⚡ 下载速度：1-3 个并行任务
代理配置
支持的代理类型
- SOCKS5（推荐）：兼容性好
- HTTP：部分场景适用
配置步骤
- 选择代理类型
- 填写代理地址和端口
- 如需认证，填写用户名和密码
- 点击"测试代理"验证连接
💡 也可以点击"导入系统代理"自动检测并导入系统代理设置
网络诊断
如果遇到连接问题，可使用"网络诊断"功能：
- 全面检测网络环境
- 诊断 Telegram 连接状态
- 提供修复建议
语言与主题
语言切换
支持以下语言：
- 简体中文
- 繁体中文
- English
切换后立即生效，影响所有界面文本、菜单、按钮和帮助文档。
主题管理
提供多种预设主题。主题切换会影响：
- 主窗口配色
- 按钮和控件颜色
- 进度条样式
- 表格主题
高级功能
用户信息
点击左侧菜单"高级" → "用户消息"查看：
非会员用户
- 当前用户 ID
- 下载速度和限制说明
- 升级会员引导
会员用户
- 会员信息
- 会员到期时间
- 享有的权限列表
- 续费和升级选项
会员权益
- ✨ 频道批量下载功能
- 👨💼 优先客服支持
帮助中心
常见问题
Q1: 下载速度很慢怎么办？
- 检查网络连接是否正常
- 检查代理设置，尝试更换代理服务器
- 减少并行下载数量
- 尝试使用 VPN 连接
- 考虑使用自己的 API 凭据以提升速度
Q2: 无法连接 Telegram 怎么办？
- 检查网络是否可以正常访问 Telegram
- 在配置中设置代理服务器
- 使用"网络诊断"功能检测问题
- 尝试使用 VPN 或更换网络环境
Q3: 下载任务失败怎么办？
- 查看失败原因（悬停在状态上可查看详情）
- 检查消息链接是否有效
- 确认是否有权限访问该消息
- 尝试重新登录 Telegram
- 如持续失败，请联系技术支持
Q4: 重命名规则如何设置？
在添加下载任务时可以配置：
- 勾选"作者名称"：文件名前添加作者
- 勾选"时间戳"：添加下载时间
- 填写"自定义信息"：添加自定义文本
- 勾选"保留原文件名"：保留原始名称
最终格式：作者_时间戳_自定义信息_原文件名
Q5: 什么是强制去重？如何工作？
强制去重功能会根据文件的 Telegram 内部唯一标识（文件 ID 和哈希值）检测重复文件：
- 开启后，系统会自动检测是否已下载过该文件
- 如发现重复，会跳过下载并显示已有文件位置
- 避免重复下载，节省存储空间和时间
Q6: 为什么有些消息无法复制链接？（v2.0.0.6 新增）
普通群组、私聊、机器人的消息没有公开链接：
- Telegram 只为频道和超级群组提供公开链接
- 这类消息可通过"频道下载"标签页直接下载
- 点击"下载"按钮会自动添加到下载队列
- 无需复制链接，程序会自动处理
Q7: 普通群组的消息如何下载？
- 打开"频道下载"标签页
- 在列表中选择普通群组
- 查看并筛选消息
- 点击"下载"按钮或"下载选中"
- 程序会自动识别并下载
Q8: 私聊和机器人的文件可以下载吗？
可以！v2.0.0.6 版本开始支持所有聊天类型：
- 在"频道下载"标签页选择私聊或机器人对话
- 查看消息列表，点击下载即可
- 下载流程与频道消息完全相同
- 支持所有高级选项（重命名、去重等）
Q9: 频道下载需要会员吗？
Q10: 如何查看下载日志？
下载日志保存在程序根目录：
- 日志文件夹：
cache/logs/ - 数据库文件：
telegram_downloader.db - 如遇问题，可将日志发送给技术支持
📋 版本历史
v2.0.0.6 (2025-12-05)
- ✨ 新增：支持无公开链接的消息下载（普通群组、私聊、机器人）
- ✨ 新增：双模式下载架构（链接模式 + 消息对象模式）
- 🔧 优化：复制链接功能，过滤无效的伪链接
- 🎉 改进：支持所有 Telegram 聊天类型的文件下载
v1.0 (2025-12-04)
- 🎉 初始版本发布
- 📥 消息下载功能
- 📺 频道下载功能
- ⚙️ 配置管理功能
- 🎨 主题管理
- 👥 会员系统
🆘 技术支持
如果您遇到问题或有任何疑问：
- 📖 查看 使用指南
- ❓ 浏览 常见问题
- 🌐 访问官网：www.tgload.com
- 📝 提交反馈（在软件"关于"页面获取联系方式）
感谢使用 TG下载助手！
如有任何建议，欢迎随时联系我们。