TDL JSON 导出工具：可视化筛选 Telegram 聊天内容的图形界面导出器

TDL JSON 导出工具是一款基于 TDL 的 Telegram 聊天记录导出器，拥有简洁易用的图形界面。用户可以在界面中快速设置导出条件（例如时间范围、消息类型、关键词筛选等），一键生成命令并导出为标准 JSON 文件，无需手动输入复杂命令。

无论你是想批量备份 Telegram 频道内容，还是筛选特定消息类型（例如视频、图片、文字），这款工具都能让你轻松完成数据导出。

---

💡 工具亮点

• 图形界面操作：无需命令行，所有选项可视化呈现。
• 支持多条件筛选：按消息内容、文件名、文件大小、浏览次数、发送者 ID 等精准过滤。
• 导出 JSON 格式：标准化结构，便于后期数据分析或与下载脚本配合使用。
• 自定义导出范围：支持按时间戳、消息 ID、或最近 N 条消息导出。
• 附加选项丰富：可选 --with-content、--raw、--all 等高级参数。
• 兼容原版 TDL：完全兼容 iyear/tdl 的命令行工具。

---

🎯 适用场景

• 导出 Telegram 群组或频道的所有聊天记录。
• 筛选并导出含特定关键词的消息（如“项目计划”、“会议记录”）。
• 只导出媒体类消息（图片、视频、文件）。
• 导出并保存聊天记录用于备份或分析。
• 结合下载工具，从导出的 JSON 中批量下载 Telegram 文件。

---

🪄 功能说明

1️⃣ 基础设置

在左侧面板中输入：

• 聊天标识 (-c CHAT)：可输入 Telegram 用户名、频道链接、ID 或电话号码。
• 主题 ID (–topic)：仅导出特定主题下的消息。
• 回复 ID (–reply)：导出某条消息的所有回复。
• 输出文件 (-o)：选择保存的 JSON 文件名。

2️⃣ 导出范围 (-T / -i)

可按不同类型设置导出范围：

• time：按时间戳范围导出（例如 1727712000,1727894399）。
• id：按消息 ID 范围导出（例如 100,500 表示导出 ID 100 至 500）。
• last：导出最近 N 条消息。

📘 例：

tdl chat export -c https://t.me/example -T id -i 100,500

3️⃣ 过滤设置 (-f)

可根据多种条件筛选消息：

• Message contains '关键词' → 筛选消息内容。
• Media.Name contains '文件名' → 筛选文件名。
• Views > 1000 → 筛选浏览数大于 1000 的消息。
• Forwards > 10 → 筛选被转发超过 10 次的内容。
• Media.Size > 5*1024*1024 → 筛选大于 5MB 的文件。
• FromID == 12345678 → 筛选指定用户发送的消息。
• 支持布尔筛选：Pinned（置顶）、Silent（静音）、Mentioned（提及我）。

所有筛选条件可自由组合，例如：

.FileCaption contains '报告' && Views > 500 && Media.Size > 2*1024*1024

4️⃣ 附加选项

• –with-content：导出媒体同时包含消息文本。
• –raw：导出原始结构，包含 Telegram 底层字段。
• –all：导出包括非媒体在内的所有消息。

---

📦 命令示例

导出包含关键词的消息：

tdl chat export -c https://t.me/channel -o "tdl-export.json" -f "Message contains '项目计划'"

导出文件大于 10MB 的视频消息：

tdl chat export -c @videogroup -o "bigfiles.json" -f "Media.Size > 10*1024*1024"

导出最近 500 条消息并附带文本内容：

tdl chat export -c https://t.me/group -T last -i 500 --with-content

---

⚙️ 环境要求

• 操作系统：Windows / macOS / Linux
• Python 版本：3.9 及以上
• 依赖库：tkinter（标准库自带）
• 依赖工具：TDL CLI

---

📁 项目文件结构

📂 Telegram_TDL_Exporter
├── main.py            # 程序入口
├── gui_main.py        # 图形界面布局
├── tdl_logic.py       # 命令构建逻辑
├── utils.py           # 工具函数
└── README.md          # 项目说明

---

🚀 使用步骤

1. 下载并解压项目文件。
2. 安装 Python 3.9+，并确保 tdl 工具可用。
3. 双击运行 main.py。
4. 输入 Telegram 聊天链接或 ID。
5. 设置导出范围与筛选条件。
6. 点击 “生成命令” → “复制命令”。
7. 在 PowerShell 或 CMD 中粘贴执行。

---

📈 SEO 优化要点

• 主要关键词：Telegram 导出工具、TDL JSON 导出、Telegram 聊天记录导出器、Telegram 数据筛选导出。
• Meta 描述：TDL JSON 导出工具是一款可视化 Telegram 聊天导出器，支持多条件筛选并生成标准 JSON 文件，适合备份和数据分析。
• 推荐图片：界面截图，alt 建议使用 “TDL JSON 导出工具界面”。
• 结构优化：标题层级清晰、段落短、代码块优化，利于搜索引擎抓取。

---

🧑‍💻 总结

TDL JSON 导出工具是一款功能全面且用户友好的 Telegram 聊天内容导出解决方案。它将复杂的命令行操作图形化，支持灵活的筛选条件，让用户能够精准导出所需内容。无论你是 Telegram 内容创作者、数据分析师，还是普通备份用户，这款工具都能为你提供高效、稳定、可控的数据导出体验。

📎 小贴士：导出的 JSON 文件可与 Telegram 下载工具结合使用，实现完整的消息备份与媒体资源保存。