crazyq/pt_helper repository overview

⁠pt_helper PT小助手

⁠一、小助手简介

pt_helper PT小助手集自动刷流与签到于一身，既可以第一时间获取最新发布的免费种子（默认跳过HR种子），又能够在种子免费期过后自动删除种子和文件，还支持站免、HR等模式，从此再也不用花时间配置Flexget和Autoremove-torrents了。 目前小助手支持的PT站情况如下：

⁠二、使用方式及步骤

1. 确认CPU架构并配置好Docker环境，小助手目前支持AMD64、ARM和ARM64三种架构

2. 群晖用户适用（威联通用户可参考）

3. unraid用户适用：CA里搜索pt_helper即可

4. Linux用户适用

   docker run --restart=always -d --name pt_helper -p 你指定的端口:8192 -v 你的数据存放目录:/data crazyq/pt_helper:latest
   

   Copy

   参考：

   docker run --restart=always -d --name pt_helper -p 8192:8192 -v /volume1/docker/ptdata1:/data crazyq/pt_helper:latest
   

   Copy

5. 打开浏览器访问：http://docker所在机器IP:你指定的端口⁠ ，参考： http://192.168.1.1:8192⁠ ，默认登陆用户名密码：admin

6. 登陆后，点击“下载服务器管理”，配置qBittorrent/Deluge2/Transmission服务器，点击“测试服务器”待测试成功后，点击确定保存

7. 点击“站点管理”，完善站点的Cookie，Cookie格式为：以分号分割的键值对，例如： name1:value1; name2=value2，建议通过F12开发者工具获取Cookie

8. 小助手会每隔10分钟获取一次有到期时间且不为HR的Free种，然后把种子交给上述第4步中的下载服务器进行下载，并且在种子免费期过后删除种子和文件

建议：强烈建议刷流与保种分开，推荐单独开一个下载服务器的容器来刷流

⁠三、更新

1. 方法一（推荐）：无需更新镜像，通过小助手首页检查更新，按提示更新后重启Docker即可完成自动更新。
2. 方法二：重新拉取最新镜像，删除原容器，与原容器配置保持一致新建新的容器。
3. 小助手v1不能通过方法一升级到v2，需要采用方法二，并删除原有的数据目录。

⁠四、常见问题

1. pt小助手提示种子添加成功，但是下载服务器中并没有出现任务。-->请到该站种子列表页面（不是种子详情页面！），随便选择一个种子，点击右侧的下载，确认第一次下载种子的页面是否已经点掉。
2. 套件版Tr自动停止。-->换Docker版，同时qBittorrent也推荐用Docker版。
3. qBittorrent自动新建的分类能不能删？-->不能删，删了就不会自动删种了。
4. HR的设置的单位是什么？-->天，即小助手添加种子的日期+HR天数=删种时间，这里设置的天数是包括种子下载时间的，开了HR要经常去网站看看，小心吃HR
5. 怎么修改刷流频率？ 怎么刷多个站？ -->以上功能需要在参数管理的License中输入helloworld（可能会失效，每天可在小助手里获取）解锁，喜欢的可以找我PY属于自己的License
6. 站点管理点开没东西。-->Ctrl+F5试试，不行的话就是小助手v2版本不兼容v1的数据目录，需要删除原来的数据目录后重启容器。

⁠五、更新日志

⁠2023-9-7 v2.4.3

1. 重新适配HHAN

⁠2023-9-5 v2.4.2

1. 重新适配SSD

⁠2023-8-28 v2.4.1

1. 修了个会导致识别不到下载地址的BUG

⁠2023-8-26 v2.4.0

1. 重新适配HHAN

⁠2023-7-16 v2.3.9

1. chd域名修改

⁠2023-6-15 v2.3.8

1. 重新适配NICEPT

⁠2023-5-15 v2.3.7

1. 支持HHAN

⁠2022-12-3 v2.3.6

1. 重新适配NICEPT

⁠2022-11-27 v2.3.4 - v2.3.5

1. 重新适配SSD

⁠2022-9-24 v2.3.3

1. 最近实在太忙了，不好意思，等忙完再来个更新
2. 修复qBittorrent版本>=4.4.4时无法连接的坑
3. 适配HDSKY签到，又要验证码啦，记得配置百度OCR

⁠2022-6-16 v2.3.2

1. 测试Tracker时，会先测试网络连通性，解决了群晖下测试失败的问题

⁠2022-6-16 v2.3.1

1. 重新适配HARES及签到
2. 适配HDSKY签到
3. 测试Tracker时，会先测试网络连通性
4. 测试Tracker时，会返回限时免费且做种人数=1的种子，便于观察
5. 界面优化

⁠2022-4-25 v2.3.0

1. 针对NICEPT的更新重新适配

⁠2022-3-1 v2.2.9

1. 优化HR处理逻辑
2. 修复TTG站免模式下删除种子时间不对的BUG，也顺便优化了站免的逻辑

⁠2022-2-28 v2.2.8

1. 优化数据读写性能
2. 当无视HR时，不对HR种子打标
3. 更新获取License的链接
4. 修复在qBittorrent下开启种子上传情况扫描后，存在非小助手添加的种子时导致不能正常处理的问题
5. 修复在多个下载器下，默认只启动一个种子上传情况扫描的问题

