feat: add first-run empty state guidance

2026-07-02 09:57:06 +08:00
parent 9bad70f425
commit d8c3c5d548
5 changed files with 214 additions and 9 deletions
@@ -953,3 +953,10 @@
 - 测试：`tests/test_gui.py` 补充主窗口 ③Tab icon、账号登录状态文本与颜色、删除账号/删除批次按钮 danger 样式断言。
 - 验证：`python -m py_compile app\gui.py tests\test_gui.py` 通过；`python -m unittest discover -s tests -p "test_gui.py"` 通过（63 tests）；`python -m compileall app main.py` 通过；`python -m unittest discover -s tests` 通过（151 tests）。测试输出仍有 PySide6 字体目录提示，不影响结果。
 - 下一步：T-514「①②③ 首次空状态引导卡片」。
+## 【2026-07-02】T-514 完成 · ①②③首次空状态引导卡片
+
+- 文档先行：扩展 `docs/06-tasks.md` 的 T-514 口径，明确无账号时①②③均显示「前往账号管理」引导，有账号但无任务时分别提示①导入 Excel、②先完成①采集、③先完成②生成；卡片只做 UI 引导，不替代执行前账号/Chrome/登录态预检。
+- 代码：`app/gui.py` 新增共享 `_build_empty_state_card()` / `_set_empty_state()`；①导入采集、②AI生成、③更新shopee在刷新任务时按账号和任务状态显示/隐藏空状态卡片；②新增 `open_accounts_callback` 并由 `MainWindow` 传入跳④回调；原有导入、采集、生成、更新和安全拦截流程不变。
+- 测试：`tests/test_gui.py` 新增①②③空状态断言，覆盖无账号时按钮跳④、有账号但无任务时显示对应下一步提示且隐藏跳④按钮。
+- 验证：`python -m py_compile app\gui.py tests\test_gui.py` 通过；`python -m unittest discover -s tests -p "test_gui.py"` 通过（66 tests）；`python -m compileall app main.py` 通过；`python -m unittest discover -s tests` 通过（154 tests）。测试输出仍有 PySide6 字体目录提示，不影响结果。
+- 下一步：T-515「批次阶段进度总览」。