Telegram Reader — 只读读取 Telegram 频道，收集财经新闻与市场情报

技能概述

Telegram Reader 是一个基于命令行工具 tdl 的只读技能，用于读取 Telegram 频道和群组中的财经新闻、加密货币信号与市场研究内容，并把消息导出为 JSON 便于后续分析。

适用场景

1. 加密货币与交易信号追踪 当你想回溯某个 Telegram 信号频道最近发布了什么、按时间范围核对历史喊单记录时，可以直接导出指定条数或时间区间的消息，而不是在手机上不停往上翻。

2. 财报季与宏观新闻监控 把多个财经频道的最新消息批量导出后集中阅读，快速定位财报超预期、评级调整、央行表态等关键信息，适合需要同时盯多个信源的投研人员。

3. 量化研究的数据源整理 按消息 ID 区间或话题（topic）导出群组讨论，保存为 JSON 落盘，作为后续文本分析、情绪统计或语料整理的原始数据。

核心功能

1. 列出与筛选聊天 通过 tdl chat ls 查看账号下的全部会话，支持按类型（如只看频道）或按名称关键字过滤，并可输出 JSON，帮助你在一堆订阅里快速定位目标频道。

2. 多维度导出消息 tdl chat export 支持三种定位方式：按最近条数（-T last）、按 Unix 时间戳区间（-T time）、按消息 ID 区间（-T id），还可通过 --topic 读取论坛群组中某个话题下的消息。搭配 --all --with-content 可确保导出的是文字内容而不只是媒体消息。

3. 读取而非写入的安全边界 技能仅封装读取类命令，不发送消息、不加入或退出频道、不做任何写操作；登录会话一次性完成并保存在本地，后续调用不再需要重复认证。

常见问题

telegram-reader 能发送消息或自动加入频道吗？

不能。这是一个明确的只读技能，只覆盖列出会话、搜索频道、导出消息这几类读取操作，不包含发送消息、加入/退出频道等任何写入能力。如果你的目标是自动发帖或做社群运营，这个技能不适用。

使用前需要 Telegram 账号吗？怎么登录？

需要一个 Telegram 账号来完成一次性登录。技能会先检查环境里是否已安装 tdl、会话是否有效；未登录时提供三种方式：二维码登录（tdl login -T qr，用手机 App 扫码最快）、手机号验证码登录、或从官方版 Telegram Desktop 导入已有会话。登录过程需要你自己在终端交互输入手机号和验证码，技能不会代替你处理账号凭据。会话保存在本地，登录一次即可长期使用；如需区分工作与个人账号，可以用命名空间（-n work）管理多套会话。

导出的消息包含哪些内容？媒体文件也能拿到吗？

导出的每条消息包含消息 ID、发布时间、正文文本、发送者、浏览量以及媒体元信息等字段，以 JSON 形式写入你指定的文件，读取和处理都比直接解析终端输出更可靠。需要特别注意的是：导出文字消息必须加上 --all --with-content，否则默认只会导出媒体类消息，会出现"导出了文件但没有任何文字"的情况。技能本身聚焦于阅读频道内容，不负责下载媒体文件。

私有频道或我没有加入的频道能读取吗？

不能。读取权限取决于你的 Telegram 账号本身——只有账号已加入或有权访问的频道才能读取。若返回 CHANNEL_PRIVATE，说明当前账号没有该频道的访问权，需要你先在 Telegram 客户端中自行加入。同理，遇到 FLOOD_WAIT_X 表示触发了 Telegram 的速率限制，等待提示的秒数后重试即可，不要连续高频请求。

这个技能收费吗？可以读取多少个频道？

技能本身不收费，它只是对开源命令行工具 tdl 的封装，读取范围也不设条数上限以外的额外限制。实际能读到什么，取决于你的 Telegram 账号订阅了哪些频道，以及 Telegram 侧的接口限流。建议先用较小的导出量（例如最近 20 条）确认频道和格式正确，再按需扩大范围。