基础下载订阅流程

最后更新:2025-12-23
核心逻辑解读(由Gemini生成)

1. 任务发起的两种方式

  • 立即下载(手动控制):用户通过搜索直接选择特定种子,指令直接下发。这适用于“我想立刻看到某部片子”的场景。

  • 订阅列表(自动监控):MoviePilot 将需求存入列表,由定时任务在后台不断检索。只有当找到符合用户设置的“优先级规则”(如:4K、特定字幕组等)的种子时,才会触发下载。

2. 精确的指令下发

  • 路径预设:MP 在推送种子给 qBittorrent (QB) 时,会明确告知 QB:“请将文件下载到 /media/download”。

  • 路径一致性:这要求两个容器对物理硬盘的称呼必须一致。如果 MP 说存到 A,但 QB 只有 B 目录,下载就会报错或文件“失踪”。

3. 存储核心:硬连接 (Hardlink) 的奥秘

这是图中最重要的部分,解释了数据实体与文件夹之间的关系:

  • 物理数据实体:硬盘上真实的 0 和 1 数据只有一份。

  • 一物二用

    • 在下载目录中:文件保持原始名称和结构,供 QB 读取数据进行持续做种

    • 在整理目录中:文件被 MP 重新命名(如:电影名.年份.mkv)并分类,供 Emby/Plex 刮削识别。

4. 为什么“必须硬连接”而“不能移动”?

这是原理图中 Note(备注) 部分的核心要义:

  • 做种的存亡:在 PT 站规则中,下载完成后必须保持上传(做种)。QB 必须在 /media/download 路径下实时读到文件才能上传。

  • 移动的代价:如果执行“移动”操作,文件从下载目录消失,QB 会立即报错“文件丢失”,导致做种停止。这不仅无法获取上传量,还可能导致账号因违规被封禁。

  • 硬连接的优势

    • 零空间占用:虽然两个目录下都能看到文件,但并不多占空间。

    • 秒级完成:整理过程瞬间完成,无需等待漫长的文件复制。

    • 互不干扰:你在整理目录里改名、移动,都不会影响下载目录里 QB 的做种。