刷流任务
刷流任务从一个站点的种子列表里,按你定的条件挑新的免费种(或你允许的其他优惠)推送给下载器,做种一段时间后按规则删掉,把上传量和魔力攒起来。它和 RSS 订阅是两条独立的流程,开启刷流不会改变 RSS 的行为。
刷流会增加对站点的请求,也会让下载器持续进出种子。开启前请确认站点规则允许刷流,并留意站点对新种下载速度、H&R 和做种时长的要求。
新建任务
在左侧导航「下载 → 刷流任务」里点「新建任务」。一个任务对应一个站点和一个下载器:
| 设置 | 说明 |
|---|---|
| 站点 | 只能选内置站点,下拉框里只列已启用的站点:站点要先在「站点列表」里配置好凭证并启用。刷流用站点凭证读种子列表、下载种子,不需要 RSS 链接,账号等级还不能生成 RSS 链接时也能用 |
| 分区 | 只对 M-Team:综合区和成人区是两张列表,可选「综合区」「成人区」或「两个都读」,默认综合区 |
| 下载器 | 种子推给哪个下载器;保存路径可以选这台下载器预设的目录,也可以直接输入,和分类一样留空时用下载器的默认值 |
| 额外标签 | 可选。站点名、pt-tools-brush 和任务专属标签 pt-brush-<任务编号> 总会带上 |
| 检查间隔 | 每隔多久运行一轮,最短 5 分钟,默认 10 分钟 |
| 保存后开启 | 新任务默认关闭,确认配置无误后再开启 |
任务开启后,每一轮依次做三件事:给任务名下的种子采样(记录上传、下载量)、按删种规则删除、在限额之内加新种。
入场条件
每一轮请求一次站点种子列表的第一页(走站点自己的限速),再在本地逐条判断。读哪张列表跟着「优惠类型」:只勾「免费」时读站点的免费种子列表(NexusPHP 站点的「仅免费」,Unit3D 与 Gazelle 站点的免费筛选);勾了别的类型(默认就勾着「2x 免费」)时读不带筛选的全部种子列表,再按优惠类型在本地挑,因为站点的免费筛选读不到别的优惠(NexusPHP 的「仅免费」连 2x 免费都不列)。全部种子列表的第一页里免费种可能比免费列表里少。M-Team 等站点本来就读全部列表、在本地挑,不受影响。运行记录的步骤里写明这一轮读的是哪张列表。遇到连接被重置、超时这类一时的网络错误或站点出错(5xx)时,按指数退避再试两次(约 2 秒、4 秒,各加一点随机时长,每次重试前先等站点的限速);限流、登录失效、Cloudflare 质询不重试。站点回的不是种子列表(拦截、维护、验证页)时,这一轮记为失败,错误里写明页面的标题和开头的文字。M-Team 每页 100 个、置顶的排在前面;选「两个都读」时综合区、成人区各请求一次,同一个种子只算一次,其中一个分区读取失败时照常处理另一个,失败原因写在运行结果里。
- 优惠类型:默认只收「免费」和「2x 免费」,也可以加上 50%、2x 50% 等。部分站点(如 M-Team)的列表会混入普通种,同样在这里拦下。M-Team 的单种免费、覆盖到这个种子的促销也算免费:这类种子在列表里本身的优惠可能是 50%,pt-tools 按单种免费和促销的起止时间判断,不交给站点按优惠筛选(站点按种子本身的优惠筛选会漏掉它们)。
- 优惠剩余:优惠还剩多久才收,默认至少 60 分钟;没有到期时间的永久免费不受限制。
- 体积:最小、最大体积(GB),0 表示不限。设了体积限制、但列表里看不出体积的种子不收。
- 做种人数不多于、下载人数不少于:用来挑人多、竞争小的种子。
- 发布不超过:只收发布不久的新种,0 表示不限。
- 标题包含 / 排除:每行或逗号分隔,大小写不敏感,同时匹配标题和副标题。
- 排除 H&R:默认开启。站点开启了整站 H&R 时,整站的种子都按 H&R 处理(与 RSS 下载同一规则)。关掉之后只收算得出做种要求的 H&R 种子:站点规则里没有做种时长时,到站点详情的设置里填写「H&R 做种要求(小时)」;没填时这类种子不收(删种规则没法判断什么时候可以删),这一轮的运行结果会写明「H&R 要求的做种时长未知」有几个。站点规则写明上传量达到体积的几倍也算达标时,也可以填「H&R 上传量达标(倍)」:做种时长未知的 H&R 种子这时也收,看不出体积的不收(运行结果写「H&R 做种时长未知,体积也未知,没法按上传量判断」)。
M-Team 任务的运行结果前面写明读了哪些分区,例如「M-Team 综合区、成人区第 1 页:列表 200 个、符合条件 3 个、加入 2 个」,表示这两张列表的汇总,不是某一个种子的判定。
符合条件的种子按下载人数从多到少、做种人数从少到多排序,依次加入。任何刷流任务在这个站点推送过的种子(包括已经删掉的)不会再加回来,同一个种子也不会被两个任务各加一份;下载器里已经有的种子同样跳过。
限额
| 限额 | 说明 |
|---|---|
| 同时下载数 | 任务名下还在下载的种子数上限,1–50,必填 |
| 任务总体积 | 任务名下所有在做种子的体积合计上限,0 表示不限 |
| 每天加入 | 当天加入的种子体积合计上限,0 表示不限 |
推送和 RSS 下载走同一个入口,磁盘保护与站点做种容量的检查照常生效。某个种子被这两道检查拒绝时,这一轮停止加种,下一轮再试;连续 3 个种子文件下载失败、或者种子加进下载器之后本地记录写不进去(这个种子会被撤回)时,也停止这一轮。
删种规则
下面的规则任一条满足就删,删除时默认连数据一起删(可以改成只从下载器移除);数据还被别的种子用着时(比如给它加了辅种),只删种子、保留数据:
- 做种满 N 小时:只对已经下完的种子算。
- 分享率达到 N。
- 平均上传低于 N KB/s:按最近 M 分钟(默认 30)的上传量算,只对已经下完、做种满 M 分钟、采样也覆盖了这段时间的种子判断。
- 没有活动 N 小时:按下载器记的最后一次上传或下载数据的时间算(qBittorrent、Transmission 都记),与自动删种的「不活跃」用同一个时间;下载器没给这个时间时,按刷流自己的采样,这段时间里上传量和下载量都没有增长就删。
- 免费即将到期、尚未下完:默认开启。下一轮检查之前就会到期的,这一轮就删,避免到期之后的下载按非免费计。
有 H&R 的种子在做种时长达到站点要求之前一律不删,包括免费到期时尚未下完的情况。站点设置里填了「H&R 上传量达标」时,下完以后上传量达到要求也算达标,之后照常按删种规则判断;没下完的不按上传量算。
下载完成按「进度 100% 并且不在校验、出错状态」判断;校验中或文件丢失的种子不算下完。
刷流只处理带本任务标签、并且是本任务加入的种子。你把某个种子的任务标签去掉,或者给它打上保留标签(在「下载器」页的种子列表点「保留」,见保留种子)或自动清理里的保护标签,它就交还给你:刷流不再删它,也不会再加回同一个种子,之后按自动删种的规则处理(带保留或保护标签时不删)。手动删掉或被其他方式删掉的种子,记录会标成「已不在下载器」。任务换了下载器之后,已经加入的种子仍在原来的下载器里采样、按规则删除;原来的下载器暂时连不上时,那些种子这一轮不动。
运行记录
每个任务的操作里有「运行记录」(手机上是「记录」),点「上次运行」那一格的结果或错误也会打开。任务每运行一轮(定时或「立即运行」)记一条,最新的在最上面并默认展开:
- 开始时间、定时还是手动、用时,以及状态:成功;部分失败(这一轮跑完了,但个别种子下载、推送、删除或记录失败);失败(例如读不到站点的种子列表、连不上下载器);没跑完(这一轮进行到一半时 pt-tools 退出了,下次启动时补记);进行中。
- 这一轮的摘要与错误,和任务列表里「上次运行」写的一样。
- 点开看步骤:任务名下在做多少个种子、今天已加入多少;读到的列表有几个;以前加过的、下载器里已有的、不符合条件的各有几个,不符合的按原因汇总,并逐个列出前 30 个种子与原因;加入了哪些种子(优惠、体积、优惠到什么时候、H&R 做种要求);删了哪些、为什么删;哪些种子已不在下载器里;这一轮为什么停止加种(例如达到同时下载上限、推送被磁盘保护拒绝)。
每个任务保留最近 500 条、14 天以内的记录,删除任务时一起删除。一轮的步骤很多时,后面的不再记录,记录里会注明。
与自动清理的关系
刷流任务正在管的种子由刷流任务自己的删种规则处理,「自动删种」的删除条件(做种时长、分享率、做种竞争度等)都跳过它们,两套规则不会争抢。归属按刷流任务的记录认,不看 pt-tools-brush 标签:任务删掉了、种子交还给你了(摘掉任务标签、点了保留),种子即使还带着 pt-tools-brush,也按自动删种的规则处理。磁盘空间低于保底线时的紧急清理仍然覆盖所有种子,包括刷流种子;带保留标签或保护标签的除外。
关闭与删除任务
- 关闭:不再加新种。已加入的种子继续按删种规则处理,直到全部删完。
- 删除:任务与它的统计、种子记录、运行记录一起删除,下载器里的种子保留,之后不再由刷流管理。删除时选这些种子怎么处理:
- 交给自动删种(默认):按自动删种的规则处理,保护规则照样生效;没开自动删种时一直留在下载器里。
- 保留这些种子:给每个种子加上
pt-tools-keep标签(见保留种子),自动删种(含紧急清理)、做种竞争度和免费结束时的删除都不删它们。有下载器连不上或标签加不上时任务不删,对话框里列出是哪几个;已经加上标签的保持保留、不再归这个任务管,可以稍后再试,或者改选交给自动删种。已经不在下载器里的种子不影响删除。
- 任务正在运行一轮时不能删除或修改,稍后再试(一轮用的是开始时读到的配置)。
在手机 App 里、经 MCP 或 AI 助手删除任务时,按默认交给自动删种。
收益与战报
刷流任务页的页头有「统计」:日、周、月、季、年五档,管这一页所有的收益数字,选过的记在这台浏览器里。
| 统计 | 看多久 | 当前这一段 |
|---|---|---|
| 日 | 最近 30 天 | 今日 |
| 周 | 最近 12 周 | 本周 |
| 月 | 最近 12 个月 | 本月 |
| 季 | 最近 8 个季度 | 本季度 |
| 年 | 最近 5 年 | 今年 |
- 顶部的数字带:在做种子数、本期上传和下载(旁边写上一期的值,例如「上周 77.14 GB」)、累计分享率;每格的小柱子是最近 7 段。
- 任务表的「本期 上传 / 下载」列(按日时是「今日」)是每个任务这一段的收益。
- 收益卡(例如「最近 12 周收益」)每根柱子是一段的上传量,上面一行读数写选中那一段的上传、下载、加入和删除数,默认是当前这一段;鼠标移到柱子上、或者点一下图表后按左右方向键,看别的段。「明细」把每一段的数字列成表,新的在前。
收益的口径是刷流种子在下载器里的累计上传、下载量相邻两次采样之差,按服务器时区分天;两次采样跨过午夜时,这段增量按时长分摊到两天。周从周一开始,季度从 1、4、7、10 月开始;当前这一段只算到今天,所以本周、本月通常比上一段少。
手机 App 的刷流页有同样的五档,柱子可以点或左右拖动。
开启了每日战报时,当天有刷流收益的话,战报里会多一节「今日刷流」:合计的上传、下载、加入和删除数,任务多于一个时逐个列出。
从 Vertex 迁移
pt-tools 的刷流参考了 Vertex 的常用玩法,概念大致对应如下:
| Vertex | pt-tools |
|---|---|
| 刷流任务(RSS 任务) | 刷流任务:一个任务对应一个站点和一个下载器,选种来自站点的种子列表而不是 RSS 链接 |
| 选种规则 | 入场条件:优惠类型、优惠剩余、体积、做种 / 下载人数、发布时长、标题包含与排除、排除 H&R |
| 删种规则 | 删种规则:做种时长、分享率、平均上传速度、无活动时长、免费到期未完成,任一条满足即删 |
| 下载器限制(最大下载数、空间) | 限额:同时下载数、任务总体积、每天加入;磁盘保护与站点做种容量沿用全局设置 |
| 标签 / 分类 | 额外标签与分类;pt-tools-brush 与任务标签自动带上 |
pt-tools 目前不支持 Vertex 的自定义脚本规则;需要更复杂的条件时,可以拆成几个条件不同的任务。
接口
| 接口 | 说明 |
|---|---|
GET / POST /api/brush/tasks | 列出任务(含在做种子数与收益)/ 新建任务 |
GET / PUT / DELETE /api/brush/tasks/<编号> | 读取、修改、删除任务;删除时的 torrents 见下 |
POST /api/brush/tasks/<编号>/run | 立即运行一轮,返回这一轮的结果;站点或下载器出错没跑完时回 502 |
GET /api/brush/tasks/<编号>/runs?limit=<1–100>&offset= | 运行记录,新的在前,带每一轮的步骤 |
GET /api/brush/tasks/<编号>/torrents?state=active|removed|gone | 任务名下的种子 |
GET /api/brush/stats?granularity=<周期>&periods=<段数> | 按周期分段的各任务与合计收益,见下 |
这些接口都要求登录。
删除任务时,torrents 是留下的种子怎么处理:handover(默认,交给自动删种)或 keep(保留,加 pt-tools-keep),别的值回 400。选 keep 时成功回 {"success": true, "kept": <保留了几个>, "missing": <几个已经不在下载器里>};有种子保留失败时任务不删,回 502,正文的 failed 逐个列出 title、info_hash、downloader_id、downloader_name 与 message。
granularity 是 day、week、month、quarter、year,默认 day;periods 默认 30、12、12、8、5 段,最多 366、104、60、40、20 段。返回的每一段有第一天 date 与最后一天 end,最后一段是当前这一段(end 是它自然的结束日,收益只算到今天)。旧的 ?days=<1–90> 仍然可用,等于按天的那么多段。