83 行
2.4 KiB
Markdown
83 行
2.4 KiB
Markdown
# 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`。
|