【MP插件】飞牛影视调度器——让你的飞牛影视乖乖刮削

EWEDL

使用过飞牛影视的用户，大多都对其本地媒体库的“秒级入库”印象深刻。然而，当我们的媒体库从本地硬盘迁移到云盘挂载时，情况就变得复杂起来。

由于云盘特性，飞牛影视原生的扫描机制在处理网盘路径时，依赖于定时刷新，并且每次都会扫描整个媒体库。对于影视库体量庞大、动辄数十TB的用户而言，这意味着更新一部影片可能需要长达数十分钟甚至更久的等待，体验大打折扣。为了解决这一核心痛点，我开发了这款名为“飞牛影视调度器 (Fnmvscheduler)”的MP插件，它专为应对云盘挂载等复杂场景下的扫描调度难题而生。（我们无法在本文介绍MP是什么，请朋友们自行从别的渠道进行了解）

📖它是什么？

简单来说，飞牛影视调度器是一款 MP 插件。它不再依赖于被动的定时扫描，而是通过主动监听 MP 的“转移完成”事件，在确认文件已经“安家落户”后，立即向飞牛发起一次有针对性的扫描请求。

• 传统网盘扫描：依赖定时刷新，每次都会对整个媒体库进行全量扫描。对于大型影视库，这无疑是一场漫长且低效的等待。
• 飞牛影视调度器：由事件精准触发，确保在最佳时机（文件转移完成时）执行，并且能够做到“指哪扫哪”，只扫描更新的文件夹，告别了全盘扫描的漫长耗时。

✨核心特性：专为复杂场景设计

• 🎯 精确扫描模式 (首选推荐)：这是插件的王牌功能！启用后，它会直接命令飞牛仅扫描刚刚入库的那个影视文件夹。这意味着，无论你的媒体库有多庞大，入库时间都能从过去的数十分钟缩短至秒级，体验媲美本地存储。
• 🧠 智能网盘模式：专为云盘挂载深度优化。内置了防抖、任务冲突检测、智能重试与静默等待等一系列高级逻辑，能有效过滤掉网络波动带来的干扰，在复杂的网络环境下最大限度地保证扫描成功率。
• 🛡️ 任务冲突防护：在触发新扫描前，它会像个聪明的交通警察，主动检查飞牛服务器是否已在执行扫描任务。如果有，它会智能排队等待，有效避免系统资源冲突和任务重复。
• 🚀 高效Token管理：内置智能Token缓存机制，30分钟内复用登录状态，大幅减少对服务器的重复登录请求，响应更迅速，也更友好。
• 🛠️ 辅助调试工具：配置路径时怕填错？插件提供了“媒体库获取测试”功能，一键就能在日志中列出所有媒体库的准确路径和名称，让你在配置时信心满满。
• 📜 完善的日志管理：支持按计划自动清理日志，也可随时手动清理，确保插件持久稳定运行。

🚀开启你的智能调度之旅

安装和配置过程非常简单，只需几步即可完成。

第一阶段：安装插件

1. 进入 MP 的插件市场，选择添加第三方插件仓库。
2. 在地址栏中，准确输入以下地址进行添加：

   https://github.com/EWEDLCM/MP官方全称-Plugins/
   

3. 添加成功后，返回插件市场，此时应该能找到“飞牛影视调度器”。
4. 点击安装。

第二阶段：核心配置

1. 在插件市场中找到已安装的插件，点击进入配置页面。

2. 在 【基础设置】 标签页中，勾选 “启用插件”。

3. 配置扫描规则 (核心步骤)：

   • 这是插件工作的最关键一步。你需要定义 MP 的出库路径与飞牛媒体库的对应关系。
   • 格式为：整理后路径#媒体库名称#模式
   • 模式可选：本地、网盘。但强烈建议直接开启下文提到的“精确扫描”功能，此时该模式选项会自动失效，由插件采用最优逻辑。
   • 示例：
     • /vol1/1000/media/电视剧#电视剧#本地
     • /vol02-12345/媒体/movies#电影#网盘

4. 开启精确扫描 (强烈推荐)：

   • 切换到 【高级】 标签页。
   • 勾选 “精确扫描” 开关。这将无视你在规则中设置的“本地”或“网盘”模式，统一采用最高效的文件夹扫描方式，大幅提升入库速度。
   • 你还可以按需开启 “通知” 功能，当扫描失败时，插件会通过你选择的渠道发送提醒。参考下图！

⚠️ 重要前提：保持路径映射一致

要让插件精准识别路径，你必须确保 MP 用于访问媒体文件的Docker容器路径，与飞牛媒体库设置中的路径 完全一致。

例如，在你的 docker-compose.yml 文件中：

volumes:
  - '/vol2/1000/download:/vol2/1000/download'

这种是插件正常工作的基础。

❓ 常见问题解答 (FAQ)

Q1: 插件启用了，但文件转移后为什么没有触发扫描？
A: 请优先检查以下几点：

1. 扫描规则：确认规则已正确配置，特别是 路径 和 媒体库名称 是否与你的实际情况完全一致。
2. 路径映射：这是最常见的问题。请确认 MP 的Docker路径映射与飞牛媒体库路径完全一致。
3. 日志检查：查看插件日志，通常会有明确的错误提示。
4. 功能测试：使用配置页 【维护】 标签下的“媒体库获取测试”功能，检查插件能否成功读取到你的媒体库信息。

Q2: 我应该使用“网盘”模式还是“精确扫描”？
A: 强烈推荐直接开启“精确扫描”。它是最新、最高效的模式，无论你的存储是本地还是网盘，它都能提供最佳的扫描速度和成功率。

Q3: 如果忘记媒体库的准确名称或路径怎么办？
A: 使用 【维护】 标签下的“媒体库获取测试”功能。勾选并保存后，插件会立即在日志中打印出所有飞牛服务器的媒体库详细信息（包括ID、名称、路径），方便你复制粘贴。

总结

飞牛影视调度器 (Fnmvscheduler) 并没有试图重新发明造轮子，而是作为连接 MP 和飞牛之间的一座桥梁。它精准地解决了云盘用户在媒体库自动化更新流程中的核心痛点，让飞牛在云端存储场景下的体验也能如本地一般流畅。

该项目原本只是为了解决我自己的实际需求，但最近看到许多用户都在苦恼这方面的问题，还是放出来给大家尝尝鲜。如果你正是一位被网盘扫描问题困扰的飞牛用户，同时又是MP玩家，那么可以尝试一下。目前已经稳定运行半年有余。

重要声明

本文并非对MP项目进行推广，仅分享个人制作的插件项目，各位看官也请遵守官方要求，不要在评论区提及项目全称，如有需要，请自行搜索。