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