docs(tasks): commit T-662a/c/d scope-dialog redesign
Redesign per user requirement: pre-run scope dialogs in ①② replace the status column/dropdown model; ③ keeps background interception only. T-662b already landed in previous commit alongside the red text alignment. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
chengma
co-authored by
Claude Fable 5
Claude Fable 5
parent
21c72d0d93
commit
b4250f36f8
+13
-9
@@ -26,8 +26,9 @@ created: 2026-07-18
|
||||
- `unlisted`：未上架；
|
||||
- `reviewing`：审核中；
|
||||
- `unknown`：历史 NULL、DOM 检测失败或出现未识别状态横幅。
|
||||
- `NULL` 和非法历史值统一按 `unknown` 读取；`unlisted/reviewing` 属于异常状态，`normal/unknown` 默认可继续后续流程。
|
||||
- `NULL` 和非法历史值统一按 `unknown` 读取；只有 `normal` 表示本次检测未发现已知异常，可进入默认的采集、付费生成和更新候选；`unlisted/reviewing/unknown` 均不得被“只处理状态正常商品”策略放行。
|
||||
- 文本归一化：trim、连续空白折叠、繁简白名单兼容；禁止依赖 `data-v-*`。
|
||||
- 提供共享纯逻辑 helper，统一完成状态代码归一化、中文显示和任务分组，①②③不得各自复制状态判断。
|
||||
|
||||
## DOM 检测规则
|
||||
|
||||
@@ -37,7 +38,7 @@ created: 2026-07-18
|
||||
- `您的商品未上架` → `unlisted`。
|
||||
- 查询成功且没有 warning 横幅 → `normal`。
|
||||
- 有 warning 横幅但没有白名单命中 → `unknown`，不得保留旧的 `normal` 或误判正常。
|
||||
- DOM 查询抛错或返回结构非法 → `unknown`，但不使标题/封面采集失败；错误写脱敏诊断日志。
|
||||
- DOM 查询抛错或返回结构非法 → `unknown`；错误写脱敏诊断日志。是否继续采集标题/封面由 T-662b 的本轮采集策略决定，状态探测本身不直接制造技术失败。
|
||||
- 多横幅时跳过无关警告，取 DOM 顺序中第一个白名单命中项；没有命中则为 `unknown`。
|
||||
- `product_status_note` 只保存归一化后的 title/desc 摘要，最多 2000 字符；`product_status_at` 记录本次检测时间。
|
||||
- 现有 `PRODUCT_UNAVAILABLE_TEXT_MARKERS` 和商品失效 toast 逻辑保持不变。
|
||||
@@ -49,9 +50,10 @@ created: 2026-07-18
|
||||
- `product_status_note TEXT NULL`；
|
||||
- `product_status_at TEXT NULL`。
|
||||
- `db.init_db()` 使用幂等原位迁移；`Task` dataclass 暴露三字段。
|
||||
- 扩展 `db.set_collected()` 时使用新增 keyword-only 参数，保持现有位置参数调用兼容；标题、封面与商品状态在同一事务写入。
|
||||
- `editor.collect()` 在同一编辑页会话中读取状态，返回状态快照；CollectWorker 透传到 DB。重新采集覆盖三字段。
|
||||
- 状态检测失败时仍可成功采集标题/封面，保存 `unknown` 与当前检测时间。
|
||||
- 新增独立、幂等的商品状态写入 API，使标题/封面被采集策略略过时仍能保存状态、note 和检测时间；扩展 `db.set_collected()` 时使用新增 keyword-only 参数，保持现有位置参数调用兼容。
|
||||
- 编辑器提供可复用的商品状态探测步骤，并保证在读取标题、下载封面之前完成；完整采集成功时，标题、封面和本次状态快照在同一事务写入。
|
||||
- 每次重新采集都必须重新打开页面检测状态，不得依据数据库旧快照提前略过，否则商品恢复正常后无法刷新状态。
|
||||
- 状态探测返回 `unknown` 时保存当前快照；是否继续读取标题和封面由 T-662b 传入的本轮策略决定。
|
||||
|
||||
## 验收标准
|
||||
|
||||
@@ -59,13 +61,15 @@ created: 2026-07-18
|
||||
- [ ] 无 warning 为 `normal`；未知 warning、DOM 异常和非法返回均为 `unknown`。
|
||||
- [ ] 多横幅共存按约定选择，note 规范化且受长度限制。
|
||||
- [ ] 旧库迁移幂等，历史 NULL 显示语义为「未知」。
|
||||
- [ ] 重新采集覆盖状态、note 和时间；检测失败不阻断标题/封面采集。
|
||||
- [ ] 只写商品状态时不伪造“采集成功”，也不清空既有标题和封面；完整采集可原子写入内容和状态。
|
||||
- [ ] 重新采集始终重新检测并覆盖状态、note 和时间，不根据旧快照预过滤。
|
||||
- [ ] 不改变商品失效判断、Chrome/CDP 页面打开关闭和 Shopee 更新逻辑。
|
||||
|
||||
## 测试与文档
|
||||
|
||||
- `tests/test_editor_login.py`：样本结构、无横幅、未知横幅、多横幅、异常降级与 collect 回归。
|
||||
- `tests/test_db.py`：迁移幂等、NULL 语义、keyword-only 写入与重新采集覆盖。
|
||||
- `tests/test_product_status.py`：状态归一化、中文显示、正常与非正常分组。
|
||||
- `tests/test_editor_login.py`：样本结构、无横幅、未知横幅、多横幅、异常降级、探测顺序与 collect 回归。
|
||||
- `tests/test_db.py`：迁移幂等、NULL 语义、独立状态写入、keyword-only 写入、既有内容保留与重新采集覆盖。
|
||||
- 更新 `docs/04-architecture.md` 第七节和 `docs/api.md`；登记样本路径、选择器纪律和状态代码。
|
||||
|
||||
## 验证
|
||||
@@ -80,7 +84,7 @@ git diff --check
|
||||
|
||||
## 非目标
|
||||
|
||||
- 不识别无样本的售罄、违规、禁卖等状态；未知横幅先归 `unknown`。
|
||||
- 不识别无样本的售罄、违规、禁卖等状态；未知横幅先归 `unknown`，不得猜测为正常。
|
||||
- 不新增 GUI，不过滤任务，不回写 Excel，不做定时刷新。
|
||||
|
||||
## 执行记录
|
||||
|
||||
Reference in New Issue
Block a user