文章摘自：ptools.fun

欢迎使用 PTools 欢迎加入 PTools 的大家庭，ptools 致力于让你更轻松更自动的玩 PT，目前实现了以下功能：说明：此前很多人都希望有个 win 版，我也进行了测试，发现问题太多，开发量巨大，且使用入门……

欢迎加入 PTools 的大家庭，ptools 致力于让你更轻松更自动的玩 PT，目前实现了以下功能：

说明： 此前很多人都希望有个 win 版，我也进行了测试，发现问题太多，开发量巨大，且使用入门难度极高，不符合本工具宗旨，所以取消 win 计划，推荐 winNas 用户使用 Linux 子系统使用 docker 版本，方便快捷。

1. 支持从 PTPP 备份文件导入站点信息

2. 支持油猴脚本添加站点和同步站点 Cookie 信息

3. 支持国内大部分 PT 站点的签到

4. 支持站点个人数据信息获取、展示

5. 支持部分站点拉取免费种子

6. 计划任务：自动化功能，支持签到、更新数据、拉取种子等功能的自动化

7. 通知功能：自动任务执行结束后发送任务执行报告，支持企业微信，wxpusher，IYUU，Pushdeer，Bark

8. 日志查看：十分钟左右生成一次执行日志，十分钟期间无操作的，无日志

9. OCR 识别接口：支持百度 OCR 文字识别，用于部分站点签到时的验证码识别

10. 种子管理：查看拉取到本地的免费种子信息，支持推送到下载器，目前仅支持自定义路径

11. 支持下载任务管理（目前仅实现了 qbittorrent 管理），实现对下载任务的基本操作，可能会存在种子过多无法加载的情况

12. 支持网页内更新、重启更新，无需重复拉取 docker 镜像，

13. 实现简易终端窗口

14. hosts 文件编辑

15. 等等

三板斧

部分站点比较特殊，例如：瓷器的 cookie 经常过期，站点访问性较差，自动任务总是失败，所以总结了三板斧操作

1. 出问题之后更新 Cookie
• 瓷器的 Cookie 有大佬测试可以试用手机浏览器 alook 获取，成功率很高
• 由于瓷器 Cookie 的特殊性，如果依旧失败，可以尝试以分号为单位，删除phpsession字段

2. 提取填写浏览器 User-Agent

3. CloudflareTest 优选站点 IP，并写入 hosts

提问

1. 请先详细阅读文档，文档讲解的很详细，当然可能有个别点不会很清晰，但很少吧？

2. 使用中遇到问题请先检查一下几个地方
1. 请先检查工具是否为最新版本，使用中遇到问题的，大部分很快就更新解决了，保持更新会解决很多问题，更新完别忘了同步数据库，想简单点，就遇到问题先重启一下。
2. 群里多爬爬楼，也能解决很多问题，或者直接搜一搜
3. 运行日志，搜索traceback关键字即可看到运行中出现的错误信息，求助时，可将这一块完整截图，支持下载日志文件，不找到怎么查找的，可以下载日志文件求助（虽然在代码中尽量避免在日志中出现敏感信息，但是每个人对敏感信息的定义有所不同，请注意咯）。
4. 自动任务运行记录，会标注自动任务运行状态，executed 表示运行成功，miss 表示时间错过了，多出现在重启服务时，err 表示运行错误，点击进去会有报错信息，求助时可以带上。

安装

PTools 文档访问链接

关于 https 反代的说明

功能一览

站点添加

1. 支持 PTPP 备份文件导入

注意事项：

1. 此功能仅为减轻手动录入工作量，部分站点导入失败属正常现象，

2. 站点较多时导入时间比较长，请稍微等待

2. 手动添加
1. 我的站点处添加





2. 我的数据处添加





两处添加并无什么不同，我的站点添加为框架自带的页面，较为简陋，后期会逐渐淘汰。
我的数据处还实现了站点信息图表，支持查看站点历史信息，以及数据展示图（求药图）
3. 油猴脚本添加，默认你知道油猴是啥，不知道的百度

暂时只支持 Cookie 同步，其他功能还没开发，不要催我，不要催我，不要催我，累

1. 安装油猴脚本 脚本获取地址：https://greasyfork.org/zh-CN/scripts/458791-pttoptools跳转链接
2. 在 Ptools 配置项中添加 token,token 可以自定义
3. 配置 Ptools 的 docker 地址，注意后面要加/

配置项

OCR 配置

1. 获取 OCR 授权信息

2. 添加到配置项，仅能添加一项，未配置时显示添加按钮，配置后显示删除按钮
指引

3. 添加成功后无需其他操作。

通知推送

1. 自行获取相关通知的账号、密钥、授权码等信息

2. 根据相关配置项进行填写。
填写教程指引

自动任务

1. 在计划任务 => 计划任务重可以添加自动任务，支持的任务可在任务选择任务中查看

2. 请需要运行的任务请保持开启状态

3. 任务类型支持间隔时间循环任务和 cron 任务
1. 间隔循环任务的时间表达式可以直接填写数字，单位为秒，也支持乘法表达式，乘号请使用表示，例如，可填写60，表示 1 分钟，60*60表示 1 小时，6*3600表示 6 小时
2. cron 任务的时间表达式为五位 cron 表达式，按顺序分别表示：分钟 小时 日 月 年，作为 pter，运行时间基本是每天重复，后三位直接使用即可，不同时间使用空格作为间隔，例如： 10 23 * * *表示每天晚上 11 点 10 分运行，
提供几个常用时间表达式，需要的请依次类推，搞 PT 还是要有折腾精神，自行学习一下 Cron 表达式：
每天晚上 11 点 10 分：10 23 * * *
每天早上 8 点 01 分：01 08 * * *
每天 8-18 点运行：0 8-18 * * *
每天 8-18 点每两个小时运行一次：0 8-18/2 * * *
每天 8 点，12 点，18 点运行：0 8,12,18 * * *

签到

1. 我的站点处勾选站点，点击工具栏的签到，等待时间较久，会在页面弹出通知。

2. 我的数据处可在站点卡片点击单站签到，页面会有通知，也可点击数据汇总卡片，实现全站签到，页面无通知，会推送消息到你设定的通知推送上。

3. 自动任务签到，按照你设定的时间执行签到，执行结束后发送任务报告，自动签到时默认会记录当天签到状态，已签到的不会重复签到，未签到的下次任务继续签到，所以，推荐设置时，每天执行多次。

更新数据

任务管理，目前仅为测试

1. 任务管理模块实现了 qb 下载任务的管理，暂时无添加任务功能。

2. 任务较多时，可能会出现一直在加载的情况，本人实测，2000 左右热任务数是没有问题的

3. 1.5 秒刷新一次，频率与 qb 的 webui 保持一致

代码更新

作为不断开发迭代的工具，工具的更新迭代非常快，请你跟上我们的步伐！

1. 当有更新时，会有更新按钮，你可以选择点击更新，更新结束后请点击同步数据库。

2. 重启时也会更新代码，当你在手动更新出错时，可以选择重启容器。

3. 运行中出错时，你也可以选择重启，会解决大部分问题。

简易终端

配置项

1. Toml 配置文件，目前主要用于保存 Filelist 站点用户名密码，以后会逐渐增加内容，例如：配置 HTPPS 反代域名，配置密钥等等

关于 toml 格式，我们有相关说明：链接

2. hosts 编辑，好多站点套了 cloudflare，访问缓慢，自动任务经常失败，需要自行优选站点 IP根据需要自行编辑，如你不懂得此项操作的含义，看看就行了，不要点 > 本文由简悦 SimpRead 转码