T-659 更新蝦皮批次内容预检改为剔除跳过不中止整批

问题 / 背景

③「更新蝦皮」选定批次点「开始更新」时，若批次内有个别记录的新标题或新封面生成失败（内容为空），当前会弹窗「更新内容未生成」并中止整批更新——1~2 条失败记录拦下其余全部合格记录。

代码链路（app/gui/tabs/apply.py）：

_start_update()（:243）按当前筛选收集候选任务：_is_update_candidate_task()（:390）只看 stage == "generated" 且 status ∈ {success, pending, failed}，生成失败的记录也在候选内；
_update_content_error()（:584）按更新模式检查候选：模式含标题要求 new_title 非空、含封面要求 new_cover_path 非空，任何一条缺失即返回完整错误文案；
:256-260 预检非空 → QMessageBox.warning("更新内容未生成", ...) → return，一条都不执行。

该预检的原始意图是拦「更新模式选错」的整体性错误（如批次只生成了标题、用户却选了标题+封面），但没有区分「全部缺失（模式错）」与「个别缺失（个别生成失败）」。执行层 ApplyWorker 本身支持逐条跳过（汇总格式含「略过{skipped}」，:697），预检比执行器更严格，属于门槛过度。

需求定稿

预检从「一票中止」改为「剔除 + 知情确认」：

缺少本轮所需内容（按更新模式判定新标题/新封面）的记录，从本轮任务中剔除，不进 ApplyWorker；
确认弹窗（保留，符合 ③ 开始更新前弹窗确认的红线）中新增跳过说明：缺标题/缺封面的条数与示例商品ID，让用户知情后再确认；
仅当剔除后无任务可执行（整批缺失，大概率模式选错）时，保留现有「更新内容未生成」警告中止，并沿用回②生成或调整更新内容的引导文案；
被剔除记录的库内状态、stage、Excel 回写均不变——它们不算本轮失败也不算略过，修复（②补生成）后下轮自然重新入选。

实现方案

_update_content_error() 重构为返回结构化结果（如「可执行任务列表 + 缺标题列表 + 缺封面列表」），或新增并列函数；不再以「有缺失」为中止条件。
_start_update()：
- 剔除后可执行任务 > 0：把跳过统计并入 _confirmation_message()（新增行如「跳过 N 条缺少新标题（示例商品ID：…）」），確認后仅以可执行任务创建 ApplyWorker；
- 剔除后为 0：维持现「更新内容未生成」QMessageBox.warning 中止，文案不变；
「检查本轮更新」（dry_run）与正式更新走同一套剔除逻辑，两者展示一致的跳过说明。
状态栏摘要同步：本轮开始时记录「本轮 N 条，跳过 M 条（缺标题 x / 缺封面 y）」。
不修改 ApplyWorker、CDP 流程、批次/店铺筛选、Excel 回写和 _is_update_candidate_task() 的候选口径（failed 状态保留在候选中是为了重试上轮更新失败的记录，与本问题无关）。

验收标准

批次内 1~2 条缺新标题/新封面时，点「开始更新」不再中止：确认弹窗列出跳过条数与示例商品ID，确认后其余记录正常执行。
跳过的记录不进入本轮执行，也不被计为本轮失败或略过；其库内状态与 Excel 不受本轮影响。
整批全部缺失所需内容时，仍弹「更新内容未生成」警告并中止，引导文案与现版一致。
「检查本轮更新」（dry_run）与正式更新的剔除与提示行为一致。
更新模式为「只更新标题」时只按新标题剔除；「只更新封面」只按新封面剔除；「标题和封面」按两者分别统计并都剔除。
确认弹窗仍在执行前出现（③ 红线不变）；取消则不执行任何任务。
被跳过记录在②补生成后，下轮筛选自动重新入选并可正常更新。
CDP 执行、批次筛选、店铺筛选、停止/重置更新、Excel 回写行为不变。

测试要求

tests/test_gui.py（既有「更新内容未生成」用例所在文件）覆盖：部分缺标题、部分缺封面、两者混合、全部缺失中止、剔除后确认文案内容、dry_run 一致性、三种更新模式的剔除口径。
断言跳过记录未进入 worker 任务列表、状态与 stage 未被改动。
回归：无缺失时确认文案与现版一致（不出现跳过行）。

文档同步

实现时更新 docs/04-architecture.md 中 ③ 更新前置校验的描述（如有）；不修改冻结的 docs/06-tasks.md。

验证

py -3.10 -m unittest tests.test_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

非目标

不修改 ②AI生成的失败重试机制，不在③内触发补生成。
不修改 ApplyWorker 执行语义、并发、批次大小与账号就绪检查。
不改动「账号未就绪」中止逻辑（那是另一类整体性前置条件）。
不引入按记录勾选/排除的手动选择 UI。

执行记录

2026-07-17：ApplyTab 新增按更新模式划分可执行任务、缺少新标题任务和缺少新封面任务的预检；有可执行任务时只将其交给 ApplyWorker，缺失记录不改 SQLite、Excel 或运行状态。
2026-07-17：正式更新和「检查本轮更新」共用该预检；确认框显示跳过条数、缺失类型和示例商品ID，状态栏与本轮日志显示可执行/跳过摘要。全部任务都缺失时仍沿用「更新内容未生成」弹窗中止。
2026-07-17：补充三种更新模式的剔除口径、正式更新部分跳过和检查模式部分跳过回归测试；同步架构、API 和界面流程文档。
验证通过：py -3.10 -m unittest tests.test_gui（190 项）、py -3.10 -m unittest discover -s tests（591 项）、py -3.10 -m ruff check app tests main.py、py -3.10 -m compileall app main.py、git diff --check。离屏 GUI 测试有 Qt 字体/插件告警，但无测试失败。

6.2 KiB Raw Permalink Blame History Unescape Escape