核心用法
本 Skill 利用 Telethon 库通过 MTProto 用户 API（非 Bot API）获取 Telegram 聊天历史，可访问 Bot API 无法读取的消息记录。支持按聊天 ID、论坛话题 ID 检索，提供消息数量限制、分页偏移及 JSON 格式导出功能。
显著优点
1. 突破 Bot API 限制：可读取任意对话历史，包括私人群组、频道及论坛话题
2. 灵活检索：支持按数量、偏移消息 ID、特定话题维度精准定位
3. 结构化输出：JSON 格式便于后续数据处理与分析
4. 会话持久化：首次登录后 session 自动保存，无需重复验证
潜在缺点与局限性
- 认证门槛高：需手动注册 my.telegram.org 应用、交互式手机验证码登录及可能的 2FA
- 平台风险提示：Telegram 会检测并拦截通过自身网络传输的登录验证码
- 权限边界模糊：虽为"用户 API"，但批量抓取可能触发平台风控
- 无内置过滤：需自行处理大量消息数据的存储与隐私合规
适合人群
- 需要迁移或备份 Telegram 聊天记录的个人用户
- 研究社群历史数据的分析师与开发者
- 需整合 Telegram 内容至其他系统的自动化工作流
常规风险
| 风险类型 | 说明 |
|---------|------|
| 账号安全 | 需保管 api_hash、session 文件及 2FA 密码，泄露即等同于账号泄露 |
| 平台封禁 | 高频请求或异常模式可能触发 Telegram 反滥用机制 |
| 法律合规 | 抓取他人聊天记录需符合 GDPR 等数据保护法规，不得用于监控或泄露隐私 |