feat: 完成T-403结果回写与汇总

新增excel.write_back_results，按原Excel文件、工作表和行号回写新标题、新封面图片路径与更新状态。

③更新完成后自动用WriteBackWorker(mode=results)回写结果，并弹窗汇总成功、失败、略过数量；文件被占用时提示关闭Excel后手动重试。

补充Excel结果回写、GUI自动回写/汇总/锁文件提示和模块契约测试，同步任务看板、API、流程和当前状态文档。

docs/api.md

@@ -88,7 +88,7 @@ SQLite 连接规则：
 - `connect()` 必须设置 `PRAGMA foreign_keys=ON`、`journal_mode=WAL`、`busy_timeout=5000`、`synchronous=NORMAL`。
 - DB 写入短事务、单条提交；Excel 回写失败不回滚 DB。
 
-## excel 模块（`app/excel.py`，导入与旧字段回写已建；结果回写待 T-403，依赖 openpyxl）
+## excel 模块（`app/excel.py`，导入与回写已建，依赖 openpyxl）
 
 ```python
 class ExcelError(RuntimeError): ...
@@ -121,9 +121,13 @@ write_back(batch_id, excel_path=None, path=None) -> dict
 # 只写 stage 已到 collected/generated/applied 或已有旧字段值的任务；无可写任务时返回 rows=0
 # 原文件被占用(锁) → 抛 ExcelError，调用方提示“请关闭后重试”，或改用 export_copy
 # -> {"ok": True, "batch_id": str, "files": int, "rows": int, "written_files": [abs_path, ...]}
+write_back_results(batch_id, excel_path=None, path=None) -> dict
+# 把【新标题/新封面图片路径/更新状态】批量回写到【原 Excel】
+# 更新状态：成功 / 失败：原因 / 略过：原因 / 待更新
+# 原文件被占用(锁) → 抛 ExcelError；SQLite 更新结果不回滚，GUI 提示关闭后重试
+# -> {"ok": True, "batch_id": str, "files": int, "rows": int, "written_files": [abs_path, ...]}
 export_copy(batch_id, out_dir_or_path, path=None) -> dict
 # 退路：另存带旧字段的副本，不动原文件；目录输出时生成 *_cmshopee回写.xlsx
-# T-403 会在此基础上扩展新标题/新封面/更新状态回写。
 ```
 
 列模板见 [架构 5.3](04-architecture.md)；别名以“别名”列为权威，必须与 ④ 账号管理中的账号别名一致。`shopee待处理任务模板.xlsx` 是可提交的标准空模板；运营填写后的 Excel 副本属于业务数据，不提交。
@@ -296,7 +300,7 @@ class ApplyTab(QWidget)                    # ③ 更新shopee：筛选已生成
 class CollectWorker(BaseWorker)            # ① 后台采集：账号就绪预检 -> editor.collect -> db.set_collected/mark_skipped/mark_failed
 class GenerateWorker(BaseWorker)           # ② 后台生成：ai.generate_batch -> db.set_generated/mark_failed + 进度
 class ApplyWorker(BaseWorker)              # ③ 后台更新：账号就绪预检 -> editor.apply_task -> db.set_applied/mark_skipped
-class WriteBackWorker(BaseWorker)          # ① 后台回写：excel.write_back(batch_id) 写旧标题/旧封面到原 Excel
+class WriteBackWorker(BaseWorker)          # ①/③ 后台回写：旧字段或更新结果写回原 Excel
 class TaskTableModel(QAbstractTableModel)  # 任务表格模型：账号/别名/商品ID/阶段；未匹配别名显示“略过”
 class GenerateTaskTableModel(QAbstractTableModel) # ② 任务表格模型：店铺/商品ID/旧标题/新标题/状态
 class ApplyTaskTableModel(QAbstractTableModel)    # ③ 任务表格模型：店铺/商品ID/新标题/新封面/阶段/结果
@@ -343,7 +347,7 @@ TAB_STYLE: str                              # 顶层 Tab 栏防误点样式：
 - 「停止」调用 worker 的协作式 `cancel()`；未开始的 Future 取消，不记失败；已完成的 `db.set_generated()` 结果保留，可再次开始生成剩余任务。
 - 进度标签显示：`标题x/n · 封面x/n · 失败z`；每条封面生成成功后立即 `db.set_generated()`，失败 `db.mark_failed(..., "generate", error)`，GUI 刷新任务表。
 
-③ 更新shopee当前要点（T-401/T-402）：
+③ 更新shopee当前要点（T-401/T-402/T-403）：
 
 - `ApplyTab` 顶部筛选栏包含：批次、店铺、状态、刷新。批次来自 `db.list_batches()`；店铺来自当前更新候选任务别名并优先显示匹配账号名。
 - ③ 只列出已具备新标题/新封面、可进入更新阶段的任务：`stage=generated/applied`，或已有新字段且 `status=failed/skipped` 的任务。
@@ -356,7 +360,8 @@ TAB_STYLE: str                              # 顶层 Tab 栏防误点样式：
 - 预检通过后逐条 `db.mark_running(..., "apply")` → `editor.apply_task(account, task)` → `db.set_applied()`；成功推进 `stage=applied/status=success/committed=1`，失败保持原 stage、`status=failed/committed=0/last_error`，单条失败继续下一条。
 - 别名未匹配账号的任务逐条 `db.mark_skipped()`，原因 `别名未匹配账号`；「停止」调用 worker 协作式 `cancel()`，已开始单条跑到安全边界后结束。
 - ③ 没有常驻提交开关；确认弹窗是提交线上前的边界。
-- 更新结果回写原 Excel 留给 T-403。
+- 更新完成后自动调用 `WriteBackWorker(mode="results")` → `excel.write_back_results()`，把新标题、新封面路径、更新状态写回原 Excel；原文件被占用时提示关闭后点击「回写结果到 Excel」手动重试，SQLite 更新结果不回滚。
+- 自动结果回写完成后弹窗汇总成功/失败/略过数量与 Excel 回写文件/行数；若没有可回写批次，也会弹出更新汇总。
 
 ## workers 模块（`app/workers.py`，已建，PySide6）
 
@@ -391,6 +396,7 @@ run_worker(worker: BaseWorker, thread_name=None, start=True) -> QThread
 - 每个 worker/线程按需创建自己的 SQLite connection，不跨线程共享连接。
 - ③ 的批量确认弹窗在 GUI 主线程完成；用户确认后才创建 `ApplyWorker`。
 - `ApplyWorker` 串行调用 `editor.apply_task()`，逐条 `set_applied()`，失败继续；账号未就绪时整体阻断并引导④，不进入逐条提交。
+- `WriteBackWorker` 默认 `mode="old"` 回写旧字段；③ 使用 `mode="results"` 回写新标题/新封面/更新状态，支持单批次或多批次列表。
 - `execute()` 未捕获异常会发 `failed(-1, error)` 与 `finished({"ok": False, "error": ...})`；普通单行失败由业务 worker 自己发 `failed(task_id, error)` 后继续处理。
 
 ## 启动入口