核心概念（V4）

V4 的文档按 页面与任务 组织。理解下面这些概念后，你会更容易把“我要做什么”映射到正确的入口。

对话（Chat）

Telegram 中的“聊天对象”，可能是私聊、群组、频道。

• 你可以在对话页浏览消息、预览媒体、对单条消息执行下载/转发/导出等操作。

话题（Topic）

群组的“话题”（论坛模式）。在 V4 里，某些任务允许直接选择“对话/话题”作为目标或来源。

评论（Replies）

频道消息的评论区（或带评论线程的消息）。

• 在对话页进入某条消息的评论区后，你可以对评论线程创建下载/转发任务（详见「对话页 → 评论」）。

任务（Task）

V4 的核心执行单位。大多数“批量/自动化”的动作都会以任务的形式运行，并在「任务台」中可见。

任务通常包含：

• 任务标题/名称：方便区分
• 范围：源对话/话题/评论/链接等
• 筛选条件：时间、关键词、成员、文件类型/大小/时长等
• 输出规则：保存根目录、目录结构、文件命名规则等
• 执行控制：立即启动、执行频率、循环次数等

任务台（Task Board）

统一的任务管理页面，负责：

• 创建任务（批量下载 / 链接下载 / 批量转发 / 发送）
• 启动、暂停、停止、删除任务
• 查看任务详情（下载详情/转发详情）

自动化（Automation）

长期运行的规则类任务：

• 自动下载：通常只需要启用一条规则，用于监听新消息并自动下载
• 自动转发：可以创建多条规则，监听并按条件转发/同步到指定目标

队列与并发

为了稳定性，任务执行通常会有并发与排队机制（例如批量下载的批次大小、转发的执行频率等）。

你会在任务参数里看到类似：

• 批量下载数量：每次处理多少条消息/资源（用于控制压力与失败率）
• 执行频率：每次操作之间的间隔（用于避免触发 Telegram 的频率限制与风控）

这些参数用于避免触发 Telegram 的频率限制与风控。