通过 MTProto 协议访问 Telegram 用户 API，突破 Bot API 限制，获取任意聊天、群组或论坛主题的历史消息，支持分页导出与 JSON 输出。
说明：
## 核心功能
`telegram-history` 利用 Telethon 库直接调用 Telegram MTProto 用户 API，解决官方 Bot API 无法读取历史消息的硬性限制。该技能支持从私聊、群组、频道及论坛主题中提取完整消息历史，提供按消息数量、偏移 ID 分页、指定话题等多种检索模式，并可导出为结构化 JSON 格式便于后续分析。
## 显著优点
1. **突破 Bot API 限制**：官方 Bot 仅能接收新消息或特定命令交互，无法追溯历史；本技能通过用户 API 实现真正的历史消息回溯。
2. **完整的元数据获取**：自动解析发送者名称、消息时间、媒体类型等完整信息，优于第三方爬虫方案。
3. **论坛主题支持**：原生支持 Telegram 论坛（Topics）架构，可精确提取特定话题下的讨论串。
4. **灵活的输出格式**：JSON 输出便于与数据分析工具链集成，支持自动化批处理。
5. **会话持久化**：一次性登录后会话长期有效，无需重复验证。
## 潜在局限与风险
**关键安全风险**：
– **账号封禁**：Telegram 对非官方客户端行为有严格风控，高频或异常模式的数据抓取可能触发账号限制甚至永久封禁。
– **2FA 凭证管理**：需在本地存储 API 凭证 (`api_id`/`api_hash`) 及用户会话，若权限配置不当存在泄露风险。
– **隐私合规**：抓取他人消息历史涉及数据隐私法规（GDPR、个保法等），需获得明确授权。
**技术局限**：
– 依赖 `my.telegram.org` 申请的 API 凭证，流程门槛较高。
– 首次登录需手机号+短信验证码+可选2FA，交互步骤繁琐。
– 大规模历史同步受 Telegram 速率限制，超量请求可能导致临时限流。
## 适用人群
– **数据分析师**：需对 Telegram 社群进行舆情分析、内容审计。
– **社区管理员**：迁移或备份历史讨论记录。
– **安全研究员**：取证分析特定群组的信息传播模式。
– **开发者**：构建 Telegram 消息归档、搜索或知识库系统。
## 常规风险管控建议
1. 使用专用小号而非主账号进行操作。
2. 控制请求频率，避免短时间内大量拉取历史消息。
3. 严格保管 `api_credentials.json` 与 `session/` 目录，建议设置 600 文件权限。
4. 遵守 Telegram ToS 及当地数据保护法规，仅操作自有或获授权的数据。
会员专属
