核心用法
tg-channel-reader 是基于 MTProto 协议（Pyrogram/Telethon）的 Telegram 频道读取工具，支持获取公开/私密频道的帖子与评论讨论。
主要功能
| 命令 | 用途 |
|------|------|
| `tg-reader-check` | 预检诊断，离线验证凭证与会话状态 |
| `tg-reader info @channel` | 获取频道元数据（标题、订阅数、描述） |
| `tg-reader fetch @channel --since 24h` | 按时间窗口获取帖子，支持 `--comments` 拉取评论 |
| `tg-reader auth` | 首次认证，生成会话文件 |
特色能力：
- 未读追踪模式：
"read_unread": true实现增量监控，自动记录已读位置 - 批量获取：多频道顺序抓取，自定义延迟防风控
- Token 经济：
--output输出到文件，分析时直接读取避免重复抓取
典型工作流
tg-reader fetch @channel1 @channel2 --since 24h --comments --output digest.json
---
显著优点
1. 协议层直连：MTProto 原生协议，比 Web 抓取更稳定、完整获取评论讨论
2. 状态持久化：未读追踪机制适合构建日报/监控自动化
3. 双后端兼容：Pyrogram（默认）与 Telethon 可选，容错性强
4. 结构化输出：JSON 格式含 error_type/action 字段，便于 Agent 自动决策
---
潜在局限与风险
| 局限 | 说明 |
|------|------|
| 凭证门槛 | 需从 my.telegram.org 获取 `api_id`/`api_hash`，流程较繁琐 |
| 会话安全 | `.session` 文件等同于账号密码，泄露即丧失账户控制权 |
| 风控限制 | 高频抓取触发 `flood_wait`，需退避重试 |
| 评论追踪缺失 | 已读帖子的新评论无法被未读模式捕获 |
| 媒体无分析 | 图片/视频仅返回 caption，无 OCR/视觉理解 |
| 用户名变更 | 频道改名会导致追踪状态重置 |
---
适合人群
- 信息监控者：需要定时汇总多个 Telegram 信源
- 研究者/分析师：追踪特定话题的频道动态与社群反馈
- 自动化构建者：对接 Agent 实现"每日频道摘要"工作流
---
常规风险
- 凭证泄露：
TG_API_HASH与会话文件需chmod 600保护，禁止提交 Git - 账号封禁：异常登录行为或高频请求可能触发 Telegram 风控
- 会话失效：跨环境复制 session 文件可能导致
AUTH_KEY_UNREGISTERED需重新认证 - 隐私合规：抓取私密频道需确保自身具备合法访问权限