# 删种规则 ## 类型 * 普通规则 即通过条件列表用来筛选种子, 根据匹配情况进行删种 * javascript 通过 Javascript 代码, 依据代码段的返回值进行判断删种 ## 普通规则 ### 说明 1. 分享率一: 上传 / 种子大小 的结果
2. 分享率二: 上传 / 下载 的结果
3. 站点域名: 种子的 Tracker 地址的域名部分
4. 各类时间: 选项时间到当前时间的差值, 单位为 秒/s
5. 各类大小: 单位为 字节 / Byte, 可以使用 \* 做乘法运算
6. 各类速度: 单位为 字节/s / Byte/s
7. 种子状态: 参照 qBittorrent 对种子状态的定义, 主要包含以下几类:\ 上传中: `uploading`, 下载中: `downloading` 等待下载: `stalledDL`, 做种但无上传: `stalledUP` 更多状态请参照 qBittorrent Wiki, 若想删除等待下载状态下的种子, 应填写 `stalledDL` 8. 返回信息: 种子 Tracker 列表中由 Tracker 返回的信息
9. 当前时间: 当天 0 点到当前时间的秒数\ 例: 填写 当前时间大于 8\*3600 与 当前时间小于 22\*3600\ 则只会在当天上午 8 点之后到 22 点之前删种\ 0 点的时间戳取决于 Vertex 安装环境的时区
10. 全局速度: 当前下载器的速度
11. 做种下载连接: 仅计算已连接上的数量, 也即 qBittorrent WebUI 内括号外的数字
12. 做种下载任务: 任务的数量, 做种包含上传中状态与做种状态, 下载包含下载中与等待下载状态
13. 比较类型中的 包含 / 包含于 或 不包含 / 不包含于: 值部分需以半角逗号 , 为分割符, 如种子分类不包含于 KEEP, KEEP2, KEEP3 三个分类, 则应填写: `KEEP,KEEP2,KEEP3` ## Javascript ### 基本结构 ```javascript // 提供 maindata 与 torrent 参数, maindata 为 qBittorrent 的全局信息, torrent 为当前操作种子的信息 // 返回 true 则意为符合删种条件, 若未设置持续时间, 则立即删除该种, false 为不删除 (maindata, torrent) => { return false; } ``` ### maindata #### maindata 结构如下 ```javascript const maindata = { downloadSpeed: 0, uploadSpeed: 0, freeSpaceOnDisk: 0, leechingCount: 0, seedingCount: 0, usedSpace: 0, queuedIO: 0, readCacheOverload: 0， writeCacheOverload: 0, torrents: [torrent, torrent, torrent....] } ``` #### maindata 各属性释义 | 属性 | 释义 | | ------------------ | ----------------------------------------------------- | | downloadSpeed | 全局下载速度, 单位 Byte/s | | uploadSpeed | 全局上传速度, 单位 Byte/s | | freeSpaceOnDisk | 剩余空间, 单位 Byte | | leechingCount | 当前下载数量, 包括下载, 等待下载状态 | | seedingCount | 当前做种数量, 包括做种, 上传状态 | | usedSpace | 已使用空间, 由所有种子完成量加和得到, 单位 Byte | | queuedIO | IO 队列长度, qBittorrent 统计页面的 队列的 I/O 任务, 仅限 qBittorrent | | readCacheOverload | 读取缓存超负荷, qBittorrent 统计页面的 读取缓存超负荷, 仅限 qBittorrent | | writeCacheOverload | 写入缓存超负荷, qBittorrent 统计页面的 写入缓存超负荷, 仅限 qBittorrent | | originProp | 由客户端返回的原始客户端属性, 具体内容请参考文档 | | torrents | 种子列表 | ### torrent #### torrent 结构如下 ```javascript const torrent = { availability: 0.5, name: 'torrent name', uploadSpeed: 0, downloadSpeed: 0, size: 0, progress: 0.1, tracker: 'tr.ack.er', completed: 0, uploaded: 0, downloaded: 0, ratio: 0.1, category: 'category', state: 'downloading', addedTime: 0, completedTime: -1, savePath: '/root/Downloads', seeder: 0, leecher: 0, trackerStatus: '' } ``` #### torrent 属性与 qBittorrent 所返回的属性对应关系 ```javascript const torrent = { availability: 'availability', name: 'name', uploadSpeed: 'upspeed', downloadSpeed: 'dlspeed', size: 'size', progress: 'progress', tracker: 'tracker', completed: 'completed', uploaded: 'uploaded', downloaded: 'downloaded', ratio: 'ratio', category: 'category', state: 'state', addedTime: 'added_on', completedTime: 'completion_on', savePath: 'save_path', seeder: 'num_seeds', leecher: 'num_leechs' } ``` #### torrent 各属性释义 | 属性 | 释义 | | ------------- | ------------------------------------------------ | | availability | 可用性, 可以是小数, 4.1.x 版本没有这个参数, 由客户端根据已连接的 peer 计算得出 | | name | 种子名称 | | uploadSpeed | 上传速度, 单位 Byte/s | | downloadSpeed | 下载速度, 单位 Byte/s | | size | 种子大小, 单位Byte | | progress | 种子当前进度 | | tracker | Tracker 地址, 与 qBittorrent 返回不同, 此属性仅包含域名 | | completed | 已完成大小, 单位 Byte | | uploaded | 已上传, 单位 Byte | | downloaded | 已下载, 单位 Byte | | ratio | 分享率 | | category | 分类 | | state | 种子当前状态 | | addedTime | 种子添加时间, 秒时间戳 | | completedTime | 种子完成时间, 秒时间戳 | | savePath | 保存路径 | | seeder | 已连接的做种 peer 数量 | | leecher | 已连接的下载 peer 数量 | | trackerStatus | Tracker 返回信息, 部分站点不支持 | | originProp | 由客户端返回的原始种子属性, 具体内容请参考文档 | 关于种子列表, 了解更多 => [qBittorrent-Api-Wiki:get-torrent-list](https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-\(qBittorrent-4.1\)#get-torrent-list) #### torrent 任务状态释义 | 状态 | 释义 | | ------------------ | -------------------------------- | | error | 发生了一些错误，适用于暂停的种子 | | missingFiles | Torrent 数据文件丢失 | | uploading | Torrent 正在播种，正在传输数据 | | pausedUP | Torrent 已暂停并已完成下载 | | queuedUP | 队列已启用且 torrent 已排队等待上传 | | stalledUP | Torrent 正在播种，但没有建立连接 | | checkingUP | Torrent 已完成下载，正在检查中 | | forcedUP | Torrent 被强制上传并忽略队列限制 | | allocating | Torrent 正为下载分配磁盘空间 | | downloading | 正在下载 Torrent，正在传输数据 | | metaDL | Torrent 刚刚开始下载并正在获取元数据 | | pausedDL | Torrent 已暂停并且尚未完成下载 | | queuedDL | 队列已启用且 torrent 已排队等待下载 | | stalledDL | Torrent 正在下载，但未建立连接 | | checkingDL | 与 checkingUP 相同，但 torrent 尚未完成下载 | | forcedDL | Torrent 被强制下载以忽略队列限制 | | checkingResumeData | 在 qBt 启动时检查恢复数据 | | moving | Torrent 正在移动到另一个位置 | | unknown | 未知状态 | 关于任务状态, 了解更多 => [qBittorrent-Api-Wiki:torrent-management](https://github.com/qbittorrent/qBittorrent/wiki/WebUI-API-\(qBittorrent-4.1\)#torrent-management) ## 举栗 ### 黑车 ```javascript // 黑车 (maindata, torrent) => { const categoryList = [ "不想", "删的", "种子", "加", "这些", "分类" ]; const ruleData = [ { down: 80, up: 50 }, { down: 70, up: 40 }, { down: 60, up: 30 }, { down: 50, up: 25 }, { down: 40, up: 20 }, { down: 20, up: 7 }, { down: 15, up: 5 }, { down: 10, up: 2 }, { down: 5, up: 0.5 } ]; const { state, upspeed, category, dlspeed } = torrent.originProp; if (categoryList.indexOf(category) !== -1) { return false; } for (const rule of ruleData) { if ( state == "downloading" && dlspeed >= util.calSize(rule.down, "MiB") && upspeed <= util.calSize(rule.up, "MiB") ) { return true; } } return false; }; ``` ### 慢车 ```javascript // 慢车 持续时间30s // 下载状态，上传低于550kb，进度在10-100之间 // 下载人数大于100的种子不删 // 0点-7点，或者客户端下载种子数量小于等于10时不删种 (maindata, torrent) => { const categoryList = [ "不想", "删的", "种子", "加", "这些", "分类" ]; const { state, upspeed, progress, ratio, category } = torrent.originProp; if (categoryList.indexOf(category) !== -1 || torrent.leecher >= 100) { return false; } if ( (moment().hour() >= 0 && moment().hour() <= 7) || maindata.leechingCount <= 10 ) { return false; } if ( state === "downloading" && upspeed <= util.calSize(1, "MiB") && moment().unix() - torrent.addedTime >= 600 ) { return true; } return false; }; ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://wiki.vertex-app.top/zhu-yao-mo-kuai/shan-zhong-gui-ze.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.