feat: auto-prepare chrome for collection
This commit is contained in:
chengma
@@ -59,7 +59,7 @@ imported → collected → generated → applied
|
||||
|
||||
## 三、职责划分
|
||||
|
||||
**GUI（5 Tab）**：见 [routes.md](routes.md)。只做交互与预览，不写业务逻辑；耗时操作走 PySide6 `QObject` worker + `QThread`，用 signal 回主线程刷新 UI。**首次未配账号、对应账号 Chrome 未启动或未登录时，① ③ 执行按钮禁用或执行前拦截，并提示去 ④；③ 不静默自动打开账号 Chrome。**
|
||||
**GUI（5 Tab）**：见 [routes.md](routes.md)。只做交互与预览，不写业务逻辑；耗时操作走 PySide6 `QObject` worker + `QThread`，用 signal 回主线程刷新 UI。**① 采集点击后会为本轮匹配到的账号自动确保 Chrome 就绪：已打开则复用，未打开才启动；随后只检测登录态，未登录账号的任务跳过并汇总提示去 ④人工登录。③ 更新蝦皮仍是线上提交高风险链路：执行前只检测账号 Chrome/CDP/登录态，不自动启动缺失账号 Chrome。**
|
||||
|
||||
**核心模块**
|
||||
|
||||
@@ -442,7 +442,7 @@ data/images/<batch_id>/<slug>/<task_id>_<item_id>_new.<ext> # AI 生成的新
|
||||
### 6.4 登录检测
|
||||
|
||||
- 无 Shopee tab 时打开卖家中心根地址 `https://<region_host>/`（默认 `https://seller.shopee.tw/`），重定向到登录页或缺会话 Cookie（`SPC_ST`/`SPC_U`）→ 未登录；不自动登录，提示人工登录。
|
||||
- ④「启动登录」只负责准备该账号独立 user-data-dir + CDP 端口的 Chrome，供用户人工登录；该入口必须幂等：若端口已响应，复用现有账号 Chrome 并打开/激活卖家中心登录 tab，不再新开 Chrome；若端口未响应，才启动 Chrome。「检测登录」只验证当前 Chrome/CDP/会话 Cookie 是否可用。①/③ 的预检只检测，不自动启动缺失浏览器。若商品详情页或卖家中心重定向到 `accounts.shopee.tw/seller/login`，必须按登录页处理，返回 `LOGIN_PAGE` 并在 GUI 显示未登录。
|
||||
- ④「启动登录」只负责准备该账号独立 user-data-dir + CDP 端口的 Chrome，供用户人工登录；该入口必须幂等：若端口已响应，复用现有账号 Chrome 并打开/激活卖家中心登录 tab，不再新开 Chrome；若端口未响应，才启动 Chrome。「检测登录」只验证当前 Chrome/CDP/会话 Cookie 是否可用。① 采集的预检会复用同一幂等启动能力，自动确保本轮匹配账号 Chrome 就绪但不自动登录；③ 更新的预检只检测，不自动启动缺失浏览器。若商品详情页或卖家中心重定向到 `accounts.shopee.tw/seller/login`，必须按登录页处理，返回 `LOGIN_PAGE` 并在 GUI 显示未登录。
|
||||
|
||||
## 七、CDP 已验证事实（务必遵守）
|
||||
|
||||
|
||||
@@ -32,9 +32,9 @@
|
||||
- 存储：`data/config.json`（应用设置和 AI backend 内部字段，普通默认 cmhub）+ `data/config/ai_models.json`（direct AI 模型清单与本地明文 Key）+ `data/config/cmhub.json`（cmhub 本地明文 Key）+ SQLite `data/cmshopee.db`（账号/任务/各阶段结果，密码本地明文仅参考）+ openpyxl（Excel）+ 本地 `data/images/`（旧/新封面）；密码/API Key 保存或变更时提示，展示和日志/导出必须脱敏。
|
||||
- 多账号隔离：每账号独立 user-data-dir（非 profile）。
|
||||
- 账号↔任务绑定：以 Excel“别名”列为权威；未匹配略过，结束弹窗汇总。
|
||||
- 执行：默认多账号串行、单条失败继续；③ 提供「检查本轮更新」按钮，检查只写运行日志和汇总，不打开 Shopee、不提交线上、不改任务状态；⑤ 可开启多账号并行（不同账号并行、同账号内串行）并设置每批最大更新条数。③ 点击「开始更新」后先按真实更新安全设置弹窗确认当前筛选范围、任务数量、每批大小和预计批次；确认后做本轮账号 Chrome/CDP/登录态预检，未启动或未登录则弹窗列出账号并中止、不自动打开 Chrome；账号就绪后按批逐条点「更新」提交线上，点击停止后不再开始下一条或下一批。
|
||||
- 执行：默认多账号串行、单条失败继续；① 点击「采集旧标题/旧封面」后会为本轮匹配账号自动确保 Chrome 就绪（已开复用、未开启动），再检测登录态；未登录账号任务整组略过并汇总提示，采集结束不关闭账号 Chrome。③ 提供「检查本轮更新」按钮，检查只写运行日志和汇总，不打开 Shopee、不提交线上、不改任务状态；⑤ 可开启多账号并行（不同账号并行、同账号内串行）并设置每批最大更新条数。③ 点击「开始更新」后先按真实更新安全设置弹窗确认当前筛选范围、任务数量、每批大小和预计批次；确认后做本轮账号 Chrome/CDP/登录态预检，未启动或未登录则弹窗列出账号并中止、不自动打开 Chrome；账号就绪后按批逐条点「更新」提交线上，点击停止后不再开始下一条或下一批。
|
||||
- AI：普通产品默认 `backend=cmhub`，由 `data/config.json` 的 Base URL/别名和 `data/config/cmhub.json` Key 配置，Base URL 会规整为网关根；`app/ai.py` 仍支持 `backend=direct` 作为内部兼容/手工回滚路径，direct 由 `data/config/ai_models.json` 配置服务商/模型/Key。生成返回值保持不变，计费 metadata 通过事件传出。生成内容直接用于更新，本地留档+回写 Excel 供追溯。
|
||||
- 登录：人工登录 + 程序检测，不自动登录；④「启动登录」会打开或复用对应账号浏览器供人工登录，④「检测登录」和①/③预检只验证登录态；无 Shopee tab 时检测入口为 `https://<region_host>/`（默认 `https://seller.shopee.tw/`）；页面跳到 `accounts.shopee.tw/seller/login` 时已明确判为未登录；首次未配账号、对应账号 Chrome 未启动或未登录时，① ③ 应禁用或执行前预检提示，并引导去④，③ 不静默启动缺失账号 Chrome。
|
||||
- 登录：人工登录 + 程序检测，不自动登录；④「启动登录」会打开或复用对应账号浏览器供人工登录，④「检测登录」只验证登录态；无 Shopee tab 时检测入口为 `https://<region_host>/`（默认 `https://seller.shopee.tw/`）；页面跳到 `accounts.shopee.tw/seller/login` 时已明确判为未登录；①采集预检会自动确保匹配账号 Chrome 就绪但不自动登录，未登录账号略过并引导去④；③更新预检只检测 Chrome/CDP/登录态，缺失或未登录时中止，不静默启动缺失账号 Chrome。
|
||||
|
||||
## 当前目录要点
|
||||
|
||||
@@ -92,9 +92,9 @@
|
||||
## 当前已知限制
|
||||
|
||||
- T-505 已完成：①采集、②AI生成、Excel 导入/回写、③更新蝦皮、④Chrome 启动/登录检测、⑤AI模型测试连接均已接入业务可读 `run_logs/run_log_events`；异常路径写本地 `data/logs/cmshopee.log` 脱敏 traceback，业务日志不记录 Cookie、密码、API Key、token。
|
||||
- T-105b 已完成：④账号管理「启动登录」改为幂等入口。同一账号再次点击时会先检查 `debug_port` 是否已有 CDP 响应；已运行则复用现有账号 Chrome 并打开/激活卖家中心登录 tab，状态栏提示“该账号 Chrome 已打开，已复用现有窗口”，不会再次 `subprocess.Popen()`；未运行才新启动 Chrome 并等待 CDP 就绪。不自动登录、不填密码、不改变①/③预检不自动启动 Chrome 的规则。
|
||||
- T-105b 已完成：④账号管理「启动登录」改为幂等入口。同一账号再次点击时会先检查 `debug_port` 是否已有 CDP 响应；已运行则复用现有账号 Chrome 并打开/激活卖家中心登录 tab，状态栏提示“该账号 Chrome 已打开，已复用现有窗口”，不会再次 `subprocess.Popen()`；未运行才新启动 Chrome 并等待 CDP 就绪。不自动登录、不填密码。T-560 后①采集复用该幂等启动能力自动确保匹配账号 Chrome 就绪，③更新预检仍不自动启动 Chrome。
|
||||
|
||||
- ① 采集和③真实更新都依赖对应账号 Chrome 已用专属 user-data-dir 和 CDP 端口启动并登录；T-205/T-402 已在执行前拦截未配置账号、Chrome 未启动、CDP 端口不可访问、未登录，并引导去④账号管理。③ 点击「开始更新」后若本轮需要账号未就绪，必须中止本轮更新，不自动打开账号 Chrome、不提交任何商品。
|
||||
- ① 采集和③真实更新都依赖对应账号 Chrome 专属 user-data-dir、CDP 端口和登录态。T-560 后①采集会在点击采集时自动确保本轮匹配账号 Chrome 就绪：已开复用、未开启动；开 Chrome 失败才中止，预检未登录或中途掉登录的账号任务整组略过并汇总提示补登录。③ 点击「开始更新」后若本轮需要账号未就绪，必须中止本轮更新，不自动打开账号 Chrome、不提交任何商品。
|
||||
- T-501/T-501b/T-501c 已完成 `data/config/ai_models.json` 模型清单 UI，以及 `data/config.json` 里的标题/图片默认模型角色、并发、重试、分辨率、jpg 质量、路径/端口设置和 蝦皮更新安全开关。
|
||||
- T-506 已完成：③ 已将用户可见 `dry-run` 改为「检查本轮更新」按钮；真实更新对当前筛选结果按每批最大更新条数自动分批，确认弹窗显示任务数和预计批次，停止为当前商品安全结束后不再开始新任务；⑤ 设置页已改为居中内容区，左右留白已缩短为 T-506 初始实现约 40%，模型详情/角色与生成参数/路径与端口/蝦皮更新安全使用三列布局，长字段跨列；「多账号并行更新」与「最大并行账号数」已合并为同一个横向组件，最大并行账号数紧跟其后且不换行。
|
||||
- T-507 已完成：普通正式更新移除 `test_item_id` 商品 ID 限制；③ 确认弹窗不再显示测试商品 ID；⑤ 普通设置页隐藏测试商品 ID，只作为历史/调试兼容字段保留；仍保留允许真实提交、允许更新封面、每批最大条数、二次确认、账号就绪预检、多账号并行上限、运行日志和 Excel 回写。
|
||||
|
||||
+5
-5
@@ -42,9 +42,9 @@
|
||||
## 首次使用引导保护
|
||||
|
||||
- ① 导入采集 与 ③ 更新蝦皮 都依赖**账号已配置且已登录**（在 ④ 账号管理）。
|
||||
- 当无账号 / 对应账号 Chrome 未启动 / 账号未登录时：相关执行按钮**禁用或在执行前汇总拦截**，并提示「请先到『账号管理』配置账号并登录」。
|
||||
- ① 点击「采集旧标题/旧封面」后，会为本轮匹配到账号的店铺自动确保 Chrome 就绪：已打开则复用，未打开才启动；随后逐账号检测蝦皮登录态，未登录账号的任务整组略过并在结束汇总中提示去④人工登录。
|
||||
- ③ 点击「开始更新」后必须检查当前筛选结果涉及的账号；只要有账号 Chrome 未启动、CDP 端口不可访问或 Shopee 未登录，就弹窗列出账号并中止本轮更新，不创建真实更新 worker，不提交任何商品。
|
||||
- 可以提供「打开账号管理」或「启动登录」入口辅助用户处理当前账号；不要无提示批量启动所有账号 Chrome，避免开错账号或启动过多浏览器进程。用户主动点击④「启动登录」时也必须先检查该账号 CDP 端口，已打开则复用现有 Chrome 并打开/激活卖家中心 tab，不重复 `Popen` 新窗口。
|
||||
- 可以提供「打开账号管理」或「启动登录」入口辅助用户处理当前账号；③ 不要无提示批量启动所有账号 Chrome，避免在提交线上前开错账号或启动过多浏览器进程。用户主动点击④「启动登录」时也必须先检查该账号 CDP 端口，已打开则复用现有 Chrome 并打开/激活卖家中心 tab，不重复 `Popen` 新窗口。
|
||||
- 老用户账号已就绪则无感。
|
||||
|
||||
## ① 导入采集
|
||||
@@ -65,11 +65,11 @@
|
||||
|
||||
- 导入：openpyxl 解析**输入列**（账号名/别名/商品id）入 SQLite。
|
||||
- **导入汇总栏**（导入后即时刷新，跑采集前的校验关口）：显示 文件数、解析行数（原始数据量）、有效/无效行、匹配账号行数（按账号细分）、未匹配行数。未匹配/无效数字标红可点，点击在列表筛出便于定位纠错。
|
||||
- 采集：用该账号已启动并登录的 Chrome 只读打开商品页，读旧标题、下载旧封面到 `data/images/<batch_id>/<slug>/<task_id>_<item_id>_old.jpg`，写 `old_title/old_cover_path`，stage=collected。若程序为采集自动新建商品页 tab，采集结束后自动关闭；若复用用户原本打开的 tab，则不关闭。
|
||||
- 采集：点击后先为本轮匹配账号确保 Chrome 就绪（已开复用、未开启动），再检测登录；未登录账号的任务整组略过并汇总提示。登录账号用对应 Chrome 只读打开商品页，读旧标题、下载旧封面到 `data/images/<batch_id>/<slug>/<task_id>_<item_id>_old.jpg`，写 `old_title/old_cover_path`，stage=collected。若程序为采集自动新建商品页 tab，采集结束后自动关闭；若复用用户原本打开的 tab，则不关闭。采集结束不关闭账号 Chrome，用户可自行关闭。
|
||||
- 若商品 ID 已失效、无权限或店铺不匹配，Shopee 可能只弹出短暂错误 toast；采集失败时界面日志应显示捕获到的 toast 文案，并把 toast HTML/URL 写入本地诊断日志，避免用户手动抢复制。只有明确捕获商品失效/商品不存在/无权限类 toast 时，①列表“阶段”列显示“商品失效”；其他商品页打开失败仍显示“失败”。如果失败发生在 `open_product()` 内部，本轮自动新建的商品 tab 必须关闭，复用用户已有 tab 不关闭。
|
||||
|
||||
- 回写：采集完成后自动把旧标题/旧封面路径批量回写原 Excel；保留「回写旧数据到 Excel」作为手动重试入口（原文件被锁→提示关闭后重试/另存）。
|
||||
- 别名未匹配账号 / 账号未登录 → 该行 skipped 并记原因。`T-207` 接入后，① 采集会像③更新一样写 `run_logs/run_log_events`，并把完整脱敏 traceback 写入本地 `data/logs/`，用于定位失败卡在哪个步骤。
|
||||
- 别名未匹配账号 → 该行 skipped 并记原因，不为未匹配别名启动 Chrome。账号预检未登录或采集中途掉登录 → 该账号剩余任务整组 skipped 并记原因，结束汇总列出需补登录的账号。`T-207` 接入后，① 采集会像③更新一样写 `run_logs/run_log_events`，并把完整脱敏 traceback 写入本地 `data/logs/`，用于定位失败卡在哪个步骤。
|
||||
|
||||
- 「删除批次」位于①批次筛选旁，只能对当前选中的具体批次执行，不能在“全部批次”下执行；运行中禁用。删除是软删除：写本地批次删除标记，不物理删除 DB 记录，不删除原 Excel，不回滚蝦皮。删除后该批次不再出现在①/②/③任何批次下拉、任务列表、筛选、采集、生成、更新、回写入口中。确认框必须显示任务数、已上线任务数，并提示软删除只隐藏本地批次、不会回滚线上修改。
|
||||
## ② AI生成
|
||||
@@ -187,7 +187,7 @@
|
||||
③ 更新蝦皮：对已生成任务点击开始更新 → 安全开关检查 → 弹窗确认 → 账号就绪预检（未启动/未登录则中止） → 换标题/允许时换封面 → 点「更新」提交 → 回写结果 → 弹窗汇总
|
||||
```
|
||||
|
||||
- 未配账号 / Chrome 未启动 / 未登录：① ③ 的执行按钮禁用或执行前提示去 ④；③ 不静默启动缺失账号 Chrome。
|
||||
- 未配账号 / 未登录：① 会自动确保匹配账号 Chrome 就绪但不自动登录，未登录账号略过并提示去④；③ 更新前仍只检测账号 Chrome/CDP/登录态，未启动或未登录则中止，不静默启动缺失账号 Chrome。
|
||||
- 已生成的任务即可进 ③；③ 通过 ⑤ 安全开关并经用户确认批量弹窗后提交线上，无常驻提交开关。
|
||||
- 任意步骤失败：记入该任务、日志标明，不影响其他任务。
|
||||
|
||||
|
||||
+7
-2
@@ -3,7 +3,7 @@ id: T-560
|
||||
title: ① 采集前批量确保账号 Chrome 就绪 + 登录预检（自动开、不自动登录）
|
||||
phase: 2
|
||||
deps: [T-203, T-205, T-105b, T-103b, T-523]
|
||||
status: TODO
|
||||
status: DONE
|
||||
created: 2026-07-08
|
||||
---
|
||||
|
||||
@@ -51,4 +51,9 @@ created: 2026-07-08
|
||||
|
||||
## 执行记录
|
||||
|
||||
（做完在此记录：改了哪些文件、跑的验证命令与结果、决策）
|
||||
- 2026-07-08：同步 `AGENTS.md`、`docs/04-architecture.md`、`docs/routes.md`、`docs/current-state.md`，明确 T-560 后 ①采集会自动确保匹配账号 Chrome 就绪，③更新仍保持只检测不自动启动的高风险边界。
|
||||
- 2026-07-08：`CollectWorker` 采集预检从“Chrome 未启动即 blocked”改为“先幂等确保 Chrome 就绪”：已运行账号复用，未运行账号调用 `accounts.launch_for_login()` 启动；启动失败才 blocked 并弹窗中止。
|
||||
- 2026-07-08：预检未登录账号不再 blocked，改为把该账号任务整组 `skipped` 并记原因；采集过程中若二次登录检测发现掉登录，则把该账号当前和剩余任务整组 `skipped` 为“采集中途掉登录”，不逐条重复失败。
|
||||
- 2026-07-08：①采集完成后新增账号汇总弹窗：列出自动启动账号、需要补登录账号，并提示采集结束不会自动关闭账号 Chrome；未匹配别名仍逐行略过且不启动 Chrome。
|
||||
- 2026-07-08：更新 GUI 单测，覆盖 Chrome 未运行时自动启动、启动失败阻断、预检未登录账号级略过、中途掉登录账号级略过、结束汇总弹窗；③更新侧不自动启动 Chrome 的测试保持不变。
|
||||
- 验证通过：`python -m ruff check app tests main.py`、`py -3.10 -m compileall app main.py`、`py -3.10 -m unittest discover -s tests`。
|
||||
|
||||
Reference in New Issue
Block a user