pt-tools 是什么
本页介绍 pt-tools 的用途、工作方式和 Web 界面中的各个页面，帮助你判断它是否适合自己。
pt-tools 是一个自托管的 PT（Private Tracker）站点管理工具。它在你自己的服务器、NAS 或电脑上运行，把多个 PT 站点、下载器和聊天通知放进同一个 Web 界面：定时拉取 RSS 订阅并把符合条件的种子推送到下载器，刷流、辅种和转移做种，订阅电影、追剧并把下载完的影视整理进媒体库，汇总各站点的用户数据和登录状态；可以在手机 App、QQ 或 Telegram 上查看和控制，也可以用自然语言交给内置的 AI 助手处理。
工作方式
pt-tools 是一个独立的程序，Web 界面和后台任务在同一个进程里运行，数据保存在本机的 SQLite 数据库中，不依赖任何托管服务。
- 站点：你添加的每个 PT 站点都使用你自己的 Cookie、API Key 或 Passkey 访问。当前内置 72 个站点，见支持站点。
- RSS 订阅：后台按设定的间隔拉取订阅，按过滤规则或免费状态筛选种子，再推送到下载器，见 RSS 订阅。
- 下载器：支持 qBittorrent 和 Transmission，可以同时添加多个。推送前会检查剩余空间和站点的做种数量上限。
- 做种：刷流任务按条件挑新种做种、按规则删种；IYUU 辅种让同一份数据在多个站点做种；转移做种把种子搬到另一台下载器。
- 追剧与媒体库：订阅一部电影、追一部剧集的一季以后，pt-tools 到各站点搜索，RSS 里出现时也会下载，按质量档案挑资源；下载完以后识别、按模板放进媒体库，并通知 Emby、Jellyfin 或 Plex。页面在「媒体」分组里，见追剧与订阅和整理入库。
- 首页：打开网页先到首页，上面是 NAS 概览、今天播出的集、待处理的事，以及下载器、存储与备份的状况；「系统 → 系统体检」一次检查 pt-tools 用到的服务与设置。见首页与系统体检。
- 通知与 ChatOps：推送结果和系统事件可以发到聊天软件；绑定过的聊天账号可以发送命令，见 ChatOps 快速开始。
- AI 助手：在「系统 → AI 助手设置」接上一个大模型以后，可以在网页、手机 App、Telegram 或 QQ 里用自然语言查数据、搜索和推送种子、管理订阅；改动类操作每次都要你确认才执行。见 AI 助手。
- 手机 App 与接口：手机 App 在「系统 → 远程访问」扫码配对，经直连或 relay 连回 pt-tools，连接端到端加密，见手机 App；脚本与 MCP 客户端用 API 令牌接入，MoviePilot、IYUU、Sonarr 这类工具可以经 qB 兼容入口把 pt-tools 当成 qBittorrent，Seerr 可以经 Servarr 兼容入口把它当成 Radarr、Sonarr。
其中刷流、辅种、转移做种、追剧与媒体库、首页、手机 App、AI 助手等是 1.0 预览版加入的功能，正式版 0.48.0 尚未包含，见 1.0 预览版新功能。
界面中的页面
左侧导航按用途分成几组。
| 分组 | 页面 | 用途 |
|---|---|---|
| 概览 | 首页、用户统计、数据导出、AI 助手 | NAS 概览、今天播出与待处理；所有站点的上传量、分享率、做种和等级进度；把统计导出为分享图；用自然语言查数据和操作 |
| 站点 | 站点列表、自动签到、已支持站点、CookieCloud 导入 | 添加和配置站点、查看登录状态；每天到站点签到；浏览内置站点及其认证方式；从 CookieCloud 导入 Cookie |
| 下载 | 种子搜索、任务列表、等免费、暂停任务、刷流任务、下载器 Web UI、下载器设置、下载器助手、转移做种、IYUU 辅种、qB 兼容入口 | 跨站点搜索并推送种子；查看 RSS 推送记录；等不免费的种子免费以后再下载；刷流、辅种与转移做种；管理下载器中的任务和下载器配置 |
| 媒体 | 探索、日历、追剧与订阅、媒体库、整理历史、媒体识别 | 浏览 TMDB 的榜单，订阅电影、追剧；按天看订阅的集哪天播出；订阅的进度与设置；设置媒体库与整理规则；查看整理结果；纠正识别结果 |
| 规则 | 过滤规则、自动清理 | 编写 RSS 过滤规则；配置自动删种、磁盘保护和工作目录清理 |
| ChatOps | 消息通知、消息模板、ChatOps 绑定、操作审计、RSS 通知日志 | 配置通知通道与消息模板；绑定聊天账号；查询命令记录和 RSS 通知的发送结果 |
| 系统 | 全局设置、系统体检、NAS 监控、CloakBrowser、API 令牌、MCP 接入、远程访问、AI 助手设置、运行日志、修改密码 | 运行间隔、下载策略等全局配置；检查各项服务与设置；首页 NAS 概览的来源；登录探测后备通道；令牌、MCP 与手机 App 的接入；AI 助手的模型；查看日志；修改密码 |
在手机上，同样的页面以卡片形式显示，底部导航提供常用入口。
适合谁
- 在多个 PT 站点刷流或追剧，需要按规则自动下载的用户。
- 希望同一份数据在多个站点做种的用户。
- 订阅电影、追剧，希望从找资源、下载到整理进媒体库都自动完成的用户。
- 希望在一个页面查看各站点数据、并在长期未登录之前收到提醒的用户。
- 已经在使用 qBittorrent 或 Transmission，希望统一管理多个下载器的用户。
使用前请注意
- pt-tools 使用你自己的账号凭证访问站点。启用自动访问前，请确认各站点的规则允许，并合理设置请求频率。pt-tools 不保证自动化访问不会被站点警告或封禁。
- 数据目录中的
secret.key用来加密站点 Cookie。丢失密钥后，已保存的 Cookie 无法恢复，请与数据库一起备份，见升级与备份。 - 不提供 macOS 二进制；macOS 请使用 Docker 运行。