fix: clarify AI generation failure retry states

docs/troubleshooting.md

@@ -164,6 +164,51 @@ curl -i "https://<你的BaseURL>/api/v1/balance" -H "Authorization: Bearer sk_cm
 
 T-530 已实现：保存和请求前都会把 Base URL 规整为网关根，去掉多余路径、查询串和片段；HTTP 404 会映射为 `not_found`，显示“cmhub 接口不存在，请检查 Base URL 或该实例是否已部署 /api/v1/models”，不再透传 `notfound` 这类生涩原文。
 
+## ②AI生成提示“当前筛选结果没有可生成任务”
+
+### 现象
+
+在②AI生成模块选中某个批次，列表里看到多条“失败”记录，点击「开始生成」后，状态栏提示：
+
+```text
+当前筛选结果没有待生成或生成失败可重试任务；请先在①导入采集完成旧数据采集
+```
+
+旧版本可能提示：
+
+```text
+当前筛选结果没有可生成任务
+```
+
+### 原因
+
+②AI生成只能处理两类任务：
+
+- 已完成①采集的待生成任务：底层通常是 `stage=collected`。
+- AI 生成阶段失败、可以重试的任务：例如生成标题或生成封面失败。
+
+如果列表里的“失败”其实是①采集失败，任务还停在 `stage=imported/status=failed`，没有旧标题和旧封面，②无法直接生成。2026-07-06 的实测问题就是这种情况：本地最新批次 5 条任务都是 `stage=imported/status=failed/collect_attempts>0/generate_attempts=0`，属于采集失败，不是 AI 生成失败。
+
+如果失败来自③更新shopee，任务通常已有新标题/新封面，但这是更新阶段失败，也不应回到②自动重新生成。
+
+### 当前处理
+
+当前代码已把②AI生成列表的失败状态细分为：
+
+- `采集失败`：需要先回①重新采集旧标题/旧封面。
+- `生成失败`：可以在②当前筛选范围内再次点击「开始生成」重试。
+- `更新失败`：应去③更新shopee重试或重置更新状态，不会被②误当成生成任务。
+
+②「开始生成」使用统一的 `ai.is_generatable_task()` 判断可生成范围，GUI、Worker 和底层 `generate_batch()` 口径一致。
+
+### 推荐处理
+
+1. 如果②状态列显示“采集失败”：回到①导入采集，确认对应账号 Chrome 已启动且已登录，再重新采集旧标题/旧封面。
+2. 如果②状态列显示“生成失败”：留在②，确认 cmhub Base URL、API Key、别名和点数正常后，直接点击「开始生成」重试当前筛选结果。
+3. 如果②状态列显示“更新失败”：到③更新shopee处理；需要重复更新时使用③的重置更新状态入口，不要在②重新生成。
+
+排查时不要把 `cmshopee.db`、`config/cmhub.json`、`config/ai_models.json` 或任何 API Key、密码、Cookie 发到聊天、文档或提交里。
+
 ## AI生成：标题成功但图片生成失败，且看不到原因
 
 当前代码会为 ② AI生成写两层日志：