🧰 TDL 命令生成器（JSON 导入下载版）

一个图形化界面（GUI）工具，用于快速构建 TDL 命令。支持从 JSON 文件导入批量下载、自定义命名模板、线程与并发控制、自动补全选项等功能。无需记忆复杂命令行参数，一键生成可直接在 PowerShell / CMD 使用的命令。

🖼️ 界面概览

• 左侧：命名模板设置
• 右侧：JSON 导入、下载目录、线程并发、功能选项与命令预览
• 底部：命令操作按钮（生成命令 / 复制命令 / 清空输入）

按钮居中对齐，整体布局采用左右分栏式设计，操作直观清晰。

✨ 功能介绍

🧾 1. JSON 文件导入下载

可直接选择通过 tdl chat export 导出的 JSON 文件，自动生成命令：

tdl dl -f "tdl-export.json"

支持自定义输出目录（参数 -d）。

🧩 2. 命名模板设置

支持启用 自定义命名模板 (–template)，可选择预设模板或自定义字段组合：

• 标题（FileCaption）
• 时间（DownloadDate）
• 文件名（FileName）
• 频道名称（ChatTitle）
• 发送者 ID（SenderID）
• 文件大小（FileSize）

点击“生成当前模板”后，系统自动插入模板命令。示例：

{{ filenamify .FileCaption 64 }}_{{ formatDate .DownloadDate `2006-01-02-15-04-05` }}_{{ filenamify .FileName }}

⚙️ 3. 线程与并发控制

可选参数：

• -t 启用线程数
• -l 启用并发数

仅在勾选后生效。

🧰 4. 功能选项（可多选）

功能名称	参数	功能描述
反序下载	--desc	从最旧到最新顺序下载
MIME 修正扩展名	--rewrite-ext	自动检测并修正文件扩展名
组合消息识别	--group	合并相册或组合消息
跳过重复文件	--skip-same	自动跳过已存在文件
Takeout 模式	--takeout	使用 Telegram Takeout API 下载

🧾 5. 命令输出与操作

• 自动生成完整命令字符串
• 一键复制到剪贴板
• 一键清空所有输入内容

⚙️ 环境要求

• Python 3.9+
• 无需第三方库，仅使用标准库 tkinter

如出现提示：

ModuleNotFoundError: No module named 'tkinter'

请执行：

pip install tk

🚀 使用方法

1. 下载或克隆本项目
2. 双击运行 main.py 或命令行输入：

python main.py

3. 操作步骤：
   • 选择导出的 JSON 文件路径
   • （可选）选择 下载目录
   • （可选）设置 线程与并发参数
   • 勾选所需的 功能选项
   • 设置或生成 命名模板
   • 点击 生成命令
   • 复制命令粘贴到 PowerShell / CMD 执行

📂 项目结构

📦 TDL_CommandBuilder
├── main.py                # 主入口
├── ui_main.py             # 图形界面布局
├── command_builder.py     # 命令生成核心逻辑
├── template_config.py     # 命名模板配置模块
├── sanitizer.py           # 命令清理与格式化
├── validators.py          # 参数验证模块
├── utils.py               # 工具函数集合
└── README.md              # 使用说明文档

🧩 示例命令

基础导入：

tdl dl -f "Y:\导出文件\tdl-export.json"

指定输出目录 + 自定义命名模板：

tdl dl -f "Y:\tdl\export.json" -d "Y:\Downloads" --template "{{ filenamify .FileCaption 64 }}_{{ formatDate .DownloadDate `2006-01-02-15-04-05` }}"

多线程并发下载 + 修复扩展名：

tdl dl -f "tdl-export.json" -t 8 -l 4 --rewrite-ext

🧱 技术细节

• 图形界面框架：Tkinter
• 命令组装逻辑：动态变量绑定 + 字符串模板
• 支持系统：Windows / macOS / Linux
• 输出兼容：PowerShell、CMD、Terminal

💡 使用提示

• 本工具仅生成命令，不直接执行下载
• 若 Telegram API 速率受限，TDL 会提示： Occasional suspensions are due to Telegram rate limitations
• 建议生成命令后手动运行，根据需要调整参数

👨‍💻 作者说明

本项目由 TDL 命令生成器增强版 改进而来，支持 导入 JSON 下载模式，优化了界面布局与命名模板逻辑。模块结构清晰，后续可轻松扩展新功能。

📜 许可证

本项目使用 MIT License。您可自由使用、修改与分发，但请保留原作者署名。