212 行
无行尾
6.8 KiB
Markdown
212 行
无行尾
6.8 KiB
Markdown
# AstrBot × MoviePilot 剩余开发队列
|
||
|
||
> 当前基线:`v0.13.0`
|
||
>
|
||
> 本文只记录尚未完成、需要补强或尚未完成实机验证的工作。已完成能力以当前代码和版本记录为准。
|
||
|
||
## 总体开发顺序
|
||
|
||
```text
|
||
v0.14.0 订阅安全与管理
|
||
↓
|
||
v0.15.0 资源结果与资源搜索体验
|
||
↓
|
||
v0.16.0 通知查询与通知可靠性
|
||
↓
|
||
v0.17.0 Telegram 实机兼容
|
||
↓
|
||
v0.18.0 LLM 自然语言完整链路
|
||
↓
|
||
v0.19.0 稳定性、持久化与运维增强
|
||
```
|
||
|
||
## v0.14.0:订阅安全与管理
|
||
|
||
### 目标
|
||
补齐订阅生命周期,并统一所有会改变 MoviePilot 状态的操作确认机制。
|
||
|
||
### 任务
|
||
|
||
- [ ] `/mp subscribe <媒体编号>` 改为先创建确认请求,不直接创建订阅
|
||
- [ ] 订阅确认请求显示影视名称、TMDB 编号、类型、季信息
|
||
- [ ] 实现 `/mp sub-search <订阅ID>`,手动触发指定订阅搜索
|
||
- [ ] 实现 `/mp unsubscribe <订阅ID或媒体ID>`
|
||
- [ ] 删除订阅必须经过二次确认
|
||
- [ ] 增加订阅不存在、重复订阅、订阅删除失败等错误提示
|
||
- [ ] 在订阅列表中显示订阅状态、季、搜索策略和最近更新时间
|
||
- [ ] 为订阅管理增加单元测试和 Mock API 测试
|
||
|
||
### 验收
|
||
|
||
```text
|
||
/mp subscribe 1
|
||
→ 返回确认码,不创建订阅
|
||
|
||
/mp confirm <确认码>
|
||
→ 创建订阅并自动触发一次搜索
|
||
|
||
/mp sub-search <订阅ID>
|
||
→ MoviePilot 收到一次订阅搜索请求
|
||
|
||
/mp unsubscribe <订阅ID>
|
||
→ 返回确认码
|
||
/mp confirm <确认码>
|
||
→ 订阅被删除
|
||
```
|
||
|
||
## v0.15.0:资源结果与搜索体验
|
||
|
||
### 目标
|
||
让资源搜索结果足够清晰、可比较、可直接选择下载。
|
||
|
||
### 任务
|
||
|
||
- [ ] 优化资源结果展示:编号、名称、站点、分辨率、质量、大小、做种数、发布时间、免费状态
|
||
- [ ] 兼容 MoviePilot 不同版本的资源字段名
|
||
- [ ] 明确资源编号与 MoviePilot 下载参数的映射
|
||
- [ ] 显示资源缺少下载链接、GUID、种子 ID 等关键字段时的原因
|
||
- [ ] 增加资源排序和筛选参数
|
||
- [ ] 支持按站点、分辨率、质量、大小筛选
|
||
- [ ] 支持分页或限制结果数量
|
||
- [ ] 研究并接入 MoviePilot 流式资源搜索接口
|
||
- [ ] 搜索时间较长时发送“正在搜索资源”提示
|
||
- [ ] 无资源时给出直接订阅建议
|
||
- [ ] 增加真实资源字段的回归样本
|
||
|
||
### 验收
|
||
|
||
```text
|
||
/mp resources 1
|
||
→ 返回结构化资源列表
|
||
|
||
/mp download 2
|
||
→ 能准确选择第 2 条资源
|
||
→ 资源缺字段时给出可理解的错误
|
||
```
|
||
|
||
## v0.16.0:通知查询与可靠性
|
||
|
||
### 目标
|
||
补齐手动通知查询,并验证后台轮询在真实 MoviePilot 环境中的可靠性。
|
||
|
||
### 任务
|
||
|
||
- [ ] 实现 `/mp notifications`
|
||
- [ ] 支持按时间、类型或数量限制通知查询
|
||
- [ ] 优化下载完成、下载失败、订阅搜索失败通知格式
|
||
- [ ] 通知中包含影视名称、资源摘要、状态、时间
|
||
- [ ] 验证通知 ID、分页和游标在当前 MoviePilot 版本中的稳定性
|
||
- [ ] 验证 AstrBot 重启后不重复推送历史通知
|
||
- [ ] 验证 MoviePilot 暂时不可达时的退避和恢复
|
||
- [ ] 验证固定群聊推送
|
||
- [ ] 验证固定个人账号推送
|
||
- [ ] 推送失败时记录可诊断日志,但不泄露 API Token
|
||
|
||
### 验收
|
||
|
||
- 下载完成后固定目标收到一次通知
|
||
- 下载失败后固定目标收到一次通知
|
||
- 重启 AstrBot 不重复推送旧通知
|
||
- MoviePilot 短暂离线恢复后可以继续轮询
|
||
- `/mp notifications` 可以查询最近通知
|
||
|
||
## v0.17.0:Telegram 实机兼容
|
||
|
||
### 目标
|
||
完成 Telegram 平台的真实部署验证,而不只停留在平台抽象层。
|
||
|
||
### 任务
|
||
|
||
- [ ] 验证 Telegram 私聊用户白名单
|
||
- [ ] 验证 Telegram 群聊和群成员白名单
|
||
- [ ] 验证 Telegram 命令解析和参数传递
|
||
- [ ] 验证 Telegram 会话编号隔离
|
||
- [ ] 验证 Telegram 图片封面发送
|
||
- [ ] 验证 Telegram 固定群聊推送
|
||
- [ ] 验证 Telegram 固定个人账号推送
|
||
- [ ] 处理 Telegram 不支持或表现不同的消息组件
|
||
- [ ] 更新 Telegram 配置示例和排障文档
|
||
|
||
### 验收
|
||
|
||
至少完成以下真实操作:
|
||
|
||
```text
|
||
Telegram /mp search <影视名>
|
||
Telegram /mp resources 1
|
||
Telegram /mp subscribe 1
|
||
Telegram /mp confirm <确认码>
|
||
Telegram 接收下载通知
|
||
```
|
||
|
||
## v0.18.0:LLM 自然语言完整链路
|
||
|
||
### 目标
|
||
让 LLM 能够完成“搜索—展示—确认—订阅/下载”的完整流程,同时保留明确的命令控制。
|
||
|
||
### 任务
|
||
|
||
- [ ] 支持“搜索某影视并查看资源”的自然语言请求
|
||
- [ ] LLM 展示影视名称、TMDB 编号、上映年月、集数、评分和封面信息
|
||
- [ ] LLM 展示资源站点、质量、大小和可下载字段
|
||
- [ ] LLM 在执行下载或订阅前明确展示目标并创建确认请求
|
||
- [ ] LLM 不能绕过 `/mp confirm` 执行写操作
|
||
- [ ] 支持“选择第 N 个资源下载”
|
||
- [ ] 支持“没有资源就订阅”的建议流程
|
||
- [ ] 支持自然语言查询订阅、下载任务和通知
|
||
- [ ] 处理 LLM 选择编号过期、会话不一致和目标不明确
|
||
- [ ] 增加 LLM 工具调用测试和确认流程测试
|
||
|
||
### 验收
|
||
|
||
```text
|
||
搜索《某影视》,看看有没有 4K 资源
|
||
→ 返回影视信息和资源候选
|
||
|
||
把第 2 个资源下载下来
|
||
→ 展示资源详情并要求确认
|
||
|
||
确认
|
||
→ 创建 MoviePilot 下载任务
|
||
```
|
||
|
||
## v0.19.0:稳定性、持久化与运维增强
|
||
|
||
### 目标
|
||
提高长期运行能力,降低重启、升级和配置错误带来的影响。
|
||
|
||
### 任务
|
||
|
||
- [ ] 增加配置校验和启动时诊断信息
|
||
- [ ] `/mp test` 显示 URL、鉴权、接口版本等脱敏诊断结果
|
||
- [ ] 统一处理 MoviePilot 401、403、404、429、5xx 和超时错误
|
||
- [ ] 对资源搜索和通知轮询增加超时、重试和退避策略
|
||
- [ ] 会话缓存支持更清晰的过期提示
|
||
- [ ] 重启后保留必要的待确认操作或明确使其失效
|
||
- [ ] 增加操作日志摘要,不保存完整 Token 和站点凭据
|
||
- [ ] 增加 MoviePilot API 版本兼容层
|
||
- [ ] 完善安装、升级、回滚和备份文档
|
||
- [ ] 在真实 AstrBot 容器中加入导入检查和最小联调检查
|
||
|
||
## 已知但需要持续观察的事项
|
||
|
||
- [ ] MoviePilot 不同版本资源返回字段可能不同
|
||
- [ ] MoviePilot 的通知分页和通知 ID 稳定性需要持续验证
|
||
- [ ] 封面 URL 是否能被所有 OneBot 11 实现直接访问
|
||
- [ ] 部分 Telegram 适配器对混合文字/图片消息链的支持可能不同
|
||
- [ ] 资源搜索耗时取决于 MoviePilot 站点数量和站点响应速度
|
||
- [ ] 当前主链路已在 QQ 环境验证,Telegram 仍属于待实机验证范围
|
||
|
||
## 每个版本的交付规则
|
||
|
||
每个版本完成后必须:
|
||
|
||
1. 补充或更新单元测试
|
||
2. 执行 `python -m pytest tests -q`
|
||
3. 执行全部业务模块的 `py_compile`
|
||
4. 更新版本号和版本记录
|
||
5. 创建 Git tag
|
||
6. 推送到局域网 Forgejo
|
||
7. 部署到 NAS AstrBot 容器
|
||
8. 查看 AstrBot 插件加载日志
|
||
9. 完成对应的真实命令验收 |