批量下載任務（V4）¶
用於對 一個或多個對話/話題 的歷史消息進行批量下載（按篩選條件與輸出規則保存到本地）。
適用場景¶
- 下載某個頻道/羣的歷史圖片/視頻/文件
- 按時間範圍、關鍵詞、成員、大小/時長等條件篩選下載
- 需要穩定可追蹤（任務臺可看到進度、失敗項）
創建任務（可跟着做）¶
- 進入「任務臺」點擊 「創建任務」。
- 選擇 「批量下載」。
- 在彈窗中按順序配置：
- 任務標題：建議包含範圍與規則（如“頻道A-2026年1月-視頻”）
- 對話/話題：選擇源對話或話題（支持多選）
- 保存根目錄：下載文件將保存到該目錄下
- 配置篩選條件（可選）：
- 開始時間 / 結束時間
- 內容關鍵詞（多個用逗號隔開）
- 反向關鍵詞（排除包含這些關鍵詞的內容）
- 指定成員（僅支持羣組/超級羣組/頻道）
- 評論（如支持時：不包含/包含/僅評論）
- 配置限制條件（可選）：
- 文件類型（圖片、視頻等）
- 文件大小（大於/小於 + 數值 + 單位）
- 文件時長（大於/小於 + 數值 + 單位）
- 配置輸出規則（建議設置）：
- 目錄結構：決定保存到哪些子目錄
- 文件命名規則：按界面提示選擇（建議優先用“時間/序號/原文件名”等穩定規則）
- 文件名長度限制：避免文件名過長導致保存失敗（按界面默認值即可）
- 生成文本文件：如開啓，會把消息文字額外保存爲文本文件（便於歸檔）
- 執行控制：
- 批量下載數量：同一時間處理的數量（建議先用默認值）
- 立即啓動：建議首次創建保持開啓
- 點擊確認創建任務。
參數說明（按界面理解）¶
基本¶
- 任務標題：僅用於識別任務
- 對話/話題：支持多選；對話與話題都會作爲下載範圍
- 保存根目錄：所有下載文件的根目錄
篩選¶
- 開始時間/結束時間：按消息時間篩選
- 內容關鍵詞：多個用逗號分隔；命中則保留
- 反向關鍵詞：命中則排除
- 指定成員：僅處理這些成員的內容
- 評論：
- 不包含：只下載主消息
- 包含：主消息與評論都下載
- 僅評論：只下載評論內容
限制¶
- 文件類型：只處理所選類型
- 文件大小：選擇“大於/小於”，再填數值與單位（KB/MB/GB）
- 文件時長：選擇“大於/小於”，再填數值與單位（秒/分鐘/小時）
輸出¶
- 目錄結構：決定保存到哪些子目錄層級（界面會展示示例路徑）
- 文件命名規則：決定文件名怎麼生成（建議避免用過長的“消息內容”做文件名）
- 文件名長度限制：避免某些系統/路徑限制導致保存失敗
- 生成文本文件：把消息文字額外保存爲文本文件（可選）
常見問題與排查¶
下載很慢 / 失敗很多¶
- 降低 批量下載數量
- 檢查代理節點質量與穩定性
- 分批按時間範圍下載，避免一次掃太久
文件名很亂或過長¶
- 調整 文件命名規則 與 文件名長度限制
- 優先選擇穩定、短的命名方式（例如“時間 + 序號/原文件名”等）