cmshoppe/docs/tasks/T-664.md

---
id: T-664
title: 采集范围按钮文案简化
status: DONE
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、计费或③更新蝦皮逻辑。

## 执行记录

- ①范围选择框默认按钮改为“采集架上商品”，扩展按钮改为“采集全部商品”；保留原有 objectName、颜色、布局、键盘行为与 `normal_only/all/None` 返回值。
- 说明文字明确“架上商品”只继续采集检测结果为正常的商品，“全部商品”还包括未上架、审核中和状态未知商品；②生成范围文案未改。
- 同步更新 `docs/routes.md`、`docs/04-architecture.md`、`docs/api.md` 和 GUI 断言。
- 验证通过：`py -3.10 -m unittest tests.test_gui`（202 项）、`py -3.10 -m unittest discover -s tests`（617 项）、`py -3.10 -m ruff check app tests main.py`、`py -3.10 -m compileall app main.py`、`git diff --check`。