AstrBot plugin for controlling MoviePilot via commands and LLM tools
查找文件
2026-07-20 23:32:48 +08:00
docs docs: finalize integration and test report 2026-07-20 22:34:05 +08:00
tests feat: improve media search result presentation 2026-07-20 23:32:48 +08:00
.gitignore feat: add MoviePilot plugin skeleton 2026-07-20 22:13:45 +08:00
_conf_schema.json feat: add notification polling and push targets 2026-07-20 22:28:19 +08:00
access_policy.py feat: add cross-platform target abstraction 2026-07-20 22:29:17 +08:00
confirmation.py feat: add session context and confirmations 2026-07-20 22:19:04 +08:00
download_service.py fix: support AstrBot package plugin imports 2026-07-20 22:54:31 +08:00
main.py feat: improve media search result presentation 2026-07-20 23:32:48 +08:00
media_service.py feat: improve media search result presentation 2026-07-20 23:32:48 +08:00
metadata.yaml feat: improve media search result presentation 2026-07-20 23:32:48 +08:00
moviepilot_client.py fix: authenticate MoviePilot REST requests with token query 2026-07-20 23:19:31 +08:00
notification_service.py fix: support AstrBot package plugin imports 2026-07-20 22:54:31 +08:00
platform_compat.py fix: support AstrBot package plugin imports 2026-07-20 22:54:31 +08:00
README.md docs: finalize integration and test report 2026-07-20 22:34:05 +08:00
requirements.txt feat: add MoviePilot plugin skeleton 2026-07-20 22:13:45 +08:00
session_context.py feat: add session context and confirmations 2026-07-20 22:19:04 +08:00
subscription_service.py fix: support AstrBot package plugin imports 2026-07-20 22:54:31 +08:00

AstrBot MoviePilot 插件

在 AstrBot 内通过命令和 LLM 控制 MoviePilot。

当前状态

核心功能已按开发队列完成到 v0.11.0,包括媒体/资源搜索、订阅、立即下载、下载任务控制、固定目标通知和 LLM Tool。

安装开发版本

将本目录放到 AstrBot 的 data/plugins/astrbot_plugin_moviepilot,启动 AstrBot 后在插件管理页面重载。

配置

在 AstrBot WebUI 的插件配置中填写:

  • MoviePilot 地址和 API Token;
  • 私聊用户白名单;
  • 群聊及群内用户白名单;
  • 固定推送群聊和个人账号;
  • 通知轮询间隔。

API Token 仅用于访问 MoviePilot,不要粘贴到聊天消息或提交到日志中。

命令

/mp help
/mp search <关键词>
/mp detail <媒体编号或媒体ID>
/mp seasons <媒体编号或媒体ID>
/mp resources <媒体编号>
/mp subscribe <媒体编号>
/mp download <资源编号>
/mp downloads
/mp download start <任务ID>
/mp download stop <任务ID>
/mp download delete <任务ID>
/mp subscriptions
/mp confirm <确认码>
/mp cancel

推荐使用链路:

/mp search 沙丘
/mp resources 2
/mp download 1
/mp confirm abc123

如果没有资源,可以直接:

/mp subscribe 2

订阅创建后插件会自动触发一次 MoviePilot 订阅搜索。

推送

通知轮询读取 MoviePilot 的 /api/v1/message/notification,默认首次启动不重放历史通知,后续按通知 ID 去重。推送目标由配置决定:

  • push_group_id:固定群聊。
  • push_private_user_id:固定个人账号。
  • push_platform_id:目标平台实例,默认 aiocqhttp,Telegram 可填写 telegram。

安全

  • 所有命令和 LLM Tool 都先经过平台、私聊用户、群聊和群内用户白名单检查。
  • 下载、删除订阅、删除下载任务等副作用操作需要确认。
  • 资源下载链接只传给 MoviePilot,默认不直接发送到聊天窗口。
  • Token 保存在 AstrBot 配置中,不应写入日志、截图或聊天记录。

开发与测试

python -m pytest tests -q
python -m py_compile main.py access_policy.py confirmation.py download_service.py media_service.py moviepilot_client.py notification_service.py platform_compat.py session_context.py subscription_service.py

完整设计和分阶段任务见 docs/research-2026-07-20.md 与 docs/development-queue.md。