docs: 统一 V1 更新确认策略

2026-06-26 15:55:28 +08:00
parent 479d02a2b8
commit ccb4d52d9f
18 changed files with 127 additions and 104 deletions
@@ -51,8 +51,8 @@ imported  →  collected  →  generated  →  applied

 - **imported**：openpyxl 解析输入列入库。
 - **collected**：只读打开商品页，读旧标题、下载旧封面到本地，写 `old_title/old_cover_path`，回写 Excel 旧字段。
- **generated**：AI 用提示词+旧标题生成新标题；用提示词+旧封面生成新封面（image-to-image），新图存本地。**无人工确认环节**，生成完即可被 ③ 执行（新图留档本地 + 回写 Excel 供事后追溯）。
- **applied**：打开编辑页换标题+封面，**总是点「更新」提交线上**（无开关），回写结果。
+- **generated**：AI 用提示词+旧标题生成新标题；用提示词+旧封面生成新封面（image-to-image），新图存本地。**不设逐条人工审核阶段**，生成完即可进入 ③（新图留档本地 + 回写 Excel 供事后追溯）。
+- **applied**：③ 点击「开始更新」后弹窗确认当前筛选范围和任务数量；确认后打开编辑页换标题+封面，逐条点「更新」提交线上，回写结果。

 任意阶段失败 → `stage` 不前进、记 `error`、`result/skipped`，不影响其他任务。

@@ -62,7 +62,7 @@ imported  →  collected  →  generated  →  applied

 **核心模块**

- `appconfig`：读写 `config.json`（Chrome 路径、`chrome_user_data_dir` 根、图片目录、AI 配置、端口、DB 路径、默认是否提交）。
+- `appconfig`：读写 `config.json`（Chrome 路径、`chrome_user_data_dir` 根、图片目录、AI 配置、端口、DB 路径）。
 - `db`：SQLite 读写账号、任务、各阶段结果；建表/迁移。
 - `excel`：openpyxl 读输入列、把输出列回写原 Excel（处理文件锁）。
 - `config`：账号 ↔ user-data-dir 绑定；slug；目录创建。
