cmshoppe/docs/tasks/T-664.md

id, title, status, phase, deps, created

id	title	status	phase	deps	created
T-664	采集范围按钮文案简化	DONE	7	T-663	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 中①采集范围的用户可见文案与语义说明。

验证

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。