MoviePilot 将元数据、站点、下载器、文件存储、媒体服务器和通知渠道连接起来,完成影视与音乐管理。先区分各组件职责,更容易定位配置或故障应该改在哪里。
| 阶段 | 主要输入 | 输出与去向 |
|---|---|---|
| 识别与选片 | 名称、媒体来源、来源内 ID | 确定的电影、电视剧或音乐身份 |
| 搜索与订阅 | 媒体目标、站点、规则、库存 | 经过匹配和过滤的站点资源 |
| 下载 | 种子或下载链接、下载器配置 | 下载器中的任务与源文件 |
| 整理与刮削 | 源文件、目录策略、命名与覆盖设置 | 媒体库文件、元数据、封面等 |
| 扫描与播放 | 媒体服务器连接和目标目录 | 库存信息、展示与播放入口 |
| 自动化与交互 | 后台任务、工作流、消息、Agent | 组合操作、状态与通知 |
Web、iOS、消息机器人、CLI 与 MCP 是不同入口,核心业务仍由 MoviePilot 后端处理。客户端显示成功应结合下载器、整理历史和媒体服务器实际结果验收。
| 仓库 | 职责 | 不应混淆的边界 |
|---|---|---|
| MoviePilot | 后端运行时、订阅、搜索、下载、整理、API、Agent 与插件宿主 | 不维护 Vue 业务页面和官方插件源码 |
| MoviePilot-Frontend | Vue 业务界面、设置、插件 UI、模块联邦与容器适配 | 不复制后端认证与业务规则 |
| MoviePilot-App | iOS 原生导航、WKWebView、连接、通知与系统小组件 | 业务页面继续复用前端,不能代替后端服务 |
| MoviePilot-Plugins | 官方插件源码、市场索引、图标、插件文档与发布 | 插件运行与权限仍由主程序承载 |
| MoviePilot-Build | 从站点源码、认证配置和版本文件生成资源 | 不是用户日常安装的后端 |
| MoviePilot-Resources | 发布运行时消费的站点索引和认证资源 | 资源生成逻辑在 Build 仓库 |
| MoviePilot-Rust | 解析、过滤等性能加速扩展及 wheel 发布 | 主程序通过 moviepilot-rust 依赖使用,不是独立业务服务 |
| MoviePilot-Server | 共享、统计、公共能力和可选 App 消息中转 | 与用户自己的 MoviePilot 后端、数据库配置不同 |
| MoviePilot-OCR | 站点验证码识别 HTTP 服务 | 不负责站点登录状态和用户认证资格 |
| MoviePilot-Web | 官网介绍和展示 | 不是产品管理界面源码 |
| MoviePilot-Wiki | 安装、配置、使用、运维和开发导航 | 不代替各源码仓库的完整开发合同 |
resources.v3/ 安装到后端 app/application/site/,不能复制 V2 文件混用。遇到兼容问题,应记录 后端、前端、资源、相关插件或 App 的组合,而不是只报一个“最新版本”。版本切换见升级。
| 问题 | 首选落点 | 建议附带 |
|---|---|---|
| 订阅、识别、下载调度、整理和主程序 API | 主程序仓库 | 后端版本、脱敏日志、最小复现 |
| 页面交互、设置显示、网页与 PWA | 前端仓库 | 前后端版本、浏览器、宽度与截图 |
| 原生连接、导航、签名或小组件 | App 仓库 | App/iOS 版本、签名方式、兼容前端 |
| 某个插件行为 | 插件作者仓库 | 插件版本、主程序版本及该插件日志 |
| 某个站点适配 | 主程序或资源相关维护入口 | 站点类型、资源版本和合规脱敏样本 |
| OCR、私有消息中心自身故障 | OCR 或 Server 仓库 | 对应服务版本、调用状态与日志 |
| Wiki 过时、缺漏或链接错误 | Wiki 仓库 | 页面地址、错误内容和当前行为依据 |