#6564·MoviePilot

[错误报告]: 插件市场无法加载使用 package.v3.json 的插件

Author: andyxu8023Created Sep 3, 2026Updated Sep 18, 2026
Labelsbug

确认

  • 我的版本是最新版本,我的版本号与 version 相同。
  • 我已经 issue 中搜索过,确认我的问题没有被提出过。
  • 我已经 Telegram频道 中搜索过,确认我的问题没有被提出过。
  • 我已经修改标题,将标题中的 描述 替换为我遇到的问题。

当前程序版本

v3.0.0

运行环境

Docker

问题类型

主程序运行问题

问题描述

现象

  • 插件市场无法显示使用 package.v3.json 的插件
  • 用户配置了插件仓库 https://github.com/andyxu8023/MoviePilot-Plugins,该仓库包含 GetMissingEpisodes(剧集管家)插件
  • 重启 MoviePilot 后仍然无法在插件市场中看到该插件

复现步骤

  1. PLUGIN_MARKET 中添加包含 package.v3.json 的插件仓库
  2. 重启 MoviePilot
  3. 打开插件市场页面
  4. 搜索该仓库中的插件

期望行为

  • 插件市场应该能够加载并显示使用 package.v3.json 的插件

已定位 / 推测

通过分析代码发现,MoviePilot V3 的插件市场加载逻辑存在问题:

  1. VERSION_FLAGv3
  2. VERSION_BACKWARD_COMPATIBLE_FLAGS["v3"] = ["v2"]
  3. async_online_candidates 调用 async_collect 时,compatible_flags["v2"]
  4. async_collect 会为每个市场创建两个任务:
    • 加载 package.json(v1 基础版本)
    • 加载 package.v2.json(v2 向后兼容版本)
  5. 但不会加载 package.v3.json

相关代码位置:

  • /app/app/runtime/extensions/plugin/catalog.py 第 240-245 行
  • /app/app/application/plugin/catalog.py 第 233-260 行

验证:直接调用 client.get_plugins(repo_url, 'v3') 可以正确获取到插件列表,证明仓库配置和插件本身没有问题。

已尝试的处理

  • 重启 MoviePilot 服务
  • 检查插件仓库配置
  • 验证 GitHub API 可以直接获取插件列表

建议修复

修改 async_collect 方法,使其也加载当前版本的 package.v3.json,而不仅仅是向后兼容的 package.v2.json

发生问题时系统日志和配置文件

bash
### Doctor 摘要
状态:healthy
运行环境:Docker
汇总:total=14 error=0 warn=1 advisory=1 fixed=0
关键发现:
- [warn/advisory] 最近日志存在插件异常;来源:autosignin.log, dockercopilothelper.log;命中:7 条,去重后 5 条;建议:可使用安全模式启动后检查插件配置。

### 日志筛选依据
策略:time_window_and_keyword_block_match
时间窗口:最近 60 分钟
窗口起点:2026-09-03T15:13:41
关键词:GetMissingEpisodes、剧集管家、plugin
单文件最多保留:80 行
命中文件:
- /config/logs/moviepilot.log;命中关键词:GetMissingEpisodes、plugin、剧集管家;行数:80

