快速上手 PT 助手 Plus：PT-Plugin-Plus 浏览器插件完整使用教程

快速上手 PT 助手 Plus：PT-Plugin-Plus 浏览器插件完整使用教程

【免费下载链接】PT-Plugin-PlusPT 助手 Plus，为 Microsoft Edge、Google Chrome、Firefox 浏览器插件（Web Extensions），主要用于辅助下载 PT 站的种子。项目地址: https://gitcode.com/GitHub_Trending/pt/PT-Plugin-Plus

PT-Plugin-Plus（PT 助手 Plus）是一款浏览器插件，把 PT 站的"找种子、发下载"流程压缩到两三次点击，适合用 Transmission、qBittorrent 等下载服务器、常驻多个 PT 站的用户。

📌 一、你为什么会遇到这个问题

两个场景，看看你是不是天天在重复：

场景 1：三部标签页找一部电影。在 A 站搜"奥本海默"只有老版本，再去 B 站、C 站各搜一次，手动复制关键词、人肉对比做种人数和文件大小。三部标签页来回切，电影是找到了，种子在哪不清楚。

场景 2：找到了好种子，下载流程却很手动。复制种子链接 → 打开 NAS 面板 → 新增下载任务 → 手填保存路径。手机上更劝退，经常"先放着"，然后就没有然后了。

传统手动流程至少 5 步：

1. 在站点搜索页找到目标种子
2. 复制种子链接
3. 打开下载服务器面板
4. 新增任务并填写保存路径
5. 切到下一个站点重复以上操作

PT 助手 Plus 的作用就是接管第 2~5 步：一次搜多个站点，点一下把种子发到下载服务器，路径还按站点自动区分。

⚙️ 二、动手之前：环境与准备

当前源码版本为1.6.1（见 package.json）。注意：项目已进入停止维护期，官方推荐迁移到继任项目 PT-depiler（以仓库 README 说明为准），但现有插件仍可正常使用，本文按仓库现状讲解。

前置条件：

• Node.js：14+，建议 17+（配合下文的 OpenSSL 参数）
• Yarn：项目锁定yarn@1.19.1
• Git

一条命令验证环境：

node -v && yarn -v && git --version

🚀 三、PT 插件安装步骤：从零到跑通

1. 克隆代码仓库：

git clone https://gitcode.com/GitHub_Trending/pt/PT-Plugin-Plus cd PT-Plugin-Plus

2. 安装依赖：

yarn install

3. 构建插件，成功后根目录生成dist文件夹（构建内容包含配置页、后台脚本、内容脚本和资源）：

yarn build

在 macOS / Linux 且 Node 17+ 环境下，需先设置export NODE_OPTIONS=--openssl-legacy-provider再执行构建，原因见第六节第 1 条。

4. 把dist文件夹加载进浏览器：

加载完成后，点击工具栏插件图标即可打开配置页面，在地址栏输入pt也会出现插件的搜索入口。

🔍 四、核心能力拆解：聚合搜索与一键下载

一键发送种子到下载服务器

点击站点页面上的种子，直接发送到下载服务器，无需复制链接。支持批量下载当前页所有种子、批量复制下载链接（部分站点需设置 passkey）。

关键配置项：配置页"下载客户端"（服务器地址、端口、认证信息）；下载历史默认关闭，可在配置页开启。

按站点设置下载规则

不同站点可以发到不同的下载服务器、使用不同的保存路径，这是比 RSS 更灵活的地方。

额外能力：显示默认下载服务器当前可用空间（目前支持 Transmission），避免下到一半磁盘满了。

多站聚合搜索

输入一次关键词，同时在多个站点搜索并汇总是结果，方便横向比较做种人数、文件大小。配置项为"搜索方案"，定义搜索哪些站点；入口在插件的搜索结果页，也支持地址栏快速触发（见第五节）。

影视页面一键搜索

在豆瓣电影页面、豆瓣 Top250、"选电影"、IMDb 电影页面点一下按钮，直接拿片名去搜 PT 种子，省掉手输片名的环节。

🧩 五、进阶玩法与个性化配置

组合技 1：地址栏直达聚合搜索。在"搜索方案"里配好多个方案后，地址栏输入pt+ 关键词，按 Tab 会列出"方案名 → 关键词"的建议，回车直接打开聚合搜索结果页。全程不用打开配置页，找片动线最短。

组合技 2：站点改版自救。站点更新页面导致解析失效时，进配置页的"站点搜索入口"和"站点插件"，按站点单独定制选择器与行为，把失效的解析规则调回来。

组合技 3：数据不断档。开启下载历史后，配合"备份"设置把完整配置备份到服务器，换电脑时恢复；也可以手动导出配置 JSON 存档，避免规则白配。

🐛 六、排障与高频疑问

1. 构建时报ERR_OSSL_EVP_UNSUPPORTED原因：webpack 4 使用 md4 哈希，与 Node 17+ 的 OpenSSL 3 不兼容。 解决：构建前执行export NODE_OPTIONS=--openssl-legacy-provider；Windows 下用set设置（package.json 的 build 脚本已内置 Windows 写法）。

2. 加载后浏览器看不到插件图标原因：开发者模式未开启，或dist不完整。 解决：确认dist/manifest.json存在；开启开发者模式后点"重新加载"；Firefox 必须用"临时加载附加组件"，不能直接打开 xpi。

3. 种子发不到下载服务器原因：客户端没启动，或地址/端口/认证填错。 解决：先手动启动下载服务器，再逐项核对"下载客户端"里的参数。

4. 部分站点识别不到种子原因：站点页面结构更新，解析规则失配。 解决：在"站点搜索入口"里自定义选择器；仍不行就看"系统日志"页面的报错信息定位。

📚 七、架构与源码导读

插件基于 Manifest V2（见public/manifest.json），三层分工：内容脚本抓取页面上的种子信息，后台脚本处理下载与搜索逻辑，options 页面负责配置与展示，改功能时按这个路径找文件就行。

下次再在三个站点标签页之间反复横跳时，试试用一次聚合搜索，找种子的动线会顺很多。现在就去克隆仓库，把它加载进你的浏览器吧。

【免费下载链接】PT-Plugin-PlusPT 助手 Plus，为 Microsoft Edge、Google Chrome、Firefox 浏览器插件（Web Extensions），主要用于辅助下载 PT 站的种子。项目地址: https://gitcode.com/GitHub_Trending/pt/PT-Plugin-Plus