Files
cmshoppe/docs/tasks/T-664.md
T

54 lines
2.3 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
id: T-664
title: 采集范围按钮文案简化
status: TODO
phase: 7
deps: [T-663]
created: 2026-07-18
---
# T-664 采集范围按钮文案简化
## 问题 / 背景
①导入采集的范围确认框已经改为纵向全宽布局,但默认选项“只采集状态正常的商品”和扩展选项“采集所有状态的商品”仍然偏长。运营更容易理解“架上商品”和“全部商品”;“架上”在本功能中明确指本次状态检测结果为正常的商品,而不是泛指已导入记录。
## 方案
- 仅修改①导入采集范围框的两个用户可见按钮文案:
- `只采集状态正常的商品` 改为 `采集架上商品`;
- `采集所有状态的商品` 改为 `采集全部商品`。
- 保留既有按钮 objectName、默认主操作蓝色、全部范围的警示橙色、纵向布局、回车/Esc 行为与稳定返回值 `normal_only/all/None`。
- 在说明文字中补足语义:`采集架上商品` 仅继续采集检测结果为“正常”的商品;`采集全部商品` 包括未上架、审核中和状态未知商品。保留“可能增加采集时间,但本步骤不消耗 AI 点数”。
- ②AI生成的按钮与说明文字不改,避免把“架上”误用于会消耗 AI 点数的生成范围。
## 验收标准
- [ ] ①弹窗完整显示“采集架上商品”“采集全部商品”“取消”,按钮文案与说明文字一致。
- [ ] 选择“采集架上商品”仍返回 `normal_only`;选择“采集全部商品”仍返回 `all`;取消、回车、Esc 行为不变。
- [ ] ①现有颜色、布局、Worker 参数、状态检测、采集结果、日志和②/③流程不回归。
## 测试与文档
- 更新 `tests/test_gui.py` 的①范围对话框按钮文案、默认项、说明文字与两种返回值断言。
- 更新 `docs/routes.md`、`docs/04-architecture.md`、`docs/api.md` 中①采集范围的用户可见文案与语义说明。
## 验证
```bash
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
```
## 非目标
- 不恢复 `QMessageBox`,不改②生成范围文案。
- 不改变商品状态判定、范围策略、数据库、Chrome/CDP、计费或③更新蝦皮逻辑。
## 执行记录
- 待实现。