MoviePilot 种子名自动测试与下载 (增强版)

Arthur Cole
2026-03-11T06:39:09Z

在各大 PT 站点详情页自动提取种子名称，发送至 MoviePilot 进行识别，支持手动匹配和一键推送下载。

======================================================================
MoviePilot 种子名自动测试与下载 (增强版) v3.1.3
======================================================================

结合 MoviePilot 的媒体识别与自动化能力，自动识别当前种子对应的影视信息，并支持一键推送至 MoviePilot 下载。

本脚本基于原作者 yubanmeiqin9048 的思路持续增强，重点优化了：
- M-Team 新版页面结构适配
- SPA 路由切换残留状态清理
- 自动识别候选词重试策略
- 安全性与可发布性

----------------------------------------------------------------------
【 核心功能亮点 】
----------------------------------------------------------------------
* 自动识别 + 多轮重试：进入种子详情页后自动提取标题，按“原始标题/清洗标题/去集数或年份变体”等候选依次识别，显著提升命中率。
* 手动关联识别：自动失败时可一键打开弹窗，使用 TMDB 搜索（支持全部/电视剧/电影）并按 ID 精确绑定。
* 一键推送下载：自动打包种子标题、详情页链接、站点域配置（Cookie/代理等）并提交给 MoviePilot 下载接口。
* 进度与报错可见：页面内提供状态提示，失败可直接查看原因；支持调试日志开关用于排查兼容问题。
* M-Team 专项增强：优化标题提取策略，并在 SPA 页面路由切换时自动清理旧状态，避免“非详情页残留识别结果”。

----------------------------------------------------------------------
【 首次安装与配置 】
----------------------------------------------------------------------
1. 安装脚本并打开任意支持站点的种子详情页。
2. 首次运行会自动弹出配置面板（缺配置时会阻止识别流程）。
3. 需要填写以下 4 项：
- MoviePilot 地址（必须含 `http://` 或 `https://` 与端口）
- MoviePilot 用户名
- MoviePilot 密码
- TMDB API Key（需使用你自己的 Key）
4. 点击保存后生效。

油猴菜单：
- `⚙️ 设置 MoviePilot 账号`：修改 MP/TMDB 配置
- `🧪 切换调试日志`：开启/关闭控制台调试输出（默认关闭）

----------------------------------------------------------------------
【 常见问题 (FAQ) 】
----------------------------------------------------------------------
Q：为什么“自动识别失败”但不是报错？
A：通常是 MoviePilot 识别接口返回了空结果（`media_info: null`），说明该标题未匹配到有效影视条目，不是网络或登录故障。

Q：手动搜索 TMDB 没结果？
A：请优先检查：
1. TMDB API Key 是否填写正确、是否可用；
2. 浏览器网络是否可访问 `api.themoviedb.org`；
3. 关键词是否过脏（可手动删掉分辨率/编码/日期等后再搜）。

Q：切到其他页面后，之前识别状态还在吗？
A：`v3.1.1` 已处理：M-Team 非 `/detail/{id}` 页面会自动清理注入状态与弹窗。

Q：点击下载后推送失败？
A：常见原因包括：
1. MoviePilot 未配置该站点规则（Cookie/UA/代理）；
2. 下载器未在 MoviePilot 中正确配置或掉线；
3. 站点下载链接受限，后端无法拉取。

----------------------------------------------------------------------
【 安全与隐私说明 】
----------------------------------------------------------------------
* 不再内置任何 TMDB 公共 Key，必须使用你自己的 Key。
* 配置信息仅保存在油猴本地存储（GM_setValue），脚本不会主动上传到第三方服务。
* 调试日志默认关闭；开启时会避免输出敏感令牌。
* 已对关键动态渲染内容做转义处理，降低注入风险。

----------------------------------------------------------------------
声明：本脚本仅用于个人自动化管理辅助，与 MoviePilot 官方开发组无直接关联。
感谢原作者 yubanmeiqin9048 的思路启发与初代代码。