SuperAPI AI 工具集

dump-channel

通用与其它

查看项目

更新于 10-16 01:49

技能介绍

用途:把 Telegram 频道、群组或聊天记录完整归档为 NDJSON,并下载其中的媒体文件。

主要能力:按 @用户名 或数字 chat ID 导出;输出目录内含 messages.ndjson(每行一条 JSON,按时间从旧到新)与 media/ 文件夹,媒体按消息 ID 命名便于对照;NDJSON 字段包含 id、date、text、has_media、media_type、media_file、views、forwards、reply_to_msg_id、grouped_id、edit_date 及 sender 信息。

使用方式:需已存在会话文件 ~/.local/share/gramjs/<profile>.session,否则先运行 /tlg:setup;账号须已订阅或加入目标频道。完整导出:bun "$SCRIPT" dump @ChannelName ./output/ChannelName;仅文本:加 --no-media;按数字 ID:bun "$SCRIPT" dump -1001234567890 ./output/MyChannel;换 profile:加 -p <profile>。

适用场景:频道内容备份、数据分析(可用 jq、DuckDB、Polars 查询 NDJSON)、带图表截图筛选等。

限制与注意:必须有账号访问权限,不能导出未订阅的频道;同一 profile 不要并发运行多个导出,避免会话文件冲突;重跑会跳过已下载媒体但重写完整 NDJSON,可安全续传;约 3000 条消息加 1700 个媒体约需 3-5 分钟,1 万条以上加媒体约 10-15 分钟;下载中可能短暂断连,GramJS 会自动重连。建议在 git 项目中忽略 media 目录,仅版本管理 NDJSON 元数据。安装来源与收费信息暂未提供。