MoviePilot 官方插件仓库，也是默认插件市场的源码与索引仓库： https://github.com/jxxghp/MoviePilot-Plugins
当前开发目标是 MoviePilot V3。新插件开发者不需要先阅读 V2 文档，也不要在多份 “适配指南”之间自行拼接流程。
阅读 MoviePilot 插件开发指南（V3）。这是当前唯一的 完整主指南，覆盖目录、最小骨架、生命周期、稳定 SDK、配置与数据、页面、事件、 API、服务、测试和发布。
先阅读主指南，再查看 V2 插件迁移到 V3。迁移专题只讲旧导入兼容、 媒体身份、音乐链、数据迁移和 V3 合同差异，不再承担从零开发说明。
查看 仓库与发布指南，了解索引、版本选择、元数据、 CI、Release 和跨仓协作边界。
查看 常见问题。API 返回与前端调用另见 插件 API 专题。
V2 插件开发指南 仅作为历史版本参考。新插件和 V3 专用实现不要从该文档开始。
本仓库不是独立运行时：
MoviePilot负责插件加载、事件分发、API、服务、数据、工作流和 Agent 运行时。MoviePilot-Frontend负责配置页、详情页、仪表板和 Vue 联邦组件渲染。MoviePilot-Plugins负责插件源码、市场索引、图标、测试、文档和发布流程。
MoviePilot-Plugins/
├── plugins.v3/ # 当前 V3 专用插件，新插件放这里
├── tests/v3/ # V3 插件测试
├── package.v3.json # V3 插件市场索引
├── plugins.v2/ # V2 历史专用实现
├── package.v2.json # V2 历史索引
├── plugins/ # 更早或跨版本的存量实现
├── package.json # 默认历史索引
├── icons/ # 插件图标
├── docs/ # 开发、迁移、FAQ 和发布文档
└── .github/ # CI 与 Release 工作流
V3 新插件使用 plugins.v3/<plugin_id_lower>/、tests/v3/<plugin_id_lower>/ 和
package.v3.json。V3 对旧插件的回退加载只用于兼容存量实现，不是新插件继续写入
旧目录的理由。
- 插件目录名必须是插件主类名的小写形式，主类定义在目录的
__init__.py。 - 新增类和方法需要补充说明职责的注释。
plugin_version、索引version和最新history必须一致。- 当前版本历史置顶，所有历史按语义版本降序排列。
- V3 新代码优先使用
app.sdk；不要新增对宿主内部目录布局的无必要依赖。 - 插件运行数据写入插件数据目录，不要写回源码目录。
- 第三方依赖安装在宿主共享环境，不能降级或覆盖 MoviePilot 核心依赖。
- 测试放在仓库根
tests/v3/<plugin_id>/，不要放进插件源码目录。 - 提交前运行 Python 编译、版本门禁、相关测试和
git diff --check。
第三方仓库建议 fork 本项目并保留相同目录和索引结构。MoviePilot 插件市场只读取
GitHub 仓库的 main 分支；仓库地址通过 PLUGIN_MARKET 配置，多个地址用逗号
分隔。
请勿开发用于破解 MoviePilot 用户认证，或提供色情、赌博等违法违规内容的插件。