From 87648e89d50c9e319bff3388017ded7f43ecfcb6 Mon Sep 17 00:00:00 2001
From: chengma <chengma2027@gmail.com>
Date: Thu, 9 Jul 2026 16:40:50 +0800
Subject: [PATCH] docs(tasks): add T-575 AI generation progress feedback

---
 docs/tasks/T-575.md | 74 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 74 insertions(+)
 create mode 100644 docs/tasks/T-575.md

diff --git a/docs/tasks/T-575.md b/docs/tasks/T-575.md
new file mode 100644
index 0000000..00b8554
--- /dev/null
+++ b/docs/tasks/T-575.md
@@ -0,0 +1,74 @@
+---
+id: T-575
+title: ②AI生成图片失败红色进度段与完成汇总弹窗
+phase: 7
+deps: [T-574]
+status: TODO
+created: 2026-07-09
+---
+
+## 问题 / 背景
+
+②AI生成模块中，图片生成进度条当前主要按成功数量推进。例如本轮需要生成 13 张图片，其中 11 张成功、2 张失败，结束后进度条会显示大部分绿色、剩余部分白色/空白。
+
+从用户视角看，这个表现容易误解：
+
+- 白色区域像是“还有任务没处理完”，但实际是已经处理完且失败。
+- 失败任务没有在进度条上形成直观的红色反馈，用户需要看日志或失败数字才知道失败占比。
+- 一批生成结束后，只有底部状态和日志，缺少一次清晰中文汇总提示。
+
+## 方案
+
+- `app/gui/tabs/generate.py`
+  - 为②AI生成页增加一个轻量分段进度条控件，至少支持：
+    - 绿色：成功数量。
+    - 红色：失败数量。
+    - 灰白/空白：未处理、停止后未执行或尚未完成数量。
+  - 图片进度条改用分段进度条。
+  - 统计口径：
+    - `cover_done` 表示图片成功数。
+    - `failed` 中包含本轮标题/图片失败总数；为了第一版范围可控，图片进度条的红色失败段先使用“本轮失败数中可归入图片处理的数量”或在 GUI 侧保守用 `min(failed, cover_total - cover_done)`。
+    - 完整结束时，已处理部分应显示为绿色 + 红色，剩余未执行才保留空白。
+  - 本轮生成 `finished` / `cancelled` 后弹一次中文汇总框：
+    - 全成功用信息提示。
+    - 有失败或停止用警告提示。
+    - 汇总标题和图片各自成功/总数、失败数、用时秒数。
+  - 弹窗只做汇总，不塞完整商品 ID 清单；失败明细继续看滚动日志。
+
+## 文案建议
+
+- 全成功：
+  - 标题：`AI生成完成`
+  - 正文：`本轮AI生成完成：标题 13/13，图片 13/13，失败 0，用时 126 秒。`
+- 有失败：
+  - 标题：`AI生成完成，有失败任务`
+  - 正文：`本轮AI生成完成：标题 13/13，图片 11/13，失败 2，用时 492 秒。失败明细请查看下方运行日志，可稍后重新生成失败任务。`
+- 停止：
+  - 标题：`AI生成已停止`
+  - 正文：`本轮AI生成已停止：标题 8/13，图片 5/13，失败 1，用时 180 秒。未完成任务可再次点击开始生成继续处理。`
+
+## 验收要点
+
+- 本轮图片 13 张、成功 11、失败 2 时，图片进度条结束后显示 11 份绿色 + 2 份红色，不再留下误导性的白色失败区域。
+- 运行中未完成部分仍可显示为空白/灰白。
+- 本轮生成完成后只弹一次中文汇总框。
+- 全成功、部分失败、用户停止分别使用合适标题和提示级别。
+- 滚动日志仍保留失败明细，弹窗不展示敏感信息、不展示完整接口路径或 token。
+- 不影响标题进度条、用时秒数、cmhub余额显示和现有运行日志。
+- 验证命令：
+  - `py -3.10 -m unittest tests.test_gui`
+  - `python -m ruff check app tests main.py`
+  - `py -3.10 -m compileall app main.py`
+  - `py -3.10 -m unittest discover -s tests`
+  - `git diff --check`
+
+## 边界（不改什么）
+
+- 不改 AI/cmhub 请求协议、并发、重试、下载保存逻辑。
+- 不改 DB schema。
+- 不改任务筛选、重置生成、封面画廊、Excel 或③更新蝦皮流程。
+- 第一版不做逐商品失败弹窗，不做失败商品 ID 大列表。
+
+## 执行记录
+
+（做完在这里写：改了什么文件、跑了什么验证命令及结果、关键决策。）