MoviePilot官方插件市场：https://github.com/jxxghp/MoviePilot-Plugins
请不要开发用于破解MoviePilot用户认证、色情、赌博等违法违规内容的插件，共同维护健康的开发环境！
- 插件仓库需要保持与本项目一致的目录结构（建议fork后修改），仅支持Github仓库，
plugins存放插件代码，一个插件一个子目录，子目录名必须为插件类名的小写，插件主类在__init__.py中编写。 package.json为插件仓库中所有插件概要信息，用于在MoviePilot的插件市场显示，其中版本号等需与插件代码保持一致，通过修改版本号可触发MoviePilot显示插件更新。
- 插件图标可复用官方插件库中
icons下已有图标，否则需使用完整的http格式的url图片链接（包括package.json中的icon和插件代码中的plugin_icon）。 - 插件的背景颜色会自动提取使用图标的主色调。
- 插件命名请勿与官方库插件中的插件冲突，否则会在MoviePilot版本升级时被官方插件覆盖。
- 可在插件目录中放置
requirement.txt文件，用于指定插件依赖的第三方库，MoviePilot会在插件安装时自动安装依赖库。
- 插件支持
插件配置及详情展示两个展示页面，通过配置化的方式组装，使用 Vuetify 组件库，所有该组件库有的组件都可以通过Json配置使用。
-
注册
NoticeMessage事件响应，event_data包含消息中的所有数据，参考IYUU消息通知插件：注册事件：
@eventmanager.register(EventType.NoticeMessage) -
事件对象：
{ "channel": MessageChannel|None, "type": NotificationType|None, "title": str, "text": str, "image": str, "userid": str|int, }
PS：MoviePilot中的其它事件也是同样方法实现响应：
class EventType(Enum):
# 插件需要重载
PluginReload = "plugin.reload"
# 插件动作
PluginAction = "plugin.action"
# 执行命令
CommandExcute = "command.excute"
# 站点已删除
SiteDeleted = "site.deleted"
# 站点已更新
SiteUpdated = "site.updated"
# 转移完成
TransferComplete = "transfer.complete"
# 下载已添加
DownloadAdded = "download.added"
# 删除历史记录
HistoryDeleted = "history.deleted"
# 删除下载源文件
DownloadFileDeleted = "downloadfile.deleted"
# 收到用户外来消息
UserMessage = "user.message"
# 收到Webhook消息
WebhookMessage = "webhook.message"
# 发送消息通知
NoticeMessage = "notice.message"
# 名称识别请求
NameRecognize = "name.recognize"
# 名称识别结果
NameRecognizeResult = "name.recognize.result"
# 订阅已添加
SubscribeAdded = "subscribe.added"
# 订阅已完成
SubscribeComplete = "subscribe.complete"-
实现
get_command()方法，按以下格式返回命令列表：[{ "cmd": "/douban_sync", // 动作ID，必须以/开始 "event": EventType.PluginAction,// 事件类型，固定值 "desc": "命令名称", "category": "命令菜单（微信）", "data": { "action": "douban_sync" // 动作标识 } }] -
注册
PluginAction事件响应，根据event_data.action是否为插件设定的动作标识来判断是否为本插件事件：注册事件：
@eventmanager.register(EventType.PluginAction)事件判定：
event_data = event.event_data if not event_data or event_data.get("action") != "douban_sync": return
-
实现
get_api()方法，按以下格式返回API列表：[{ "path": "/refresh_by_domain", // API路径，必须以/开始 "endpoint": self.refresh_by_domain, // API响应方法 "methods": ["GET"], // 请求方式：GET/POST/PUT/DELETE "summary": "刷新站点数据", // API名称 "description": "刷新对应域名的站点数据", // API描述 }] -
在对应的方法中实现API响应方法逻辑，通过
http://localhost:3001/docs查看API文档和调试
- 注册公共定时服务后，可以在
设定-服务中查看运行状态和手动启动，更加便捷。 - 实现
get_service()方法，按以下格式返回服务注册信息：[{ "id": "服务ID", // 不能与其它服务ID重复 "name": "服务名称", // 显示在服务列表中的名称 "trigger": "触发器：cron/interval/date/CronTrigger.from_crontab()", "func": self.xxx, // 服务方法 "kwargs": {} // 定时器参数，参考APScheduler }]
-
注册
NameRecognize事件，实现识别逻辑（参考ChatGPT插件），注意：只有主程序无法识别时才会触发该事件@eventmanager.register(EventType.NameRecognize) -
完成识别后发送
NameRecognizeResult事件，将识别结果注入主程序eventmanager.send_event( EventType.NameRecognizeResult, { 'title': title, # 原传入标题 'name': str, # 识别的名称 'year': str, # 识别的年份 'season': int, # 识别的季号 'episode': int, # 识别的集号 } )
-
注意：识别请求需要在15秒内响应，否则结果会被丢弃；插件未启用或参数不完整时应立即回复空结果事件，避免主程序等待； 多个插件开启识别功能时，以先收到的识别结果事件为准。
eventmanager.send_event( EventType.NameRecognizeResult, { 'title': title # 结果只含原标题，代表空识别结果事件 } )
-
通过调用
SitesHelper().add_indexer(domain: str, indexer: dict)方法，新增或修改内建索引器的支持范围，其中indexer为站点配置Json，格式示例如下：示例一：
{ "id": "nyaa", "name": "Nyaa", "domain": "https://nyaa.si/", "encoding": "UTF-8", "public": true, "proxy": true, "result_num": 100, "timeout": 30, "search": { "paths": [ { "path": "?f=0&c=0_0&q={keyword}", "method": "get" } ] }, "browse": { "path": "?p={page}", "start": 1 }, "torrents": { "list": { "selector": "table.torrent-list > tbody > tr" }, "fields": { "id": { "selector": "a[href*=\"/view/\"]", "attribute": "href", "filters": [ { "name": "re_search", "args": [ "\\d+", 0 ] } ] }, "title": { "selector": "td:nth-child(2) > a" }, "details": { "selector": "td:nth-child(2) > a", "attribute": "href" }, "download": { "selector": "td:nth-child(3) > a[href*=\"/download/\"]", "attribute": "href" }, "date_added": { "selector": "td:nth-child(5)" }, "size": { "selector": "td:nth-child(4)" }, "seeders": { "selector": "td:nth-child(6)" }, "leechers": { "selector": "td:nth-child(7)" }, "grabs": { "selector": "td:nth-child(8)" }, "downloadvolumefactor": { "case": { "*": 0 } }, "uploadvolumefactor": { "case": { "*": 1 } } } } }示例二：
{ "id": "xxx", "name": "站点名称", "domain": "https://www.xxx.com/", "ext_domains": [ "https://www.xxx1.com/", "https://www.xxx2.com/" ], "encoding": "UTF-8", "public": false, "search": { "paths": [ { "path": "torrents.php", "method": "get" } ], "params": { "search": "{keyword}", "search_area": 4 }, "batch": { "delimiter": " ", "space_replace": "_" } }, "category": { "movie": [ { "id": 401, "cat": "Movies", "desc": "Movies电影" }, { "id": 405, "cat": "Anime", "desc": "Animations动漫" }, { "id": 404, "cat": "Documentary", "desc": "Documentaries纪录片" } ], "tv": [ { "id": 402, "cat": "TV", "desc": "TV Series电视剧" }, { "id": 403, "cat": "TV", "desc": "TV Shows综艺" }, { "id": 404, "cat": "Documentary", "desc": "Documentaries纪录片" }, { "id": 405, "cat": "Anime", "desc": "Animations动漫" } ] }, "torrents": { "list": { "selector": "table.torrents > tr:has(\"table.torrentname\")" }, "fields": { "id": { "selector": "a[href*=\"details.php?id=\"]", "attribute": "href", "filters": [ { "name": "re_search", "args": [ "\\d+", 0 ] } ] }, "title_default": { "selector": "a[href*=\"details.php?id=\"]" }, "title_optional": { "optional": true, "selector": "a[title][href*=\"details.php?id=\"]", "attribute": "title" }, "title": { "text": "{% if fields['title_optional'] %}{{ fields['title_optional'] }}{% else %}{{ fields['title_default'] }}{% endif %}" }, "details": { "selector": "a[href*=\"details.php?id=\"]", "attribute": "href" }, "download": { "selector": "a[href*=\"download.php?id=\"]", "attribute": "href" }, "imdbid": { "selector": "div.imdb_100 > a", "attribute": "href", "filters": [ { "name": "re_search", "args": [ "tt\\d+", 0 ] } ] }, "date_elapsed": { "selector": "td:nth-child(4) > span", "optional": true }, "date_added": { "selector": "td:nth-child(4) > span", "attribute": "title", "optional": true }, "size": { "selector": "td:nth-child(5)" }, "seeders": { "selector": "td:nth-child(6)" }, "leechers": { "selector": "td:nth-child(7)" }, "grabs": { "selector": "td:nth-child(8)" }, "downloadvolumefactor": { "case": { "img.pro_free": 0, "img.pro_free2up": 0, "img.pro_50pctdown": 0.5, "img.pro_50pctdown2up": 0.5, "img.pro_30pctdown": 0.3, "*": 1 } }, "uploadvolumefactor": { "case": { "img.pro_50pctdown2up": 2, "img.pro_free2up": 2, "img.pro_2up": 2, "*": 1 } }, "description": { "selector": "td:nth-child(2) > table > tr > td.embedded > span[style]", "contents": -1 }, "labels": { "selector": "td:nth-child(2) > table > tr > td.embedded > span.tags" } } } } -
需要注意的是，如果你没有完成用户认证，通过插件配置进去的索引站点也是无法正常使用的。
-
请不要添加对黄赌毒站点的支持，否则随时封闭接口。