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

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

diff --git a/docs/tasks/T-665.md b/docs/tasks/T-665.md
new file mode 100644
index 0000000..03c07e3
--- /dev/null
+++ b/docs/tasks/T-665.md
@@ -0,0 +1,54 @@
+---
+id: T-665
+title: 生成范围按钮文案简化
+status: TODO
+phase: 7
+deps: [T-663]
+created: 2026-07-18
+---
+
+# T-665 生成范围按钮文案简化
+
+## 问题 / 背景
+
+②AI生成的范围确认框已使用 T-663 的稳定纵向布局，但按钮“只生成状态正常的商品”和“生成所有状态的商品”偏长。为与①采集的“架上商品 / 全部商品”范围表达保持一致，运营需要更短、更易扫读的文案，同时必须保留对 AI 点数成本和商品状态范围的明确提示。
+
+## 方案
+
+- 仅修改②AI生成范围框的两个用户可见按钮文案：
+  - `只生成状态正常的商品` 改为 `生成架上商品`；
+  - `生成所有状态的商品` 改为 `生成全部商品`。
+- 在说明文字中补足语义：`生成架上商品` 仅将检测结果为正常的商品交给 AI；`生成全部商品` 会把未上架、审核中和状态未知商品也交给 AI，可能额外消耗点数。
+- 保留既有按钮 objectName、默认主操作蓝色、全部范围警示橙色、禁用条件、纵向布局、回车/Esc 行为和稳定返回值 `normal_only/all/None`。
+- ①采集范围文案不改；不改变 `build_generation_plan()`、任务指纹、`GenerateWorker`、cmhub 调用、计费、日志或③更新蝦皮逻辑。
+
+## 验收标准
+
+- [ ] ②弹窗完整显示“生成架上商品”“生成全部商品”“取消”，按钮文案与说明文字一致。
+- [ ] 选择“生成架上商品”仍返回 `normal_only`；选择“生成全部商品”仍返回 `all`；无异常候选时“生成全部商品”仍禁用。
+- [ ] “生成全部商品”保持警示橙色，说明明确会处理未上架、审核中、状态未知并可能额外消耗点数。
+- [ ] ①采集、生成范围计划、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`，不改①采集范围文案。
+- 不改变商品状态判定、生成范围策略、数据库、cmhub 请求、计费或③更新蝦皮逻辑。
+
+## 执行记录
+
+- 待实现。