核心概念

文档按 控制中心、账号，以及进入账号后的页面与任务 来组织。理解下面这些概念后，你会更容易把“我要做什么”映射到正确的入口。

控制中心

TG-FF Agent 打开后，首先看到的是 TG-FF 控制中心。它管理这台电脑上的账号：添加、改名、启动、停止、进入 TG-FF、查看文件保存位置，以及检查更新。

• Windows 和 macOS 安装的程序名叫 TG-FF Agent，窗口里写的是「TG-FF 控制中心」
• Linux 在浏览器里使用控制中心，进入前需要先登录控制中心自己的账号和密码
• 关闭控制中心窗口，或在 Linux 上关闭浏览器，正在运行的账号会继续在后台工作

账号

一个账号对应一次 Telegram 登录。多个账号的登录信息、任务和文件分开存放。

• 点击账号即可「启动并进入」。账号还没启动时，会先启动，准备好后再打开 TG-FF
• 名称可以随时修改，不影响登录状态和已经保存的文件
• 删除账号会清除登录信息、任务记录和相关设置；已经保存到电脑上的文件会留下
• 至少需要保留一个账号

对话（Chat）

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

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

话题（Topic）

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

评论（Replies）

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

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

任务（Task）

进入账号之后，大多数批量或自动化动作都会以任务的形式运行，并在「任务台」中可见。

任务通常包含：

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

任务台（Task Board）

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

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

自动化（Automation）

长期运行的规则类任务：

• 自动下载：监听新消息并自动下载，可以同时开启多条规则
• 自动转发：监听并按条件转发到指定目标，可以同时开启多条规则

队列与并发

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

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

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

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