docs(tasks): add T-575 AI generation progress feedback

This commit is contained in:
chengma
2026-07-09 16:40:50 +08:00
parent aac5c5d177
commit 87648e89d5
+74
View File
@@ -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 大列表。
## 执行记录
(做完在这里写:改了什么文件、跑了什么验证命令及结果、关键决策。)