⁠2022-2-22 v2.2.3-v2.2.7

1. 适配HARES签到
2. 在已有登陆记录推送的基础上，增加登陆日志记录
3. 在下载服务器管理中增加最低上传速度限制（单位KB/s），两次种子上传情况检查区间内平均上传速率小于该值，非HR且已完成的种子将被删除

⁠2022-2-21 v2.1.9-v2.2.2

1. 修复种子上传情况检查中的BUG
2. 日志输出调整，查问题起来容易点
3. 删除磁盘空间限制，保留种子上传情况扫描，如果有已完成且不是HR的种子，在两次种子上传情况检查区间内，都没有贡献任何上传，那么该种子将会被删除
4. 增加robots.txt禁止爬虫
5. 增加默认密码修改提示，请大家尽快修改默认密码
6. 一定时间内，尝试登陆失败次数过多，IP会被封禁

⁠2022-2-20 v2.1.8

1. 种子列表新增HR标记
2. 新增磁盘空间限制，在达到磁盘空间限制后，如果有已完成且不是HR的种子，在两次扫描的间隔中，都没有贡献任何上传，那么该种子将会被删除
3. 为了以防更新前的HR种子被误删，此次更新会把以前的种子都打上HR标记，但不影响FREE过自动删除

⁠2022-2-19 v2.1.6-2.1.7

1. 修复因为绕过第一次下载导致TTG无法下载种子的BUG
2. 增加站点自定义限速
3. 界面优化
4. 执行逻辑优化
5. 针对HARES的更新重新适配

⁠2022-2-18 v2.1.5

1. 自动绕过第一次下载提示
2. 增加登陆成功、失败推送
3. 优化种子获取逻辑

⁠2022-2-17 v2.1.4

1. 企业微信推送改为图文推送，图片可自定义
2. 小助手LOGO更新
3. 支持Deluge1.3+

⁠2022-2-16 v2.1.1-v2.1.3

1. bark推送增加图标
2. 增加企业微信推送
3. 界面优化
4. 修复多个下载服务器下不会删除种子的BUG

⁠2022-2-15 v2.1.0

1. 增加新人引导
2. 界面优化

⁠2022-2-14 v2.0.3-v2.0.8

1. 增加微信推送WxPusher（优先推送bark，没有配置bark就推送WxPusher）
2. 验证码识别从联众换成百度通用文字识别-高精度版
3. 适配HDCHINA
4. 站点管理里的种子页面已经解锁，请谨慎修改

⁠2022-2-13 v2.0.1-v2.0.2

1. 支持Transmission2.x 以及 3.x
2. 种子列表页面增加站点名称显示
3. 修复默认下载路径配置导致下载失败的问题

⁠2022-2-13 v2.0.0

1. 支持多个下载服务器
2. 支持同时刷多个站，每个站的策略可以单独设置
3. 刷流频率可以调节
4. 以上功能需要在参数管理的License中输入helloworld（可能会失效，每天可在小助手里获取）解锁，喜欢的可以找我PY属于自己的License

⁠2022-1-2 v1.9.3

1. 支持OPENCD
2. OPENCD单种自动限速100MB/s

⁠2021-12-20 v1.9.2

1. 支持AUDIENCES
2. AUDIENCES单种自动限速125MB/s
3. OB单种自动限速100MB/s
4. HDHOME单种自动限速25MB/s
5. PTHOME单种自动限速100MB/s

⁠2021-12-10 v1.9.1

1. U2单种自动限速50MB/s

⁠2021-11-29 v1.9.0

1. 修复MSG不能下载种子的BUG
2. bark消息推送到"PT小助手"分组
3. HDHOME改用HTTPS连接

⁠2021-10-4 v1.8.9

1. 新增密码重置功能
2. 小助手首页可以正确显示无视HR模式

⁠2021-10-2 v1.8.8

1. 新增无视HR模式，hrMode设置为-1时，可以无视HR。
2. 修复defaultDownloadPath=0时，会创建目录0的问题。

⁠2021-10-1 v1.8.7

1. 修复个BUG，TTG在开HR模式后获取删除时间不对。
2. 移除TJUPT和HDCHINA的支持。
3. 新增SSD隐藏功能（没啥用，不用惦记）

⁠2021-9-13 v1.8.6

1. Docker镜像从latest、arm64_latest合并为latest
2. 修复首页界面显示的BUG
3. 适配LEMONHD站免

⁠2021-8-30 v1.8.5

1. 在参数管理中，新增UserAgent修改
2. 首页新增显示当前刷流站点、HR模式状态以及当前UserAgent
3. 修复站免模式下，一定几率下添加不了种子的BUG
4. 修复TTG在站免模式下获取不到到期时间的BUG

⁠2021-8-23 v1.8.4

1. 修复当种子大小为整数时不能正常获取种子大小的BUG
2. 修复bark推送地址为0时仍然推送的BUG
3. 完善了参数管理里的一些说明

⁠2021-8-4 v1.8.3

