diff --git a/README.md b/README.md index e5acad3..78a0704 100644 --- a/README.md +++ b/README.md @@ -53,3 +53,5 @@ python -m unittest discover -s tests ``` 详细部署步骤见 [docs/DEPLOYMENT.md](docs/DEPLOYMENT.md)。 + +后续增强计划见 [docs/ROADMAP.md](docs/ROADMAP.md)。 diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md new file mode 100644 index 0000000..ffef623 --- /dev/null +++ b/docs/ROADMAP.md @@ -0,0 +1,50 @@ +# 后续增强路线图 + +当前主链路已经完成: + +```text +JM ID -> jmcomic 下载 -> CBZ/PDF 归档 -> Komga 扫描 -> AstrBot 消息反馈 +``` + +以下增强不阻塞 MVP,可按实际使用反馈继续推进。 + +## S-17.1 批量下载 + +- 支持 `/jm batch 123 456 789` +- 支持一行一个 ID 的文本参数 +- 每个 ID 独立归档,最终汇总成功/失败列表 + +## S-17.2 任务状态与取消 + +- `/jm queue` 查看等待中和运行中的任务 +- `/jm cancel ` 取消尚未开始的任务 +- 运行中的 jmcomic 同步线程无法强杀,只标记后续阶段不再归档 + +## S-17.3 元数据增强 + +- 从 jmcomic 返回对象中提取作者、标签、页数、标题别名 +- 写入更完整的 `ComicInfo.xml` +- 可选生成 `series.json` 或导出一份归档索引 + +## S-17.4 Komga 健康检查 + +- `/jm komga` 检查 Komga 地址、认证、library ID 是否可用 +- 扫描失败时给出更明确的修复建议 + +## S-17.5 去重与重命名策略 + +- 按 JM ID 检查已有归档,避免标题变化导致重复入库 +- 支持归档文件模板,例如 `{id} - {title}.cbz` +- 支持迁移旧文件名到新模板 + +## S-17.6 权限与审计 + +- 分群/分会话白名单 +- 记录下载请求来源、操作者、归档路径 +- 支持仅管理员触发 Komga 扫描,普通用户只下载 + +## S-17.7 真实环境联调 + +- 在 AstrBot 实例内加载插件 +- 使用真实 jmcomic 下载一个小本子 +- 使用真实 Komga library 验证扫描入库