astrbot_plugin_moviepilot/docs/remaining-development-queue.md
2026-07-22 22:59:03 +08:00

6.8 KiB

AstrBot × MoviePilot 剩余开发队列

当前基线:v0.13.0

本文只记录尚未完成、需要补强或尚未完成实机验证的工作。已完成能力以当前代码和版本记录为准。

总体开发顺序

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 测试

验收

/mp subscribe 1
→ 返回确认码,不创建订阅

/mp confirm <确认码>
→ 创建订阅并自动触发一次搜索

/mp sub-search <订阅ID>
→ MoviePilot 收到一次订阅搜索请求

/mp unsubscribe <订阅ID>
→ 返回确认码
/mp confirm <确认码>
→ 订阅被删除

v0.15.0:资源结果与搜索体验

目标

让资源搜索结果足够清晰、可比较、可直接选择下载。

任务

  • 优化资源结果展示:编号、名称、站点、分辨率、质量、大小、做种数、发布时间、免费状态
  • 兼容 MoviePilot 不同版本的资源字段名
  • 明确资源编号与 MoviePilot 下载参数的映射
  • 显示资源缺少下载链接、GUID、种子 ID 等关键字段时的原因
  • 增加资源排序和筛选参数
  • 支持按站点、分辨率、质量、大小筛选
  • 支持分页或限制结果数量
  • 研究并接入 MoviePilot 流式资源搜索接口
  • 搜索时间较长时发送“正在搜索资源”提示
  • 无资源时给出直接订阅建议
  • 增加真实资源字段的回归样本

验收

/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 配置示例和排障文档

验收

至少完成以下真实操作:

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 工具调用测试和确认流程测试

验收

搜索《某影视》,看看有没有 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. 完成对应的真实命令验收