核心用法
该 Skill 基于 Pyrogram/Telethon 双后端，通过 Telegram 官方 MTProto 协议实现直连，无需 Bot API 即可读取任意公开频道及用户已加入的私密频道内容。核心命令包括：
tg-reader-check：离线预检，验证凭证与会话文件状态tg-reader info @channel：获取频道元数据（订阅数、描述等）tg-reader fetch @channel --since 24h：按时间窗口抓取帖子，支持--comments获取讨论区回复
支持多频道顺序抓取（自动 10 秒间隔防风控）、纯文本过滤、Telethon 备用切换，并可输出至文件以节省 Token。
显著优点
1. 协议级访问：绕过 Bot API 限制，可读取非 Bot 管理员的频道内容及评论
2. 结构化输出：JSON 格式包含阅读量、转发数、媒体类型、评论数等完整元数据
3. 风控友好：内置指数退避重试、自动延迟调节，错误类型标准化（flood_wait、access_denied 等）便于程序化决策
4. 双引擎冗余：Pyrogram（默认）与 Telethon 可一键切换，降低单点故障风险
5. Token 经济模式：--output 模式将大数据量结果写入文件，仅返回摘要，显著降低 LLM 上下文消耗
潜在局限与风险
| 局限 | 说明 |
|------|------|
| 凭证门槛 | 需从 my.telegram.org 申请 `api_id`/`api_hash`，对普通用户有一定技术门槛 |
| 会话绑定 | 会话文件与设备/网络环境强绑定，Docker 隔离模式易出现 `AUTH_KEY_UNREGISTERED` 失效 |
| 评论媒体盲区 | 评论中的图片/视频仅标记存在性，无 OCR 或视觉分析 |
| 速率天花板 | Telegram 服务器级风控不可完全规避，高频监控仍可能触发冷却 |
| 隐私合规 | 抓取非公开频道或评论区用户数据需确保符合 GDPR/数据安全法 |
适合人群
- 舆情分析师与 OSINT 研究员：需批量监控 Telegram 信息源
- 内容聚合开发者：构建频道摘要、热点追踪自动化工作流
- 社区运营者：跟踪竞品频道动态或用户反馈
常规风险
- 凭证泄露：
TG_API_HASH与会话文件等同于账号密码，泄露即丧失账号控制权 - 账号封禁：异常高频抓取或行为模式触发 Telegram 反滥用策略
- 数据滞留：默认输出文件
tg-output.json需定期清理，避免敏感信息本地堆积