--- id: T-689 title: 商品套图已完成历史任务不阻断原图删除 phase: 7 deps: [T-631, T-658b] status: TODO created: 2026-07-22 --- ## 问题 / 背景 商品套图第一轮全部生成成功后，用户需要移除一张商品原图、调整参考素材并开始第二轮生成。当前 `remove_original_assets_if_unused()` 只要发现任意 `image_studio_jobs.source_asset_id` 指向该原图，就一律阻断删除，不区分任务是否已经结束。因此第一轮已成功且不可重试的历史 job 仍会错误提示“选中的图片正在被生成任务或终选引用，不能移除”。 此外，T-658b 已把参考图保存为 `reference_asset_ids` JSON 快照，但现有引用计数只统计 `source_asset_id`、`output_asset_id` 和终选表，未检查参考图快照。若直接放宽所有 job 引用，会造成仍在执行或可恢复的任务读取到已删除参考图，违反任务快照和 fail-fast 规则。 ## 方案 ### 1. 按可执行性而非历史存在性判定阻断 - 为“从商品原图列表删除”提供专用的引用判定 helper；不直接放宽通用 `asset_reference_counts()` 或非原图的删除语义。 - 对每个待删原图同时检查： - 当前 `image_studio_selections` 终选直接引用； - job 的 `source_asset_id`； - job 的 `reference_asset_ids` 有序 JSON 快照。 - 以下情形必须阻断整批删除： - job 状态为 `pending`、`submitted`、`running`； - job 为 `failed`、`expired`、`cancelled` 且 `recovery_action` 为 `resume` 或 `regenerate`，仍可继续查询或重试； - 原图被当前终选直接引用； - 参考图快照格式无效，无法可靠判定引用关系。 - `succeeded` 且 `recovery_action=none` 的 job 仅属于不可重试的历史记录，不得阻断删除。其他终态且 `recovery_action=none` 同样按已放弃历史处理。 - 批量删除保持全有或全无：任一图片有阻断原因时，全部不删，并向 GUI 返回中文、可行动的原因，例如“所选原图仍被可继续处理的生成任务引用，请先完成、停止或放弃该任务”。 ### 2. 删除后的历史兼容 - 允许删除已完成历史 job 的原图资产行。既有 SQLite 外键会将 job 的 `source_asset_id` 和生成图的 `parent_asset_id` 置为 `NULL`；历史 job 的提示词、状态、扣点、生成结果和生成轮次仍保留，历史生成列表和已生成图片不得丢失。 - 对已完成 job 的 `reference_asset_ids` 保持原快照文本，不尝试重写、猜测替代图片或改变历史 prompt；该 job 不可重试，因此不再依赖当前原图资产。 - 原图本地文件继续保留，不删除蝦皮线上图片；用户重新拉取蝦皮原图时，线上仍存在的图片可重新进入原图列表。 ### 3. GUI 反馈与第二轮生成 - 第一轮所有任务已成功结束后，删除未被终选直接引用的原图应正常通过，删除成功后重排 `source_order`，用户可立即以新顺序开始第二轮生成。 - 若第一轮存在运行中、远端已提交未完成、失败可重试或可恢复任务，维持删除阻断；提示应说明是“可继续处理的生成任务”而非笼统的“正在生成”。 - 已完成的生成结果、历史生成弹窗、终选和导出继续按原轮次读取；下一轮 job 只使用删除后的当前原图列表，并保持 T-658b 的输入快照冻结规则。 ### 4. 服务与兼容边界 - 继续复用 `remove_original_assets_if_unused()` 作为 GUI 的唯一原图删除入口，在内部改用专用阻断判定；单张、勾选批量、键盘、右键和悬停删除必须一致。 - 保持项目归属、资产类型、下载中、拉取中、生成中和事务重排校验；不允许通过 GUI 直接删除数据库行。 - 不新增 SQLite schema，不删除 job、生成结果、终选记录或本地文件，不修改 cmhub 提交、轮询、下载、计费、Shopee CDP 和①至⑤模块。 ## 验收要点 - 第一轮全部 `succeeded/recovery_action=none` 后，删除作为主图或参考图使用过、但未被终选直接引用的商品原图成功；剩余 `source_order` 连续，第二轮使用新顺序。 - `pending/submitted/running` job 的源图和参考图删除均被阻断。 - `failed/expired/cancelled` 且可 `resume/regenerate` 的源图和参考图删除均被阻断。 - 已完成历史 job 不再误拦截；历史轮次、生成结果、提示词、扣点和已选生成图片仍可查看，历史 job 的源图显示缺失时不影响查看生成结果。 - 任意被终选直接引用的原图仍被阻断；混合选择“可删 + 不可删”时不发生部分删除。 - 无效 `reference_asset_ids` 快照走保守阻断并显示中文错误，不得静默放行。 - 自动验证： - `py -3.10 -m unittest tests.test_image_studio tests.test_product_suite tests.test_product_suite_gui` - `py -3.10 -m unittest discover -s tests` - `py -3.10 -m ruff check app tests main.py` - `py -3.10 -m compileall app main.py` - `git diff --check` ## 执行记录 - 待实施。