# 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,不要粘贴到聊天消息或提交到日志中。 ## 命令 ```text /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 ``` 推荐使用链路: ```text /mp search 沙丘 /mp resources 2 /mp download 1 /mp confirm abc123 ``` 如果没有资源,可以直接: ```text /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 配置中,不应写入日志、截图或聊天记录。 ## 开发与测试 ```bash 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`。