2.4 KiB
2.4 KiB
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。