### moviepilot.log
【INFO】2026-09-03 16:09:46,970 [-] - plugin.py - 开始识别标题:mac 版Farming Simulator 25 ...
【INFO】2026-09-03 16:09:48,076 [-] - plugin.py - 开始识别标题:Windows 11 X64 Pro en-US APRIL TPM BYPASSED 2022 - CzOS [Multilingual] ...
【INFO】2026-09-03 16:09:49,660 [-] - plugin.py - 开始识别标题:VMware Workstation Pro 16.1.0 Build 117198959 incl keygen [CrackingPatching] [Pre-Activated] ...
【INFO】2026-09-03 16:09:50,211 [-] - plugin.py - 开始识别标题:Stellar Phoenix Windows Data Recovery Professional <IP> + Crack [Full Setup] ...
【INFO】2026-09-03 16:09:50,814 [-] - plugin.py - 开始识别标题:Disk Drill Professional <IP> + Crack [Stable] ...
【INFO】2026-09-03 16:09:51,312 [-] - plugin.py - 开始识别标题:WinRAR 5.40 [EN] 32bit + 64bit + Patch - Crackingpatching.com [Clean] ...
【INFO】2026-09-03 16:09:51,950 [-] - plugin.py - 开始识别标题:YTD Youtube Downloader 6.12.11 + Crack {B4tman} (Full) ...
【INFO】2026-09-03 16:09:52,484 [-] - plugin.py - 开始识别标题:DaVinci Resolve Studio 18.1.0.0016 (x64) + Crack (Clean Install) ...
【INFO】2026-09-03 16:09:52,983 [-] - plugin.py - 开始识别标题:Topaz Video AI 3.3.3 (x64) + Crack (Multilingual) ...
【INFO】2026-09-03 16:09:53,478 [-] - plugin.py - 开始识别标题:ReFX Nexus v2.2 VSTi RTAS DVDR - AiRISO [deepstatus] [Final] ...
【INFO】2026-09-03 16:09:56,888 [-] - plugin.py - 开始识别标题:KMS Tools Portable by Ratiborus 01.12.2023 [Repack] ...
【INFO】2026-09-03 16:09:57,987 [-] - plugin.py - 开始识别标题:Adobe Photoshop Lightroom CC 2015 6.1 + Crack (Clean Install) ...
【INFO】2026-09-03 16:09:58,530 [-] - plugin.py - 开始识别标题:Star Wars: The Mandalorian & Grogu 2026 1080p HMAX WEB-DL H.264 Atmos DDP 5.1-LongWeb ...
【INFO】2026-09-03 16:09:58,855 [-] - plugin.py - 开始识别标题:Star Wars: The Mandalorian & Grogu 2026 1080p HMAX WEB-DL H.264 Atmos DDP 5.1-LongWeb ...
【INFO】2026-09-03 16:09:59,216 [-] - plugin.py - 开始识别标题:CCTV-1 First Class Begins 20260901 1080i HDTV AVC DD5.1-QHstudIo ...
【INFO】2026-09-03 16:09:59,725 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 3 Aston Villa vs Arsenal 2026 08 31 2160p WEB-DL HDR HFR HEVC AAC 2.0-SKYSPORTSUHD ...
【INFO】2026-09-03 16:10:00,066 [-] - plugin.py - 开始识别标题:mpv-win64-static ...
【INFO】2026-09-03 16:10:00,599 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 1 Manchester City vs Bournemouth 2026 08 23 2160p WEB-DL HDR HFR HEVC AAC 2.0-SKYSPORTSUHD ...
【INFO】2026-09-03 16:10:00,957 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 1 Newcastle United vs Liverpool 2026 08 23 2160p WEB-DL HDR HFR HEVC AAC 2.0-SKYSPORTSUHD ...
【INFO】2026-09-03 16:10:01,262 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 2 Crystal Palace vs Manchester City 2026 08 28 2160p WEB-DL HDR HFR HEVC AAC 2.0-SKYSPORTSUHD ...
【INFO】2026-09-03 16:10:01,584 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 2 Manchester United vs Ipswich Town 2026 08 30 2160p WEB-DL HDR HFR HEVC AAC 2.0-CANAL+UHD ...
【INFO】2026-09-03 16:10:02,025 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 1 Arsenal vs Coventry City 2026 08 21 2160p WEB-DL HDR HFR HEVC AAC 2.0-SKYSPORTSUHD ...
【INFO】2026-09-03 16:10:05,689 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 1 Manchester City vs Bournemouth 2026 08 23 2160p WEB-DL HDR HFR HEVC AAC 2.0-SKYSPORTSUHD ...
【INFO】2026-09-03 16:10:06,030 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 1 Newcastle United vs Liverpool 2026 08 23 2160p WEB-DL HDR HFR HEVC AAC 2.0-SKYSPORTSUHD ...
【INFO】2026-09-03 16:10:06,402 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 2 Crystal Palace vs Manchester City 2026 08 28 2160p WEB-DL HDR HFR HEVC AAC 2.0-SKYSPORTSUHD ...
【INFO】2026-09-03 16:10:06,763 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 2 Manchester United vs Ipswich Town 2026 08 30 2160p WEB-DL HDR HFR HEVC AAC 2.0-CANAL+UHD ...
【INFO】2026-09-03 16:10:10,445 [-] - plugin.py - 开始识别标题:EPL 2026-27 Round 1 Arsenal vs Coventry City 2026 08 21 2160p WEB-DL HDR HFR HEVC AAC 2.0-SKYSPORTSUHD ...
【INFO】2026-09-03 16:10:10,836 [-] - plugin.py - 开始识别标题:METAL GEAR SOLID – Master Collection Version v3 0 0 + European Pack / Japanese Language Pack DLCs-FitGirl ...
【INFO】2026-09-03 16:10:11,507 [-] - plugin.py - 开始识别标题:CCTV-1 First Class Begins 20260901 1080i HDTV AVC DD5.1-QHstudIo ...
【INFO】2026-09-03 16:10:11,851 [-] - plugin.py - 开始识别标题:This Party 2026 1080p NF WEB-DL x264 DDP5.1-FLUX ...
【INFO】2026-09-03 16:10:16,135 [-] - plugin.py - 开始识别标题:Ankam Attahasam 2026 2160p SNXT WEB-DL DDP5.1 H.265-KCx ...
【INFO】2026-09-03 16:10:17,731 [-] - plugin.py - 开始识别标题:Th Pelican Brief 1993 EUR 1080p BluRay VC-1 TrueHD 5.1 2Audio-UBits ...
【INFO】2026-09-03 16:10:19,348 [-] - plugin.py - 开始识别标题:This Party 2026 1080p NF WEB-DL x264 DDP5.1-FLUX ...
【INFO】2026-09-03 16:10:19,701 [-] - plugin.py - 开始识别标题:LEGO Star Wars The Mandalorian 2026 2160p DSNP WEB-DL DV HDR10+H.265 DDP5.1-BYNDR ...
【INFO】2026-09-03 16:10:20,786 [-] - plugin.py - 开始识别标题:METAL GEAR SOLID – Master Collection Version v3 0 0 + European Pack / Japanese Language Pack DLCs-FitGirl ...
【INFO】2026-09-03 16:10:21,099 [-] - plugin.py - 开始识别标题:Jared Freid The Family Plan 2026 1080p NF WEB-DL x264 DDP 5.1-CUPCAKES ...
【INFO】2026-09-03 16:10:22,179 [-] - plugin.py - 开始识别标题:Ankam Attahasam 2026 2160p SNXT WEB-DL H.265 DDP5.1-KCx ...
【INFO】2026-09-03 16:10:22,524 [-] - plugin.py - 开始识别标题:Heaven Is My Way aka Kupilih Jalur Langit 2026 1080p NF WEB-DL x264 DDP 5.1-ATMOS ...
【INFO】2026-09-03 16:10:24,246 [-] - plugin.py - 开始识别标题:W lesie dzis nie zasnie nikt II 2021 1080p NF WEB-DL x264 DD+5.1 Atmos-playWEB ...
【INFO】2026-09-03 16:10:26,045 [-] - plugin.py - 开始识别标题:W lesie dzis nie zasnie nikt II 2021 2160p NF WEB-DL H.265 DD+5.1 Atmos-playWEB ...
【INFO】2026-09-03 16:10:26,414 [-] - plugin.py - 开始识别标题:Bo Jue Qian Jin De Wei Xian Hun Yue 2026 S01 720p WEB-DL H.265 AAC-GodDramas ...
【INFO】2026-09-03 16:10:28,342 [-] - plugin.py - 开始识别标题:Feng Yin Chen Yuan 2026 S01 720p WEB-DL H.265 AAC-GodDramas ...
【INFO】2026-09-03 16:10:28,544 [-] - plugin.py - 开始识别标题:Hun Hou Xin Dong Ling Zong Zhui Qi You Dian Tian 2025 S01 720p WEB-DL H.264 AAC-GodDramas ...
【INFO】2026-09-03 16:10:29,694 [-] - plugin.py - 开始识别标题:Shen Huan Jue Zheng Wo Bei Zhu Chu Jia Men 2025 S01 720p WEB-DL H.264 AAC-GodDramas ...
【INFO】2026-09-03 16:10:31,460 [-] - plugin.py - 开始识别标题:Xian Hun Hou Ai Pei Shao De Qi Yue Xiao Jiao Qi 2024 S01 720p WEB-DL H.264 AAC-GodDramas ...
【INFO】2026-09-03 16:10:33,014 [-] - plugin.py - 开始识别标题:Zhong Nian Ma Ma Jue Xing Le 2025 S01 720p WEB-DL H.264 AAC-GodDramas ...
【INFO】2026-09-03 16:10:34,803 [-] - plugin.py - 开始识别标题:Gai Xiu Wu Qing Dao Hou Shi Xiong Men Ku Zhe Qiu Yuan Liang 2026 S01 720p WEB-DL H.265 AAC-GodDramas ...
【INFO】2026-09-03 16:10:38,214 [-] - plugin.py - 开始识别标题:Leng Ku Xian Sheng Zhuan Shu Chong Ni 2025 S01 720p WEB-DL H.264 AAC-GodDramas ...
【INFO】2026-09-03 16:10:42,701 [-] - plugin.py - 开始识别标题:Zi Chen Yu Shu 2026 S01 720p WEB-DL H.265 AAC-GodDramas ...
【INFO】2026-09-03 16:10:42,910 [-] - plugin.py - 开始识别标题:Bie Re Ta Ta Ba Shi Chong Nv Kuang Xiao 2026 S01 720p WEB-DL H.265 AAC-GodDramas ...
【INFO】2026-09-03 16:10:44,007 [-] - plugin.py - 开始识别标题:Star Wars: The Mandalorian & Grogu 2026 1080p HMAX WEB-DL H.264 Atmos DDP 5.1-LongWeb ...
【INFO】2026-09-03 16:10:44,363 [-] - plugin.py - 开始识别标题:Zhen Qian Jin Ma Jia You Dian Duo 2026 S01 720p WEB-DL H.265 AAC-GodDramas ...
【INFO】2026-09-03 16:10:51,521 [-] - plugin.py - 开始识别标题:Ma Ma De Fan Zha Gong Lve 2026 S01 720p WEB-DL H.265 AAC-GodDramas ...
【INFO】2026-09-03 16:10:54,478 [-] - plugin.py - 开始识别标题:Xiao Shi Sheng Si Ju Wo Dai Cun Min Zhuan Yi Sheng Zhu 2026 S01 720p WEB-DL H.265 AAC-GodDramas ...
【INFO】2026-09-03 16:10:56,322 [-] - plugin.py - 开始识别标题:Qia Si Gu Ren Lai 2025 S01 720p WEB-DL H.265 AAC-GodDramas ...
【INFO】2026-09-03 16:10:58,438 [-] - plugin.py - 开始识别标题:Cai Huang De Mei Nv Zong Cai Lao Po 2025 S01 720p WEB-DL H.264 AAC-GodDramas ...
【INFO】2026-09-03 16:11:00,204 [-] - plugin.py - 开始识别标题:Quan Neng Hou Ma Yang Fan Pai
...(已截断)

本 Issue 由 MoviePilot Agent 协助用户提交。