From 7f07184e75dd84c9f0d498cc2f33b61622a1df1f Mon Sep 17 00:00:00 2001 From: Codex Date: Wed, 22 Jul 2026 22:59:03 +0800 Subject: [PATCH] docs: add remaining development queue --- docs/remaining-development-queue.md | 212 ++++++++++++++++++++++++++++ 1 file changed, 212 insertions(+) create mode 100644 docs/remaining-development-queue.md diff --git a/docs/remaining-development-queue.md b/docs/remaining-development-queue.md new file mode 100644 index 0000000..47c79c0 --- /dev/null +++ b/docs/remaining-development-queue.md @@ -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. 完成对应的真实命令验收 \ No newline at end of file