docs: add remaining development queue

这个提交存在于:
Codex 2026-07-22 22:59:03 +08:00
父节点 b86e2c4032
当前提交 7f07184e75

查看文件

@ -0,0 +1,212 @@
# 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. 完成对应的真实命令验收