From b0ef62c21a38bd3668e2b9d172111a62336b5128 Mon Sep 17 00:00:00 2001
From: chengma <chengma2027@gmail.com>
Date: Sat, 18 Jul 2026 17:30:00 +0800
Subject: [PATCH] docs(tasks): add collection scope copy task

---
 docs/tasks/T-664.md | 53 +++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 53 insertions(+)
 create mode 100644 docs/tasks/T-664.md

diff --git a/docs/tasks/T-664.md b/docs/tasks/T-664.md
new file mode 100644
index 0000000..7d013be
--- /dev/null
+++ b/docs/tasks/T-664.md
@@ -0,0 +1,53 @@
+---
+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、计费或③更新蝦皮逻辑。
+
+## 执行记录
+
+- 待实现。