1. 优化做种人数处理，修复SSD不能获取做种人数的问题

⁠2021-7-28 v1.8.2

1. 支持HARES

⁠2021-7-11 v1.8.1

1. 针对LEMONHD的更新重新适配

⁠2021-7-5 v1.8.0

1. NICEPT单种自动限速12MB/s
2. 获取新种逻辑优化
3. 修复hrMode=0时获取不到新种子的bug

⁠2021-6-25 v1.7.9

1. 适配CHD的HR

⁠2021-5-3 v1.7.8

1. 增加HDCHINA的支持
2. 获取新种逻辑优化

⁠2021-4-28 v1.7.7

1. 针对LEMONHD的更新重新适配

⁠2021-4-19 v1.7.6

1. 修复不能清空日志的bug

⁠2021-4-12 v1.7.5

1. 新增CHD签到遇到多选题时自动换题功能
2. 修复Cookie以;结尾时导致解析错误的bug
3. 小助手架构优化

⁠2021-4-11 v1.7.4

1. 新增bark推送测试
2. Golang版本更新到1.16.3
3. 容器基础镜像升级到Alpine3.13

⁠2021-4-10 v1.7.3

1. 优化bark推送信息，标题会显示刷流的Tracker
2. 站点管理新增“Tracker测试”，用来获取一条符合要求的种子，方便测试设置

⁠2021-4-8 v1.7.2

1. 针对LEMONHD的更新重新适配

⁠2021-4-8 v1.7.1

1. 在运行情况页面新增数据库压缩功能，在清空日志后使用效果格外明显

⁠2021-4-6 v1.7.0

1. 修复联众识别验证码时图片是竖着的bug
2. 联众识别验证码错误后支持反馈错误并返还点数

⁠2021-3-25 v1.6.8 - v1.6.9

1. 连接下载服务器时忽略对https证书的检查
2. https相关bug修复

⁠2021-3-25 v1.6.7

1. 更新了一下种子免费时间的获取逻辑
2. 优化了一下种子获取的逻辑希望适配gz起来方便一点

⁠2021-3-25 v1.6.6

1. 优化CHD、HDSKY签到

⁠2021-3-24 v1.6.5

1. CHD支持签到

⁠2021-3-24 v1.6.4

1. HDSKY支持签到

⁠2021-3-23 v1.6.3

1. 更新文件的存储从腾讯COS换成了UCloud，又可以白嫖了

⁠2021-3-23 v1.6.2

1. 优化自动更新逻辑，做好了腾讯COS跳坑的准备
2. 界面优化

⁠2021-3-22 v1.6.1

1. 修复TTG识别HR种错误的问题

⁠2021-3-21 v1.6.0

1. 首页可以显示刷流刷新频率及扫描次数
2. UI优化
3. 定时任务逻辑优化
4. 支持TTG

⁠2021-3-18 v1.5.1

1. 修复清空日志后一定几率下出现日志插入失败的问题
2. 修复签到成功信息推送失败的问题

⁠2021-3-16 v1.5.0

1. 增加Transmission 2.9x 版本支持
2. 增加CHD HR标记识别

⁠2021-3-13 v1.4.0

1. 增加Deluge 2.0 版本支持

⁠2021-3-7 v1.3.4

1. 新增bark推送
2. 减少日志产生量

⁠2021-3-5 v1.3.3

1. 支持TLF

⁠2021-3-5 v1.3.2

1. 新增ARM64的Docker版本

⁠2021-2-20 v1.3.1

1. 修复Cookie识别的Bug

⁠2021-2-20 v1.3.0

1. 新增重启Docker自动更新的机制

⁠2021-2-18 v1.2.6

1. 新增HR模式，开启后，种子在HR时间过后才会删除
2. 新增站免模式，开启后，种子在站免结束后才会删除

⁠2021-2-18 v1.2.5

1. 增加种子大小区间限制

⁠2021-2-9 v1.2.4

1. 支持U2，无需修改Hosts等科学处理
2. 新增清空日志按钮
3. 添加失败的种子会在下次添加种子时作为新种子添加
4. 支持HDSKY

⁠2021-2-6 v1.2.3

1. 站点管理新增Cookie检测功能，检测成功可以显示站点用户名。
2. 支持PTER
3. 新增默认下载路径配置
4. FRDS单种自动限速12.5MB/s
5. UI优化
6. 日志优化

⁠2021-2-3 v1.2.2

1. Docker镜像改用Alpine作为基础镜像
2. 自动跳过HR种子
3. 支持LEMONHD

⁠2021-2-2 v1.2.1

1. 获取免费种子时，增加2xfree的识别
2. 将数据库与容器分离，数据库不放在Docker内，通过-v来外挂

⁠2021-2-1 v1.2.0

1. qBittorrent下，删除种子后，自动删除对应的分类
2. 新增签到功能

⁠2021-2-1 v1.0

1. 项目从Python重构为Golang，增加UI界面
2. 支持CHD/OB/TJUPT/MSG/TCCF/NICEPT/HDHOME/PTHOME/SSD

⁠五、BUG反馈

微信：crazyq 备注pt小助手

Email:[email protected]⁠