批量下载任务（V4）¶
用于对 一个或多个对话/话题 的历史消息进行批量下载（按筛选条件与输出规则保存到本地）。
适用场景¶
- 下载某个频道/群的历史图片/视频/文件
- 按时间范围、关键词、成员、大小/时长等条件筛选下载
- 需要稳定可追踪（任务台可看到进度、失败项）
创建任务（可跟着做）¶
- 进入「任务台」点击 「创建任务」。
- 选择 「批量下载」。
- 在弹窗中按顺序配置：
- 任务标题：建议包含范围与规则（如“频道A-2026年1月-视频”）
- 对话/话题：选择源对话或话题（支持多选）
- 保存根目录：下载文件将保存到该目录下
- 配置筛选条件（可选）：
- 开始时间 / 结束时间
- 内容关键词（多个用逗号隔开）
- 反向关键词（排除包含这些关键词的内容）
- 指定成员（仅支持群组/超级群组/频道）
- 评论（如支持时：不包含/包含/仅评论）
- 配置限制条件（可选）：
- 文件类型（图片、视频等）
- 文件大小（大于/小于 + 数值 + 单位）
- 文件时长（大于/小于 + 数值 + 单位）
- 配置输出规则（建议设置）：
- 目录结构：决定保存到哪些子目录
- 文件命名规则：按界面提示选择（建议优先用“时间/序号/原文件名”等稳定规则）
- 文件名长度限制：避免文件名过长导致保存失败（按界面默认值即可）
- 生成文本文件：如开启，会把消息文字额外保存为文本文件（便于归档）
- 执行控制：
- 批量下载数量：同一时间处理的数量（建议先用默认值）
- 立即启动：建议首次创建保持开启
- 点击确认创建任务。
参数说明（按界面理解）¶
基本¶
- 任务标题：仅用于识别任务
- 对话/话题：支持多选；对话与话题都会作为下载范围
- 保存根目录：所有下载文件的根目录
筛选¶
- 开始时间/结束时间：按消息时间筛选
- 内容关键词：多个用逗号分隔；命中则保留
- 反向关键词：命中则排除
- 指定成员：仅处理这些成员的内容
- 评论：
- 不包含：只下载主消息
- 包含：主消息与评论都下载
- 仅评论：只下载评论内容
限制¶
- 文件类型：只处理所选类型
- 文件大小：选择“大于/小于”，再填数值与单位（KB/MB/GB）
- 文件时长：选择“大于/小于”，再填数值与单位（秒/分钟/小时）
输出¶
- 目录结构：决定保存到哪些子目录层级（界面会展示示例路径）
- 文件命名规则：决定文件名怎么生成（建议避免用过长的“消息内容”做文件名）
- 文件名长度限制：避免某些系统/路径限制导致保存失败
- 生成文本文件：把消息文字额外保存为文本文件（可选）
常见问题与排查¶
下载很慢 / 失败很多¶
- 降低 批量下载数量
- 检查代理节点质量与稳定性
- 分批按时间范围下载，避免一次扫太久
文件名很乱或过长¶
- 调整 文件命名规则 与 文件名长度限制
- 优先选择稳定、短的命名方式（例如“时间 + 序号/原文件名”等）