核心用法
本技能基于MTProto协议（Pyrogram/Telethon双后端）实现Telegram频道深度监控，支持以下核心场景：
内容获取：tg-reader fetch @频道名 可拉取帖子正文、媒体说明、链接预览卡片及讨论组评论。支持时间范围过滤（--since 24h）、批量多频道抓取、以及--text-only跳过纯媒体内容。
智能追踪：启用read_unread模式后，技能自动维护阅读状态（~/.tg-reader-state.json），仅返回新内容，无需重复指定时间范围，适合构建日报/预警工作流。
会话管理：首次使用需通过tg-reader auth完成Telegram账号授权，生成~/.tg-reader-session.session会话文件。该文件与账号完全绑定，技能提供自动备份（.last-good）、损坏恢复（restore-session）及并发锁机制。
部署灵活性：支持直接运行（推荐，需执行审批）或Docker隔离模式（需显式配置API凭证与会话文件挂载）。
显著优点
1. 协议级原生访问：MTProto直连绕过Telegram Bot API限制，可访问私密频道、完整评论树及链接预览元数据
2. 输出结构化：JSON格式包含消息ID、阅读量、转发数、媒体类型、web_page链接卡片等丰富字段，便于自动化处理
3. Token经济设计：--output模式直接落盘，避免大体积数据（尤其带评论时）消耗LLM上下文窗口
4. 故障自愈：内置会话完整性检查（tg-reader-check）、自动备份轮换及明确错误分类（access_denied/flood_wait等），降低运维复杂度
潜在局限
- 媒体内容受限：图片/视频仅提取说明文字，无OCR或视觉分析能力
- 评论追踪粒度：未读模式仅追踪帖子级别，已读帖子的新增评论不会触发更新
- 用户名变更敏感：频道改名会导致追踪状态重置（状态键基于username）
- 速率限制：高频抓取可能触发Telegram限流，需配合
--delay参数或Cron调度规避
适合人群
- 信息分析师/研究员：需批量监控多信源并生成摘要
- 社区运营：追踪竞品频道动态、舆情预警
- 自动化工作流开发者：构建基于Telegram内容的ETL管道
常规风险
| 风险类型 | 说明 | 缓释措施 |
|---------|------|---------|
| **凭证泄露** | `TG_API_HASH`与会话文件等同账号密码 | 配置`0600`权限，禁止入git，Docker模式使用env注入 |
| **会话劫持** | `.session`文件被盗可导致完整账号接管 | 定期备份、启用2FA、隔离环境运行 |
| **合规边界** | 抓取私密频道可能涉及数据隐私法规 | 仅操作用户已加入的频道，遵守Telegram ToS |
| **API封禁** | 异常流量模式可能导致账号限制 | 控制请求频率，使用`--delay`，避免并发冲突 |
安全等级说明
技能本身不提供内容过滤或恶意代码检测，安全性高度依赖：① Telegram账号本身的安全状态；② 会话文件的存储安全；③ 用户合规使用。建议生产环境配合只读专用账号、网络隔离及定期凭证轮换。