@@ -195,8 +195,8 @@ CREATE TABLE tasks (
 - `alias` 是账号↔任务**唯一关联键**；找不到账号 → stage=skipped，error=别名未匹配，最后弹窗汇总。
 - `account_name` 仅展示/参考；匹配以 `alias` 为准。
 - `old_title/old_cover_path`：程序**采集阶段抓取**的快照（输出）。
- `new_title/new_cover_path`：**AI 生成**结果（输出），图片落本地，**无人工确认**，生成即可应用。
- `committed`：③ 执行时**总是点「更新」提交**；该字段记录提交是否成功。
+- `new_title/new_cover_path`：**AI 生成**结果（输出），图片落本地；不设逐条确认阶段，生成即可进入 ③。
+- `committed`：③ 用户确认批量更新弹窗后逐条点「更新」提交；该字段记录提交是否成功。
 - 各字段**每阶段处理完立即写回 SQLite**（实时落库）；阶段结束后批量回写 Excel。

 ### 5.3 Excel 模板
@@ -244,7 +244,7 @@ images/<slug>/<item_id>_new.<ext>    # AI 生成的新封面
 - 每条/每张完成**立即 `set_generated` 写库**（实时落库，停止或崩溃不丢已生成的）。
 - **「停止」**：取消未开始的任务，正在跑的少量完成或中断；停止后可再次「开始生成」对剩余继续。
 - 进度：`标题 x/n · 封面 x/n · 失败 n`。
- 生成后 stage=generated；**无人工确认**。双击任务弹窗查看新旧封面（纯查看），可选对某行 `重生成`；新标题直接用 AI 输出（不可编辑）。
+- 生成后 stage=generated；**不设逐条人工审核阶段**。双击任务弹窗查看新旧封面（纯查看），可选对某行 `重生成`；新标题直接用 AI 输出（不可编辑）。
 - 并发数、重试、分辨率、jpg 质量、模型/Key 均来自 ⑤ 设置（`config.json` 的 `ai` 段）。

 提示词管理：
@@ -255,7 +255,9 @@ images/<slug>/<item_id>_new.<ext>    # AI 生成的新封面

 ### 6.3 应用更新（③ Tab）

- 对**已生成（generated）任务**：`open_product` → `change_title(new_title)`（如有）→ `replace_cover(new_cover_path)`（如有）→ **总是 `click_update` 提交**。
+- ③ 顶部筛选确定本次作用范围；点击「开始更新」后弹窗展示筛选条件、任务数量和“将提交线上”的风险提示。
+- 用户点「是/确认」才开始批量更新；点「否/取消」不执行、不改库。
+- 对确认后的**已生成（generated）任务**：`open_product` → `change_title(new_title)`（如有）→ `replace_cover(new_cover_path)`（如有）→ `click_update` 提交。
 - 串行、单条失败继续；每条立即写 SQLite；全部完成回写 Excel（新字段+状态）+ 弹窗汇总。

 ### 6.4 登录检测
@@ -277,18 +279,18 @@ images/<slug>/<item_id>_new.<ext>    # AI 生成的新封面
 | 上传成功 | 张数 +1 且新图 src 为 `susercontent` |
 | 封面=第一位 | `Input.dispatchMouseEvent` 拖到第一位，落点 `第一张.left - 0.30*宽` |
 | 满 9 张 | 上限 9；换封面先删第一张（`.shopee-image-manager__icon--delete`，确认框待实测）|
-| 更新按钮 | `button.eds-button` 中 `<span>更新</span>`；③ 执行即点提交；禁用态（校验未过）记为失败 |
+| 更新按钮 | `button.eds-button` 中 `<span>更新</span>`；③ 批量确认后逐条点提交；禁用态（校验未过）记为失败 |
 | 登录检测 | 重定向到登录页或缺 `SPC_ST` → 未登录 |

-高风险动作（删满 9 张封面、点更新提交、AI 图直接上线）先在测试商品验证。注意：本设计**无人工确认、无提交开关**，③ 一旦执行即把 AI 标题/封面提交线上，新图本地留档+回写 Excel 是唯一事后追溯手段。
+高风险动作（删满 9 张封面、点更新提交、AI 图上线）先在测试商品验证。注意：本设计无逐条人工审核阶段、无常驻提交开关；③ 点击「开始更新」后必须弹窗确认，确认后才把当前筛选结果中的 AI 标题/封面提交线上。新图本地留档+回写 Excel 是事后追溯手段。

 ## 八、推荐开发顺序

 1. **地基**：`editor.py`（含采集）、`appconfig.py`+`config.json`、`db.py`、`.gitignore`。
 2. **账号与启动**（④）：`config` 建目录、`chrome` 启动器/快捷方式、登录保活与检测、账号 CRUD。
 3. **导入采集**（①）：`excel` 导入、采集旧标题/旧封面、回写。
-4. **AI 生成**（②）：`ai` 模块、提示词、对照预览与确认。
-5. **更新 shopee**（③）：对已生成任务换标题+封面、直接提交、回写。
+4. **AI 生成**（②）：`ai` 模块、提示词、对照预览。
+5. **更新 shopee**（③）：对已生成任务弹窗批量确认后换标题+封面、提交、回写。
 6. **设置**（⑤）+ 首次未配账号引导保护。

 ## 九、项目结构建议
@@ -317,5 +319,5 @@ cmshopee/
 - 存储边界：应用设置→config.json，账号/任务/结果→SQLite，图片→本地目录并记路径于 DB，登录态→user-data-dir；同一事实只存一处。
 - 别名是账号↔任务唯一关联键。
 - 密码与 AI Key 加密存、不外传、不写日志；不自动登录。
- AI 生成内容直接用于 ③ 更新（无人工确认）；新图本地留档 + 回写 Excel 以备追溯。
+- AI 生成内容直接进入 ③ 更新候选；③ 批量确认后提交，新图本地留档 + 回写 Excel 以备追溯。
 - 高风险模块先单独验证，再接入流水线。